Aller au contenu principal

Guide de style DITA - Bonnes pratiques pour les rédacteurs Bonnes pratiques pour les rédacteurs

Introduction
Types d'information et rubriques
Les cartes DITA
Syntaxe et balisage
Langue et ponctuation
Graphiques et images
Références croisées
Réutilisation de contenu
Métadonnées, traitement conditionnel et indexation
Le processus de documentation DITA
Principes de rédaction DITA

Accueil
Réutilisation de contenu
Variables

Réutilisation de contenu
- Définition de la réutilisation de contenu
  La réutilisation de contenu permet d'améliorer l'efficacité en éliminant les répétitions d'expressions, de blocs de texte, de rubriques et même de collections de rubriques.
- Réutilisation et modèle de maturité DITA
  La réutilisation de contenu est l'une des fonctions que vous devez adopter rapidement au cours de votre passage de la rédaction basée sur le style vers la rédaction structurée avec DITA.
- L'attribut de référencement de contenu : conref
  La fonctionnalité conref permet d'utiliser du contenu DITA à plusieurs emplacements au sein d'une même collection. L'attribut conref d'une rubrique cible indique la rubrique source et la portion de cette rubrique à réutiliser.
- Pratiques de la réutilisation de contenu
- Variables
  - Variables en utilisant l'attribut conref et le filtrage
    La publication à partir d'une source unique (single-sourcing) repose largement sur le concept de variables. Bien que DITA n'ait pas de fonction nommée précisément variable, le standard supporte des fonctionnalités pour gérer des variables.
  - Variables utilisant l'indirection
    L'élément keyword peut être utilisé en tant que conteneur pour les mots ou les phrases variables, lorsqu'il est utilisé conjointement avec l'élément keydef dans la carte DITA. Au lieu d'entrer la valeur du mot-clé directement dans l'élément, il vous est possible de le référencer indirectement par l'intermédiaire d'une clé.
  - Utiliser des entités internes comme variables
    Les entités internes sont des fonctions XML permettant de créer des raccourcis. Elles sont à éviter en rédaction DITA.
- Organiser les rubriques et les éléments réutilisables
- Rubriques et cartes imbriquées
  La carte DITA est un outil puissant permettant de réutiliser des rubriques dans différentes publications. Les rubriques peuvent également être réutilisées en utilisant des rubriques ditabase, mais il est préférable d'éviter cette technique.
- Principes avancés de référencement de contenu

Variables

Les variables sont souvent des expressions (telles que des noms de produits) qui sont réutilisées en remplaçant la valeur de la variable au moment où l'information est publiée.

Traduction du DITA Style Guide - Best Practices for Authors (Tony Self) www.ditastyle.com.

Hébergé par IXIASOFT. Généré par <oXygen/> XML WebHelp.