从多个 Asciidoc 文件生成单个 PDF

Generate single PDF from multiple Asciidoc files

我正在尝试将现有的 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 文件的旁边。我要指定目标路径。

我会很感激每一个提示。谢谢并致以最诚挚的问候。塞巴斯蒂安

您考虑过使用 includes 吗?

只需将“01-intro.adoc”添加到此行的任意位置:

include::02-next-file.adoc[]

当您使用常规命令构建 01-intro.adoc 时,02-next-file.adoc 的内容将被放入包含行的位置。使用这种方法,我们创建了一个包含许多包含的文件,然后只构建该文件。我们对此非常满意。

(2021 年 12 月 26 日)

最简单和最方便的方法是将 VSCode IDE 与 AsciiDoc extension installed. This extension is developed by the same team that develops the AsciiDoctor 文本处理器一起使用。这是一种基于 GUI 的方法,可以解决您的所有问题,所以我敢肯定您会喜欢它的。

(第1步)安装扩展后,使用键盘快捷键Cmd+,进入设置,然后输入asciidoc.use_asciidoctorpdf 在搜索栏中勾选复选框(见下面的演示)

(第 2 步) 要从多个 .adoc 文件创建一个 pdf 文件,只需将它们全部放在一个 .adoc 文件中include::directory-to-the-adoc-file.adoc[](见下图)

(第 3 步)F1,然后输入 as pdf 并按 Enter 导出单曲 .adoc文件作为单个 PDF 文件,这将允许您指定 PDF 的目标导出目录。请耐心等待几秒钟导出完成,IDE会在导出完成后第一时间通知您(见下图)