Subject: [Rfc-markdown] 1.3.9: More SVG cleanups, version/help on command line

From: Carsten Bormann <[email-masked]>
Date: Sun, 19 Jul 2020 16:12:16 +0200

1.3.9 has version/help on the command line (--version, --help); thank you MCR.

Among a few little nit fixes, it also has a bit more polish in the SVG fixup.
SVG tool translations are now cached (in .refcache or where your KRAMDOWN_REFCACHEDIR points to; my favorite for the latter is ~/.cache/xml2rfc, so the cache is shared with XML2RFC), so, unless you change the source in the code block or update the kramdown-rfc version, no time will be wasted in rerunning the tools.

Extract from the README is below.

As usual, update with

	gem update kramdown-rfc2629

(a simple `gem update` will suffice, but also possibly update other gems you don’t need updated).  A `sudo` may be required depending on your setup.

Grüße, Carsten

(1.3.x)
Slowly improving support for SVG generating tools for XML2RFCv3 (i.e.,
with `-3` flag).
These tools must be installed and callable from the command line.

The basic idea is to mark an input code block with one of the following
labels (language types), yielding some plaintext form in the .TXT
output and a graphical form in the .HTML output.  The plaintext is the
input in some cases (e.g., ASCII art, `mscgen`), or some plaintext
output generated by the tool (e.g., `plantuml-utxt`).

Currently supported labels as of 1.3.9:

* goat, ditaa: ASCII (plaintext) art to figure conversion
* mscgen: Message Sequence Charts
* plantuml: widely used multi-purpose diagram generator
* plantuml-utxt: Like plantuml, except that a plantuml-generated
  plaintext form is used
* mermaid: Very experimental; the conversion to SVG is prone to
  generate black-on-black text in this version

Note that this feature does not play well with the CI (continuous
integration) support in Martin Thomson's [I-D Template][], as that may
not have the tools installed in its docker instance.