Help&Web pouvant générer avec un même projet des aides hlp, html, chm, pdf et rtf nous allons découvrir comment bien l'utiliser pour optimiser le rendu.

Choix du format

Il s'effectue lors de la compilation, pour chacun d'eux vous avez la possibilité d'ajuster divers paramètres.

Fig. 283 Options Hlp

Fig. 284 Options Html

Fig. 285 Options Chm

Fig. 286 Options Texte-Rtf

Fig. 287 Options Pdf

Exclusion de rubriques

En fonction du format choisi vous pouvez exclure certaines rubriques, pour ce faire cliquez sur le bouton à gauche de l'arborescence de vos rubriques.

Fig. 288 Exclure la rubrique lors d'une compilation rtf et texte

Vous pouvez exclure un groupe de rubriques depuis le menu Projet|Editer les rubriques

36

Ajuster le contenu suivant le format

Grâce à la compilation conditionnelle vous pouvez faire ce compiler des parties de vos rubriques en fonction du format généré, pour cela sélectionnez le morceau de texte puis cliquez sur Directives conditionnelles

Fig. 289 Inclure si HtmlHelp

Vos composants peuvent aussi réagir au format de la compilation au travers de la fonction Condition

if condition('_HTML_') then
begin
// on arrive ici si compilation html
if condition('_HTMLHELP_') then
 begin
  // on ne viendra ici que pour une compilation htmlhelp (chm)
 end;
end;

37

Feuilles de styles

Vous pouvez aussi utiliser des feuilles de styles css différentes en fonction du format, là encore la logique est basée sur les directives conditionnelles.

Fig. 290 Inclusion conditionnée des feuilles de styles

Aller plus loin

En mixant les techniques que nous venons de voir, vous pouvez radicalement changer le comportement d'un projet suivant qu'il soit compilé pour tel ou tel format.

Le manuel en ligne et l'aide en ligne d'Help&Web sont créés à partir du même projet, ils ont pourtant une logique de fonctionnement et une apparence bien différentes.

Fig. 291 Manuel en ligne - format html

Fig. 292 Aide en ligne - format Htmlhelp

Une utilisation judicieuse des en-tête et bas de page globaux d'Help&Web nous facilite encore plus la tâche.

Fig. 293 En-tête projet Aide Help&Web

On remarque que lorsque l'on compile pour une aide CHM (HtmlHelp ) on utilise le composant TopFixedfooter et sinon le composant composant TopClassicManuel TopClassicManuel

Sommaire