Aide help&web

 

Table des matières

VI

Pour que l'aperçu css de votre rubrique soit à jour vous devez avoir basculé en Aperçu Html avant d'ouvrir l'éditeur de style d'Help&Web.

La directive conditionnelle THEME vous permet d'ajuster le contenu de vos rubriques en fonction du thème activé.

Lors de la publication en HTML, chaque plugin jquery va être fusionné avec jquery lui-même et placé dans hw-jquery.js

Depuis l'onglet Rubriques vous avez accès à un historique de votre rubrique qui vous permettra de revenir à une version antérieure.

Le point de restauration d'une version officielle est protégé par défaut

Vous pouvez indiquer un point de restauration dans un profil de publication pour pouvoir publiée une version spécifique

La publication d'une version officielle crée automatiquement un point de restauration

Le nom de publication vous permet de choisir un nom différent du nom de projet pour votre aide finale.

Le numéro de construction est automatiquement incrémenté à chaque publication si le projet a été modifié

Depuis l'onglet Projet vous avez un accès direct au numéro de version

Le champ "URL de base du projet" vous permet d'indiquer l'adresse web de base et ainsi les liens en provenance d'autres projets pointeront au bon endroit

Vous pouvez appliquer cette exclusion à la rubrique ainsi qu'à ses sous-rubriques.

Si vous étiez en mode Aperçu Html l'affichage va se mettre à jour pour prendre en compte vos changements

Vous pouvez incorporer une feuille de style en fonction d'une condition, par exemple uniquement pour une compilation pdf

Les modèles de projet d'Help&Web ont une rubrique Table des illustrations qui utilise cette fonctionnalité

Vous pouvez désactiver l'inscrustation des puces en basculant la propriété ShowPuceLegende du composant Fig.spr à false

Lorsque vous collez une image depuis le presse-papier par CTRL+V vous avez le choix de définir une légende, si vous souhaitez simplement insérer une icône sans légende utilisez CTRL+SHIFT+V

Vous pouvez aussi basculer en mode source, sélectionner la portion de texte à transformer en gabarit puis cliquer sur

La condition _APERCU_ vous permet de ne pas réaliser des actions longues qui sont inutiles dans ce contexte, c'est le cas du composant search qui ne réalise l'indexation du projet que lors d'une compilation complète!

Lors d'un transfert vous pouvez générer une archive zip synchronisée avec votre FTP

Pour changer les titres des pages Table des matières,Index et Glossaire, faites suivre le nom du script par :Nouveau_Titre

Pensez à utiliser des profils associés à vos filtres, cela vous facilitera leur utilisation lors d'une publication.

Un clic droit vous permet de choisir le mode d'insertion

Vous pouvez filtrer vos rubriques en fonction de leur statut

en pressant les touches Ctrl+Shift vous désactivez cette option

Positionnez-vous à droite d'une ligne de texte et pressez CTRL+1..6 pour transformer celui-ci en titre

Vous pouvez sélectionner un groupe de lignes pour les tranformer en autant de titres

En pressant Ctrl+Entrée dans l'éditeur de contenu vous définissez automatiquement un paragraphe aligné à gauche

Sélectionnez un caractère et pressez CTRL+A vous pourrez alors accentuer directement votre lettre sans avoir à vous souvenir que ê = ALT+234 ;)

Positionnez-vous à droite d'une ligne de texte et pressez CTRL+1..6 pour transformer celui-ci en titre

En pressant Ctrl+Entrée dans l'éditeur de contenu vous définissez automatiquement un paragraphe aligné à gauche, Ctrl+Shift gauche+Entrée un paragraphe centré et Ctrl+Shift droit+Entrée un paragraphe aligné à droite.

Pour un accès direct vers l'en-tête et le bas de page cliquez sur

en pressant les touches Ctrl+Shift vous désactivez cette option

Positionnez-vous à droite d'une ligne de texte et pressez CTRL+1..6 pour transformer celui-ci en titre

Vous pouvez sélectionner un groupe de lignes pour les tranformer en autant de titres

En pressant Ctrl+Entrée dans l'éditeur de contenu vous définissez automatiquement un paragraphe aligné à gauche

Le service de traduction de Microsoft est intégré dans Help&Web et est accessible au travers de l'icône

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

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;

SearchResume sert aussi pour le moteur de recherche et le composant Resume utilisé sur la page d'accueils des tutoriaux

Cela est aussi valable pour les aides chm (htmlhelp) qui utilisent le format html

Vous n'êtes pas limité à chacher les éléments vous pouvez aussi choisir de modifier leur apparence lors de l'impression.

