Installation

XToGen 1 fonctionne (presque) "out of the box", pour XToGen 2, il y a quelques fichiers à modifier.

XToGen 1

Après avoir décompressé votre archive ZIP, modifier le fichier global_xtogen.properties (dans xtogen/static) pour l'adapter à votre installation de SDX.

XToGen 2

Après avoir décompressé votre archive ZIP, modifier le fichier global_xtogen.properties (dans xtogen/static) pour l'adapter à votre installation de SDX.

Il reste ensuite 2 manipulations à effectuer sur votre installation Tomcat/SDX pour assurer le bon fonctionnement de XToGen :

  • Ajoutez la ligne suivante dans $CATALINA_HOME/bin/catalina.sh (si vous êtes sous Unix/Linux)
    JAVA_OPTS='-Djava.awt.headless=true -Xms128m -Xmx512m'
    ou la ligne suivante dans %CATALINA_HOME%\bin\catalina.bat (si vous êtes sous Windows) :
    set JAVA_OPTS=-Xms128m -Xmx512m
    Les lignes précédentes permettent d'augmenter la capacité de mémoire allouée par Java et sont nécessaires pour les opérations gourmandes en mémoire (comme la génération PDF par exemple). La directive headless sert pour la génération des galeries de vignettes.
  • Ajoutez au fichier {CATALINA_HOME}/webapps/sdx/WEB-INF/cocoon.xconf la section suivante :
    <!-- The XToGen logicsheet. The XSLT file is in xtogen-lib.jar. -->
    <builtin-logicsheet>
    	<parameter name="prefix" value="xtg"/>
    	<parameter name="uri" value="http://xtogen.tech.fr"/>
    	<parameter name="href" value="resource://fr/tech/sdx/xtogen/logicsheet/xtogen.xsl"/>
    </builtin-logicsheet>
    
    dans la section <target-language name="java"> par exemple après la déclaration de la feuille de style logique SDX (à la ligne 324). Ceci permet l'utilisation des tags XToGen (préfixe xtg) dans les feuilles XSP.