0.1.0	2023年10月21日

#1332 in 文本处理

Apache-2.0

210KB
865 代码行

mdbook-asciidoc

为mdbook提供后端，输出AsciiDoc。

安装

要使用，请安装此工具

cargo install mdbook-asciidoc

并在book.toml中将其添加为后端

[preprocessor.asciidoc]

以下配置值可以在book.toml中设置。

名称	类型	默认值	描述
`allow-asciidoc`	布尔值	false	设置时，处理Markdown源中包含的一些AsciiDoc结构。
`heading-offset`	整数	0	对标题级别应用的额外偏移量。
`skip-chapters`	字符串	""	生成AsciiDoc时忽略的文件名列表，用逗号分隔。

当设置allow-asciidoc配置选项时，源文档中的AsciiDoc可以作为类似HTML的标签的content属性包含，以防止它被Markdown解释。

例如，在AsciiDoc中使用四个下划线来分隔块引用，但如果未转义，则会在Markdown中解释为水平线

    <asciidoc content='____'></asciidoc>

~13–25MB
~382K SLoC