Grâce a la puissante fonctionnalité de génération conditionnelle et au système de construction de HelpNDoc, il est plus simple et rapide que jamais de produire de multiples variations d’une documentation maitresse. Imaginez l’écriture d’un fichier d’aide complet, d’un manuel, d’un livre ou d’une documentation, tout en choisissant les parties à inclure dans chaque produit fini: vous commencez à comprendre la puissance de cette fonctionnalité pour fournir différentes variations de votre documentation maitresse à divers clients, acheteurs, partenaires… Lisez ce qui suit pour en apprendre plus sur le système de génération conditionnel de HelpNDoc.

Créer une documentation de base et ajouter des conditions

Comme exemple, imaginons que nous écrivons une documentation pour un logiciel et que nous souhaitons fournir deux fichiers de documentation différents: l’un d’eux est destiné aux utilisateurs finaux tandis que l’autre est destiné à l’équipe de support et fournira d’avantage d’information tout au long de la documentation.

Commençons par créer un nouveau projet en ajoutant les chapitres et contenus initiaux. Nous allons maintenant définir une section conditionnelle, seulement visible par l’équipe de support, que nous appellerons la section “technique”.

Insérer une section conditionnelle
  • Placer le curseur dans l’éditeur de chapitre avant la partie technique de la documentation
  • Depuis l’onglet de ruban “Insérer”, cliquer sur “Section conditionnelle”
  • Assurez-vous que l’opération “Si” est sélectionnée et cliquer sur le lien “Gérer les balises” pour éditer les balises du projet
  • Dans la fenêtre nouvellement ouverte “Gérer les balises de construction”, ajouter une balise nommée “Technical” à la liste et cliquer sur OK
  • Dans la fenêtre “Insérer une opération conditionnelle”, cocher la balise “Technical” nouvellement ajoutée et cliquer sur OK

Pour fermer la section technique, il est possible d’ajouter une opération “FIN”: chaque opération “SI”, “SI NON” et “AUTREMENT” précédemment ouverte sera fermée et le contenu suivant l’opération “FIN” sera inclus dans chaque construction. Pour ce faire, placer le curseur après la section technique, cliquer sur “Section conditionnelle” dans l’onglet de ruban “Insérer”, choisir l’opération “Fin” et cliquer sur OK.

Exemple d'une section conditionnelle

Paramétrer les constructions pour générer de multiples variations

Nous allons créer deux constructions PDF: l’une d’elle sera distribuée aux utilisateurs finaux et ne contiendra pas les sections techniques alors que l’autre sera distribué à l’équipe de support et contiendra toutes les sections techniques.

Maintenant que le contenu est prêt, nous devons générer de multiples variations de la documentation finale. Pour ce faire, nous allons créer deux constructions PDF différentes.

Personnalisation des constructions pour inclure les sections conditionnelles
  • Depuis l’onglet de ruban “Accueil”, cliquer sur la partie haute du bouton “Générer l’aide”
  • Supprimer toutes les constructions existantes de la liste des constructions sauf “Construire la documentation PDF” en les sélectionnant une à une et en cliquant sur le bouton “Supprimer”
  • Ajouter une nouvelle construction PDF à la liste en cliquant sur le bouton “Ajouter”
  • Sélectionner la première construction et la renommer “PDF utilisateur finale”. De même pour la seconde construction et la renommer “PDF équipe support”
  • Sélectionner la construction “PDF équipe support” et cliquer sur le lien “Personnaliser” dans les “Paramètres des constructions” s’ils ne sont pas déjà visibles
  • Aller sur l’onglet “Balises inclues” et cocher la balise “Technical” pour cette construction: cela inclura toutes les sections techniques pour cette construction
  • Cliquer sur “Générer” et examinez les deux fichiers de documentation PDF générés
Différences entre les constructions PDF générées

En utilisant son système de génération conditionnelle unique, HelpNDoc est l’outil parfait pour fournir une multitude de variations d’une documentation, d’un manuel, d’un livre ou d’un fichier d’aide pour des audiences spécifiques. Comme nous l’avons vu dans cette présentation rapide, il est à la fois extrêmement simple mais étonnamment puissant de créer plusieurs versions d’une même documentation grâce à HelpNDoc. Mais ne nous croyez pas sur parole et téléchargez votre version gratuite de HelpNDoc dès maintenant pour l’essayer par vous même!

Voir aussi...

Illustration de l'analyseur de caractères de HelpNDoc [illustration] [Featured]
L'arme secrète des rédacteurs techniques : les avantages uniques de l'analyseur de caractères de HelpNDoc

HelpNDoc est une solution de choix pour les professionnels qui cherchent à créer une documentation de haute qualité, attrayante et conviviale. Cependant, ce n’est pas seulement son interface …

Lire la suite →
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 →

Catégories: articles