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

Carsten Bormann <cabo@tzi.org> Mon, 24 May 2021 16:24 UTC

Return-Path: <cabo@tzi.org>
X-Original-To: rfc-markdown@ietfa.amsl.com
Delivered-To: rfc-markdown@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 04D603A2E24 for <rfc-markdown@ietfa.amsl.com>; Mon, 24 May 2021 09:24:26 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.296
X-Spam-Level:
X-Spam-Status: No, score=-1.296 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, HTML_MESSAGE=0.001, SPF_FAIL=0.001, SPF_HELO_NONE=0.001, URIBL_BLOCKED=0.001, URIBL_SBL=0.5, URIBL_SBL_A=0.1] autolearn=no autolearn_force=no
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id RM2rCgLd9Rv0 for <rfc-markdown@ietfa.amsl.com>; Mon, 24 May 2021 09:24:21 -0700 (PDT)
Received: from gabriel-2.zfn.uni-bremen.de (gabriel-2.zfn.uni-bremen.de [IPv6:2001:638:708:32::19]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 6474A3A2E22 for <rfc-markdown@ietf.org>; Mon, 24 May 2021 09:24:21 -0700 (PDT)
Received: from [192.168.217.118] (p548dcc89.dip0.t-ipconnect.de [84.141.204.137]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by gabriel-2.zfn.uni-bremen.de (Postfix) with ESMTPSA id 4FpjGB1dr7z2xDv; Mon, 24 May 2021 18:24:18 +0200 (CEST)
From: Carsten Bormann <cabo@tzi.org>
Content-Type: multipart/alternative; boundary="Apple-Mail=_DDDEFF74-1040-4E7D-8D64-DA0111156D80"
X-Mao-Original-Outgoing-Id: 643566257.744441-9b441237f4adf6dd947aa3d21078aaf1
Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.120.23.2.6\))
Date: Mon, 24 May 2021 18:24:17 +0200
Message-Id: <5DD21FAE-C2E5-46F7-AA5E-DC2755FC7144@tzi.org>
To: RFC Markdown <rfc-markdown@ietf.org>
X-Mailer: Apple Mail (2.3608.120.23.2.6)
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-markdown/kLhRHyeczEU64FyfYRuLgBT5sds>
Subject: [Rfc-markdown] 1.4.11..1.4.14.pre: various housekeeping, railroad diagrams, new beta
X-BeenThere: rfc-markdown@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "rfc-markdown is a discussion list for people writing I-Ds and RFCs in Markdown and the authors of the tools used for that." <rfc-markdown.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/rfc-markdown>, <mailto:rfc-markdown-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/rfc-markdown/>
List-Post: <mailto:rfc-markdown@ietf.org>
List-Help: <mailto:rfc-markdown-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/rfc-markdown>, <mailto:rfc-markdown-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 24 May 2021 16:24:26 -0000

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