diff --git a/fr_FR.ISO8859-1/books/fdp-primer/tools/chapter.sgml b/fr_FR.ISO8859-1/books/fdp-primer/tools/chapter.sgml index 29b6d1e45a..4d73927dd7 100644 --- a/fr_FR.ISO8859-1/books/fdp-primer/tools/chapter.sgml +++ b/fr_FR.ISO8859-1/books/fdp-primer/tools/chapter.sgml @@ -1,301 +1,301 @@ Outils Le FDP utilise un certain nombre de logiciels pour faciliter la gestion de la documentation de FreeBSD, la convertir en différents formats, et ainsi de suite. Vous devrez vous-même vous servir de ces outils, si vous travaillez à la documentation de FreeBSD. Tous ces outils existent sous forme de logiciels portés ou pré-compilés pour FreeBSD, ce qui vous simplifie beaucoup la tâche de leur installation. Vous devrez les installer avant de mettre en pratique les exemples donnés dans les chapitres suivants. Ces chapitres vous expliquent comment vous servir de ces outils. Utilisez <filename>textproc/docproj</filename> si possible Vous pouvez gagner beaucoup de temps si vous les installez avec textproc/docproj. C'est un méta-port qui ne contient pas lui-même de logiciels. Au lieu de cela, il dépend de l'installation correcte de divers autres logiciels portés. Son installation devrait télécharger et installer automatiquement tous les paquetages listés dans ce chapitre dont vous aurez besoin, s'ils n'existent pas déjà sur votre système. L'un des paquetages dont vous aurez peut-être besoin est le jeu de macro-instructions JadeTeX. Celui-ci, à son tour, a besoin que TeX soit installé. TeX est un paquetage volumineux, dont vous n'aurez besoin que si vous voulez générer les versions PostScript et PDF. Pour économiser du temps et de l'espace disque, vous pouvez préciser si vous voulez ou non installer JadeTeX (et donc TeX). Faites soit : &prompt.root; make JADETEX=yes install ou : &prompt.root; make JADETEX=no install selon le cas. Outils indispensables Logiciels Vous aurez besoin de ces programmes avant de pouvoir utilement travailler sur la documentation de FreeBSD. Ils font tous partie de textproc/docproj. SP (textproc/sp) Une série d'applications, dont un analyseur syntaxique SGML et un outil de normalisation du source SGML. Jade (textproc/jade) Une implémentation des DSSSL. Cela sert à convertir des documents marqués vers d'autres formats, dont HTML et TeX. Tidy (www/tidy) Un formateur HTML, qui sert à remettre en forme le code HTML généré automatiquement pour qu'il soit plus lisible. Lynx (www/lynx-current) Navigateur WWW en mode texte, &man.lynx.1; peut aussi convertir des fichiers HTML en fichiers texte. DTDs et Entités Ce sont les DTDs et jeux d'entités utilisés par le FDP. Il faut les installer avant de pouvoir travailler à la documentation. DTD HTML (textproc/html) HTML est le langage principal du World Wide Web, il est utilisé constamment par le site Web de FreeBSD. DTD LinuxDoc (textproc/linuxdoc) Une partie de la documentation de FreeBSD est marquée avec LinuxDoc. Le FDP migre activement de LinuxDoc à DocBook. DTD DocBook (textproc/docbook) DocBook est conçu pour le marquage de documentation technique et le FDP est en cours de migration de LinuxDoc à DocBook. A la date de rédaction de cette documentation, celle-ci et le Manuel de Référence de FreeBSD sont au format DocBook. Entités ISO 8879 (textproc/iso8879) 19 de jeux de caractères ISO 8879:1986 utilisés par de nombreuses DTDs. Cela comprend des symboles mathématiques nommés, les caractères “latins” supplémentaires (accents, signes diacritiques et ainsi de suite) et les lettres grecques. Feuilles de style Les feuilles de style sont utilisées pour convertir et formater la documentation pour l'affichage à l'écran, l'impression, et ainsi de suite. Les Modular DocBook Stylesheets (textproc/dsssl-docbook-modular) Les Modular DocBook Stylesheets sont utilisées pour convertir la documentation marqué en DocBook aux autres formats, comme HTML ou RTF. Outils facultatifs Il n'est pas obligatoire d'installer les outils qui suivent. Si vous le faites cependant, vous trouverez peut-être plus facile de travailler à la documentation et ils vous donneront plus de possibilité de choix du format de sortie. Logiciels JadeTeX et teTeX (print/jadetex et print/teTeX) Jade et teTeX servent à convertir les documents DocBook en DVI, Postscript et PDF. Il faut pour cela les macro-instructions JadeTeX. Si vous n'avez pas l'intention de convertir votre documentation à l'un de ces formats (i.e., HTML, texte et RTF vous suffisent), il n'est pas nécessaire d'installer JadeTeX et teTeX. Cela vous fera gagner du temps et de l'espace disque, teTeX, en effet occupe plus de 30 Mo. Si vous choisissez d'installer JadeTeX et teTeX, vous devrez configurer teTeX après avoir installé JadeTeX. - print/jadetex/pkg/MESSAGE vous donnera + print/jadetex/pkg-message vous donnera des instructions détaillées sur la façon de procéder. Emacs ou xemacs (editors/emacs ou editors/xemacs) Ces deux éditeurs ont un mode spécialisé pour travailler sur des documents marqués conformément à une DTD SGML. Cela vous permet d'avoir moins de choses à saisir et limite la possibilité d'erreurs. Vous n'êtes pas obligé de les utiliser, n'importe quel éditeur peut servir avec des documents marqués. Mais vous trouverez peut-être qu'ils vous permettent d'être plus efficace. Si quelqu'un a d'autres outils utiles pour manipuler des documents SGML, merci de transmettre l'information à Nik Clayton (nik@freebsd.org), de façon à ce qu'il les ajoute à cette liste.