asciidoctor asciidoctor 包括 adocs 及其图像

Mar*_*art 5 asciidoc asciidoctor

我正在构建我的 asciidoc 模板来管理我的开发文档。因此,我希望能够将现有的 ASCII 文档链接到主/或包含图像和其他资源的新文档中。为了链接文档,我使用include关键字,该关键字可以将文档引用到新文档中。

问题

我的问题是,包含/引用文档的图像未显示。我知道图像的路径分辨率从主文档开始,与包含/引用的文档图像的路径不匹配。所包含文档中的图像路径是正确的。仅生成包含的文档时会显示图像。有没有人有好的解决方案来解决这个问题?

包含图像的无效文档示例

1. 文档的目录结构。

main.adoc 包括包含图像的 Risikoanalysis_v2.adoc

  • ./main.adoc
  • ./Risikoanalysisn/Risikoanalysis_v2.adoc
  • ./Risikoanalysisn/Risikodiagramm_1_v2.png
  • ./Risikoanalysisn/Risikodiagramm_2_v2.png

2.main.adoc文件的内容

== Content 1

ratatata

include::./Risikoanalysen/Risikoanalyse_v2.adoc[]
Run Code Online (Sandbox Code Playgroud)

3. Risikoanalysis_v2.adoc 的内容

= Risikoanalyse 
Inhaltsverzeichnis
:doctype: book
:toc: left
:toclevels: 4
:sectnums:

:version: Version 2.0, 03.03.2019
{version}

<<<
== Risiken
bachelor party

image::Risikodiagramm_1_v2.png[Risikodiagramm,300,align="center"]       // image that is not resolved

<<<
== preventive Gegenmassnahmen
rooftop party

image::Risikodiagramm_2_v2.png[Risikodiagramm,300,align="center"]       // image that is not resolved
Run Code Online (Sandbox Code Playgroud)

4. 生成文档的命令

  • asciidoctor main.doc*
  • asciidoctor-pdf main.doc

pme*_*pme 4

我不确定你是否尝试过。

添加目录中的所有图像./imagesasciidoctor这是获取图像的默认目录。

您的链接保持不变:

image::Risikodiagramm_2_v2.png[Risikodiagramm,300,align="center"]
Run Code Online (Sandbox Code Playgroud)

您可以配置此路径:

:imagesdir: myImages
Run Code Online (Sandbox Code Playgroud)

请参阅https://asciidoctor.org/docs/user-manual/#setting-the-location-of-images