目录
- 什么是 Hexo？
- 为什么选择 Hexo？
- Hexo 的安装步骤
- 如何在 GitHub 上创建一个新的仓库
- Hexo 的基本配置
- 选择和安装主题
- 如何将 Hexo 部署到 GitHub Pages
- 常见问题解答
什么是 Hexo？
Hexo 是一个快速、简洁且高效的静态博客框架，它使用 Markdown 作为内容格式，支持多种主题和插件。Hexo 的优点在于：
- 快速：生成速度快，可以在几秒钟内生成网站。
- 简洁：使用 Markdown 编辑文章，易于上手。
- 高效：支持部署到 GitHub Pages，方便管理。
为什么选择 Hexo？
选择 Hexo 的原因主要有：
- 开源：Hexo 是一个开源项目，社区活跃，有众多主题和插件可供使用。
- 支持多平台：可部署在 GitHub Pages、Netlify 等多个平台。
- 强大的生态：有丰富的插件和主题，能够扩展博客功能。
Hexo 的安装步骤
1. 安装 Node.js
首先，你需要安装 Node.js。你可以从 Node.js 官网 下载适合你操作系统的安装包，完成安装后可以在终端输入以下命令确认安装成功： bash node -v npm -v
2. 安装 Hexo
在命令行中输入以下命令安装 Hexo： bash npm install -g hexo-cli
3. 创建 Hexo 博客
在你想创建博客的目录下，使用命令： bash hexo init myblog cd myblog npm install
如何在 GitHub 上创建一个新的仓库
- 登录你的 GitHub 账号。
- 点击右上角的加号，选择“New repository”。
- 输入仓库名称，选择“Public”，然后点击“Create repository”。
Hexo 的基本配置
1. 配置 _config.yml 文件
打开 Hexo 项目中的 _config.yml 文件，设置以下信息：
title: 博客标题subtitle: 博客副标题author: 作者名language: 语言（如zh-Hans表示简体中文）
2. 设置 URL
确保将 url 设置为你的 GitHub Pages 地址，格式为 https://<你的用户名>.github.io/<仓库名>。
选择和安装主题
1. 查找主题
你可以在 Hexo 官方主题库 中查找喜欢的主题。
2. 安装主题
在 Hexo 项目根目录下，运行以下命令安装主题（以 landscape 为例）： bash git clone https://github.com/hexojs/hexo-theme-landscape themes/landscape
然后在 _config.yml 中设置主题： yaml theme: landscape
如何将 Hexo 部署到 GitHub Pages
1. 安装 GitHub Pages 插件
在 Hexo 项目根目录下，安装 GitHub Pages 部署插件： bash npm install hexo-deployer-git –save
2. 配置 _config.yml
在 Hexo 项目的 _config.yml 中添加部署信息： yaml deploy: type: git repo: https://github.com/<你的用户名>/<仓库名>.git branch: main
3. 部署博客
使用以下命令部署博客： bash hexo clean hexo generate hexo deploy
常见问题解答
Hexo 是否支持中文？
是的，Hexo 完全支持中文内容，您可以在 Markdown 文件中自由使用中文。
如何添加自定义页面？
您可以在 source 目录下创建新文件夹和 Markdown 文件，然后在 _config.yml 中添加相应的路由。具体方法可参考 Hexo 文档。
Hexo 的主题可以更换吗？
可以，Hexo 支持更换主题，您只需在 themes 目录下安装新的主题并修改配置文件即可。
如何解决部署过程中出现的错误？
首先，确认 GitHub 仓库地址是否正确，检查网络连接。如果仍然存在问题，可以查阅 Hexo 和 GitHub 的官方文档，或在社区寻求帮助。
Hexo 的博客能否使用自定义域名？
当然可以，您只需在 GitHub Pages 的设置中添加自定义域名，并在 Hexo 的 _config.yml 文件中设置 url 字段即可。
