1. Installation

1.1. Installation de XXE

1.1.1. Configuration requise

  • Environnement d'exécution Sun Java[tm] 1.4.1. ou supérieur.

  • Au moins 256 Mo de mémoire et un microprocesseur à 600 MHz.

  • 60 Mo d'espace disque libre, 120 Mo pour un paquetage incluant l'environnement d'exécution Java[tm] 1.5

XXE est officiellement supporté sur Windows NT/2000/XP, sur Linux 2.4 et sur Mac OS X 10.3/10.4. Il est également utilisable sur d'autres plate-formes exécutant Java[tm] 1.4.1+ (Solaris par ex.), mais sans support de la part d' XMLmind.

XXE a été testé avec :

  • l'environnement d'exécution Sun Java[tm] 1.4.1+ (jusqu'à 1.5.0.04) sous Windows NT4, 2000, XP version Familiale, XP version Professionnelle, SuSE Linux 9.0 et 9.3

  • Mac OS X 10.3.9 et Java[tm] 1.4.2_05 (également désigné Apple Java 1.4.2 Update 1), Mac OS X 10.4.1 et Java[tm] 1.4.2_07

  • les serveurs Apache HTTP 2.0.44 et Apache HTTP 1.3.19 + mod_dav 1.0.2

  • Différents serveurs FTP sous Unix

  • le serveur HTTP de Windows 2003 IIS avec son extension WebDAV

  • le serveur FTP de Windows 2003.

1.1.2. Installation sous Unix

Procédure:

  1. S'assurer que le répertoire Java[tm] bin/ est bien référencé dans la variable $PATH et en même temps vérifier que la version du Java[tm] runtime référencée dans la variable $PATH est la bonne.

    $ java -version
    java version "1.5.0_04"
    Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_04-b05)
    Java HotSpot(TM) Client VM (build 1.5.0_04-b05, mixed mode, sharing)
  2. Décompresser la distribution XXE à un endroit.

    $ cd 
    $ tar zxvf xxe-std-211.tar.gz
    $ ls xxe-std-211
    addon/
    bin/
    demo/
    doc/
  3. XXE peut être directement utilisé à partir du répertoire xxe-std-211/.C'est à dire que vous pouvez ajouter xxe-std-211/bin/ à votre variable $PATH.

    $ xxe-std-211/bin/xxe &

1.1.3. Manuel d'installation sous Windows

Le manuel d'installation sur Windows est le même que celui pour l'installation sous Unix. XXE doit être alors lancé en exécutant le script xxe-std-211\bin\xxe.bat plutôt que le script xxe-std-211/bin/xxe.

1.2. Contenu du répertoire de distribution

bin/

contient le code de XXE (fichiers .jar), plusieurs scripts utilisés pour démarrer XXE ainsi que les utilitaires associés.

bin/xxe, xxe.bat

Les scripts de démarrage de XXE. Utiliser xxe sous tout système Unix. Utiliser xxe.bat sous Windows.

bin/deploywebstart, deploywebstart.bat

Les scripts utilisés pour générer une configuration Java[tm] Web Start (fichiers.jnlp, jars authentifiés, etc.) à partir d'un paquetage logiciel XXE pouvant être personnalisé. Utiliser deploywebstart sous tout système Unix. Utiliser deploywebstart.bat sous Windows.

La commande deploywebstart est documentée dans le XMLmind XML Editor - Configuration and Deployment.

bin/xsdvalid, dtdvalid, dtdtoxsd, xsdvalid.bat, dtdvalid.bat, dtdtoxsd.bat

Les scripts utilisés pour lancer xsdvalid, dtdvalid et dtdtoxsd. Voir la documentation Guide de l'utilisateur de l'outil xsdvalid de XMLmind pour plus de détails à propos de ces outils.

bin/rngvalid, rngvalid.bat

Les scripts utilisés pour lancer Jing, le validateur RELAX NG de James Clark.

bin/rngdoc, rngdoc.bat

Les scripts utilisés pour générer un manuel de référence simple à partir des schémas RELAX NG.

Le manuel de référence produit est prévu pour aider les auteurs de contenu à créer des instances conformes à un schéma donné. Ce manuel n'est pas prévu pour aider les auteurs de schéma à documenter leur architecture.

bin/csscheck, csscheck.bat

Les scripts utilisés pour vérifier la syntaxe des feuilles de style CSS écrites pour XXE

bin/convertdoc, convertdoc.bat

Les scripts utilisés pour exécuter convertdoc. Cet outil permet d'exécuter une commande XXE à partir de la ligne de commande exactement comme si cette commande était exécutée depuis XXE.

Voir XMLmind XML Editor - Commands pour plus d'informations sur cet outil.

