<oXygen/> XML Editor User Guide

Fenêtre principale

L'interface de <oXygen/> utilise des conventions et des composants d'interface standards pour offrir un environnement d'édition familier et intuitif parmi tous les systèmes d'exploitation.

La fenêtre principale est centrale durant le travail. En plus de la barre de titre qui affiche l'icône du programme <oXygen/>, le nom, l'information licence, la fenêtre principale comprend les composants suivants :

Figure 3.24. L'interface principale

L'interface principale

Quand deux ou plus de deux fenêtres principales de panneaux sont affichées, <oXygen/> offre des barres de séparation qui permettent un arrangement dans l'espace de l'écran. En sélectionnant une barre de séparation on peut la déplacer vers une autre position, ainsi augmentant l'espace occupé par un panneau tout en diminant celui occupé par l'autre.

Comme la majorité du travail est centrée autour du panneau de l'éditeur, les autres panneaux peuvent être cachés en utilisant les contrôles d'expansion et de masquage situés sur les barres de séparation.

Menu principal

Le menu principal, situé sous la barre de titre du programme, offre un accès à toutes les fonctions disponibles de <oXygen/>.

Menu Fichier

[Note]Note

Les utilisateurs de Macintosh devront utiliser la touche commande au lieu de control pour tous les raccourcis clavier.

Tableau 3.1. Options du menu Fichier

  • Fichier-> Nouveau (Ctrl+N) : Affiche le dialogue Nouveau à partir duquel on peut sélectionner le type de fichier.

  • Fichier-> Ouvrir (Ctrl+O) : Affiche le dialogue Ouvrir utilisé pour chercher, sélectionner et ouvrir un ou plusieurs fichiers.

  • Fichier-> Ouvrir URL (Ctrl+U) : Affiche le dialogue Ouvrir URL utilisé pour chercher, sélectionner et ouvrir un ou plusieurs fichiers en utilisant FTP/WebDAV.

  • Fichier-> Importer HTML (Ctrl+M) : Importe les fichiers HTML vers XHTML 1.0 Transitional ou Strict. Il en résulte un fichier XHTML qui contient une déclaration DOCTYPE se référant à la définition XHTML DTD sur le Web et le contenu traité du fichier importé comme XHTML Transitional ou Strict suivant quel bouton l'utilisateur a choisi lors de l'importation.

  • Fichier->Revenir: Charge la dernière version sauvegardée du document. Toutes les modifications non-sauvées sont perdues.

  • Fichier->Réouvrir: Affiche une liste des fichiers document récemment ouverts. Sélectionner un fichier à ouvrir.

  • Fichier->À partir d'un modèle : Affiche le dialogue Modèles utilisé pour chercher, sélectionner et ouvrir un nouveau document basé sur un document modèle existant. Les documents modèles agissent comme des points de départ qui ont des propriétés prédéfinies telles que le type de fichier, le prolog, l'élément root, les conteneurs, et même un contenu existant.

  • Fichier->Ajouter aux Modèles : Affiche le dialogue Ajouter Modèles utilisé pour définir le nom avec lequel le modèle sera reconnu dans l'option "Nouveau à partir de modèles" option.

  • Fichier-> Enregistrer (Ctrl+S) : Sauve le document actuel. Si le document n'a pas de fichier, affiche le dialogue "Enregistrer sous".

  • Fichier->Enregistrer sous: Affiche le dialogue Enregistrer sous, utilisé pour nommer et sauver un document ouvert dans un fichier; ou sauver un fichier existant avec un nouveau nom.

  • Fichier->Enregistrer à l'URL : Affiche le dialogue Enregistrer à l'URL, utilisé pour nommer et sauver un document ouvert dans un fichier ; ou sauver un fichier existant sous un nouveau nom, en utilisant FTP/WebDAV.

  • Fichier->Tout enregistrer: Sauve tous les documents ouverts. Si un document n'a pas de fichier, affiche le dialogue "Enregistrer sous".

  • Fichier->Enregistrer les résultats (Ctrl+R) : Affiche le dialogue Enregistrer les résultats, utilisé pour savuer la liste des résultats de l'onglet message actuellement actif.

  • Fichier->Nouveau Projet: Crée un nouveau projet dans le panneau projet.

  • Fichier->Ouvrir le projet (Ctrl+F2) : Affiche le dialogue Ouvrir le projet utilisé pour chercher, sélectionner et ouvrir un fichier projet.

  • Fichier->Enregistrer le projet (Ctrl+F3 (Cmd+G sur Mac)) : Sauve le projet actuel. Si le projet n'a pas de fichier, affiche le dialogue "Enregistrer projet sous".

  • Fichier->Enregistrer le projet sous : Affiche le dialogue Enregistrer le projet sous, utilisé pour nommer et sauver un projet dans un fichier ; ou sauver un fichier projet existant sous un nouveau nom.

  • Fichier->Imprimer (Ctrl+P) : Affiche le dialogue de mise en page pour définir la taille et les propriétés d'orientation de la page pour l'impression.

  • Fichier->Imprimer les résultats : Affiche le dialogue de mise en page pour définir la taille et les propriétés d'orientation de la page pour l'impression de la liste des résultats de l'onglet message actuel.

  • Fichier-> Propriétés : Affiche les propriétés du fichier comme le fichier schéma utilisé pour Tag-Insight, le fichier d'encodage et les propriétés d'indentation.

  • Fichier-> Fermer (Ctrl+W) : Ferme uniquement l'onglet sélectionné. Tous les autres onglets restent.

  • Fichier->Tout Fermer: Ferme tous les documents ouverts. Si un document est modifié ou n'a pas de fichier, une invitation à sauver, ne pas sauver, ou annuler l'opération est affiché.

  • Fichier->Réouvrir un projet : Affiche une liste des fichiers projet récemment ouverts. Sélectionner un fichier à ouvrir.

  • Fichier->Quitter x (Ctrl+Q) : Quite l'éditeur XML <oXygen/>. Les informations de session telles que le projet actuel, les documents ouverts et les réglages d'options sont rendues persistantes. Quand l'éditeur <oXygen/> est ré-ouvert, les informations persistantes retournent au dernier état sauvé.

Menu Édition

Tableau 3.2. Menu Édition Options

  • Édition->Annuler (Ctrl+Z) : Annule, dans une limite de 100, les actions d'édition pour retourner à l'état précédent. Des opérations complexes comme "Tout remplacer", "Indenter la sélection", etc sont maintenant traitées comme de simples événements annulables.

  • Édition->Rétablir (Ctrl+Shift+Z) : Recréé, dans la limite de 100, les actions d'édition qui ont été annulées par la fonction "Annuler".

  • Édition->Couper (Ctrl+X) : Enlève du document le nœud actuellement sélectionné et le place dans le presse-papiers.

  • Édition->Copier (Ctrl+C) : Place une copie de la sélection actuelle dans le presse-papiers.

  • Édition->Coller (Ctrl+V) : Place le contenu du presse-papier dans le document à la position du curseur.

  • Édition->Tout sélectionner (Ctrl+A) : Sélectionne l'ensemble du corps du document actuel, dont les espaces vierges précédant le premier et suivant le dernier caractère.

  • Édition->Vérifier l'orthographe (F4) : Vérifie l'orthographe dans votre document.

  • Édition->Signets : Placer des signets et accéder rapidement à des positions marquées dans les documents édités.

Menu Rechercher

Tableau 3.3. Options du menu Rechercher

  • Rechercher->Rechercher/Remplacer... (Ctrl+F) : Affiche le dialogue Rechercher/Remplacer, utilisé pour définir les opérations "rechercher" ou"rechercher et remplacer" sur le document actuel. L'opération de remplacement peut lier des variables de groupes regexp à la Perl 5 ($1, $2, etc.) depuis la recherche.

  • Rechercher->Rechercher/Remplacer dans les fichiers (Ctrl+F) : Affiche le dialogue Rechercher/Remplacer dans les fichiers, utilisé pour définir les opérations "rechercher" ou "rechercher et remplacer" sur un nombre de fichiers. L'opération de remplacement peut lier des variables de groupe regexp à la Perl 5 ($1, $2, etc.) depuis la recherche.

  • Rechercher->Aller à la ligne (Ctrl+L (Cmd+L sur Mac)) : Affiche la dialogue Aller à utiliser pour placer le curseur directement à une position précise dans le document actuel en spécifiant une ligne et une colonne ou par offset suivant le début du document.

  • Rechercher->Recherche encore (F3) : Exécute une autre recherche en utilisant la dernière configuration de recherche.

Menu Perspective

Tableau 3.4. Options du menu Perspective

  • Éditeur d'Arbre... (Ctrl+T) : cette option ouvre la fenêtre de l'éditeur d'arbre.

  • Debugger : Cette option ouvre la perspective du Debugger.

  • Editor : Cette option ouvre la perspective de l'Éditeur.

Menu Options

Tableau 3.5. Options du menu Options

  • Préférences : Comprend toutes les options de configuration nécessaires pour personnaliser <oXygen/> selon vos besoins et votre environnement réseau.

  • Vérifier les nouvelles versions : Force la fonction de vérification de version d'interroger le site web de <oXygen/> pour de nouvelles versions.

  • Restauration de la configuration par défaut: Annule tous les réglages personnalisés par l'utilisateur pour <oXygen/> et revient à l'installation par défaut.

  • Importer scénario de transformation : Charge un fichier de propriétés avec des scénarios.

  • Exporter scénario de transformation : Sauve tous les scénarios and un fichier séparé, un fichier de propriétés.

Menu Modules d'extension

Tableau 3.6. Options du menu Modules d'extension

Contient la liste de modules de type général détectés dans le sous-dossier des modules du dossier d'installation. S'il n'y a pas de module de type général configuré, le menu ne sera pas affiché.

Menu Outils

Tableau 3.7. Options menu Outils

  • Trang intégré... (Ctrl+Alt+T) : Convertit le document actuel vers un langage de grammaire supporté en utilisant le convertisseur Trang intégré.

  • Documentation de schéma... (Ctrl+Alt+S) : Un outil utilisé pour générer une documentation HTML d'un document schéma XML.

  • Visualisateur SVG : contient un visualisateur pour les fichiers Scalable Vector Graphics.

  • Analyseur WSDL SOAP : contient un analyseur et émetteur SOAP pour les fichiers Web Services Description Language.

  • Outils externes : Contient la liste des outils externes configurés dans l'option Préférences->Outils externes. S'il n'y a pas d'outils externes configurés le menu sera désactivé.

Menu Debugger

Tableau 3.8. Options menu Debugger

  • Debugger : Cette option ouvre la perspective du Debugger.

  • Actions du débogueur : les descriptions des actions du débogueur peuvent être trouvées dans la section Barre d'outils de contrôle.

Menu Document

