[rfc-i] Normalized HTML

Yaakov Stein yaakov_s at rad.com
Wed Mar 28 01:28:10 PDT 2012

> If they appear, diagrams MUST be in SVG. Equations MUST be in MathML.

I am a bit worried about making people have to learn and use MathML and SVG.

Let's try writing a simple quadratic :
Latex : $ a x^2 + bx + c $
MathML (presentation format) :

Similarly, a simple block diagram will be 10 times longer and a thousand times more complicated to write by hand
than the equivalent LaTeX code.

So, either we will need to find various tools to input these expressions,
or the IETF volunteers will need to code them.


-----Original Message-----
From: rfc-interest-bounces at rfc-editor.org [mailto:rfc-interest-bounces at rfc-editor.org] On Behalf Of Larry Masinter
Sent: Wednesday, March 28, 2012 10:16
To: RFC Interest
Subject: [rfc-i] Normalized HTML

After listening to the BOF discussions and reading the email, I've changed my thinking. 

I'm leaning toward a marked up profile of HTML where the authoring format and distribution format is a canonicalization of the authoring format. That is, I think we could move away from XML/XML2RFC and instead have a "cleaned profile" HTML with a tidy-step that does the work that xml2rfc does but which is idempotent (i.e., the output is suitable for input and generates the same HTML.)   

Having the output format suitable for input and production of other formats trivializes the re-use issues. 

"View Source" is powerful.

ID-editor: edit in simplified profile of HTML, or else edit in some tool and generate ("clean") HTML.

Preprocessor run through a 'tidy' which does things like "make head/title match h1 header", fixing up metadata, annotating or styling references, fix cross-references.
Postprocessor: generate ASCII-only view of HTML by substituting longdesc for diagrams, changing cross-references, etc.

Reviewers can comment on HTML or derived forms (ASCII-text view, PDF, epub, etc.)

Validate ID-submitted form, edit in same way that ID-editor does, if necessary.

Convert RFCs also  into .txt, .pdf, epub.  

If they appear, diagrams MUST be in SVG. Equations MUST be in MathML.  No images allowed(!)  (Text should be text so it is searchable). Probably need some "clean" styling requirements for diagrams.

Equations and diagrams must have ASCII-only alt descriptions for accessibility, meet accessibility guidelines.

Probably something similar to W3C pub-rules and using tools similar to W3C pub tools.

rfc-interest mailing list
rfc-interest at rfc-editor.org

More information about the rfc-interest mailing list