我正在尝试将现有的 asciidoc 文档转换为 pdf。 Asciidoctor-pdf 看起来很简单，我可以将单个文件转换为 pdf。
asciidoctor-pdf -a pdf-theme='./theme/styles.yml' -a pdf-fontsdir='GEM_FONTS_DIR, theme/fonts/' 01-intro.adoc
但我的文档分布在许多文件中。我想从所有这些文件中创建一个 pdf。有人知道怎么做吗？
其次，我不希望生成的 pdf 位于 adoc 文件的旁边。我想指定一个目标路径。
我会很感激每一个提示。谢谢和最好的问候。塞巴斯蒂安
【问题讨论】：
标签： asciidoc asciidoctor asciidoctor-pdf
（2021 年 12 月 26 日）
最简单方便的方法是使用安装了AsciiDoc extension 的VSCode IDE。此扩展由开发AsciiDoctor 文本处理器的同一团队开发。这是一种基于 GUI 的方法，可以解决您的所有问题，所以我很确定您会喜欢它的。
（步骤1） 安装扩展后，使用键盘快捷键Cmd + , 进入设置，然后在搜索栏中输入asciidoc.use_asciidoctorpdf 并打勾盒子（见下面的演示）
（第 2 步） 要从多个 .adoc 文件创建一个 pdf 文件，只需将它们全部放在一个带有 include::directory-to-the-adoc-file.adoc[] 的 .adoc 文件中（见下图）
（第 3 步） 按F1，然后输入as pdf 并点击Enter 将这个.adoc 文件导出为单个PDF 文件，这将允许u 指定 PDF 的目标导出目录。请耐心等待几秒钟导出完成，IDE会在导出完成后立即通知您（见下图）
【讨论】：
您是否考虑过使用包含？
只需在您的文档中添加“01-intro.adoc”这一行的任何位置：
include::02-next-file.adoc[]
当您使用常规命令构建01-intro.adoc 时，02-next-file.adoc 的内容将被放到包含行的位置。使用这种方法，我们创建一个包含许多包含的文件并构建该文件。我们对此非常满意。
【讨论】：