Hexo安装过程

Hexo 是什么

Hexo 是一个基于 Node.js 的静态博客框架，广泛用于搭建快速、简洁且高效的博客或静态网站。它的主要特点是生成速度快、易于配置和扩展，支持丰富的主题和插件，适合于技术人员和博主快速搭建个人博客或文档站点。

Hexo 的工作原理

Hexo 采用 Markdown 或其他标记语言编写内容，然后通过模板引擎生成静态 HTML 文件，这些文件可以直接托管在任何静态网站托管平台上（如 GitHub Pages、Vercel、Netlify 等）。

Hexo 项目文件结构

.
├── _config.yml            # Hexo 主配置文件，控制网站的基本设置
├── package.json           # Node.js 项目的配置文件，包含 Hexo 的依赖项
├── scaffolds/             # 模板文件夹，存放文章、页面等内容的模板
│   ├── draft.md           # 草稿模板
│   ├── page.md            # 页面模板
│   └── post.md            # 文章模板
├── source/                # 资源文件夹，存放用户的文章、页面和其他资源
│   ├── _drafts/           # 草稿文件夹，未发布的文章存放在此处
│   ├── _posts/            # 已发布的文章，所有 Markdown 格式的文章文件都放在这里
│   └── ...                # 其他资源文件（如图片、文档等），可以直接存放于此
├── themes/                # 主题文件夹，存放 Hexo 使用的主题
│   └── your-theme/        # 当前使用的主题目录
│       ├── _config.yml    # 主题的单独配置文件
│       ├── layout/        # 页面布局文件夹
│       ├── source/        # 主题相关资源，如图片、CSS、JS
│       └── ...            # 其他主题相关文件
├── public/                # 生成的静态文件，`hexo generate` 后输出的 HTML 文件
└── node_modules/          # Node.js 依赖包文件夹，存放 Hexo 和插件的依赖

主要文件及文件夹详解

_config.yml：Hexo 的主配置文件，定义了网站的基本设置（如站点名称、描述、语言、URL 配置、部署方式等）。这是整个网站的核心配置文件。
package.json：定义了 Hexo 项目的依赖和脚本，可以在此添加或更新 Hexo 相关的插件、主题等内容。
scaffolds/：用于存放文章、页面等内容的模板文件，当创建新文章或页面时，会按照模板内容进行初始化。用户可以根据需要自定义这些模板。
source/：是用户存放内容的主要目录：
- _posts/：放置已发布的文章，文章文件通常以 Markdown 格式保存。
- _drafts/：存放未发布的草稿文章，通过 hexo publish 命令可以将草稿发布到 _posts 目录。
- 其他文件或文件夹：可以存放资源文件（如图片、PDF 等），会直接映射到网站的根目录。
themes/：用于存放 Hexo 的主题，用户可以选择或自定义主题来改变网站的外观。每个主题都有其独立的配置文件 _config.yml，用于设置主题相关的参数。
public/：生成的静态文件存放在这个目录，通过 hexo generate 命令生成。此目录中的文件可以直接上传到 Web 服务器或托管服务进行发布。
node_modules/：存放 Hexo 项目依赖的 Node.js 模块和插件，通常不需要手动修改。

Hexo 文件结构的意义

模块化管理：不同功能、内容和配置分离，方便管理和维护。
扩展性强：通过 themes 和 scaffolds 等文件夹，用户可以方便地进行自定义。
生成速度快：Hexo 只需读取 source 和 scaffolds 中的内容，通过主题生成静态页面，所有生成内容都保存在 public 文件夹中，速度快且易于部署。

Hexo 的搭建步骤

Step 1: 安装 Node.js

Hexo 依赖于 Node.js，因此需要先安装 Node.js 和 npm（Node.js 的包管理工具）。

下载 Node.js：
- 访问 Node.js 官方网站。
- 推荐下载 LTS（长期支持）版本，以保证稳定性。

安装 Node.js：

Windows 用户：运行下载的 .msi 安装程序，按照提示完成安装。
macOS 用户：运行下载的 .pkg 文件进行安装。

Linux 用户：可以通过包管理器安装，如：

  # Debian/Ubuntu
  sudo apt update
  sudo apt install -y nodejs npm
        
  # 或者通过 NodeSource 安装最新版本
  curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
  sudo apt-get install -y nodejs

验证 Node.js 和 npm 是否安装成功：
```
1
2
 node -v
 npm -v
```
运行以上命令会输出 Node.js 和 npm 的版本号。

Step 2: 安装 Git

Git 是 Hexo 部署和版本控制所需的工具。

下载 Git：
- 访问 Git 官方网站下载适用于系统的安装包。

安装 Git：

Windows 用户：运行下载的 .exe 文件，并按照提示进行安装。
macOS 用户：可以通过下载 .dmg 文件安装，或使用 Homebrew 安装：
```
1
  brew install git
```

Linux 用户：可以通过包管理器安装，如：

  # Debian/Ubuntu
  sudo apt update
  sudo apt install -y git

验证 Git 是否安装成功：
```
1
 git --version
```
运行该命令会显示 Git 的版本号。

Step 3: 安装 Hexo

安装 Hexo CLI： 使用 npm 安装 Hexo 的命令行工具（CLI）。
```
1
 npm install -g hexo-cli
```
- g 选项表示全局安装，使得 Hexo 命令在系统中全局可用。
创建 Hexo 项目： 在你想创建博客的目录中运行以下命令：
```
1
2
3
 hexo init my-blog
 cd my-blog
 npm install
```
- hexo init my-blog：在当前目录下创建一个名为 my-blog 的新 Hexo 项目。
- cd my-blog：进入项目文件夹。
- npm install：安装项目依赖。
配置 Hexo： 打开项目中的 _config.yml 文件，修改站点的基本配置（如站点名称、描述、作者信息等）。
运行 Hexo：
- 生成静态文件：
```
1
  hexo generate
```
- 本地启动服务器预览网站：
```
1
  hexo server
```
访问 http://localhost:4000，即可预览你的网站。
安装主题：
- Hexo 默认使用 landscape 主题，你可以安装其他主题。在 Hexo 的主题库中选择一个主题，按照主题文档中的说明进行安装。
- 例如，安装 hexo-theme-next：
```
1
git clone https://github.com/theme-next/hexo-theme-next themes/next
```
- 修改 my-blog/_config.yml 文件中的 theme 配置为新主题的名称：
```
1
theme: next
```

创建和发布内容

创建文章：
- 使用 Hexo 提供的命令创建新文章：
```
1
hexo new post "My First Post"
```
- 这会在 source/_posts/ 目录下创建一个新的 Markdown 文件，你可以编辑这个文件来写文章内容。
生成静态文件：
- 使用以下命令生成静态网站文件：
```
1
hexo generate
```
- 生成后的文件会被放置在 public/ 目录中。
启动本地服务器：
- 你可以使用 Hexo 的本地服务器来查看网站效果：
```
1
hexo server
```
- 打开浏览器并访问 http://localhost:4000 查看你的站点。