一款博客框架 hexo 的安装和使用说明

安装 hexo

  1. 安装node.js

  2. 安装git

  3. 安装 hexo

    npm install -g hexo-cli

初始化 hexo 项目

1
2
3
cd <folder>
hexo init
npm install

安装主题

  1. 找一个自己喜欢的主题: hexo 主题商店

  2. 使用npm直接安装到node_modules，或者git clone安装到source/themes

  3. 修改主目录下的_config.yml

    1
    theme: ayer # 新主题名

配置 GitHub Pages

1
2
3
4
5
6
7
- url: https://hmmmmmya.github.io

deploy:
    type: git # 不要使用github
    repo: git@github.com:hmmmmmya/hmmmmmya.github.io.git # 使用ssh连接
    branch: main # 分支
    message: add new blog # 自动部署commit备注，可不填

注意 url 不能直接拷贝仓库地址https://github.com/hmmmmmya/hmmmmmya.github.io, 否则显示会有问题, 要写成https://hmmmmmya.github.io

hexo 使用 git 前要先安装hexo-deployer-git

1
npm install hexo-deployer-git --save

hexo 常用命令

1
2
3
4
5
hexo n "我的博客" == hexo new "我的博客" #新建文章
hexo g == hexo generate #生成
hexo s == hexo server #启动服务本地预览
hexo d == hexo deploy #部署
hexo clean #清除缓存 网页正常情况下可以忽略此条命令

  • 创建博客也可以在 source/_posts目录下创建 markdown

  • 本地调试用 hexo g 和 hexo s, 需要清除本地生成的内容则用hexo clean

  • 调试时修改并保存, 本地网页能动态加载的, 不需要再重新生成再加载

  • 本地调试无问题后，使用 hexo d部署到 GitHub。提交前要重新hexo g生成下

  • hexo clean可用于提交代码时清除本地的 public 内容, 若配置了.gitignore 则提交代码时可以不用此命令

hexo 分类和标签

创建分类

1.1 生成“分类”页并添加 tpye 属性
打开命令行，进入博客所在文件夹。执行命令

1
hexo new page categories`

成功后会提示：

1
INFO  Created: ~/Documents/blog/source/categories/index.md

根据上面的路径，找到 index.md 这个文件，打开后默认内容是这样的：

1
2
3
4
---
title: 文章分类
date: 2017-05-27 13:47:40
---

按照更换的主题指示修改后

1
2
3
4
5
6
---
title: categories
type: "categories"
layout: "categories"
date: 2024-06-07 17:19:12
---

创建分类成功，保存并关闭文件。

1.2 给文章添加“categories”属性
打开需要添加分类的文章，为其添加 categories 属性。下方的 categories: web 前端表示添加这篇文章到“web 前端”这个分类。注意：hexo 一篇文章只能属于一个分类，也就是说如果在“- web 前端”下方添加“-xxx”，hexo 不会产生两个分类，而是把分类嵌套（即该文章属于 “- web 前端”下的 “-xxx ”分类）。

1
2
3
4
5
6
7
8
9
---
title: 搭建博客
categories:
  - web前端
tags:
  - Hexo
  - 博客
date: 2024-06-07 17:01:12
---

这里categories自己随意修改，但只能有一个，不需要再修改categories目录的 index 文件。

至此，成功给文章添加分类，点击首页的“分类”可以看到该分类下的所有文章。当然，只有添加了 categories: xxx 的文章才会被收录到首页的“分类”中。

创建标签

2.1 生成“标签”页并添加 tpye 属性
打开命令行，进入博客所在文件夹。执行命令

1
hexo new page tags

默认内容

1
2
3
4
---
title: 标签
date: 2017-05-27 14:22:08
---

修改后

1
2
3
4
5
6
---
title: tags
type: "tags"
layout: "tags"
date: 2024-06-07 17:20:13
---

创建标签成功，保存并关闭文件。

2.2 给文章添加“tags”属性

1
2
3
4
5
6
7
8
9
---
title: 搭建博客
categories:
  - web前端
tags:
  - hexo
  - 博客
date: 2024-06-07 17:01:12
---

这里tags自己随意增加，不需要再修改tags目录的index文件。

参考