Comment créer un nouveau fichier CHM

Les fichiers CHM (Compiled HTML Help) sont la norme pour la documentation logicielle sous Windows. Que vous soyez un développeur documentant votre application ou un rédacteur technique, la création d'un fichier d'aide structuré et navigable est essentielle. Ce guide vous accompagnera dans la création d'un nouveau projet CHM avec CHM Editor.

Remarque : La création de fichiers CHM à partir de zéro peut être complexe avec les outils standards. CHM Editor simplifie ce processus avec une interface visuelle et des modèles intégrés.

1. Installation et configuration

Tout d'abord, assurez-vous que CHM Editor est installé. Si ce n'est pas encore fait, vous pouvez télécharger la version d'essai pour suivre ce tutoriel.

Une fois installé, lancez l'application. Vous serez accueilli par l'écran de démarrage.

2. Créer un nouveau fichier CHM

Pour créer un nouveau fichier CHM, accédez à Fichier > Nouveau dans le menu supérieur, ou appuyez simplement sur Ctrl+N.

Menu de création d'un nouveau fichier CHM

Configuration du fichier CHM

La boîte de dialogue « Nouveau fichier CHM » vous permet de configurer votre documentation. Il s'appelle « projet » car CHM Editor crée des fichiers auxiliaires (tels que les paramètres du projet et les fichiers HTML sources) en plus du CHM compilé final :

Boîte de dialogue des propriétés du nouveau projet CHM

Nom du projet : Le titre interne de votre projet d'aide.
Nom de fichier et emplacement : Où votre projet sera enregistré.
Langue : La langue par défaut pour votre fichier d'aide.
Nom de l'entreprise et site web : Métadonnées optionnelles qui apparaissent dans les propriétés du fichier.
Modèle : Choisissez parmi les schémas de couleurs professionnels intégrés :
- Simple Blue — Un look standard et professionnel.
- Simple Green — Une apparence fraîche et moderne.
- Simple Orange — Un style chaleureux et énergique.

3. Ajouter des rubriques

Un fichier d'aide se compose de plusieurs rubriques organisées dans une structure arborescente. Les rubriques sont les pages individuelles de votre documentation dans lesquelles les utilisateurs navigueront.

Étape 1 : Cliquez sur le bouton Ajouter une rubrique

Pour ajouter une nouvelle rubrique, cliquez sur le bouton + dans la barre de navigation :

Bouton Ajouter une rubrique dans la barre d'outils de CHM Editor

Étape 2 : Configurez votre rubrique

Dans la boîte de dialogue qui apparaît, vous pouvez définir les paramètres de votre rubrique :

Boîte de dialogue de création de nouvelle rubrique

Vous avez trois options pour créer une rubrique :

Créer avec un nouveau fichier : Crée une nouvelle page HTML vierge pour écrire du contenu. C'est l'option la plus courante lors de la création de documentation à partir de zéro.
Créer sans fichier : Crée un en-tête de section (dossier) dans la table des matières qui contient d'autres rubriques mais n'a pas de contenu propre. Utilisez-le pour organiser les rubriques en groupes logiques.
Créer avec un fichier existant : Lie un fichier HTML existant de votre système au projet. Utile lorsque vous avez déjà de la documentation au format HTML.

Étape 3 : Définir la rubrique par défaut

La rubrique par défaut est la première page que les utilisateurs verront en ouvrant votre fichier CHM. Il y a deux façons de la définir :

Option A : Lors de la création de la rubrique, cochez la case « Définir par défaut » :

Case 'Définir par défaut' lors de la création de rubrique

Option B : Faites un clic droit sur n'importe quelle rubrique existante et sélectionnez « Définir par défaut » :

Option 'Définir par défaut' dans le menu contextuel

Conseil : N'oubliez pas de définir une rubrique par défaut — c'est la page que les utilisateurs verront en premier lors de l'ouverture de votre fichier d'aide.

4. Modifier le contenu

Utilisez le volet de l'éditeur pour formater le texte, insérer des images et créer des liens.

Utilisez la Vue arborescente à gauche pour organiser la hiérarchie des rubriques.
Utilisez le volet Éditeur à droite pour modifier visuellement le contenu.

Traduire votre contenu

CHM Editor inclut une traduction intégrée alimentée par Google ou Bing. Vous pouvez traduire votre contenu de deux manières :

Traduire le texte sélectionné : Surlignez le texte souhaité, choisissez la langue cible dans le menu déroulant et cliquez sur le bouton Traduire. C'est utile pour traduire des parties de votre documentation tout en gardant d'autres parties dans la langue d'origine.
Traduire toute la page : Sans sélectionner de texte, restez simplement sur la page, choisissez la langue cible et cliquez sur Traduire. Tout le contenu de la page sera traduit tout en préservant tout le formatage et la structure HTML.

Remarque : Les traducteurs professionnels peuvent utiliser CHM Editor pour gérer les fichiers d'aide comme des documents standards — aucune connaissance HTML requise. Toutes les balises et le formatage sont préservés lors de la traduction.

Conseil pro : Vous pouvez exporter votre fichier d'aide aux formats PDF ou Word ultérieurement si vous avez besoin de fournir une documentation imprimable.

Avec votre projet configuré, vous êtes prêt à créer une documentation complète. CHM Editor gère le processus de compilation complexe en arrière-plan, vous permettant de vous concentrer sur la rédaction de bon contenu.