安装主题

使用 Keep 主题之前，如果你对 Hexo 框架搭建个人博客没有任何经验，那么建议你先阅读以下两个网站的内容，能够帮助你快速入门 Hexo 博客框架。

• Easy Hexo

• Hexo 官网

安装 Keep 主题

• 如果你使用 Hexo 5.0 或更高版本，最简单的安装方式是通过 NPM （强烈推荐）

  cd your-hexo
  npm install hexo-theme-keep

• 或者使用 Git 克隆整个 Keep 主题仓库

  cd your-hexo
  git clone https://github.com/XPoet/hexo-theme-keep themes/keep

使用 Keep 主题

Keep 主题安装完成后，在 Hexo 配置文件 _config.yml 中将 theme 设置为 keep。

# your-hexo/_config.yml

theme: keep

更新（升级）Keep 主题

Keep 主题不定期发布新版本，你可以通过如下命令更新（升级）。

• 通过 NPM 安装最新版本 （强烈推荐）

  cd your-hexo
  npm install hexo-theme-keep@latest

• 通过 Git 更新到最新的 master 分支

  cd your-hexo/themes/keep
  git pull

注意事项

• 使用 Keep 主题必须确保你的 Node.js 版本 >= 14.0，当你的 Hexo 项目运行时报错或发出警告，请注意升级你的 Node.js 版本。

• 使用手册中的 your-hexo 代表你的 Hexo 博客项目根目录名称，请不要在终端工具直接输入 your-hexo。

• 通过 Git 更新 Keep 主题的前提是 —— 你也是使用 Git 安装的 Keep 主题，否则无效。

• 作者强烈建议使用 NPM 来安装和更新 Keep 主题。

• 如果你使用 NPM 安装 Keep 主题，那么需要把 node_modules/hexo-theme-keep/_config.yml 路径下的主题配置文件复制到 your-hexo/source/_data/keep.yml 或 your-hexo/_config.keep.yml。

• 如果你使用 NPM 更新 Keep 主题，但 your-hexo/themes/ 目录下又包含 keep，你需要删除 your-hexo/themes/keep，否则无法使用通过 NPM 更新的 Keep 主题，因为 your-hexo/themes/keep 优先级最高，这两种方式不要混用。

• 如果你刚接触 Hexo 和 Keep 主题，也就是说你对 Hexo 框架和 Keep 主题都不熟悉的情况下，那么推荐你直接使用 Keep 快速启动模板 来搭建 Hexo 博客。