Skip to content

安装主题

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

安装 Keep 主题

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

    sh
    cd your-hexo
    npm install hexo-theme-keep
  • 或者使用 Git 克隆整个 Keep 主题仓库

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

使用 Keep 主题

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

yaml
# your-hexo/_config.yml

theme: keep

更新(升级)Keep 主题

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

  • 通过 NPM 安装最新版本 (强烈推荐)

    sh
    cd your-hexo
    npm install hexo-theme-keep@latest
  • 通过 Git 更新到最新的 master 分支

    sh
    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.ymlyour-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 博客。

Released under the AGPL-3.0 License