Avant de décortiquer vos 500 pages si soigneusement préparés, prenez quelques instants pour suivre ce guide pas-à-pas afin de bien comprendre toutes les implications de cette opération.

Dans notre scénario, un Tour-opérateur veut montrer ses destinations de vacances spécialisées en deux catégories :

Vacances Joyeuses et bon marché 

Vacances Atrocement chères 

      

Il souhaite que la plupart de ses clients voient les destinations de la 1ère catégorie (mais seulement certains de ces clients voudront voir les deux catégories), et enfin d'autres ne rechercheront que des destinations luxueuses.

Alors le Tour-opérateur crée deux Projets comme ceci :

Projet Maître

1. Appelez le menu "Fichier | Nouveau Projet" et entrez son nom : "Vacances", son titre : "Grandes Vacances" et le répertoire que vous voulez, mais notez bien son emplacement, nous en aurons besoin bientôt.
2. Créez un nouvel En-tête nommé "Joyeuses et bon marché" et deux sujets au-dessous : "Barbizon" et "Aubenas".
3. Appelez "Projet | Paramètres du Project" et cochez l'Option "Ce Projet fait partie d'un Projet Fusionné"
4. Appelez "Projet | Options du Compilateur HtmlHelp" et dans l'Onglet "Général" cochez l'Option "Créer un Index Binaire" et décochez l'Option "Créer une TDM Binaire"

             

Compilez et voyez ce que vous avez créé.

Projet esclave

1. Appelez à nouveau le menu "Fichier | Nouveau Projet" et entrez son nom : "Atrocementcheres" (sans espaces ni accents : évitez les accents en HTML !), son titre : "Grandes Vacances" et le même répertoire que vous avez choisi pour le 1er projet. (*)
2. Ajoutez un nouvel En-tête et nommez le "Atrocement chères" et deux nouveaux sujets au-dessous : "Hawaii" and "Antarctique".
3. Appelez "Projet | Paramètres du Project" et cochez l'Option "Ce Projet fait partie d'un Projet Fusionné"

5. Appelez "Projet | Options du Compilateur HtmlHelp" et dans l'Onglet "Général" cochez l'Option "Créer un Index Binaire" et décochez l'Option "Créer une TDM Binaire" et utilisez exactement les mêmes Options que pour le Projet Maître. Il est importaznt de répercuter toute modification de paramètres dans tous les Projets à Fusionner.

Compilez et notez le Contenu et l'Index.

(*) Avoir deux ou plusieurs Projets dans le même répertoire peut poser problème, si des Pages ont le même "Context String" dans des Projets distincts. Dans ce cas, le dernier Projet compilé écrasera les valeurs de Context Strings communes aux autres projets

D'une certaine façon celà vous oblige à maintenir des pages uniques, mais si vous ne voulez ou ne pouvez pas gérer celà, créez le Projet Esclave dans un répertoire séparé, et ne recopiez que le Ficher Compilé dans le Projet Maître.

Fusion des deux Projets !

Revenons au Projet Maître et ajoutons-y notre Projet Esclave :

1. Dans le menu "Fichier", la dernière entrée devrait être "Vacances". Sélectionnez-la et le Projet Maître s'ouvrira.
2. Nous allons maintenant informer le Projet des Fichiers à fusionner. Appelez le menu "Projet | Options du Compilateur HtmlHelp" et cliquez sur l'Onglet "Avancé" puis sur [Fusionner les Fichiers] et entrez tous les Projets Esclaves. Dans notre exemple nous allons entrer "AtrocementCheres.chm" (sans espaces) et cliquer [Ok].

3. Nous allons maintenant demander au Projet Maître de fusionner les fichiers de "Contenu" des Projets Esclaves : Dans l'Onglet "Texte d'Aide", dans "Contenu" placez-vous sur la dernière entrée et appelez le menu "Insérer | Fusionner un autre Contenu" et tapez le nom du projet compilé suivi de "::/" puis du nom du Projet Esclave. Exemple :    "AtrocementCheres.chm::/AtrocementCheres.hhc""

Compilez. La Table des Matières du Projet Maître affiche maintenant les deux Projets, comme dans la copie d'écran ci-dessous. Si vous regardez l'Index vous constaterez qu'il à fusionné, lui aussi et que vous pouvez utiliser le Moteur de Recherche pour trouver des données du Projet Esclave.

En cas de difficultés, reprenez les étapes une par une pour voir ce que vous n'avez pas bien compris.

Problèmes éventuels avec la Fusion

La version actuelle de Microsoft HtmlHelp v1.4 présente quelques bogues avec la Fusion.

Nous vous avions conseillé de placer le Contenu Fusionné au 1er niveau de l'Arborescence du Projet Esclave, mais vous remarquerez qu'une indentation a été ajoutée juste sous la dernière entrée du Projet Maître. Il s'agit bien d'un bug.

Si vous essayez de placer le Contenu Fusionné à toiute autre position les résultats ne seront pas prévisibles.

Un autre problème est la présence d'espaces dans les noms des fichiers. Veuillez les éviter pour les Projets Esclaves