HACKING
brancharpeges
changeset 0 1397c2bfefa2
equal deleted inserted replaced
-1:000000000000 0:1397c2bfefa2
       
     1 $Id: HACKING 1841 2005-12-27 00:21:22Z fabien $
       
     2 
       
     3 DESCRIPTION DES FICHIERS
       
     4 ========================
       
     5 
       
     6 arpeges.sgml: fichier principal pour la version longue des Arpèges.
       
     7 
       
     8 arpeges_basic.sgml: fichier principal pour la version allégée des Arpèges.
       
     9 
       
    10 *.sgml: entités externes utilisés pour les Arpèges.
       
    11 
       
    12 struct.dtd: définitions des entités externes des Arpèges.
       
    13 
       
    14 xmltex.cfg: Fichier de configuration de xmltex/pdfxmltex.
       
    15 
       
    16 Makefile: cibles principales de la compilation.
       
    17 
       
    18 HACKING: ce fichier
       
    19 
       
    20 GFDL: GNU Free Documentation Licence
       
    21 
       
    22 GFDL_fr: Traduction de la GFDL
       
    23 
       
    24 HARMONIQUE: Licence Harmonique
       
    25 
       
    26 COPYING: Note de licence
       
    27 
       
    28 draft/: Répertoire contenant différents brouillons et notes sur le
       
    29 développement des Arpèges.
       
    30 
       
    31 utils/: Fichiers partagés avec Opéra.
       
    32 
       
    33 utils/Makefile.rules: Règles génériques de compilation.
       
    34 
       
    35 perso.sk: Feuille de personnage en format sketch.
       
    36 
       
    37 create.fig: Feuille de personnage en format X-Fig.
       
    38 
       
    39 DESCRIPTION DES CIBLES
       
    40 ======================
       
    41 
       
    42 booklet: produit un fichier pdf prêt à une impression en half-letter
       
    43 pour former un feuillet.
       
    44 
       
    45 pdf: produit un fichier pdf normal. Prend l'option SHORT_VERSION.
       
    46 
       
    47 text: produit une sortie texte à partir du format html. Prend l'option SHORT_VERSION.
       
    48 
       
    49 html: produit une sortie multi-pages en html. Prend l'option SHORT_VERSION.
       
    50 
       
    51 html_one: produit une sortie sur une seule page en html. Prend l'option SHORT_VERSION.
       
    52 
       
    53 aides: création des aides de jeu
       
    54 
       
    55 normal: création des formats de distribution pour les Arpèges version longue.
       
    56 
       
    57 short: création des formals de distribution pour les Arpèges version allégée.
       
    58 
       
    59 all: équivalent à normal + short + aides
       
    60 
       
    61 snapshot: produit une archive courante du source.
       
    62 
       
    63 clean: retire les fichiers temporaires.
       
    64 
       
    65 purge: retire les fichiers temporaires et les cibles.
       
    66 
       
    67 validate: valide le source XML.
       
    68 
       
    69 
       
    70 DESCRIPTION DES OPTIONS DE COMPILATION
       
    71 ======================================
       
    72 
       
    73 SHORT_VERSION: [non-défini] Indique de formatter une version
       
    74 allégée des Arpèges. Peut valoir 1.
       
    75 
       
    76 MAX_TEX_RECURSION: [4] Nombre maximum de fois que TeX est repassé sur
       
    77 la cible.
       
    78 
       
    79 XML_EXT: [sgml] Extension par défaut des fichiers XML.
       
    80 
       
    81 PAPERSIZE: [letter] Type de papier. Couramment, il n'y a que
       
    82 letter et a4 qui sont supportés.
       
    83 
       
    84 HTML2TXT: [w3m -dump] Commande pour convertir du html en texte.
       
    85 
       
    86 XSLT: [xsltproc] Transformateur xslt. saxon est aussi supporté.
       
    87 
       
    88 FOP: [passivetex] Processeur XSL-FO. fop est une autre option possible
       
    89 mais ne fonctionne pas actuellement.
       
    90 
       
    91 XML_DECL [/usr/share/sgml/declaration/xml.decl]: fichier de la déclaration xml.
       
    92 
       
    93 DOCBOOK_XSL_PATH: [/usr/share/sgml/docbook.stylesheet/xsl/nwalsh]
       
    94 Répertoire d'installation des feuilles de style XSL.
       
    95 
       
    96 JAVADIR: [/usr/share/java] Répertoire java contenant les principales
       
    97 classes java.
       
    98 
       
    99 CATALOG: [./catalog:/etc/sgml/catalog] Listes de catalog SGML.
       
   100 
       
   101 PRINT_STYLE: [$(DOCBOOK_XSL_PATH)/fo/docbook.xsl] Feuille de style
       
   102 pour l'impression.
       
   103 
       
   104 HTML_STYLE: [$(DOCBOOK_XSL_PATH)/html/docbook.xsl] Feuille de style
       
   105 pour le format HTML en une page.
       
   106 
       
   107 CHUNK_STYLE: [$(DOCBOOK_XSL_PATH)/html/chunk.xsl] Feuille de style
       
   108 pour le format HTML multi-pages.
       
   109 
       
   110 {PRINT|HTML|CHUNK}_OPTIONS: Options pour les différentes feuilles de
       
   111 style précédentes.
       
   112 
       
   113 DESCRIPTION DES OUTILS:
       
   114 =======================
       
   115 
       
   116 XML Docbook DTD:  http://www.docbook.org/
       
   117 
       
   118 Norman Walsh' XSL Docbook: http://docbook.sf.net/
       
   119 
       
   120 xsltproc: http://xmlsoft.org/XSLT/
       
   121 
       
   122 xmltex:  http://www.ctan.org/tex-archive/macros/xmltex/
       
   123 
       
   124 passivetex: http://users.ox.ac.uk/~rahtz/passivetex/
       
   125 
       
   126 sketch: http://sketch.sf.net/
       
   127 
       
   128 X-Fig: http://www.xfig.org/
       
   129 
       
   130 Ghostscript: http://ghostscript.sf.net/
       
   131 
       
   132 PSUtils: http://www.dcs.ed.ac.uk/home/ajcd/psutils/
       
   133 
       
   134 SP: http://www.jclark.com/sp ou 
       
   135 OpenSP: http://openjade.sf.net