Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

rfcxmlconv #32

Open
enkore opened this issue Apr 9, 2012 · 3 comments
Open

rfcxmlconv #32

enkore opened this issue Apr 9, 2012 · 3 comments

Comments

@enkore
Copy link
Contributor

enkore commented Apr 9, 2012

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
Copy link
Contributor Author

enkore commented Apr 9, 2012

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
Copy link
Contributor Author

enkore commented Apr 10, 2012

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
Copy link
Contributor Author

enkore commented Apr 12, 2012

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant