Icarus的默认主题配置文件为_config.icarus.yml。 此文件定义了站点全局的布局与样式设置,同时也控制了例如插件与挂件等外部功能的配置。 本文详细介绍了本主题的一般配置,并且解释了Icarus使用哪些配置文件和它是如何生成并验证这些配置。

推送更改

命令行
git add .
git commit -m "github action update"
git push origin main

安装hexo主题

命令行
npm install hexo-theme-aurora hexo-plugin-aurora --save
cli
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

_config.yml
theme: icarus

因为使用了 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.yml
...
highlight:
enable: false
prismjs:
enable: false

然后将以下配置添加到主题配置文件 _config.aurora.yml 中

_config.aurora.yml

#! ---------------------------------------------------------------
#! Highlighter Shiki
#! ---------------------------------------------------------------
shiki:
enable: true
backgroundColor: '#1a1a1a'

创建 “关于 (about)” 页面

主题默认开启了 about 页面,所以我们需要创建这个 about 页,要不主题就无法正常显示 about 页。

要创建这个默认的 about 页,只需要执行这个 Hexo 的命令:

命令行
hexo new page about

执行完毕后,你会发现在 source/ 文件中多处了一个新的文件夹:

命令行
.
└── source
└── about
└── index.md

你可以随意修改这个 index.md markdown 文件中的内容,此文件的内容将会现在在我们的 about 页面中。

重新生成与本地服务器

使用以下命令来运行本地环境。

命令行
hexo clean & hexo g & hexo server

1. 初始化Hexo

新建blog文件夹,进入后安装依赖

命令行
npm install -g hexo-cli
hexo init blog
cd blog
npm instal

2. 初始化仓库

选择VSCode直接对项目开源到github仓库。

也可以手动去github创建一个空仓库,然后手动在命令行中推送。

命令行
git init
git remote add origin [email protected]:ahsyon/hexo-source-Repo.git
git add .
git commit -m "Initial commit"
git push -u origin main

3. 创建Token

在个人设置中新增一个Personal access tokens。至少要包含repo权限,然后记住token。
这个token是给Github Action用的,Github Action会把Hexo编译部署到gh-pages分支。
随后在存放Hexo代码的仓库里把这个Token新增进去,名称为GH_TOKEN(随意,后面需要一致)。