Xml on Miek Gieben

How to install xml2rfc on Debian

Wed, 13 Nov 2019 07:17:36 +0000

Xml2rfc is the tool the IETF uses to convert the canonical XML for an Internet-Draft into text, HTML or a PDF. This utility has seen many releases while the XML schema was being finalized. It’s important (if you write I-Ds) that you have the latest version of xml2rfc installed.

Installing it as a Debian package is done with:

go to https://pypi.org/project/xml2rfc/#files
download the tar archive (say “xml2rfc-2.35.0.tar.gz”)
execute: py2dsc-deb xml2rfc-2.35.0.tar.gz (“py2dsc-deb” can be found in the “python-stdeb” package)
execute: sudo dpkg -i deb_dist/python-xml2rfc_2.35.0-1_all.deb

Note a py2dsc also exists, but that doesn’t create a Debian package.

Markdown for XML2RFC v3 - Update

Thu, 18 Dec 2014 22:46:00 +0000

And another update (2015-01-12)

This is a follow up the previous article about using markdown for XML2RFC. The syntax has been changed and more features have been implement. And my blackfriday fork has been renamed mmark.

See this document for an up to date syntax of mmark. A short summery will be given here.

New features are:

Include raw XML references
Allow HTML comments to be converted to crefs
Abbreviations (https://michelf.ca/projects/php-markdown/extra/#abbr), this is not used in XML2RFC but seems a relatively standard markdown extension
Example lists (http://johnmacfarlane.net/pandoc/README.html#numbered-example-lists)
Quote attribution

Also the possibility to convert pandoc2rfc documents to mmark has been added (as a quick and dirty perl script + pandoc!):

Markdown for XML2RFC v3

Thu, 27 Nov 2014 22:50:00 +0000

Or… how to write Markdown to generate XML that is valid XML2RFC v3. These are some assorted notes and ideas

Goal:

Self contained file with all information to generate a complete I-D;
CommonMarkdown, with some extension.

I’m working on implementing these ideas in blackfriday. The following has already been implemented:

Abstract;
Citation;
Document divisions;
Index;
File inclusion;
Extra attributes (kramdown’s IAL.) (work-in-progress).

Document meta data

In TOML - much easier than YAML for instance, lines are starting with %. We don’t need to specify the citations here because: