IETF Logo Mail Archive

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

Mark Nottingham <mnot@mnot.net> Sat, 30 October 2021 06:01 UTC

Return-Path: <mnot@mnot.net>
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 A99E83A1BA2 for <rfc-markdown@ietfa.amsl.com>; Fri, 29 Oct 2021 23:01:30 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.101
X-Spam-Level:
X-Spam-Status: No, score=-2.101 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H2=-0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=mnot.net header.b=KRaSDOCK; dkim=pass (2048-bit key) header.d=messagingengine.com header.b=JzwtArqz
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 xMK7ZcBirz5n for <rfc-markdown@ietfa.amsl.com>; Fri, 29 Oct 2021 23:01:25 -0700 (PDT)
Received: from wout3-smtp.messagingengine.com (wout3-smtp.messagingengine.com [64.147.123.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 4D6513A1BA0 for <rfc-markdown@ietf.org>; Fri, 29 Oct 2021 23:01:25 -0700 (PDT)
Received: from compute6.internal (compute6.nyi.internal [10.202.2.46]) by mailout.west.internal (Postfix) with ESMTP id 4701E3200E86; Sat, 30 Oct 2021 02:01:24 -0400 (EDT)
Received: from mailfrontend2 ([10.202.2.163]) by compute6.internal (MEProxy); Sat, 30 Oct 2021 02:01:24 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=mnot.net; h= content-type:mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; s=fm1; bh=F dGFj11grVeqJBUD6RR+gyxDKwB/mUjP3jN8YpVfCL4=; b=KRaSDOCKJrBgoSlyG nTUKsNmeZM0PY6qhc4oMznFakBURxC0YWA1BB9715sSNPr+b4xP6GAS0lV0nVJ3d 96BHdkMml6cpztUFC9edxKO1bjXgI2dIAuGbOpwxkxTuiu+xKRY6Hwe8cQ/bF2hq KAXcXK9JZ6btnOkNPFf8nwACMooam+mBwSuYCaJj/LV07TIm5BUDA+b0+Ay3pnwx dUK6F0AxE7EBIhk3lCeb6Jrx/tdyAjQ36wh785+mPAA5n3QyaBRo4g76Ok7MuTBD wbBfQfyQNw4O6dl1ROoReTm9dTd2QxNQa763+WGlNChXniSMchSep1kALb7Nw+rI L6MTQ==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm1; bh=FdGFj11grVeqJBUD6RR+gyxDKwB/mUjP3jN8YpVfC L4=; b=JzwtArqzAFPHGRc/4F+KM4+M4y4uqLNmLR5kKHo9whJfAV7OKVEKdbNdy 8eAui5Yv9q/MChFftSQCRYLZpBXcl0RVNBL6ymc3rJMk1CYl7h/YIpgM+WhqDJEq r3JS9WerJAeHGP+CKIirf+aulzZ/0NZrDWSJqSsoVGTAv9Ew+nKLnJY2NNy0zDhk PpUEkITWUJT2csxAfRLqu4NOSRUllESU64/rgkMEDYqoEiPSMHCONcwrqekhqRs0 /JOL01SWVvBPVFDAMaqdKJOCFUeKXemD5Gw+BND++GzEQeMs7PdAa/fbu/uk+Nps BSHjEuBV0EgeAm3AhnM54wcUcwOWg==
X-ME-Sender: <xms:s998YQU7y_FAbbSLRJs8NUh73Sk-4qrd23wodilK_4r0X1u2DXapwQ> <xme:s998YUm7IJEN4nkEIhG65aa7vb_2fuO7FnCjuF8jSIy4JUZHU5nwa4oszqCIlVoM0 AFjyjBCMWvAGtEneQ>
X-ME-Received: <xmr:s998YUas3x_S5_35ireqLn2GPAupO0TscJsQ56lxfEIWx7redEYVYzu5kmfcb9YtD8rz2NWGrmM5tKXLrF-Z1PHoTVRGTV0lwnGt3JyXO4Y_6o8VbpZMYF9d>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvtddrvdegiedgleegucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurheptggguffhjgffgffkfhfvofesthhqmhdthhdtjeenucfhrhhomhepofgrrhhk ucfpohhtthhinhhghhgrmhcuoehmnhhothesmhhnohhtrdhnvghtqeenucggtffrrghtth gvrhhnpeejkeehfedvgeffjedtfeehfffghfekgfelfefhkeduudehteejveeiieelueeu teenucffohhmrghinhephhhtthhpfihgrdhorhhgpdhivghtfhdrohhrghdpmhhnohhtrd hnvghtnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrhhomhep mhhnohhtsehmnhhothdrnhgvth
X-ME-Proxy: <xmx:s998YfWpblBws03moc6cxFOvj9Vb3UWILFsaGs9YxUZDU-zhWii-3w> <xmx:s998Yak_8AvG-Q7mAtnUW4r0risU_u9rrdk6Se0wtGERw0SfNmZP3w> <xmx:s998YUeNL63HK5HiO0nz2jSekrsu4f0XbVZIraUJjObXnouJZ4UJ-Q> <xmx:s998YbBIG60xFJqmsgtxMQkNf7v5_cT2fgZ-v3hTfFb4cxX6SiOE4Q>
Received: by mail.messagingengine.com (Postfix) with ESMTPA; Sat, 30 Oct 2021 02:01:22 -0400 (EDT)
Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 15.0 \(3693.20.0.1.32\))
From: Mark Nottingham <mnot@mnot.net>
In-Reply-To: <22597.1635514020@localhost>
Date: Sat, 30 Oct 2021 17:01:22 +1100
Cc: Martin Thomson <mt@lowentropy.net>, rfc-markdown@ietf.org
Content-Transfer-Encoding: quoted-printable
Message-Id: <19C95F23-7BA1-477E-A711-E88B6C9E8BE4@mnot.net>
References: <a1849958-8325-4474-9578-ce1f093cc49c@www.fastmail.com> <22597.1635514020@localhost>
To: Michael Richardson <mcr+ietf@sandelman.ca>
X-Mailer: Apple Mail (2.3693.20.0.1.32)
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-markdown/ro3UcOUVoj9iXSHe3XyOVcCCd_s>
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: Sat, 30 Oct 2021 06:01:31 -0000

IIRC this should enable things like:
  https://httpwg.org/http-core/draft-ietf-httpbis-semantics-latest.html#rfc.index

> On 30 Oct 2021, at 12:27 am, Michael Richardson <mcr+ietf@sandelman.ca> wrote:
> 
> 
> 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
> 
> 
> 
> 
> _______________________________________________
> Rfc-markdown mailing list
> Rfc-markdown@ietf.org
> https://www.ietf.org/mailman/listinfo/rfc-markdown

--
Mark Nottingham   https://www.mnot.net/

v2.23.0 | Report a Bug | By Email