Pandoc2rfc translates text written in the Markdown variant Pandoc to documents in xml2rfc format. It's an easy way to write RFCs.
The documentation for Pandoc2rfc can be found at: http://tools.ietf.org/html/draft-gieben-pandoc2rfc-03
Although you can type Pandoc just fine, there are two things that differ
- Using Pandoc citations is not supported, you must use internal references for this;
- Referencing figures and tables is done by abusing inline footnotes, which are typeset directly after the figure or table.
As said, more extensive docs are here: http://tools.ietf.org/html/draft-gieben-pandoc2rfc-03. But after some setup, it is just typing Pandoc syntax in $EDITOR.
template.xml to your I-D directory. Modify
template.xml according to your needs and run:
pandoc -t docbook -s <yourfile>.mkd | \ xsltproc --nonet transform.xsl - > <yourfile>.xml
And to create a draft.txt
xml2rfc template.xml -f draft.txt --text
And/or create a Makefile.
Or you can install
Pandoc2rfc on your system. Then copy
to your I-D directory. Modify according to your needs and run:
Packages can be found for Debian/Ubuntu at:
https://launchpad.net/~miek/+archive/pandoc2rfc, they should also install in previous Ubuntu versions.
Or see http://pandoc2rfc.implementers.org/ for proper Debian packages.
Note that you don't even need
xsltproc per se, just an XSLT transformer
program. Also note that only
xsltproc is tested.
Pandoc2rfc v2 works with
xml2rfc version 2.x.
Miek Gieben - 2012