Éditeur DITAVAL ditaval-editor
Les fichiers DITAVAL sont utilisés pour générer une sortie conditionnelle. Dans une seule rubrique, vous pouvez ajouter des conditions à l’aide d’attributs d’élément pour conditionner le contenu. Ensuite, vous créez un fichier DITAVAL dans lequel vous spécifiez les conditions qui doivent être sélectionnées pour générer du contenu et quelle condition doit être exclue de la sortie finale.
Adobe Experience Manager Guides vous permet de créer et modifier facilement des fichiers DITAVAL à l'aide de l'éditeur DITAVAL. L'éditeur DITAVAL récupère les attributs (qui peuvent être utilisés comme conditions) définis dans votre système et vous pouvez les utiliser pour créer ou modifier des fichiers DITAVAL. Pour plus d’informations sur la création et la gestion des conditions dans Adobe Experience Manager, consultez la section Administration des balises de la documentation de Adobe Experience Manager.
Les sections suivantes présentent les options disponibles pour un fichier DITAVAL dans Experience Manager Guides.
Créer un fichier DITAVAL
Pour créer un fichier DITAVAL, procédez comme suit :
-
Dans le panneau Référentiel, sélectionnez l’icône Nouveau fichier puis sélectionnez Rubrique dans le menu déroulant.
Vous pouvez également accéder à cette option à partir de la page d'accueil Experience Manager Guides et du menu d'options d'un dossier dans la vue Référentiel.
-
La boîte de dialogue Nouvelle rubrique s'affiche.
-
Dans la boîte de dialogue Nouvelle rubrique, fournissez les détails suivants :
- Titre de la rubrique.
- (Facultatif)* Nom de fichier de la rubrique. Le nom du fichier est suggéré automatiquement en fonction du titre de la rubrique. Si votre administrateur a activé les noms de fichiers automatiques en fonction du paramètre UUID, vous ne verrez pas le champ Nom .
- Modèle sur lequel la rubrique sera basée. Pour un fichier DITAVAL, sélectionnez Ditaval dans la liste déroulante.
- Chemin d’accès où enregistrer le fichier de rubrique. Par défaut, le chemin du dossier actuellement sélectionné dans le référentiel s’affiche dans le champ Chemin .
-
Sélectionnez Créer.
La rubrique est créée au chemin d’accès spécifié. En outre, la rubrique est ouverte dans l’éditeur pour modification.
Modifier le fichier DITAVAL
Lorsque vous créez une rubrique DITAVAL, elle s’ouvre dans l’éditeur pour être modifiée. Pour modifier une rubrique DITAVAL existante, accédez au dossier ou à la carte où se trouve la rubrique DITAVAL, puis sélectionnez Modifier dans le menu Options.
L'éditeur DITAVAL vous permet d'effectuer plusieurs tâches répertoriées ci-dessous à l'aide des options de la barre d'outils de l'éditeur.
Options de la barre d’outils de l’éditeur
Menu déroulant
La liste déroulante Menu permet d’accéder aux actions de modification, Rechercher et remplacer, Historique des versions, Libellé de version, Fusionner, Créer une tâche de révision, Suivi des modifications et Balises.
Pour plus d’informations, voir Options de menu déroulant
Ajouter une prop
Ajoutez une seule propriété dans votre fichier DITAVAL.
La première liste déroulante répertorie les attributs DITA autorisés que vous pouvez utiliser dans le fichier DITAVAL.
La deuxième liste déroulante affiche les valeurs configurées pour l’attribut sélectionné. Ensuite, la liste déroulante suivante affiche les actions que vous pouvez configurer sur l’attribut sélectionné. Les valeurs autorisées dans le menu déroulant de l’action sont les suivantes : include, exclude, passthrough et flag. Pour plus d'informations sur ces valeurs, consultez la définition de l'élément prop dans la documentation OASIS DITA. Pour plus d’informations sur l’action des propriétés ajoutées dans les attributs, consultez Actions de la propriété.
Ajouter une Rev Prop
Pour ajouter un numéro de révision spécifique à une balise au format XML, vous pouvez utiliser l’option Ajouter une prop rev . Un attribut rev est ainsi ajouté à la balise, avec la valeur définie dans le champ Valeur ainsi que l’action sélectionnée pour la propriété. Cet attribut de révision peut être utilisé ultérieurement pour filtrer le contenu XML approprié en fonction du numéro de révision spécifié lors de la génération de la sortie.
Ajouter toutes les props
Si vous souhaitez ajouter d’un seul clic toutes les propriétés ou tous les attributs conditionnels définis dans votre système, utilisez la fonction Ajouter toutes les props . Les valeurs autorisées dans le menu déroulant de l’action sont les suivantes : include, exclude, passthrough et flag . Les détails de ces actions sont mentionnés ci-dessous.
Actions pour la propriété
Il existe principalement quatre actions disponibles pour une propriété donnée qui peuvent être utilisées. Elles sont répertoriées comme suit :
Inclure : permet d’inclure le contenu dans la sortie. Il s’agit du comportement par défaut, sauf indication contraire.
Exclure : permet d’exclure le contenu de la sortie (si toutes les valeurs de l’attribut particulier sont exclues).
Passthrough : permet d’inclure le contenu dans la sortie et de conserver la valeur d’attribut dans le flux de sortie pour un traitement ultérieur par un moteur d’exécution, par exemple le filtrage d’exécution en fonction des paramètres utilisateur individuels.
Ajouter des indicateurs : pour marquer le contenu dans la sortie, vous pouvez définir l’indicateur comme action pour l’attribut souhaité dans le fichier. Vous pouvez également appliquer différents styles d’indicateur à l’aide de la liste déroulante Style d’indicateur, comme illustré dans le fragment de code ci-dessous.
-
Couleur d’arrière-plan : sélectionnez la teinte, la saturation et le contraste dans la couleur d’arrière-plan. La valeur HEX correspondante sera automatiquement mise à jour en fonction de votre sélection. Vous pouvez également changer le format de l’espace colorimétrique à l’aide de la liste déroulante pour choisir entre HEX, RGB et HSB.
-
Couleur du texte : sélectionnez la teinte, la saturation et le contraste de la couleur du texte. La valeur HEX correspondante sera automatiquement mise à jour en fonction de votre sélection. Vous pouvez également changer le format de l’espace colorimétrique à l’aide de la liste déroulante pour choisir entre HEX, RGB et HSB.
-
Options de style : vous pouvez ajouter certaines options de style, telles que Gras, Italique, Souligné, Surligné, Double soulignement.
-
Indicateurs de début et de fin : vous pouvez insérer des images en tant qu’indicateurs de début et de fin à l’aide du bouton Ajouter un indicateur. Pour sélectionner des images, utilisez Parcourir Assets pour effectuer une sélection dans le référentiel Guides ou Ajouter un fichier pour les charger à partir de votre système local. De plus, vous pouvez spécifier un texte secondaire pour les images.
-
Conflit de style : résout les conflits qui se produisent lorsqu’un seul élément contient plusieurs propriétés avec différents styles d’indicateur. Dans ce cas, la valeur définie dans les propriétés de conflit de style est sélectionnée, agissant efficacement comme sélecteur de valeur par défaut pour les couleurs d’arrière-plan et de texte.
Informations sur la version et Enregistrer comme nouvelle version
La fonctionnalité Informations sur la version et Enregistrer en tant que nouvelle version combine le suivi des versions et l’enregistrement du contenu dans une seule fonctionnalité.
Pour plus d’informations, voir Enregistrer en tant que nouvelle version
Verrouiller/déverrouiller
Verrouille ou déverrouille le fichier courant. Le verrouillage d’un fichier vous donne un accès exclusif en écriture au fichier.
Pour plus d’informations, voir Verrouiller et déverrouiller le fichier
Enregistrer le contenu
Une fois le fichier DITAVAL modifié, sélectionnez Enregistrer dans la barre d'onglets.
Vues de l’éditeur DITAVAL
L’éditeur DITAVAL d’Adobe Experience Manager Guides prend en charge l’affichage des fichiers DITAVAL dans deux modes ou vues différents :
Auteur : Voici une vue standard Ce que vous voyez est ce que vous obtenez (WYSISYG) de l’éditeur DITAVAL. Vous pouvez ajouter ou supprimer des propriétés à l’aide de l’interface utilisateur simple, qui présente les propriétés, ses valeurs et les actions dans une liste déroulante. Dans la vue Auteur, vous avez la possibilité d’insérer une propriété individuelle et d’insérer toutes les propriétés en un seul clic.
Vous pouvez également trouver la version du fichier DITAVAL sur lequel vous travaillez actuellement en plaçant le pointeur de la souris sur le nom du fichier.
Source: La vue Source affiche le code XML sous-jacent qui constitue le fichier DITAVAL. Outre les modifications de texte standard effectuées dans cet affichage, un auteur peut également ajouter ou modifier des propriétés à l’aide du catalogue dynamique.
Pour appeler le catalogue dynamique, placez le curseur à la fin de toute définition de propriété et saisissez « < ». L’éditeur affiche une liste de tous les éléments XML valides que vous pouvez insérer à cet emplacement.
Utilisation des fichiers DITAVAL dans l’interface utilisateur d’Assets
Vous pouvez également créer un fichier DITAVAL à partir de l’interface utilisateur d’Assets. Les étapes de création d'une rubrique DITAVAL sont les suivantes :
-
Dans l’interface utilisateur d’Assets, accédez à l’emplacement où vous souhaitez créer le fichier DITAVAL.
-
Sélectionnez Créer > Rubrique DITA.
-
Sur la page Plan directeur, sélectionnez le modèle de fichier DITAVAL et sélectionnez Suivant.
-
Sur la page Propriétés, spécifiez les Titre et Nom pour le fichier DITAVAL.
note note NOTE Le nom est automatiquement suggéré en fonction du Titre de votre fichier. Si vous souhaitez spécifier manuellement le nom du fichier, assurez-vous que le Nom ne contient pas d'espaces, d'apostrophe ou de crochets et se termine par .ditaval. -
Sélectionnez Créer.
Le message Rubrique créée s’affiche.
Vous pouvez choisir d'ouvrir le fichier DITAVAL pour l'éditer dans l'éditeur DITAVAL ou d'enregistrer le fichier de rubrique dans le référentiel Adobe Experience Manager.
Pour modifier un fichier DITAVAL existant, procédez comme suit :
-
Dans l’interface utilisateur d’Assets, accédez au fichier DITAVAL à modifier.
-
Pour obtenir un verrou exclusif sur le fichier, sélectionnez le fichier et sélectionnez Extraire.
-
Sélectionnez le fichier et sélectionnez Modifier pour ouvrir le fichier dans l’éditeur DITAVAL d’Adobe Experience Manager Guides.