<oXygen/> XML Editor User Guide

Chapitre 13. Configurer l'editeur

Préférences

Une fois que <oXygen/> est installé vous pouvez utiliser les préférences suivantes pour personnaliser <oXygen/> selon vos besoins et votre environnement réseau.

Général

Figure 13.1. Les préférences générales

Les préférences générales
Contrôle automatique de version

Lorsqu'il est activé, contrôle la disponibilité d'une nouvelle version de <oXygen/> à http://www.oxygenxml.com.

Changer la langue de l'interface

<oXygen/> supporte plusieurs langues pour la localisation de l'interface utilisateur. Sélectionnez la liste déroulanteOptions->Préférences->Général+Langue pour afficher la langue de votre choix.

Changer l'apparence

Utilisez cette option pour modifier le style de l'interface.

Encodage pour les fichiers non-XML

Cette option définit l'encodage par défaut à utiliser lors de l'ouverture de documents non-XML.

Manipulation de la BOM

Cette option définit la manipulation de la BOM (marque d'ordre d'octet ou Byte Order Mark) quand le document est sauvegardé.

Les options possibles sont :

  • Ne pas écrire - n'écrit pas les octets de la BOM, les octets chargés de la BOM sont ignorés ;

  • Écrire - écrit les octets de la BOM associés au codage du document;

  • Préserver - si le document chargé avait une BOM, écrire les octets de la BOM associée au codage du document. C'est l'option par défaut.

Séparateur de ligne

Cette option définit le séparateur de ligne à utiliser. Le choix par défaut du système règle le séparateur de ligne selon la plate-forme.

Navigateur internet par défaut

Le chemin d'un exécutable de navigateur web. Le navigateur est utilisé pour ouvrir les résultats des transformations XSLT ou PDF, pour ouvrir la page d'accueil de <oXygen/> ou pour aller à des paragraphes spécifiques dans la recommandation du W3C XML Schéma sur le site du W3C en cas d'erreurs de validation.

Open last edited files from project

When enabled, <oXygen/> will open the last edited files from project at start-up.

Beep on operation finished

If checked, it notifies the user thru a beep that an action has ended. It will notify the user only at the end of validate, wellformed and transform actions.

Éditeur

Utilisez ces options pour configurer l'aspect visuel, les paramètres de formatagee et le comportement de l'assistant de contenu.

Aspect

Figure 13.2. Le panneau Aspect

Le panneau Aspect
Police

Utilisez cette option pour sélectionner la famille et la taille de la police utilisée pour afficher le texte dans l'éditeur.

Couleur de fond de l'éditeur

Utilisez cette option pour régler la couleur de fond de l'éditeur.

Couleur du curseur de l'éditeur

Utilisez cette option pour régler la couleur de fond de l'éditeur.

Couleur de la sélection active

Utilisez cette option pour régler la couleur du texte sélectionné.

Couleur de fond de la sélection

Utilisez cette option pour régler la couleur de fond du texte sélectionné.

Couleur de surlignage des lignes

Utiliser cette option pour régler la couleur de surlignage pour la ligne où se trouve le curseur.

Même police pour l'interface

Si coché, la police de l'interface sera celle de l'édition.

Anti-crénelage du texte

Cette option indique si les chaînes du texte doivent être dessinées avec un rendu anti-crénelage.

Saut de ligne

Cette option va automatiquement faire de sauts de ligne dans les documents édités.

Montrer marques EOL/EOF

Montre les EOL/EOF en utilisant de petits icônes, pour une meilleure visualisation du document.

Afficher les nombres de lignes

Cette option active la colonne des numéros de ligne se trouvant dans la partie gauche de l'espace d'édition. Si la case n'est pas cochée, l'option nombres de lignes est désactivée.

Afficher la barre d'augmentation

Cette options active l'affichage de la barre d'augmentation du document.

Surligner la balise correspondante

Cette option active le surlignage pour les balises correspondant à celle où se trouve le curseur.

Surligner la ligne actuel

Permet le surlignage de la ligne actuelle.

Formatage

Figure 13.3. Le panneau Formatage

Le panneau Formatage
Détecter l'indentation à l'ouverture

L'éditeur essaie de détecter les réglages d'indentation du document XML ouvert. De cette façon vous pouvez formater correctement les fichiers qui ont été créés avec des réglages différents, sans avoir à changer vos options. De plus vous pouvez activer les options avancées pour détecter la longueur maximale de ligne à utiliser pour la formatage et le saut de ligne réel. Ces fonctions ont été conçus pour minimiser les différences créées par l'opération d'impression intelligente en travaillant avec un système de versionage comme CVS par exemple.

