<oXygen/> User Guide

Fenêtre Éditeur d'arbre

La fenêtre éditeur d'arbre comprend les principaux composants suivants :

Figure 3.31. L'interface principale

L'interface principale

Menu principal

Le menu principal, situé sous la barre de titre du programme, offre un accès à toutes les fonctions disponibles dans l'Éditeur d'Arbre 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.23. Options du menu Fichier

  • Fichier-> Nouveau (Ctrl+N) : Crée un nouveau document vierge et l'affiche dans l'éditeur d'arbre.

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

  • 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 "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 vers URL : Affiche le dialogue Enregistrer vers URL, utilisé pour nommer et sauver un document ouvert dans un fichier ; ou sauver un fichier existant avec un nouveau nom, en utilisant FTP/WebDAV.

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

  • Fichier-> Fermer (Ctrl+W) : Ferme l'Éditeur d'Arbre.

Menu Édition

Tableau 3.24. Options du menu Édition

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

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

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

  • Édition->Effacer (Delete) : Efface le nœud sélectionné du document.

  • Édition->Commencer l'édition (F5) : Commence l'édition du nœud sélectionné depuis le document.

  • Édition->Fin édition (F6) : Termine l'édition du nœud sélectionné.

  • É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ée, dans la limite de 100, les actions d'édition qui ont été annulées par la fonction "Annuler".

Menu Insérer

Tableau 3.25. Options du menu Insérer

  • Insérer-> Insérer (F9) : Insère un nouveau node du même type que celui sélectionné en tant que son enfant.

  • Insérer élément : Insère un élément après le node sélectionné en tant que son dernier enfant.

  • Insérer attribut : Insère un attribut après le node sélectionné en tant que son dernier attribut.

  • Insérer commentaire : Insère un commentaire après le node sélectionné en tant que son dernier enfant.

  • Insérer CDATA: Insère un CDATA après le node sélectionné en tant que son dernier enfant.

  • Insérer instruction de traitement : insère une instruction de traitement après le nœud sélectionné en tant que dernier enfant.

  • Insérer texte : insère un texte après le nœud sélectionné en tant que dernier enfant.

  • Insérer référence entité : Insère une entité après le node sélectionné en tant que son dernier enfant.

Menu Déplacer

Tableau 3.26. Options du menu Déplacer

  • Déplacer->Relever (Ctrl+Haut) : Relève le nœud sélectionné d'une position.

  • Déplacer->Déplacer en bas (Ctrl+Bas) : Abaisse le nœud sélectionné d'une position.

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. Garder le curseur sur un icône pour afficher une aide contextuelle qui vous résume sa fonction. Cliquer sur un icône pour utiliser sa fonction.

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

Les boutons de la barre d'outils principale

Tableau 3.27. 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 fichier.

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 "Enregistrer sous".

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

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

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

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

Édition->Effacer (Effacer) : Efface le nœud sélectionné du document.

Édition->Annuler (Ctrl+Z) : Annule, dans une limite d'un maximum de 100, les actions d'édition pour retourner à 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".

XPath : Exécute une expression XPath, utilisé pour sélectionner les éléments spécifiés à l'intérieur du document.

Barre d'outils de l'éditeur d'arbre

La barre d'outils de l'éditeur d'arbre, situés sur la partie gauche de la fenêtre de l'éditeur d'arbre, offre un accès aisé aux fonctions fréquemment utilisées. Chaque icône est un bouton qui agit comme raccourci vers la fonction correspondante. Garder le pointeur de la souris sur un icône pour afficher une aide qui vous renseignera quant à sa fonction. Cliquer sur un icône pour utiliser sa fonction.

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

Valider le XML (Ctrl+Shift+V) : Exécute l'opération de validation sur le document actuel en utilisant une moulinette de validation. Retourne une liste de résultats des erreurs dans le panneau Message. Le formatage du document actuel est vérifié pour la conformité avec la DTD spécifiée ou les règles du schéma XML.

Insérer->Insérer - Élément : Insère un élément après le nœud sélectionné comme son dernier enfant.

Insérer->Insérer - Attribut : Insère un attribut après le nœud sélectionné comme son dernier enfant.

Insérer->Insérer - Commentaire : Insère un commentaire après le nœud sélectionné comme son dernier enfant.

Insérer->Insérer - CDATA : Insère un CDATA après le nœud sélectionné comme son dernier enfant.

Insérer->Insérer - Instruction de traitement : Insère une instruction de traitement après le nœud sélectionné comme son dernier enfant.

Insérer->Insérer - Texte : Insère un texte après le nœud sélectionné comme son dernier enfant.

Insérer->Insérer - Référence d'entité : Insère une référence d'entité après le nœud sélectionné comme son dernier enfant.

Commencer l'édition : commence l'édition du nœud sélectionné du document.

Finir l'édition : termine l'édition du nœud sélectionné.

Montrer/cacher attributs : cette option affiche/cache les attributs.

Montrer/cacher espace blanc : cette option affiche/cache l'espace blanc.

Déplacer->Relever (Ctrl+Up) : cette option relève le nœud sélectionné d'une position.

