纯文本生成

INSTALL 和 HISTORY 都是从现有的 SGML 源码生成的。它们从同一个中间 RTF 文件中提取。

1. 输入以下命令生成 RTF：

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

2. 把 installation.rtf 导入 Applix Words。

3. 设置页宽和页边距。

   1. 在 File.PageSetup 中把页宽调整为 10 英寸。

   2. 选中全部文本。用标尺把右边距调整为 9.5 英寸。这样最大列宽就是 79 个字符，在 80 列上限目标之内。

4. 把文档中不需要的部分去掉。

   对于 INSTALL，删除文本末尾除当前发行版之外的所有发行说明。对于 HISTORY，删除发行说明之前的所有文本，保留并修改标题和目录（ToC）。

5. 把结果导出为“ASCII Layout”。

6. 用 emacs 或 vi 清理 INSTALL 中的表格信息。删除移植贡献者的“mailto” URL 以缩小列的高度。

Applixware RTF 清理

硬拷贝过程不可或缺的组成部分 jade 没有为正文文本指定默认样式。过去，这个未确诊的问题导致目录（ToC）生成过程极其漫长。不过，在 ApplixWare 方面的大力帮助下，症状已得到诊断，并且有了可用的变通方法。

1. 输入以下命令生成 RTF 输入（例如）：

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

2. 修复 RTF 文件，使其正确指定所有样式，特别是默认样式。该字段可以用 vi 或者下面这个小小的 sed 过程添加：

   #!/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
         

   该脚本会在 {\s0 Normal;} 的位置添加它作为文档的第 0 号样式。按照 ApplixWare 的说法，RTF 标准不允许添加隐式的第 0 号样式，不过 M$Word 恰好能处理这种情况。

3. 在Applix Words中打开一个新文档，然后导入RTF文件。

4. 使用 ApplixWare 生成新目录（ToC）。

   1. 从第一行第一个字符开始到最后一行最后一个字符为止，选中现有的 ToC 行。

   2. 使用 Tools.BookBuilding.CreateToC构建新的 ToC。选择前三级标题。这会用 ApplixWare 原生的 ToC 替换从 RTF 导入的现有行。

   3. 使用 Format.Style 调整 ToC 格式，依次选择三种 ToC 样式，并调整First 和Left的缩进。使用以下数值：

      表 DG2.2. 目录的缩进格式

      样式	首行缩进（英寸）	左缩进（英寸）
      TOC-Heading 1	0.6	0.6
      TOC-Heading 2	1.0	1.0
      TOC-Heading 3	1.4	1.4

      
      

5. 在整个文档中完成以下工作：

   • 调整分页。

   • 调整表格列宽。

   • 把插图插入文档。使用 ApplixWare 工具栏上的居中边距按钮把每幅图在页面上居中。

     注意

     并非所有文档都有插图。你可以在 SGML 源文件中 grep 字符串“graphic”，来找出文档中可能带有插图的部分。有少数插图在文档的不同部分重复出现。

6. 用正确的值替换 ToC 中 Examples 和 Figures 部分右对齐的页码。这只需要几分钟（每份文档）。

7. 如果存在书目，从每个条目中删除短形式引用标题。Norm Walsh 的 DocBook 样式表似乎会把这些打印出来，尽管这只是紧随其后的信息的一个子集。

8. 将文档保存为 Applix Words 原生格式，以便日后更容易地进行最后时刻的编辑。

9. 把文档“打印”到 PostScript 格式的文件。

10. 使用 gzip 压缩 Postscript 文件。把压缩后的文件放入 doc 目录。