[rfc-i] Anyone interested in trialing a Word/Markdown -> RFC converter?

phill at hallambaker.com (Phillip Hallam-Baker) Fri, 20 March 2015 16:18 UTC

From: "phill at hallambaker.com"
Date: Fri, 20 Mar 2015 12:18:25 -0400
Subject: [rfc-i] Anyone interested in trialing a Word/Markdown -> RFC converter?
Message-ID: <CAMm+LwhihxKeB9uSM0K8xd2eos4shF07JyCAq8XPvU8qQNe5Ng@mail.gmail.com>

I think my new RFC generator tool is now ready for some alpha testing.
Is anyone interested?

There are two versions of the tool, one with Word document support,
the other without. To run with Word document support, Windows and a
licensed copy of Word and the primary interop assemblies is currently
required. The non-Word version of the tool should run on any platform
that has .NET or a mono distribution installed.

I have since found a library which interfaces with the Word files
directly. That should allow me to eliminate the need for Word. Which
will mean that people can use OpenOffice to write RFCs.


The tool accepts the following inputs:

Word
Markdown
HTML
xml2rfc

The tool generates the following outputs:

PlaintextRFC
Markdown
xml2rfc
HTML

All versions of the tool have integrated bibliography management. So
you write [!RFC822] to create a normative reference and [~RFC821] to
create an informative one.

In order to generate an RFC, a small amount of metadata is required.
This is what the header from the draft I am currently working on looks
like:

X.509v3 TLS Feature Extension

TLS Feature Extension

<ietf>draft-hallambaker-tlsfeature
<ipr>trust200902
<category>Standards Track
<area>Security
<version>07
<author>Phillip Hallam-Baker
    <lastname>Hallam-Baker
    <initials>P. M.
    <firstname>Phillip
    <organization>Comodo Group Inc.
    <email>philliph at comodo.com

This version has a few quirks. The current version does support tables
but they have to be entered using the escape markup. It can't read a
Word table.

If people are interested in this sort of tool, I will do the work to
convert to the open source library.

The code is up on sourceforge.

https://sourceforge.net/projects/html2rfc/

I am just trying to reorg the code before pushing the new versions out.