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.

Insérer une variable

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 :

  1. Dans l’onglet “Accueil” du ruban de HelpNDoc, dans le groupe “Bibliothèque”, cliquez sur “Ajouter un élément”
  2. Cliquez sur “Ajouter une variable”
  3. Saisissez un nom d’élément, tel que “Colour-Term”
  4. 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 :

Remplacement de variable dans la version
  1. Parcourez le guide étape par étape comment créer une nouvelle sortie de documentation à publier pour apprendre à créer une nouvelle construction
  2. Ensuite, accédez aux paramètres de constructions
  3. Remplacez la valeur de la variable “Colour-Term”
  4. 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...

Un rédacteur technique heureux d'utiliser HelpNDoc [happy] [Featured]
Obtenir le meilleur de HelpNDoc : Comment la fonctionnalité "Conserver les fichiers temporaires" peut-elle aider les rédacteurs techniques ?

Lorsque l’on travaille sur de la documentation technique, chaque outil et chaque fonctionnalité à notre disposition peut faire une grande différence en termes de productivité et d’efficacité. L’une de …

Lire la suite →
Conversion de l'ancienne version de WinHelp HLP en documentation moderne [converting] [Featured]
Revitalisez vos fichiers d'aide : Convertir les anciens fichiers WinHelp HLP en documentation moderne avec HelpNDoc

À une époque où l’information est consommée sur une pléthore d’appareils et de plateformes, les fichiers WinHelp HLP classiques - autrefois la norme en matière de documentation d’aide basée sur …

Lire la suite →
HelpNDoc vs WordPress [versus] [Featured]
Maîtriser la publication multicanal : pourquoi HelpNDoc laisse WordPress dans la poussière

Dans le monde numérique interconnecté d’aujourd’hui, le concept de publication multicanal est devenu plus critique que jamais. Alors que le public recherche des informations sur différentes …

Lire la suite →
Boîte de dialogue Générer la documentation de HelpNDoc [generate] [Featured]
Donner du pouvoir aux rédacteurs techniques : Exploiter les fonctionnalités de remplacement de HelpNDoc pour des variations de documentation illimitées

Dans le paysage en constante évolution de la rédaction technique, le besoin de flexibilité, de personnalisation et d’efficacité est plus crucial que jamais. En tant que rédacteurs techniques, nous …

Lire la suite →

Catégories: articles