активирующий плантумл от asciidoctor

Я хочу активировать plantuml от asciidoctor

От asciidctor я узнал:

привязка: идентификатор [необязательный xreflabel]

равно

[[id, необязательный xreflabel]]

а где якорь?

Linux Mint Asciidoctor 1.5.6 GraphViz установлен

предварительный просмотр в IntelliJ с плагином asciidoctor не работает

plantuml::images/diagramm.puml[] // работает

[plantuml,images/diagramm.puml] // не работает

как написать правильную вставку?


person Hendrik Timmermann    schedule 11.07.2019    source источник


Ответы (1)


Вы задаете два разных вопроса.

Во-первых, синтаксис anchor:id[optional xref label] эквивалентен [[id, optional xref label]]. Они обеспечивают целевое местоположение в документе, на которое могут указывать перекрестные ссылки, но привязки сами по себе не видны. Необязательная метка используется для обозначения ссылок, указывающих на якоря.

Например, когда этот документ Asciidoctor преобразуется в HTML:

= Document

First: anchor:alice[Alice]

Second: [[bob, Bob]]

Link to <<alice>>.

Link to <<bob>>.

HTML выглядит так:

...
<div id="header">
<h1>Document</h1>
</div>
<div id="content">
<div class="paragraph">
<p>First: <a id="alice"></a></p>
</div>
<div class="paragraph">
<p>Second: <a id="bob"></a></p>
</div>
<div class="paragraph">
<p>Link to <a href="#alice">Alice</a>.</p>
</div>
<div class="paragraph">
<p>Link to <a href="#bob">Bob</a>.</p>
</div>
</div>
...

Если ваш документ содержит привязку, но никогда не ссылается на нее, разметка привязки не будет выводиться.

На второй вопрос вы уже ответили. Когда расширение asciidoctor-plantuml установлено, оно обеспечивает поддержку макроса plantuml:. Всякий раз, когда вы включаете plantuml::path/to/plantuml/diagram.puml[] в свой документ, расширение отображает указанный файл диаграммы PlantUML и выдает результирующее изображение, где макрос должен был появиться в выходных данных.

Использование [plantuml,images/diagramm.puml] будет указывать только якорь с идентификатором plantuml, а любые перекрестные ссылки, указывающие на него, будут буквально помечены images/diagramm.puml.

person eskwayrd    schedule 11.07.2019
comment
Можно ли дать id другое определение как путь к puml-файлу? - person Hendrik Timmermann; 16.07.2019
comment
хммм, я не добавлял расширение plantuml, я добавил asciidoctor-диаграмму - person Hendrik Timmermann; 16.07.2019
comment
См. [ссылка] (stackoverflow.com/questions/57037280/) также - person Hendrik Timmermann; 25.07.2019
comment
Да, вы можете указать идентификатор для любого блока. Добавьте [[id]] в строку, непосредственно предшествующую блоку, который должен получить идентификатор. - person eskwayrd; 25.07.2019
comment
asciidoctor-diagram может вызывать PlantUML для рендеринга, но сам не устанавливает PlantUML. - person eskwayrd; 25.07.2019