引言
最近基于Github Pages整了一个个人页面，记录一下如何使用Github Pages建站以及自定义域名
本文没有建站系统等，因为我也就写了一个Markdown文件
创建Github仓库
其中Repository name为username.github.io，例如我的Github用户名为yexca，则输入yexca.github.io
Git环境安装
Windows环境直接从Git官网直接下载安装程序即可
安装完成后，打开Git Bash，在命令行输入以下代码
1
2
$ git config --global user.name "Your Name"
$ git config --global user.email "[email protected]"
其中“Your Name”替换为您的姓名，“email@example”替换为您的邮箱
例如我的
1
2
$ git config --global user.name "yexca"
$ git config --global user.email "[email protected]"
Github Desktop
安装
如果您熟悉Git的操作熟悉Git操作怎么会来看我的文章，这一步可以跳过
直接进入Github Desktop官网下载安装即可
克隆仓库
打开Github Desktop后登录Github账号选择一个空文件夹将上一步创建的仓库克隆到本地
然后软件会出现一个仓库变动界面，右方会有一些快捷操作
这里我使用VS Code，点击“Open in Visual Studio Code”在VS Code打开
建立网站
这里直接创建一个README.md文件使用Markdown编辑(这里顺便放一个我写的Markdown笔记)
编辑完成并保持后在Github Desktop点击Commit to main，然后点击右方Push origin即可
至此访问username.github.io即可看到网站内容如果没看到请等一段时间
自定义域名
Github Pages
进入刚刚建立的仓库页面，点击Settings，左侧找到Pages，在Custom domain处输入自定义域名然后点击Save
注：在这里可以进行Jekyll建站主题的选择
DNS
在域名的DNS解析处添加一个CNAME类型解析，将域名指向username.github.io，其中username为您的Github用户名
HTTPS
这里我用Github的不知为何没成功，于是使用Cloudflare
在DNS解析处启用代理，然后在SSL/TLS的边缘证书处将始终使用HTTPS打开即可
其他建站
因无博客需求，我只是写一个简单的文件，如果是建立博客之类的可以使用一些建站工具
- Jekyll Github官方支持的建站
-
VuePress中文网 Markdown推荐
- Gitbook 适合建立文档类网站
- LOFFER
- Gridea 一个静态博客写作客户端
- Hexo 快速、简洁且高效的博客框架
- Hugo
参考文章
GitHub Pages 快速入门 - GitHub Docs