Vous trouverez la dernière version de M4_SOFTWARE_URL_SGML, écrit par M4_EMAIL_URL_SGML, à l'adresse : M4_SOFTWARE_URL Ce document, écrit en SGML, peut être disponible en plusieurs formats: M4_AVAILABLE_FORMATS(`M4_THIS_FILE_PREFIX') (à la convenance de l'administrateur du site). Introduction

Le logiciel M4_SOFTWARE est utile pour générer facilement des fichiers aux formats ASCII, TeX, SGML, PostScript, HTML, HTML monobloc, PDF, Info, LyX, et man à partir d'un document SGML écrit avec la DTD linuxdoc. L'internationalisation des balises de navigation HTML est prise en compte. Le logiciel M4_SOFTWARE est une collection de répertoires, d'un fichier Makefile, et d'exemples en SGML, associés pour pouvoir créer de la documentation selon différents formats de sortie en une seule commande de type make. Toutes les langues de sgmltools sont supportées. Installation

L'installation est très simple puisqu'elle consiste à extraire l'archive à l'endroit où vous voulez générer votre documentation. Prérequis

La plupart des logiciels nécessaires sont surement déjà présent sur votre système car ils font partie de toute bonne distribution libre qui se respecte. Logiciels: sgmltools 1.0.x (j'utilise 1.0.9) perl. Utilisé par sgmltools. make (gnu make) m4 (gnu m4) pour vous faciliter les traitements redondants LaTeX (pour générer des fichiers .dvi). Optionnel. pdflatex (pour générer des fichiers .pdf). Optionnel. ghostview (pour visualiser des fichiers .ps). Optionnel. lynx (lynx est fort en ASCII). Optionnel. tidy (tidy un correcteur HTML). Optionnel. rcs ou cvs (Si vous voulez utiliser un contrôle de version sur vos documents). Optionnel. tar (gnu tar). Optionnel. Vous devez savoir écrire des documents au format SGML avec la DTD linuxdoc. Téléchargement

Téléchargez M4_SOFTWARE via ftp à l'adresse suivante: L'archive est nommée M4_SOFTWARE-M4_VERSION.tgz où M4_VERSION est le numéro de version. Mise en place

You n'avez pas besoin d'être root pour installer M4_SOFTWARE. Vous installez M4_SOFTWARE là où vous voulez créer de la documentation. gzip -tv M4_SOFTWARE-M4_VERSION.tgz # optionnel mais rassurant cd où/vous/voulez tar tzvf M4_SOFTWARE-M4_VERSION.tgz tar xzvf M4_SOFTWARE-M4_VERSION.tgz cd M4_SOFTWARE-M4_VERSION make # et lisez ... Vous pouvez renommer le répertoire M4_SOFTWARE-M4_VERSION/ comme bon vous semble à n'importe quel moment. La commande make utilisée sans argument produit simplement un rappel des options disponibles; c'est l'équivalent de make help Utilisation

Pour l'impatient

Si vous écrivez des documents dans une autre langue que l'anglais (l'anglais est la langue par défaut) vous devez terminer son nom par le suffixe .ll.sgml où ll sont les deux caractères symbolisant votre langue. En voici la liste: en: english,english, de: deutsch,german, nl: nederlands,dutch, fr: français,french, es: español,spanish, da: dansk,danish, no: norsk,norwegian, se: svenska,swedish, pt: portuges,portuguese, ca: català,catalan, it: italiano,italian, ro: românã,romanian Créer un nouveau fichier en vous inspirant du modèle: cd M4_SOFTWARE-M4_VERSION cp sgml/lidoma-model.fr.sgml sgml/monfichier.fr.sgml Editez le fichier sgml/monfichier.fr.sgml (emacs est particulièrement adapté pour cela). Sauvegardez le. Générez un fichier HTML sur une seule page: make htm regardez dans le répertoire htm/ ls -l htm/ monfichier.fr.htm Visualisez le fichier monfichier-fr.htm avec votre navigateur favori (lynx, n'est-ce pas?). Essayez d'autres format de sortie: make make txt html ps pdf Si vous désirez cloner l'essentiel de M4_SOFTWARE tapez juste: make clone et déplacer le répertoire clone/ où bon vous semble. Index

Pour créer un fichier index, nommé index.html dans chaque répertoire, utiliser la commande: make indexes make i # même comportement make if # en force (élimine les anciens fichiers) Certains traitements sont automatisés avec m4. Toutes les définitions sont définis une seule fois dans le fichier include/definitions.m4 et les fichiers qu'il inclut. Pour modifier les définitions principales les plus voyantes et utiles, éditez le fichier include/override.m4 et modifiez les valeurs à votre guise. Bonne doc !