引言
前言
使用github pages + hexo搭建个人博客网站。
GitHub Pages 是通过 GitHub 托管和发布的公共网页，可以使用github账号免费创建“username.github.io”站点。详情查看“GitHub Pages 快速入门 - GitHub 文档”
Hexo 是一个快速、简洁且高效的博客框架（随便找的），Hexo使用简单的命令就可以将本地文章部署到设定的网站中。详情查看“文档 | Hexo”。
定义
无。
参考资料
- GitHub Pages 快速入门 - GitHub 文档
- 文档 | Hexo
- GitHub Pages + Hexo搭建个人博客网站，史上最全教程_hexo博客-CSDN博客
- Git 详细安装教程（详解 Git 安装过程的每一个步骤）_git安装-CSDN博客
- 注册Github账号详细教程【超详细篇 适合新手入门】_github注册-CSDN博客
- Git的环境配置（GitHub的SSH密钥的配置超详细）_gitshezhi github 帐户设置 ssh 密钥并运行 ssh 代理-CSDN博客
搭建个人博客
搭建个人博客流程
- 准备运行环境
- 创建github pages站点
- 部署Hexo博客框架
- 上传文章
- 更换主题
准备运行环境
Hexo运行环境只需要git和Node.js。
安装git
在官网选择适合自己系统的最新git下载版本。
运行git安装程序，在安装界面点击下一步，如下图所示。
选择默认安装工具，点击下一步，如下图所示。
使用vim编辑器，点击下一步，如图所示。
选择使用master作为git仓库默认分支（main默认分支无法建立网站），点击下一步，如下图所示。
添加git到PATH（方便后续在用户路径使用git），点击下一步，如下图所示。
使用自带的openSSH工具，点击下一步，如下图所示。
使用openSSH加密方式，点击下一步，如下图所示。
选择行结尾方式（选择默认即可），点击下一步，如下图所示。
选择MinTTY终端（cmd太难用），点击下一步，如下图所示。
选择git提交方式（默认即可），点击下一步，如下图所示。
选择git管理凭证（默认即可），点击下一步，如下图所示。
启用文件缓存，点击下一步，如下图所示。
后续功能不需要（使用默认即可），点击安装（等待安装完成即可完成git安装
），如下图所示。
安装详细说明可以参考Git 详细安装教程（详解 Git 安装过程的每一个步骤）_git安装-CSDN博客
安装Node.js
在官网下载预构建安装程序，如下图所示。
运行安装程序，点击下一步，如下图所示。
创建github pages站点
基于github pages站点的网页需要使用github账户，注册github账号参考注册Github账号详细教程【超详细篇 适合新手入门】_github注册-CSDN博客
创建公用存储库
Github点击Home，进入家界面，如下图所示。
在gitbub家界面选择new新建公共仓库，如下图所示。
创建仓库时名称需要选择为github用户名+github.io，例github用户名为hongdei，创建公用仓库为hongdei.github.io。创建仓库时需要选择公用仓库，使用readme初始化仓库，下图所示。
更换分支
创建的仓库默认分支为main分支，但是使用Hexo支持的分支为master，因此需要更换分支。创建分支为master，如下图所示。
在仓库界面的Default branch选项中修改默认分支。点击切换选项，在选项界面点击分支选项（如果有多个不同名称分支会在下拉框中显示），选择masetr选项然后点击跟新。如下图所示。
部署Hexo框架
Hexo是一个快速、简洁、高效的博客框架。搭配github pages可以实现“免费创建博客网站”。
安装Hexo
准备运行环境后使用nmp安装Hexo。
npm install -g hexo-cli
安装完成Hexo后使用init初始化。
$ hexo init <folder>
$ cd <folder>
$ npm install
安装完成后文件夹如下。
.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes
配置Hexo
初始化后安装目录下_config.yml为网站配置文件，type为网站类型，repo为github仓库路径使用SSH访问格式为“git@github.com:hongdei/用户仓库名称”，branch为提交分支名称。设置如下图所示。（使用SSH访问git需要提前设置github仓库公用密钥，参考Git的环境配置（GitHub的SSH密钥的配置超详细）_gitshezhi github 帐户设置 ssh 密钥并运行 ssh 代理-CSDN博客）
上传文章
Hexo使用简单命令就可实现上传本地文章到博客网站。Hexo通过hexo-deployer-git插件上传本地文章到github仓库，通过github pages站点实现公网访问Hexo渲染的博客。
新建文件
hexo new <文件名称>
清理缓存文件
hexo clean
清除缓存文件和生成的静态文件。
生成静态文件
hexo d
将本地文章生成静态文件。
同步到git仓库
hexo g
将本地文件部署到网站
更多设置见指令 | Hexo。
更换主题
暂无。
主题下载
主题配置
部署主题
常见问题
使用main分支无法显示hexo框架博客
问题描述
Github仓库默认分支为main分支，Hexo博客框架使用master分支。在main分支上传文章github pages并不会显示博客文章。
问题解决办法
更换mian分支为master，并修改hexo分支配置为master。
参考文档
无。