hexo常用指令·

1
2
3
4
5
6
hexo clean        #清除缓存文件 (db.json) 和已生成的静态文件 (public)
hexo g #生成静态文件
hexo d #部署到网站 简化为 hexo g -d
hexo s #启动本地服务器
hexo n "title" #新建一篇文章,标题为title
hexo version #显示 Hexo 版本

准备工作·

​ 完成Hexo环境搭建,参考Hexo博客搭建

官方文档

安装Butterfly主题·

​ 参考Hexo 配置butterfly主题

Hexo-Butterfly主题配置

美化·

参考·

Butterfly美化

关于我的Butterfly主题的所有优化 | Modesty (hr-insist.github.io)

♪(*)欢迎回来!Butterfly主题美化日记 | Akilarの糖果屋

Math·

使用Mathjax·

尽管butterfly官文文档推荐使用KaTex,但是我按照官方文档的步骤后,需要换行的数学公式显示有问题,所以退而求其次使用Mathjax。

  1. 修改主题配置文件_butterfly_config.yml

    1
    2
    3
    4
    5
    mathjax:
    enable: true
    # true 表示每一页都加载mathjax.js
    # false 需要时加载,须在使用的Markdown Front-matter 加上 mathjax: true
    per_page: false

    如果 per_page 设为 true,则每一页都会加载 Mathjax 服务。设为 false,则需要在文章 Front-matter 添加 mathjax: true,对应的文章才会加载 Mathjax 服务。

  2. 安装渲染插件

    1
    2
    npm uninstall hexo-renderer-marked --save  #如果有其他的数学渲染插件,一并删除
    npm install hexo-renderer-kramed --save

    安装新的插件后,要重新打开cmd窗口才会生效。

  3. 配置hexo的配置文件_config.yml

    1
    2
    3
    4
    5
    6
    7
    8
    kramed:
    gfm: true
    pedantic: false
    sanitize: false
    tables: true
    breaks: true
    smartLists: true
    smartypants: true

解决在hexo中无法显示数学公式的问题·

修改node_modules\kramed\lib\rules\inline.js文件

hexo-renderer-kmared渲染引擎仍然存在一些语义冲突问题,到博客的根目录下,找到node_modules\kramed\lib\rules\inline.js,把第11行的escape变量的值做相应的修改:

1
2
3

//escape: /^\\([\\`*{}\[\]()#$+\-.!_>])/,
escape: /^\\([`*\[\]()#$+\-.!_>])/,

这一步是在原基础上取消了对,{,}的转义(escape)。

同时把第20行的em变量也要做相应的修改。

1
2
3

//em: /^\b_((?:__|[\s\S])+?)_\b|^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,
em: /^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,

重启hexo:

1
2

复制成功hexo cl && hexo g && hexo s

行间公式无法换行可将公式中双反斜线 \\ 换行不好用,改为4个反斜线 \\\\ 换行即可。

hexo 更换 markdown渲染器 @upupming/hexo-renderer-markdown-it-plus_hexo render-CSDN博客

https://akilar.top/posts/f99b208/)

引用本地图片·

首先要在 Hexo 博客配置添加一行[1]

1
2
# 开始使用本地静态资源
post_asset_folder: true

添加这行配置后,当你什么插件也没安装时,使用 hexo 4.0 也可以在文章引用本地图片,引用方式是这样的:

首先在 _posts 文件夹下建立一个博文文件,比如 2019-12-23-hello-world.md,再建立一个同名的文件夹 2019-12-23-hello-world。这篇文章要引用的图片就放在该文件夹下。

或者 hexo new 2019-12-23-my-post

比如我就在该目录下放一个图片2019-12-23-hello-world/haha.png。然后在博文 Markdown 文件里引用该图片,怎么引用呢?用下面这种方式:

1
![](haha.png)

发布文章·

1.新建文章·

hexo博客目录下,进入Git Bash命令窗口中,输入以下命令:

1
hexo new "title"

就会在博客目录下的/source/_posts/ 文件夹下,可以看到已经生成了标题为(title.md)的博客文件。

2.给文章添加分类和标签·

(1) 在(title.md)文件中设置tagscategories属性:

1
2
3
4
5
6
title: XX
date: XX
tags:
- 博客 //多个标签可以这样添加
- hexo
categories: 备忘录

3.启动服务器,本地测试·

1
hexo  s

4.发布到Github上·

(1)发表的文章在本地预览无误后,在 Git Bash 命令窗口执行以下命令:

1
hexo clean && hexo g && hexo d