Dev::Coder 在電梯裡遇見雙胞胎
首頁 | 關於我 | 筆記 // 當你開始尋找,你就已經在前往的路上...

Plugins 可以用來擴充 AsciiDoc,分為 backend、filter 跟 theme 三種。

asciidoc 可以用來管理這些 plugins:

asciidoc (--backend | --filter | --theme) install <plugin_zip>
asciidoc (--backend | --filter | --theme) remove <plugin_name>
asciidoc (--backend | --filter | --theme) list

list 可以用來查看已經安裝(或內建)的 plugins,以 filters 為例:

$ asciidoc --filter list
$ASCIIDOC_DIR/filters/code
$ASCIIDOC_DIR/filters/music
$ASCIIDOC_DIR/filters/source
...

Plugins 都是以 .zip 的形式佈署,可以用 install 將它安裝到 plugins dir (~/.asciidoc/backends~/.asciidoc/filters~/.asciidoc/themes)底下,每個 plugin 會被安裝在以 plugin name 為名的子資料夾裡。

ditaa 為例:

$ asciidoc --filter install ditaa-filter-1.1.zip 1
$ asciidoc --filter list
$ASCIIDOC_DIR/filters/code
$ASCIIDOC_DIR/filters/music
$ASCIIDOC_DIR/filters/source
...
~/.asciidoc/filters/ditaa
1 plugin name 只能由英數字跟底線組成,而且 .zip 的檔名也規定必須以 plugin name 做為開頭。就這個例子而言,ditaa 就是 plugin name,因為接下來的 -filter-1.1 不是合法的字元。

覺得這份文件有幫助?別忘了按個讚並分享給更多的人、留下你/您的意見...

comments powered by Disqus