基于Hexo6的博客建设

Hexo框架

Hexo是一个快速、简洁且高效的博客框架。

Hexo使用 Markdown（或其他渲染引擎）解析文章，搭配主题进行静态网页的生成。

Hexo支持Markdown的所有功能，并拥有强大的插件系统。

Hexo6搭建

首先确保系统中已经配置完了Node.js环境，并已经安装了pnpm包管理工具，可参见之前的博客文章

使用以下命令直接进行全局安装，请确保node的node_modules包含在了系统环境变量内，否则无法正常运行hexo命令

npm install hexo-cli -g
cd 切换到工作目录
hexo init blog
cd blog
npm install
hexo server

通过以上命令就已经搭建了默认主体的Hexo博客，但如果觉得这个主题不好看可以换个主题

本教程以indigo主题为例介绍安装过程但原仓库已停止维护，升级到Hexo6的版本在这个仓库，查阅稳定请参考老仓库的文档

cd themes
git clone https://github.com/yscoder/hexo-theme-indigo.git
pnpm install hexo-renderer-less --save   # 使用pnpm进行安装
pnpm install hexo-generator-feed --save
pnpm install hexo-generator-json-content --save
pnpm install hexo-helper-qrcode --save

安装完成后对两份_config.yml配置文档进行修改

Hexo文章页及新主题页设置

文章页的顶头应添加以下说明文档

---
title: 基于Hexo6的博客建设
date: 2023-04-17
categories: 
- Web前端
- JavaScript
tags: 网站建设
---

新主题页通过命令创建

hexo new page friends

并设置说明文档

---
title: 友情链接
description: 友情链接
layout: page
comments: false
reward: false
---

Hexo插件设置

hexo生成的页面可以一键生成并推送到GitHub，由GitHub免费建站，通过插件hexo-deployer-git实现

pnpm install hexo-deployer-git

修改_config.yml添加配置

deploy:
  type: git
  repo: https://github.com/<username>/<project>
  # example, https://github.com/hexojs/hexojs.github.io
  branch: gh-pages

执行命令即可自动部署，警告：如果配置不当该步骤会清空仓库的所有提交记录并从头开始记录

hexo clean
hexo deploy