Experiments with xml2rfc

What is xml2rfc? What is xml2rfc v3? The RFC Editor team have put together an FAQ to help answer those questions.


This page will contain experimental tools around xml2rfc, incuding the new xml2rfc version 3. To use xml2rfc version 2, switch here.

A v3 update to the xml2rfc language has been published. Discussion of changes to it are being held on the rfc-dev@ietf.org list. (General questions on RFC formats should be discussed on the rfc-interest@rfc-editor.org list.)

XML2RFC V3 Vocabulary | HTML Format | PDF Format | CSS for HTML and PDF | Plaintext Format | SVG Use | Non-ASCII Use | RFC Framework | RFCv3 Preptool

Dev Version of XML2RFC version 2

This exercises the current dev version of the xml2rfc conversion program.
NOTE: if you choose v3-plaintext or v3-HTML, your input will go through the v2→v3 conversion procession and additional error messages may be generated.
Note: If you get an empty output, be sure to turn on the Output option "Use frames to show Warnings & Errors" and look for errors there.

Convert Your XML Source
Input Source:
 File:
 URL:
Input Type: xml2rfc kramdown
Output format:
Text: plaintext as PDF
v3-plaintext
unpaginated
Web page: HTML as PDF
v3-HTML
  RfcMarkup as PDF
 
ePub
Other: convert v2 to v3 XML nroff expanded XML
Options:
 Output result Use frames to show Warnings & Errors Window File

<Report issues with the V2→V3 conversion to the xml2rfc-dev mailing list.>
<Please report other XML2RFC bugs to the trac system.>
<(You may also discuss those other XML2RFC bugs on the rfc-interest mailing list.)>
<Report website issues here.>

SVG 1.2 Tiny Checker and Converter

Check and Fix Up Your SVG Source

Check your SVG file against the SVG Tiny 1.2 spec, and generate a new version that has been fixed up to be compatible.

Input Source:
 File:
 URL:
Options:
 Output result Use frames to show Warnings Window File

<Report issues here.>

Carsten Bormann's KramDown Converter

Convert a KramDown File to Xml2rfc format

Convert your kramdown file to xml2rfc format. See Carsten Bormann's page for more details. (The current version supported can be seen here.

Input Source:
 File:
 URL:
Options:
 Output result Use frames to show Warnings Window File

<Report issues here.>

OLD Prototype xml2rfc V2 to V3 Converter

################################################################
Note: this is being replaced with an option to the xml2rfc converter.
See the "convert v2 to v3 XML" option in the form above.
################################################################

Convert Your XML Source

Try converting your xml2rfc v2 XML document to xml2rfc v3 XML.

In particular, this conversion tool removes all elements that are marked as "deprecated" in draft-hoffman-xml2rfc, and converts them to their intended replacements.

Input Source:
 File:
 URL:
Options:
 Output Comments About Conversions
Note: warnings and error messages may still be found in the output. Search for the string 'CONVERT'.
Off On
 Fix some common input errors For example, fix the use of "--" with comments. Off On
 Show the Conversion Rules Being Followed
(Extracts the set of rules being followed by the converter and prints them along with the file .)
Off On

<Report issues here.>

Questions? Try the RFC Interest mailing list <rfc-interest@rfc-editor.org>.