Apprenez à rechercher et à corriger des erreurs dans la structure d’un document avec Adobe FrameMaker.
Dans un enchaînement structuré, une erreur peut être un problème structurel, tel qu’un élément à emplacement non valide ou bien un attribut non valide, tel qu’un attribut dont la valeur obligatoire est manquante. Dans la Vue de la structure, lorsqu’un élément réduit contient un contenu non valide dans sa structure, le signe flèche situé sur la droite du nom de l’élément s’affiche en rouge.
Vous pouvez également valider un document pour rechercher les erreurs. Une fois que vous savez où ces erreurs se trouvent, utilisez le catalogue Eléments et la Vue de la structure pour vous aider à les corriger.
Si vous avez apporté des modifications au formatage du texte dans les éléments, il se peut que ceux-ci ne soient plus conformes à leurs règles de formatage.
Apprenez à rechercher et à corriger des erreurs dans la structure d’un document à l’aide de la Vue de la structure dans Adobe FrameMaker.
Lorsqu’un élément n’est pas conforme aux règles de contenu ni aux descriptions d’attributs dans les définitions d’éléments du document, la Vue de la structure identifie l’erreur à votre place.
Si un ou plusieurs éléments enfants requis par les définitions d’éléments sont manquants dans un élément, un carré rouge apparaît sur la ligne verticale où l’élément enfant devrait se trouver.
Si un élément se trouve à un emplacement non autorisé par les règles de contenu, la ligne verticale qui se trouve à côté est interrompue à partir de sa position et jusqu’à la fin de l’élément parent.
Si un élément n’est pas défini pour le document actif, sa bulle est de couleur rouge. Cela arrive parfois si vous l’avez collé depuis un autre document.
Si un attribut a une valeur non valide ou s’il n’est pas défini dans le document, un x de couleur rouge apparaît à gauche du nom de l’attribut et sa valeur est affichée en rouge.
Si un attribut n’a pas de valeur définie, aucune valeur
n’apparaît à droite de son nom. S’il doit obligatoirement avoir une valeur, aucune valeur
n’apparaît en rouge et un carré rouge apparaît à sa gauche.
Apprenez à valider un document et à corriger des erreurs dans la structure d’un document avec Adobe FrameMaker.
Lorsque FrameMaker valide un document, il recherche les éléments non conformes aux règles de contenu et d’attribut dans les définitions d’éléments du document. Si FrameMaker trouve une erreur, il sélectionne l’élément et donne une description de l’erreur.
Vous pouvez valider un document entier, l’enchaînement en cours ou bien l’élément actif. Si vous validez l’élément actif, FrameMaker ne vérifie pas ses éléments enfants. Par exemple, si vous validez l’élément <section>
ci-dessous, FrameMaker vérifie que l’élément <En-tête>
, les deux éléments <Para>
et l’élément <Liste>
sont valides, mais il ne vérifie par les éléments <Elément de liste>
dans <Liste>
.
Si le document contient du texte conditionnel, seules les versions affichées sont validées.
Vous pouvez également valider un livre entier comprenant tous les fichiers, seulement le fichier du livre ou bien seulement l’élément actif dans le fichier du livre.
Pour valider un document, procédez comme suit :
Sélectionnez Validation d’éléments s’affiche :
. La boîte de dialogueSélectionnez Document/livre entier, Eléments du livre seulement, Enchaînement en cours ou Elément en cours pour spécifier la portée de la validation.
Pour exclure des éléments ou des valeurs d’attributs de la recherche, sélectionnez Ignorer les éléments manquants ou Ignorer les valeurs d’attributs manquantes.
Si ces paramètres sont sélectionnés, FrameMaker ne recherche pas les emplacements où un élément enfant ou une valeur d’attribut obligatoires sont manquants. Vous pouvez envisager de les sélectionner si vous ne cherchez pas à construire un document complet pour le moment.
Cliquez sur Commencer validation.
FrameMaker commence la vérification à partir du début de l’élément en cours. Si vous ne validez que celui-ci, il vérifie l’élément contenant le point d’insertion ou l’élément sélectionné. Si vous avez sélectionné plusieurs éléments, il commence par le premier de la sélection.
Si FrameMaker rencontre une erreur, cliquez sur Commencer validation une nouvelle fois pour continuer.
La partie supérieure de la boîte de dialogue Validation de l’élément affiche le nom de l’élément et un court message relatif au problème.
Vous avez alors la possibilité de corriger l’erreur, de l’ignorer ou de cliquer sur Autoriser comme exception. Dans ce dernier cas, FrameMaker n’identifiera plus cette erreur lors de la prochaine validation du document.
Répétez l’étape 5 jusqu’à ce que FrameMaker ne détecte plus d’erreur.
Lorsque FrameMaker atteint la fin du document, il reprend à partir du début et poursuit la validation. Lorsque FrameMaker atteint la fin d’un enchaînement, il passe au suivant.
La validation des éléments d’une EDD inclut les attributs des clauses conditionnelles (if-then). Par exemple, supposons que les valeurs possibles d’un attribut soient A ou B ou C et qu’une règle contextuelle indique If [attrval = "D"]
. La condition est considérée comme une erreur et signalée comme étant une structure non valide lors de l’importation de définitions d’éléments.
De même, si les règles de formatage du texte ou de préfixe/suffixe d’un élément utilisent des noms d’attributs dans les spécifications de contexte, le nom d’attribut et la casse doivent correspondre à la définition de l’attribut dans la définition d’élément.
Si la valeur initiale d’un attribut est restaurée, l’action n’est pas signalée comme une modification. Ceci accroît les performances en évitant les vérifications de valeurs inutiles.
Sélectionnez
.Cliquez sur Effacer les exceptions. FrameMaker les efface alors du document, de l’enchaînement ou de l’élément, selon l’option que vous avez choisie dans la boîte de dialogue.
Découvrez les messages d’erreur de validation lors de la validation d’un document structuré avec Adobe FrameMaker.
Les messages d’erreurs suivants peuvent apparaître en haut de la boîte de dialogue Validation d’éléments dans Adobe FrameMaker.
L’enchaînement en cours ne comporte aucun élément.
L’élément en cours n’est pas défini dans le document. Il se peut que vous l’ayez copié depuis un autre document.
<élément>
Au moins un élément obligatoire est manquant avant l’élément spécifié.
Au moins un élément enfant est requis à la fin de l’élément actif.
Il n’y a pas de point d’insertion ou de sélection.
Ce message apparaît lorsque la portée de la validation définie est Elément en cours.
Il n’y a pas de point d’insertion ou de sélection.
Ce message apparaît lorsque la portée de la validation définie est Enchaînement en cours.
L’élément n’est pas autorisé au niveau supérieur du document.
L’élément contient du texte, mais cela n’est pas autorisé.
L’élément est autorisé à contenir du texte, mais pas dans cet emplacement.
@attribut
fait référence à une valeur ID non définie.L’attribut est une Référence ID et fait référence à une valeur d’ID unique inexistante dans le document (ou dans le livre, si vous validez un livre).
@attribut
n’est pas défini pour cet élément.La définition de cet élément ne comporte pas cet @attribut
.
L’élément est de type erroné ; le type peut être un graphique, un marqueur, une référence croisée, une équation ou une variable système. Par exemple, un élément de référence croisée est parfois du texte au lieu d’une référence croisée.
@attribut
La valeur de l’attribut est d’un type erroné.
@attribut
doit être comprise entre n et n.La valeur numérique de l’attribut est en dehors de la plage spécifiée.
@attribut
ne fait pas partie des choix autorisés.La valeur de l’attribut doit correspondre à une valeur figurant dans la liste déroulante affichant les choix valides.
Une valeur d’ID doit être unique pour tous les éléments du document ou du livre.
L’attribut ne doit pas avoir une valeur obligatoire.
<élément>
exclu dans cet élémentL’<élément>
n’est pas autorisé en raison d’une règle d’exclusion s’appliquant au parent ou à l’un de ses ancêtres.
<élément>
interdit dans cet élémentL’<élément>
n’est autorisé nulle part dans l’élément parent.
<élément>
non valide dans cet emplacementL’<élément>
est autorisé dans l’élément parent, mais pas dans l’emplacement en cours.
Apprenez à corriger les erreurs de validation XML avec Adobe FrameMaker.
Après avoir identifié les erreurs dans les éléments et les attributs, corrigez-les en vous aidant du catalogueEléments et de la Vue de la structure :
Pour corriger un élément se trouvant dans un emplacement non valide, placez l’élément dans un emplacement valide ou bien modifiez-le en élément valide pour son emplacement actuel.
Vous pouvez sélectionner un élément non valide dans la Vue de la structure. Si vous êtes en train d’effectuer une validation, FrameMaker sélectionne l’élément pour vous.
Une fois l’élément sélectionne, le catalogue Eléments affiche les éléments valides dans cet emplacement.
Pour corriger un élément dont le contenu n’est pas valide (contenant le fragment de texte CONTENU NON VALIDE
), définissez-le comme élément autorisant ce contenu.
Pour corriger une structure où un élément enfant est manquant, insérez l’élément requis.
Vous pouvez cliquer à l’endroit où un élément est manquant ou, si vous procédez à une validation, FrameMaker y place le point d’insertion pour vous. Lorsque le point d’insertion se trouve dans l’emplacement de l’élément manquant, le catalogue Eléments indique quels sont les éléments valides dans cet emplacement.
Pour corriger une valeur d’attribut non valide, remplacez la valeur par une valeur valide pour cet attribut.
Pour supprimer un attribut non défini, sélectionnez l’élément comportant l’attribut non défini, ouvrez la boîte de dialogue Attributs, sélectionnez l’attribut, et cliquez sur Supprimer l’attribut. Dans la boîte de dialogue suivante, retirez l’attribut de l’élément en cours ou de tous les éléments qui possèdent également l’attribut.
Pour résoudre une référence croisée possédant un ID non valide, sélectionnez la référence croisée, choisissez
, et remplacez-la par une source ayant un ID valide.