配置 Hexo 博客

hexo官方文档，看中文文档更详细

按照以下几个步骤配置 Hexo 博客：

1. 安装 Node.js 和 Git

Hexo 是基于 Node.js 构建的，因此首先需要安装 Node.js。请访问 Node.js 官网 下载并安装适合您操作系统的 Node.js 版本。

同时，Hexo 使用 Git 进行版本控制，所以请确保您的电脑上已经安装了 Git。如果没有，请访问 Git 官网 下载并安装。

2. 安装 Hexo

打开命令行工具，执行以下命令以全局安装 Hexo：

1
npm install -g hexo-cli

3. 初始化 Hexo 博客

创建一个新的文件夹，用于存放您的博客项目。然后在命令行中进入该文件夹，并执行以下命令以初始化 Hexo 博客：

1
hexo init

这将会在当前文件夹中生成 Hexo 的基本文件结构。接下来，执行以下命令以安装项目依赖，如果你换了电脑check out hexo的文件后直接在文件夹更新依赖：

1
npm install

4. 配置博客

配置文件位于项目根目录下的 _config.yml 文件。您可以根据需要修改该文件以配置您的博客。以下是一些常见的配置选项：

  • title: 博客的标题
  • subtitle: 博客的副标题
  • description: 博客的描述
  • author: 作者的名字
  • language: 博客的语言
  • timezone: 时区

5. 写博客文章

在 source/_posts 文件夹下创建一个新的 Markdown 文件，例如 hello-world.md。在该文件中，您可以开始编写您的博客文章。文章的元数据（例如标题、日期、标签等）可以放在文件的 Front-matter 部分。

例如：

1
2
3
4
5
title: Hello World
date: 2023-05-20
tags:
- 示例
- 教程

这是我的第一篇 Hexo 博客文章。

6. 预览博客

为了预览您的博客，执行以下命令以启动本地服务器：

1
hexo server

然后在浏览器中访问 http://localhost:4000 即可查看您的博客。

7. 生成静态文件

当您想要部署您的博客时，需要先生成静态文件。执行以下命令以生成静态文件：

1
hexo generate

这将会在 public 文件夹下生成静态文件。

8. 部署博客

您可以将生成的静态文件部署到各种托管平台，例如 GitHub Pages、GitLab Pages、Netlify 等。在 _config.yml 文件中，您可以配置部署相关的选项。例如，以下配置表示使用 GitHub Pages 进行部署：
我自己是注册了一个新的github账号（domainz），设置了github pages

1
2
3
4
deploy:
  type: git
  repo: git@github.com:yourusername/yourusername.github.io.git
  branch: main

然后在命令行中执行以下命令以部署博客：

1
hexo deploy

前提是已经把本机密钥配置上去了
cat ~/.ssh/id_rsa.pub
ssh-keygen -t rsa -C “youremail@example.com“
执行 cat ~/.ssh/id_rsa.pub，复制输出的字符串。然后登录到托管平台，找到 SSH 密钥的设置页面（如 GitHub 的 SSH and GPG keys），并将刚刚复制的字符串粘贴到这里。

以上就是配置 Hexo 博客的基本步骤。

9. 编辑的源文件上传到git

需要忽略掉public文件夹，这个是动态生成的，我们主要保存config、source以及theme。仓库的根目录下创建一个名为.gitignore的文件，添加

1
touch .gitignore
1
2
3
4
5
6
node_modules/
db.json
package-lock.json
package.json
public/
scaffolds/

10. 其他记录

主题

很久没有重新写博客，next跑起来显示异常，直接找个新的主题Butterfly
Butterfly配置

1
2
git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
sudo npm install hexo-renderer-pug hexo-renderer-stylus --save

Butterfly代码高亮配置

命令

  1. hexo new post “blog title”
  2. hexo g //生成
  3. hexo s //本地服务器运行，通过localhost访问
  4. hexo d //部署

通过以下初始化归档和分类目录

  • hexo new page “categories”
  • hexo new page “tags”
  • 打开 categories 文件夹下的 index.md ，在最下面一行加一行文字就行，注意中间有空格。type: categories;
  • 打开 tags 文件夹下的 index.md ，在最下面一行加一行文字就行，注意中间有空格。type: tags;
  • 通过配置_config.yml的excerpt设置文章的展开全文 0._config.yml–> excerpt = true