安装 Homebrew#

1. 打开终端（Terminal） 点击右上角放大镜（Spotlight），也可以command+空格调出聚焦搜索，搜索终端并打开。
2. 在终端输入安装命令：

   1
   /bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

3. 执行后提示 请安装Git后再运行此脚本，在系统弹窗中点击“安装”按钮

   1
   查询git发现有版本不确定后面是否还需要安装
   2
   git -v
   3
   git version 2.50.1 (Apple Git-155)

4. 安装后按提示操作：
   1. 选择下载源，输入 1（清华大学镜像）
   2. 输入电脑开机密码
   3. 如果询问是否删除旧版本 Homebrew，输入 Y
   4. 按回车开始安装
   5. 选择镜像源时输入 5（阿里镜像）
5. 安装完成后，关闭终端，再重新打开终端。 Homebrew 安装完成。

安装 Git#

在终端输入命令：

1
brew install git

回车执行，等待安装完成即可。 Git 安装完成。

安装 Node.js#

1. 进入官网下载 macOS 安装程序： https://nodejs.org/zh-cn/download
2. 安装步骤：
   1. 打开下载好的安装包
   2. 点击“继续”
   3. 同意用户协议
   4. 点击“安装”
   5. 输入电脑密码
   6. 点击“安装软件”
3. 安装完成后，点击“关闭”。 Node.js 安装完成。

使用node版本 管理工具nvm，安装Node.js和npm#

注：不推荐使用Node installer，因为它会把npm 安装到具有本地权限的目录中，在全局运行npm时可能会导致EACCES权限错误。我们直接使用nvm安装即可。

1. 下载和安装nvm 
   1. 在终端执行：

   1
   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

   也可以在github 获取最新版本地址：https://github.com/nvm-sh/nvm#installing-and-updating 2. 验证是否安装成功：
   在终端输入command -v nvm，如果输出 nvm 则说明安装成功。
2. 使用nvm安装Node.js和npm 如果之前已经用其他方法安装过node.js，无需担心，nvm 会直接覆盖安装。
   1. 在终端输入nvm ls-remote，列出都有哪些可用版本
   2. 从中选择一个安装，例如 nvm install v24.14.1
   3. 使用安装好的版本，例如 nvm use v24.14.1 接下来就可以使用npm安装Hexo。在终端输入 npm install -g hexo-cli即可。 参考的原文档：
      https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally/

进入项目目录#

1
cd [project-name]

安装主题#

主题安装方式有许多种，选择一种你喜欢的方式即可，如果你看不懂这些，默认使用第一种即可

1. 使用 Git 安装

1
git clone -b dev https://github.com/everfu/hexo-theme-solitude.git themes/solitude

受限于防火墙和网速下载比较慢，容易安装失败 2. 自行下载主题文件安装 下载最新的 release 版本 解压到 themes 目录，并将解压出的文件夹重命名为 solitude 文件结构参考

1
- 博客目录/
2
    - themes/
3
        - solitude/

3. 使用包管理器安装 npm pnpm bun yarn

1
npm i hexo-theme-solitude

配置主题#

编辑 Hexo 项目的 _config.yml 文件，将 Hexo 主题修改为 solitude：

1
theme: solitude

安装依赖#

npm pnpm bun yarn

1
npm i hexo-renderer-pug

本地启动 Hexo#

分别执行

1
hexo clean
2
hexo generate
3
hexo server
4
#可以合并执行
5
hexo cl; hexo g; hexo s

访问 http://localhost<4000> 查看你的博客。

将主题配置复制到博客根目录（可选）#

为了减少升级主题后带来的不便，可将主题目录的 _config.yml 内容复制到博客根录并重命名为 _config.solitude.yml。 NPM 安装 Mac/Linux

1
cp -rf ./node_modules/hexo-theme-solitude/_config.yml ./_config.solitude.yml

Git 安装 Mac/Linux

1
cp -rf ./themes/solitude/_config.yml ./_config.solitude.yml

博客根目录下的 _config.solitude.yml 中的配置优先级大于主题目录 _config.yml 中的配置内容。如果使用了 _config.solitude.yml， 主题的 _config.yml 对应配置将不会有效果。

更新主题时记得关注配置文件是否改动，通过对比配置文件改动，同步修改原配置文件即可。

注意: 复制的是主题的 _config.yml ，而不是 hexo 的 _config.yml。 不要把主题目录的 _config.yml 删掉

文件结构参考

1
- 博客目录/
2
    - themes/
3
        - solitude/
4
            - _config.yml
5
- _config.solitude.yml

字数统计#

1
# --------------------------- start ---------------------------
2
# Word count
3
# 字数统计
4
# warning: Please install the hexo-wordcount plugin first.
5
# 警告: 请先安装 hexo-wordcount 插件。
6
wordcount: false
7
# --------------------------- end ---------------------------

安装 hexo-wordcount 插件 npm

1
npm i hexo-wordcount

数学公式#

1
# --------------------------- start ---------------------------
2
# Katex
3
# Latex formula support
4
# Latex 公式支持
5
katex:
6
  enable: false
7
  # Whether to load on each page
8
  # 是否在每个页面加载
9
  per_page: false
10
  # Whether to enable copy formula
11
  # 是否启用复制公式
12
  copytex: false
13
# --------------------------- end ---------------------------

卸载 hexo-render-marked

1
npm un hexo-renderer-marked

安装 hexo-renderer-markdown-it katex @renbaoshuo/markdown-it-katex npm

1
npm i hexo-renderer-markdown-it katex @renbaoshuo/markdown-it-katex

添加以下内容到 _config.yml _config.yml

1
markdown:
2
  preset: 'default'
3
  render:
4
    html: true
5
    xhtmlOut: false
6
    langPrefix: 'language-'
7
    breaks: true
8
    linkify: true
9
    typographer: true
10
    quotes: '“”‘’'
11
  enable_rules:
12
  disable_rules:
13
  plugins:
14
    - '@renbaoshuo/markdown-it-katex'
15
  anchors:
16
    level: 2
17
    collisionSuffix: ''
18
    permalink: false
19
    permalinkClass: 'header-anchor'
20
    permalinkSide: 'left'
21
    permalinkSymbol: '¶'
22
    case: 0
23
    separator: '-'
24
  images:
25
    lazyload: false
26
    prepend_root: false
27
    post_asset: false
28
  inline: false  # https://markdown-it.github.io/markdown-it/#MarkdownIt.renderInline

开启配置项

1
# --------------------------- start ---------------------------
2
# Katex
3
# Latex formula support
4
# Latex 公式支持
5
katex:
6
  enable: true
7
  # Whether to load on each page
8
  # 是否在每个页面加载
9
  per_page: true
10
  # Whether to enable copy formula
11
  # 是否启用复制公式
12
  copytex: false
13
# --------------------------- end ---------------------------