Re: [Rfc-markdown] [Tools-discuss] Reference to NIST document

[Carsten Bormann <[e-mail]>]

> On 2021-06-19, at 21:44, Michael Richardson <[e-mail]> wrote:
> 
> 
> Carsten Bormann <[e-mail]> wrote:
>> The NIST reference collections are really dusty at this point.
>> Kramdown-rfc does not do shopping around, so a NIST.* reference triggers lookup in bibxml2.
> 
>> I’m lazy and usually use DOIs for NIST references.
> 
>> Putting...
> 
>> informative:
>> NIST.SP.800-56a: DOI.10.6028/NIST.SP.800-56a
> 
> Is "NIST." an kramdown thing?

Kramdown-rfc recognizes NIST.* labels and tries to look them up in bibxml2.

However, the syntax above uses a DOI reference and then renames that, so the above magic is not applied.

> I recognize the DOI as being an alias, but I didn't know I could put a / in there.

Both / and _ should work; since the point of the rename is to get to choose an anchor of one’s liking (and so it doesn’t matter that “/“ cannot be in an anchor), I just copied the / from the original DOI.

> Is anything special done with a DOI?

If it looks like DOI.*, it will be looked up for you from doi.org, so you don’t need to supply your own reference.  doi.org info can be a bit sketchy, though, so better check, and use kramdown-rfc’s doilit tool plus some hand editing if you don’t like the result.

https://github.com/cabo/kramdown-rfc2629/wiki/Pitfalls#reference-anchors

Grüße, Carsten