Les rédacteurs techniques doivent fréquemment actualiser leurs documentations, manuels d’utilisation ou sites web pour les partager avec les collègues ou les fournir aux utilisateurs. Ce processus peut être long et nécessite une attention particulière pour s’assurer que la version souhaitée est régulièrement mise à jour. Heureusement, l’outil de création d’aide HelpNDoc peut être configuré pour que la génération programmée de la documentation soit automatique. Voyons comment le faire.

Utilisation de l’interface en ligne de commande de HelpNDoc

Depuis une invite de commande ou PowerShell, il est possible d’automatiser le processus de génération de documentation de HelpNDoc, pour obtenir tout format pris en charge par l’outil de création d’aide.

Interface en ligne de commande HelpNDoc

HelpNDoc intègre une puissante interface en ligne de commande pouvant servir à générer n’importe quel format de documentation pris en charge, sans aucune intervention de l’utilisateur. Par exemple, la ligne de commande suivante génère toutes les constructions paramétrées et activées dans un projet nommé MyProject.hnd :

hnd6.exe MyProject.hnd build

La ligne de commande build offre diverses options pour décider du format de documentation à générer, spécifier les balises à affecter, remplacer les variables, etc. La ligne de commande suivante, par exemple, ne génèrera que les chapitres indiqués comme Complet (prêt pour un usage public) du format de documentation HTML :

hnd6.exe MyProject.hnd build -only="Build HTML documentation" -statuses="Build HTML documentation:Complete"

Vous pouvez consulter la documentation HelpNDoc sur les lignes de commande pour découvrir toutes les options disponibles et utiliser les lignes de commande adaptées à vos besoins spécifiques. Une fois cette étape achevée, nous pouvons continuer et programmer une tâche de génération de documentation.

Automatisation de la génération de la documentation

Une fois la ligne de commande souhaitée définie, nous pouvons créer une tâche planifiée afin de l’exécuter périodiquement et de nous assurer que la documentation générée reste en permanence à jour.

planificateur de tâches Windows

Il existe de nombreux outils d’“intégration continue” ou systèmes de compilation disponibles pour exécuter des lignes de commande programmées ou provoquées. Nous utiliserons le “Planificateur de tâches” de Windows pour produire quotidiennement une nouvelle version de la documentation HTML, par exemple. Voyons ici comment le faire :

  • Cliquez sur le logo Windows dans la barre des tâches.
  • Saisissez “Planificateur de tâches” et cliquez dessus pour exécuter le programme.
  • Dans le menu “Action”, cliquez sur “Créer une tâche de base…”.
  • Spécifiez un “Nom”, et éventuellement une “Description”, puis cliquez sur “Suivant”.
  • Sélectionnez le “Déclencheur” souhaité (quotidien, par exemple), ensuite cliquez sur “Suivant”.
  • Personnalisez les options du déclencheur, comme l’heure de démarrage, et cliquez sur “Suivant”.
  • Sélectionnez l’action “Démarrer un programme” et cliquez sur “Suivant”.
  • Indiquez le chemin d’accès complet vers HelpNDoc dans le champ “Programme/script”. C’est habituellement : "C:\Program Files (x86)\IBE Software\HelpNDoc 6\hnd6.exe"
  • Dans le champ “Ajouter des arguments “, entrez le reste de la ligne de commande définie précédemment. Par exemple :
    MyProject.hnd -verysilent build -only="Build HTML documentation" -statuses="Build HTML documentation:Complete"
    Note : L’argument en ligne de commande -verysilent a été ajouté pour éviter d’afficher une invite de commande lorsque HelpNDoc fonctionne.
  • Saisissez le chemin d’accès complet du fichier de votre projet HelpNDoc dans le champ “Commencer dans”. Par exemple C:\Documentation\. Cliquez sur “Suivant”.
  • Vérifiez, cliquez sur “Terminer” et c’est fait ! La tâche de génération de la documentation est planifiée.

Avec l’interface en ligne de commande intégrée de HelpNDoc, le Planificateur de tâches Windows (ou tout autre système de traitement automatisé) peut être utilisé pour, facilement et rapidement, automatiser la génération de la documentation. Cela peut aider les rédacteurs techniques à gagner beaucoup de temps et d’efforts, afin de fournir une documentation à jour aux utilisateurs et aux collaborateurs.

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