Lors de la réalisation d’un fichier d’aide, manuel d’utilisation ou livre électronique, il est non seulement important de fournir des traductions en fonction du public cible, mais aussi d’utiliser les mots appropriés en fonction des langues des lecteurs. Prenons le mot “couleur” comme exemple : “color” est l’orthographe appropriée pour l’Anglais Américain tandis que “colour” l’est dans toutes les autres variantes principales de l’Anglais. En tant que rédacteur technique, la prise en charge de plusieurs variantes de langage peut occasionner des complications et du travail additionnel afin que la documentation entière soit exempte d’erreurs. Heureusement, l’outil de création d’aide HelpNDoc rend cette tâche simple et rapide grâce aux espace réservés variables et à son puissant système de version.
Utilisation des espaces réservés variables
Les espaces réservés variables sont stockés et gérés depuis la bibliothèque du projet. Ils peuvent être ré-utilisés dans n’importe quel chapitre et leur valeur actuelle sera utilisée pour générer la documentation finale.
Tout d’abord, créons un nouvel espace réservé variable dans la bibliothèque de notre projet. C’est très facile :
- Dans l’onglet “Accueil” du ruban de HelpNDoc, dans le groupe “Bibliothèque”, cliquez sur “Ajouter un élément”
- Cliquez sur “Ajouter une variable”
- Saisissez un nom d’élément, tel que “Colour-Term”
- Saisissez la valeur par défaut de l’élément, telle que “colour”
Nous pouvons maintenant insérer cet espace réservé variable dans n’importe quel chapitre, au besoin. Il y a plusieurs façons de le faire :
- Sélectionnez l’élément dans la bibliothèque et placez le curseur à l’endroit où il doit être inséré dans le chapitre. Dans l’onglet “Accueil” du ruban, dans le groupe “Bibliothèque”, cliquez sur “Insérer dans le chapitre”
- Placez le curseur à l’endroit où il doit être inséré dans le chapitre, faites un clic-droit avec la souris sur l’élément de la bibliothèque dans le panneau Bibliothèque, puis cliquez sur “Insérer dans le chapitre”
- La façon la plus rapide : Tout en saisissant du texte dans l’éditeur de chapitre, commencez par taper un point d’exclamation “!” et appuyez sur le raccourci clavier CTRL + ESPACE, continuez par renseigner le nom de la variable “Colour-Term” et appuyez sur entrée lorsqu’elle est sélectionnée pour l’insérer dans le chapitre
Générer plusieurs variantes de documentation
Une fois la documentation écrite, le puissant système de version de HelpNDoc peut générer plusieurs formats et variantes pour différents publics cible.
Nous pouvons maintenant produire les fichiers de documentation pour les utilisateurs finaux. HelpNDoc peut produire plusieurs formats de documentation, dont les fichiers d’aide CHM, les sites Web HTML réactifs, les documents Word et PDF, les livres électroniques EPUB et Kindle et les fichiers d’aide Qt. Il peut également produire de multiples variations de ces formats de documentation grâce à son puissant système de version.
Créons deux versions HTML pour différentes orthographes Anglaises et remplaçons notre variable :
- Parcourez le guide étape par étape comment créer une nouvelle sortie de documentation à publier pour apprendre à créer une nouvelle construction
- Ensuite, accédez aux paramètres de constructions
- Remplacez la valeur de la variable “Colour-Term”
- Générez la documentation
HelpNDoc créera automatiquement deux variantes de la documentation, une utilisera le terme approprié pour l’Anglais Américain et l’autre ciblera toutes les autres variantes d’Anglais.
Aller plus loin avec la ligne de commande
Une fois les versions définies et activées, HelpNDoc les générera automatiquement à la demande. Mais, ce n’est pas la seule façon de remplacer les variables.
Une alternative à la création d’une version pour chaque variation est d’exploiter la prise en charge de ligne de commande étendue de HelpNDoc : la commande build peut être utilisée avec l’argument -v pour remplacer une variable. C’est particulièrement utile dans un système de construction automatisé et un témoignage de polyvalence de HelpNDoc :
hnd5.exe project.hnd build -v=“Colour-Term:color”
HelpNDoc inclut davantage de fonctionnalités pour simplifier et accélérer le processus de rédaction d’excellents fichiers d’aide, manuels d’utilisation ou livres électroniques. Téléchargez de ce pas votre copie gratuite pour commencer !
Voir aussi
- Combler le fossé entre les enseignants et les élèves : Exploiter la puissance des outils d'aide à la rédaction pour une création de contenu engageante
- Comment les rédacteurs techniques peuvent inclure du code PHP dans leur documentation en ligne
- Comment créer un fichier d'aide CHM : utilisez un logiciel moderne de création d'aide au lieu du dépassé HTML Help Workshop
- Pourquoi préférer un outil de création d'aide à Microsoft Word pour produire une documentation de qualité ?
- Comment configurer et mettre à jour les propriétés des images à travers vos projets de documentation