L'aide wxWidgets ?

wxWidgets est une plate-forme en pleine expansion. Elle supporte le format HtmlHelp ainsi que son propre format d'aide.

HtmlHelp fonctionne sous Windows tandis que l'aide wxWidgets tourne sous Windows, Unix et Apple Mac. 

L'extension de fichier pour wxWidgets est ".htb" et lorsque vous compilez un projet Fast-Help en wxWidgets, il sera sauvegardé dans le répertoire "wxWidgets" (en-dessous du projet).

Note: Le répertoire "HtmlHelp" est utilisé pour les fichiers temporaires lors de la compilation (plutôt que d'utiliser un répertoire supplémentaire). Aussi, si vous basculez entre HtmlHelp et wxWidgets, assurez-vous que vous avez décoché "Quick Compile". Cela forcera toutes les pages à être rafraichies lors de la compilation.

Affichage de l'aide wxWidgets

Fast-Help est fourni avec une visionneuse (en distribution libre) "HelpView.exe" qui se trouve dans le répertoire "Compilers" (en-dessous du répertoire d'installation). Lorsque vous sélectionnez "Project | Display | wxWidgets Help", la commande suivante est exécutée (et chargée):

  "C:\Folder path\HelpView.exe" "C:\Location of help file\YourHelpFile.htb".

Différences entre l'aide HtmlHelp et wxWidgets

• Le panneau de commande (avec trois onglets, barre au-dessus, boutons de navigation à gauche et contenu à droite) est similaire à l'écran HtmlHelp excepté qu'il n'y a pas d'onglet "favoris".
• Les boutons de navigation comporte les commandes suivantes:
  Masquer/Afficher, Arrière, Avant, Remonter d'un niveau, Page précédente, Page suivante, Imprimer et Affichage des options de caractères.
• Lorsque vous consultez l'aide, vous visualisez seulement un intitulié qui est le titre de votre fichier d'aide. Quand vous cliquez sur cet intitulé, le sujet (topic) par défaut s'affiche. Ceci permet en fait d'avoir plusieurs fichiers d'aide chargés dans le même "viewer" (visionneuse).
• Vous pouvez imprimer un sujet (topic) à la fois.
• Dans l'onglet Index, les mots-clefs n'apparaissent pas par défaut mais vous pouvez utiliser le bouton [Show All] (Afficher Tout).
• Une fonction pratique est la fonction "Bookmarks" (disponible dans l'onglet Contents). Vous pouvez ajouter la page en cours à vos Bookmarks (signets) qui sont sauvegardés automatiquement lorsque le fichier d'aide est fermé.
• Bien que l'en-tête fixe (nonscroll) est affichée au-dessus du sujet (topic), il s'agit d'une zone "non-scroll" dans l'aide wxWidgets. Elle se déplacera avec le reste de la page (parce que le JavaScript n'est pas supporté). De même, la région "nonscroll" n'a pas de couleur de fond de page à l'inverse du format HtmlHelp.
• En outre, le formatage est légèrement différent entre HtmlHelp et wxWidgets. L'aide HtmlHelp est affichée par l'explorateur internet tandis que l'aide wxWidgets s'affiche par son propre moteur html. Malheureusement, cela ne produit pas le même rendu. Aussi, lors de la compilation en format wxWidgets, un format html simplifié est généré afin de répondre aux limitations des styles CSS (inline).
• Lors du premier affichage, la taille des caractères peut être trop petite (en fonction de l'écran). Il est parfois judicieux d'augmenter la taille des caractères dans la visionneuse (Viewer) à 12 points. Vous pouvez y parvenir en cliquant sur le bouton [A]  (à droite de la barre de raccourcis).
• Les liens vers des sites web et des adresses email ne fonctionnent pas dans le format wxWidgets.
• Les images animées GIF ne sont pas prises en compte.
• De même, les paragraphes extensibles et les popups ne sont pas pris en charge (à cause de l'utilisation de JavaScript).

Vous pouvez compléter votre information au sujet des wxWidgets sur www.wxWidgets.org.

Vous pouvez également télécharger des visionneuses pour différents systèmes d'exploitation (produites par Anthemion Software) à partir des liens suivants: