Discussion:
Using plantuml and requiring Java to build TS docs
Alan Carroll
2017-11-13 21:23:28 UTC
Permalink
I have been using plantuml to generate diagrams and I have found it works
well. You can see some examples of it in use here -
https://solidwallofcode.github.io/tls-bridge.en.html
The source for the diagrams is here -
https://github.com/SolidWallOfCode/ts-docs/tree/apache/uml

Although it's quite nice, it comes as a jar file and so requires local Java
to be installed. I have looked around for some mechanism to package this up
in to a single executable but have not found anything really suitable.

This is more debatable now that the documentation isn't built unless
specifically enabled and installing Java is not a high hurdle. If I'm the
only one who builds the docs locally I am OK with this. Or, if some one can
package up plantuml.jar without requiring Java, that would be cool as well.

There is a Sphinx extension for plantuml to allow in line diagrams, as
shown here - https://solidwallofcode.github.io/reference.en.html - you can
see how it works by clicking on the "Show Source" link.

Any thoughts?

Loading...