Documentation PostgreSQL 14.22 » Annexes » Documentation » Écriture de la documentation

Précédent | Niveau supérieur | Suivant
J.3. Construire la documentation | Sommaire | J.5. Guide des styles

## J.4. Écriture de la documentation

Les sources de la documentation sont généralement modifiés avec un éditeur disposant d'un mode d'édition XML, et encore plus s'il a certaines connaissances des langages du schéma XML pour qu'il puisse connaître la syntaxe DocBook.

Notez que pour des raisons historiques, les fichiers sources de la documentation sont nommés avec une extension `.sgml` même si ce sont maintenant des fichiers XML. Donc vous aurez besoin d'ajuster la configuration de votre éditeur pour configurer le bon mode.

### J.4.1. Emacs

nXML Mode, qui est fourni avec Emacs, est le mode le plus commun pour éditer des documents XML avec Emacs. Il vous permettra d'utiliser Emacs pour insérer les balises et vérifier la cohérence des balises. Il supporte DocBook directement. Vérifiez le manuel nXML pour une documentation détaillée.

`src/tools/editors/emacs.samples` contient les configurations recommendées pour ce mode.