<oXygen/> User Guide |
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 :
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.
Le menu principal, situé sous la barre de titre du programme, offre un accès à toutes les fonctions disponibles de oXygen.
![]() | 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
![]() |
|
Tableau 3.2. Menu Options
![]() |
|
Tableau 3.3. Options du menu
![]() |
|
Tableau 3.5. Options du menu
![]() |
|
Tableau 3.7. Options menu
![]() |
|
Tableau 3.8. Options du menu
![]() |
|
Tableau 3.9. Options du menu
![]() |
|
Tableau 3.10. Options du menu
![]() |
|
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.
Tableau 3.11. Description des boutons de la barre d'outils principale
![]() | Ctrl+N) : Affiche le dialogue Nouveau depuis lequel on peut sélectionner le type de document. -> ( |
![]() | Ctrl+O) : Affiche le dialogue Ouvrir utilisé pour chercher, sélectionner et ouvrir un ou plusieurs fichiers. -> ( |
![]() | Ctrl+U) : Affiche le dialogue Ouvrir URL utilisé pour chercher, sélectionner et ouvrir un ou plusieurs fichiers en utilisant FTP/WebDAV. -> ( |
![]() | 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. |
![]() | : 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. |
![]() | : 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". |
![]() | Ctrl+Z) : Inverse, dans la limite d'un maximum de 100, les actions d'édition pour revenir à l'état précédent. -> ( |
![]() | 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". -> ( |
![]() | Ctrl+X) : Retire la sélection actuelle depuis le document et la place dans le presse-papier. -> ( |
![]() | Ctrl+C) : Place une copie de la sélection actuelle dans le presse-papier. -> ( |
![]() | Ctrl+V) : Place le contenu du presse-papier dans le document à la position du curseur. -> ( |
![]() | F4) : Vérifie l'orthographe du document. -> ( |
![]() | F7) -> Création rapide : Place un signet à la position actuelle du curseur. -> ( |
![]() | Ctrl+F) : Affiche le dialogue Rechercher/Remplacer, utiliser pour définir les opérations "rechercher" ou "rechercher et remplacer" sur le document. -> ( |
![]() | : 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. |
![]() | Ctrl+T) : Affiche la fenêtre de l'éditeur d'arbre. -> ( |
![]() | -> : Ouvre la perspective du debugger. |
![]() | -> : Ouvre la perspective de l'éditeur. |
![]() | -> : Ajuste le contraste. |
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.
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.
Tableau 3.13. Description des boutons de la barre d'outils projet
![]() | : Crée un nouveau projet dans le panneau projet. |
![]() | Ctrl+F2) : Affiche le dialogue Ouvrir le projet utilisé pour chercher, sélectionner et ouvrir un fichier projet. -> ( |
![]() | Ctrl+F3) : Sauve le projet actuel. Si le projet n'a pas de fichier, alors le dialogue "Enregistrer le projet sous" est affiché. -> ( |
![]() | : Active ou désactive le chemin du fichier pour tous les fichiers affichés dans la vue du projet. |
![]() | : 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. |
![]() | : Retire le contenu du dossier sélectionné de la vue du projet. |
![]() | : inclut le document actuel dans le dossier sélectionné dans la 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 à 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
|
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é.
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.
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.
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 :
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.
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
: Ferme uniquement l'onglet sélectionné. Tous les autres onglets restent.
: 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é.
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:
Documents XML
Documents DTD
Documents XSD
Documents XSL
Documents TXT
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.
Tableau 3.19. Description des boutons de la barre d'outils de l'éditeur
![]() | 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é. -> ( |
![]() | 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. -> ( |
![]() | -> : 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. |
![]() | -> : 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. |
![]() | -> : Convertit le document actuel vers un langage de grammaire supporté en utilisant le convertisseur Trang intégré. |
![]() | -> : Associe un schéma au document actuel. |
![]() | 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. -> ( |
![]() | 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. -> ( |
![]() | 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. -> ( |
![]() | Ctrl+Shift+L) : Lit la structure du document actuel afin qu'elle puisse être sauvée comme modèle en utilisant l'option . -> ( |
![]() | : Quand on est en mode "Bloqué" les balises ne peuvent être éditées. Débloquer permet l'édition des balises. |
: Exécute une expression XPath, utilisée pour sélectionner des éléments spécifiés à l'intérieur du document actuel.
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
![]() |
|
La barre de statut de l'éditeur, se trouvant sous l'espace d'édition, offre des informations sur le document actuel :
Affiche le chemin complet du document actuel.
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.
Affiche la position actuelle du curseur en termes de numéro de ligne : numéro d'espace.
Indique si le document a été modifié ou non depuis la dernière sauvegarde.
Le panneau message, situé dans la moitié basse de la fenêtre principalen, affiche les messages renvoyés par les opérations suivantes :
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
![]() |
|
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
![]() |
|
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.
Lors du travail avec les expressions XPath, oXygen sort les erreurs et les résultats de nœud au panneau message.
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.
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.
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.
Le panneau Contour, situé dans la partie inférieure gauche de la fenêtre principale possède les fonctions suivantes :
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.
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.
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.