Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Use pandoc to create XML suitable for xml2rfc

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 bib tweaks October 22, 2012
Octocat-spinner-32 test Make it depend on transform.xsl March 23, 2014
Octocat-spinner-32 .gitignore added June 09, 2013
Octocat-spinner-32 AUTHORS
Octocat-spinner-32 CONTRIBUTORS Add these files January 01, 2012
Octocat-spinner-32 LICENSE Remove license May 21, 2013
Octocat-spinner-32 Makefile Put the transform.xsl and friends in /usr/share August 30, 2013
Octocat-spinner-32 README.md Fixed: paragraph too long February 23, 2014
Octocat-spinner-32 pandoc2rfc use comma here March 23, 2014
Octocat-spinner-32 pandoc2rfc.1.pdc use flag instead of option/switch March 23, 2014
Octocat-spinner-32 plain.xsl Make this slightly longer July 22, 2013
Octocat-spinner-32 rfcmarkup Add rfcmarkup to create cooler html March 13, 2013
Octocat-spinner-32 template.xml Cleanups July 01, 2013
Octocat-spinner-32 transform.xsl Merge branch 'master' of github.com:miekg/pandoc2rfc February 23, 2014
README.md

README

The documentation for Pandoc2rfc can be found at: http://tools.ietf.org/html/draft-gieben-pandoc2rfc-03

Differences with Pandoc

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.

Bare install

Just copy transform.xsl and 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.

Packages

Or you can install Pandoc2rfc on your system. Then copy template.xml to your I-D directory. Modify according to your needs and run:

pandoc2rfc *.mkd

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.

XSLT 1.0

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

Something went wrong with that request. Please try again.