La documentación Postscript para copia impresa se genera convirtiendo la fuente SGML a RTF, para después importarla a ApplixWare-4.4.1. Después de pequeños cambios (vea la sección que viene) la salida se "imprime" a un fichero postscript.
INSTALL e HISTORY se actualizan en cada versión nueva. Por razones histórica estos ficheros están en un formato de texto plano, pero provienen de ficheros fuente SGML.
Generación de texto plano
Tanto INSTALL como HISTORY se generan desde fuentes SGML que ya existen. Se extraen desde el fichero RTF intermedio.
Para generar RTF escriba:
% cd doc/src/sgml
% make installation.rtf
Importe installation.rtf a Applix Words.
Fije el ancho y los márgenes de la página.
Ajuste el ancho de página en File.PageSetup a 10 pulgadas.
Seleccione todo el texto. Ajuste el margen derecho a 9,5 pulgadas utilizando la regla. Esto dará un ancho de columna máximo de 79 caracteres, que esta dentro del límite superior de las 80.
Elimine las partes del documento que no sean necesarias.
Para INSTALL, elimine todas las notas de la versión desde el final del texto a excepción de aquellas que tengan que ver con la versión actual. Para HISTORY, elimine todo el texto que esté por encima de las notas de versión, preservando y modificando el título y el ToC.
Exporte el resultado como "ASCII Layout".
Usando emacs o vi, elimine la información de tablas en INSTALL. Borre los "mailto" URLs de los que han contribuido al porte para comprimir la altura de las columnas.
Hay que abordar varias cosas mientras se genera en Postscript hardcopy.
Arreglos en Applixware RTF
No parece que Applixware haga bien el trabajo de importar RTF generado por jade/MSS. En particular, a todo el texto se le da la etiqueta de atributo "Header1" , aunque por lo demás el formateo del texto es aceptable. También se da que los números de página de la Tabla de Contenidos no referencian correctamente a la sección listada en la tabla, sino que se refieren directamente a la página de la Tabla de Contenidos.
Por ejemplo, para generar la entrada RTF escriba:
% cd doc/src/sgml
% make tutorial.rtf
Abra un nuevo documento en Applix Words y después importe el fichero RTF.
Imprima la Tabla de Contenidos que ya existe.
Inserte figuras en el documento y centre cada figura en la página utilizando el botón de centrado de márgenes.
No todos los documentos tienen figuras. Puede buscar en los ficheros fuente SGML la cadena "graphic" para identificar aquellas partes de la documentación que puedan tener figuras. Unas pocas figuras se repiten en varias partes de la documentación.
Trabaje sobre el documento ajustando saltos de página y anchos de columnas en las tablas.
Si existe bibliografía, Applix Words aparentemente marca todo el texto restante después del primer titulo como si tuviera un atributo de subrayado. Seleccione todo el texto restante y desactive el subrayado usando el botón de subrayado y a partir de aquí subraye explícitamente cada documento y el título del libro.
Siga tratando el documento marcando la Tabla de Contenidos con el correspondiente número de página para cada entrada.
Reemplace los valores de número de página de la derecha en la Tabla de Contenidos con los valores correctos. Esto sólo toma unos minutos por documento.
Guarde el documento en el formato nativo de Applix Words para permitir una edición rápida más adelante si fuera necesario.
"Imprima" el documento a un fichero en formato Postscript.
Comprima el fichero Postscript utilizando gzip. Coloque el fichero comprimido en el directorio doc.