Subject: [Rfc-markdown] 1.4.11..1.4.14.pre: various housekeeping, railroad diagrams, new beta

From: Carsten Bormann <[email-masked]>
Date: Mon, 24 May 2021 18:24:17 +0200

A few more non-earth-shattering updates:

1.4.11: Add limited support for railroad diagrams (via kgt)
You need to have “Kate’s Grammar Tool” (kgt) installed [0], and then can create railroad diagrams (both ASCII/UTF8-Art and SVG) from single ABNF productions like:

~~~ railroad-utf8
absrel = [scheme] [host [port]] / discard
~~~

Text form:

      |     absrel:
      |                                ╭───────────>────────────╮
      |                                │                        │
      |                ╭─────>──────╮  │          ╭────>─────╮  │
      |                │            │  │          │          │  │
      |         │├──╮──╯── scheme ──╰──╯── host ──╯── port ──╰──╰──╭──┤│
      |             │                                              │
      |             ╰────────────────── discard ───────────────────╯

SVG form:

1.4.12: Add boilerplates bcp14info (and bcp14info-tagged)
Useful for when BCP14 (RFC 2119) language is used outside of standards track documents (such as ISE submissions), e.g.:

{::boilerplate bcp14info-tagged}

1.4.13: Emergency fix for upstream gem incompatibility
(couldn’t use the usual mechanisms for handling such incompatibilities because the upstream hasn’t always been a gem).
You need this emergency fix if you get error messages about “safe_load” [1].

As always, update with

	gem update

(sudo in front of this may be required if you use a system-installed ruby).

1.4.14.pre: Refactor kramdown option handling
Issue 123 [2] finally made some outstanding technical debt unbearable, so to fix this issue, I put in some refactoring.  You need this if you use refcontent or annotations in bibxml.

Since this is a slightly more extensive change than usual, I made a beta (pre-release).
If you have issue 123, or want to help, install this via…

	gem update kramdown-rfc2629 --pre

…and please do send me some feedback if you don’t have problems.

Grüße, Carsten

[0]: https://katef.github.io/kgt/
[1]: https://mailarchive.ietf.org/arch/msg/tools-discuss/axfdz8O-pfkK84AIMoBN0AoH1lY
[2]: https://github.com/cabo/kramdown-rfc2629/issues/123