Conditions et contenu conditionnel
L’utilisation de contenu conditionnel est une technique puissante qui soutient la réutilisation du contenu. Elle permet de réutiliser les mêmes objets dans diverses publications et divers contextes plutôt que de les restreindre à une publication et à un contexte précis. Appliquez des conditions au contenu spécifique au contexte pour n’afficher le contenu que lorsque les conditions sont remplies, tel que défini dans le contexte de la publication.
Que sont les conditions?
Dans le cadre de la gestion du contenu, le terme contenu conditionnel désigne le contenu inclus dans la sortie uniquement lorsque des critères spécifiques, les conditions, sont remplis. Une condition est une règle qui définit les critères de sélection pour déterminer le contenu à afficher. La construction de la règle de base consiste en un nom de condition associé à une valeur de condition.
Par exemple, vous pouvez utiliser une condition « public » pour qualifier le contenu comme étant destiné uniquement à un certain type d’utilisateur ou à une condition de « format » pour désigner le contenu qui n’est pertinent qu’à un certain format de sortie. Les paires de noms-valeurs correspondantes peuvent être audience=beginner et format=online.
DITA vs Tridion Docs
En règle générale, dans DITA, vous rendez le contenu conditionnel en utilisant les attributs de profilage DITA, comme @product, @platform et @audience, et peut-être un fichier ditaval pour préciser les attributs à afficher ou non. Vous pouvez définir des conditions sur des éléments XML individuels en définissant une valeur pour l’attribut de @ishcondition de l’élément.
Définition des noms et des valeurs des conditions
Ajout de conditions au contenu
Vous pouvez définir des conditions sur des éléments XML individuels en définissant une valeur pour l’attribut de @ishcondition de l’élément. Dans un même attribut @ishcondition, la valeur peut être une simple paire de noms-valeurs, ou une expression complexe.
- les éléments individuels d’une rubrique, soit le niveau le plus bas
- toutes les rubriques d’un mappage
- les mappages entiers d’un mappage parent, soit le niveau le plus élevé
Établir le contexte de publication
Pour chaque publication où des conditions sont utilisées, vous devez définir le contexte de publication, c’est-à-dire un ensemble de règles que vous construisez en sélectionnant des conditions et des valeurs. Le contexte détermine le contenu conditionnel à afficher dans cette publication par rapport au contenu à masquer.
Vous pouvez définir le contexte dans l’application Publication Manager.
En fonction du contexte, Tridion Docs applique un traitement conditionnel pour transformer le contenu chaque fois qu’un utilisateur consulte des rubriques ou des mappages dans Publication Manager, affiche la publication dans Collective Spaces ou publie le contenu vers l’une des sorties définies.
Affichage du contenu conditionnel
La liste suivante décrit le comment le contenu conditionnel s’affiche lorsque vous utilisez l’un des outils de création :
- Publication Manager
-
Lorsque vous sélectionnez une rubrique dans l’onglet Contenu et que vous l’affichez dans le volet de prévisualisation, l’ensemble du texte conditionnel de la rubrique s’affichera (rien n’est masqué), mais la mise en surbrillance indiquera s’il sera affiché ou masqué dans la sortie publiée.
L’aperçu utilise la mise en surbrillance suivante pour le texte conditionnel :- Arrière-plan vert : le texte est inclus lorsque vous publiez la publication.
- Arrière-plan rouge : le texte est exclu lorsque vous publiez la publication.
- Outil de création XML
-
Les différentes applications de création prennent en charge le contenu conditionnel DITA de différentes façons. Reportez-vous à la documentation du produit que vous utilisez.
- Draft Space
-
Dans Draft Space, les conditions sont présentées dans la vue Plan et dans la vue Document. Les titres des objets de la vue Plan qui sont conditionnés hors de la publication sont traversés d’une barre, signalant qu’il s’agit d’une objet exclu.
Les objets qui sont conditionnés hors de la publication sont également marqués d’un X rouge et d’une étiquette « exclus » dans la vue Document.
- Review Space
- Dans Review Space, les objets qui sont conditionnés hors de la publication ne sont pas rendus dans les vues Plan et Document dans Review Space.
Filtrage pendant la publication
Avant qu’une publication ne soit rendue dans la sortie souhaitée, le contenu qui ne correspond pas au contexte est filtré. Cela vous permet de générer des sorties différentes d’une même publication, en spécifiant différents contextes lorsque vous publiez.