G.3. Construire la documentation

Procédure G.1. Nettoyage du RTF avec Applixware™

OpenJade ne précise pas de style par défaut pour le corps du texte. Dans le passé, ce problème non diagnostiqué engendrait un long processus de génération du sommaire. Grâce à la grande aide des gens d'Applixware™, le symptôme a été diagnostiqué et un contournement est disponible.

1. Produire la version RTF en saisissant :

   doc/src/sgml$ gmake postgres.rtf
   

2. Réparer le fichier RTF afin de spécifier correctement tous les styles et en particulier le style par défaut (default). Si le document contient des sections refentry, il faut remplacer les éléments de formatage qui relient le paragraphe précédent au paragraphe courant par un lien entre le paragraphe courant et paragraphe suivant. Un utilitaire, fixrtf , est disponible dans doc/src/sgml afin de permettre ces corrections :

   doc/src/sgml$ ./fixrtf --refentry postgres.rtf
   

   Le script ajoute {\s0 Normal;} comme style de rang zéro dans le document. D'après Applixware™, le standard RTF prohibe l'utilisation implicite d'un style de rang 0 alors que Microsoft Word est capable de gérer ce cas. Afin de réparer les sections refentry, le script remplace les balises \keepn par \keep.

3. Ouvrir un nouveau document dans Applixware Words™ et y importer le fichier RTF.

4. Produire une nouvelle table des matières avec Applixware™.

   1. sélectionner les lignes existantes de la table des matières, du premier caractère de la table au dernier caractère de la dernière ligne ;

   2. construire une nouvelle table des matières en allant dans le menu Tools → Book Building → Create Table of Contents. Sélectionner les trois premiers niveaux de titres pour l'inclusion dans la table des matières. Cela remplace les lignes existantes importées du RTF en une table des matières issue d'Applixware™ ;

   3. Ajuster le formatage de la table des matières à l'aide de Format → Style, en sélectionnant chacun des trois styles de la table des matières et en ajustant les indentations pour First et Left. Utiliser les valeurs suivantes :

      Style	Indentation de First (pouces)	Indentation de Left (pouces)
      TOC-Heading 1	0.4	0.4
      TOC-Heading 2	0.8	0.8
      TOC-Heading 3	1.2	1.2

5. Sur l'ensemble du document :

   • ajuster les sauts de page ;

   • ajuster la largeur des colonnes des tables.

6. Remplacer les numéros de pages justifiés à droite dans les portions d'exemple et de figures de la table des matières avec les bonnes valeurs. Cela ne prend que quelques minutes.

7. Supprimer la section d'index du document si elle est vide.

8. Régénérer et ajuster la table des matières.

   1. sélectionner un champ de la table des matières ;

   2. sélectionnez le menu Tools → Book Building → Create Table of Contents ;

   3. délier la table des matières en sélectionnant le menu Tools → Field Editing → Unprotect ;

   4. supprimer la première ligne de la table des matières, qui est un des champs de la table elle-même.

9. Sauvegarder le document au format natif Applixware Words™ pour que les modifications de dernière minute soient plus faciles par la suite.

10. « Imprimer » le document dans un fichier au format Postscript.