El proyecto de documentación

Puede disponer de documentación tanto en formato HTML como Postscript , ambos formatos disponibles como parte de la instalación estándar de Postgres . Aquí se discute acerca de cómo trabajar con las fuentes de la documentación y sobre cómo generar paquetes de documentación.

Las fuentes de la documentación se han escrito usando ficheros de texto plano en formato SGML . El propósito del SGML DocBook es el de permitir a un autor especificar la estructura y el contenido de un documento técnico (usando el DTD DocBook) y también el de tener un documento de estilo que defina cómo ese contenido se verá finalmente (por ejemplo, utilizando Modular Style Sheets, Hojas de Estilo Modular, de Norm Walsh).

Lea Introduction to DocBook para tener un buen y rápido sumario de las características de DocBook. DocBook Elements le da una poderosa referencia de las características de DocBook.

El conjunto de esta documentación se ha construido usando varias herramientas, incluyendo jade de James Clark y Modular DocBook Stylesheets de Norm Walsh.

Normalmente las copias impresas se producen importando ficheros Rich Text Format (RTF) desde jade a ApplixWare para eliminar algún error de formato y a partir de aquí exportarlo como fichero Postscript.

TeX es un formato soportado como salida por jade, pero no se usa en estos momentos, principalmente por su incapacidad para hacer formateos pequeños del documento antes de la copia impresa y por el inadecuado soporte de tablas en las hojas de estilo TeX.