[rfc-i] XML citation library for RFCs (bibxml)

Julian Reschke julian.reschke at gmx.de
Sun Jul 12 10:23:38 PDT 2015


On 2015-07-11 01:50, Alice Russo wrote:
> FYI, the RFC Editor maintains a version of the XML citation library for RFCs ("bibxml") that has been updated to create text output that matches the RFC Style Guide, i.e., each reference includes the URL for the RFC info page and the DOI. (In addition, it includes more accurate data for specific RFCs regarding seriesInfo, role, and when an organization is an author.) It is available via rsync (see https://www.rfc-editor.org/rsync-help.html).
>
> Replacing the existing bibxml (available from xml2rfc.ietf.org) with the one from rfc-editor.org is under consideration. For example:
> (A) http://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.5234.xml
> (B) http://www.rfc-editor.org/refs/bibxml/reference.RFC.5234.xml
>
> One change is removing the format elements. Example of what is removed from (A):
> <format type="TXT" octets="26359" target="http://www.rfc-editor.org/rfc/rfc5234.txt"/>
>
> Rationale: It makes the info page (the target) the entry point. When using xml2rfc v2, the presence of the format element does not have an effect on the text or HTML output.
>
> With an eye toward the future, for xml2rfc v3, <format> has been deprecated as described in draft-hoffman-xml2rfc:
>
>   o  Deprecate <format> because it is not useful and has caused
>      surprise for authors in the past.  If the goal is to provide a
>      single URI (Uniform Resource Identifier) for a reference, use the
>      "target" attribute on <reference> instead.
>
> Please let us know if you object to this change.
>
> Thank you.
> ...

+1 on having the RFC Production Center maintain the files.

Out of curiosity: are you maintaining these manually, or do you 
auto-create them from the RFC Index? (Last time I checked (XML version 
of) the RFC Index didn't have the first/sur/fullname details needed for 
that).

Best regards, Julian


More information about the rfc-interest mailing list