Я использую Asciido c и Plant UML в IntelliJ для написания документации.
Там я столкнулся со странной проблемой с включением диаграмм. Я нашел способ заставить это работать, но я не понимаю почему. Я хотел бы знать, почему он работает так, как работает.
Я использую следующее утверждение для включения диаграммы UML Plant на страницу:
["plantuml","containers"]
----
include::../diagrams/containers.puml[]
----
Однако вместо включения ../diagrams/containers.puml
, как и предполагалось, это включает в себя диаграмму, отличную от кажущегося несвязанным ресурсом ../external-references/diagrams/external-components.puml
, а затем масштабирует его до размера ../diagrams/containers.puml`.
По какой-то причине это происходит только для этого включает в себя заявление. Следующее включение другой диаграммы PUML, например, работает независимо от того, где в AsciDo c я ее положил:
["plantuml","system-context"]
----
include::../diagrams/system-context.puml[]
----
Теперь, как упоминалось ранее, мне удалось заставить его работать, изменив полное утверждение к следующему (удаление ",containers"
в заголовке):
["plantuml"]
----
include::../diagrams/containers.puml[]
----
Для меня это вызывает два вопроса:
- Почему включение работает для
system-context.puml
но не для containers.puml
? - Почему на это даже влияет вторая часть синтаксиса? Я думал, что это для альтернативного текста, если изображение не может быть отображено.