Tableau 3.9.  Options du menu Document

  • Document+Fichier->Insérer un fichier... : Insère un fichier à la position actuel du curseur dans le document.

  • Document+Fichier->Ouvrir fichier au niveau du curseur : Ouvre dans un nouveau paneau le fichier avec le nom sous la position actuelle du curseur dans le document actuel.

  • Document+Fichier->Ouvrir dans une application système : Ouvre le fichier édité dans l'application y étant associé par défaut sur la machine.

  • Document+Trouver->Trouver tous: Trouvez toutes les occurrences de choix courant dans le document courant.

  • Document+Pliage->Basculer pliage: Basculer le pliage du document.

  • Document+Pliage->Réduire les pliages enfant (Ctrl+NumPad+-) : Plie les sections indentées à un niveau à l'intérieur de l'élément actuel.

  • Document+Pliage->Augmenter les pliages enfant (Ctrl+NumPad++) : Déplie les sections indentées à un niveau dans l'élément actuel.

  • Document+Pliage->Tout augmenter (Ctrl+NumPad+*) : Déplie toutes les sections à l'intérieur de l'élément actuel.

  • Document+XML Document->Valider le document (Ctrl+Shift+V) : Exécute l'opération de validation sur le document actuel en utilisant une moulinette de validation. Renvoie une liste-résultat des erreurs dans le panneau message. Le balisage du document est vérifié pour la conformité avec les règles de la DTD, du schéma XML ou du schéma Relax NG spécifié. Pour la validation par rapport à des schémas Relax NG le document XML doit inclure une instruction de traitement de la forme : <?oxygen RNGSchema="URL-du-schéma" type="xml (ou compact)">

  • Document+XML Document->Contrôler que le document est bien formé (Ctrl+Shift+W) : Exécute l'opération de vérification de la forme XML sur le document actuel en utilisant une moulinette non-validante. Retourne une liste-résultat des erreurs dans le panneau message.

  • Document+XML Document->Validation Externe : Affiche le dialogue de Validation externe, utilisé pour sélectionner les schémas externes (XML, Relax NG, NRL, schéma Schematron) et d'exécuter l'opération de validation sur le document actuel en utilisant les schémas sélectionnés. Retourne une liste d'erreurs dans le panneau des messages. Le balisage du document actuel est vérifié pour sa conformité avec les règles des schémas spécifiés.

  • Document->Appliquer le scénario de transformation (Ctrl+Shift+T) : Exécute le traitement de transformation en utilisant les propriétés de configuration définies dans le dialogue Configuration de transformation.

  • Document->Configurer un scénario de transformation (Ctrl+Shift+C) : Affiche le dialogue de Configuration de transformation, utilisé pour définir les propriétés pour la conversion de documents vers de multiples cibles de sortie. Permet aussi la sauvegarde de "Scénarios". Chaque scénario peut contenir une configuration unique prête à être utilisée dans le futur.

  • Document->Formater et indenter (Ctrl+Shift+P) : Aussi référencé comme "Pretty Print", "Formater et indenter" exécute des fonctions de mise en page pour rendre le formatage plus aisé à lire à l'écran et à l'impression.

  • Document+XML Document->Ouvrir schéma externe : Ouvre le schéma utilisé poru la validation du document actuel dans un nouvel éditeur.

  • Document+XML Document->Associer schéma... : Ouvre un dialogue pour sélectionner un schéma pour valider le document. Le schéma est d'un des types suivants : XML Schema, DTD, Relax NG, NRL, Schematron.

  • Document+XML Document->Convertir en... : Ouvre un dialogue pour convertir le document actuel vers différents formats de schémas en utilisant le convertisseur Trang.

  • Document+XML Document->Apprendre la structure (Ctrl+Shift+L) : Lit la structure de formatage du document actuel de telle façon qu'elle puisse être sauvée comme modèle en utilisant l'optionEnregistrer la structure.

  • Document+XML Document->Enregistrer la structure (Ctrl+Shift+S) : Affiche le dialogue Enregistrer la structure, utilisé pour nommer et créer des documents DTD appris par la fonction "Apprendre la structure".

  • Verrouiller/Déverrouiller les balises XML : Si en mode "Verrouiller" les balises ne peuvent être éditées. Déverrouiller permet l'édition des balises.

  • Document+XML Document->Indenter la sélection : Exécute les fonctions de mise en page sur la sélection actuelle pour rendre le balisage plus aisé à lire sur l'écran et à l'impression.

  • Document+XML Document->Sélection non-commentée : Retire les crochets de commentaire <!-- --> du commentaire actuellement sélectionné.

  • Document+XML Document->Commenter la sélection : Place des crochets de commentaire <!-- --> autour de la sélection actuelle ou à la position du curseur.

  • Document+XML Document->Aller à la balise correspondante (Ctrl+Shift+G) : Déplace le curseur jusqu'à la balise de fermeture qui correspond à celle d'ouverture, ou vice versa.

  • Document+XML Refactoring->Entourer dans <balise> (Ctrl+/): Le texte sélectionné dans l'éditeur est marqué avec les balises d'ouverture et de fermeture de la dernière action 'Entourer'.

  • Document+XML Refactoring->Entourer dans balise... (Ctrl+E): Le texte sélectionné dans l'éditeur est entouré par une balise d'ouverture et une balise de fermeture.

  • Document+XML Refactoring->Sélection d'échappement : Remplace les symboles <, >, &,", ' par &lt;, &gt;, &amp;, &quot;, &apos;.

  • Document+XML Refactoring->Renommer élément : l'élément à la position du curseur et les élément ayant le même nom peuvent être renommés suivant les options dans le dialogue Renommer.

  • Document+XML Refactoring->Diviser élément (Ctrl+Alt+D) : divise l'élément à la position du curseur en deux éléments identiques. Le curseur doit se trouver dans l'élément.

  • Document+XML Refactoring->Joindre les éléments (Ctrl+Alt+J) : joint les éléments à gauche et à droite du curseur. Les éléments doivent avoir les mêmes nom, attributs et valeurs d'attribut.

  • Document+XML Refactoring->Effacer les balises des éléments (Ctrl+Alt+X) : Efface les balises de l'élément qui inclut la sélection actuelle dans le document.

  • Document+XML Refactoring->Importer la liste des entités (Ctrl+Alt+X) : Sélectionne une liste de fichiers et les importe comme entités externes.

Menu Fenêtre

Tableau 3.10. Options du menu Fenêtre

  • Fenêtre-> Suivante : Active les fenêtres de gauche à droite dans la liste des documents ouverts dans l'éditeur.

  • Fenêtre-> Précédente : Active les fenêtre de droite à gauche dans la liste des documents ouverts dans l'éditeur.

  • Liste de fichiers ouverts : Affiche une liste des documents actuellement ouverts dans le panneau de l'éditeur.

Menu Aide

Tableau 3.11. Options du menu Aide

  • Aide->Aide (F1) : Ouvre le système d'aide en ligne de l'éditeur XML <oXygen/>.

  • Aide->Aller sur le site d'<oXygen/> : affiche la page d'accueil de <oXygen/> en utilisant le navigateur par défaut. Le e-Store de <oXygen/> donne des informations sur les prix des licences et permet de payer en ligne de façon sécurisée.

  • Aide->Enregistrer : permet à l'utilisateur d'entrer le texte de la licence du courrier d'enregistrement.

  • Conseil du jour : Sélectionne au hasard un conseil de productivité de <oXygen/> et l'affiche dans le dialogue Conseil du jour.

  • Aide->À propos de: Affiche le dialogue À propos, qui donne des informations sur le numéro de version de <oXygen/> et le statut de la licence.

Barre d'outils principale

La barre d'outils principale, située sous le menu principal, offre un accès aisé aux fonctions communes et fréquemment utilisées. Chaque icône est un bouton qui agit comme un raccourci vers une fonction liée. Gardez le pointeur sur l'icône pour afficher une aide contextuelle qui vous résumera sa fonction. Cliquez sur une icône pour utiliser sa fonction.

Figure 3.25. Les boutons de la barre d'outils principale

Les boutons de la barre d'outils principale

Tableau 3.12. Description des boutons de la barre d'outils principale

Fichier-> Nouveau (Ctrl+N) : Affiche le dialogue Nouveau depuis lequel on peut sélectionner le type de document.

Fichier-> Ouvrir (Ctrl+O) : Affiche le dialogue Ouvrir utilisé pour chercher, sélectionner et ouvrir un ou plusieurs fichiers.

Fichier-> Ouvrir URL (Ctrl+U) : Affiche le dialogue Ouvrir URL utilisé pour chercher, sélectionner et ouvrir un ou plusieurs fichiers en utilisant FTP/WebDAV.

Fichier-> Enregistrer (Ctrl+S) : Sauve le document actuel. Si le document n'a pas de fichier, affiche le dialogue "Enregister sous".

Fichier->Enregistrer vers une URL : Affiche le dialogue Enregistrer URL, utilisé pour nommer et sauver un document ouvert dans un fichier ; ou sauver un fichier existant sous un nouveau nom en utilisant FTP/WebDAV.

Fichier->À partir d'un modèle : Affiche le dialogue Modèles utilisé pour chercher, sélectionner et ouvrir un nouveau document basé sur un modèle existant. Les documents modèles fonctionnent comme des points de départ qui ont des propriétés prédéfinies telles que le type de fichier, prolog, l'élément root, les conteneurs et un contenu existant.

Fichier->Ajouter aux modèles :Affiche le dialogue Ajouter aux modèles utilisé pour définir le nom par lequel le modèle sera reconnu dans l'option "À partir d'un modèle".

Édition->Annuler (Ctrl+Z) : Inverse, dans la limite d'un maximum de 100, les actions d'édition pour revenir à l'état précédent. Des opérations complexes comme "Tout remplacer", "Indenter la sélection", etc sont maintenant traitées comme de simples événéments annulables.

Édition->Rétablir (Ctrl+Shift+Z) : Recrée, dans la limite d'un maximum de 100, les actions d'édition qui ont été inversées par la fonction "Annuler".

Édition->Couper (Ctrl+X) : Retire la sélection actuelle depuis le document et la place dans le presse-papier.

Édition->Copier (Ctrl+C) : Place une copie de la sélection actuelle dans le presse-papier.

Édition->Coller (Ctrl+V) : Place le contenu du presse-papier dans le document à la position du curseur.

Édition->Vérifier l'orthographe (F4) : Vérifie l'orthographe du document.

Édition->Signets (F7) -> Création rapide : Place un signet à la position actuelle du curseur.

Recherche->Rechercher/Remplacer (Ctrl+F) : Affiche le dialogue Rechercher/Remplacer, utiliser pour définir les opérations "rechercher" ou "rechercher et remplacer" sur le document.

Recherche-> Rechercher Remplacer dans les fichiers : Affiche le dialogue Rechercher/Remplacer dans les fichiers, utilisé pour définir les opérations "chercher" ou "chercher et remplacer" parmi un nombre de fichiers.

Perspective->Éditeur d'Arbre... (Ctrl+T) : Affiche la fenêtre de l'éditeur d'arbre.

Perspective->Debugger : Ouvre la perspective du debugger.

Perspective->Éditeur : Ouvre la perspective de l'éditeur.

Ajusteur du contraste de la transparence->Transparence : Ajuste le contraste de balisage dans la perspective Éditeur.

Panneau Projet

Le panneau projet, situé sur la partie gauche de la fenêtre principale, permet la définition de projets et la gestion logique des documents qu'il contient.

Les fichiers du projet entier ou d'un dossier d'un projet peuvent être validés avec un simple clic sur un bouton vis-à-vis d'un schéma de type Schematron, XML Schema, Relax NG, NRL, ou une combinaison de ce dernier avec Schematron. Ceci avec le support du dossier logique du projet vous permet de grouper vos fichiers et de les valider très facilement.

Si un dossier d'un projet contient de nombreux documents, un certain document peut être rapidement trouvé dans l'arbre du projet si l'utilisateur sélectionne avec la souris le dossier contenant le fichier désiré (ou un autre document de ce dossier) et tape les premiers caractères du nom du document. Le document désiré sera automatiquement sélectionné dès que les caractères tapés identifieront son nom dans le dossier. Une fois sélectionné, le document peut être ouvert en pressant la touche ENTRÉE ou en double-cliquant dessus ou il peut être effacé en pressant la touche SUPPR ou en choisissant "Enlever fichier" depuis le menu contextuel.

Tableau 3.13. Description du panneau projet

Le panneau projet comprend :

La barre d'outils projet

La barre d'outils projet, située en haut du panneau projet, offre un accès facile aux fonctions projet de <oXygen/>. Chaque icône est un bouton qui agit comme un raccourci vers une fonction liée. Gardez le pointeur sur un icône pour afficher une aide contextuelle qui vous expliquera sa fonction. Cliquer sur un icône pour utiliser sa fonction.

Figure 3.26. La barre d'outils projet

La barre d'outils projet

Tableau 3.14. Description des boutons de la barre d'outils projet

Fichier->Nouveau projet :Crée un nouveau projet dans le panneau projet.

Fichier->Ouvrir le projet (Ctrl+F2) : Affiche le dialogue Ouvrir le projet utilisé pour chercher, sélectionner et ouvrir un fichier projet.

Fichier->Enregistrer le projet (Ctrl+F3) : Sauve le projet actuel. Si le projet n'a pas de fichier, alors le dialogue "Enregistrer le projet sous" est affiché.

Tout valider: Valide tous les fichiers du projet.

Option Montrer/Masquer chemin : Active ou désactive le chemin du fichier pour tous les fichiers affichés dans la vue du projet.

Nouveau dossier : Affiche le dialogue Nouveau dossier, utilisé pour spécifier le nom d'un dossier sur le point d'être créé sous le projet ou dossier existant et sélectionné dans la vue du projet.

Ajouter le fichier édité : inclut le document actuel dans le dossier sélectionné dans la vue du projet.

Vue du projet

La vue du projet offre une méthode pour la gestion et la visualisation logique des fichiers associés à un projet. Une fois qu'un projet est ouvert, les fichier sauvés peuvent être ajoutés, ou retirés, du projet. Soit lorsqu'il est ouvert dans le panneau éditeur soit directement depuis un système de fichier local ou distant.

Tableau 3.15. Description de la vue du projet

Pour faciliter l'organisation des fichiers, des dossier virtuels peuvent être créés. Les dossiers virtuels n'existent que dans le fichier projet, offrant une méthode logique pour l'organisation visuelle. En plus de la création interne de dossiers virtuels, vous pouvez aussi importer des dossiers systèmes et leur contenu depuis des systèmes de fichier locaux ou distants. Le résultat est une vue en arbre qui facilite la navigation et la gestion des fichiers à l'intérieur du projet, indépendamment de l'emplacement physique des fichiers.

Tous les dossiers, créés en interne ou importés, n'ont pas de connexion physique avec un système de fichier local ou distant. C.-à-d. si vous ajoutez, effacez ou renommez un dossier projet, ces opérations ne sont exécutées que dans le fichier projet de <oXygen/>. Le même principe s'applique aux fichiers, à l'exception que la représentation d'un fichier dans la vue du projet maintient un lien vers le fichier physique. C.-à-d. que des actions telles que "Enlever", ne retire le fichier que du fichier projet actuel, cela n'efface pas le fichier du système de fichiers. Double-cliquer sur un fichier est équivalent à Fichier-> Ouvrir (Ctrl+O) .

Le chemin complet du fichier est caché par défaut. Cliquer sur le bouton Afficher/Masquer chemin pour afficher ou non le chemin.

La cible par défaut lors de l'ajout de fichiers à un projet est la racine du projet. Sélectionner un dossier change la cible au dossier sélectionné. Les fichiers peuvent avoir plusieurs exemplaires dans le dossier système mais ne peuvent apparaître deux fois dans le même dossier.

Un clic-droit sur n'importe quel objet dans la vue en arbre affiche le menu projet avec les fonctions qui peuvent être exécutées sur cet objet, ou depuis l'objet sélectionné. Les options disponibles depuis le menu projet sont spécifiques au type d'objet sélectionné dans la vue en arbre.

Le menu projet contient une liste de toutes les actions qui est dépendant de l'objet sélectionné. La description de toutes les actions disponibles suit :

Tableau 3.16. Description du menu projet

  • Nouveau dossier : Affiche le dialogue Nouveau dossier, utilisé pour spécifier le nom d'un dossier à créer sous le projet ou dossier existant et sélectionné dans la vue du projet.

  • Ouvrir : Ouvre le fichier sélectionné.

  • Ouvrir dans une application système : Ouvre le fichier sélectionné dans l'application y étant associé par le système.

  • Copier emplacement : Copie l'emplacement du fichier sélectionné comme URL.

  • Enlever : Enlève le fichier sélectionné de la vue du projet.

  • Rechercher/Remplacer dans les fichiers: Recherche une chaîne dans les fichiers sélectionnés du projet ou dans le projet entier.

  • Ouvrir avec->Visualisateur SVG : Ouvre le document sélectionné avec le visualisateur SVG.

  • Ouvrir avec->Documentation schéma : Ouvre le document sélectionné dans le dialogue de documentation schéma.

  • Ouvrir avec->Convertisseur Trang : Ouvre le document sélectionné dans le dialogue du convertisseur Trang.

  • Ouvrir avec->Analyseur WSDL SOAP : Ouvre le document sélectionné dans le dialogue de l'analyseur WSDL SOAP.

  • Valider la sélection : Valide le fichier sélectionné ou tous les fichiers du dossier sélectionné.

  • Valider la sélection avec... : valide le fichier sélectionné ou tous les fichiers du dossier sélectionné avec un schéma spécifique.

Panneau Vue du modèle

Le panneau Vue du modèle, situé sur la partie gauche de la fenêtre principale, facilite l'effort d'édition en présentant la structure de la balise actuellement éditée ainsi que la documentation additionnelle de la balise.

La vue du modèle, combinée au Sommaire puissant, est un outil qui offre à l'utilisateur des informations sur l'espace document édité.

Tableau 3.17. Description du panneau Vue du modèle

Le panneau Vue du modèle comprend :

La vue de la structure de l'élément.

La vue de la structure de l'élément affiche la structure de la balise éditée ou sélectionné dans le format d'un arbre.

Tableau 3.18. Description de la vue de la structure de l'élément

Les informations incluent le nom, le modèle et les attributs que la balise actuellement éditée peut avoir. Les attributs autorisés sont affichés avec les restrictions qu'ils peuvent avoir.

La vue annotation.

La vue annotation affiche les annotations qui sont présentes dans le schéma utilisé pour la balise actuellement éditée ou sélectionnée.

Tableau 3.19. Description de la vue annotation

Cette information peut être très utile aux personnes apprenant le XML car elle a très peu de définitions disponibles pour chaque balise utilisée.

Panneau éditeur

Le panneau éditeur est où vous passez la majeure partie de votre temps à lire, éditer, appliquer des balises et vérifier la validité et la forme de vos documents.

Le panneau éditeur est composé de :

Onglets de document de l'éditeur

L'éditeur <oXygen/> utilise le mode page en onglets pour afficher les documents ouverts. L'onglet du document se trouve au-dessous de la barre d'outils de l'éditeur et montre le type de fichier, le nom du fichier ainsi que son statut d'édition.

Figure 3.27. Les onglets de document de l'éditeur

Les onglets de document de l'éditeur

Les fichiers modifiés sont signalés par un "*", sauver le document retire ce statut jusqu'à la prochaine opération d'édition.

Chaque document ouvert a un onglet associé affichant cette information. Pour distinguer quel document est actuellement édité, le document actif est surligné et mis en avant plan. Les onglets des documents inactifs sont ombrés et dans le fond. Sélectionner un onglet change le focus du document pour afficher son contenu pour l'édition. Laisser le pointeur en état stationnaire au-dessus d'un onglet permet d'afficher le chemin complet du fichier dans une bulle.

Utilisez le clic-droit sur n'importe quel onglet pour afficher le menu Onglet document.

Menu de l'onglet du document

  • Fermer : Ferme uniquement l'onglet sélectionné. Tous les autres onglets restent.

  • Fermer les autres fichiers : Ferme tous les fichiers en dehors de l'onglet sélectionné.

  • Tout Fermer : Ferme tous les documents ouverts. Si un document est modifié ou n'a pas de fichier, une invitation à sauver, ne pas sauver, ou annuler l'opération de sauvegarde est affiché.

  • Ajouter fichier : Ajoute le document actuel dans le dossier sélectionné dans la vue du projet.

  • Tout ajouter au projet : inclut tous les document ouverts dans le dossier sélectionné dans la vue du projet.

Types de fichier du document

Le type de fichier est signalé par un icône précédent le nom du fichier. Même si cette information peut être obtenue avec l'extension du fichier, l'identification visuelle des types de style est amélioré en utilisant une légende en couleur qui correspond aux icône de l'Aperçu de projet:

ROUGE

Documents XML

BLEU CLAIR

Documents DTD

VIOLET FONCÉ

Documents XSD

VIOLET

Schéma Relax NG - XML

JAUNE

Schéma Relax NG - Compact

JAUNE

Schéma NRL

VERT

Documents XSL

MARRON

Documents WSDL

ROUGE

Documents XQuery

CYAN

Documents Schematron Schema

BLANC

Documents TXT

Barre d'outils de l'éditeur

La barre d'outils de l'éditeur, se trouvant en-dessous des onglets document, offre un accès aisé aux fonctions d'édition de <oXygen/>. Chaque icône est un bouton qui agit comme un raccourci pour une fonction. Laissez votre pointeur-curseur au-dessus d'un icône pour voir apparaître une bulle décrivant la fonction de l'icône. Cliquez sur l'icône pour utiliser sa fonction.

Figure 3.28. Les boutons de la barre d'outils de l'éditeur

Les boutons de la barre d'outils de l'éditeur

Tableau 3.20. Description des boutons de la barre d'outils de l'éditeur

Document+XML Document->Valider le document (Ctrl+Shift+V) : Exécute l'opération de validation du document courant en utilisant une moulinette de validation. Retourne une liste-résultat d'erreurs dans le panneau Message. La structure du document courant est vérifiée pour sa conformité avec les règles de la DTD ou du schéma XML spécifié.

Document+XML Document->Contrôler que le document est bien formé (Ctrl+Shift+W) : Exécute l'opération de vérification de la forme du XML sur le document actuel en utilisant une moulinette non-validante. Retourne une liste-résultat d'erreurs dans le panneau Message.

Document+XML Document->Validation Externe : Affiche le dialogue de validation externe utilisé pour sélectionné un schéma de type XML Schema, Relax NG, NRL ou Schematron pour exécuter l'opération de validation sur le document actuel. Le fichier Relax NG schema peut être soit en syntaxe XML soit en syntaxe compacte. Dans le cas d'erreurs la validation retourne une liste d'erreurs dans le panneau des messages.

Document+XML Document->Appliquer le scénario de transformation (Ctrl+Shift+T) : Exécute le processus de transformation en utilisant les propriétés de configuration définies dans le dialogue Configurer la transformation.

Document+XML Document->Configurer un scénario de transformation (Ctrl+Shift+C) : Affiche le dialogue Configurer la transformation, utilisé pour définir les propriétés pour la conversion de documents vers de multiples cibles de sortie. Permet aussi la sauvegarde de "Scénario's". Chaque scénario peut emmagasiner une configuration unique prête à être utilisée dans le futur.

Document+XML Document->Scénario de débogage : Vous pouvez lancer le débogage et le fichier d'entrée, le processeur et les paramètres depuis le scénario de transformation XSLT qui est associé au fichier actuellement édité.

Document+XML Document->Indenter le document (Ctrl+Shift+P) : Aussi nommé "Impression intelligente", "Indenter le document" met en page le document afin de rendre la structure plus aisée à lire sur l'écran et sur sortie papier.

Document+XML Document->Ouvrir le schéma externe : Ouvrir le schéma utilisé pour valider le document courant.

Document+XML Document->Associer Schéma ... : Associe un schéma au document actuel.

