Feeds of canonical RFC XML formatted bibliographies about asciidoctor-bibliography HOT 7 OPEN

I think we should allow RFC entity directives just like MMark does so that we don’t need to pull in the RFC references, but allow xml2rfc to do it.

I have already been downloading RFC references from this site and it’s really annoying.

from asciidoctor-bibliography.

This would mean that, whenever a preformatted reference was known to be available, the gem would need to insert not the preformatted reference in the biblio, but the following:

In the stylesheet of the XML document:

<!ENTITY RFC2119 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2119.xml">

and in the bibliography itself:

&RFC2119;

The asciidoctor-rfc would presumably have to have the smarts of rearranging the XML, recognising the entities in the bibliography, and inserting the corresponding entity definitions into the XML stylesheet. (The different locations of the URLs should be inferrable from the anchor text prefix.) Paolo, ascii-bibliography would still need to realise that the entity &RFC2119; corresponds to a citation with anchor RFC2119.

from asciidoctor-bibliography.

When asciidoctor-rfc sees a references like <<RFC1234>> or <<I-D.author-topic-num>> (or we give it some prefix, e.g., <<ietf:RFC1234>>, then this reference should be inferred to be an external one, and:

1. Rendered in the XML stylesheet as <!ENTITY...>
2. Rendered inside the <references> section
3. Known by asciidoctor-bibliography that the reference is external.

@opoudjis It's hard to wrap this around my head right now... 😉

from asciidoctor-bibliography.

I can do all of this in isolation from asciidoc-bibliography; it's the interaction with asciidoc-bibliography that I'm worried about.

from asciidoctor-bibliography.

Done in asciidoc-rfc.

from asciidoctor-bibliography.

I think I might be missing some points. I'll get back to speed with the changes asciidoctor-rfc and report back with some questions.

from asciidoctor-bibliography.

metanorma/asciidoctor-rfc#86 . In accordance with that ticket, the scope of asciidoctor-biblio would be reduced to BibXML/RFC XML conversion...

from asciidoctor-bibliography.