$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