在 GitHub Pages 搭建 Hexo 博客

概述

https://hexo.io/zh-cn/docs/

在自己 GitHub 中要有一个 public 仓库，名字为你的 GitHub 用户名.github.io，用于部署。

建站

https://hexo.io/zh-cn/docs/setup

hexo init默认会生成package-lock.json文件。个人的使用建议是，禁用这个文件的生成。而由于hexo init要求当前目录为空，所以一开始还没法写在.npmrc文件中，只能通过命令行来设置。

npm config set package-lock false
hexo init

上述操作的配置是会写到用户文件夹的.npmrc文件的。操作完之后，再根据自己的实际情况，决定是否保留在用户文件夹中的.npmrc中的配置。

npm config remove package-lock

可以根据需要，在当前目录新建.npmrc文件。

registry=https://registry.npmmirror.com/
package-lock=false

配置

https://hexo.io/zh-cn/docs/configuration

其中包括关于主题配置的内容。使用代替主题配置文件。

命令

https://hexo.io/zh-cn/docs/commands

好习惯是每次generate之前都先clean一下。

部署

https://hexo.io/zh-cn/docs/github-pages

https://hexo.io/zh-cn/docs/one-command-deployment

分支名称根据习惯设置，建议设置为main。

仓库备份

直接将当前博客目录作为 Git 本地备份仓库地址。

在最开始hexo init的时候，已经生成了.gitignore，直接用就行。

个人建议再新建一个.npmrc文件。

registry=https://registry.npmmirror.com/
package-lock=false

在 GitHub 新建相应的仓库。

写作

https://hexo.io/zh-cn/docs/writing

Front-matter

https://hexo.io/zh-cn/docs/front-matter

资源文件夹

https://hexo.io/zh-cn/docs/asset-folders

按照里面的设置，就可以有更方便的在 markdown 嵌入图片的方式。

自定义

永久链接

https://hexo.io/zh-cn/docs/permalinks

如果不修改，默认的每篇文章的链接是带日期的。我自己一般使用/:title/，这样更简洁。

代码高亮

https://hexo.io/zh-cn/docs/syntax-highlight