扩展与自定义

Asciidoctor 提供了默认的样式表和内置转换器,使您能够快速处理和转换文档,但它也允许您使用自定义样式表和转换器。Asciidoctor 项目包括来自样式表工厂的替代样式表主题和专业的转换器。您还可以创建自己的主题和转换器。

Asciidoctor 是高度可定制的,提供不同级别的自定义选项。

内置属性

Asciidoctor 有一些内置的文档属性,可以用来控制输出。例如,您可以通过使用 toc 属性来更改 "目录" 的位置。 Asciidoctor 用户手册 描述了每个内置的属性,您可以使用它们。

样式表

如前所述,Asciidoctor 提供了默认的样式表,但您可以 应用替代的主题。 您还可以创建自己的主题。

Docinfo 文件

您可以使用 docinfo 文件向输出文档的头部或尾部添加自定义内容。Docinfo 文件对于向输出文档注入转换器未添加的辅助元数据、样式表和脚本信息非常有用。

模板转换器

模板转换器是一个实现,它使用模板将解析后的 AsciiDoc 文档树中的每个块转换为输出格式。

扩展

Asciidoctor 提供了一个 扩展 API,提供了 一系列扩展点,可以将语言扩展到新的使用场景。

自定义转换器

自定义转换器是用户提供的特定实现,它扩展了 Asciidoctor.Converter 类。