Asciidoc Asciidoctor включают в себя adocs и их изображения - PullRequest
2 голосов
/ 10 марта 2019

Я создаю свой шаблон asciidoc для управления моей документацией по разработке. Поэтому я хочу иметь возможность связать существующие документы ascii с основным / или новым документом , включая изображения и другими ресурсами. Для связывания документов я использую ключевое слово include , которое используется для ссылки на документы в новом.

Проблема

Моя проблема в том, что изображения включенного / указанного документа не отображаются. Мне известно, что разрешение пути для изображения начинается с основного документа и не совпадает с путем из включенные / ссылающиеся изображения документа. Пути к изображениям во включенном документе правильные. Изображения отображаются при создании только включенного документа. У кого-нибудь есть хорошее решение, чтобы решить это?

Пример неработающего документа с изображениями

1. Структура каталогов документов.

main.adoc включает Risikoanalyse_v2.adoc, который содержит изображения

  • . / Main.adoc
  • . / Risikoanalysen / Risikoanalyse_v2.adoc
  • . / Risikoanalysen / Risikodiagramm_1_v2.png
  • . / Risikoanalysen / Risikodiagramm_2_v2.png

2. Содержание документа main.adoc

== Content 1

ratatata

include::./Risikoanalysen/Risikoanalyse_v2.adoc[]

3. Содержание Risikoanalyse_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

4. Команда для генерации документов

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

1 Ответ

2 голосов
/ 15 марта 2019

Я не уверен, что вы пробовали это.

Добавить все изображения в каталог ./images. Это каталог по умолчанию, из которого asciidoctor получает изображение.

Ваши ссылки остаются прежними:

image::Risikodiagramm_2_v2.png[Risikodiagramm,300,align="center"]

Вы можете настроить этот путь:

:imagesdir: myImages

См. https://asciidoctor.org/docs/user-manual/#setting-the-location-of-images

...