纯文本生成

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 目录。