Une fois que vous avez rédigé votre fichier d’aide ou votre site web de documentation, vous souhaitez généralement être en mesure de l’intégrer avec vos produits existants: lorsque les utilisateurs ont des difficultés à réaliser une action quelconque, ils doivent pouvoir lancer le fichier d’aide; et le bon chapitre expliquant cette action spécifique doit leur être présenté. À cet effet, les Outils de Création d’Aide comme HelpNDoc fournissent deux identifiants uniques pour chaque chapitre: un ID d’Aide alphanumérique et un numéro de Contexte d’Aide. Cela permet d’atteindre un chapitre spécifique depuis votre application logicielle ou votre site web. Mais en tant que rédacteur technique, vous ne serez probablement pas chargé de “lier” cette application ou ce site web avec le fichier d’aide et vous enverrez plutôt une liste d’identifiants de chapitre aux développeurs responsables. Grâce au très puissant éditeur de script, d’HelpNDoc vous pouvez le faire très facilement!
Utiliser l’API d’HelpNDoc pour automatiser ce travail
HelpNDoc inclut une API très puissante qui peut être utilisée depuis l’Éditeur de Script pour maintenir et automatiser vos projets. Nous allons l’utiliser pour créer un fichier avec une liste d’identifiants de chapitre.
Une fois votre projet ouvert, vous pouvez accéder à l’Éditeur de Script d’HelpNDoc depuis l’onglet de ruban “Outils”. L’Éditeur de script sera utilisé pour saisir et exécuter du code basé sur le langage pascal pour automatiser la génération d’un fichier texte contenant une liste de légendes de chapitres ainsi que les ID d’Aide et les numéros de Contexte d’Aide qui leurs sont associés.
Si vous n’êtes pas développeur, pas d’inquiétude: copiez et collez simplement le script qui suit, puis cliquez sur “Exécuter le script” dans l’éditeur de script d’HelpNDoc pour générer automatiquement ce fichier texte.
const
// Define the output file
OUTPUT_FILE = 'c:\tmp\topics.txt';
var
// Current topic ID
aTopicId: string;
var
// List of output
aList: TStringList;
begin
// Init list
aList := TStringList.Create;
aList.Add('Topic Caption | Help ID | Help Context');
aList.Add('--------------------------------------');
try
// Get first topic
aTopicId := HndTopics.GetTopicFirst();
// Loop through all topics
while aTopicId <> '' do
begin
// Add the topic to the list
aList.Add(Format('%s | %s | %d', [
HndTopics.GetTopicCaption(aTopicId),
HndTopics.GetTopicHelpId(aTopicId),
HndTopics.GetTopicHelpContext(aTopicId)
]));
// Get next topic
aTopicId := HndTopics.GetTopicNext(aTopicId);
end;
// Create the file
aList.SaveToFile(OUTPUT_FILE);
finally
aList.Free;
end;
end.
En lançant ce script, HelpNDoc va générer un fichier situé à l’emplacement “c:\tmp\topics.txt” (cela peut être personnalisé dans le script ci-dessus) avec une liste de tous les chapitres disponibles dans le projet actuel. Vous pouvez maintenant envoyer ce fichier à vos développeurs afin qu’ils puissent relier l’application ou le site web avec le fichier d’aide que vous êtes entrain de rédiger. De cette manière, vous n’aurez pas à faire le travail du développeur et le développeur n’aura pas besoin d’avoir accès à la structure du fichier d’aide. Voici un exemple de fichier texte généré:
Topic Caption | Help ID | Help Context
--------------------------------------
Introduction | Introduction | 0
Welcome | Welcome | 1
What's new | Whatsnew | 2
Getting Started | GettingStarted | 3
System requirements | Systemrequirements | 4
Getting help | Gettinghelp | 5
L’API d’HelpNDoc vous aidera à gagner du temps
Grâce à l’API et à l’éditeur de script très puissant d’HelpNDoc, vous serez en mesure de réaliser rapidement et facilement des choses qui sont impossible avec n’importe quel autre Outils de Création d’Aide: Automatiser la génération d’aide et de documentation, exporter des identifiants de chapitre, simplifier des tâches chronophages… les possibilités sont infinies! Alors jetez un œil à la liste énorme des méthodes d’API disponibles d’HelpNDoc et commencez à automatiser la rédaction de votre aide, documentation et livres électroniques dès maintenant.
Voir aussi...
Transformez votre salle de classe avec HelpNDoc : l'outil ultime de la rentrée pour les enseignants et les étudiants
À l’approche de la rentrée scolaire, les enseignants et les étudiants sont à la recherche d’outils susceptibles de simplifier la création de contenu, d’améliorer la collaboration et d’enrichir …
Lire la suite →Comment Personnaliser la Position et la Taille Initiales des Fichiers d'Aide CHM
Créer des fichiers CHM (Compiled HTML Help) avec HelpNDoc est un jeu d’enfant, grâce à son interface conviviale et à ses puissantes fonctionnalités. Dans cet article, nous examinerons comment vous …
Lire la suite →Équilibrer la sécurité et la facilité d'utilisation : Les meilleurs formats de documentation pour le partage interne
Le partage efficace et sécurisé de la documentation est essentiel sur le lieu de travail moderne. Que vous distribuiez des manuels internes, de la documentation sur des projets ou des directives …
Lire la suite →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 →