hexo必装插件及安装脚本

请先确保电脑上已经安装了必须的软件,如 node.jsgit ,因为日常需要使用 代码数学公式流程图搜索 等工具,所以下方的插件安装也主要是与此相关的。

注意:以下仅适用于 hexo-next 主题。

插件安装

先放一个博客 islet.space 需要使用到的插件,都需要使用 npm 进行安装。

本博客使用到的一些插件

将下方这段脚本保存至 hexo_install.sh 文件中,并使用 chmod +x hexo_install.sh 命令为其添加执行权限,并使用 ./hexo_install.sh 进行执行即可。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# uninstall the unnecessary renderer,like marked and kramed
sudo npm uninstall hexo-renderer-marked --save
sudo npm uninstall hexo-renderer-kramed --save


# install the necessary plugins for hexo
sudo npm install @fancyapps/fancybox --save
sudo npm install @fortawesome/fontawesome-free --save
sudo npm install @next-theme/pjax --save
sudo npm install @next-theme/plugins --save
sudo npm install hexo-deployer-git --save
sudo npm install hexo-filter-mermaid-diagrams --save
sudo npm install hexo-generator-searchdb --save
sudo npm install hexo-math --save
sudo npm install hexo-renderer-ejs --save
sudo npm install hexo-renderer-pandoc --save
sudo npm install hexo-renderer-stylus --save

插件启用

pandoc

若要启用pandoc进行渲染,除了之前必须要卸载旧的渲染器(如 markedkramed 外),还需要去github页面下载一个pandoc的渲染器软件并进行安装。

pandoc下载链接:https://github.com/jgm/pandoc/releases

mermaid

mermaid需要显示的话也需要安装插件,需要在hexo-next主题文件夹下的 _config.yml 文件中进行启用,如下:

mermaid在主题配置文件中的启用

latex

latex数学公式可以由 pandoc 渲染器进行渲染,只需要在hexo-next主题文件夹下的 _config.yml 文件中启用 mathjax ,如下:

数学公式在主题配置文件中的启用

搜索功能功能不仅需要安装插件,还需要分别在博客文件夹根目录中的 _config.yml 和 hexo-next主题文件夹下的 _config.yml 文件中进行启用,如下:

博客根目录配置文件下的启用

注意:此处的 db.json 需要在 public 文件夹中也有一份的时候启用;如果 db.json 无法使用,则更换为 search.xml 。因为 db.jsonsearch.xml 是由插件生成的搜索数据库(可以这么看)。

hexo主题配置文件下的启用