GitHub-Pages

1.GitHub-Pages 是什么

• GitHub-Pages是一个免费的静态站点托管服务

• 特点如下:

  • 操作简单、完全免费
  • 支持静态脚本
  • 自定义域名
  • 功能多，玩法丰富

• 搭配 GitHub 的 CICD服务: Actions 可以实现更加灵活的功能

2.如何使用GitHub-Pages

• 参考官方文档很容易搭建
• 简述下步骤:
  • 1.创建一个公开仓库，仓库名必须为: username.github.io, username 为你的GitHub用户名
  • 2.clone该项目并简单添加一个index.html,内容随便
  • 3.推送至远程仓库
  • 4.访问username.github.io即可访问到自己 添加的index.html的内容

3.自定义域名

• 1.在 username.github.io仓库中的settings、Pages可以设置自定义域名
• 2.前往自己的域名服务商那里添加一个域名的CNAME记录
• 3.等待生效后验证
• 4.因为众所周知的原因，GitHub在国内访问比较慢
• 5.因此可以使用CDN技术将username.github.io作为回源地址加快国内访问速度

4.静态博客框架

• 借助静态博客框架可以让我们专注于写作

• 常用的静态博客框架:

  • Jekyll, github-pages-site-with-jekyll
  • Hexo
  • Hugo
  • GitBook

• 可以根据自己的喜好进行选择

5.gh-pages分支

• 普通用户和组织的站点的发布源是默认的master分支，而普通项目的发布源是gh-pages分支
• 发布源可以在仓库中的settings、Pages页面设置
• 静态博客框架需要配置环境来预览页面，最后需要build出静态资源文件
• 将静态资源文件推送至username.github.io仓库，我们才可以通过互联网访问我们的站点
• 这一过程过于复杂和繁琐，那有没有什么方法可以简化这个过程呢
• 可以利用 GitHub 的 CICD服务: Actions，自动将 master分支的代码 build 后推送至 gh-pages
• 这样master分支就是源代码， gh-pages 分支就是编译后的静态文件