The documentation is a work in progress, and English edition is just an empty shell for now. I will translate it when Chinese edition has done.
嵌入文件就是由嵌入链接引入的文件,它会替代链接字符串进行渲染。
你可以用它将一个大文件分成几个小文件,也可以用来创建会多次使用的片段文件。如果嵌入链接和标题标记(二至六级)配合使用,它就会成为一个能自适应嵌入标题层级的块嵌入(嵌入文件的标题为块标题,在它下面的标题会自动降级)。它还支持通过嵌入链接语法传递参数,因此也具有模板的功能。
嵌入参数
嵌入参数使用 Mustache 语法({{ }}
)占位,它有序号(从 0 开始)和字符串两种索引方式({{ 0 }}
或 {{ a }}
),字符串(命名)参数也可以用对应序号索引,用 |
分开的部分会作为索引值为 undefined
时的默认值({\{ 0| }}
,转义了 {
以避免被替换)。
文件切片
文件切片标记会将文件内容划分为多个切片,你可以通过传入命名参数 slice
来指定需要嵌入的切片序号(从 0 开始,如果为 random
则随机选取)或命名字符串(和嵌入参数类似),没有这个参数文件就不会被切分。
嵌入参数的执行优先级最高,然后是文件切片,最后才是行内脚本,这意味着你可以将传入的参数作为脚本代码的一部分执行。
- This page is open source, improve it