Création de fichiers d'aide CHM

Un fichier CHM, c'est en somme une collection de pages web compressées et regroupées dans un seul fichier — et il fait toujours figure de format d'aide incontournable pour les applications logicielles. À bien y réfléchir, sans fichier d'aide, votre application reste un simple outil, pas un produit abouti. La logique de votre programme vous paraît évidente, à vous qui l'avez écrite; pour un nouvel utilisateur, c'est une autre histoire. Le fichier CHM comble exactement ce fossé: vos utilisateurs comprennent ce qu'ils ont entre les mains et tirent vraiment parti de votre logiciel.

Impossible de faire plus simple pour doter votre application d'une aide contextuelle: la plupart des langages et environnements de développement modernes savent lier nativement vos composants logiciels à des fichiers CHM. Cette intégration s'appuie sur l'API HtmlHelp de Microsoft, qui permet à votre application d'ouvrir une rubrique d'aide précise ou de lancer une recherche directement depuis le programme.

Bonne nouvelle: aucun savoir-faire particulier n'est requis. Avec l'éditeur visuel WYSIWYG, votre premier fichier CHM voit le jour en quelques minutes. Rédigez et modifiez vos rubriques sans effort, puis réglez la table des matières, les mots-clés, les menus et la navigation en quelques clics. Quant aux Help Context ID, ils transforment le tout en une aide contextuelle pleinement intégrée.

Comment créer un fichier d'aide CHM dans Dr.Explain?

Tout commence par la création d'un projet depuis le menu principal: esquissez les grands sujets de votre futur fichier d'aide. Vous préféreriez ne pas concevoir la structure vous-même? Choisissez alors l'un des modèles de manuel prêts à l'emploi.

Ensuite, remplissez chaque sujet avec votre contenu. Ajoutez des images annotées pour montrer clairement comment votre logiciel fonctionne, et habillez le tout grâce à l'aperçu en direct du projet: dans les paramètres, le style visuel de vos pages se règle en un tour de main.

Une fois le fichier exporté, il ne vous reste qu'à le lier à votre application et à l'embarquer dans votre package d'installation. Avec la prise en charge des Help Context ID, votre projet devient un système d'aide contextuelle complet et fonctionnel.

Intégration

Cet outil professionnel génère des fichiers CHM prêts à brancher dans vos applications Windows — ni codage, ni compétence pointue requis. Prenons l'exemple d'une application .NET. Dans Dr.Explain, chaque sujet dispose d'un champ "Nom de fichier" (Filename) dans le panneau des propriétés, que vous définissez comme bon vous semble. Dans l'exemple ci-dessous, nous y avons saisi "save_button".

Ouvrez maintenant votre application dans l'éditeur de code. Pour l'élément d'interface qui doit ouvrir la rubrique correspondante (la section "Bouton Enregistrer"), affectez la valeur "save_button" à la propriété HelpKeyword:

private void HlpButton_Click(object sender, EventArgs e) { Help.ShowHelp(this, "save_button.chm"); }

Et voilà: chaque élément d'interface est relié à la bonne rubrique de votre documentation.

Exemples de manuels utilisateur au format CHM créés dans Dr.Explain

Voici, sur écrans réels, quelques systèmes d'aide contextuelle construits avec Dr.Explain.

Que vaut Dr.Explain à l'usage?

Dr.Explain coche la case "niveau professionnel" tout en restant d'une simplicité déconcertante — au point que débutants comme experts s'y retrouvent. Voici pourquoi il s'impose pour créer des guides d'aide sans y passer des semaines.

Collaboration d'équipe. Dr.Explain est certes une application de bureau, mais elle s'appuie sur la plateforme cloud Tiwri.com, où plusieurs auteurs travaillent ensemble sans la moindre friction.

Workflow intuitif. Le processus de création tient en une ligne: aucune connaissance technique spécialisée n'est nécessaire.

Support multilingue. Rédigez et gérez votre documentation en plusieurs langues, et générez un fichier CHM distinct pour chacune — parfait quand votre logiciel vise un public mondial.

Dr.Explain est-il fait pour vous?

Dr.Explain s'adresse à ceux qui prennent la documentation utilisateur au sérieux: pas seulement à qui veut empiler des instructions, mais à qui entend bâtir un système d'aide structuré qui change vraiment la manière dont les utilisateurs appréhendent le logiciel. Concrètement, il devient vite indispensable si:

• votre guide utilisateur a pris une telle ampleur qu'il vous faut une recherche en texte intégral pour que chacun trouve vite ce qu'il cherche;
• vous voulez appliquer un style personnalisé et donner à votre projet une identité visuelle qui n'appartient qu'à lui;
• vous travaillez à plusieurs sur le même document;
• vous comptez exporter vers plusieurs formats — CHM, HTML, PDF, DOCX;
• vous préférez tester une version gratuite avant de vous décider;
• vous avez besoin d'intégrer du code ou des widgets personnalisés dans votre système d'aide.

Ce que disent les utilisateurs de la création de fichiers CHM dans Dr.Explain

"Dr.Explain nous a séduits par sa grande facilité d'utilisation et de gestion des captures d'écran. Nous avons décidé de baser notre système sur l'assistant de captures d'écran, en créant des explications guidant l'utilisateur à travers la tâche. La gestion des contrôles dans chaque capture d'écran ainsi que la possibilité de créer à la fois des fichiers CHM et HTML ont été les points clés dans le choix de votre produit."

Robert Sibilski, PDG et programmeur en chef de Siborsoft

"C'était la première fois que nous devions créer un fichier d'aide pour un projet. J'ai fait des recherches et comparé différents outils de création de fichiers d'aide CHM et Dr.Explain semblait correspondre à mes besoins et semblait très facile à utiliser. Sur la base des avis d'autres utilisateurs, j'ai décidé de l'essayer et je peux dire sans hésitation que c'était une bonne décision."

Rick Szasz, programmeur chez Damselfly Solutions Inc

"J'ai permis aux gens de comparer le CHM généré avec Dr.Explain et les autres fichiers d'aide. La différence était énorme ! Les commentaires que j'ai reçus sur la version de Dr.Explain étaient absolument positifs, et ceux sur les fichiers CHM générés par l'IDE, négatifs... Le CHM créé par Dr.Explain semble parfait, ce qui augmente la valeur de l'ensemble du projet. Nous pouvons voir à quel point c'est sérieux."

Michel Garcia, le fondateur et PDG d'EZSecure

Questions fréquentes