从多个 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会在导出完成后第一时间通知您(见下图)
我正在尝试将现有的 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会在导出完成后第一时间通知您(见下图)