Indenter avec tabulation

Si coché active 'Indenter avec tabulation' pour régler l'indentation à une unité de tabulation. Si la case n'est pas cochée, 'Indenter avec tabulation' est désactivé et l'indentation sera du nombre d'espaces définis par l'option 'Largeur d'une indentation'.

Taille d'indentation

Règle le nombre d'espaces ou la taille de la tabulation qui équivaudra à une simple indentation. L'indentation peut être des espaces ou une tabulation, séléctionner la préférences en utilisant l'option Indentation avec Tabulation. Si réglé à 4 une tabulation équivaudra à 4 espaces blancs ou une tabulation de 4 caractères suivant quelle option a été réglée dans l'option Indentation avec Tabulation.

Indenter en collant

Indenter le texte du collage suivant les réglages d'indendation définis par l'utilisateur. Cela est utile pour préserver le style d'indentation du texte copié depuis d'autres documents.

Saut de ligne réel

Cette fonciton permet de gagner du temps lors de l'écriture d'un gros document XML. Vous pouvez définir une limite pour la longueur des lignes dans votre document. Quand cette limite est dépassée, l'éditeur va insérer une nouvelle ligne avant le mot qui fait dépasser la limite, et va indenter la ligne suivante. Cela minimise le besoin de reformater le document.

Enable Smart Enter

If checked, it inserts a new indented line between start and end tag.

Formater et indenter le document à l'ouverture

Si coché, l'opération Formater et indenter le document à l'ouverture va formater et indenter le document avant l'ouverture

Augmenter les éléments vides

Si coché, l'opération Format et indenter va représenter les éléments vides avec une balise de fermeture séparée, par ex. <a atr1="v1"></a>. Si non-coché, la même opération va représenter un élément vide dans une forme plus compacte : <a atr1="v1"/>

Add space before closing empty tags

When checked the Format and Indent operation will add a space before the closing slash of a closing tag.

Trier les attributs

Si coché, l'opération Formater et indenter va trier alphabétiquement les attributs d'un élément. Si non-coché, la même opération va les laisser dans le même ordre qu'avant l'application de l'opération.

Break line before attribute's name

If checked, the "Format and Indent" (Pretty-Print) function will break the line before the attribute's name.

Break long attributes

If checked, the "Format and Indent" (Pretty-Print) function will break long attributes.

Detect line width on open

If checked, it detects the line width automatically when the document is opened.

Indent in preserve space elements

If checked, automatic tags indentation while editing will take place for all elements including the ones that are excluded from Pretty Print (default behaviour). When unchecked, indentation while editing will not take place in elements that have the 'xml:space' attribute set on 'preserve' or are in the list of Preserve Space Elements.

Longueur de ligne - pretty print

Définit le point auquel la fonction "Formater et indenter" (Pretty-Print) va exécuter le saut de ligne. Si réglé à 100, Pretty-Print va faire un saut de ligne au 100ème espace, espaces vierges, balises, et éléments inclus.

Préserver les éléments d'espace

Cette liste contient les noms des éléments pour lesquels les espaces blancs contenus comme les blancs, tabulations et lignes vierges sont préservés par l'opération Formater et indenter exactement comme avant l'application de l'opération.

Éliminer les éléments d'espace

Cette liste contient les noms des éléments pour lesquels les espaces blancs contigus comme les blancs, tabulations et lignes vierges sont fusionnés par l'opération Formater et indenter en un seul blanc.

Enregistrer

Figure 13.4. Le panneau Enregistrer

Le panneau Enregistrer
Faire une copie de sauvegarde à l'enregistrement

Si coché, à la sauvegarde d'un document édité une copie de sécurité est faite.

Activer l'enregistrement automatique

L'enregistrement automatique est une fonction pratique qui assure que votre travail est sauvegardé en fond. Vous pouvez spécifier le délai entre chaque sauvegarde automatique. Si coché, permet à l'enregistrement automatique d'utiliser la valeur spécifiée. Si non-coché, l'enregistrement automatique est désactivé.

Intervalle d'enregistrement automatique (minutes)

Sélectionner le délai en minutes pour l'intervalle entre chaque enregistrement automatique.

Enregistrer tous les fichiers avant la transformation ou la validation

Enregistre tous les fichiers ouverts avant de valider ou de transformer un document XML. De cette façon les dépendances sont résolues, par exemple en modifiant à la fois le document XML et son Schéma XML.

Check errors on save

If checked, a checking for errors is done when saving the edited document.

