search

0x10cStandardsCommittee / 0x10c-Standards

0x10c Computing Standards. This repository is intended to contain as many relevant/popular standards as possible.
210 stars 18 forks source link

rfcxmlconv #32

Open enkore opened 12 years ago

enkore commented 12 years ago

Useful helper tool to convert xml2rfc's XML to Markdown and LaTeX

https://github.com/enkore/rfcxmlconv

It is currently in a pre-alpha state, but it supports basic markdown output and a subset of the RFC2629/xml2rfc format. Tables are currently not supported.

enkore commented 12 years ago

Most stuff is now supported. LaTeX output also supports tables, but I didn't find a real solution for Markdown, because Markdown just doesn't have any facilities for tables. Probably I just build something that makes the table ASCII-art like.

Oh and you shouldn't put anything else than text in table cells or list items. Just mentioning.

enkore commented 12 years ago

Here you can see what a RFC looks like in Markdown. Take a look at the format section.

Markdown is just not a language for complex documents; but the LaTeX output looks quite good. Pretty cool for longer RFCs (offline reading/eBook-readers)...

enkore commented 12 years ago

I'll provide more-or-less up-to-date PDF and Markdown versions here. I'll update that when new RFCXs are submitted and significant changes are made to drafts. This is the git repository/branch responsible for that page, so you can check when I last updated it.

PDF documents are generated using pdflatex and KOMA-Script.