diff -r 000000000000 -r 1397c2bfefa2 HACKING
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/HACKING	Mon Dec 26 19:21:22 2005 -0500
@@ -0,0 +1,135 @@
+$Id: HACKING 1841 2005-12-27 00:21:22Z fabien $
+
+DESCRIPTION DES FICHIERS
+========================
+
+arpeges.sgml: fichier principal pour la version longue des Arpèges.
+
+arpeges_basic.sgml: fichier principal pour la version allégée des Arpèges.
+
+*.sgml: entités externes utilisés pour les Arpèges.
+
+struct.dtd: définitions des entités externes des Arpèges.
+
+xmltex.cfg: Fichier de configuration de xmltex/pdfxmltex.
+
+Makefile: cibles principales de la compilation.
+
+HACKING: ce fichier
+
+GFDL: GNU Free Documentation Licence
+
+GFDL_fr: Traduction de la GFDL
+
+HARMONIQUE: Licence Harmonique
+
+COPYING: Note de licence
+
+draft/: Répertoire contenant différents brouillons et notes sur le
+développement des Arpèges.
+
+utils/: Fichiers partagés avec Opéra.
+
+utils/Makefile.rules: Règles génériques de compilation.
+
+perso.sk: Feuille de personnage en format sketch.
+
+create.fig: Feuille de personnage en format X-Fig.
+
+DESCRIPTION DES CIBLES
+======================
+
+booklet: produit un fichier pdf prêt à une impression en half-letter
+pour former un feuillet.
+
+pdf: produit un fichier pdf normal. Prend l'option SHORT_VERSION.
+
+text: produit une sortie texte à partir du format html. Prend l'option SHORT_VERSION.
+
+html: produit une sortie multi-pages en html. Prend l'option SHORT_VERSION.
+
+html_one: produit une sortie sur une seule page en html. Prend l'option SHORT_VERSION.
+
+aides: création des aides de jeu
+
+normal: création des formats de distribution pour les Arpèges version longue.
+
+short: création des formals de distribution pour les Arpèges version allégée.
+
+all: équivalent à normal + short + aides
+
+snapshot: produit une archive courante du source.
+
+clean: retire les fichiers temporaires.
+
+purge: retire les fichiers temporaires et les cibles.
+
+validate: valide le source XML.
+
+
+DESCRIPTION DES OPTIONS DE COMPILATION
+======================================
+
+SHORT_VERSION: [non-défini] Indique de formatter une version
+allégée des Arpèges. Peut valoir 1.
+
+MAX_TEX_RECURSION: [4] Nombre maximum de fois que TeX est repassé sur
+la cible.
+
+XML_EXT: [sgml] Extension par défaut des fichiers XML.
+
+PAPERSIZE: [letter] Type de papier. Couramment, il n'y a que
+letter et a4 qui sont supportés.
+
+HTML2TXT: [w3m -dump] Commande pour convertir du html en texte.
+
+XSLT: [xsltproc] Transformateur xslt. saxon est aussi supporté.
+
+FOP: [passivetex] Processeur XSL-FO. fop est une autre option possible
+mais ne fonctionne pas actuellement.
+
+XML_DECL [/usr/share/sgml/declaration/xml.decl]: fichier de la déclaration xml.
+
+DOCBOOK_XSL_PATH: [/usr/share/sgml/docbook.stylesheet/xsl/nwalsh]
+Répertoire d'installation des feuilles de style XSL.
+
+JAVADIR: [/usr/share/java] Répertoire java contenant les principales
+classes java.
+
+CATALOG: [./catalog:/etc/sgml/catalog] Listes de catalog SGML.
+
+PRINT_STYLE: [$(DOCBOOK_XSL_PATH)/fo/docbook.xsl] Feuille de style
+pour l'impression.
+
+HTML_STYLE: [$(DOCBOOK_XSL_PATH)/html/docbook.xsl] Feuille de style
+pour le format HTML en une page.
+
+CHUNK_STYLE: [$(DOCBOOK_XSL_PATH)/html/chunk.xsl] Feuille de style
+pour le format HTML multi-pages.
+
+{PRINT|HTML|CHUNK}_OPTIONS: Options pour les différentes feuilles de
+style précédentes.
+
+DESCRIPTION DES OUTILS:
+=======================
+
+XML Docbook DTD:  http://www.docbook.org/
+
+Norman Walsh' XSL Docbook: http://docbook.sf.net/
+
+xsltproc: http://xmlsoft.org/XSLT/
+
+xmltex:  http://www.ctan.org/tex-archive/macros/xmltex/
+
+passivetex: http://users.ox.ac.uk/~rahtz/passivetex/
+
+sketch: http://sketch.sf.net/
+
+X-Fig: http://www.xfig.org/
+
+Ghostscript: http://ghostscript.sf.net/
+
+PSUtils: http://www.dcs.ed.ac.uk/home/ajcd/psutils/
+
+SP: http://www.jclark.com/sp ou 
+OpenSP: http://openjade.sf.net