<oXygen/> XML Editor User Guide |
Les processeurs Xalan et Saxon supportent l'usage d'élements d'extension et de fonctions d'extension. Contrairement à un élément de résultat littéral, auquel la feuille de style transfert simplement l'arbre résultat, un élément extension exécute une action. L'extension est habituellement utilisée car la feuille de style xslt échoue à proposer des fonctions adéquates à l'utilisateur pour accomplir une tâche plus complexe.
Extensions for Xalan and Saxon are included in [<oXygen/> install directory] \frameworks\docbook\xsl\extensions. If you want to use the extensions group for Xalan, you have to rename the file "xalan25.jar.ext" to "xalan25.jar". Same specifications for Saxon: rename "saxon653.jar.ext" to "saxon653.jar". You can only use one group of extensions at a time.
Exemples sur comment utiliser les extensions peut être trouvé ici :
http://xml.apache.org/xalan-j/extensions.html
http://saxon.sourceforge.net/saxon6.5.2/extensions.html
Les choses suivantes doivent être faites dans l'ordre afin que le transformateur puisse trouver et utiliser avec succès les classes de l'extension Java :
Régler la propriété "com.oxygenxml.additional.classpath" afin qu'elle contienne les chemins additionnels vers les dossiers contenant les classes ou jars de l'extension Java utilisée.
Exemple de réglage pour un dossier appelés "test1" contenant des classes d'extension et un jar "test2/ext.jar" situés dans le dossier C:\work\ext\ :
Pour les personnes qui utilisent un script ( bat ou sh ) pour
lancer <oXygen/>, ajoutez le paramètre suivant
"-Dcom.oxygenxml.additional.classpath=C:/work/ext/test1;C:/work/ext/test2/ext.jar"
à la ligne de commande java dans votre fichier de script (oxygen.bat
ou
oxygen.sh
). Exemple : "java -Xmx256m
-Dcom.oxygenxml.additional.classpath=C:/work/ext/test1;C:/work/ext/test2/ext.jar
-cp %CP% ro.sync.exml.Oxygen %1 %2 %3 %4 %5" .
Pour les personnes qui utilisent un exécutable ( exe ) pour
lancer <oXygen/>, ajoutez le paramètre suivant
"com.oxygenxml.additional.classpath=C:/work/ext/test1;C:/work/ext/test2/ext.jar"
dans le fichier oxygen.ini
situé dans le dossier racine de
<oXygen/>.
Après que le paramètre est réglé, les classes et jars Java des chemins de l'extension sont dynamiquement chargés et peuvent être utilisés par les processeurs de transformation sans aucun réglage supplémentaire.