标签插件(Tag)

标签插件帮助开发者在文章中快速插入内容。

概要

hexo.extend.tag.register(name, functionargs, content{}, options);

标签函数会传入两个参数:argscontent,前者代表开发者在使用标签插件时传入的参数,而后者则是标签插件所覆盖的内容。

从 Hexo 3 开始,因为新增了非同步渲染功能,而改用 Nunjucks 作为渲染引擎,其行为可能会与过去使用的 Swig 有些许差异。

选项

ends

使用结束标签,此选项默认为 false

async

开启非同步模式,此选项默认为 false

范例

没有结束标签

插入 Youtube 影片。

hexo.extend.tag.register('youtube'functionargs{  var0
  return'<div class="video-container"><iframe width="560" height="315" src="http://www.youtube.com/embed/''" frameborder="0" allowfullscreen></iframe></div>'
});

有结束标签

插入 pull quote。

hexo.extend.tag.register('pullquote'functionargs, content{  var' '
  return'<blockquote class="pullquote''">''</blockquote>'
}, {ends: true

非同步渲染

插入文件。

varrequire'hexo-fs'
varrequire'path'
hexo.extend.tag.register('include_code'functionargs{  var0
  var
    returnfunctioncontent{    return'<pre><code>''</code></pre>'
  });}, {asynctrue