hexo

下载运行环境node.js

node.js的安装和管理

安装，推荐版本管理器nvm

可以轻松安装、切换多个版本的node.js

下载最新的长期支持版

1	nvm install lts

查看nodejs版本

nvm list

激活指定版本

1	nvm use 24.11.1

安装hexo

1	npm install -g hexo-cli

ps：由于nvm的特性，启用特定版本nodejs后，npm下载的包会放在对应的版本文件夹下。
但在安装hexo插件时要再hexo blog所在目录bash

初始化博客

hexo init
blog目录应该如下
Pasted image 20251208144042.png|50x50

下载新主题

git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

修改站点配置

打开博客根目录下的 _config.yml 文件，找到 theme 字段，将其值改为新主题的文件夹名。

1
2
3

theme: landscape # 默认是这个
修改为 ↓
theme: butterfly

安装依赖

部分主题可能需要额外的插件，按主题说明安装后，清理并重新生成即可预览。

安装Butterfly所需的渲染器
npm install hexo-renderer-pug hexo-renderer-stylus –save
清理缓存并重新生成
hexo clean
hexo g
hexo s

在hexo的文件中嵌入音频需要在blog根目录bash，使用指令

npm install –save hexo-tag-aplayer 安装插件
npm uninstall -g hexo-tag-aplayer 卸载
npm 检测下载的包列表

githu上新建库来部署本地博客

在github page部署
为了方便后面域名映射，仓库名建议使用 zzmxq(github用户名).gihub.io

本地博客配置

使用hexo后根目录产生config，安装主题后在theme文件夹下也会产生一个config。前者用来管理部署，后者管理blog的具体样式

hexo blog根目录下congfig配置

重要参数
1.timezone：时区选择：Asia/Shanghai
2、url: 博客的地址，填错影响css样式的路径：
3、root：/
4、theme：下载主题后更改为主题名称比如，butterfly
5、deploy：重要，有关部署的位置，
type： ‘git’
repo: 选择上面创建的的仓库的ssh链接，git@github.com:ZZMXQ/zzmxq.github.io.git
branch: 仓库分支，对于git填main

完成以上配置，即可hexo d部署，推荐在仓库网页端主分支main中创建CNAME，写入购买的域名比如blog.zzmzzm.top

到此为止就可以在github page成功看到网页

国内浏览设置

先在阿里云购买一个域名比如zzmzzzm.top

设置购买域名的DNS解析，需要填写

主机记录：zzmzzm的前置子域名比如www，blog，mail，cn，etc。

记录类型：选择CNAME，将购买的域名指向github page的默认网址 比如 https：//用户名.github.io

其他默认设置

Pasted image 20251208143536.png|50x50

回到github page页面，在domin custom中输入完整域名比如blog.zzmzzm.top等待解析完即刻。

以上设置在博客内容较多时加载很慢，最终方案建议将域名备案，再把github托管的文件储存在国内的对象服务器上

每次本地md文件更新内容后hexo generate，然后 hexo d即可，如果含有config的更新先要hexo clean
推送到远程后可能需要重新填写custom domain，且内容更新有延迟

在source目录下创建名为CNAME且不带后缀的纯文本，输入自定义的域名