# Cas concrets d’utilisation de DITA XML

L'utilisation quotidienne du format de rédaction structurée DITA XML sur des projets multilingues en tant que rédacteur technique m'a amené à développer certaines solutions et astuces que je vous livre ici. Tout retour d'expérience est le bienvenu !

## La documentation de NuFirewall

Pour un exemple détaillé en situation réelle, voir le [cas concret : documentation de NuFirewall](https://docs.redaction-technique.org/fr/formats/nufirewall-case-study/), qui présente la réutilisation par conref et le texte conditionnel ditaval.

Documentation
: NuFirewall, un produit logiciel. Sa documentation, réalisée sous DITA XML, a été perçue par la presse comme un point fort du produit.

Techniques illustrées
: Le partage de blocs d’information avec les conref : les centraliser dans un fichier unique, utiliser le nœud XML de plus bas niveau, prendre en compte les contraintes de traduction, limiter leur imbrication et protéger les informations confidentielles. La fourniture d’une information ciblée avec le texte conditionnel ditaval.

À lire pour
: Voir comment ces choix de réutilisation et de filtrage ont été faits sur la documentation d’un produit réel.

- [**Cas concret : documentation de NuFirewall**](https://docs.redaction-technique.org/fr/formats/nufirewall-case-study/): Stratégies de conref et texte conditionnel ditaval, avec un schéma pour chaque choix.

## Solutions et astuces issues de projets multilingues

Les didacticiels DITA XML et XSL-FO rassemblent les procédures nées de cet usage quotidien, par exemple :

- **[Gérer les projets multilingues](https://docs.redaction-technique.org/fr/tutorials/dita-xml-xsl-fo-tutorials/#g%C3%A9rer-les-projets-de-documentation-multilingues-dita-xml).** Une méthodologie et un script Bash qui génèrent chaque version linguistique à partir d’un fichier ditamap unique.
- **[Texte conditionnel](https://docs.redaction-technique.org/fr/tutorials/dita-xml-xsl-fo-tutorials/#cr%C3%A9er-des-documents-diff%C3%A9rents-%C3%A0-partir-des-m%C3%AAmes-sources-dita-xml).** Des documents différents à partir des mêmes sources DITA XML, filtrés par des fichiers ditaval.
- **[Sortie PDF](https://docs.redaction-technique.org/fr/tutorials/dita-xml-xsl-fo-tutorials/#dita-open-toolkit--afficher-les-r%C3%A9f%C3%A9rences-crois%C3%A9es-dans-les-pdf).** Des réglages de DITA Open Toolkit et des feuilles de style XSL-FO, comme l’affichage des références croisées.

- [**Didacticiels DITA XML et XSL-FO**](https://docs.redaction-technique.org/fr/tutorials/dita-xml-xsl-fo-tutorials/): Tous les didacticiels, regroupés par tâche : publier un premier PDF, créer plusieurs documents à partir des mêmes sources, personnaliser la sortie PDF et éditer sous Emacs.

## Articles connexes

- [Du document à la base documentaire modulaire](https://docs.redaction-technique.org/fr/formats/modular-documentation/)
- [Une architecture documentaire trop complexe ?](https://docs.redaction-technique.org/fr/formats/document-architecture-complexity/)

---

Source: https://docs.redaction-technique.org/fr/formats/dita-xml-case-studies/