.. Copyright 2011-2018 Olivier Carrère
.. Cette œuvre est mise à disposition selon les termes de la licence Creative
.. Commons Attribution - Pas d'utilisation commerciale - Partage dans les mêmes
.. conditions 4.0 international.
.. code review: yes
.. _creer-des-documents-differents-a-partir-des-memes-sources-dita-xml-texte-conditionnel:
Créer des documents différents à partir des mêmes sources DITA XML (texte conditionnel)
=======================================================================================
|dita| offre un mécanisme de texte conditionnel. Ce mécanisme favorise la
réutilisation du contenu source et évite la redondance des informations. Ce
didacticiel aidera le |techwriter| à utiliser ce mécanisme en
quelques minutes.
.. rubric:: Prérequis
- Vous avez installé |dita-ot| dans le répertoire :file:`DITA-OT1.5.4` sous
GNU/Linux ou Windows.
#. Collez le code suivant dans un fichier et enregistrez ce dernier sous le nom
de :file:`texte-conditionnel.dita` dans le répertoire :file:`DITA-OT1.5.4` :
.. code-block:: xml
Utilisation du texte conditionnel
Danger pour les électriciens
Risque d'électrocution
Ne touchez pas les fils électriques.
Danger pour les plombiers
Risque de noyade
Ne plongez pas dans la piscine.
Tout contenu placé entre balises ne comportant pas de
valeur audience exclue dans un fichier
.ditaval est publié dans les documents
destinés aux plombiers et aux électriciens.
Ce code contient des balises |dita| contenant des valeurs *audience*
différentes : nous allons exclure le contenu d'une de ces deux balises lors
de la génération du fichier cible en utilisant la clé *audience*.
#. Collez le code suivant dans un fichier et enregistrez ce dernier sous le nom
de :file:`texte-conditionnel.ditamap` dans le répertoire
:file:`DITA-OT1.5.4` :
.. code-block:: xml
Exemple de texte conditionnel
#. Collez le code suivant dans un fichier et enregistrez ce dernier sous le nom
de :file:`electriciens.ditaval` dans le répertoire :file:`DITA-OT1.5.4` :
.. code-block:: xml
#. Collez le code suivant dans un fichier et enregistrez ce dernier sous le nom
de :file:`plombiers.ditaval` dans le répertoire :file:`DITA-OT1.5.4` :
.. code-block:: xml
#. Ouvrez un terminal et entrez la commande suivante dans le répertoire
:file:`DITA-OT1.5.4` :
.. code-block:: console
$ java -jar lib/dost.jar /i:texte-conditionnel.ditamap \
/filter:electriciens.ditaval /outdir:. /transtype:pdf2
Ouvrez le fichier :file:`texte-conditionnel.pdf` ; il contient des
informations destinées :
- aux plombiers et aux électriciens,
- uniquement aux électriciens.
#. Ouvrez un terminal et entrez la commande suivante dans le répertoire
:file:`DITA-OT1.5.4` :
.. code-block:: console
$ java -jar lib/dost.jar /i:texte-conditionnel.ditamap \
/filter:plombiers.ditaval /outdir:. /transtype:pdf2
Ouvrez le fichier :file:`texte-conditionnel.pdf` ; il contient des
informations destinées :
- aux plombiers et aux électriciens,
- uniquement aux plombiers.
.. seealso::
- :ref:`creer-des-documents-differents-a-partir-des-memes-sources-restructuredtext-rest-texte-conditionnel`
- :ref:`creer-des-documents-differents-a-partir-des-memes-sources-restructuredtext-jinja-texte-conditionnel`
- :ref:`creer-des-documents-differents-a-partir-des-memes-sources-restructuredtext-jinja-objet-texte-conditionnel`
.. text review: yes