Support automatic citations to RFCs / I-Ds like MMark

[metanorma]

Support automatic citations to RFCs / I-Ds like MMark

[ronaldtse]

@paolobrasolin should this be done in asciidoctor-bibliography? Or an "addon" to it?

[ronaldtse]

And output in this format https://tools.ietf.org/html/rfc7749#section-2.30

[paolobrasolin]

We can definitely support the syntax of asciidoctor-bibliography; matchers and data structures are already in place, so it should be relatively straightforward to output in RFC.

[ronaldtse]

Looks like we should support this syntax and output:

cite:[@RFC1234]

• citation reference => <xref target="RFC1234"/>
• add in <references>: <?rfc include="https://xml2rfc.tools.ietf.org/public/rfc/bibxml/reference.RFC.1234.xml"?>

cite:[@I-D.xxx-yyy-zzz]

• citation reference => <xref target="I-D.xxx-yyy-zzz"/>
• add in <references>: <?rfc include="https://xml2rfc.tools.ietf.org/public/rfc/bibxml3/reference.I-D.xxx-yyy-zzz.xml"?>

cite:[@I-D.xxx-yyy-zzz#11]

• citation reference => <xref target="I-D.xxx-yyy-zzz-11"/>
• add in <references>: <?rfc include="https://xml2rfc.tools.ietf.org/public/rfc/bibxml3/reference.I-D.xxx-yyy-zzz-11.xml"?>

Then xml2rfc will automatically fetch these references.

@paolobrasolin maybe we can also provide a shorter syntax for cite:[], such as MMark's [@RFC1234] or Kramdown's {{@RFC1234}}?

[ronaldtse]

Actually @paolobrasolin we can make this syntax work?

• <<?RFC1234>> (informative)
• <<!RFC1234>> (normative)
• <<-RFC1234>> (suppress in references)

[opoudjis]

Implemented with cite:norm[] and cite:info[]

I'm closing because I'm assuming the more succinct syntax is not feasible.