📖 本教程更新于 2021 年 10 月 09 日

安装 hexo

1
npm install hexo -g

hexo 常用指令

1
2
3
4
hexo clean # 清空hexo,主要删除Hexo根目录下的public文件夹
hexo g # 重新成功public文件夹内容
hexo s # 启动本地hexo服务
hexo d # 发布到远程仓库

初始化 hexo

1
hexo init

安装 deploter-git 插件

1
npm install hexo-deployer-git

Hexo 发布到 github 的时候,会丢失 reanme 和 CNAME

1
npm install hexo-generator-cname

安装主题 Butterfly

官方网站

在博客根目录安装主题

1
npm i hexo-theme-butterfly

安装渲染器

1
npm install hexo-renderer-pug hexo-renderer-stylus --save

修改 hexo 配置文件_config.yml,把主题改为Butterfly

1
theme: Butterfly

其余配置请参考主题的配置文档

升级主题 Butterfly

在博客根目录安装主题

1
npm update hexo-theme-butterfly

常用插件

本地搜索

安装插件

1
npm install hexo-generator-search --save

_config.yml中配置插件

1
2
3
4
search:
path: search.xml
field: post
content: true

RSS

安装插件

1
npm install hexo-generator-feed --save

_config.yml中配置插件

1
2
3
4
5
6
7
8
9
10
11
12
feed:
type: atom
path: atom.xml
limit: 20
hub:
content:
content_limit: 140
content_limit_delim: " "
order_by: -date
icon: icon.png
autodiscovery: true
template:

豆瓣

安装插件

1
npm install hexo-butterfly-douban --save

_config.yml中配置插件

1
2
3
4
5
6
7
8
9
10
11
douban:
user: 208531615
builtin: false
movie:
title: "电影"
quote: "那些年好看的电影,什么时候在来重新回顾呢"
meta: true
comments: true
top_img: https://i.loli.net/2021/01/30/bn8hatkJd4euIRl.jpg
aside: true
timeout: 10000

添加萌宠

1
2
npm install hexo-helper-live2d --save
# 参考文章:https://vonsdite.cn/posts/fbd1f97f.html

安装 sitmap 插件

1
2
npm install hexo-generator-sitemap --save
npm install hexo-generator-baidu-sitemap --save

卸载 hexo

1
npm uninstall hexo