{"id":443,"date":"2019-09-21T17:16:27","date_gmt":"2019-09-21T15:16:27","guid":{"rendered":"https:\/\/www.nikostotz.de\/blog\/?p=443"},"modified":"2019-09-21T17:16:27","modified_gmt":"2019-09-21T15:16:27","slug":"how-to-render-a-hierarchical-tree-in-asciidoctor","status":"publish","type":"post","link":"https:\/\/www.nikostotz.de\/blog\/how-to-render-a-hierarchical-tree-in-asciidoctor\/","title":{"rendered":"How to Render a (Hierarchical) Tree in Asciidoctor"},"content":{"rendered":"\n

Showing a hierarchical tree, like a file system directory tree, in Asciidoctor is surprisingly hard. We use PlantUML to render the tree on all common platforms.<\/p>\n\n\n\n

\"Example<\/figure>\n\n\n\n

This tree is rendered from the following code:<\/p>\n\n\n\n\n

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
<\/div><\/td>
[plantuml, format=svg, opts="inline"]
\n----
\nskinparam Legend {
\n    BackgroundColor transparent
\n    BorderColor transparent
\n    FontName "Noto Serif", "DejaVu Serif", serif
\n    FontSize 17
\n}
\nlegend
\nRoot
\n|_ Element 1
\n  |_ Element 1.1
\n  |_ Element 1.2
\n|_ Element 2
\n  |_ Element 2.1
\nend legend
\n----<\/div><\/td><\/tr><\/tbody><\/table><\/div>\n\n\n\n\n

It works on all Asciidoctor implementations that support asciidoctor-diagram<\/tt> and renders well in both HTML and PDF. Readers can select the text (i.e. it’s not an image), and we don’t need to ship additional files.<\/p>\n\n\n\n

We might want to externalize the boilerplate:<\/p>\n\n\n\n\n

1
2
3
4
5
6
7
8
9
10
11
12
<\/div><\/td>
[plantuml, format=svg, opts="inline"]
\n----
\n!include asciidoctor-style.iuml
\nlegend
\nRoot
\n|_ Element 1
\n  |_ Element 1.1
\n  |_ Element 1.2
\n|_ Element 2
\n  |_ Element 2.1
\nend legend
\n----<\/div><\/td><\/tr><\/tbody><\/table><\/div>\n\n\n\n\nasciidoctor-style.iuml<\/i>\n\n
1
2
3
4
5
6
<\/div><\/td>
skinparam Legend {
\n    BackgroundColor transparent
\n    BorderColor transparent
\n    FontName "Noto Serif", "DejaVu Serif", serif
\n    FontSize 17
\n}<\/div><\/td><\/tr><\/tbody><\/table><\/div>\n\n\n\n\n

Thanks to PlantUML’s impressive reaction time<\/a>, we soon won’t even need Graphviz installed.<\/p>\n\n\n\n

Please find all details in the example repository<\/a> and example HTML<\/a> \/ example PDF<\/a> rendering.<\/p>\n","protected":false},"excerpt":{"rendered":"

Showing a hierarchical tree, like a file system directory tree, in Asciidoctor is surprisingly hard. We use PlantUML to render the tree on all common platforms. This tree is rendered from the following code: It works on all Asciidoctor implementations that support asciidoctor-diagram and renders well in both HTML and PDF. Readers can select the […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[31],"tags":[],"class_list":["post-443","post","type-post","status-publish","format-standard","hentry","category-asciidoctor"],"_links":{"self":[{"href":"https:\/\/www.nikostotz.de\/blog\/wp-json\/wp\/v2\/posts\/443","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.nikostotz.de\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.nikostotz.de\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.nikostotz.de\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.nikostotz.de\/blog\/wp-json\/wp\/v2\/comments?post=443"}],"version-history":[{"count":11,"href":"https:\/\/www.nikostotz.de\/blog\/wp-json\/wp\/v2\/posts\/443\/revisions"}],"predecessor-version":[{"id":455,"href":"https:\/\/www.nikostotz.de\/blog\/wp-json\/wp\/v2\/posts\/443\/revisions\/455"}],"wp:attachment":[{"href":"https:\/\/www.nikostotz.de\/blog\/wp-json\/wp\/v2\/media?parent=443"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.nikostotz.de\/blog\/wp-json\/wp\/v2\/categories?post=443"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.nikostotz.de\/blog\/wp-json\/wp\/v2\/tags?post=443"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}