W3C home > Mailing lists > Public > ietf-http-wg@w3.org > January to March 2022

Re: Referencing keywords/eref in kramdown-rfc2629

From: Mark Nottingham <mnot@mnot.net>
Date: Tue, 22 Feb 2022 09:03:21 +1100
Cc: HTTP Working Group <ietf-http-wg@w3.org>
Message-Id: <44B4D0C7-FC8C-435A-9D04-8EA169E3CC5C@mnot.net>
To: Roberto Polli <robipolli@gmail.com>
Hi Roberto,

The best place for this kind of discussion is probably the rfc-markdown list:
  https://www.ietf.org/mailman/listinfo/rfc-markdown

Cheers,


> On 21 Feb 2022, at 8:34 pm, Roberto Polli <robipolli@gmail.com> wrote:
> 
> Hi folks,
> 
> Currently, to reference a keyword on kramdown-rfc
> you need to do something like this e.g. in Notational Convention
> 
> ```
> ## Notational Conventions
> ...
> The definitions [representation], [representation data], ..
> 
> [representation]: https://datatracker.ietf.org/doc/html/rfc7231#section-3
> [representation data]: https://datatracker.ietf.org/doc/html/rfc7231#section-3.1
> 
> ```
> 
> Instead, it would be great to support something like the following
> 
> ```
> ## Notational Conventions
> ...
> The definitions [representation], [representation data], ..
> 
> [representation]: {{Section 3 of RFC7231}}}
> [representation data]: {{Section 3 of RFC7231}}}
> 
> ```
> 
> Moreover, resolving specification aliases, e.g.
> 
> ...
> This document relies on {{!SEMANTICS=RFC7231}}
> The definitions [representation], [representation data], ..
> 
> [representation]: {{Section 3 of SEMANTICS}}}
> [representation data]: {{Section 3 of SEMANTICS}}}
> 
> ```
> would be even better.
> 
> I filed an issue here
> https://github.com/cabo/kramdown-rfc2629/issues/155
> 
> Comments welcome :)
> 
> Have a nice day,
> R.
> 

--
Mark Nottingham   https://www.mnot.net/
Received on Monday, 21 February 2022 22:03:43 UTC

This archive was generated by hypermail 2.4.0 : Monday, 21 February 2022 22:03:44 UTC