Aide multiformat

Publié le 08/09/2009 15:41:02

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. 101 Options Hlp

Fig. 102 Options Html

Fig. 103 Options Chm

Fig. 104 Options Texte-Rtf

Fig. 105 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. 106 Exclure la rubrique lors d'une compilation rtf et texte

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

22

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. 107 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;

23

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. 108

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. 109 Manuel en ligne - format html

Fig. 110 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. 111 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