Lors de la création d'un nouveau document avec Jaxe, il est nécessaire de choisir un fichier de config.
Les fichiers de config de Jaxe permettent de spécifier l'interface d'édition des documents XML avec Jaxe pour un langage XML donné. Ceci recouvre les informations sur le langage XML, les options d'enregistrement, les menus (notamment pour insérer les éléments), les types d'affichage des éléments, les exports possibles, et toutes les chaînes de caractères utilisées dans l'interface, en fonction de la langue de l'utilisateur.
Les fichiers de config se trouvent dans le répertoire config de Jaxe, et leurs noms se terminent par "_config.xml". Les anciens fichiers de config (avant Jaxe 3.0) avaient un nom se terminant en "_Jaxe_cfg.xml". On peut les convertir dans la nouvelle version à partir d'un menu d'export dans le menu Fichier.
Il est possible d'ouvrir un schéma XML dans Jaxe et d'"exporter" vers un fichier de config. Cela crée automatiquement un fichier de config qui permettra l'édition dans Jaxe pour ce schéma, mais les choix automatiques pour les types d'affichage sont souvent mauvais ou insuffisants : cet export ne doit pas être considéré comme une méthode de création des fichiers de config, mais peut servir pour commencer la création d'un fichier de config à partir d'un schéma particulièrement complexe.
Arbre des éléments sous l'élément LANGAGE :
Arbre des éléments sous l'élément ENREGISTREMENT :
Les menus définis dans les fichiers de config s'affichent au-dessus de la zone de texte de Jaxe. Ils ne sont pas mélangés avec la barre de menus de Jaxe, qui se trouve au-dessus (en haut de l'écran sur Mac).
Arbre des éléments sous l'élément MENUS :
Une fonctionnalité essentielle de Jaxe est la possibilité d'afficher et d'éditer les éléments XML de diverses façons, quelque soient leurs types dans le schéma XML. On pourra par exemple choisir d'afficher un élément représentant une table sous forme de table, ou un élément pointant vers une image sous forme d'image. L'objectif étant de faciliter l'édition des documents, sans pour autant perdre de vue leur aspect sémantique : on ne cherchera pas à afficher les éléments tels qu'on les verra sous forme de page web ou PDF, mais simplement avec une interface facilitant l'édition et mettant en évidence le sens des différents éléments.
Arbre des éléments sous l'élément AFFICHAGE_NOEUDS :
| Type | Description | Affichage |
|---|---|---|
| division | Deux barres allant jusqu'au bout de la fenêtre à droite, permettant de bien séparer de grandes parties du document. | |
| zone | Deux balises et des retours à la ligne, pour séparer des parties plus petites qu'avec division. | |
| string | Deux balises pour identifier une petite chaîne de caractères, sans retour à la ligne. | |
| vide | Une seule balise, typiquement pour un élément vide. | |
| tableau | Affichage de tableau de type tableur (avec le composant Swing JTable). Pratique pour des tableaux de nombres, mais ne permet pas d'utiliser des élements XML à l'intérieur des cellules (utiliser tabletexte pour cela). | |
| tabletexte | Affichage d'une table permettant d'utiliser des éléments XML dans les cellules. Gère aussi les attributs rowspan et colspan pour regrouper les cellules verticalement et horizontalement. | |
| style | A utiliser dans le cas (très rare si le langage XML code le sens par opposition à la forme) où un élément XML ne donne qu'une information de style. Affiche les caractères dans le style choisi (gras, italique, ...), sans aucune balise. Une alternative est d'utiliser le type string, qui permet aussi de choisir un style, mais affiche les balises. | |
| fichier | Affiche une image à partir de son chemin sur le disque issu d'un attribut de l'élément XML (à préciser). Il est possible de faire des copier/coller d'images et Jaxe créera automatiquement l'élément XML et le fichier de l'image sur le disque, en utilisant le premier élément de type fichier. | |
| symbole | Permet de choisir une image parmi un ensemble d'images situé dans un dossier. | |
| liste | Pour un élément correspondant à une liste à points ou numérotée. Le sous-élément doit utiliser le type item. S'affiche comme zone, avec un bouton '+' pour créer de nouveaux éléments de la liste. | |
| item | Elément d'une liste affichée avec le type liste. S'affiche avec des points ou des numéros, en fonction du type de liste. | |
| typesimple | Affiche un élément ayant une simple valeur, dans une petite zone particulière. Utilisable uniquement pour les éléments ayant un type simple dans le schéma XML. L'affichage précis (zone de texte, menu ou boîte à cocher) et la validation se fait en utilisant les contraintes du schéma XML. | |
| equation | Affiche l'image d'une équation. L'équation peut être éditée par un simple clic dessus, avec un dialogue présentant en même temps le texte de l'équation (avec une syntaxe très simple propre à Jaxe) et l'image correspondante. | |
| formulaire | Affiche un élément et tous ses sous-éléments possibles sous la forme d'un formulaire, avec un champ par sous-élément. Attention à ne pas utiliser ce type avec des éléments pouvant avoir un sous-arbre infiniment profond ! | |
| plugin | Si vous voulez définir votre propre élément Jaxe, c'est possible ! Voir la partie "Création de nouveaux éléments Jaxe" de la documentation pour les développeurs pour plus de précisions. |
Des paramètres peuvent être utilisés, en fonction des types d'affichage, avec l'élément PARAMETRE sous AFFICHAGE_ELEMENT.
Les affichages de type division et zone peuvent avoir un paramètre indiquant le nom de l'attribut à utiliser comme titre pour l'affichage.
Les affichages de type fichier et symbole doivent avoir un paramètre indiquant l'attribut repérant le nom du fichier.
Les affichages de type tableau et tabletexte doivent avoir des paramètres indiquant les éléments repérant les lignes et les cellules.
Les affichages de type style doivent avoir un paramètre indiquant le style.
Les affichages de type zone et string peuvent avoir un paramètre indiquant le style, un paramètre avec la police de caractères, et un paramètre avec la taille des caractères.
Les affichages de type equation doivent avoir des paramètres indiquant les attributs à utiliser pour le texte de l'équation et le nom de l'image.
Voilà la liste complète des paramètres possibles:
| type | nom du paramètre | description |
|---|---|---|
| division et zone | titreAtt | attribut pour le titre |
| division, zone, string et vide | attributsVisibles | affiche tous les attributs sur la balise de début (true|false) |
| tableau et tabletexte | trTag | élément pour une ligne |
| tableau et tabletexte | tdTag | élément pour une cellule |
| tableau et tabletexte | thTag | élément pour une cellule d'entête |
| tabletexte | colspanAttr | attribut de fusion des colonnes |
| tabletexte | rowspanAttr | attribut de fusion des lignes |
| tabletexte | alignAttr | attribut d'alignement du texte |
| liste | typeListe | type de liste (POINTS|NUMEROS) |
| style, zone et string | style | GRAS|ITALIQUE|EXPOSANT|INDICE|SOULIGNE|BARRE |
| zone et string | police | police de caractères |
| zone et string | taille | taille de caractères |
| fichier et symbole | srcAtt | attribut avec le nom du fichier |
| plugin | classe | classe Java dérivée de JaxeElement |
| item | image1 | première image de pastille |
| item | image2 | deuxième image de pastille |
| equation | srcAtt | attribut avec le nom de l'image |
| equation | texteAtt | attribut avec le texte de l'équation |
Arbre des éléments sous l'élément EXPORTS :
On peut souhaiter modifier tous les textes (appelés aussi chaînes de caractères ou strings) de l'interface créée avec la configuration. Soit pour améliorer la lisibilité sans avoir à modifier le schéma, soit pour fournir une interface dans une autre langue pour le même schéma. On peut aussi souhaiter fournir les textes pour un ensemble de langues, de manière à ce que les utilisateurs puissent éditer les mêmes documents, avec la même configuration Jaxe, mais avec une interface entièrement dans leur langue.
Pour ces raisons, l'élément STRINGS représente un ensemble de textes pour une langue et un pays donné, et il est possible d'en spécifier plusieurs dans le même fichier de config. On mettra par exemple langue="pt" pays="BR" pour le portugais brésilien, ou juste langue="fr" pour spécifier la langue française sans précision sur le pays.
Arbre des éléments sous l'élément STRINGS :
Ce fichier a bien sûr été créé avec Jaxe !