Hexo User Manual

发表于 更新于
Hexo博客配置杂记

VSCode + Hexo

安装Paste Image插件

安装完插件后，通过 Ctrl + Shift + P 快捷键打开setting.json
Open Settings(JSON)

然后，在setting.json文件中添加两行配置

1
2
"pasteImage.path": "${currentFileNameWithoutExt}/",
"pasteImage.insertPattern": "{% asset_img ${imageFileName} %}",

然后就可以使用Ctrl + Alt + V快捷键就可以粘贴图片到markdown文档中了。但是这个快捷键不一定好使。也可以通过Ctrl + Shift + P然后输入past image来粘贴。
插入的图片采用asset_img语法，关于asset_img详细信息可参考：https://hexo.io/docs/asset-folders。插入的图片将会放到markdown文件同名的文件夹中。

安装Markdown Preview Enhanced插件

Markdown Preview Enhanced插件无法展示使用asset_img插入的图片，需要修改插件的parser.js。通过快捷键Ctrl+Shift+P打开parser.js:
Extent Parser
然后修改onWillParseMarkdown函数：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
onWillParseMarkdown: function(markdown) {
  var vscode = require("vscode");
  var path = require("path");
  return new Promise((resolve, reject)=> {
    markdown = markdown.replace(
      /\{%\s*asset_img\s*(\S+)\s*\S*\s*%\}/g,
      (whole, content) => {
        abs_filename = vscode.window.activeTextEditor.document.fileName
        filename = path.basename(abs_filename);
        filename = filename.substring(0,filename.indexOf('.'))
        return `![](${filename + "/"+ content})`;
      }
    )
    return resolve(markdown)
  })
},

参考文章：

主页配置显示文章摘抄

默认情况下，在主页中会把整个文章都显示了，导致主页特别乱。可以通过在文章中插入下面代码来截取摘抄：

1
<!-- more -->

也可以通过description字段来单独撰写摘抄。

代码段

可以通过代码段标签raw来禁止Markdown引擎渲染标签内的内容。

VSCode中预览hexo的图片

支持 plantuml 画图

hexo-filter-plantuml
示例：

UserUserFirst ClassFirst ClassSecond ClassSecond ClassLast ClassLast ClassDoWorkCreateRequestDoWorkWorkDoneRequestCreatedDone

支持 GraphViz 画图

使用hexo-tag-viz插件来绘制。支持把dot或viz代码块渲染成graphviz图形。
可以通过 engine=xxx 来选择不同的渲染引擎。支持的引擎包括 circo，dot，neato，osage，或者 twopi。默认使用 dot 引擎。

``` viz
digraph {
A -> {B; C; D}
}
```
%0 A A B B A->B C C A->C D D A->D

通过engine参数指定引擎：

``` viz engine=neato
digraph {
A -> {B; C; D}
}
```
%0 A A B B A->B C C A->C D D A->D

链接本站文章

官方介绍：引用文章

1
{% post_link android/Android-Activity启动流程 %}

对应的完整路径是：source/_posts/android/Android-Activity启动流程.md。