从 asciidoctor 激活 plantuml

Question

我想从 asciidoctor 激活 plantuml

我从 asciidctor 了解到：

锚点：id[可选外部引用标签]

等于

[[id,可选的外部引用标签]]

但是锚在哪里？

linux 安装了 mint asciidoctor 1.5.6 GraphViz

使用 asciidoctor 插件在 IntelliJ 中预览不工作

plantuml::images/diagramm.puml[] // 有效

[plantuml,images/diagramm.puml] // 无效

如何写出正确的embedding？

Answer 1

您在问两个不同的问题。

首先，anchor:id[optional xref label] 语法等同于 [[id, optional xref label]]。这些提供了 cross-reference 链接可以指向的文档中的目标位置，但锚点本身不可见。可选标签用于标记指向锚点的链接。

比如当这个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] 只会指定 ID 为 plantuml 的锚点，任何指向它的 cross-reference 链接都将按字面意思标记为 images/diagramm.puml.

Answer 2

“asciidoc”intellij 扩展可以渲染 plantuml，
通过添加 kroki url (https://world-tsp-ci-assurance.is.echonet/kroki/) 变成以下形式：

/File/settings/Languages&Frameworks/AsciiDoc/Use kroki to render diagram instead of Asciidoctor Diagram/url of custom kroki instance

这将激活所有 kroki 支持的语言：不仅是 plantuml：

actdiag 
blockdiag   
bpmn    
bytefield   
c4plantuml  
ditaa   
erd 
excalidraw  
graphviz    
mermaid 
nomnoml 
nwdiag  
packetdiag  
plantuml    
rackdiag    
seqdiag 
svgbob  
umlet   
vega    
vegalite    
wavedrom

从 asciidoctor 激活 plantuml

activiating plantuml from asciidoctor

plantuml

asciidoctor