Documentation Conversion to Online Help

Word documents to XML via upCast

Following Rice's example, using upCast to convert Word documents to upCast (Windows machine).

1. Once upCast is installed: Resources > templates > Word to DocBook > open template.
   1. Documentation for upCast: http://upcast.de/iloop/assets/content/products/upcast/765b1744/doc/manual/html/index.html#N2004D
   2. Documentation also in the Word to DocBook folder
2. Change the Catalog (under Pipeline Settings) to ${pipeline:PipelineBase}/resources/schema/catalog
3. Strip the title page, TOC from the Word documents; Large documents kept failing/timing-out so I had to break them in two.
4. Choose the file (even though it says rtf to DocBook v 5.0 it seemed to convert .docx files just fine).
5. I didn't select any options
6. Table Model: CALS
7. DocBook structure: book > chapter > section
   
   

DocBook Notes

• Fix hierarchy:

1. 1. Chapters are Intro, Standard Docs (overview), Maintenance Docs (overview), Appendix
   2. Section X.X would be each individual standard doc or maintenance doc or item in the appendix.
   3. Section X.X.X are sub-titles for each document: Getting Started, Process Overview, Document Layout, Business Rules and Routing (all are on the same level in the hierarchy).
   4. Removed TOC description tables under chapters

• Removed extra TOC anchors (TOC_xxxxx...) from Word. Check anchors
• Put red arrows in note element; remove the red arrow images
• Put tips into tip elements
• Table titles need to have emphasis as bold
• Changed column widths on tables to 1.0*
• Changed "phrase role="strong"" to "emphasis role="bold""