Modèles de code

Les modèles de code sont des petits fragments de document qui peuvent être réutiliser dans d'autres sessions d'édition. We have defined a large set of ready-to use templates for XSL and XML Schema stored in a file named code_templates.xml located in the <oXygen/> Preferences folder (subfolder com.oxygenxml of the user home directory). So you can even share the templates from this file with your colleagues using the import function. Pour obtenir la liste des modèles vous devez utiliser Tag-Insight avec le raccourcis clavier (par défaut CTRL-ESPACE).

Figure 13.5. Le panneau des modèles de code

Le panneau des modèles de code
Nouveau

Définir un nouveau modèle de code.

Éditer

Éditer le modèle de code sélectionné.

Effacer

Effacer le modèle de code sélectionné.

Importer

Importer un fichier avec des modèles de code.

Exporter

Exporter un fichier avec des modèles de code.

Performance

Figure 13.6. The Performance pane

The Performance pane
Clear undo buffer on save

If checked, the undo action has no effect after you've saved your document. You can only undo the modifications made after you've saved it.

Clear undo buffer before Format and Indent

If checked, the undo buffer is cleared. The undo action can now only undo the Format and Indent action

Tag-Insight

La fonction Tag-insight permet la recherche en ligne de syntaxe et l'auto-remplissage d'éléments et d'attributs de formatage pour rationnaliser le formatage et réduire les erreurs lors de l'édition.

Propriétés

Ces réglages définissent le mode opératoire de l'assistant de contenu.

Figure 13.7. Le panneau Propriétés de Tag Insight

Le panneau Propriétés de Tag Insight
Utilisation Tag-insight

Cette option active le Tag-insight. Si la case n'est pas cochée, toutes les fonctionnalités Tag-insight sont désactivées.

Case sensitive search

When it is checked the search in the content completion window when you type a character is case sensitive ('a' and 'A' are different characters).

Fermer l'élément inséré

Lors de l'insertion d'éléments depuis l'assistant Tag-insight, les balises de début et de fin sont toutes deux insérées.

Ajouter le contenu de l'élément

Lorsque la case est cochée, <oXygen/> va insérer automatiquement les éléments de la DTD ou du Schema XML.

Ajouter contenu optionnel

Si coché, <oXygen/> va automatiquement insérer les éléments optionnels de la DTD ou du schéma XML.

Ajouter première particule du choix

Si coché, <oXygen/> va automatiquement insérer la première particule du choix de la DTD ou du schéma XML.

Insérer les attributs obligatoires

Si coché, <oXygen/> va automatiquement insérer les attributs requis depuis la DTD ou le schéma XML pour un élément inséré avec l'aide de l'assistant Tag-Insight.

Insérer les attributs fixés

Si coché, <oXygen/> va automatiquement insérer n'importe quels attributs FIXÉS de la DTD ou du Schema XML pour un élément inséré à l'aide de l'assistant Tag-Insight.

Montrer toutes les entités

Si coché, <oXygen/> va afficher une liste avec toutes les entités internes et externes déclarées dans le document actuel quand l'utilisateur tape le caractère de début d'une entité (c.-à-d. &).

Position du curseur entre les balises

Si coché, <oXygen/> va mettre le curseur automatiquement entre les balises même si les éléments auto-insérés ont des attributs qui ne sont pas requis. La position du curseur peut être forcée entre les balises.

Montrer annotations

Si coché, <oXygen/>, va afficher les annotation squi sont présentes dans le schéma utilisé pour l'élément actuel, l'attribut ou la valeur de l'attribut.

Montrez annotations comme tooltip

Si coché, il montre les annotations de cet élément comme tooltip.

Utiliser les commentaires de la DTD comme annotation

Si coché, <oXygen/> va utiliser tous les commentaires de DTD comme annotation.

Apprendre les valeurs des attributs

Si coché, <oXygen/> va afficher une liste avec toutes les valeurs des attributs apprises depuis le document actuel.

Apprendre à l'ouverture du document

Si coché, <oXygen/> va automatiquement apprendre la structure du document quand le document est ouvert.

Défaut

When no schema is specified in the edited document, <oXygen/> will try to use one of the default association rules set. It will try to use the association rules in the order presented in the Tag Insight / Default pane.

Figure 13.8. Le panneau Défaut Tag Insight

Le panneau Défaut Tag Insight
Namespace

Specifies the namespace of the root element from the association rules set (any by default).

Root local name

Specifies the local name of the root element (any by default).

File name

Specifies the name of the file (any by default).

Schema type

