Aide > Mode auteur > Utilisation du marquage > Insertion et affichage de commentaires
  
Insertion et affichage de commentaires
L'ajout de remarques dans un document, pour vous ou pour d'autres personnes qui travaillent dessus, peut être utile et pratique. Vous pouvez le faire dans Arbortext Editor en insérant des commentaires. Les commentaires n'apparaissent pas dans le document publié. Cependant, ils s'affichent dans la vue d'édition de votre document.
Ajout de commentaires à un document
Suivez la procédure ci-après pour ajouter un commentaire dans un document :
1. Placez le curseur à l'endroit où vous voulez insérer ce commentaire.
2. Sélectionnez Insérer > Commentaire.
Remarque : Les Menus complets doivent être activés pour que vous puissiez accéder à ce choix de menu. Pour activer les Menus complets, accédez à Outils > Préférences et sélectionnez la catégorie Fenêtre dans la boîte de dialogue Préférences. Cochez la case Menus complets.
3. Placez le curseur à l'intérieur de la paire de balises _comment et entrez vos notes ou commentaires.
Déplacement de marquage et de texte sélectionnés dans un commentaire
Non seulement il est possible d'ajouter des remarques, au moyen de commentaires, dans un document, mais vous pouvez également sélectionner du texte et/ou un balisage dans votre document, afin de les déplacer vers un commentaire. De cette manière, ils ne seront pas inclus dans la sortie publiée. Lorsque vous incluez des balises dans un commentaire, celles-ci sont converties en texte à l'intérieur du commentaire. Si, par exemple, vous sélectionnez dans votre document une balise para contenant le texte « Ceci est un commentaire. », puis choisissez Insérer > Commentaire, le contenu suivant est placé dans un commentaire :
<para>This is a comment.</para>
Notez qu'il n'est pas possible de déplacer un balisage dans un commentaire lorsque la suppression de ce balisage invalide la structure du document. Vous pouvez réintégrer du texte commenté et un balisage dans votre document en sélectionnant l'option de menu Edition > Annuler le commentaire. Si vous déplacez un commentaire contenant un balisage vers un autre emplacement de votre document et que vous essayez d'appliquer la commande Annuler le commentaire à ce contenu, le balisage intégré à un commentaire doit être valide dans le nouvel emplacement, sans quoi cette opération ne sera pas autorisée.
Suivez la procédure ci-après pour ajouter du texte et un balisage existant dans votre document à un commentaire :
1. Sélectionnez le contenu à déplacer vers un commentaire.
2. Sélectionnez Insérer > Commentaire.
Le texte et le balisage sélectionnés sont déplacés vers un commentaire.
3. Placez votre curseur dans le commentaire et sélectionnez Edition > Annuler le commentaire.
Le texte et le balisage inclus dans le commentaire sont réinsérés dans le document.
* 
Vous ne pouvez pas insérer de balises à l'intérieur d'une paire de balises _comment. Pour ajouter des balises, utilisez une section marquée (Entités > Sections marquées) en définissant son statut sur Ignorer. Remarque : Les sections marquées ne peuvent être utilisées que dans le cas de documents SGML.
Masquage des commentaires
Si vous souhaitez masquer les commentaires dans l'affichage d'édition de Arbortext Editor, utilisez la boîte de dialogue Préférences :
1. Pour désactiver l'affichage des commentaires, sélectionnez Outils > Préférences afin d'ouvrir la boîte de dialogue Préférences. Sélectionnez la catégorie Affichage et décochez la case Commentaires.
Vos commentaires sont masqués et les balises de commentaires s'affichent sous la forme d'une icône représentant une flèche à deux pointes.
2. Pour activer l'affichage des commentaires, accédez à la boîte de dialogue Préférences. Sélectionnez la catégorie Affichage et cochez la case Commentaires.