Aide multiformat

Publié le 05/12/2006 12:06:40

Je m'abonne

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

Fig. 86 Options Html

Fig. 87 Options Chm

Fig. 88 Options Texte-Rtf

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

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

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

Fig. 91 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;

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. 92 Inclusion css sous conditions

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.