[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
- [Rfc-markdown] 1.4.11..1.4.14.pre: various housek… Carsten Bormann