toyboot4e
Oct 19, 2020

1. About

Generate diagrams from ascii text!

1.1. Requirements

Make sure you have asciidoctor-diagram:

$ rvm install asciidoctor-diagram

2. asciidoctor-diagram

2.1. Ditaa

serde
Figure 1. Overview of the serde framework
Source
.Overview of the serde framework
[ditaa, "ditaa/serde"]
....
      /---------------------\   /--------------------\
      |                     |   |                    |
      |    /-------------\  |   |  /--------------\  |
      |    |  Serialize  |  |   |  |  Serializer  |  |
      |    \-------------/  |   |  \--------------/  |
      |       ^       |     |   |    ^       |       |
      |       |       v     |   |    |       v       |
+-----+----------+  /-------+---+------\  +----------+---+
| data structure |  | serde data model |  | data format  |
+-----+----------+  \-------+---+------/  +----------+---+
      |       ^       |     |   |    ^       |       |
      |       |       v     |   |    |       v       |
      |    /-------------\  |   |  /--------------\  |
      |    | Deserialize |  |   |  | Deserializer |  |
      |    \-------------/  |   |  \--------------/  |
      | cGRE                |   | c1AB               |
      \---------------------/   \--------------------/
                 ser                      de
....

2.2. Plant UML

Mindmap:

miandmap
Source
[plantuml.freesize,mindmap]
----
@startmindmap
+ Programming
++ Languages
+++_ Crafting Interpreters
+++_ compilerbook
++ Games
+++_ Languages
+++_ Frameworks
-- Text editors
---_ VSCode
---_ Sublime Text 3
---_ NeoVim
---_ Evil Emacs
@endmindmap
----

The mindmap syntax:

  • +: right

  • -: left

  • _: branch