-
之前的版本不一定可用，最低可用版本为
0.1.8：book.json{ "plugins": [ "asciidoc-include@0.1.8" ] } -
gitbook版本：book.json{ "gitbook": ">=2.4.0" }
-
配置说明：
键 类型 值 默认值 说明 syntaxstring
-
asciidoc -
gitbook
asciidoc-
当
syntax === 'asciidoc'时，本插件会将include语法指向文件的内容与该处include语法内容替换 -
当
syntax === 'gitbook'时，本插件会将include语法转化为gitbook的内容引用语法
-
-
配置示例：
book.json{ "pluginsConfig": { "asciidoc-include": { "syntax": "gitbook" } } }
-
当前目录有
a.adoc，b.adoc，c.adoc两个文件，没有d.adoc：-
a.adoc内容如下：a.adoc:cPath : . :dPath : . include::./b.adoc[] include::{cpath}/c.adoc[] include::{dpath}/d.adoc[] I'm a.adoc
-
b.adoc内容如下：b.adocI'm b.adoc
-
c.adoc内容如下：c.adocI'm c.adoc
-
在转化成
HTML之前，asciidoc-include插件会查找a.adoc里面的include语法，根据配置syntax的值采用不同的处理方式-
转化成
a.html前夕的a.adoc:cPath : . :dPath : . I'm b.adoc I'm c.adoc include::{dpath}/d.adoc[] I'm a.adoc
-
转化成
a.html前夕的a.adoc:cPath : . :dPath : . {% include "./b.adoc" %} {% include "{cpath}/c.adoc" %} {% include "{dpath}/d.adoc" %} I'm a.adoc
-
思考：
gitbook方式将:cPath : .这种转化成{% set cPath = "." %}的gitbook模板语法， 然后将include处改成{% include "{{dpath}}/d.adoc" %}，在{% %}里包含{{ }}不一定可用，暂且记录下来
-
-
-
-
不能和
advanced-emoji插件混合使用，如果需要使用，方法如下：-
使用我
fork下来的一份插件代码：-
安装：
book.json{ "plugins": [ "advanced-emoji@git+https://github.com/ZihoRo/gitbook-plugin-advanced-emoji.git" ] }
-
自己
fork，然后按下面说明修改index.js，push到github，剩下的就是上一方法的安装，将自己的github-url替换到git+之后修改前// 省略非关键代码 module.exports = { // 省略非关键代码 hooks: { "page:before": function(page) { if (page.type === "markdown") { // 省略非关键代码 return page; } // 此处应该有 return page; } } };
修改后// 省略非关键代码 module.exports = { // 省略非关键代码 hooks: { "page:before": function(page) { if (page.type === "markdown") { // 省略非关键代码 return page; } return page; } } };
-
向原作者提
bug，我英语不好，就不掺合了
-
-
我不知道其他插件是否也有同样问题，没有去一一看了