<> <> <> = Pages de manuels = == Le format des pages de manuel == Le format des pages de manuel est documenté par des... pages de manuel :) Voici donc les pages de manuel à lire pour traduire des pages de manuel en en comprenant le format. * '''Explication de la structure des pages de manuel :''' {{{ man 7 man-pages}}} La version française de cette page indique notamment comment les noms des différentes sections doivent être traduites. * '''Format des pages de manuel classiques (format ''man'') :''' {{{ man 7 man man 7 groff_man}}} * '''Format des pages de manuel BSD (format ''mdoc'') :''' {{{ man 7 mdoc man 7 groff_mdoc}}} == Vérifier les pages de manuel == * Vérifier l'orthographe : {{{ aspell --mode=nroff check ma_page.1}}} * Vérifier le rendu du document : {{{ man -l ma_page.1}}} = SGML et XML = == Reconnaître les formats DocBook et LinuxDoc == Les deux principaux formats source que nous utilisons pour la documentation sont les format [[Format_des_documents/DocBook|DocBook]] (XML et SGML) et [[Format_des_documents/LinuxDoc|LinuxDoc]] (SGML). * Le format '''[[Format_des_documents/DocBook|DocBook]]''' est reconnaissable car il commence soit par une ligne du type (SGML [[Format_des_documents/DocBook|DocBook]]) : {{{ }}} soit par une ligne du type (XML [[Format_des_documents/DocBook|DocBook]]) : {{{ }}} * Le format SGML '''[[Format_des_documents/LinuxDoc|LinuxDoc]]''' commence toujours par une ligne du type : {{{ }}} Pour plus d'informations, consultez les pages dédiées à /LinuxDoc et à /DocBook. == Vérifier l'orthographe d'un document XML (ou SGML) avec aspell == Si les outils de correction orthographique ne sont pas parfaits, ils permettent de corriger les plus grosses erreurs. L'utilisation d'un correcteur orthographique est donc en général une étape indispensable à la réalisation d'une bonne traduction. Aspell permet de vérifier un texte XML (ou SGML) balisé en faisant abstraction des balises, ce qui facilite grandement le travail. Il vous suffit de lancer la commande suivante : {{{ aspell -H mon_document.xml }}}