DG2.3. Building The Documentation

Applixware RTF Cleanup

jade, an integral part of the hardcopy procedure, omits specifying a default style for body text. In the past, this undiagnosed problem led to a long process of Table of Contents (ToC) generation. However, with great help from the ApplixWare folks the symptom was diagnosed and a workaround is available.

1. Generate the RTF input by typing (for example):

   % cd doc/src/sgml
   % make tutorial.rtf
         
   

2. Repair the RTF file to correctly specify all styles, in particular the default style. The field can be added using vi or the following small sed procedure:

   #!/bin/sh
   # fixrtf.sh
   # Utility to repair slight damage in RTF files generated by jade
   # Thomas Lockhart <lockhart@alumni.caltech.edu>
   #
   for i in $* ; do
     mv $i $i.orig
     cat $i.orig | sed 's#\\stylesheet#\\stylesheet{\\s0 Normal;}#' > $i
   done
   
   exit
         
   

   where the script is adding {\s0 Normal;} as the zero-th style in the document. According to ApplixWare, the RTF standard would prohibit adding an implicit zero-th style, though M$Word happens to handle this case.

3. Open a new document in Applix Words and then import the RTF file.

4. Generate a new ToC using ApplixWare.

   1. Select the existing ToC lines, from the beginning of the first character on the first line to the last character of the last line.

   2. Build a new ToC using Tools.BookBuilding.CreateToC. Select the first three levels of headers for inclusion in the ToC. This will replace the existing lines imported in the RTF with a native ApplixWare ToC.

   3. Adjust the ToC formatting by using Format.Style, selecting each of the three ToC styles, and adjusting the indents for First and Left. Use the following values:

      Table DG2-1. Indent Formatting for Table of Contents

      Style	First Indent (inches)	Left Indent (inches)
      TOC-Heading 1	0.6	0.6
      TOC-Heading 2	1.0	1.0
      TOC-Heading 3	1.4	1.4

5. Work through the document to:

   • Adjust page breaks.

   • Adjust table column widths.

   • Insert figures into the document. Center each figure on the page using the centering margins button on the ApplixWare toolbar.

     Note: Not all documents have figures. You can grep the SGML source files for the string "graphic" to identify those parts of the documentation that may have figures. A few figures are replicated in various parts of the documentation.

6. Replace the right-justified page numbers in the Examples and Figures portions of the ToC with correct values. This only takes a few minutes per document.

7. If a bibliography is present, remove the short form reference title from each entry. The DocBook stylesheets from Norm Walsh seem to print these out, even though this is a subset of the information immediately following.

8. Save the document as native Applix Words format to allow easier last minute editing later.

9. "Print" the document to a file in Postscript format.

10. Compress the Postscript file using gzip. Place the compressed file into the doc directory.