RSE Wiki Archive

User Tools

Site Tools

Trace:
design:producing-output

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision 		Previous revision
Next revision Both sides next revision
design:producing-output [2013/08/28 10:25]
paul created 		design:producing-output [2013/09/04 13:24]
paul Removed the format list
Line 2: Line 2:
  
 ====== Current Production ====== ====== Current Production ======
- 
-**//Alice needs to check whether the statements in this section are true.//** 
  
   - If the input to the RFC Editor is XML, the document is edited directly.   - If the input to the RFC Editor is XML, the document is edited directly.
-  - When editing is complete, xml2rfc v2 is used to generate nroff.+  - When editing is complete, xml2rfc v2 is used to generate text (unless errors are such that xml2rfc v1 is used instead).  AUTH48 state is initiated using the text output. Once approvals are complete, xml2rfc v2/v1 is used to generate nroff. 
 +  - The nroff is is edited to fix the placement of page breaks and any remaining quirks.
   - The nroff is used to produce paginated text.   - The nroff is used to produce paginated text.
   - The paginated text is used to produce PDF that looks just like the paginated text.   - The paginated text is used to produce PDF that looks just like the paginated text.
 +  - The RFC Editor publishes the text and PDF files.
   - Separately, the Tools Team uses the paginated text to produce HTML that looks just like the paginated text but has additional links.   - Separately, the Tools Team uses the paginated text to produce HTML that looks just like the paginated text but has additional links.
  
Line 20: Line 20:
 ====== Proposed Future Production ====== ====== Proposed Future Production ======
  
-  - If the input to the RFC Editor is XML, the document is edited directly. +  - A tool (tentatively called "RFCToolv3") is used to convert XML to other formats. 
-  - When editing is complete, RFCToolv3 is used to produce HTML that is round-trippable with the XML; this will most likely be done using XSLT processing. +  - If the input to the RFC Editor is XML, the document is edited directly. If the input is a different format, the RFC Editor first converts it into XML using tools and (probably) hand-editing. 
-  - RFCToolv3 uses the HTML to produce unpaginated text. +  - When editing is complete,  AUTH48 state is initiated. The RFC Editor and the authors interact, and the interactions are reflected in the XML. 
-  - RFCToolv3 uses the unpaginated text to produce paginated text. +  - Once approvals are complete, the RFC Editor finalizes the XML and uses RFCToolv3 to create all the non-normative formats (see [[design:formats|Thoughts on Non-Canonical Formats]]). 
-  - RFCToolv3 uses the HTML to produce PDF format 1 that looks much like the HTML (including having live links), and also has relevant headers and footers. +  - The RFC Editor publishes the XML and all of the other formats.
-  - RFCToolv3 uses the paginated text to produce PDF format 2, hopefully having live links. (Both PDF formats are produced for US Letter and A4 page sizes.) +
-  - RFCToolv3 uses the HTML to produce EPUB. +
- +
-If the input to the RFC Editor is nroff, the RFC Editor first turns it into XML, then the steps above +
-are used. +
- +
-If the input to the RFC Editor is plain text, the RFC Editor first turns it into XML, then the steps above +
-are used. +
  
design/producing-output.txt · Last modified: 2013/10/30 09:34 by rsewikiadmin

Page Tools

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki