<oXygen/> 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.22. 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. En utilisant cette méthode vous pouvez optimiser le bureau suivant vos besoins d'espace de travail.

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-> 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.

  • É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+G (Cmd+L sur Mac)) : Affiche le dialogue Aller à la ligne utilisé pour déplacer directement le curseur au numéro de ligne spécifié.

  • 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.

  • Intégrer dans le shell de l'explorateur : Disponible uniquement pour Windows, permet l'association MIME de types de fichier avec l'éditeur XML oXygen.

  • 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.

  • 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 Document

Tableau 3.8.  Options du menu Document

  • Document->Valider le XML (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->Vérifier la forme XML (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->Validation Relax NG : Affiche le dialogue Validation RELAX NG, utilisé pour sélectionner le schéma Relax NG et pour exécuter l'opération de validation sur le document actuel en utilisant le schéma Relax NG sélectionné. Retourne une liste-résultat des erreurs dans le panneau Message. Le balisage du document est vérifié pour la conformité avec les règles du schéma RNG spécifié.

  • Document->Appliquer la 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->Configuration 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->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->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->Insérer un fichier... : Insère un fichier à la position actuel du curseur dans le document.

  • 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->Entourer dans <balise> (Ctrl+Slash): 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'édtieur est entouré par une balise d'ouverture et une balise de fermeture.

  • 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 aisé à lire sur l'écran et à l'impression.

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

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

  • 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.

Menu Fenêtre

Tableau 3.9. 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.10. Options du menu Aide

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

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

  • Acheter maintenant : Affiche la page du magasin en ligne de oXygen en utilisant le navigateur par défaut. Le e-magasin oXygen donne des informations sur les coûts de licence et offre des transactions en ligne sécurisées.

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

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.23. Les boutons de la barre d'outils principale

Les boutons de la barre d'outils principale

Tableau 3.11. 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".

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.

À 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.

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.

É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.

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.

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.

L'arbre des documents affiché dans ce panneau supporte la validation par batch : un ou plusieurs fichiers dans le projet actuel peuvent être validés en une fois en sélectionnant l'option "Valider sélection" dans le menu contextuel de l'arbre, et tous les fichiers projet peuvent être validés en un seul clic sur le bouton "Valider tous les fichiers" de la barre d'outils.

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.12. 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.24. La barre d'outils projet

La barre d'outils projet

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

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é.

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.

Effacer dossier: Retire le contenu du dossier sélectionné de 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.14. 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.15. 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.

  • Renommer dossier : Permet la modification du nom du dossier projet sélectionné.

  • Effacer dossier : Retire le contenu du dossier sélectionné de la vue du projet.

  • Ajouter fichiers : Affiche le dialogue Ajouter fichiers, utilisé pour chercher et sélectionner les fichiers à inclure dans la vue du projet.

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

  • Importer dossier : Affiche un dialogue Importer dossier, utilisé pour ajouter des dossiers et leur contenu à la vue du projet.

  • Importation de dossiers distants Importer dossiers distants : l'utilisateur peut choisir d'importer un dossier qui existe sur un serveur WebDAV ou FTP. Le projet aura une structure logique semblable au contenu du dossier distant. Les fichiers de tous les sous-dossiers distants sont ajoutés dans les dossiers logiques correspondants.

  • Lien vers un dossier externe : L'utilisateur peut créer des dossiers de lien dans l'arbre du projet. Un dossier de lien a une correspondance dans le système de fichiers. Le projet va présenter la structure de ce dossier comme il existe sur le disque.

  • Rafraîchir : Utilisez cette option pour rafraîchir le contenu des dossiers qui sont les fils d'un lien vers un dossier externe.

  • Ouvrir tous les fichiers : Ouvre tous les fichiers associés au projet actuel. Si le fichier apparaît deux fois, seul le premier exemplaire est ouvert.

  • Ouvrir : Ouvre le fichier sélectionné.

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

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

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

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.16. 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.17. 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.18. 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 :

Figure 3.25. Le panneau de l'éditeur

Le panneau de l'éditeur

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.26. 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.

  • 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é.

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

VIOLET FONCÉ

Documents DTD

VIOLET CLAIR

Documents XSD

VERT

Documents XSL

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.27. Les boutons de la barre d'outils de l'éditeur

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

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

XML->Valider le XML (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é.

XML->Vérifie la forme du XML (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.

XML->Validation Relax NG : Affiche le dialogue Validation Relax NG, utilisé pour sélectionner le schéma Relax NG et exécuter la validation sur le document actuel. Le fichier schéma peut être soit en syntaxe XML Relax NG, ou en syntaxe compacte Relax NG. En cas d'erreurs la validation retourne une liste-résultat des erreurs dans le panneau Message.

XML->Validation NRL : Affiche le dialogue Validation NRL, utilisé pour sélectionner le schéma NRL (Namespace Routing Language) et pour exécuter l'opération de validation sur le document actuel. En cas d'erreur, la validation renvoie une liste-résultat d'erreurs dans le panneau Message.

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

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

XML->Appliquer la 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.

XML->Configurer la 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.

XML->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.

XML->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.

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.

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.

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.20. 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+Slash): 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.

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.28. 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.29. 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.

Tableau 3.21. 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.22. 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 tous les onglets : Ferme tous les onglets ouverts dans le panneau.

Valider et Vérifier les erreurs parser du XML

Les fonctions "Valider le XML " et "Vérifier la forme XML " 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.30. 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.

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.