Pour que le texte reprenne le titre de votre page utilisez le champ calculé [ #12]

Vous pouvez exclure tel ou telle rubrique en fonction du format de sortie

ListOfTopic génère en html une liste non ordonnée (ul) que vous pouvez styler à votre guise

En laissant un ou plusieurs espaces en début d'un titre vous instaurez une indentation.

Lorsque vous créez un lien vers une rubrique, elle est ajoutée aux liens connexes

Si cette structure ne vous convient pas vous devez définir votre propre composant pour générer vos notes, servez-vous de notes.spr comme modèle.

Les entreprises doivent obligatoirement obtenir une licence entreprise, la version gratuite ne peut-être utilisée que pour tester le programme et passer un délai raisonnable Help&Web doit être soit effacé soit enregistré.

Vous pourrez toujours détruire un projet protégé en dehors d'Help&Web !

La protection contre l'effacement n'est valable que depuis Help&Web

Attention ces styles ne sont répercutés entièrement que pour des aides html et htmlhelp (chm), en hlp seules les propriétés de fonte, couleurs (Color, Background-Color), image en fond (Background-image), largeur (Width) et hauteur (Height) sont disponibles.

En PDF en plus des propriétés disponibles en hlp vous avez aussi accès aux marges, padding et bordures.

Top, Left sont disponibles si vous basculez Position sur absolute pour les blocs (type paragraphe, DIV) ou sur relative pour du texte.

Attention ces styles ne sont répercutés entièrement que pour des aides html et htmlhelp (chm), en hlp seules les propriétés de fonte, couleurs (Color, Background-Color), image en fond (Background-image), largeur (Width) et hauteur (Height) sont disponibles.

En PDF en plus des propriétés disponibles en hlp vous avez aussi accès aux marges, padding et bordures.

Top, Left sont disponibles si vous basculez Position sur absolute pour les blocs (type paragraphe, DIV) ou sur relative pour du texte.

Le code HTML ne sera fonctionnel QUE dans les publications CHM et HTML dans les autres formats il sera affiché telquel.

En Hlp/Pdf/Rtf seules les options concernant la fonte, la couleur et la puce graphique sont prises en compte contrairement au format html qui gère l'ensemble des attributs du style.

Vous devez avoir Acrobat Reader installé sur votre machine pour profiter de l'aperçu PDF de vos rubriques, mais il n'est nullement indispensable pour la publication de votre projet en PDF

Les caractères unicode ne seront reconnus que dans les publications au format Html, CHM et Rtf mais pas en Hlp et Pdf

Sous Vista et Windows 7 le répertoire system.hew est situé dans C:\Users\[votre_compte]\AppData\Roaming\HelpAndWeb

Pour y accéder pressez les touches WINDOWS+R entrez %APPDATA% puis OK

L'affichage en taille réelle ne fonctionne qu'en Html et HtmlHelp (CHM)

Attention, l'image est effacée de votre disque, pour la récupérer vous devrez aller dans la poubelle de windows et la restaurer.

Vous ne pouvez pas combiner plus de 2 mots mais vous pouvez séparer des combinaisons : mot1+mot2,mot2-mot3

Vous ne pouvez pas combiner plus de 2 mots mais vous pouvez séparer des combinaisons : mot1+mot2,mot2-mot3

Lorsque vous activez une langue différente de la principale, l'arborescence des rubriques et le titre de la rubrique sélectionnée restent affichés dans la langue de référence le changement n'a lieu qu'a la publication.

La publication multilingue n'est pas disponible dans la version gratuite pour les particuliers, elle n'est accessible que dans la version entreprise.

Un projet Winhelp est constitué des fichiers nécessaires au compilateur de microsoft pour réaliser une aide hlp, à savoir fichiers rtf contenant vos rubriques, les fichiers bmp de vos images et le fichier hpj qui décrit les options de compilations.

Help&Web crée lui aussi de tels fichiers, vous les retrouverez dans les sous répertoires hlp16 ou hlp32 (suivant que vous compiliez pour une aide 16 bits ou 32 bits), ils servent uniquement lors de la compilation finale et n'ont pas à être distribués.

Connecter vous permet d'ouvrir un projet Help&Web qui n'apparait pas dans la liste des projets, c'est le cas par exemple lorsque vous importez un projet depuis une autre machine en copiant son répertoire.

Pour copier un projet vous pouvez aussi réaliser une archive, puis passer par Nouveau projet et sélectionner Archive de projet

Vous pouvez servir un contenu différent en utilisant des directives conditionnelles

Vous pouvez exclure un groupe de rubriques depuis l'onglet Rubriques Propriétés:Rubriques

Dans un composant Help&Web la propriété name correspond à un identifiant #, alors que les propriétés css référence une classe css

Le pré-requi pour gérer des thèmes est d'utiliser des variables dans vos feuilles de styles

Vous pouvez aussi afficher du source php pour cela vous devez lui donner comme extension '.color.php', si vous référencez un '.php' lors de la compilation html celui-ci sera automatiquement incorporé avec un '' voir le tutorial pour produire des fichiers php

Ces trois commandes sont ignorées dans tous les autres formats que le pdf

En entrant les premières lettres du nom de l'image dans la liste du haut, elle est sélectionnée automatiquement.

Un clic droit sur une image la fait s'afficher en grandeur réelle.

Dans la version gratuite cette fonctionnalité n'est disponible que pour l'aperçu de vos rubriques, elle n'est pas reprise lors de la publication du projet.

La description courte servira de légende par défaut lors de l'utilisation des composants ThumbnailImage et Fig

En PDF la taille de la bordure est la même pour les 4 bords des cellules, par défaut elle fait 1 pixel et vous l'ajustez au travers de la propriété Border-Top-Width

L'onglet Html vous permet de contrôler la production de vos listes en choisissant ou non de les placer dans un DIV ainsi qu'en définissant un Identifiant.

Les objets Texte enrichi, Texte Spécial et Bannière dispose d'un accès direct pour vous permettre d'insérer un tel champ.

Depuis la version 5.2 vous disposez de deux nouveaux champs calculés qui permettent d'obtenir la date de création et de modification d'une rubrique.

Depuis la version 5.4 les champs suivants sont disponibles

  • Numéro majeur de version
  • Numéro mineur de version
  • Numéro de construction
  • Date de publication

Voir le chapitre sur la compilation pour plus de détail sur ces champs

Les schémas conditionnels peuvent êtres imbriqués.

Cette option n'est disponible que dans les versions enregistrées

Les scripts PdfTriangleFond , PdfClassicFond et PdfBandeauFond sont présent en standard.

Vous pouvez insérer une image qui servira de page de garde avant le sommaire en renseignant la propriété image du script pdfSommaire ( cliquez sur )

La gestion complète du FTP n'est disponible que pour la version Entreprise, la version gratuite pour les particuliers n'en dispose que pour des projets de moins de 10 rubriques.

Depuis l'onglet styles vous fixerez les fontes utilisées lors de la conversion en hlp/rtf/pdf pour les styles logiques html (h1,h2 etc.)

Lorsque vous créez un lien vers une rubrique, elle est ajoutée aux liens connexes

Un modèle contient le contenu et les propriétés de la rubrique

Ces filtres peuvent aussi s'appliquer pour sélectionner les rubriques à publier, voir onglet Publier > Configurer

Lorsque vous modifiez le contenu d'une rubrique le statut "A mettre à jour" est automatiquement attribué pour cette rubrique dans ses langues secondaires.

Pour effacer une marque, placez vous sur la ligne puis repressez la combinaison ALT+CTRL+F0..9

Les marques sont sauvegardées avec la rubrique, vous les retrouverez donc à la réouverture du projet

Sous Help&Web les rubriques de premier niveau sont appelées Chapitre, toutes les autres ont pour nom Page outre le fait qu'un Chapitre sera toujours au premier niveau de l'arborescence, une telle rubrique ne pourra pas se voir attribuer le style popup

Vous pouvez modifier les fontes employées par défaut pour le titre et le contenu de vos rubriques depuis l'onglet Style - Architecture de base

Vous pouvez aussi poser un lien sur une image légendée, mais pas sur un thumbnail, qui ouvre l'image en taille réelle, ni sur une vignette.

En xhtml/htmlhelp vous pouvez définir les couleurs zone fixe / zone défilante individuellement pour chaque page en utilisant le composant BodyColor situé sur l'onglet Html de la palette des composants

Sous Help&Web les rubriques de premier niveau sont appelées Chapitre, toutes les autres ont pour nom Page outre le fait qu'un Chapitre sera toujours au premier niveau de l'arborescence, une telle rubrique ne pourra pas se voir attribuer le style popup

Le texte peut contenir des enrichissements, ils seront conservés lors de la traduction automatique.

SYSTEM.HEW est dans le répertoire d'installation d'Help&Web sous XP et dans \Users\[votre_compte]\AppData\Roaming\HelpAndWeb sous Vista/Seven (tapez %appdata% dans l'explorateur de fichiers pour un accès direct)

Sommaire