# 標簽插件(Tag)
標簽插件幫助開發者在文章中快速插入內容。
## 概要
```
hexo.extend.tag.register(name, functionargs, content{}, options);
```
標簽函數會傳入兩個參數:`args` 和 `content`,前者代表開發者在使用標簽插件時傳入的參數,而后者則是標簽插件所覆蓋的內容。
從 Hexo 3 開始,因為新增了非同步渲染功能,而改用 [Nunjucks](http://mozilla.github.io/nunjucks/) 作為渲染引擎,其行為可能會與過去使用的 [Swig](http://paularmstrong.github.io/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
```
- 文檔
- 開始使用
- 概述
- 建站
- 配置
- 指令
- 遷移
- 基本操作
- 寫作
- Front-matter
- 標簽插件(Tag Plugins)
- 資源文件夾
- 數據文件
- 服務器
- 生成文件
- 部署
- 自定義
- 永久鏈接(Permalinks)
- 主題
- 模版
- 變量
- 輔助函數(Helpers)
- 國際化(i18n)
- 插件
- 其他
- 問題解答
- 貢獻
- API
- 核心
- 概述
- 事件
- 局部變量
- 路由
- Box
- 渲染
- 文章
- 腳手架(Scaffold)
- 主題
- 擴展
- 控制臺(Console)
- 部署器(Deployer)
- 過濾器(Filter)
- 生成器(Generator)
- 輔助函數(Helper)
- 遷移器(Migrator)
- 處理器(Processor)
- 渲染引擎(Renderer)
- 標簽插件(Tag)