Document+XML Document->Convertir vers ... : Convertit le document actuel vers un langage de grammaire supporté en utilisant le convertisseur Trang intégré.

Document+XML Document->Apprendre la structure du document (Ctrl+Shift+L) : Lit la structure du document actuel afin qu'elle puisse être sauvée comme modèle en utilisant l'option Sauver la structure.

Document+XML Document->Enregistrer la structure (Ctrl+Shift+S) : enregistre la structure de document apprise dans un fichier DTD externe.

Permettre ou non la modification des balises XML : Quand on est en mode "Bloqué" les balises ne peuvent être éditées. Débloquer permet l'édition des balises.

XPath : Exécute une expression XPath, utilisée pour sélectionner des éléments spécifiés à l'intérieur du document actuel. <oXygen/> peut exécuter des expressions conformément à la version 1.0 ou 2.0 de XPath.

L'espace d'édition

L'éditeur <oXygen/> offre un ensemble utile de fonctions qui permettent une édition aisée de documents structurés. Des fonctions telles que la colorisation automatique de syntaxe et la vérification, le Tag-insight intelligent, auto-remplissage des balises de fin aident à améliorer la productivité et réduire les erreurs. Les attributs de texte tels que la police, le formatage, couplés avec des options de colorisation personnalisées pour la colorisation de syntaxe en font un éditeur flexible et puissant pour l'édition de documents structurés.

En plaçant le pointeur de la souris sur un élément ou un attribut alors un aide contenant la documentation définie dans le schéma XML ou la DTD est affichée.

Un clic-droit n'importe où dans l'éditeur affiche un menu avec les options liées à l'édition et aux opérations de balisage.

Tableau 3.21. Description du menu de l'espace d'édition

  • Édition->Couper (Ctrl+X): Enlève la sélection actuelle du document et la place dans le presse-papiers.

  • Édition->Copier (Ctrl+C): Place une copie de la sélection actuelle dans le presse-papiers.

  • Édition->Copier (Ctrl+V) : Place le contenu actuel du presse-papiers dans le document à la position du curseur.

  • Fichier-> Enregistrer (Ctrl+S) : Sauve le document actuel. Si le document n'a pas de fichier, affiche le dialogue "Enregistrer sous...".

  • Fichier-> Fermer (Ctrl+W) : Ferme uniquement l'onglet sélectionné. Tous les autres onglets restent.

  • Document->Ouvrir fichier au niveau du curseur : Ouvre dans un nouveau paneau le fichier avec le nom sous la position actuelle du curseur dans le document actuel.

  • Document->Tout trouver (Ctrl+Shift+F) : Trouve toutes les occurences d'un mot sélectionné dans le fichier actuel.

  • Document->Aller à la balise correspondante (Ctrl+Shift+G) : Déplace le curseur jusqu'à la balise de fermeture qui correspond à la balise d'ouverture, ou vice versa.

  • Entourer par : Affiche un sous-menu avec des éléments de formatage rangés par ordre alphabétique. Le texte sélectionné dans l'éditeur est marqué avec les balises de début et de fin de l'élément sélectionné.

  • Document->Entourer dans <balise> (Ctrl+/): Le texte sélectionné dans l'éditeur est marqué avec les balises d'ouverture et de fermeture de la dernière action 'Entourer'.

  • Document->Entourer dans balise... (Ctrl+E) : Le texte sélectionné dans l'éditeur est entouré des balises d'ouverture et de fermeture spécifiées.

  • Plug-ins : Affiche un sous-menu avec la liste de la sélection type de plug-ins qui peuvent être lancés dans le contexte du document actuellement édité.

  • Document->Commenter la sélection : Place des crochets de commentaire <!-- --> autour de la sélection actuelle ou à la position du curseur.

  • Document->Sélection non-commentée : Retire les crochets de commentaire <!-- --> autour du commentaire actuellement sélectionné.

  • Document->Sélection d'échappement : Remplace les symboles <, >, &,", ' par &lt;, &gt;, &amp;, &quot;, &apos;.

  • Document->Indenter la sélection : Exécute les fonctions de mise en page sur la sélection actuelle pour rendre le balisage plus lisible sur l'écran et à l'impression.

  • Document->Renommer élément : l'élément à la position du curseur et les éléments qui ont le même nom que l'élément actuel peuvent être renommés suivant les options du dialogue Renommer.

  • Document->Diviser élément (Ctrl+Alt+D) : diviser l'élément à la position du curseur en deux éléments identiques. Le curseur doit être dans l'élément.

  • Document->Joindre les éléments (Ctrl+Alt+J) : joint les éléments à gauche et à droite du curseur. Les éléments doivent avoir les mêmes nom, attributs et valeurs d'attribut.

La barre de statut de l'éditeur

La barre de statut de l'éditeur, se trouvant sous l'espace d'édition, offre des informations sur le document actuel :

Figure 3.29. La barre de statut de l'éditeur

La barre de statut de l'éditeur
La case chemin du document

Affiche le chemin complet du document actuel.

Le panneau Message

Affiche le statut des opérations Validater le XML, Vérifier la forme XML , Appliquer la transformation, évaluation de l'expression XPath et indenter le document et le résultat (succès ou non) et le nombre d'erreurs trouvées lors de la dernière opération.

Le panneau coordonnées du curseur

Affiche la position actuelle du curseur en termes de numéro de ligne : numéro d'espace.

Le panneau statut de l'édition

Indique si le document a été modifié ou non depuis la dernière sauvegarde.

Panneau message

Le panneau message, situé dans la moitié basse de la fenêtre principalen, affiche les messages renvoyés par les opérations suivantes :

Figure 3.30. Le panneau message

Le panneau message

Pour distinguer les types de résultats, chaque liste de résultat de fonctions est affichée dans un onglet séparé à l'intérieur du panneau.