bin/*.jar

Bibliothèques (non-système) Java[tm] nécessaires pour lancer XXE :

  • xxe_app.jar, xxe.jar qui contient le code de XXE.

    xxe_help.jar qui contient l'aide en ligne de XXE.

    xsc.jar, est le produit de vérification orthographique de XMLmind, le meilleur achat pour un correcteur orthographique, entièrement écrit en langage Java[tm]. Pour plus d'information, visiter http://www.xmlmind.com/spellchecker.

  • jh.jar qui contient le moteur d'aide standard de Java[tm].

    resolver.jar qui contient Apache XML Commons Resolver et qui implémente les entités "catalog-based" et la résolution des URI.

    xp.jar , est le parser XML de James Clark. Voir http://www.jclark.com/.

    D'importantes parties de xsdregex.jar, le traducteur de James Clark pour les XSD vers les expressions régulières Java, ont été directement ajoutées à xxe.jar (c'est pour cela que xsdregex.jar n'est pas inclus dans la distribution). Télécharger le paquetage original depuis http://www.thaiopensource.com/download/.

    Le paquetage com.jclark.xsl.expr contient l'implémentation de XPath 1.0 utilisé par XT, le moteur XSLT de James Clark. Une version modifiée de ce paquetage, renommée com.xmlmind.xmledit.xpath, a été directement ajoutée à xxe.jar (c'est pourquoi xt.jar n'est pas inclus dans la distribution). Télécharger la distribution XT complète depuis http://www.jclark.com/xml/xt-old.html ou depuis http://www.blnz.com/xt/index.html

    relaxng.jar est la version 20030619 de Jing , le validateur RELAX NG de James Clark, légèrement modifié pour son utilisation avec XXE. Les modifications sont détaillées dan le fichier relaxng.README.

    ftp.jar est le client FTP de Bruce Blackshaw. Voir http://www.enterprisedt.com/.

    http.jar est le client HTTP de Ronald Tschalär. Voir http://www.innovation.ch/.

    saxon.jar est le moteur XSLT de Michael H. Kay. Voir http://saxon.sourceforge.net/.

    kunststoff.jar contient le modèle de présentation de Kunststoff. Voir http://www.incors.org/.

    Ces excellents paquetages logiciels n'ont pas été développés par XMLmind. L'information sur le copyright est contenue dans le fichier .LICENSE correspondant. Lire le fichier .README correspondant pour avoir plus de détails à propos de ces paquetages.

    En général, ces paquetages ne font pas parties des outils les plus largement utilisés, ni les plus réputés de leurs catégories. Mais nous avons également testé les plus utilisés et les plus connus de leurs catégories et nous avons choisis les paquetages décrits ci-dessus parce qu'ils sont plus petits, plus rapides et plus robustes que les grands noms. Mille merci aux auteurs de ces paquetages

  • translatexxe.jar contient le code de l'utilitaire mode de commande translatexxe. Cet outil peut être utilisé pour traduire les messages (entrée des menus, messages d'erreurs, etc.) contenus dans l'éditeur XML d'XMLmind.

    Il n'y a pas de commande fournie. Pour exécuter translatexxe utiliser "java -jar translatexxe.jar".

bin/icons/

Contient les icônes du bureau pour XXE.

bin/mac/

Contient des fichiers (par exemple Info.plist) utilisés sur le Mac pour créer XMLEditor.app à partir d'une distribution .zip ou .tar.gz.

addon/

Le répertoire addon/ est l'endroit où XXE trouve ses extensions, quel que soit le type d'extensions: configurations, plug-ins, traduction dans des langues autres que l'anglais, dictionnaires pour le correcteur orthographique.

Le répertoire addon/ est parcouru récursivement par XXE à chaque démarrage. Par conséquent, l'organisation de se répertoire est totalement libre.

addon/config/

Contient des fichiers de configuration pour les applications XML suivantes : DocBook, Simplified DocBook, Slides, XHTML, le fichier de configuration XXE, les XML schémas du W3C.

Le contenu d'un fichier de configuration, qui spécifie une personnalisation de XXE pour une application XML spécifique, est décrit en détail dans le XMLmind XML Editor - Configuration and Deployment.

addon/spell/

Contient les dictionnaires utilisés par le correcteur orthographique. Un dictionnaire est un fichier dont le nom est LL.dar, où LL est un code ISO pour une langue.

addon/translate/

Chaque fichier .jar trouvé dans ce répertoire contient les messages d'XXE traduit dans une langue autre que l'Anglais. Fr.jar contient les messages pour le Français, de.jar contient les message pour l'Allemand, etc.

doc/

contient la documentation de l'éditeur XML XMLmind aux formats HTML et PDF (Acrobat).

Noter que:

doc/user/

Contient le guide de l'utilisateur aux formats HTML et PDF (Acrobat).

Les versions DocBook (userguide.xml) et XHTML (userguide.xhtml) sont fournies également car il peut être utile de les charger dans XXE pour évaluer l'éditeur.

demo/

Contient des documents XML qu'on peut charger dans XXE pour faire la démonstration de quelques-unes de ses caractéristiques.

1.3. Remerciements

Sous Windows, le programme d'installation de L'éditeur XML d'XMLmind (c.-à-d. *setup*.exe) est fabriqué à l'aide de Inno Setup de Jordan Russell's software. XMLmind recommande fortement cet outil excellent et gratuit.