Déplacer->Abaisser (Ctrl+Down) : cette option abaisse le nœud sélectionné d'une position.

Tout augmenter (Ctrl+P) : cette option augmente l'élément sélectionné d'un niveau.

Tout effondrer (Ctrl+L) : cette option effondre l'élément sélectionné d'un niveau.

Insérer->Insérer (Insérer) : Insère un nouveau nœud du même type que celui sélectionné comme son frère.

Panneau éditeur

Le panneau éditeur comprend :

Figure 3.33. Le panneau éditeur

Le panneau éditeur

Le panneau navigation

Pour une navigation rapide dans le document vous pouvez utiliser le panneau de navigation qui affiche chaque niveau du document sur une colonne différente. Vous pouvez facilement naviguer sur le même niveau de l'arbre en appuyant sur la flèche descendante d'une colonne et choisir le signe désiré.

Le panneau de navigation se trouve au-dessus de l'espace d'édition.

Figure 3.34. Le panneau de navigation

Le panneau de navigation

Espace d'édition

L'éditeur de visualisation en arbre offre un ensemble utile de fonctions qui permettent une édition aisée des document structurés. Chaque signe a un icône associé pour une identification visuelle plus facile des signes.

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

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

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

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

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

  • Édition->Effacer (Effacer) : Efface le nœud sélectionné du document.

  • É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ée, dans la limite de 100, les actions d'édition qui ont été annulées par la fonction "Annuler".

  • Tout augmenter All (Ctrl+P) : Cette option augmente l'élément sélectionné d'un niveau.

  • Tout effondrer (Ctrl+L) : Cette option effondre l'élément sélectionné d'un niveau.

  • Valider XML (Ctrl+Shift+V) : Exécute l'opération de validation sur le document actuel en utilisant une moulinette de validation. Retourne une liste-résultat d'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é.

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.35. 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 Valider le XML et évaluation de l'expression XPath et le résultat (succès ou non) et le nombre d'erreurs trouvées durant la dernière opération.

Le panneau statut d'é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 de l'éditeur d'arbre, affiche les messages renvoyés par les opérations suivantes :

Figure 3.36. Le panneau message

Le panneau message

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

Pour changer de liste de résultats, sélectionner l'onglet requis. Pour fermer un onglet, ou tous les onglets, clic-droit sur l'onglet pour afficher un menu et sélectionner une option.

Tableau 3.30. Menu de l'onglet du panneau message

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

  • Fermer tous les onglets : Ferme tous les onglets à l'intérieur du 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.

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.31. 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 contenu entier du panneau message.

  • 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ésultas (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 le XML

La fonction "Valider le XML " utilise l'onglet nommé "erreurs" pour afficher les résultats. À chaque fois que cette fonction est exécutée la liste de résultats est rafraîchie avec les 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.

Panneau information

L'éditeur XML Oxygen offre un panneau d'information utile qui montre l'information détaillée sur l'attribut ou l'élément sur lequel vous travaillez.

Tableau 3.32. Information des éléments

  • Éléments : Indique le nom de l'élément.

  • Modèle : Indique la liste des éléments que l'élément sélectionné peut contenir, comme spécifié dans la DTD, le schéma XML ou le schéma Relax NG.

  • Facettes : Indique toutes les facettes appliquées à l'élément.

  • Attributs : Indique la liste des attributs que l'élément sélectionné peut contenir, comme spécifié dans la DTD, le schéma XML ou le schéma Relax NG.

Tableau 3.33. Information des attributs

  • Attributs : Indique le nom de l'attribut.

  • Modèle : Indique le type de l'attribut sélectionné, comme spécifié dans la DTD ou le schéma XML.

  • Facetttes : Indique toutes les facettes appliquées à l'élément.

  • Valeur : Indique la liste des valeurs possibles que l'attribut sélectionné peut contenir, comme spécifié dans la DTD ou le schéma XML.

  • Défaut : Indique la valeur par défaut de l'attribut.

  • Requis : Indique si l'attribut sélectionné est requis.

Panneau des entités

Le panneau des entités présente une liste d'entités définies que vous pouvez insérer dans votre document.

Tableau 3.34. Panneau des entités

  • Après : Vous permet d'insérer l'entité sélectionnée dans votre document après le nœud actuel comme prochain enfant.

  • Premier : Vous permet d'insérer l'entité sélectionnée dans votre document comme premier enfant de l'élément actuel.

  • Dernier : Vous permet d'insérer l'entité sélectionnée dans votre document comme dernier enfant de l'élément actuel.

Panneau Tous les Éléments

Le panneau Tous les Éléments présente une liste de tous les éléments définis que vous pouvez insérer dans votre document.

Tableau 3.35. Panneau Tous les Éléments

  • Après : Vous permet d'insérer l'élément sélectionné dans votre document après l'élément actuel comme enfant suivant.

  • Premier : Vous permet d'insérer l'élément sélectionné dans votre document comme premier enfant de l'élément actuel.

  • Dernier : Vous permet d'insérer l'élément sélectionné dans votre document comme le dernier enfant de l'élément actuel.