Pour changer de liste de résultat, sélectionner simplement l'onglet requis. Pour fermer un onglet, ou tous les onglets, faire un clic-droit sur l'onglet pour afficher un menu et sélectionner une option. Pour trier les valeurs des colonnes, cliquez sur le titre de la colonne. Le premier clic va trier la table de façon croissante, le second clic va la trier de façon décroissante et le troisième clic va retourner à l'état non-trié.

Tableau 3.22. Menu onglet du panneau message

  • Fermer l'onglet des résultats : Ferme l'onglet des résultats sélectionné.

  • Fermer les autres onglets : Ferme les autres onglets sauf l'onglet sélectionné.

  • Fermer tous les onglets : Ferme tous les onglets ouverts dans le panneau.

Dans tous les cas, chaque enregistrement dans une liste de résultats est lié à l'emplacement du document où l'erreur ou la chaîne de caractères indiquée se trouve. Sélectionner un enregistrement d'une liste de résultats déplace le curseur de l'éditeur vers l'object en question et le surligne. Si le document cible est fermé, il sera ouvert dans le panneau de l'éditeur.

En plus de cette fonctionnalité épargnant du temps, le menu du panneau message permet d'exécuter de nombreuses opérations sur un seul ou plusieurs enregistrements sélectionnés. Le menu du panneau message est affiché en sélectionnant un enregistrement, puis clic-droit.

Tableau 3.23. Le menu du panneau message

  • Édition->Copier (Ctrl+C) : Place une copie de la sélection actuelle dans le presse-papier.

  • Édition->Tout sélectionner (Ctrl+A) : Sélectionne le corps entier du document, dont l'espace vierge précédant le premier caractère et suivant le dernier caractère.

  • Fichier->Imprimer (Ctrl+P) : Affiche le dialogue de mise en page utilisé pour définir la taille de la page et les propriétés d'orientation pour l'impression.

  • Fichier->Enregistrer les résultats (Ctrl+R) : Affiche le dialogue Enregistrer les résultats, utilisé pour sauver la liste de résultats de l'onglet message actuellement actif.

  • Fermer l'onglet des résultats : Ferme l'onglet des résultats sélectionné.

  • Fermer les autres onglets : ferme tous les autres onglets de résultats.

  • Fermer tous les onglets : Ferme tous les onglets ouverts dans le panneau.

Valider et Vérifier les erreurs parser du XML

Les fonctions "Valider le document " et "Vérifier la forme de document " utilisent le même onglet nommé "erreurs" pour afficher leurs résultats. Comme les deux fonctions utilisent le même onglet, les listes de résultats "Valider le XML " et "Vérifier la forme XML " se réécrivent l'une au-dessus de l'autre. Chaque fois qu'une de ces fonctions est exécutée, la liste de résultats contient de nouveaux résultats.

Messages XPath

Lors du travail avec les expressions XPath, <oXygen/> sort les erreurs et les résultats de nœud au panneau message.

Messages de transformation de la sortie

Durant les procédures de transformation, XML, XHTML ou FOP, le panneau message est utilisé pour afficher, les erreurs parser, les messages d'alerte et les sorties XML ou XHTML. Chacun est affiché dans un onglet séparé. Les onglets pour XML /XHTML sont pour chaque document, les onglets d'erreurs et d'alertes sont simplement rafraîchis.

Résultats Rechercher/Remplacer

La fonction "Rechercher/Remplacer" ouvre un nouvel onglet pour chaque document sur lequel cette fonction est employée. Chaque onglet est nommé "Rechercher tous les résultats - <filename.ext>". À chaque fois que la fonction est exécutée la liste de résultats dans l'onglet associé aux documents contient les nouveaux résultats.

Messages Rechercher Remplacer dans les fichiers

La fonction "Rechercher/Remplacer dans les fichiers" utilise un seul onglet nommé "Rechercher_dans_fichiers" pour afficher les résultats. Elle ne partage pas les onglets avec aucune autre fonction, rafraîchissant l'onglet à chaque fois que la fonction est exécutée.

Panneau Contour

Le panneau Contour, situé dans la partie inférieure gauche de la fenêtre principale possède les fonctions suivantes :

Figure 3.31. Le panneau Contour

Le panneau Contour

Vue d'ensemble du document

Le Contour affiche une vue d'ensemble des balises du document XML actuellement édité. Il affiche aussi les dépendances hiérarchiques entre les éléments de balises, rendant plus facile pour l'utilisation la compréhension de la structure du document et de la façon dont les balises sont emboîtées.

Suivi de modification

Lors de l'édition, le Contour suit dynamiquement les modifications introduites par l'utilisateur, affichant au milieu du panneau le nœud actuellement modifié. Ceci donne à l'utilisateur une meilleure idée d'où il se trouve dans le document et comment la structure du document est affectée par ses modifications.

Changement de la structure du document

Des éléments XML entiers peuvent être déplacés ou copiés dans le document édité en utilisant uniquement la souris dans le panneau Sommaire car ce dernier supporte le Glisser et Déposer. Si vous glissez un élément XML dans le panneau Sommaire et le déposez sur un autre élément dans le même panneau, alors l'élément glissé sera déplacé après l'élément cible. Si vous gardez le pointeur de la souris sur la cible pour un petit moment afant de déposer, alors l'élément cible sera d'abord augmenté et l'élément glissé sera placé à l'intérieur de la cible après sa balise d'ouverture. Si vous gardez appuyé la touche CTRL alors une opération de copie aura lieu à la place d'un déplacement.

Sélection de balise du document

Le Contour peut aussi être utilisé pour chercher l'emplacement spécifique d'une balise et du contenu dans le document édité. Intuitivement, en sélectionnant avec le bouton gauche de la souris la balise désirée dans le panneau Contour, le document défile à la position de la balise sélectionnée. De plus, le contenu de la balise est sélectionné dans le document, rendant facile de trouver la partie du document contenue par cette balise spécifique et, de plus, de copier et coller le contenu de la balise dans d'autres parties du document ou dans d'autres documents.