[rfc-i] Authoring I-D/RFCs in AsciiDoc

Ronald Tse tse at ribose.com
Thu Dec 7 04:17:40 PST 2017

For anyone interested in using the AsciiDoc format for authoring I-Ds/RFCs, you can find a large number of examples we use to spec against and their AsciiDoc-equivalent.


These examples include:

* the official IETF templates including RFC XML v1 (https://tools.ietf.org/tools/templates)
* existing I-Ds/RFCs from (https://github.com/rfc-format)
* examples used by MMark
* examples used by Kramdown-rfc2629
* and a number of existing RFC documents like RFC 6350.

If you encounter any issue with our tool, please feel free to file an issue here and we will get it fixed (or answered):



Kind regards,


Ronald Tse
Ribose Inc.

On Nov 27, 2017, at 10:40 PM, Ronald Tse <tse at ribose.com<mailto:tse at ribose.com>> wrote:

Thank you very much Julian, we will try to include this in our test suite to test for v2/v3 compatibility :-P

Kind regards,


Ronald Tse
Ribose Inc.

On Nov 27, 2017, at 7:24 PM, Julian Reschke <julian.reschke at gmx.de<mailto:julian.reschke at gmx.de>> wrote:

On 2017-11-25 17:26, Ronald Tse wrote:
Warm greetings to everyone on the rfc-interest list!
We’ve recently made a tool that allows writing Internet-Drafts using AsciiDoc called “asciidoctor-rfc” [1], as an alternative to Kramdown / MMark or manual RFC XML. AsciiDoc is a widely-adopted textual format. Similar to Markdown, it is simple to write and easy to understand, but its major benefit is for being a structured format that directly converts into DocBook XML.
The tool, “asciidoctor-rfc” supports generating both v3 and v2 RFC XML through the “AsciiRFC” syntax [2].
We have attempted to expose as many v3 (and v2) features as possible through native AsciiDoc syntax. I do know the v3 xml2rfc tool is under development (originally scheduled for Oct?), and we are excited to try it out using RFC XML files generated with asciidoctor-rfc.

You may want to try it with rfc2629.xslt, which already supports a broad range of V3 features...: <https://www.greenbytes.de/tech/webdav/rfc2629xslt/rfc2629xslt.html#v3>

Best regards, Julian

rfc-interest mailing list
rfc-interest at rfc-editor.org<mailto:rfc-interest at rfc-editor.org>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.rfc-editor.org/pipermail/rfc-interest/attachments/20171207/8d24abe5/attachment.html>

More information about the rfc-interest mailing list