Tag Plugins@hexo

授人以鱼不如授人以渔

介绍

hexo中的tag plugins给了我们在markdown中使用“局部函数”的能力。同时注意“标签插件”和“Front-matter”中的标签不同,它们是用于在文章中快速插入特定内容的插件。

Quote

在文章中插入引言,可包含作者、来源和标题。

1
2
3
{% blockquote [author[, source]] [link] [source_link_title] %}
content
{% endblockquote %}

Code

在文章中插入代码。

1
2
3
{% codeblock [title] [lang:language] [url] [link text] %}
code snippet
{% endcodeblock %}

另一种形式的代码块,不同的是它使用三个反引号来包裹。
``` [language] [title] [url] [link text] code snippet ```

Pull Quote

在文章中插入“Pull quote”。

1
2
3
{% pullquote [class] %}
content
{% endpullquote %}

jsFiddle

jsFiddle 是一个Web开发人员的练习场,可在线编辑和测试 HTML、CSS、JavaScript代码片段。在 jsFiddle 编辑的代码,可以保存,也可分享给其他人,还可嵌入到网站中。

在文章中嵌入“jsFiddle”。

1
{% jsfiddle shorttag [tabs] [skin] [width] [height] %}

Gist

Gist 是 Github 推出的基于 Git 的代码片段管理服务。用户可以提交自己的代码片段或任意的文本,可以作为个人的代码管理库、文档管理库等。

在文章中嵌入 Gist。

1
{% gist gist_id [filename] %}

iframe

在文章中插入“iframe”。

1
{% iframe url [width] [height] %}

Image

在文章中插入指定大小的图片。

1
{% img [class names] /path/to/image [width] [height] "title text 'alt text'" %}

Link

在文章中插入链接,并自动给外部链接添加target="_blank"属性。

1
{% link text url [external] [title] %}

Include Code

插入source/downloads/code文件夹内的代码文件。source/downloads/code不是固定的,取决于你在配置文件中code_dir的配置。

1
{% include_code [title] [lang:language] path/to/file %}

Youtube

1
{% youtube video_id %}

Vimeo

Vimeo 是一个高清视频播客网站,与大多数类似的视频分享网站不同,Vimeo允许上传1280X700的高清视频,上传后Vimeo会自动转码为高清视频,源视频文件可以自由下载,它达到了真正的高清视频标准。

1
{% vimeo video_id %}

Raw

如果您想在文章中插入Swig标签,可以尝试使用”Raw”标签,以免发生解析异常。

1
2
3
{% raw %}
content
{% endraw %}

文章摘要和截断

在文章中使用<!-- more -->,那么<!-- more -->之前的文字将会被视为摘要。首页中将只出现这部分文字,同时这部分文字也会出现在正文之中。
注意,摘要可能会被Front Matter中的excerpt覆盖。

参考资料

官方文档:https://hexo.io/zh-cn/docs/tag-plugins

0%