asciidoctor(1)

包含文档和资源的基目录。默认为包含源文件的目录，或者，如果源是从流中读取的，则为当前工作目录。当与安全模式设置结合使用时，可用于 chroot 程序执行。

设置安全模式级别：unsafe、safe、server 或 secure。禁用源文件中潜在的危险宏，例如 include::[]。如果未设置，当使用此脚本调用 Asciidoctor 时，安全模式级别默认为 unsafe。

将安全模式级别设置为 safe。启用 include 指令，但阻止访问源文件的祖先路径。为兼容 asciidoc 命令而提供。如果未设置，当使用此脚本调用 Asciidoctor 时，安全模式级别默认为 unsafe。

定义、覆盖或取消设置文档属性。命令行属性优先于源文件中定义的属性，除非名称或值以 @ 结尾。不对值应用任何替换。

后端输出文件格式：开箱即用的支持 html5、docbook5 和 manpage。您还可以使用后端别名 html（别名为 html5）或 docbook（别名为 docbook5）。可以传递其他值，但如果 Asciidoctor 无法将后端解析为转换器，它将失败。默认为 html5。

文档类型：article、book、manpage 或 inline。在使用 docbook 后端时设置根元素，在使用 html 后端时设置 HTML body 元素的样式类。book 文档类型允许单个文档中有多个 0 级章节标题。manpage 文档类型启用对生成 man page 所需元数据的解析。inline 文档类型允许将单个段落的内容进行格式化并返回，而无需将其包装在容器元素中。默认为 article。

目标输出目录。默认为包含源文件的目录，或者，如果源是从流中读取的，则为当前工作目录。如果指定，则目录相对于当前工作目录解析。

用于自定义转换器模板的模板引擎。与引擎同名的 gem 将被自动加载。此名称也用于构建自定义转换器模板的完整路径。如果未指定模板引擎，将根据找到的自定义转换器模板的文件扩展名自动检测。

输出可嵌入的文档，其中不包含头部、尾部以及正文之外的所有内容。此选项对于生成可以插入到外部模板中的文档很有用。

将指定目录添加到加载路径，以便 -r 可以从默认 Ruby 加载路径之外加载扩展。此选项可以指定多次。

自动编号章节标题。--attribute sectnums 的同义词。

将输出写入文件 输出文件。默认为输入文件的基本名称，后跟 backend 扩展名。文件相对于当前工作目录解析。如果输入是从标准输入或命名管道 (fifo) 读取的，则输出文件默认为 stdout。如果 输出文件 是 -，则输出文件将写入标准输出。

源目录。目前仅在同时指定了目标目录时使用。用于在目标目录中保留在此目录内转换的文件的目录结构。如果指定，则目录相对于当前工作目录解析。

在执行处理器之前，使用标准的 Ruby require 加载指定的库。此选项可以指定多次。

输出可嵌入的文档，其中不包含头部、尾部以及正文之外的所有内容。此选项对于生成可以插入到外部模板中的文档很有用。

包含自定义转换器模板的目录，这些模板将覆盖内置集中的一个或多个模板。（需要 tilt gem）

设置产生非零退出代码（即失败）的最低日志级别（默认值：FATAL）。如果未设置此选项，即使记录了警告或错误，程序也会以零退出代码退出。

静默应用程序日志消息和脚本警告。

在报告错误时包含回溯信息。

将日志级别设置为 DEBUG，以便在 INFO 或 DEBUG 级别记录的应用程序消息会打印到 stderr。

打开脚本警告（适用于已执行的代码）。

将计时报告打印到 stderr（读取、解析和转换时间）。

打印帮助消息。如果不指定或不识别 主题，则显示命令用法。如果 主题 是 manpage，则转储 Asciidoctor man page（以 troff/groff 格式）。如果 主题 是 syntax，则打印 AsciiDoc 语法备忘单（以 AsciiDoc 格式）。

打印程序版本号。