Adobe FrameMaker User Guide
Cliquer ici pour voir cette page dans le contexte complet
Familiarisez-vous avec les fichiers DITAVAL et apprenez à les utiliser pour générer une sortie conditionnelle dans FrameMaker.
Dans FrameMaker, un fichier DITAVAL permet de générer une sortie conditionnelle. Écrivez un document unique avec du contenu conditionnel (en utilisant des attributs d’élément).
Créez ensuite un fichier DITAVAL dans lequel vous spécifiez le contenu afin de créer plusieurs versions de sorties du document selon les attributs appliqués.
Apprenez à configurer des rubriques DITA pour utiliser les fichiers DITAVAL et à appliquer des attributs conditionnels à des éléments.
Vous pouvez rendre des éléments d’un document DITA conditionnels en appliquant des attributs de condition aux éléments. Définissez ensuite dans un fichier DITAVAL les éléments à exclure ou inclure de la sortie en fonction des attributs de condition.
Avant de créer des documents avec un contenu conditionnel, vous devez d’abord prévoir les critères pour la sortie. Par exemple, supposons qu’un document possède un contenu destiné conditionnellement à des administrateurs et à des utilisateurs finaux. Dans le document, appliquez les attributs de condition selon le public cible du contenu (voir Application d’attributs de condition à des éléments). Ensuite, créez un fichier DITAVAL dans lequel vous spécifiez les éléments à inclure et à exclure selon la valeur d’attribut définie dans le document. Voir Création d’un fichier DITAVAL pour créer une sortie conditionnelle.
Pour autoriser FrameMaker à traiter conditionnellement des éléments dans un document DITA, vous devez spécifier les éléments à inclure ou exclure pour la sortie. Dans le document, appliquez un ou plusieurs des attributs conditionnels suivants aux éléments que vous devez traiter conditionnellement :
Exemple : administrateurs, auteurs ou utilisateurs finaux.
Exemple : Windows, Mac ou Linux
Exemple : FrameMaker, RoboHelp ou Captivate.
Utilisez cet attribut pour définir toute autre propriété que vous devez utiliser pour activer un traitement conditionnel pour le document, par exemple :
Exemple : Impression, PDF ou Web
Exemple : coupé, berline ou break
Vous pouvez appliquer plusieurs attributs à un élément. Par exemple, vous pouvez appliquer les attributs @audience="administrateur" et @platform="windows" à un élément. Vous pouvez également ajouter plusieurs valeurs (chacune séparée par un espace) à un attribut unique. Par exemple, vous pouvez définir@platform="windows linux" pour le contenu ciblé pour Windows et Linux.
Sélectionnez un élément dans la Vue de la structure du document.
Ouvrez le panneau Attributs ().
Mise à jour d’un ou plusieurs des attributs suivants :
audience
platform
product
otherprops
Spécifiez la condition ci-dessus pour chaque élément du document qui doit être traité conditionnellement.
Après avoir appliqué les attributs aux éléments spécifiques du document, sortez conditionnellement le contenu dans votre document selon le mode de configuration de votre fichier DITAVAL.
Après avoir configuré votre contenu à l’aide des attributs de condition (audience, platform, product et otherprops) pour définir les éléments que FrameMaker traite de manière conditionnelle pour la sortie, vous devez créer un fichier DITAVAL. Dans un fichier DITAVAL, définissez selon une paire <nom d’attribut> – <valeur> le traitement conditionnel de votre document. Par exemple, vous pouvez spécifier que le contenu destiné aux administrateurs doit être exclu du contenu de sortie destiné aux utilisateurs finaux ou aux auteurs.
Ouvrez la boîte de dialogue Nouveau XML ().
Dans la section Applications structurées, sélectionnez DITA_<version>_DITAVAL, puis cliquez sur OK.
L’élément supérieur d’un fichier DITAVAL est l’élément <val>.
Pour définir des conditions, vous devez créer des éléments <prop>.
Ajoutez un ou plusieurs éléments <prop> :
cliquez deux fois sur l’élément <propo> dans le panneau Elément ().
Ou appuyez sur Ctrl+1 pour afficher le Catalogue dynamique , sélectionnez prop puis appuyez sur Entrée.
Dans la boîte de dialogue Attributs du nouvel élément, spécifiez les attributs suivants :
@actionChoisissez d’inclure ou d’exclure l’attribut spécifié (@att, ci-dessous) de la sortie.
@attLe nom de l’attribut de condition a été appliqué à l’élément dans votre document.
Entrez le nom d’attribut exactement tel qu’il est défini dans l’élément du document.
@valLa valeur de l’attribut de condition (@att) telle que définie dans l’élément.
Entrez la valeur exactement comme vous la spécifiez pour l’attribut dans l’élément.
Par exemple, imaginons que vous appliquiez l’attribut @audience à un élément pour une sortie conditionnelle et que vous définissiez la valeur sur admin. Vous devez saisir audience dans le champ @attr pour l’élément prop dans le fichier DITAVAL. En outre, vous devez entrer admin dans le champ @val. Pour exclure l’élément avec l’attribut audience défini sur admin@, spécifiez l’action sur exclude.
Cliquez sur Insérer un élément, puis enregistrez le fichier DITAVAL.
Enregistrez le document avec l’extension .ditaval.
Apprenez à générer une sortie conditionnelle pour des rubriques DITA dans FrameMaker.
Cette section décrit, avec un exemple de cas d’utilisation, les étapes permettant de générer une sortie PDF contenant un contenu conditionnel.
Créez une rubrique DITA avec quatre éléments de paragraphe (<p>) :
Contenu destiné UNIQUEMENT à des administrateurs.
@Définissez l’attribut audience à admin.
Contenu destiné UNIQUEMENT aux auteurs.
@Définissez l’attribut audience à author.
Contenu pour les administrateurs et les auteurs
Définissez l’attribut @audience sur admin author.
Contenu destiné aux utilisateurs finaux et aux auteurs.
@Définissez l’attribut audience à end_user author.
Enregistrez le document.
Créez un fichier DITAVAL avec quatre éléments prop :
@attr: audience
@val: admin
@action: include
@attr:audience
@val:author
@action: exclude
@attr:audience
@val:end_user
@action: exclude
Le fichier DITAVAL ci-dessus fournira une sortie reprenant tous les contenus destinés aux administrateurs.
Créez un mappage DITA et incluez le document ci-dessus, puis enregistrez le mappage DITA en tant que PDF ().
Dans la boîte de dialogue Enregistrer le document, sélectionnez l’option Demander le fichier DitaVal et cliquez sur Enregistrer.
La boîte de dialogue Choisir le fichier DitaVal s’affiche.
Sélectionnez le fichier DITAVAL créé à l’étape 4, puis cliquez sur Sélectionner.
L’option Appliquer comme condition génère l’intégralité du contenu. Cependant, le contenu marqué comme exclu dans le fichier DITAVAL sort barré. Sélectionnez cette option pour la révision du document. Par exemple, cette option permet d’indiquer à un réviseur le contenu étant marqué comme exclu.
Dans la boîte de dialogue Configuration PDF, cliquez sur Définir.
Le fichier PDF de sortie inclut et exclut un contenu selon les attributs configurés dans le document et le fichier DITAVAL correspondant.