# 进阶使用

# 创建页面

Hexo 项目初始状态下并没有 categories（分类）、tags（标签）、links（友链）、about（关于）等页面，需要自己手动创建。

以创建「about（关于）」页为例：

在 Hexo 项目根目录下使用如下命令，即可创建 about 页面。
```
$ hexo new page about
```
创建成功后，打开 Hexo 项目根目录下 hexo/source/about/index.md 文件，即可填写 about 页面的内容。支持 Markdown 和 HTML 格式。

TIP

comment: true 表示该页面开启评论功能。

参考如下示例：
```
---
title: about
date: 2020-03-19 14:59:53
comment: true
---

# About me

<div style="color: red;">About me</div>
```
在主题配置文件 _config.yml 中启用 about 导航菜单。
```
menu:
  Home: /
  About: /about
  # ...
```

其他页面的创建方式跟「about（关于）」页面类似，此处不再赘述。

# 文章顶置

要实现顶置的文章，需在文章页添加 sticky 属性，sticky 值越大，顶置的文章越靠前，参考如下。

---
title: Keep 主题使用指南
date: 2020-04-07 21:55:14
tags: [Hexo]
categories: [Hexo]
sticky: 999
---

# 数学公式

如果要在文章中显示数学公式，可以使用插件 hexo-filter-mathjax (opens new window)。

配置流程：

在 Hexo 项目根目录下安装插件 hexo-filter-mathjax。
```
$ cd hexo-site
$ npm install hexo-filter-mathjax
```

在 Hexo 配置文件 _config.yml 增加如下配置。

mathjax:
  tags: none               # or 'ams' or 'all'
  single_dollars: true     # enable single dollar signs as in-line math delimiters
  cjk_width: 0.9           # relative CJK char width
  normal_width: 0.6        # relative normal (monospace) width
  append_css: true         # add CSS to every page
  every_page: false        # if true, every page will be rendered by mathjax regardless the `mathjax` setting in Front-matter of each article

在文章页添加 mathjax: true 属性，至此，就可以在该页面中写公式了。

示例：

---
title: MathJax Test
date: 2020-09-12 16:02:07
tags: MathJax
categories: MathJax
mathjax: true
---
$$
i\hbar\frac{\partial}{\partial t}\psi=-\frac{\hbar^2}{2m}\nabla^2\psi+V\psi
$$

效果图：

# 友链样式

Keep 主题对友链（links）页面进行了样式优化，你只需按如下教程，便可得到漂亮的友链列表，如下图。

创建友链（links）页面，在你的 Hexo 项目根目录下使用如下命令即可自动创建。
```
$ hexo new page links
```
注意

source/links/index.md 文件的 title 属性不要修改！
友链样式根据 title: links 来匹配！
```
---
title: links
date: 2020-05-13 14:16:07
---
```
在 Keep 主题配置文件 _config.yml 的 menu 配置项里面启用 links。
```
menu:
  Home: /
  Links: /links
  # ......
```
在你的 Hexo 项目的 source 文件夹里增加 _data 文件夹。

TIP

如果已经有了 _data 文件夹，则忽略这一步。
在 _data 文件夹里新建 links.yml 文件。

在 links.yml 文件里按如下格式增加你的友链。

- name: XPoet
  link: https://xpoet.cn/
  description: 所有命运的馈赠，早已在暗中标好价格。
  avatar: https://cdn.jsdelivr.net/gh/XPoet/image-hosting@master/common-use/avatar.jpg

- name: 不知名艺术家
  link: https://jinzhanqi.com/
  description: love artist, love code.
  avatar: https://s3.ax1x.com/2020/11/17/DVvkB4.jpg

- ......

# 平滑升级

更新 Hexo 主题时，一般都会有这样的经历：先将主题目录下的_config.yml 文件备份，更新完主题后，再将备份的数据复制粘贴还原回去。

这个过程繁琐又浪费时间，因此我们需要一种友好的更新方式。如果你也经历着这样的痛苦，那么不妨尝试 Hexo 3.0 新增的功能 -- 数据文件 (opens new window)。

Keep 主题利用该功能实现了平滑升级的特性，使用步骤如下：将主题目录下的 _config.yml 文件复制到博客根目录下的 /source/_data/ 中，并重命名为 keep.yml。如果 source 目录下没有 _data 文件夹请自行创建。

这两个文件的关系为 keep.yml 覆盖 _config.yml，也就是说，想要修改配置时，只需要修改 keep.yml 里的即可（修改 _config.yml 里的不会生效）。这样就实现了平滑升级，更新 Keep 主题时 _config.yml （可能）会更新，而你的主题配置数据保留在 keep.yml 中。

注意

主题更新后，如果主题目录下的 _config.yml 文件里出现了新的配置项，那么你必须从该文件中将它们复制到 /source/_data/keep.yml 中，并设置它们的值为你想要的选项。

如果你使用了平滑升级这一特性，那么 /themes/keep/_config.yml 和 /source/_data/keep.yml 这两个文件里的选项没有同步，是更新主题后，启动报错的最主要的原因！

有时候，同步 /themes/keep/_config.yml 和 /source/_data/keep.yml 两个配置文件里的内容也比较麻烦。因此，推荐使用代码对比工具进行查看，这样再进行同步就方便多了。例如 VS Code 自带的代码对比工具：

特别注意

如果你升级了 Kepp 主题，主题配置文件 _config.yml 的 version 的值必须跟版本号保持一致！!

例如：我将主题升级到 3.4.2 版本，那么主题配置文件 _config.yml 的 version 的值必须是 3.4.2 。如果你用了平滑升级，/source/_data/keep.yml 中的版本号需要你手动更改。

# Keep version
version: 3.4.2

# 资源压缩

Keep 主题的源码中，HTML、CSS、JavaScript、图片等资源文件是没有打包压缩的。绝大部分的 Hexo 主题也是如此。庆幸的是，可以找到相关的插件来解决这一问题。

这里可以使用 hexo-all-minifier (opens new window) 插件，它集成了 html-minifier、clean-css、uglify 和 imagemin，只需安装和简单的配置即可使用。

在 Hexo 项目根目录下安装 hexo-all-minifier。
```
$ npm install hexo-all-minifier
```
在 Hexo 配置文件 _config.yml 文件中，添加以下配置项：
```
all_minifier: true
```

如果你使用插件时遇到了问题或者想进行更详细的设置，请查看插件的文档 (opens new window)。

# 图床问题

如果你在用 Hexo 等静态博客，正愁图片不知保存在哪里，那你可以试试 PicX (opens new window)。基于 GitHub API 开发的图床神器，图片外链使用 jsDelivr 进行 CDN 加速。

免下载、免安装，打开网站即可直接使用。免费、稳定、高效。

TIP

觉得好用就点个 Star 支持一下 ❤️

# 自动部署

# Travis CI

如何使用 Travis CI 自动部署 Hexo 博客 (opens new window)

# GitHub Action

如何使用 GitHub Actions 自动部署 Hexo 博客 (opens new window)

← 配置指南贡献准则 →