IETF Logo Mail Archive

Re: [Rfc-markdown] new kramdown-rfc2629 feature in 1.5.13

Michael Richardson <mcr+ietf@sandelman.ca> Fri, 29 October 2021 13:27 UTC

Return-Path: <mcr+ietf@sandelman.ca>
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 7B2DD3A11D9 for <rfc-markdown@ietfa.amsl.com>; Fri, 29 Oct 2021 06:27:09 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.899
X-Spam-Level:
X-Spam-Status: No, score=-1.899 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham 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 s6iL8TsUxZdM for <rfc-markdown@ietfa.amsl.com>; Fri, 29 Oct 2021 06:27:05 -0700 (PDT)
Received: from tuna.sandelman.ca (tuna.sandelman.ca [209.87.249.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 151183A11D8 for <rfc-markdown@ietf.org>; Fri, 29 Oct 2021 06:27:04 -0700 (PDT)
Received: from localhost (localhost [127.0.0.1]) by tuna.sandelman.ca (Postfix) with ESMTP id 93B5C18055; Fri, 29 Oct 2021 09:28:17 -0400 (EDT)
Received: from tuna.sandelman.ca ([127.0.0.1]) by localhost (localhost [127.0.0.1]) (amavisd-new, port 10024) with LMTP id RtFSt4ei2TxW; Fri, 29 Oct 2021 09:28:14 -0400 (EDT)
Received: from sandelman.ca (obiwan.sandelman.ca [IPv6:2607:f0b0:f:2::247]) by tuna.sandelman.ca (Postfix) with ESMTP id 1C9F91800C; Fri, 29 Oct 2021 09:28:14 -0400 (EDT)
Received: from localhost (localhost [IPv6:::1]) by sandelman.ca (Postfix) with ESMTP id 3BCE3614; Fri, 29 Oct 2021 09:27:00 -0400 (EDT)
From: Michael Richardson <mcr+ietf@sandelman.ca>
To: Martin Thomson <mt@lowentropy.net>, rfc-markdown@ietf.org
In-Reply-To: <a1849958-8325-4474-9578-ce1f093cc49c@www.fastmail.com>
References: <a1849958-8325-4474-9578-ce1f093cc49c@www.fastmail.com>
X-Mailer: MH-E 8.6+git; nmh 1.7+dev; GNU Emacs 26.1
X-Face: $\n1pF)h^`}$H>Hk{L"x@)JS7<%Az}5RyS@k9X%29-lHB$Ti.V>2bi.~ehC0; <'$9xN5Ub# z!G,p`nR&p7Fz@^UXIn156S8.~^@MJ*mMsD7=QFeq%AL4m<nPbLgmtKK-5dC@#:k
MIME-Version: 1.0
Content-Type: multipart/signed; boundary="=-=-="; micalg="pgp-sha512"; protocol="application/pgp-signature"
Date: Fri, 29 Oct 2021 09:27:00 -0400
Message-ID: <22597.1635514020@localhost>
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-markdown/cmYlHFuNU8v80ESsXncBLbttfsw>
Subject: Re: [Rfc-markdown] new kramdown-rfc2629 feature in 1.5.13
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: Fri, 29 Oct 2021 13:27:10 -0000

Martin Thomson <mt@lowentropy.net> wrote:
    > With Carsten's help I've added a new feature to kramdown-rfc2629 that
    > supports auto-linking of key concepts.

    > If you have a special term, it is already possible to (ab)use
    > kramdown's "abbreviations" syntax to have that term indexed.  For
    > example:

It's cool.

I'm not sure when I'll need:

    > This turns all uses of the string "IMPORTANT CONCEPT" in the text to be
    > marked with an <iref> element.  The result is that all instances of the
    > concept are put into your index for easy reference.

this to happen, except maybe for "MUST".

Are there some other good examples in documents where this is useful and *appropriate*?

--
Michael Richardson <mcr+IETF@sandelman.ca>   . o O ( IPv6 IøT consulting )
           Sandelman Software Works Inc, Ottawa and Worldwide

v2.23.0 | Report a Bug | By Email