hexo搭建记录
Icarus的默认主题配置文件为_config.icarus.yml。 此文件定义了站点全局的布局与样式设置,同时也控制了例如插件与挂件等外部功能的配置。 本文详细介绍了本主题的一般配置,并且解释了Icarus使用哪些配置文件和它是如何生成并验证这些配置。
推送更改
git add . |
安装hexo主题
npm install hexo-theme-aurora hexo-plugin-aurora --save |
npm install -S hexo-theme-icarus hexo-renderer-inferno |
删除hexo主题
npm uninstall hexo-theme-aurora hexo-plugin-aurora |
npm uninstall hexo-theme-icarus hexo-renderer-inferno |
生成主题
需要在 Hexo 博客的根目录下创建一个 _config.aurora.yml 配置文件来配置主题.
直接复制这个demo到项目根目录的 _config.aurora.yml 中
配置主题
你要用的主题是 aurora 所以需要把 _config.yml 中的 theme 值改为 aurora
打开在 Hexo 根目录下的 _config.yml
修改把 theme 的值改为 aurora或者icarus
theme: icarus |
设置 permalink
因为使用了 Vue-router,Hexo 默认生成的页面和文章的 permalink 与我们 Vue router 中的 path 是不相符的,那么就会出现无法访问的问题。
所以我们需要修改 Hexo 默认配置文件里面的 permalink 参数。
打开在 Hexo 根目录下的 _config.yml
修改 permalink 参数为 /post/:title.html
设置
主题 2.5 版本开始主题已经改为使用 Shiki 作为代码高亮引擎。Shiki支持使用从 VSCode 导出的主题。颜色标记化与 VSCode 相同! Shiki 默认还支持了一些最多人使用的主题哦!
首先,我们需要禁用 _config.yml 中的 highlight 和 prismjs 。
... |
然后将以下配置添加到主题配置文件 _config.aurora.yml 中
|
创建 “关于 (about)” 页面
主题默认开启了 about 页面,所以我们需要创建这个 about 页,要不主题就无法正常显示 about 页。
要创建这个默认的 about 页,只需要执行这个 Hexo 的命令:
hexo new page about |
执行完毕后,你会发现在 source/ 文件中多处了一个新的文件夹:
. |
你可以随意修改这个 index.md markdown 文件中的内容,此文件的内容将会现在在我们的 about 页面中。
重新生成与本地服务器
使用以下命令来运行本地环境。
hexo clean & hexo g & hexo server |
1. 初始化Hexo
新建blog文件夹,进入后安装依赖
npm install -g hexo-cli |
2. 初始化仓库
选择VSCode直接对项目开源到github仓库。
也可以手动去github创建一个空仓库,然后手动在命令行中推送。
git init |
3. 创建Token
在个人设置中新增一个Personal access tokens。至少要包含repo权限,然后记住token。
这个token是给Github Action用的,Github Action会把Hexo编译部署到gh-pages分支。
随后在存放Hexo代码的仓库里把这个Token新增进去,名称为GH_TOKEN(随意,后面需要一致)。
