This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
design:text-requirements [2013/09/03 16:14] rsewikiadmin |
design:text-requirements [2013/10/09 13:55] paul Moved the ASCII stuff to the end |
||
---|---|---|---|
Line 1: | Line 1: | ||
==== Requirements for Text Output ==== | ==== Requirements for Text Output ==== | ||
- | Technical requirements: | + | The following assumes that there is going to be only one text-only non-canonical |
- | The .txt publication | + | |
- | * use classic/ | + | |
- | * have paginated output | + | |
- | * use classic/ | + | |
- | * support UTF-8 encoding | + | |
+ | The text-only format must have the same page height limitations as the current RFC format. It must contain the same headers and footers and page break character as the current RFC format. There is no requirement that the text-only format use widow and orphan control; the use case for this is to allow similar referencing of paragraphs from the text-only format to the canonical format and non-canonical HTML format. | ||
+ | |||
+ | The text-only format must allow for preformatted text and art to be 80 characters wide without wrapping those lines. This is due to the relaxation of the 72-character restriction on preformatted text and art in the new canonical format. | ||
+ | |||
+ | The text-only format must represent all SVG-based artwork as a "see reference" | ||
+ | |||
+ | === ASCII vs. UTF-8 for Text Output === | ||
+ | |||
+ | As of 2013-10-09, it is not clear whether or not the text output will be ASCII or UTF-8. The following assumes ASCII. If the format is UTF-8, then the following is wrong. | ||
+ | |||
+ | The text-only format must have the same character-set limitations as the current RFC format. For new RFCs that have non-ASCII characters in them, each such character must be represented as // | ||
+ | //Dave thinks: disagree with the above paragraph. I'm leaning towards saying there should be a separate UTF-8 (e.g. .utf8) text version. | ||
- | Policy requirements: | ||
- | * an RFC may include ASCII art OR SVG, but not both | ||
- | * the .txt publication output will include links to the info pages where there are images | ||
- | * we could potentially include direct links to the HTML anchors, but am concerned about future failure of links; info page links are likely to be more stable | ||
- | * non-ASCII characters in the Author' | ||