Variables
Sujet Suivant</p><p>Sujet Précédent  Sujet Suivant 

Appelez le menu "Outils | Variables" pour ouvrir l'écran de gestion des Variables. Vous verrez la liste de toutes les Variables dans la partie gauche. En haut à droite figure la description de la Variable courante et au-dessous le texte qui la remplacera. 


Définition des Variables

Une Variable est une donnée simple associée à un Nom de Variable unique. A la compilation, chaque occurrence de la Variable sera remplacée par la valeur de celle-ci.


Exemple : Supposons que le N° de téléphone de votre société figure une vingtaine de fois dans l'ensemble du Projet, et vous savez que l'entreprise va prochaînement déménager ! 

Voici comment il faudrait procéder :


  1. Cliquez [Ajouter] et saisissez "NumTelephone" puis [Ok]. (Vous pouvez faire court et saisir "NT" mais lorsque vous rouvrirez votre Projet pour le modifier dans 6 mois, qui se souviendra de la signification de la Variable "NT" ?)
  2. Dans le champ "Remplacer par" entrez votre N° de téléphone  actuel, comme "01 02 03 04 05" puis cliquez [Ok]
  3. Passez maintenant dans le texte d'aide et placez le pointeur là où le N° de téléphone doit apparaître. Appelez le menu "Insérer | Variable", choisissez la Variable que vous venez de créer et cliquez [Insérer], et ainsi de suite pour chaque occurrence.
  4. Compilez ! La Variable sera remplacée par le N° de téléphone.
  5. Maintenant appelez à nouveau le menu "Outils | Variables" et sélectionnez "NumTelephone". Remplacez sa valeur par un autre N° de téléphone. Vous pouvez aussi le formatter, le colorier etc...
  6. Re-compilez ! Vérifiez que toutes les occurrences du N° de téléphone ont bien été modifiées.


Ce système vous fera vraiment gagner du temps si vous pensez à l'utiliser aussi souvent que possible..



 Variables Réservées et Site Web

Lorsque vous compilez un Site Web, l'Onglet "Chercher" contient trois paragraphes dont vous pouvez modifier la valeur, en utilisant les  trois Variables Réservées ci-dessous :


GO

Le titre du bouton à droite du texte à chercher

TYPE

Le paragraphe qui commence par "Saisir le texte à rechercher..."

EXACT

Le paragraphe qui commence par "Encadrez les chaînes exactes..."


Les Résultats contiennent aussi deux paragraphes que vous souhaiterez peut-être personnaliser, et pour lesquels vous disposez de deux Variables Réservées :


PAGES_FOUND

Le texte qui montre combien de pages ont été trouvées.

SEARCH_NO_MATCHES

Le paragraphe qui commence par "Aucun résultat ne correspond..."



 Ballons d'aide pour les Onglets de Site Web

Il y a trois Onglets au-dessus du panneau des Contenus dans un Site Web compilé par Fast-Help : "Contenus", "Index" et "Chercher".


Chaque fois que le pointeur passe au-dessus de l'un de ces Onglets, un texte apparait. Vous pouvez personnaliser ces textes d'aide au moyen des Variables Réservées ci-dessous :



WEBSITE_CONTENTS_HINT

Aide pour l'Onglet "Contenus"

WEBSITE_INDEX_HINT

Aide pour l'Onglet "Index"

WEBSITE_SEARCH_HINT

Aide pour l'Onglet "Chercher"


Ballons d'aide pour les Boutons de Navigation "Précédent" et "Suivant"

Dans les modes HtmlHelp et Site Web, si vous avez activé ces boutons au moyen de l'Option correspondante, les boutons Gauche et Droite s'afficheront en haut à droite de chaque Page.


Chaque fois que le pointeur passe au-dessus de l'un de ces boutons apparaît le texte correspondant, à savoir "Précédent" et "Suivant". Pour les modifier utilisez les Variables Réservées ci-dessous :


NEXT_TOPIC_HINT

Texte d'aide du bouton "Suivant"

PREVIOUS_TOPIC_HINT

Texte d'aide du bouton "Précédent"



Liens de Fin de Sujet sur un PocketPC 

A la compilation d'un document ou d'un fichier d'aide pour PocketPC, vous pouvez ajouter deux Liens optionnels au bas de chaque Page. Fast-Help utilisera les Variables Réservées suivantes :


PPC_CONTENTS

Le Lien de retour aux Contenus

PPC_INDEX

Le Lien de retour à l'Index



 Variables Réservées  Générales

Il peut s'avérer nécessaire d'insérer dans le texte d'aide la date de modification de chaque page  ou encore le N° HelpID correspondant. Il s'agit là aussi de Variables Réservées que vous pouvez utiliser.


Par exemple, pour insérer le N° HelpID à un endroit quelconque de la page d'aide, saisissez  . Cette variable sera remplacée à la compilation par le N° correspondant.


Ce N° HelpID peut être très utile pour créer des Liens HTML directs à telle ou telle page de votre Site Web.


Exemple : Le N° HelpID de la présente page est 10226. Nous avons compilé ce Document en tant que Site Web, que nous avons téléchargé. Nous pouvons maintenant créer un lien comme ceci :

  http://www.fast-help.com/WebsiteHelp/Index.html?10226

Et nous pouvons utilisez ce lien depuis n'importe quelle page HTML de n'importe quel autre site web (Que le site en question ait été généré par Fast-Help ou pas).



Ceci n'était qu'un exemple d'utilisation des Variables Réservées Générales. Voici la liste complète :


Le Titre de votre Sujet / Popup

Le N° HelpID de la Page. Vous pouvez trouver ce N° en cliquant l'Onglet "Propriétés" en bas de l'Editeur.

La "ContextString" de votre Page

La Date à laquelle la Page a été compilée.

L'heure de compilation.

La Date et l'Heure de compilation.

La Date de dernière modification de la page.

La Date et l'Heure de dernière modification de la page.


Les Variables Réservées Générales peuvent aussi s'employer dans les Titres et les Mots-clés, ainsi que dans les blocs <TAG> HTML qui apparaîssent en jaune.