Specifies the type of schema to be used in the association rules for the document.

Schema URI

Specifies the location from where to load the schema to be used in the current association rule. The macro ${frameworks} can be used and it will be expanded to the path of the subdirectory frameworks of the <oXygen/> installation directory.

New

Opens a new dialog allowing you to specify a new association rule.

Figure 13.9. Schema mapping dialog

Schema mapping dialog
Edit

Opens a new dialog allowing you to edit an existing association rule.

Delete

Deletes one of the existing association rule.

Up

Moves the selected association rule one level up (the order is important because the first schema mapping in the list that can be associated with the document will be associated..

Down

Moves the selected association rule one level down

XSL

Ces réglages définissent quels éléments sont suggérés par l'assistant de contenu en plus de ceux de la XSL.

Figure 13.10. Le panneau XSL de Tag Insight

Le panneau XSL de Tag Insight
Aucun

Le Tag-insight n'offrira que l'information XSL..

XHTML transitional

Inclut les éléments XHTML Transitional comme substitut pour xsl:element.

Formating objects

Inclut des éléments Formating Objects comme substitut pour xsl:element.

Autre

Inclut des éléments d'un fichier DTD ou Schema XML spécifié depuis une URL comme substitut pour xsl:element.

Diagramme

If operation is slow for very large schemas disabling the schema diagram view will improve the speed of navigation through the edited schema.

Figure 13.11. Panneau de configuration de diagramme de schéma

Panneau de configuration de diagramme de schéma
Montrez le diagramme de XML Schema

If this option is disabled the schema diagram for XML Schemas will not be generated and displayed.

Montrez le diagramme de Relax NG

If this option is disabled the schema diagram for Relax NG schemas will not be generated and displayed.

Le panneau Catalogue XML

Figure 13.12. Catalogue XML

Catalogue XML

When using catalogs it is sometimes useful to see what catalog files are parsed, if they are valid or not, and what identifiers are resolved by the catalogs. The Verbosity option is used to control the output of such messages. By default it is not selected.

If the Use default catalog option is checked the first XML catalog which <oXygen/> will use to resolve system IDs at document validation and URI references at document transformation will be a default built-in catalog which maps such references to the built-in local copies of the DocBook and TEI frameworks and the schemas for XHTML, SVG and JSP documents.

L'option Préférer est utilisé pour spécifier si <oXygen/> va essayer de résoudre d'abord la référence publique PUBLIC ou SYSTEM en utilisant les catalogues XML spécifiés. Si une référence PUBLIC ne se trouve dans aucun des catalogues alors une référence SYSTEM est recherchée.

Quand vous ajoutez ou effacez un catalogue XML à la liste vous devez relancer l'application pour que les changements prennent effet.

Caractéristiques de Parseur XML

Figure 13.13. Le panneau Options Parseur XML

Le panneau Options Parseur XML
Maximum number of problems reported per file

Limit the number of errors reported at validation or well-formed check. Use this option when the total number of errors is big and the time of displaying is too large.

http://apache.org/xml/features/validation/schema - Cette option règle la fonction 'schema' sur vrai.

http://apache.org/xml/features/validation/schema-full-checking - Cette option règle la fonction 'schema-full-checking' sur vrai.

http://apache.org/xml/features/validation/honour-all-schema-location - This option sets the 'honour-all-schema-location' feature to true. This means all the schemas that are imported for a specific namespace are used to compose the validation model. If this is false, only the first schema import is taken into account.

Use only XML Schema For Validation

This option forces validation against a referred XML Schema even if the document includes a DTD declaration.

Activer le traitement XInclude

si coché, le support XInclude dans <oXygen/> est activé.

Base URI fixup

[Xerces XML Parser documentation:] According to the specification for XInclude, processors must add an xml:base attribute to elements included from locations with a different base URI. Without these attributes, the resulting infoset information would be incorrect.

Unfortunately, these attributes make XInclude processing not transparent to Schema validation.

One solution to this is to modify your schema to allow xml:base attributes to appear on elements that might be included from different base URIs.

If the addition of xml:base is undesired by your application, you can disable base URI fixup.

Language fixup

[Xerces XML Parser documentation:]The processor will preserve language information on a top-level included element by adding an xml:lang attribute if its include parent has a different [language] property.

If the addition of xml:lang is undesired by your application, you can disable the Language fixup.

Check ID/IDREF

Checks the ID/IDREF matches when the Relax NG document is validated.

Check feasibly valid

Checks the Relax NG to be feasibly valid when this document is validated.

Options de XSLT

Figure 13.14. Options de XSLT

Options de XSLT

Si vous souhaitez utiliser un autre transformateur XSLT que celui livré avec <oXygen/> c.-à-d. Apache Xalan et Saxon, il vous suffit de spécifier le nom de la classe du transformateur que <oXygen/> va régler comme valeur de la propriété Java "javax.xml.transform.TransformerFactory". Pour exécuter une transformation XSLT avec Saxon 7 par exemple, vous devez placer le fichier jar Saxon 7 dans le dossier des bibliothèques de <oXygen/> (le sous-dossier lib du dossier d'installation), régler "net.sf.saxon.TransformerFactoryImpl" comme valeur de la propriété et sélectionnert JAXP comme le processeur XSLT dans le scénario de transformation associé au document XML transformé.

Valeur

Permet à l'utilisateur d'entrer le nom de la classe Java du transformateur.

XSLT 1.0 Valider avec

Permet à l'utilisateur de régler le moteur XSLT utilisé pour la validation des documents XSL 1.0.

XSLT 2.0 Valider avec

Permet à l'utilisateur de régler le moteur XSLT utilisé pour la validation des documents XSL 2.0.

Réglages Debugger

Cette section explique les réglages disponibles pour le mode Debugger. Pour afficher les réglages, sélectionnez Options->Préférences->XSLT/FO+Options Debugger (voir Figure 13.15, « Réglages Debugger »).

Figure 13.15. Réglages Debugger

Réglages Debugger

Les réglages suivants sont disponibles :

Active la sortie XHTML

Active ou désactive la sortie en XHTML Vue du document de sortie durant la transformation. Pour des questions de performance, il est conseillé de désactiver la sortie XHTML pour les gros traitements. Par ailleurs, la zone XHTML ne peut afficher que les documents XHTML. Pour pouvoir voir le résultat de sortie d'autres formats, comme HTML, enregistrez la zone de sortie texte dans un fichier et utilisez le navigateur externe requis pour la visualisation.

Détection de boucle infinie

Activez cette option pour recevoir une notification lorsqu'une boucle infinie apparaît durant la transformation.

Profondeur maximale dans la pile des modèles

Combien d'instructions modèles (<xsl:templates>) peuvent apparaître sur la pile actuelle. Ce réglage est utilisé par la détection de boucle infinie.

Réglages Profiler

Figure 13.16. Réglages Profiler

Réglages Profiler

Les réglages suivants sont disponibles :

Show time

Show the total time that was spent in the node.

Show inherent time

Show the inherent time that was spent in the node.

Show invocation count

Show how many times the node was called in this particular call sequence.

Time scale

The time scale options determine the unit of time measurement, which may be milliseconds (ms) or microseconds (µs).

Hotspot threshold

The threshold below which hot spots are ignored is entered in milliseconds (ms).

Ignore invocation less than

The threshold below which invocations are ignored is entered in microseconds (µs).

Percentage calculation

The percentage base determines against what time span percentages are calculated.

  • Absolute: Percentage values show the contribution to the total time.

  • Relative: Percentage values show the contribution to the calling node.

Processeurs FO

En dehors du processeur d'objets de formatage intégré (Apache FOP) l'utilisateur peut utiliser d'autres processeurs externes. <oXygen/> a implémenté une façon aisée d'ajouter RenderX XEP comme processeur de FO externe si l'utilisateur a XEP d'installé.

Figure 13.17. Le panneau processeur FO

Le panneau processeur FO
Permettre le rendement du FOP intégré

Si coché, toutes les sorties FOP seront affichés dans un panneau de résultats en bas de la fenêtre de l'éditeur dont les messages ennuyants sur les instructions FO non-supportées par FOP.

Mémoire disponible pour le FOP intégré

Si vos transformations FOP échouent avec l'erreur "Out of Memory", sélectionnez depuis cette liste de choix une plus grande valeur pour le niveau de mémoire réservé pour les transformations FOP.

Fichier de configuration pour le FOP intégré

Vous devriez spécifier ici un chemin pour le fichier de configuration FOP, nécessaire par exemple pour sortir en PDF en utilisant une fonte True Type pour un document contenant de l'Unicode.

Les utilisateurs peuvent configurer les processeurs externes à utiliser avec <oXygen/> dans le dialogue suivant.

Figure 13.18. Configurer les processeurs externes

Configurer les processeurs externes
Nom

Le nom qui sera affiché dans la liste des processeurs FOP disponibles sur l'onglet FOP du dialogue configuration de la transformation.

Description

La description du processeur FO affichée dans l'option Préférences->Processeurs FO.

Dossier de travail

Le dossier dans lequel les résultats intermédiaires et finaux du traitement seront sauvés. Here you can use one of the following macros:

${home}

The path to user home directory.

${cfd}

The path of current file directory.

${pd}

The project directory.

Ligne de commande

La ligne de commande qui lancera le processeur FO, spécifique à chaque processeur. Here you can use one of the following macros:

${method}

The FOP transformation method (pdf, ps, txt).

${fo}

The input FO file.

${out}

The output file.

XPath

Figure 13.19. Le panneau XPath

Le panneau XPath
Exécuter XPath sur le source XSLT

Si coché, <oXygen/> va évaluer l'expression XPath sur les documents XSLT, sinon l'expression XPath est appliquée sur le document sélectionnée dans l'éventuel scénario de transformation associé au document XSLT.

Default prefix-namespace mappings

Associates prefixes to namespaces. These mappings are useful when applying an XPath in XPath console and you don't have to define these mappings for each document separatelly.

The New button creates an editable prefix-namespace mapping.

The Delete button deletes the selected mapping.

XQuery

Figure 13.20. XQuery pane

XQuery pane
XQuery validate with

Allows you to select the XSLT Procesor to validate the XQuery

Database

Importer

Here it is configured how empty values and null values are handled when they are encountered in an import operation.

Figure 13.21. Panneau de configuration d'importation de base de données

Panneau de configuration d'importation de base de données
Créez les éléments vides pour des valeurs vides

If this option is enabled an empty value from a database column will be imported as an empty element.

Créez les éléments vides pour des valeurs nulles

If this option is enabled a null value from a database column will be imported as an empty element.

JDBC Drivers

Here you can configure the JDBC Drivers for the Import from Database action.

Figure 13.22. JDBC Drivers pane

JDBC Drivers pane
New

Opens the JDBC Drivers dialog, allowing you to configure a new driver that will appear in in the list from "Select database table" dialog.

Figure 13.23. The JDBC Drivers dialog

The JDBC Drivers dialog
Name

Provide the name for the JDBC Driver

URL:

Provide the URL for the JDBC Driver

Driver Class

Provide the Driver Class for the JDBC Driver

Add

Adds the JDBC driver class library.

Remove

Removes driver class library from the list.

Detect

Detects JDBC driver candidates.

Stop

Stops the detection of the JDBC driver candidates.

Edit

Opens the JDBC Drivers dialog, allowing you to edit the selected driver. See above the specifications for the JDBC Drivers dialog.

Delete

Deletes the selected JDBC Driver.

Diff

<oXygen/> offers both directory and file comparison, six different diff algorithms to choose from for file comparison and multiple levels of comparison.

The complete diff solution includes two XML diff algorithms (XML Fast and XML Accurate), one Syntax Aware algorithm that gives very good results on all file types known by <oXygen/> and three all-purpose algorithms: line based, word based and characted based. Any algorithm can be used to perform differences on request, but <oXygen/> offers also an automatic selection of the algorithm, selecting the most appropriate one based on the files' content and size.

Figure 13.24. The Diff pane

The Diff pane
Default algorithm

Select from the list the algorithm that will be used as default when you open the Compare files dialog

  • Auto makes an automatic selection of the diff algorithm, based on the files' content and size.

  • Characters computes the differences at character level.

  • Words computes the differences at word level..

  • Lines computes the differences at line level.

  • Syntax aware : for the file types known by <oXygen/>, this algorithm computes the differences taking into consideration the syntax of the documents.

  • XML Fast is designed for XML documents. It works better than XML Accurate on large files, but it is less precise.

  • XML Accurate is designed for XML documents. It works best on smaller XML files and it is most precise.

[Note]Note

XML Fast and XML Accurate work for XML documents. If you'll try to use them for other types of files, you'll be prompted with the message "content not allowed in prolog"

Ignore whitespaces

This option, if checked, allows the diff algorithm to ignore the whitespaces.

XML Diff Options

This set of options allows you to specify the types of differences that will be ignored in the XML Fast and XML Accurate algorithms:

  • in node / type:
    • Processing instructions

    • Comments

    • CDATA

    • DOCTYPE

    • Text

  • in namespaces / prefixes

  • in the attributes order

Merge adjacent differences

If checked, it considers adjacent differences as one and they are presented in this way in the side-by-side editors. If unchecked, every difference is represented separately.

Mark end tags as different for modified elements

If checked, end tags of modified elements are presented as differences.

Ignore expansion state for empty elements

If checked, empty elements in both expansion states are considered matched.

Maximum number of differences

This option allows you to specify the maximum number of differences between your documents that you might be interested to see. If the number of differences is larger than the one specified here, you'll be notified by the message "Too many differences".

For the directories comparison you can specify the criterion for the component files comparison and a default file filter.

Compare files by:
  • Content

  • Timestamp (last modified date/time)

Default file filter

specifies the default type of files that will be compared in Diff Directories

Modules d'extension

<oXygen/> offre la possibilité d'ajouter des modules qui étendent les fonctions de l'application. Les modules sont livrés en tant que paquets séparés ; vérifiez l'arrivée de nouveaux modules sur le site de <oXygen/> : http://www.oxygenxml.com.

Un module consiste en un sous-dossier séparé dans le dossier des modules dans le dossier d'installation de <oXygen/>. Ce sous-dossier doit contenir un fichier plugin.xml valide en accord avec le fichier plugin.dtd file du dossier des modules.

<oXygen/> détecte et charge automatiquement les modules correctement installés dans le dossier des modules et les affiche dans l'option Modules d'extension du dialogue Préférences.

Figure 13.25. Le panneau Modules

Le panneau Modules

Une courte description du module peut être obtenue avec un clic-droit sur le nom du module.

Outils externes

L'utilisateur peut utiliser à l'intérieur de <oXygen/> d'autres outils comme à partir de la ligne de commande du shell du système d'exploitation. La configuration d'un tel outil se fait dans le dialogue suivant.

Figure 13.26. Configurer les outils externes

Configurer les outils externes
Nom

Le nom de l'entrée du menu correspondant à cet outil qui sera affiché dans le menu Outils externes et dans la boîte combo outils externes de la barre d'outils.

Description

La description de l'outil affichée dans l'option Préférences->Outils externes.

Raccourci clavier

Le raccourci clavier qui lance l'outil externe.

Dossier de travail

Le dossier que l'outil externe utilisera pour sauver les résultats intermédiaires et finaux. Here you can use one of the following macros:

${home}

The path to user home directory.

${cfd}

The path of current file directory.

${pd}

The project directory.

Ligne de commande

La ligne de commande qui lancera l'outil externe. Here you can use one of the following macros:

${dbgXML}

The path to the current Debugger source selection.

${dbgXSL}

The path to the current Debugger stylesheet selection.

${home}

The path to user home directory.

${cfn}

The current file name without extension.

${cf}

The path of the currently edited file.

${cfd}

The path of current file directory.

${tsf}

Transformation result file.

${pd}

The project directory.

Menu raccourcis clavier

L'utilisateur peut configurer dans un seul endroit tous les raccourcis clavier des entrées du menu disponibles dans <oXygen/>. Les raccourcis actuels assignés aux entrées du menu sont affichés dans le tableau suivant.

Figure 13.27. Le panneau du menu raccourcis clavier

Le panneau du menu raccourcis clavier
Description

Une courte description de l'opération de l'entrée du menu.

Catégorie

Les raccourcis sont classés en catégories pour une gestion plus aisée. Par exemple l'opération "Couper" pour la vue de la source est distinguée de l'éditeur d'arbre en l'assignant à une catégorie différente.

Raccourci

Le raccourci clavier qui lance l'opération. Double-cliquer sur une rangée du tableau ou presser le bouton "Éditer" permet à l'utilisateur d'enregistrer un nouveau raccourci pour l'opération affichée dans cette rangée.

Types de fichiers

<oXygen/> supporte une grande variété de types de fichiers, mais les utilisateurs sont libres d'ajouter de nouveaux types de fichiers spécifiés par l'extension et de les associer au type d'éditeur qui convient le mieux.

Figure 13.28. Les types de fichiers

Les types de fichiers
Extension

Les nouveaux types de fichiers.

Éditeur

Le type de l'éditeur auquel les extensions seront associées. Certains éditeurs offrent un accès aisé à des opérations fréquentes via des barres d'outils (ex. éditeur XML, éditeur XSL, éditeur de DTD) tandis que d'autres offrent juste une colorisation de syntaxe (ex. éditeur Java, SQL, Shell, etc.)

Configuration du proxy

Certains réseaux utilisent des serveurs proxy pour offrir des services internet à des clients LAN. Les clients derrière le proxy ne peuvent par conséquent se connecter à internet que via le service proxy. Le dialogue de configuration du proxy permet cette configuration. Si vous n'êtes pas sûr si votre ordinateur est obligé d'utiliser un serveur proxy pour se connecter à internet ou que vous ne connaissez pas les valeurs nécessaires pour la configuration du proxy, veuillez consulter votre administrateur réseau.

Ouvrir le dialogue de configuration du proxy en sélectionnant Options->Préférences->Configuration du proxy.

Figure 13.29. Le dialogue de configuration du proxy

Le dialogue de configuration du proxy

Compléter le dialogue comme suit:

Utiliser serveur proxy

Si coché, permet à <oXygen/> d'utiliser le serveur proxy spécifié. Si non-coché, le serveur proxy est désactivé.

Proxy web (HTTP)

L'adresse IP address ou le Fully Qualified Domain Name (FQDN) du serveur proxy.

Port

Le numéro du port TCP, normalement réglé sur 80 ou 8080.

Utilisateur

Le nom de l'utilisateur si nécessaire. Peut être vide.

Mot de passe

Le mot de passe pour l'authentification. Peut être vide.

Aucun proxy pour

Donne les domaines pour lesquels aucun proxy ne doit être utilisé.

SOCKS

Si coché, permet à SOCKS d'utiliser l'hôte et le port spécifiés pour le serveur. Si non-coché, SOCKS est désactivé.

Hôte

L'hôte SOCKS auquel vous souhaitez vous connecter.

Port

Le port SOCKS auquel vous souhaitez vous connecter.

Certificates

In <oXygen/> there are provided two types of Keystores: Java KeyStore (JKS) and Public-Key Cryptography Standards version 12 (PKCS-12). A keystore file is protected by a password.

Figure 13.30. Certificates

Certificates
Keystore type

Represents the type of keystore to be used.

Keystore file

Represents the location of the file to be imported.

Keystore password

The password which is used to protect the privacy of the stored keys.

Certificate alias

The alias to be used to store the key entry (the certificate and /or the private key) inside the keystore.

Private key password

It is only necessary in case of JKS keystore. It represents the certificate's private key password.

Validate

Verifies the entries from the fields; assures that the cerificate is valid.

Résultats / Sortie

Figure 13.31. L'option Résultats/Sortie

L'option Résultats/Sortie
Nombre maximal de lignes

Cette option règle le nombre maximal de lignes de la console de sortie où les outils externes placent leur sortie.

Imprimer

Figure 13.32. L'option échelle de l'impression

L'option échelle de l'impression

Il est parfois utile d'imprimer le contenu d'un document sur papier. <oXygen/> vous permet d'ajuster l'échelle de l'impression pour rendre plus aisée la lecture de la page.

Échelle d'impression

Affiche une barre permettant d'ajuster l'échelle d'impression entre 40% et 100%.

Tree editor

Figure 13.33. Tree editor options

Tree editor options
Format and indent on save

Check if the document should be formatted and indented (pretty-print) on save.

Couleurs

<oXygen/> supporte la colorisation de syntaxe pour les documents XML, DTD, Relax NG (XML et syntaxe compacte), Java, JavaScript, XQuery, C++, C, PHP,CSS, Perl, Properties, SQL, Shell et Batch. Même si <oXygen/> offre une configuration des couleurs par défaut pour coloriser les signes, vous pouvez choisir de personnaliser, comme exigé, en utilisant le dialogue Couleurs.

Figure 13.34. Le panneau Couleurs

Le panneau Couleurs

Ouvrez le dialogue des Couleurs en sélectionnant Options->Préférences->Couleurs et choisissez un des Types de Document supporté. Chaque type de document contient un ensemble de signes. Quand le Type de Document est sélectionné, les signes associés sont listés. Sélectionner un signe affiche les propriété de couleur actuelles et vous permet de les modifier. Utiliser les modèles Échantillons, TSL ou RVB depuis le dialogue Couleur pour définir les propriétés des couleurs.

Utiliser les modèles Échantillons, TSL ou RVB du dialogue Couleurs pour définir les propriétés des couleurs.

Les modifications sont sauvées quand le bouton OK est cliqué. Annuler ne prend pas en compte les changements. Le bouton Reset remet les couleurs aux valeurs par défaut.

Échantillons

Affiche une palette de couleurs contenant une variété de couleurs parmi le spectre des couleurs et les ombres. Sélectionner une couleur.

TSL

Teinte, Saturation et Luminosité vous permettent de spécifier une couleur en la décrivant à l'aide de la teinte, la saturation et la luminosité.

RVB

Rouge, Vert et Bleu (RVB) vous permet de spécifier une couleur à l'aide des trios de nombres pour le rouge, le vert et le bleu.

Aperçu

Affiche les propriétés des couleurs du signe courant et les résultats de la personnalisation.