Github Page

• Github page help
• Github page 区别（未完）
• ===
• 主要用于：个人blog，项目主页介绍，甚至官网都可以
• 一般位于 repository -> setting -> Github page 中开启
• 理论上任何一个仓库都可以开启 Github Page
• 由于生成的主页域名一般为 xxx.github.io，但 github.io在国内访问效果不佳。。

使用用户名开启 github page

• 使用 用户名.github.io 来做仓库名的话，会自动开启 github page 功能
• 所有提交到 master 分支上的内容，都会当成网站内容
• 这是一种比较常见开启 github page 的方法

使用 setting 手动开启 github page

• 此方法一般手动指定 master分支，master分支下 /docs目录，gh-pages分支这三种方法来作为网站根目录实现
• ====
• 使用 gh-pages，首先要创建一个 gh-pages分支 目录，当切换到 setting 时，会自动选择 gh-pages 以生成 page
• 使用 gh-pages 会自动生成 _config.yml 指定一个主题，并读取 README.md作为主页内容
• ====
• 使用 master 分支，会以 README.md 为主页内容，应该也会生成 _config.yml
• ====
• 使用 master/docs 目录，仓库名不能以username.github.io结尾，先手动在master分支下建docs目录
• Github 将会在 master/docs下读出首页数据，须在 docs 目录下放一个 CNAME文件（用来做第三方域名跳转）

区别

• Github page 提供了两种方法进行 page 建立：使用 project pages即master, gh-pages, master/docs，或是用户名、组织名.github.io生成 page
• ====
• 使用project pages将使主页文件连接到特定项目（目录），站点文件位于项目库的分支上
• 使用username.github.io不与特定的特定项目绑定，站点文件位于Github特定的存储加中
• ====
• 使用username.github.io创建的库，同时可使用自定义域名配置

注意

• Github page 页面是公开的，不管仓库是否为 private

• Github page 在linux下访问可能会有问题，原因是当username含有数字、特殊字符等