hexo init

hexo next 创建记录

开始时,对 hexo 理解错了,以为和 jekyll 一样,是每个主题单独部署,其实所有主题都是放在 themes 目录下,通过配置文件切换。

安装 hexo

hexo文档

使用 hexo next 主题

1
2
$ cd your-hexo-site
$ git clone https://github.com.cnpmjs.org/theme-next/hexo-theme-next themes/next # 注意这个文件路径,不要多层嵌套了

修改 _config.yml 文件

1
2
language: zh-CN # 中文
theme: next # 主题为 next

其他配置自行修改,相关文档:iissnan

hexo 启动本地环境测试

hexo s [–debug]

访问 http://localhost:4000

hexo 编写文章

hexo new [layout] "<title>"

如果只是需要展示顶部,在分割的地方添加 <!--more-->

这里默认的 layout_config.yml 中的 default_layout 参数
draft 草稿完成后,可以通过以下命令来发布

hexo publish "<title>"

在 hexo 中,特殊符号的渲染总是会出现特殊问题,因此对于特殊符号最好使用转义过后的符号,或者添加转义符 \

符号 转义
" &quot;
' &apos;

hexo 发布

可以通过两种方式进行发布,这里使用了第一种方式:

  1. 使用 github-Actions,只要提交文件,Actions 会自动发布。

  2. 发布至 github-page,需要插件 hexo-deployer-git

1
$ npm install hexo-deployer-git --save

先修改 _config.yml

1
2
3
4
5
deploy:
type: git
repo: https://github.com.cnpmjs.org/jinuxx/jinuxx.github.io
branch: gh-pages # 我的仓库中,main分支用来保存这个项目,gh-pages分支是用来发布的
message: update

运行命令发布至 gh-page

hexo clean & hexo d