Mode d'emploi | Adobe RoboHelp 2019 Manuel utilisateur

Ajouter à Mes manuels
659 Des pages
Utilisation de Adobe
RoboHelp Classic
(2019 release)
ao&ucirc;t 15, 2018
Table des mati&egrave;res
Chapitre 1 :
i
Prise en main . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
&Agrave; propos de RoboHelp Classic (2019 release) . . . . . . . . . . . . . . . 1
Flux de travaux de base . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Cr&eacute;ation d'un projet . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Cr&eacute;ation du contenu . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Importation de fichiers . . . . . . . . . . . . . . . . . . . . . . . . . . 2
D&eacute;veloppement de la navigation . . . . . . . . . . . . . . . . . . . . 2
Personnalisation de la sortie . . . . . . . . . . . . . . . . . . . . . . 2
G&eacute;n&eacute;ration, test et distribution du package d'aide . . . . . . . . . . 2
Activation et enregistrement . . . . . . . . . . . . . . . . . . . . . . . . 2
Installation de RoboHelp Classic . . . . . . . . . . . . . . . . . . . . 3
Aide &agrave; l'installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Activation de la licence . . . . . . . . . . . . . . . . . . . . . . . . . 3
Programme d'am&eacute;lioration des produits Adobe . . . . . . . . . . . . 3
Enregistrement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Aide et assistance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Adobe Community Help . . . . . . . . . . . . . . . . . . . . . . . . . 4
Acc&egrave;s &agrave; l'aide RoboHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Services, t&eacute;l&eacute;chargements et extras . . . . . . . . . . . . . . . . . . 4
Adobe Exchange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
T&eacute;l&eacute;chargements Adobe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Adobe Labs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Forums Adobe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Adobe TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Exemples de projets et de sorties RoboHelp . . . . . . . . . . . . . . . . . . 5
P&ocirc;le de d&eacute;veloppement RoboHelp . . . . . . . . . . . . . . . . . . . . . . . . . 5
Aide des versions ant&eacute;rieures de RoboHelp . . . . . . . . . . . . . . . . . . 6
R&eacute;capitulatif des fonctionnalit&eacute;s de RoboHelp Classic . . . . . . . . . . 6
Contenus interactifs &eacute;poustouflants produits avec
la publication HTML5 de nouvelle g&eacute;n&eacute;ration . . .
Gagnez en productivit&eacute; . . . . . . . . . . . . . . .
A propos de RoboHelp Server . . . . . . . . . . . . . .
Suivi et rapports . . . . . . . . . . . . . . . . . . .
Fusion automatique de projet . . . . . . . . . . . .
Prise en charge des langues autres que l'anglais .
Int&eacute;gration avec SharePoint . . . . . . . . . . . . . . .
Tableau des versions de SharePoint . . . . . . . . .
Chapitre 2 :
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 6
. 7
. 8
. 9
. 10
. 10
. 11
. 12
D&eacute;couverte de l'espace de travail . . . . . . . . . . . . . . . . . . . . 13
Pr&eacute;sentation de l'espace de travail . . . . . . . . . . . . . . . . . . . . . 13
Barre d'outils Acc&egrave;s rapide . . . . . . . . . . . . . . . . . . . . . . . 14
Onglets de RoboHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Volet Document &agrave; onglets . . . . . . . . . . . . . . . . . . . . . . . . 14
Conteneurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Utilisation des onglets de RoboHelp . . . . . . . . . . . . . . . . . . . . 15
Utilisation des conteneurs . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Affichage d'un conteneur . . . . . . . . . . . . . . . . . . . . . . . . 16
Organisation des conteneurs . . . . . . . . . . . . . . . . . . . . . . 17
Types de conteneurs . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Conteneur D&eacute;marrage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Conteneur Gestionnaire de projets . . . . . . . . . . . . . . . . . . . . . . . . 18
Conteneur Configuration de sortie . . . . . . . . . . . . . . . . . . . . . . . . 18
Conteneur Extraits de code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Conteneur Styles et formatage . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Conteneur Variables d&eacute;finies par l'utilisateur . . . . . . . . . . . . . . . . 20
Conteneur Liste d'erreurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Conteneur Affichage de la sortie . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Conteneur Bo&icirc;te &agrave; outils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Conteneur Gestionnaire de ressources . . . . . . . . . . . . . . . . . . . . . 20
Conteneur Recherche de contenu externe . . . . . . . . . . . . . . . . . . 21
Conteneur RoboHelp Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Environnements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Cr&eacute;ation et enregistrement d'un environnement . . . . . . . . . . . 22
Chargement d'un environnement . . . . . . . . . . . . . . . . . . . . 22
Restauration de l'environnement par d&eacute;faut . . . . . . . . . . . . . . 22
Suppression d'un environnement . . . . . . . . . . . . . . . . . . . . 22
Cr&eacute;ation et suppression de raccourcis clavier . . . . . . . . . . . . . . . 23
Cr&eacute;ation de raccourcis clavier . . . . . . . . . . . . . . . . . . . . . . 23
Suppression ou r&eacute;initialisation de touches de raccourci . . . . . . . 23
Configuration des param&egrave;tres g&eacute;n&eacute;raux . . . . . . . . . . . . . . . . . . 23
D&eacute;finition de la langue par d&eacute;faut et d'autres pr&eacute;f&eacute;rences . . . . . . 23
Activation ou d&eacute;sactivation de la confirmation . . . . . . . . . . . . 25
Activation, d&eacute;sactivation ou r&eacute;initialisation des notifications . . . . 25
ii
Chapitre 3 :
iii
Projets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
El&eacute;ments de base du projet . . . . . . . . . . . . . . . . . . . . . . . . . 26
A propos des projets . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Composants du projet d'aide . . . . . . . . . . . . . . . . . . . . . . 26
Fichiers d'un projet . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Fichier de projet principal (XPJ) . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Fichiers de dossiers (FPJ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Fichiers de mise en page source unique (SSL) . . . . . . . . . . . . . . . . 28
Fichiers de projet auxiliaires (APJ) . . . . . . . . . . . . . . . . . . . . . . . . . 29
Autres types de fichiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
A propos des types de sortie . . . . . . . . . . . . . . . . . . . . . . 29
Exigences de l'afficheur de l'utilisateur final . . . . . . . . . . . . . . 32
Cr&eacute;ation et gestion des projets . . . . . . . . . . . . . . . . . . . . . . . 33
Cr&eacute;ation d'un projet . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Cr&eacute;ation d'un projet par importation de documents . . . . . . . . . 35
Cr&eacute;ation d'un projet &agrave; l'aide de documents FrameMaker
ou Word . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Cr&eacute;ation d'un projet &agrave; l'aide d'un fichier de mappage DITA . . . . 36
Enregistrement de projets . . . . . . . . . . . . . . . . . . . . . . . . 36
D&eacute;sactivation de l'enregistrement automatique . . . . . . . . . . . . 36
Ouverture d'un projet . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Ouverture d'un projet lors du d&eacute;marrage de RoboHelp . . . . . . . 37
Ouverture d'un projet apr&egrave;s le d&eacute;marrage de RoboHelp . . . . . . . 38
Mise &agrave; niveau d'un projet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Verrouillage d'un projet sur la liste des derniers projets ouverts . . . .38
Modification des param&egrave;tres du projet . . . . . . . . . . . . . . . . 39
D&eacute;finition des options dans le volet Liste d'exclusion . . . . . . . . . 39
D&eacute;finition des options dans le volet Expressions . . . . . . . . . . . . . 40
D&eacute;finition des options dans le volet des termes &agrave; &laquo; Ignorer
toujours &raquo; . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
D&eacute;finition des options dans le volet Fichier LNG . . . . . . . . . . . . . 41
D&eacute;finition des options dans le volet Synonymes . . . . . . . . . . . . . 41
Modification du nom d'un projet . . . . . . . . . . . . . . . . . . . . 42
Affichage de projets . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
D&eacute;finir la mise en page des chapitres . . . . . . . . . . . . . . . . . . 43
Remarques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
D&eacute;placement des dossiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
G&eacute;rer des fichiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Affichage des rubriques par titre ou par nom de fichier . . . . . . . 43
Utilisation de la liste d'actions &agrave; faire . . . . . . . . . . . . . . . . . . . . . . 43
Modification de la liste des derniers projets ouverts . . . . . . . . . . 44
Ajout de fichiers et de dossiers au dossier Fichiers bagage . . . . . 45
Fonctionnalit&eacute;s suppl&eacute;mentaires avec le dossier Fichiers
bagage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Suppression des fichiers du dossier Fichiers bagage . . . . . . . . . . 45
Types de fichiers de mappage . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Suppression de rubriques de projets . . . . . . . . . . . . . . . . . . . . . . . 46
Gestion des dossiers . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Cr&eacute;ation de dossiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Dossiers du gestionnaire de projets . . . . . . . . . . . . . . . . . . . . . . . . 47
Modification du nom des dossiers . . . . . . . . . . . . . . . . . . . . . . . . . 49
D&eacute;placement de dossiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Suppression de dossiers personnalis&eacute;s . . . . . . . . . . . . . . . . . . . . . 49
Ic&ocirc;nes de fichiers et de dossiers . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Cr&eacute;ation de contenu multilingue . . . . . . . . . . . . . . . . . . . . . . 52
Prise en charge de plusieurs langues . . . . . . . . . . . . . . . . . . 53
Organisation du travail de traduction . . . . . . . . . . . . . . . . . . 55
Comparaison entre plusieurs langues . . . . . . . . . . . . . . . . . . . . . . 56
S&eacute;lection d'une langue de traduction diff&eacute;rente pour
un fichier de projet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Cr&eacute;ation d'un projet dans une langue diff&eacute;rente . . . . . . . . . . . 56
Personnalisation du texte pour la localisation . . . . . . . . . . . . . 57
WebHelp, WebHelp Pro, FlashHelp et FlashHelp Pro . . . . . . . . . . 57
WebHelp uniquement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
HTML Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Modifier le fichier de libell&eacute;s . . . . . . . . . . . . . . . . . . . . . . 57
Remarques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Modification de la langue par d&eacute;faut d'un projet . . . . . . . . . . . 58
Remarques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Prise en charge de la langue du dictionnaire associ&eacute; . . . . . . . . . 58
Indexation de texte localis&eacute; . . . . . . . . . . . . . . . . . . . . . . . 58
Jeux de caract&egrave;res universels . . . . . . . . . . . . . . . . . . . . . . 59
Prise en charge d'Unicode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Configuration de langues de saisie sous Windows . . . . . . . . . . . . 60
Mise &agrave; niveau de projets localis&eacute;s . . . . . . . . . . . . . . . . . . . 60
Personnalisations mineures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Personnalisations majeures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Importation de fichiers PDF . . . . . . . . . . . . . . . . . . . . . . . . . 61
Cr&eacute;ation d'un projet par importation de fichier PDF . . . . . . . . . 62
Cr&eacute;ation de rubriques bas&eacute;es sur des styles . . . . . . . . . . . . . . . . . 63
Importation de fichiers PDF dans un projet . . . . . . . . . . . . . . 63
Importation et liaison de documents Word et FrameMaker . . . . . . . 64
Importation et liaison de documents Microsoft Word . . . . . . . . . . 64
Etapes pour importer un document Word dans RoboHelp . . . . . . 64
Etapes pour lier un document Word &agrave; partir de RoboHelp . . . . . . 64
Cr&eacute;ation de liens par rapport &agrave; l'importation de documents Word . . . .65
Optimisation des documents Word pour les sorties en ligne . . . . . 67
Cr&eacute;ation de liens dans les options des documents Word . . . . . . . 68
Liaison et importation de documents Word . . . . . . . . . . . . . . 69
Cr&eacute;ation d'un projet par importation d'un document Word . . . . 69
Liaison d'un document Word &agrave; un projet RoboHelp . . . . . . . . . . 69
Importation d'un document Word dans un projet RoboHelp . . . 70
iv
Importation d'une table des mati&egrave;res, d'un index et
d'un glossaire Word . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Conversion d'en-t&ecirc;tes et de pieds de page dans des documents
Word . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Conversion de styles Word en styles RoboHelp . . . . . . . . . . . . 72
S&eacute;lection de la feuille de style en cascade pour le mappage
de styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Mappage automatique des styles . . . . . . . . . . . . . . . . . . . . . . . . . 73
Conversion de styles de paragraphe Word en styles RoboHelp . . . . .73
Conversion de styles de caract&egrave;re Word en styles RoboHelp . . . 74
Mappage de liste . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Cr&eacute;ation de balises HTML personnalis&eacute;es . . . . . . . . . . . . . . . . . . . 76
Conversion de styles de tableau Word en styles de tableau
RoboHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Conversion de r&eacute;f&eacute;rences Word en liens hypertexte . . . . . . . . . . 76
Cr&eacute;ation de styles RoboHelp &agrave; partir du formatage en ligne . . . . 77
Pagination et d&eacute;signation des rubriques dans les fichiers Word
convertis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
D&eacute;finition de la pagination des rubriques d'aide en ligne . . . . . . 77
Conversion des marqueurs d'aide contextuelle dans
Word en ID de mappage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
D&eacute;finition du mod&egrave;le de nom pour les rubriques g&eacute;n&eacute;r&eacute;es . . . . 79
Synchronisation des documents Word li&eacute;s avec des projets
RoboHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Indicateurs d'&eacute;tat de la synchronisation de document Word . . . 81
G&eacute;n&eacute;ration de rubriques &agrave; partir de documents Word li&eacute;s . . . . . 82
Mise &agrave; jour des rubriques g&eacute;n&eacute;r&eacute;es &agrave; partir de documents
Word li&eacute;s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Conservation des modifications d'une rubrique au cours
d'une mise &agrave; jour . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Suppression d'une rubrique g&eacute;n&eacute;r&eacute;e . . . . . . . . . . . . . . . . . . . . . . . 83
R&eacute;g&eacute;n&eacute;ration d'une rubrique supprim&eacute;e . . . . . . . . . . . . . . . . . . . 84
Modification d'un document Word li&eacute; . . . . . . . . . . . . . . . . . . . . . . 84
Suppression d'un document Word li&eacute; . . . . . . . . . . . . . . . . . . . . . . 84
Restauration d'un lien vers un document Word manquant ou
renomm&eacute; . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Param&egrave;tres de conversion de Word . . . . . . . . . . . . . . . . . . . 85
Exportation des param&egrave;tres de conversion . . . . . . . . . . . . . . . . . . 85
Importation des param&egrave;tres de conversion dans un projet . . . . 85
Composants d'un document Word convertis vers RoboHelp . . . . . 86
Importation de documents FrameMaker . . . . . . . . . . . . . . . . . . 87
Optimisation pour la sortie en ligne avant conversion . . . . . . . . 87
Pr&eacute;paration de documents FrameMaker &agrave; la conversion en
fichiers d'aide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Importation de documents FrameMaker . . . . . . . . . . . . . . . . 90
v
Cr&eacute;ation d'un projet RoboHelp en important des livres
ou des documents FrameMaker . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Importation d'un livre FrameMaker dans un nouveau projet
RoboHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Importation de documents FrameMaker dans un projet
RoboHelp existant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Composants d'un document FrameMaker convertis vers
RoboHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Concepts de base de la conversion . . . . . . . . . . . . . . . . . . . 95
Conversion d'une table des mati&egrave;res FrameMaker . . . . . . . . . . . 95
Importation des entr&eacute;es d'index FrameMaker . . . . . . . . . . . . . . . 96
Importation des d&eacute;finitions de glossaire . . . . . . . . . . . . . . . . . . . . 97
Application de conditions &agrave; partir d'un fichier Ditaval . . . . . . . . . 97
Conversion des formats FrameMaker en styles RoboHelp . . . . . 97
S&eacute;lection d'un mod&egrave;le FrameMaker de conversion . . . . . . . . . . . 97
S&eacute;lection de la feuille de style en cascade pour le mappage
de styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Mise &agrave; niveau de RoboHelp 7 vers RoboHelp 11 . . . . . . . . . . . . . 98
Structure hi&eacute;rarchique d'un livre FrameMaker 9 . . . . . . . . . . . . 100
Conversion des formats de r&eacute;f&eacute;rences crois&eacute;es FrameMaker
en styles RoboHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
R&eacute;f&eacute;rence au contenu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Param&egrave;tres de conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
D&eacute;finition de la pagination et des noms de rubrique . . . . . . . . 101
Principes de base de la pagination . . . . . . . . . . . . . . . . . . . . . . . . 101
Principes de base de nom de rubrique . . . . . . . . . . . . . . . . . . . . 103
D&eacute;finir la pagination et les noms de rubrique . . . . . . . . . . . . . . . 104
Conversion des marqueurs d'aide contextuelle de documents
FrameMaker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Application d'expressions FrameMaker de cr&eacute;ation de texte
conditionnel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Conversion de contenu FrameMaker . . . . . . . . . . . . . . . . . 106
Conversion des formats de paragraphes FrameMaker en styles
RoboHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Conversion des formats de caract&egrave;res FrameMaker en styles
RoboHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Exclusion d'un format de paragraphe FrameMaker des
rubriques RoboHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Balises HTML personnalis&eacute;es . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Mise en correspondance des styles de num&eacute;rotation
automatique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Sc&eacute;narios de mise en correspondance de listes . . . . . . . . . . . . . 108
Conversion des formats de tableaux FrameMaker en styles de
tableau RoboHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Param&egrave;tres de conversion d'image . . . . . . . . . . . . . . . . . . . . . . . 111
Conservation d'images converties . . . . . . . . . . . . . . . . . . . . . . . . 113
vi
Cr&eacute;ation de texte de substitution pour des images . . . . . . . . . . 114
Importation d'un fichier de mappage DITA . . . . . . . . . . . . . . . . 114
Importation de fichiers XML . . . . . . . . . . . . . . . . . . . . . . . . 116
S&eacute;lection du gestionnaire d'importation XML . . . . . . . . . . . . 116
Bo&icirc;te de dialogue Options d'importation XML avanc&eacute;es . . . . . . 117
A propos du Programme de supervision des gestionnaires XML . . . . 117
Importation de projets Microsoft HTML Help . . . . . . . . . . . . . . 118
Importation de projets WinHelp . . . . . . . . . . . . . . . . . . . . . 119
Importation des param&egrave;tres projet WinHelp . . . . . . . . . . . . 119
Fen&ecirc;tres contextuelles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Aide Qu'est-ce que c'est ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Rubriques externes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Puces/Num&eacute;rotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Conseils : . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Options d'importation des dossiers WinHelp . . . . . . . . . . . . 120
Dossier de fichiers HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Dossiers pour les images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Options du fichier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Options d'importation du formatage WinHelp . . . . . . . . . . . . 121
Options d'importation g&eacute;n&eacute;rales WinHelp . . . . . . . . . . . . . . 122
Volet de navigation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Volet par d&eacute;faut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Avanc&eacute; . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Fichiers HLP et HPJ . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Questions fr&eacute;quentes sur la cr&eacute;ation de projets HTML &agrave; partir de
WinHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Importation d'un fichier WinHelp HLP dans un projet HTML . . . . 125
Conseils : . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Limitations HTML avec les fichiers HLP . . . . . . . . . . . . . . . . . . . . 127
Conseils pour la cr&eacute;ation de projets HTML avec des fichiers
HLP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Importation d'un fichier WinHelp HPJ dans un projet HTML . . . . 129
Conseils pour la cr&eacute;ation de projets HTML avec des fichiers
HPJ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Ajout de projets au contr&ocirc;le de version . . . . . . . . . . . . . . . . . 130
A propos du contr&ocirc;le de version . . . . . . . . . . . . . . . . . . . 130
Application du contr&ocirc;le de version . . . . . . . . . . . . . . . . . . 131
Acc&egrave;s aux options de contr&ocirc;le de version dans les conteneurs . . . 131
Questions fr&eacute;quentes sur le contr&ocirc;le de version . . . . . . . . . . 132
Fonctionnement du contr&ocirc;le de version . . . . . . . . . . . . . . . . . . . 132
Comment plusieurs auteurs peuvent-ils utiliser le contr&ocirc;le
de version ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Les projets &agrave; un seul utilisateur peuvent-ils utiliser le
contr&ocirc;le de version ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Est-il possible de proc&eacute;der &agrave; une extraction multi-utilisateur ? . . . 132
vii
O&ugrave; puis-je d&eacute;finir les options de contr&ocirc;le de version pour
RoboHelp ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Mon programme de contr&ocirc;le de version est-il n&eacute;cessaire &agrave;
l'ext&eacute;rieur de RoboHelp ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Faut-il extraire le fichier de projet (XPJ) pour modifier
le projet ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Les &eacute;l&eacute;ments ajout&eacute;s au projet sont-ils &eacute;galement ajout&eacute;s au
contr&ocirc;le de version ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Les &eacute;l&eacute;ments supprim&eacute;s du projet sont-ils &eacute;galement
supprim&eacute;s du contr&ocirc;le de version ? . . . . . . . . . . . . . . . . . . . . . . . 133
O&ugrave; sont les derni&egrave;res modifications effectu&eacute;es par l'&eacute;quipe ? . . . . 133
Comment ajouter des fichiers de sortie au contr&ocirc;le
de version ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Ajout d'un projet RoboHelp au contr&ocirc;le de version . . . . . . . . . 133
Archivage/extraction de fichiers . . . . . . . . . . . . . . . . . . . 134
Contr&ocirc;le de version avec Microsoft SharePoint . . . . . . . . . . . . . 135
Configuration des param&egrave;tres RoboHelp pour SharePoint . . . . . 135
Configuration des param&egrave;tres de SharePoint . . . . . . . . . . . . 136
Ajout d'un projet &agrave; une biblioth&egrave;que de documents SharePoint . . . . 137
Fusion de projets d'aide . . . . . . . . . . . . . . . . . . . . . . . . . . 137
A propos des projets d'aide fusionn&eacute;s . . . . . . . . . . . . . . . . 137
Cr&eacute;ation d'un projet ma&icirc;tre . . . . . . . . . . . . . . . . . . . . . . 138
Remarques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Publication de projets enfants . . . . . . . . . . . . . . . . . . . . . 140
Affichage des projets d'aide fusionn&eacute;s . . . . . . . . . . . . . . . . 141
Suppression de projets enfants fusionn&eacute;s . . . . . . . . . . . . . . 141
Personnalisation des projets Responsive HTML5, WebHelp Pro,
ou FlashHelp Pro fusionn&eacute;s . . . . . . . . . . . . . . . . . . . . . . 141
Questions fr&eacute;quentes sur la fusion des projets . . . . . . . . . . . 142
Projets ma&icirc;tres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Fonctionnalit&eacute;s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Projets WebHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Projets d'aide HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Projets Adobe AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Rapports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Exportation de rapports de projet . . . . . . . . . . . . . . . . . . 145
Impression des rapports . . . . . . . . . . . . . . . . . . . . . . . . 145
Envoi de rapports . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
G&eacute;n&eacute;ration et personnalisation de rapports . . . . . . . . . . . . . 146
Rapport sur les liens rompus . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Rapport sur les balises de construction conditionnelles . . . . . . 146
Rapport Voir aussi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Rapport sur l'index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Rapport sur les ID de mappage en double . . . . . . . . . . . . . . . . . 147
Rapport sur les rubriques externes . . . . . . . . . . . . . . . . . . . . . . . 148
Rapport sur le glossaire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
viii
Rapport sur les images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Rapport sur les ID de mappage . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Rapport sur l'&eacute;tat du projet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Rapport sur les extraits de code . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Rapport sur les feuilles de style . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Rapport sur la table des mati&egrave;res . . . . . . . . . . . . . . . . . . . . . . . . 149
Rapport sur les propri&eacute;t&eacute;s de rubriques . . . . . . . . . . . . . . . . . . . 150
Rapport sur les r&eacute;f&eacute;rences de rubriques . . . . . . . . . . . . . . . . . . . 150
Rapport sur les rubriques par priorit&eacute; . . . . . . . . . . . . . . . . . . . . . 151
Rapport sur les rubriques non r&eacute;f&eacute;renc&eacute;es . . . . . . . . . . . . . . . . . 151
Rapport sur les fichiers inutilis&eacute;s . . . . . . . . . . . . . . . . . . . . . . . . . 151
Rapport sur les mots-cl&eacute;s d'index inutilis&eacute;s . . . . . . . . . . . . . . . . 152
Rapport sur les fichiers utilis&eacute;s . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Rapport sur les rubriques manquantes . . . . . . . . . . . . . . . . . . . . 152
Rapport sur les variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
R&eacute;f&eacute;rences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Bo&icirc;te de dialogue Propri&eacute;t&eacute;s de l'URL . . . . . . . . . . . . . . . . 153
Bo&icirc;te de dialogue de suppression d'ancien projet . . . . . . . . . . 153
Bo&icirc;te de dialogue D&eacute;placer le fichier dans le projet . . . . . . . . . 153
Aide pour les options de style HTML . . . . . . . . . . . . . . . . . 153
Conseils : . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Param&egrave;tres avanc&eacute;s de HTML help – Trois volets . . . . . . . . . . 154
Boutons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Volet de navigation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Police . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Param&egrave;tres avanc&eacute;s de HTML Help – Onglet Table des mati&egrave;res . . . . 155
Chapitre 4 :
ix
Utilisation des rubriques . . . . . . . . . . . . . . . . . . . . . . . . .156
Cr&eacute;ation, enregistrement et ouverture des rubriques . . . . . . . . . . 156
Cr&eacute;er une rubrique . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Enregistrement de rubriques . . . . . . . . . . . . . . . . . . . . . 157
Enregistrement d'une rubrique . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Activation ou d&eacute;sactivation de l'enregistrement . . . . . . . . . . . . 157
Modification du nom des fichiers de rubrique . . . . . . . . . . . . 157
Ouverture de rubriques . . . . . . . . . . . . . . . . . . . . . . . . 158
Prise en charge de plusieurs documents dans la m&ecirc;me interface . . . 158
Cr&eacute;ation de code XHTML . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Conversion de code XHTML en HTML . . . . . . . . . . . . . . . . . 159
Validation de code XHTML . . . . . . . . . . . . . . . . . . . . . . . 160
Importation et copie de rubriques . . . . . . . . . . . . . . . . . . . . 160
Importation de rubriques . . . . . . . . . . . . . . . . . . . . . . . 160
Copie de rubriques dans un projet . . . . . . . . . . . . . . . . . . 160
Affichage des rubriques et des &eacute;l&eacute;ments de conception . . . . . . . . 161
Aper&ccedil;u des rubriques . . . . . . . . . . . . . . . . . . . . . . . . . 161
Remarques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
D&eacute;finition d'une expression de construction conditionnelle . . . . 162
Affichage des &eacute;l&eacute;ments de conception . . . . . . . . . . . . . . . . 163
Pages principales . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Cr&eacute;ation d'une page principale . . . . . . . . . . . . . . . . . . . . 164
Cr&eacute;ation d'une page principale &agrave; partir d'une rubrique . . . . . . . 165
Mise en forme des pages principales . . . . . . . . . . . . . . . . . 165
Modification d'une page principale . . . . . . . . . . . . . . . . . . . . . . . 165
Modifiez le fichier CSS associ&eacute; &agrave; la page principale . . . . . . . . . . 166
Insertion d'un espace r&eacute;serv&eacute; . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
Mise en forme et modification des espaces r&eacute;serv&eacute;s . . . . . . . . 166
Importation de pages principales . . . . . . . . . . . . . . . . . . . 167
Application de pages principales . . . . . . . . . . . . . . . . . . . 167
Application d'une page principale &agrave; une rubrique . . . . . . . . . . . 167
Application d'une page principale &agrave; plusieurs rubriques . . . . . . 167
Application d'une page principale ou d'une feuille CSS lors de la
g&eacute;n&eacute;ration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
Ajout d'en-t&ecirc;tes et de pieds de page pour la documentation
imprim&eacute;e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
Gestion des rubriques . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Modification du nom d'une rubrique . . . . . . . . . . . . . . . . . 169
Mise &agrave; jour des r&eacute;f&eacute;rences de rubriques . . . . . . . . . . . . . . . 169
Ajout de tirets de soulignement aux noms de fichier . . . . . . . . 170
Modification des propri&eacute;t&eacute;s de rubriques . . . . . . . . . . . . . . 170
Modification des propri&eacute;t&eacute;s de rubrique sur l'onglet Index
(WebHelp Pro) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Modification de pages principales . . . . . . . . . . . . . . . . . . . . . . . . 171
Recherche d'une rubrique . . . . . . . . . . . . . . . . . . . . . . . 172
Recherchez les rubriques ou les images dans le Gestionnaire
de projets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
Assignation d'une rubrique par d&eacute;faut . . . . . . . . . . . . . . . . 173
Etat du suivi de la rubrique . . . . . . . . . . . . . . . . . . . . . . 174
Affichez et g&eacute;rez les informations sur les rubriques dans le
conteneur Listes des rubriques . . . . . . . . . . . . . . . . . . . . 174
Utilisation de la liste de balises . . . . . . . . . . . . . . . . . . . . 175
V&eacute;rification d'orthographe et fonction rechercher/remplacer . . . . . 175
V&eacute;rification orthographique dans la table des mati&egrave;res,
l'index ou le glossaire . . . . . . . . . . . . . . . . . . . . . . . . . 175
D&eacute;finition des options de v&eacute;rification orthographique . . . . . . . 176
Options principales . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Options sp&eacute;ciales . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Options de correction orthographique automatique . . . . . . . . . 176
Affichage de la liste Mots ignor&eacute;s . . . . . . . . . . . . . . . . . . . . . . . . 177
V&eacute;rification orthographique dans les rubriques ou les projets . . . 177
Options de v&eacute;rification orthographique pour les rubriques . . . 178
Options de v&eacute;rification orthographique pour les projets . . . . . . 178
Personnalisation d'un dictionnaire . . . . . . . . . . . . . . . . . . 179
Utilisation du th&eacute;saurus . . . . . . . . . . . . . . . . . . . . . . . . 180
x
Recherche et remplacement . . . . . . . . . . . . . . . . . . . . . 180
D&eacute;finition des options de recherche et remplacement . . . . . . . 181
Affichage des r&eacute;sultats de la recherche . . . . . . . . . . . . . . . . . . . . 184
Conformit&eacute; W3C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
R&eacute;f&eacute;rences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
Volet g&eacute;n&eacute;ral pour les projets Oracle . . . . . . . . . . . . . . . . . 185
Chapitre 5 :
xi
Modification et formatage . . . . . . . . . . . . . . . . . . . . . . . .187
Editeurs RoboHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
Editeur de conception RoboHelp . . . . . . . . . . . . . . . . . . . 187
Editeur RoboHelp HTML . . . . . . . . . . . . . . . . . . . . . . . . 187
Ouverture de l'&eacute;diteur RoboHelp HTML . . . . . . . . . . . . . . . . . . . 187
Annulation d'une modification . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
Affichage des num&eacute;ros de ligne . . . . . . . . . . . . . . . . . . . . . . . . . . 187
Ajout d'extensions de mots-cl&eacute;s . . . . . . . . . . . . . . . . . . . . . . . . . 188
Modification de la couleur du code . . . . . . . . . . . . . . . . . . . . . . . 188
Editeurs HTML tiers . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Utilisation de RoboHelp avec d'autres &eacute;diteurs HTML . . . . . . . . 189
Ajout d'un &eacute;diteur HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Suppression d'un &eacute;diteur HTML ou modification de son nom . . . . 189
S&eacute;lection automatique d'un &eacute;diteur HTML ou d&eacute;finition d'un
&eacute;diteur HTML par d&eacute;faut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
Sp&eacute;cification d'un &eacute;diteur &agrave; associer aux nouvelles rubriques . . . . 191
Formatage de caract&egrave;res et polices . . . . . . . . . . . . . . . . . . . . 191
Application ou suppression d'un formatage de caract&egrave;res . . . . . 191
Application d'une couleur au texte . . . . . . . . . . . . . . . . . . 192
D&eacute;finition des options de police avanc&eacute;es . . . . . . . . . . . . . . 192
Modification de l'espacement entre les caract&egrave;res . . . . . . . . . 192
Modification des tailles de police . . . . . . . . . . . . . . . . . . . 193
Cr&eacute;ation d'un jeu de polices . . . . . . . . . . . . . . . . . . . . . . 193
Application d'un jeu de polices &agrave; un texte . . . . . . . . . . . . . . 193
Modification de jeux de polices . . . . . . . . . . . . . . . . . . . . 193
Suppression de jeux de polices . . . . . . . . . . . . . . . . . . . . 194
Insertion de symboles et de caract&egrave;res sp&eacute;ciaux . . . . . . . . . . 194
Insertion d'un espace ins&eacute;cable . . . . . . . . . . . . . . . . . . . . 194
Mise en forme des paragraphes . . . . . . . . . . . . . . . . . . . . . . 194
Alignement des paragraphes . . . . . . . . . . . . . . . . . . . . . 194
Retrait de paragraphes . . . . . . . . . . . . . . . . . . . . . . . . . 195
Retrait de lignes de texte . . . . . . . . . . . . . . . . . . . . . . . 195
Modification de marges . . . . . . . . . . . . . . . . . . . . . . . . 196
Conseils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
Modification de l'unit&eacute; de mesure de la r&egrave;gle . . . . . . . . . . . . 196
D&eacute;finition d'une langue pour un paragraphe . . . . . . . . . . . . 196
Application d'un habillage de texte . . . . . . . . . . . . . . . . . . 197
Remarques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
R&eacute;glage de l'espacement des lignes . . . . . . . . . . . . . . . . . 197
Ajout de sauts de ligne dans les paragraphes . . . . . . . . . . . . 197
Bordures, arri&egrave;re-plans, couleur et sons . . . . . . . . . . . . . . . . . 198
Ajout ou modification de bordures et d'arri&egrave;re-plans de rubriques . . . 198
Ajout de bordures &agrave; des images . . . . . . . . . . . . . . . . . . . . 198
Suppression de bordures ou d'arri&egrave;re-plans . . . . . . . . . . . . . 198
Ajout ou suppression de lignes horizontales . . . . . . . . . . . . . 199
Ajout d'une ligne horizontale . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Suppression d'une ligne horizontale . . . . . . . . . . . . . . . . . . . . . . 199
Modification des couleurs . . . . . . . . . . . . . . . . . . . . . . . 199
Suppression de couleurs . . . . . . . . . . . . . . . . . . . . . . . . 199
Ajout de son aux rubriques . . . . . . . . . . . . . . . . . . . . . . 200
Tableaux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
A propos des tableaux . . . . . . . . . . . . . . . . . . . . . . . . . 200
Processus de cr&eacute;ation d'un tableau . . . . . . . . . . . . . . . . . . 201
Insertion de tableaux . . . . . . . . . . . . . . . . . . . . . . . . . . 201
Insertion d'un tableau de base . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
Insertion d'un tableau personnalis&eacute; . . . . . . . . . . . . . . . . . . . . . . 201
Insertion de tableaux dans des tableaux . . . . . . . . . . . . . . . . . . . 202
Copie et collage de tableaux . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
Modification de tableaux . . . . . . . . . . . . . . . . . . . . . . . 202
Insertion de lignes et de colonnes dans un tableau . . . . . . . . . . 202
Modification des propri&eacute;t&eacute;s de tableau . . . . . . . . . . . . . . . . . . . 203
D&eacute;finition des propri&eacute;t&eacute;s d'ajustement automatique
d'un tableau . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
Modification des propri&eacute;t&eacute;s d'une cellule . . . . . . . . . . . . . . . . . . 203
Modification de l'espacement dans les cellules . . . . . . . . . . . . . 203
Fusion ou division de cellules de tableau . . . . . . . . . . . . . . . . . . 204
Listes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
Application d'un retrait aux listes . . . . . . . . . . . . . . . . . . . 204
Application de styles de puce . . . . . . . . . . . . . . . . . . . . . 204
Sp&eacute;cification d'un style de puces en ligne . . . . . . . . . . . . . . . . . . 204
Cr&eacute;ation d'un style de puce pour une feuille de style . . . . . . . . 204
Mise en correspondance des couleurs des puces et du texte . . . 205
Mise en correspondance des couleurs &agrave; l'aide d'un style
en ligne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
Mise en correspondance des couleurs &agrave; l'aide d'une feuille
de style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
Suppression des puces et de la num&eacute;rotation . . . . . . . . . . . . 205
Application d'un format de num&eacute;rotation . . . . . . . . . . . . . . 206
Ajout d'un paragraphe &agrave; une liste . . . . . . . . . . . . . . . . . . . 206
Reprise ou poursuite de la num&eacute;rotation num&eacute;rique ou
alphab&eacute;tique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
En-t&ecirc;tes de page, pieds de page et sauts de page . . . . . . . . . . . . 207
En-t&ecirc;tes et pieds de page . . . . . . . . . . . . . . . . . . . . . . . 207
Cr&eacute;ation ou modification d'en-t&ecirc;tes et de pieds de page . . . . . 207
Suppression d'en-t&ecirc;tes et de pieds de page . . . . . . . . . . . . . . . . 207
xii
Insertion de sauts de page . . . . . . . . . . . . . . . . . . . . . . . 208
Zones de texte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Insertion de zones de texte dans les rubriques . . . . . . . . . . . 208
Remarques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Insertion d'une zone de texte . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Insertion d'une zone de texte positionn&eacute;e . . . . . . . . . . . . . . . . . 208
Superposition de zones de texte positionn&eacute;es . . . . . . . . . . . . 208
Modification des propri&eacute;t&eacute;s de zone de texte . . . . . . . . . . . . 209
Suppression de zones de texte d'une rubrique . . . . . . . . . . . 209
Variables d&eacute;finies par l'utilisateur . . . . . . . . . . . . . . . . . . . . . 209
Cr&eacute;ation d'une variable d&eacute;finie par l'utilisateur . . . . . . . . . . . 210
Cr&eacute;ation d'un jeu de variables . . . . . . . . . . . . . . . . . . . . . 210
Modification d'une variable d&eacute;finie par l'utilisateur . . . . . . . . . 211
Mise en forme d'une variable d&eacute;finie par l'utilisateur . . . . . . . . 211
Insertion d'une variable d&eacute;finie par l'utilisateur . . . . . . . . . . . 211
Affichage des propri&eacute;t&eacute;s d'une variable d&eacute;finie par l'utilisateur . . . . 212
Activer/d&eacute;sactiver les vues variables . . . . . . . . . . . . . . . . . 212
Suppression d'une variable d&eacute;finie par l'utilisateur . . . . . . . . . 212
Modification du nom d'une variable d&eacute;finie par l'utilisateur . . . . 213
Source unique pour les extraits de code . . . . . . . . . . . . . . . . . 213
Cr&eacute;ation et gestion des extraits de code . . . . . . . . . . . . . . . 214
Insertion d'un extrait de code dans une rubrique . . . . . . . . . . 215
Insertion d'un extrait de code dans un &eacute;diteur de texte d&eacute;roulant . . . 215
Application de balises de construction conditionnelles &agrave;
un extrait de code . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
Insertion de variables dans des extraits de code . . . . . . . . . . 215
Conversion d'un extrait de code en texte . . . . . . . . . . . . . . 215
Suppression d'un extrait de code . . . . . . . . . . . . . . . . . . . 216
R&eacute;f&eacute;rences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
Editeur par d&eacute;faut de balises META . . . . . . . . . . . . . . . . . . 216
Chapitre 6 :
xiii
Styles et feuilles de style . . . . . . . . . . . . . . . . . . . . . . . . .217
Types de styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
R&egrave;gles et attributs de supports dans les styles . . . . . . . . . . . . . . 218
D&eacute;finition des styles sp&eacute;cifiques au m&eacute;dia dans une feuille
de style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
Ajout d'une r&egrave;gle de support dans les styles de la rubrique . . . . 218
Association de fichiers CSS sp&eacute;cifiques aux supports &agrave; une
rubrique et ajouts d'attributs de supports dans le code HTML . . . 219
Syntaxe de la balise de liaison . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
Exemples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
Mappage de styles dans du contenu Word/FrameMaker vers
des styles sp&eacute;cifiques au support . . . . . . . . . . . . . . . . . . . 219
Affichage du contenu dans les styles sp&eacute;cifiques au support dans
la vue Conception . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
Suppression d'un style sp&eacute;cifique au support . . . . . . . . . . . . 220
Demandes de supports . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
Gestion des demandes de supports pour les profils d'&eacute;cran . . . . 220
Gestion des feuilles de style . . . . . . . . . . . . . . . . . . . . . . . . 221
Association d'une feuille de style aux rubriques ou aux pages
principales . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Suppression de l'association d'une feuille de style aux rubriques
ou aux pages principales . . . . . . . . . . . . . . . . . . . . . . . . 221
Cr&eacute;ation d'une feuille de style . . . . . . . . . . . . . . . . . . . . . 222
Cr&eacute;ation simultan&eacute;e d'une feuille de style et d'une rubrique . . . 222
Exportation d'une feuille de style . . . . . . . . . . . . . . . . . . . 222
Cr&eacute;ation de styles pour des feuilles de style . . . . . . . . . . . . . . . 223
Cr&eacute;ation d'un style dans la bo&icirc;te de dialogue Styles . . . . . . . . . 223
Cr&eacute;ation d'un style via le conteneur Styles et formatage . . . . . . 224
Cr&eacute;ation d'un style via l'&eacute;diteur de conception . . . . . . . . . . . 224
Styles de tableau . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
Styles de tableau globaux . . . . . . . . . . . . . . . . . . . . . . . 224
Application de styles de tableau . . . . . . . . . . . . . . . . . . . 225
Cr&eacute;ation et gestion des styles de tableau . . . . . . . . . . . . . . 225
Cr&eacute;ation de styles de tableau . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
Application de balises de construction conditionnelles
aux tableaux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
Styles de liste . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
A propos des styles de liste . . . . . . . . . . . . . . . . . . . . . . 226
Cr&eacute;ation de listes HTML . . . . . . . . . . . . . . . . . . . . . . . . 227
Cr&eacute;ation de listes multi-niveaux . . . . . . . . . . . . . . . . . . . . 227
Cr&eacute;ation d'un style avec num&eacute;rotation automatique . . . . . . . . 228
Cr&eacute;ation d'un pr&eacute;fixe de s&eacute;quencement . . . . . . . . . . . . . . . 228
Modification d'un pr&eacute;fixe de s&eacute;quencement . . . . . . . . . . . . . 229
Suppression d'une s&eacute;quence personnalis&eacute;e . . . . . . . . . . . . . 229
Styles HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Cr&eacute;ation de styles en fonction des styles Div, Hyperlien et Image . . . 229
Modification du style Div . . . . . . . . . . . . . . . . . . . . . . . 230
Modification des styles Hyperlien . . . . . . . . . . . . . . . . . . . 230
Utilisation des pseudo-classes . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
Utilisation des images Twisty . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
Utilisation des hyperliens Style de bloc . . . . . . . . . . . . . . . . . . . . 230
Modifications des styles d'images . . . . . . . . . . . . . . . . . . 231
Application des styles . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Modification de styles dans les fichiers CSS . . . . . . . . . . . . . . . 231
Modification d'un style via la bo&icirc;te de dialogue Styles . . . . . . . 232
Modification d'un style via le conteneur Styles et formatage . . . 232
Modification des styles dans un &eacute;diteur HTML . . . . . . . . . . . 232
Suppression de styles de feuilles de style . . . . . . . . . . . . . . . . . 232
Utilisation des couleurs et des images . . . . . . . . . . . . . . . . . . 233
Modification de la couleur du texte et des liens dans une
feuille de style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
xiv
Ajout ou modification des bordures ou des arri&egrave;re-plans dans
les feuilles de style . . . . . . . . . . . . . . . . . . . . . . . . .
Styles en ligne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Application ou modification des styles en ligne . . . . . . . . .
Mettre &agrave; jour les styles en ligne . . . . . . . . . . . . . . . . . .
Suppression de styles en ligne du texte . . . . . . . . . . . . .
R&eacute;initialisation des styles . . . . . . . . . . . . . . . . . . . . . . .
Par exemple (R&eacute;initialiser un style de tableau) . . . . . . . . .
Suppression du formatage . . . . . . . . . . . . . . . . . . . . . . .
Chapitre 7 :
xv
.
.
.
.
.
.
.
.
. 234
. 234
. 234
. 234
. 235
. 235
. 235
. 236
Tables des mati&egrave;res, index et glossaires . . . . . . . . . . . . . . . . .237
Tables des mati&egrave;res . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
El&eacute;ments de base sur les tables des mati&egrave;res . . . . . . . . . . . . 237
A propos des tables des mati&egrave;res . . . . . . . . . . . . . . . . . . . . . . . . 237
Cr&eacute;ation de tables des mati&egrave;res . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Impression des tables des mati&egrave;res . . . . . . . . . . . . . . . . . . . . . . . 238
Cr&eacute;ation de livres et de pages de table des mati&egrave;res . . . . . . . . 238
Cr&eacute;ation de livres de table des mati&egrave;res . . . . . . . . . . . . . . . . . . . 238
Cr&eacute;ation de livres et de pages de table des mati&egrave;res avec
liens cibl&eacute;s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Cr&eacute;ation de livres de table des mati&egrave;res &agrave; partir de pages . . . . 239
Cr&eacute;ation de pages de table des mati&egrave;res en faisant glisser les
rubriques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
Cr&eacute;ation de livres et de pages de table des mati&egrave;res avec des
variables d&eacute;finies par l'utilisateur . . . . . . . . . . . . . . . . . . . . . . . . 239
Edition de livres et de pages de table des mati&egrave;res . . . . . . . . . 240
Modification du nom des livres et des pages de table
des mati&egrave;res . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
R&eacute;organisation des livres et des pages d'une table des mati&egrave;res . .
240
Suppression de livres ou de pages de table des mati&egrave;res . . . . . 240
Modification des propri&eacute;t&eacute;s de livres et de pages de table des
mati&egrave;res . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
Gestion des tables des mati&egrave;res . . . . . . . . . . . . . . . . . . . 241
Gestion de tables de mati&egrave;res via des rapports . . . . . . . . . . . . . 241
Identification et r&eacute;paration des liens rompus dans une table
des mati&egrave;res . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
Tables des mati&egrave;res multiples . . . . . . . . . . . . . . . . . . . . . 242
A propos de la cr&eacute;ation de plusieurs tables des mati&egrave;res . . . . . 242
D&eacute;placement de livres et de pages vers les tables des mati&egrave;res . . . .242
Cr&eacute;ation de plusieurs tables des mati&egrave;res pour un projet . . . . . 243
Fusion de tables des mati&egrave;res . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
Cr&eacute;ation de s&eacute;quences de navigation &agrave; partir d'une table des
mati&egrave;res . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
El&eacute;ments de bases de l'index . . . . . . . . . . . . . . . . . . . . . 244
A propos des index et des mots-cl&eacute;s . . . . . . . . . . . . . . . . . . . . . . 244
Mots-cl&eacute;s de rubrique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
Mots-cl&eacute;s du fichier d'index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
D&eacute;finition des types de mots-cl&eacute;s utilis&eacute;s dans un projet . . . . . 246
Impression d'index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
Ajout de mots-cl&eacute;s d'index et cr&eacute;ation de liens . . . . . . . . . . . 247
Ajout de mots-cl&eacute;s d'index &agrave; l'aide de la barre d'outils . . . . . . . 247
Ajout de mots-cl&eacute;s d'index sur la base d'un titre de rubrique . . . . 248
Ajout de mots-cl&eacute;s d'index &agrave; l'aide des propri&eacute;t&eacute;s de rubrique . . . 248
Ajout de mots-cl&eacute;s d'index par s&eacute;lection de texte de rubrique . . . 248
Copie de mots-cl&eacute;s d'index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
S&eacute;lection d'une destination de mot-cl&eacute; d'index . . . . . . . . . . . . . 249
Cr&eacute;ation de mots-cl&eacute;s d'index &agrave; l'aide de variables d&eacute;finies par
l'utilisateur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Mots-cl&eacute;s d'index avec r&eacute;f&eacute;rence crois&eacute;e . . . . . . . . . . . . . . . . . . 250
Modification de mots-cl&eacute;s d'index . . . . . . . . . . . . . . . . . . 250
D&eacute;placement et classement des mots-cl&eacute;s d'index . . . . . . . . . . 250
Modification des mots-cl&eacute;s d'un projet . . . . . . . . . . . . . . . . . . . . 250
Modification des mots-cl&eacute; d'une rubrique . . . . . . . . . . . . . . . . . 251
Modification de la casse d'un mot-cl&eacute; . . . . . . . . . . . . . . . . . . . . . 251
Suppression de mots-cl&eacute;s d'index du conteneur Index . . . . . . . 251
Suppression de mots-cl&eacute;s d'index des rubriques . . . . . . . . . . . . 251
Gestion des index . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
Gestion des index &agrave; l'aide des rapports . . . . . . . . . . . . . . . . . . . . 251
Identification et correction des r&eacute;f&eacute;rences rompues dans les
rubriques de mots cl&eacute;s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
Suppression des r&eacute;f&eacute;rences de rubrique des mots-cl&eacute;s . . . . . . . 252
Suppression de mots-cl&eacute;s d'index inutilis&eacute;s . . . . . . . . . . . . . . . . 252
Application de balises de construction conditionnelles &agrave;
un index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Indexation automatique via l'assistant d'index dynamique . . . . . 253
Cr&eacute;ation automatique d'index . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
D&eacute;finition des mots-cl&eacute;s &agrave; ignorer . . . . . . . . . . . . . . . . . . . . . . . . 254
D&eacute;finition des mots courants &agrave; ignorer . . . . . . . . . . . . . . . . . . . . 255
D&eacute;finition des expressions personnalis&eacute;es . . . . . . . . . . . . . . . . . 255
Consultation de synonymes lors de l'indexation . . . . . . . . . . . . . 256
Index multiples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
Cr&eacute;ation de plusieurs index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
Fusion des index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
Tables des mati&egrave;res et index Microsoft HTML Help . . . . . . . . . . . 257
Assignation d'ic&ocirc;nes de table des mati&egrave;res personnalis&eacute;es
(HTML Help) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
Cr&eacute;ation de fichiers de contenu binaire (HTML Help) . . . . . . . . 258
Cr&eacute;ation d'index binaires (HTML Help) . . . . . . . . . . . . . . . . 258
Personnalisation d'une table des mati&egrave;res (HTML Help) . . . . . . 259
Personnalisation d'un index (HTML Help) . . . . . . . . . . . . . . 260
xvi
Ajout de contr&ocirc;les de table des mati&egrave;res (HTML Help) . . . . . . . 261
Ajout de contr&ocirc;les d'index (HTML Help) . . . . . . . . . . . . . . . 261
Association de mots-cl&eacute;s et d'&eacute;l&eacute;ments de table des mati&egrave;res
pour personnaliser les fen&ecirc;tres et les cadres (HTML Help) . . . . . 262
Glossaires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
Cr&eacute;ation de termes de glossaire . . . . . . . . . . . . . . . . . . . . 262
Importation de termes de glossaire et de d&eacute;finitions . . . . . . . . 263
Test et impression de glossaires . . . . . . . . . . . . . . . . . . . . 263
Test du glossaire dans le r&eacute;sultat . . . . . . . . . . . . . . . . . . . . . . . . . 263
Impression de glossaire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Suppression de termes du glossaire . . . . . . . . . . . . . . . . . 264
Modification des d&eacute;finitions de glossaire . . . . . . . . . . . . . . 264
Cr&eacute;ation de plusieurs glossaires . . . . . . . . . . . . . . . . . . . . 265
Fusion de glossaires . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Zones cliquables de glossaire . . . . . . . . . . . . . . . . . . . . . . . 266
A propos des zones cliquables de glossaire &agrave; d&eacute;velopper . . . . . . 266
Remarques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Ajout de zones cliquables de glossaire &agrave; d&eacute;velopper . . . . . . . . 266
Mise &agrave; jour de zones cliquables de glossaire &agrave; d&eacute;velopper . . . . . 267
Test des zones cliquables de glossaire &agrave; d&eacute;velopper . . . . . . . . 267
Annulation du marquage des zones cliquables de glossaire &agrave;
d&eacute;velopper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
Annulation du marquage des zones cliquables &agrave; l'aide de
l'assistant de cr&eacute;ation de zones cliquables de glossaire . . . . . . . 268
Annulation du marquage des zones cliquables dans la vue
Conception . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
Chapitre 8 :
xvii
Liaison, navigation et recherche . . . . . . . . . . . . . . . . . . . . .269
El&eacute;ments de navigation de base . . . . . . . . . . . . . . . . . . . . . . 269
Options de navigation . . . . . . . . . . . . . . . . . . . . . . . . . 269
A propos des chemins de navigation . . . . . . . . . . . . . . . . . 271
Ajout de chemins de navigation aux rubriques . . . . . . . . . . . 272
Cr&eacute;ation de liens de texte . . . . . . . . . . . . . . . . . . . . . . . . . 273
Cr&eacute;ation de liens de texte avec l'&eacute;diteur de conception . . . . . . 273
Cr&eacute;ation de liens par glisser-d&eacute;poser . . . . . . . . . . . . . . . . . 273
Lien vers des fen&ecirc;tres contextuelles . . . . . . . . . . . . . . . . . . . 274
Exclusion des fen&ecirc;tres contextuelles des recherches de texte
int&eacute;gral . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
Signets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Cr&eacute;ation d'un signet . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Cr&eacute;ation d'un lien vers un signet . . . . . . . . . . . . . . . . . . . 275
Modification du nom d'un signet . . . . . . . . . . . . . . . . . . . 275
Acc&egrave;s &agrave; un signet . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
Suppression d'un signet . . . . . . . . . . . . . . . . . . . . . . . . 276
Lien vers des images et des objets multim&eacute;dia . . . . . . . . . . . . . 276
Ajout de liens &agrave; des clips multim&eacute;dia . . . . . . . . . . . . . . . . . 276
Ajout de liens &agrave; partir d'images et d'objets multim&eacute;dia . . . . . . 276
Liens externes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
Lien vers des rubriques externes (projets Microsoft HTML Help) . . . . 277
Lien vers des fichiers externes . . . . . . . . . . . . . . . . . . . . . 277
Lien vers des rubriques WinHelp (projets Microsoft HTML Help) . . . . 277
Lien vers des adresses &eacute;lectroniques, sites FTP, groupes de
discussion et adresses Web . . . . . . . . . . . . . . . . . . . . . . 278
Affichage des liens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
Navigation dans le conteneur Affichage des liens . . . . . . . . . . 278
Modification de l'apparence des liens dans le conteneur
Affichage des liens . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
Modification de la taille des ic&ocirc;nes . . . . . . . . . . . . . . . . . . . . . . . 278
D&eacute;finition des options de d&eacute;filement de la fen&ecirc;tre
d'affichage des liens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
D&eacute;finition des options dans le conteneur Affichage des liens . . . 279
Gestion des liens et r&eacute;paration . . . . . . . . . . . . . . . . . . . . . . 279
Mise &agrave; jour et suppression de liens . . . . . . . . . . . . . . . . . . 279
Gestion des liens rompus . . . . . . . . . . . . . . . . . . . . . . . 280
R&eacute;paration de liens rompus . . . . . . . . . . . . . . . . . . . . . . 280
Identification et mise &agrave; jour des r&eacute;f&eacute;rences de rubrique . . . . . . 281
Identification des r&eacute;f&eacute;rences aux rubriques . . . . . . . . . . . . . . . . 281
Mise &agrave; jour des r&eacute;f&eacute;rences de rubriques . . . . . . . . . . . . . . . . . . . 281
Identification et mise &agrave; jour des r&eacute;f&eacute;rences de rubriques externes . . . 281
Affichage et test des hyperliens . . . . . . . . . . . . . . . . . . . . 282
Affichage des hyperliens et identification des s&eacute;quences de
navigation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
Test des liens dans une rubrique . . . . . . . . . . . . . . . . . . . . . . . . . 282
Contr&ocirc;les Lien . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
A propos des contr&ocirc;les Lien . . . . . . . . . . . . . . . . . . . . . . 282
Types de contr&ocirc;les Lien . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
Propri&eacute;t&eacute;s de lien de mot-cl&eacute; . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
Pour les projets Microsoft HTML Help : . . . . . . . . . . . . . . . . . . . . 284
Ajout de contr&ocirc;les Rubriques connexes . . . . . . . . . . . . . . . 284
Assistant Rubriques connexes . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
Pour les projets HTML Help avec des contr&ocirc;les Voir aussi
ou Lien de mot-cl&eacute; : . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
Cr&eacute;ation, assignation et ajout de mots-cl&eacute;s et contr&ocirc;les Voir aussi . . . 286
Cr&eacute;ation et assignation de mots-cl&eacute;s Voir aussi . . . . . . . . . . . . . 286
Conteneur Voir aussi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
D&eacute;finition des mots-cl&eacute;s Voir aussi dans l'assistant Voir aussi . . . . 286
D&eacute;finition de mots-cl&eacute;s dans un fichier CHM distant . . . . . . . . . 287
D&eacute;finition des mots-cl&eacute;s Voir aussi dans un fichier
CHM distant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
Ajout de contr&ocirc;les Voir aussi . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
Modification, r&eacute;utilisation et suppression de contr&ocirc;les Lien . . . . 288
Fen&ecirc;tres contextuelles purement textuelles . . . . . . . . . . . . . . . 289
xviii
Utilisation de fen&ecirc;tres contextuelles purement textuelles . . . . . 289
Cr&eacute;ation de fen&ecirc;tres contextuelles purement textuelles . . . . . . 289
Modification de fen&ecirc;tres contextuelles purement textuelles . . . . . 289
Suppression des fen&ecirc;tres contextuelles purement textuelles . . . . 289
Test des fen&ecirc;tres contextuelles purement textuelles . . . . . . . . 289
Test avant g&eacute;n&eacute;ration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
Test apr&egrave;s g&eacute;n&eacute;ration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
S&eacute;quences de navigation . . . . . . . . . . . . . . . . . . . . . . . . . . 290
Cr&eacute;ation ou modification de s&eacute;quences de navigation . . . . . . . 290
Cr&eacute;ation automatique de s&eacute;quences de navigation . . . . . . . . . . 290
Cr&eacute;ation manuelle de s&eacute;quences de navigation . . . . . . . . . . . . . 291
Suppression d'une rubrique d'une s&eacute;quence de navigation . . . 291
Suppression d'une s&eacute;quence de navigation ou modification
de son nom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
Affichage et test des s&eacute;quences de navigation . . . . . . . . . . . . 291
Identification des rubriques associ&eacute;es aux s&eacute;quences
de navigation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
Test des s&eacute;quences de navigation . . . . . . . . . . . . . . . . . . . . . . . . 291
Affichage des s&eacute;quences pour une rubrique . . . . . . . . . . . . . . . 292
Test des s&eacute;quences de navigation dans un navigateur ou
une vue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
Identification des s&eacute;quences de navigation auxquelles
une rubrique est assign&eacute;e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
Recherche de sortie RoboHelp . . . . . . . . . . . . . . . . . . . . . . 292
Principes de base de la recherche RoboHelp . . . . . . . . . . . . . 292
Ajout de m&eacute;tadonn&eacute;es de recherche . . . . . . . . . . . . . . . . . 294
Optimisation du contenu pour la recherche . . . . . . . . . . . . . 295
Configuration de l'exp&eacute;rience de recherche . . . . . . . . . . . . . 297
Recherche &agrave; saisie semi-automatique . . . . . . . . . . . . . . . . 298
Recherche de contenu externe . . . . . . . . . . . . . . . . . . . . . . 299
Configuration et gestion de la recherche de contenu externe . . . 299
Activation de la recherche de contenu externe . . . . . . . . . . . 300
Chapitre 9 :
xix
Multim&eacute;dia et effets sp&eacute;ciaux . . . . . . . . . . . . . . . . . . . . . .301
Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
Principes de base sur les images . . . . . . . . . . . . . . . . . . . 301
Formats de fichiers image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
Localisation d'images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
Copie d'une image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
Affichage d'une image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
Ajout d'une image dans une rubrique . . . . . . . . . . . . . . . . . . . . . 302
Ajout d'une image RoboScreenCapture dans une rubrique . . . 303
Suppression d'une image d'une rubrique . . . . . . . . . . . . . . . . . . 303
Modification d'une image dans RoboHelp . . . . . . . . . . . . . . . . . 304
Modification d'une image avec RoboScreenCapture . . . . . . . . . 304
Vignettes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
Prise en charge des vignettes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
Mappages d'image . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
Cr&eacute;ation d'une carte-image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
Modification d'un mappage d'image . . . . . . . . . . . . . . . . . . . . . . 307
D&eacute;monstrations Adobe Captivate . . . . . . . . . . . . . . . . . . . . . 307
Cr&eacute;ation d'une d&eacute;monstration Adobe Captivate . . . . . . . . . . . 307
Insertion d'une d&eacute;monstration Adobe Captivate . . . . . . . . . . 308
Importation d'une d&eacute;monstration Adobe Captivate . . . . . . . . . 308
Modification d'une d&eacute;monstration Adobe Captivate . . . . . . . . 309
Multim&eacute;dia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
Ajout d'&eacute;l&eacute;ments multim&eacute;dia . . . . . . . . . . . . . . . . . . . . . 309
Modification d'&eacute;l&eacute;ments multim&eacute;dia . . . . . . . . . . . . . . . . . 313
Suppression d'&eacute;l&eacute;ments multim&eacute;dia des rubriques . . . . . . . . . 313
HTML dynamique et effets sp&eacute;ciaux . . . . . . . . . . . . . . . . . . . 313
Principes de base du format DHTML . . . . . . . . . . . . . . . . . 314
Ajout d'effets DHTML &agrave; une rubrique . . . . . . . . . . . . . . . . . . . . . 314
Application d'effets DHTML &agrave; plusieurs paragraphes . . . . . . . . . 314
Mise &agrave; jour des effets DHTML dans une rubrique . . . . . . . . . . . 314
Modification ou suppression d'effets DHTML . . . . . . . . . . . . . . . 315
Zones cliquables dynamiques . . . . . . . . . . . . . . . . . . . . . 315
A propos des zones cliquables DHTML . . . . . . . . . . . . . . . . . . . . 315
Ajout de zones cliquables DHTML . . . . . . . . . . . . . . . . . . . . . . . . 315
Suppression de zones cliquables . . . . . . . . . . . . . . . . . . . . . . . . . 316
Modification du formatage des zones cliquables DHTML . . . . . 316
D&eacute;clencheurs et cibles . . . . . . . . . . . . . . . . . . . . . . . . . 316
A propos des d&eacute;clencheurs et des cibles . . . . . . . . . . . . . . . . . . . 316
Affectation d'un d&eacute;clencheur &agrave; du texte ou &agrave; une image . . . . . 317
Association de d&eacute;clencheurs &agrave; du texte . . . . . . . . . . . . . . . . . . . 317
Association de d&eacute;clencheurs &agrave; des images . . . . . . . . . . . . . . . . . 317
Suppression de d&eacute;clencheurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
Texte d&eacute;filant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
Ajout de texte d&eacute;filant . . . . . . . . . . . . . . . . . . . . . . . . . 318
D&eacute;finition et modification des propri&eacute;t&eacute;s de texte d&eacute;filant . . . . . 318
Suppression de texte d&eacute;filant . . . . . . . . . . . . . . . . . . . . . 318
Commentaires HTML dans les rubriques . . . . . . . . . . . . . . . . . 319
Insertion d'un commentaire HTML . . . . . . . . . . . . . . . . . . 319
Affichage d'un commentaire HTML . . . . . . . . . . . . . . . . . . 319
IFrames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
Insertion d'un iFrame . . . . . . . . . . . . . . . . . . . . . . . . . 319
Modification d'un iFrame . . . . . . . . . . . . . . . . . . . . . . . 320
Chapitre 10 :
Texte conditionnel . . . . . . . . . . . . . . . . . . . . . . . . . . . . .321
El&eacute;ments de texte conditionnel de base . . . . . . . . . . . . . . . . . 321
Personnaliser le r&eacute;sultat sur papier . . . . . . . . . . . . . . . . . . 321
D&eacute;finir du contenu personnalis&eacute; pour des publics sp&eacute;cifiques . . . 321
Fournir diff&eacute;rentes versions d'une application . . . . . . . . . . . . 321
xx
Conception et test de texte conditionnel . . . . . . . . . . . . . . . 321
Flux de production de l'impl&eacute;mentation du texte conditionnel . . 322
Gestion des liens vers les rubriques exclues . . . . . . . . . . . . . 323
Balises de construction conditionnelles . . . . . . . . . . . . . . . . . 323
Cr&eacute;ation d'une balise de construction conditionnelle . . . . . . . . 323
Application de balises de construction conditionnelles au contenu . . . 323
Remarques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
V&eacute;rification des balises appliqu&eacute;es aux rubriques . . . . . . . . . . . 324
Application de balises de construction conditionnelles &agrave; une
rubrique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
Application de balises de construction conditionnelles
&agrave; plusieurs rubriques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
Application de balises de construction conditionnelles au
contenu d'une rubrique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
Application de plusieurs balises de construction
conditionnelles au contenu d'une rubrique . . . . . . . . . . . . . . . . 325
Application de balises de construction conditionnelles
&agrave; un dossier, un index ou une table des mati&egrave;res . . . . . . . . . . . . 325
Application de balises de construction conditionnelles
aux espaces r&eacute;serv&eacute;s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
Aper&ccedil;u des zones de texte conditionnel . . . . . . . . . . . . . . . 326
Affichage et masquage du texte conditionnel . . . . . . . . . . . . 326
Suppression de balises de construction conditionnelles . . . . . . 327
Modification du nom des balises de construction conditionnelles . . . 327
Expressions de balises de construction conditionnelles . . . . . . . . . 327
D&eacute;finition d'expressions de balises de construction
conditionnelles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
Expressions de balises de construction conditionnelles avanc&eacute;es . . . 330
Chapitre 11 :
xxi
Aide contextuelle . . . . . . . . . . . . . . . . . . . . . . . . . . . . .331
&Agrave; propos de l'aide contextuelle . . . . . . . . . . . . . . . . . . . . . . 331
R&ocirc;les des auteurs et des d&eacute;veloppeurs lors de la cr&eacute;ation de l'aide
contextuelle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
Fichiers de mappage et ID de mappage . . . . . . . . . . . . . . . . . . 333
A propos des num&eacute;ros, fichiers et ID de mappage . . . . . . . . . 333
Gestion des fichiers de mappage . . . . . . . . . . . . . . . . . . . 334
Cr&eacute;ation d'un fichier de mappage . . . . . . . . . . . . . . . . . . . . . . . . 334
Importation d'un fichier de mappage . . . . . . . . . . . . . . . . . . . . . 334
Exportation d'un fichier de mappage . . . . . . . . . . . . . . . . . . . . . 335
Verrouillage ou d&eacute;verrouillage d'un fichier de mappage . . . . . . 335
Suppression d'un fichier de mappage obsol&egrave;te . . . . . . . . . . . . . 335
Suppression d'un ID de mappage inutilis&eacute; . . . . . . . . . . . . . . . . . 335
Gestion des ID de mappage . . . . . . . . . . . . . . . . . . . . . . 336
Cr&eacute;ation d'un ID de mappage . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
Modification d'un ID de mappage . . . . . . . . . . . . . . . . . . . . . . . . 336
R&eacute;attribution d'un ID de mappage . . . . . . . . . . . . . . . . . . . . . . . . 338
G&eacute;n&eacute;ration automatique d'un ID de mappage . . . . . . . . . . . . . . 339
Attribution d'un ID de mappage &agrave; une rubrique . . . . . . . . . . . . . 340
Annulation de l'attribution d'un ID de mappage . . . . . . . . . . . . 340
Modification dynamique de rubriques d'aide contextuelle . . . . . . . 341
Sc&eacute;narios d'utilisation . . . . . . . . . . . . . . . . . . . . . . . . . 341
Mappage d'une bo&icirc;te de dialogue d'application avec
une rubrique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
Informations &agrave; l'attention des d&eacute;veloppeurs . . . . . . . . . . . . . . . 342
Aide de programme des applications Visual Basic . . . . . . . . . . 343
Syntaxe de la fonction RH_ShowHelp . . . . . . . . . . . . . . . . . . . . . 344
Syst&egrave;me d'aide mixte pour les applications Visual Basic . . . . . . 344
Aide de programme des applications Visual C++ . . . . . . . . . . 345
Interdiction &agrave; RoboHelp_CSH.cpp d'utiliser des en-t&ecirc;tes
pr&eacute;compil&eacute;s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
Appels de la fonction &agrave; partir des applications Visual C++ . . . . 346
Appel d'une fonction d'aide contextuelle pour AIR Help . . . . . . 347
Appel d'une fonction d'aide contextuelle Responsive HTML5,
WebHelp, FlashHelp ou FlashHelp Pro . . . . . . . . . . . . . . . . . . . . 348
Appel d'une fonction d'aide contextuelle pour WebHelp Pro . . . . 349
Appel d'une fonction d'aide contextuelle pour HTML Help . . . . 349
Remplacement du gestionnaire d'aide MFC par d&eacute;faut . . . . . . . 350
Syst&egrave;me d'aide mixte pour les applications C++ . . . . . . . . . . . . . 351
Aide &agrave; la programmation pour les applications Java . . . . . . . . . 352
Appels de fonction &agrave; partir des applications Java . . . . . . . . . . . . 352
Appel d'une fonction d'aide contextuelle Responsive HTML5,
WebHelp, FlashHelp ou FlashHelp Pro . . . . . . . . . . . . . . . . . . . . 353
Appel d'une fonction d'aide contextuelle pour WebHelp Pro . . . . 354
Aide &agrave; la programmation pour les pages Web . . . . . . . . . . . . 354
Aide &agrave; la programmation pour les pages Web (WebHelp/Pro) . . . 354
Appels de fonctions &agrave; partir de pages Web . . . . . . . . . . . . . . . . . 355
Appel d'une fonction contextuelle pour WebHelp Pro . . . . . . . 357
Appel d'une fonction contextuelle pour WebHelp ou
FlashHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
Programmation d'un syst&egrave;me d'aide pour .NET . . . . . . . . . . . 357
Principes de base de .NET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
Appel de l'aide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
Recherche de RoboHelp Server avec les exemples .NET . . . . . . 363
Sp&eacute;cification d'une URL (WebHelp Pro) . . . . . . . . . . . . . . . . . . . 363
Services Web fournis par RoboHelp Server avec .NET . . . . . . . . 363
Etapes sans utiliser les fichiers de support . . . . . . . . . . . . . . 364
WebHelp Pro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
WebHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
Programmation de HTML Help dans les applications . . . . . . . . . 368
Appel de fonction d'aide contextuelle HTML Help . . . . . . . . . . . 368
D&eacute;pannage : aide sur les fen&ecirc;tres . . . . . . . . . . . . . . . . . . . . . . . . 369
xxii
A propos de la cr&eacute;ation d'un syst&egrave;me d'aide contextuelle
JavaHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
Cr&eacute;ation d'aide contextuelle Oracle Help . . . . . . . . . . . . . . . . . . 372
Qu'est-ce que c'est ? Aide . . . . . . . . . . . . . . . . . . . . . . . . . 377
A propos de l'outil de composition d'aide . . . . . . . . . . . . . . 377
Aide Qu'est-ce que c'est ? et Microsoft HTML Help . . . . . . . . . 377
Fonctionnement de l'aide Qu'est-ce que c'est ? pour les aides
contextuelles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
Cr&eacute;ation d'aides Qu'est-ce que c'est ? Aide . . . . . . . . . . . . . 378
Conseils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
Importation de projets d'aide Projets d'aide . . . . . . . . . . . . . 379
Remarques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
Ouverture de projets d'aide Qu'est-ce que c'est ? . . . . . . . . . . 379
Suppression de l'aide Qu'est-ce que c'est ? d'un projet . . . . . . . 379
Fichier du projet d'aide Qu'est-ce que c'est ? avec BugHunter . . . 380
Tester l'API de l'aide HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
D&eacute;pannage : aide Aide . . . . . . . . . . . . . . . . . . . . . . . . . 381
Maintenance des rubriques textuelles (projets Microsoft HTML Help) . . . 383
Remarques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383
Utilisation de rubriques contextuelles purement textuelles . . . . . . 384
Cr&eacute;ation de rubriques textuelles . . . . . . . . . . . . . . . . . . . 384
Conseils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
Modification de rubriques textuelles . . . . . . . . . . . . . . . . . 385
Test de rubriques textuelles . . . . . . . . . . . . . . . . . . . . . . 385
Conseils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
Suppression de rubriques textuelles . . . . . . . . . . . . . . . . . 386
Conseils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
Suppression de fichiers de rubrique textuelle . . . . . . . . . . . . 386
Test d'un syst&egrave;me d'aide contextuelle . . . . . . . . . . . . . . . . . . 387
Test &agrave; l'aide de l'outil d'aide contextuelle . . . . . . . . . . . . . . 387
Test &agrave; l'aide de BugHunter pour HTML Help . . . . . . . . . . . . . 387
D&eacute;marrage et fermeture de BugHunter . . . . . . . . . . . . . . . . . . . 388
Interpr&eacute;tation des donn&eacute;es BugHunter . . . . . . . . . . . . . . . . . . . . 388
Personnalisation du volet BugHunter . . . . . . . . . . . . . . . . . . . . . 389
Affichage des num&eacute;ros de mappage au format hexad&eacute;cimal . . . . 389
Test dans l'application . . . . . . . . . . . . . . . . . . . . . . . . . 389
Terminologie des syst&egrave;mes d'aide contextuelle . . . . . . . . . . . . . 389
Cr&eacute;ation d'une aide pour les applications iOS et Android . . . . . . . . 391
Fonctionnalit&eacute;s fournies . . . . . . . . . . . . . . . . . . . . . . . . 391
Etapes g&eacute;n&eacute;rales pour mettre en œuvre l'aide mobile . . . . . . . 391
Fonctions d'API disponibles . . . . . . . . . . . . . . . . . . . . . . 392
iOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
Android . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
Exemple d'application . . . . . . . . . . . . . . . . . . . . . . . . . 393
Aide contextuelle pour le contenu dynamique filtr&eacute; . . . . . . . . . . 396
R&eacute;f&eacute;rences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
xxiii
Onglet BugHunter de la bo&icirc;te de dialogue Options (HTML Help) . . . . 397
Options d'affichage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
Exemple de message sur une seule ligne . . . . . . . . . . . . . . . . . . 397
Exemple de message sur plusieurs lignes . . . . . . . . . . . . . . . . . . 397
Options de couleur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
Chapitre 12 :
G&eacute;n&eacute;ration de sortie . . . . . . . . . . . . . . . . . . . . . . . . . . .398
El&eacute;ments de base source unique et plus . . . . . . . . . . . . . . . . . 398
A propos des mises en page source unique . . . . . . . . . . . . . 398
Types de mise en page dans RoboHelp . . . . . . . . . . . . . . . . 398
Sp&eacute;cification de la mise en page principale . . . . . . . . . . . . . 399
Cr&eacute;ation et modification de mises en page de source unique . . . 399
Cr&eacute;ation ou duplication de mises en page source unique . . . . . 399
Modification de mises en page source unique . . . . . . . . . . . . . . 399
Modification du nom d'une mise en page source unique . . . . . 400
Suppression d'une mise en page source unique . . . . . . . . . . . 400
A propos de l'exclusion des rubriques non r&eacute;f&eacute;renc&eacute;es de la sortie . . . 400
G&eacute;n&eacute;ration d'une sortie de contenu dynamique . . . . . . . . . . 401
Contenu de balises . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
Cr&eacute;ation d'un filtre de contenu dynamique . . . . . . . . . . . . . . . . 402
Utilisation d'un filtre de contenu dynamique dans la sortie . . . 403
Test du filtre de contenu dynamique . . . . . . . . . . . . . . . . . . . . . . 405
G&eacute;n&eacute;rer un contenu dynamique centr&eacute; sur l'utilisateur (DUCC) . . 406
G&eacute;n&eacute;rer native (ASPX) ou sortie HTML pour Microsoft SharePoint . . . 407
Publication de (ASPX) sortie native Multi-&eacute;cran pour
Microsoft SharePoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407
Publication d'une sortie HTML pour Microsoft SharePoint . . . . 407
Utilisation de types de mises en page . . . . . . . . . . . . . . . . . . 408
Mise en page Responsive HTML5 . . . . . . . . . . . . . . . . . . . 408
Mise en page personnalisable de HTML5 Indigo . . . . . . . . . . . . 409
Navigateurs pris en charge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
Comportement en ligne/hors ligne . . . . . . . . . . . . . . . . . . . . . . . 410
Configuration des composants requis pour Responsive HTML5 . . . .410
Flux de g&eacute;n&eacute;ration de la sortie HTML5 . . . . . . . . . . . . . . . . . . . . 411
Recommandations relatives &agrave; la cr&eacute;ation de la sortie HTML5 . . . . . .411
Mise en page multi-&eacute;cran . . . . . . . . . . . . . . . . . . . . . . . 412
Navigateurs pris en charge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
Comportement en ligne/hors ligne . . . . . . . . . . . . . . . . . . . . . . . 413
Configuration des composants requis pour le multi-&eacute;cran
HTML5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
Flux de g&eacute;n&eacute;ration de la sortie HTML5 . . . . . . . . . . . . . . . . . . . . 414
Recommandations relatives &agrave; la cr&eacute;ation de la sortie HTML5 . . . 414
Mise en page eBook . . . . . . . . . . . . . . . . . . . . . . . . . . 415
Mise en page de WebHelp . . . . . . . . . . . . . . . . . . . . . . . 415
A propos de WebHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
xxiv
Ajout ou suppression de la mise en surbrillance des r&eacute;sultats
de recherche dans WebHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
Sortie WebHelp conforme &agrave; la section 508 . . . . . . . . . . . . . . . . . 416
Mises en page WebHelp Pro et FlashHelp Pro . . . . . . . . . . . . 418
A propos de WebHelp Pro et de FlashHelp Pro . . . . . . . . . . . . . . 418
Conversion de l'aide de l'ordinateur au format WebHelp Pro . . . 418
Mise en page de Microsoft HTML Help . . . . . . . . . . . . . . . . 419
A propos de Microsoft HTML Help . . . . . . . . . . . . . . . . . . . . . . . . 419
G&eacute;n&eacute;ration de Microsoft HTML Help . . . . . . . . . . . . . . . . . . . . . . 419
Liaison de livres et de pages de table des mati&egrave;res vers
des fen&ecirc;tres personnalis&eacute;es (Microsoft HTML Help) . . . . . . . . . 420
Extraction de fichiers CHM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
Modification du nom de fichiers CHM . . . . . . . . . . . . . . . . . . . . . 421
Recherche de fichiers d'aide HTML et de composants . . . . . . . . 421
Remplacement de fichiers CHM . . . . . . . . . . . . . . . . . . . . . . . . . . 422
Enregistrement ou annulation de l'enregistrement d'un
fichier CHM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
Mise en page JavaHelp . . . . . . . . . . . . . . . . . . . . . . . . . 422
A propos de JavaHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
G&eacute;n&eacute;ration d'une sortie JavaHelp . . . . . . . . . . . . . . . . . . . . . . . . 423
Fusion de projets JavaHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
Limitations de JavaHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
Mise en page d'Oracle Help . . . . . . . . . . . . . . . . . . . . . . 425
A propos d'Oracle Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
D&eacute;finition des ID de rubrique pour Oracle Help . . . . . . . . . . . . . 426
D&eacute;finition de la fen&ecirc;tre de rubrique Oracle Help . . . . . . . . . . . . 426
Affichages distants Oracle Help . . . . . . . . . . . . . . . . . . . . . . . . . . 426
Limitations d'Oracle Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428
Mise en page XML . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
Mise en page d'Adobe AIR . . . . . . . . . . . . . . . . . . . . . . . 430
Configuration de la mise en page Adobe AIR . . . . . . . . . . . . . . . 430
Cr&eacute;ation d'un certificat num&eacute;rique sign&eacute; automatiquement . . . . . 443
Signature d'une application d'aide AIR interm&eacute;diaire au
moyen de l'outil AIR Developer (ADT) . . . . . . . . . . . . . . . . . . . . . 443
G&eacute;n&eacute;ration, affichage et publication d'une sortie . . . . . . . . . . . . 444
Principes de base de la g&eacute;n&eacute;ration de la sortie . . . . . . . . . . . 444
Conseils pour une g&eacute;n&eacute;ration de projets optimale . . . . . . . . . . 445
G&eacute;n&eacute;rer la sortie Responsive HTML5 . . . . . . . . . . . . . . . . . 445
G&eacute;n&eacute;ration de la sortie de l'application mobile . . . . . . . . . . . 452
T&eacute;l&eacute;charger votre application mobile vers la boutique
d'applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
G&eacute;n&eacute;ration d'une sortie Multi-&eacute;cran HTML5 . . . . . . . . . . . . . 459
G&eacute;n&eacute;ration d'une sortie EPUB et Kindle Book . . . . . . . . . . . . 466
Ressources EPUB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
G&eacute;n&eacute;ration d'une sortie eBook . . . . . . . . . . . . . . . . . . . . . . . . . . 466
Meilleures pratiques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470
xxv
Limites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
G&eacute;n&eacute;ration d'une sortie EPUB 2.0.1 . . . . . . . . . . . . . . . . . 471
Pr&eacute;paration &agrave; la g&eacute;n&eacute;ration de la sortie EPUB 2.0.1 . . . . . . . . . . 471
Ex&eacute;cution du script pour g&eacute;n&eacute;rer la sortie EPUB 2.0.1 . . . . . . . . 471
G&eacute;n&eacute;ration d'une sortie WebHelp . . . . . . . . . . . . . . . . . . 472
G&eacute;n&eacute;ration d'une sortie WebHelp Pro ou FlashHelp Pro . . . . . . 479
G&eacute;n&eacute;ration d'une sortie Microsoft HTML Help . . . . . . . . . . . 484
G&eacute;n&eacute;ration d'une sortie Oracle Help . . . . . . . . . . . . . . . . . 485
G&eacute;n&eacute;ration d'une sortie JavaHelp . . . . . . . . . . . . . . . . . . . 489
G&eacute;n&eacute;ration d'une sortie XML . . . . . . . . . . . . . . . . . . . . . 491
G&eacute;n&eacute;ration d'EclipseHelp . . . . . . . . . . . . . . . . . . . . . . . 493
G&eacute;n&eacute;ration de sortie par lots . . . . . . . . . . . . . . . . . . . . . 494
Remarques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494
Personnalisation de la mise en page . . . . . . . . . . . . . . . . . 495
Affichage de la sortie . . . . . . . . . . . . . . . . . . . . . . . . . . 496
Affichage de la sortie Multi-&eacute;cran HTML5 . . . . . . . . . . . . . . . . . . 496
Affichage d'une sortie WebHelp, FlashHelp, WebHelp Pro et
FlashHelp Pro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496
Affichage d'une aide compil&eacute;e Microsoft HTML Help . . . . . . . . 497
Assistant de l'afficheur d'aide . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497
Publication d'une sortie . . . . . . . . . . . . . . . . . . . . . . . . 499
G&eacute;n&eacute;ration et publication d'une sortie via l'invite de commande . . . 501
Ouverture de l'application &agrave; partir de l'invite de commande . . . . . 501
G&eacute;n&eacute;ration de mises en page &agrave; l'aide d'une invite de commande . . .502
Publication de toutes les mises en page &agrave; partir de l'invite de
commande . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502
Options d'invite de commande . . . . . . . . . . . . . . . . . . . . . . . . . . 502
H&eacute;bergement des mises &agrave; jour de l'aide AIR . . . . . . . . . . . . . 503
Cr&eacute;ation et h&eacute;bergement d'une mise &agrave; jour . . . . . . . . . . . . . . . . 503
Publication d'une mise &agrave; jour . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504
Distribution de la sortie du projet . . . . . . . . . . . . . . . . . . . . . 504
Distribution de la sortie Multi-&eacute;cran HTML5 . . . . . . . . . . . . . 504
Fichiers de sortie dans le dossier Multiscreen_HTML5 . . . . . . . 505
Fichiers de sortie dans le dossier des profils d'&eacute;cran . . . . . . . . . 505
Fichiers de sortie du dossier whxdata . . . . . . . . . . . . . . . . . . . . . 505
Sous-dossiers du dossier de mod&egrave;les . . . . . . . . . . . . . . . . . . . . . 506
Distribution de la sortie eBook . . . . . . . . . . . . . . . . . . . . 506
Distribution de WebHelp . . . . . . . . . . . . . . . . . . . . . . . 506
Fichiers de sortie dans le dossier WebHelp . . . . . . . . . . . . . . . . . 507
Fichiers de sortie du sous-dossier Whgdata . . . . . . . . . . . . . . . . 509
Fichiers de sortie dans le sous-dossier Whdata . . . . . . . . . . . . . 510
Fichiers de sortie du sous-dossier Whxdata . . . . . . . . . . . . . . . . 512
Distribution de FlashHelp . . . . . . . . . . . . . . . . . . . . . . . 512
Distribution de FlashHelp avec une application . . . . . . . . . . . . . 512
Publication de FlashHelp sur un disque, un serveur ou un
ordinateur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512
xxvi
Fichiers de sortie FlashHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513
Distribution d'une aide Microsoft HTML Help . . . . . . . . . . . . 515
Enregistrement des contr&ocirc;les ActiveX . . . . . . . . . . . . . . . . . . . . . 516
Distribution de JavaHelp . . . . . . . . . . . . . . . . . . . . . . . . 516
Fichiers de sortie JavaHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
Distribution d'Oracle Help . . . . . . . . . . . . . . . . . . . . . . . 517
Fichiers de sortie Oracle Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518
Distribution de la sortie XML . . . . . . . . . . . . . . . . . . . . . 518
Distribution de la sortie Adobe AIR . . . . . . . . . . . . . . . . . . 519
Configuration de FlashPlayerTrust pour ex&eacute;cuter une
aide locale bas&eacute;e sur un navigateur . . . . . . . . . . . . . . . . . . . . . . . 519
Mot de passe du mod&eacute;rateur et chemin du fichier
de configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520
Attributs du fichier de configuration . . . . . . . . . . . . . . . . . . . . . . 520
Format des URL formats pour Windows, Mac et Linux . . . . . . . 521
A propos de la modification de l'&eacute;tat des nouveaux
commentaires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522
Documents imprim&eacute;s . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522
A propos des documents imprim&eacute;s . . . . . . . . . . . . . . . . . . 522
Organisation et personnalisation du contenu . . . . . . . . . . . . . . . 522
Mappage de styles de projet dans Word . . . . . . . . . . . . . . . . . . . 522
Types de documents Word &agrave; cr&eacute;er . . . . . . . . . . . . . . . . . . . . . . . 522
Structure du document imprim&eacute; . . . . . . . . . . . . . . . . . . . . . . . . . 523
Conversion des fonctions en ligne . . . . . . . . . . . . . . . . . . . . . . . . 523
Configuration des pages . . . . . . . . . . . . . . . . . . . . . . . . 524
Param&egrave;tres de page du corps . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524
Param&egrave;tres suppl&eacute;mentaires . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524
Organisation et personnalisation du contenu du document . . . . 527
Remarques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530
Pr&eacute;paration des documents imprim&eacute;s . . . . . . . . . . . . . . . . 531
Pr&eacute;paration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531
Styles et formatage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531
Texte conditionnel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
Mises en page source unique . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
Mappage de styles . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
Styles mapp&eacute;s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
Styles non mapp&eacute;s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
Noms de styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
Ajout de styles RoboHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
Styles en double . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
Mappage de styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
Exportation de mappages de styles . . . . . . . . . . . . . . . . . . . . . . . 536
Importation de mappages de styles . . . . . . . . . . . . . . . . . . . . . . . 536
G&eacute;n&eacute;ration de PDF . . . . . . . . . . . . . . . . . . . . . . . . . . . 536
G&eacute;n&eacute;ration d'un PDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536
G&eacute;n&eacute;ration d'un PDF avec des options de configuration . . . . . . 536
xxvii
G&eacute;n&eacute;ration de documents imprim&eacute;s . . . . . . . . . . . . . . . . . 537
Ajout d'en-t&ecirc;tes et de pieds de page dans des documents
imprim&eacute;s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538
D&eacute;finition d'options d'impression par d&eacute;faut . . . . . . . . . . . . 539
Habillages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539
A propos des habillages . . . . . . . . . . . . . . . . . . . . . . . . 539
Modification d'habillages . . . . . . . . . . . . . . . . . . . . . . . 540
Conseils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540
Ajout d'habillages &agrave; la galerie . . . . . . . . . . . . . . . . . . . . . 541
Importation d'habillages . . . . . . . . . . . . . . . . . . . . . . . . 541
Exportation d'habillages . . . . . . . . . . . . . . . . . . . . . . . . 541
Suppression d'habillages . . . . . . . . . . . . . . . . . . . . . . . . 541
Aper&ccedil;us d'habillages . . . . . . . . . . . . . . . . . . . . . . . . . . 542
Compilation d'habillages . . . . . . . . . . . . . . . . . . . . . . . . 542
Cr&eacute;ation d'habillages personnalis&eacute;s pour les projets Adobe AIR . . . . . 542
Retouche de la palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543
Modification des caract&eacute;ristiques de police . . . . . . . . . . . . . . . . 543
Personnalisation des ic&ocirc;nes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543
Cr&eacute;ation d'habillages personnalis&eacute;s dans les projets WebHelp e
t WebHelp Pro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544
Personnalisation des habillages FlashHelp . . . . . . . . . . . . . . 547
Personnalisation ou cr&eacute;ation d'un habillage avec Flash . . . . . . . 547
Modification d'un habillage sans Flash . . . . . . . . . . . . . . . . . . . . 548
S&eacute;lection et aper&ccedil;u des habillages WebHelp ou FlashHelp
&agrave; partir de la galerie . . . . . . . . . . . . . . . . . . . . . . . . . . 548
Utilisation des habillages verticaux de FlashHelp . . . . . . . . . . . . 549
Fen&ecirc;tres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550
Cr&eacute;ation et modification de fen&ecirc;tres . . . . . . . . . . . . . . . . . 550
Options WebHelp, WebHelp Pro, FlashHelp et FlashHelp Pro . . . . . .551
Options HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552
Ajout de boutons HMTL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557
Modification des fen&ecirc;tres pour les afficheurs JavaHelp et Oracle . . . . 558
Options des afficheurs JavaHelp . . . . . . . . . . . . . . . . . . . . . . . . . 558
Options des afficheurs Oracle . . . . . . . . . . . . . . . . . . . . . . . . . . . 559
Assignation d'une fen&ecirc;tre par d&eacute;faut . . . . . . . . . . . . . . . . . 559
Suppression d'une fen&ecirc;tre . . . . . . . . . . . . . . . . . . . . . . . 559
Profils d'&eacute;cran . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559
Ajout d'un profil d'&eacute;cran &agrave; un SSL Multi-&eacute;cran HTML5 . . . . . . . 560
Modification d'un profil d'&eacute;cran . . . . . . . . . . . . . . . . . . . . 560
Ajout d'un profil d'&eacute;cran au projet . . . . . . . . . . . . . . . . . . 561
Suppression d'un profil d'&eacute;cran . . . . . . . . . . . . . . . . . . . . 562
Mappage de styles des profils d'&eacute;cran . . . . . . . . . . . . . . . . 562
Utilisation du ratio de pixels du p&eacute;riph&eacute;rique pour la taille et la
r&eacute;solution d'&eacute;cran . . . . . . . . . . . . . . . . . . . . . . . . . . . 562
Mises en page d'&eacute;cran . . . . . . . . . . . . . . . . . . . . . . . . . . . 563
Cr&eacute;ation d'une mise en page d'&eacute;cran . . . . . . . . . . . . . . . . . 563
xxviii
Gestion des mises en page d'&eacute;cran . . . . . . . . . . . . . . . . . . 564
Aper&ccedil;u d'une mise en page d'&eacute;cran . . . . . . . . . . . . . . . . . . 564
Modification d'une mise en page d'&eacute;cran . . . . . . . . . . . . . . 564
Ajout d'une page de mise en page d'&eacute;cran (SLP) . . . . . . . . . . . . 564
Composants de page de mise en page d'&eacute;cran . . . . . . . . . . . . . . 565
Attributs et propri&eacute;t&eacute;s de l'espace r&eacute;serv&eacute; . . . . . . . . . . . . . . . . . 567
Conseils pour la conception de la mise en page d'&eacute;cran . . . . . . 570
Modification d'une page de mise en page d'&eacute;cran (SLP) . . . . . . 571
Personnalisation de la page de rubrique par d&eacute;faut . . . . . . . . . 572
Chapitre 13 :
xxix
R&eacute;vision et collaboration . . . . . . . . . . . . . . . . . . . . . . . . .573
R&eacute;vision dans l'&eacute;diteur de conception . . . . . . . . . . . . . . . . . . 573
Affichage de la barre d'outils R&eacute;vision . . . . . . . . . . . . . . . . 573
Activer le mode Suivi des modifications . . . . . . . . . . . . . . . 573
Configuration des param&egrave;tres de r&eacute;vision . . . . . . . . . . . . . . 574
R&eacute;vision de fichiers PDF . . . . . . . . . . . . . . . . . . . . . . . . . . 574
Cr&eacute;ation d'un fichier PDF &agrave; r&eacute;viser . . . . . . . . . . . . . . . . . . 574
Incorporation de fichiers SWF dans un fichier PDF de r&eacute;vision . . . 576
Ajout de commentaires &agrave; des fichiers SWF . . . . . . . . . . . . . . 577
Importation des commentaires d'un fichier PDF . . . . . . . . . . . 577
A propos des commentaires PDF import&eacute;s dans l'&eacute;diteur
de conception . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577
Importation de commentaires ajout&eacute;s &agrave; des fichiers SWF . . . . 578
Importation de commentaires ajout&eacute;s aux espaces r&eacute;serv&eacute;s,
extraits de code, en-t&ecirc;tes et pieds de page . . . . . . . . . . . . . . . . 578
Gestion des ressources partag&eacute;es . . . . . . . . . . . . . . . . . . . . . 578
Ajout d'un emplacement partag&eacute; . . . . . . . . . . . . . . . . . . . 579
Ajout d'une cat&eacute;gorie . . . . . . . . . . . . . . . . . . . . . . . . . 580
Remarques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 580
Partage de ressources entre les utilisateurs . . . . . . . . . . . . . 580
Affichage/masquage de contenu dans le conteneur
Gestionnaire de ressources . . . . . . . . . . . . . . . . . . . . . . 581
Gestion des fichiers partag&eacute;s et du dossier . . . . . . . . . . . . . 581
Gestion des ressources li&eacute;es . . . . . . . . . . . . . . . . . . . . . . 583
Gestion des notifications de ressources li&eacute;es . . . . . . . . . . . . 584
Configuration des param&egrave;tres du Gestionnaire de ressources . . . 585
Sp&eacute;cification de param&egrave;tres du Gestionnaire de ressources au
niveau de l'application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585
Sp&eacute;cification de param&egrave;tres du Gestionnaire de ressources au
niveau du projet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586
Configuration de l'application de contr&ocirc;le de version . . . . . . . . 586
Gestion des commentaires et des modifications . . . . . . . . . . . . . 587
Conteneur Panneau de r&eacute;vision . . . . . . . . . . . . . . . . . . . . 587
Filtrage des commentaires et des modifications . . . . . . . . . . . 588
Regroupement des commentaires et des modifications . . . . . . 589
R&eacute;ponse ou d&eacute;finition d'un &eacute;tat pour un commentaire . . . . . . . 589
Acceptation ou rejet de modifications . . . . . . . . . . . . . . . . 589
Suppression de commentaires . . . . . . . . . . . . . . . . . . . . 590
R&eacute;vision et collaboration dans l'aide AIR . . . . . . . . . . . . . . . . . 590
Evaluation de rubrique . . . . . . . . . . . . . . . . . . . . . . . . . 590
Commentaires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591
Stockage de commentaires dans un dossier r&eacute;seau partag&eacute; . . . 591
Stockage de commentaires sur un serveur RoboHelp . . . . . . . . 591
Configuration des pr&eacute;f&eacute;rences pour les commentaires . . . . . . . 592
Ajout de commentaires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593
Mod&eacute;ration des commentaires . . . . . . . . . . . . . . . . . . . . . . . . . . 593
Mod&eacute;ration des commentaires . . . . . . . . . . . . . . . . . . . . . . . . . . 594
Chapitre 14 :
Fonctionnalit&eacute;s de programme avanc&eacute;es . . . . . . . . . . . . . . . .595
Contr&ocirc;les ActiveX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595
A propos des contr&ocirc;les ActiveX . . . . . . . . . . . . . . . . . . . . 595
Ajout de contr&ocirc;les DTC . . . . . . . . . . . . . . . . . . . . . . . . . 595
Types de contr&ocirc;les ActiveX HTML Help . . . . . . . . . . . . . . . . 595
Ajout de contr&ocirc;les ActiveX . . . . . . . . . . . . . . . . . . . . . . . 596
Personnalisation des propri&eacute;t&eacute;s de contr&ocirc;le ActiveX . . . . . . . . 596
Suppression de propri&eacute;t&eacute;s d'un contr&ocirc;le ActiveX . . . . . . . . . . 597
Personnalisation du contr&ocirc;le du calendrier . . . . . . . . . . . . . 597
Applets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598
Remarques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
Formulaires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
Processus de cr&eacute;ation des formulaires . . . . . . . . . . . . . . . . 599
Ajout d'un formulaire &agrave; une rubrique . . . . . . . . . . . . . . . . . 599
D&eacute;finition des propri&eacute;t&eacute;s de formulaire . . . . . . . . . . . . . . . 599
El&eacute;ments de formulaire . . . . . . . . . . . . . . . . . . . . . . . . 600
Ajout et modification de champs de texte . . . . . . . . . . . . . . 601
Ajout de champs sp&eacute;ciaux . . . . . . . . . . . . . . . . . . . . . . . 602
Ajout de boutons &agrave; des formulaires . . . . . . . . . . . . . . . . . 603
Ajout de boutons images . . . . . . . . . . . . . . . . . . . . . . . 603
Ajout de cases &agrave; cocher . . . . . . . . . . . . . . . . . . . . . . . . 604
Ajout de boutons radio . . . . . . . . . . . . . . . . . . . . . . . . 604
Ajout de menus d&eacute;roulants . . . . . . . . . . . . . . . . . . . . . . 605
Cadres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605
A propos des cadres et des jeux de cadres . . . . . . . . . . . . . . 605
Remarques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606
Cr&eacute;ation de jeux de cadres . . . . . . . . . . . . . . . . . . . . . . 606
Modification des cadres et des jeux de cadres . . . . . . . . . . . . 607
Modification de la taille d'un cadre . . . . . . . . . . . . . . . . . . 607
Suppression de jeux de cadres . . . . . . . . . . . . . . . . . . . . 607
Liaison de jeux de cadres aux pages ou aux livres de la table des
mati&egrave;res . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608
Lien vers des rubriques dans les cadres . . . . . . . . . . . . . . . 608
Contr&ocirc;les HTML Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609
xxx
R&eacute;utilisation de contr&ocirc;les HTML Help . . . . . . . . . . . . . . . . 609
Ajout de contr&ocirc;les Rubrique WinHelp . . . . . . . . . . . . . . . . 609
Ajout de contr&ocirc;les Index . . . . . . . . . . . . . . . . . . . . . . . . 610
Ajout de contr&ocirc;les Table des mati&egrave;res . . . . . . . . . . . . . . . . 610
Ajout de contr&ocirc;les Ecran d'introduction . . . . . . . . . . . . . . . 611
Ajout de contr&ocirc;les Raccourci . . . . . . . . . . . . . . . . . . . . . 611
Ajout de contr&ocirc;les de version HHCTRL . . . . . . . . . . . . . . . . 612
Ajout de contr&ocirc;les Fermer la fen&ecirc;tre . . . . . . . . . . . . . . . . . 612
Modification de contr&ocirc;les HTML Help . . . . . . . . . . . . . . . . 613
Suppression de contr&ocirc;les HTML Help . . . . . . . . . . . . . . . . . 613
Types d'informations (pour HTML Help) . . . . . . . . . . . . . . . . . 613
A propos des types d'informations (HTML Help) . . . . . . . . . . 613
D&eacute;finition de cat&eacute;gories et de types d'informations (HTML Help) . . . . 614
Attribution de types d'informations (HTML Help) . . . . . . . . . . 615
Acc&egrave;s aux types d'informations dans l'afficheur HTML Help . . . . 615
Modification de types d'informations (HTML Help) . . . . . . . . . 616
Modification de cat&eacute;gories de types d'informations
(HTML Help) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616
Suppression de cat&eacute;gories dans des types d'informations
(HTML Help) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616
Suppression de types d'informations (HTML Help) . . . . . . . . . 616
Suppression de types d'informations dans des livres ou
des pages (HTML Help) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616
Suppression de types d'informations dans des cat&eacute;gories
(aide HTML) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616
Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617
A propos des scripts . . . . . . . . . . . . . . . . . . . . . . . . . . 617
Ajout de scripts aux rubriques HTML . . . . . . . . . . . . . . . . . 617
Prise en charge d'&eacute;v&eacute;nements dans des scripts . . . . . . . . . . . 617
Ev&eacute;nements pr&eacute;d&eacute;finis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618
Enregistrement dune fonction pour un &eacute;v&eacute;nement . . . . . . . . . . 618
Annulation de l'enregistrement d'une fonction . . . . . . . . . . . . . 619
A propos de la prise en charge de ExtendScript Toolkit . . . . . . . . . 619
Cr&eacute;ation de scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . 621
Gestion des dossiers de scripts . . . . . . . . . . . . . . . . . . . . 621
Gestion des fichiers de script . . . . . . . . . . . . . . . . . . . . . 621
Ex&eacute;cution de scripts . . . . . . . . . . . . . . . . . . . . . . . . . . 622
Images Twisties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 623
Ajout ou modification d'images dans une zone cliquable . . . . . . 623
Ajout ou modification d'images de termes de glossaire . . . . . . 623
Suppression d'images Twisties . . . . . . . . . . . . . . . . . . . . 623
Chapitre 15 :
xxxi
Raccourcis clavier par d&eacute;faut . . . . . . . . . . . . . . . . . . . . . . .624
&Agrave; PROPOS DE ROBOHELP CLASSIC (2019 RELEASE)
PRISE EN MAIN
CHAPITRE 1
1.
Prise en main
1.1.
&Agrave; propos de RoboHelp Classic (2019 release)
Adobe RoboHelp Classic (2019 release) est la version renomm&eacute;e de l'application RoboHelp que vous
utilisiez par le pass&eacute; et elle est optimis&eacute;e pour les flux de travaux ax&eacute;s sur les postes de travail. L'interface
utilisateur et le jeu de fonctionnalit&eacute;s sont sensiblement les m&ecirc;mes que pr&eacute;c&eacute;demment. Le nouveau
programme d'installation de RoboHelp (2019 release) installera &agrave; la fois RoboHelp (2019 release) (une
toute nouvelle application) et RoboHelp Classic (2019 release).
Vous pouvez facilement migrer tous vos anciens projets RoboHelp dans RoboHelp (2019 release).
Cependant, une fois que vous avez migr&eacute; et mis &agrave; jour votre projet vers RoboHelp (2019 release), vous ne
pouvez plus l'importer dans une ancienne version de RoboHelp Classic (2019 release).
Pour plus d'informations sur la nouvelle version de RoboHelp, voir le Guide de l’utilisateur RoboHelp
(2019 release). Vous pouvez &eacute;galement cr&eacute;er un cours en ligne sur Introduction &agrave; RoboHelp (2019
release).
1.2.
Flux de travaux de base
Formats d'entr&eacute;e et de sortie de RoboHelp
Cr&eacute;ation d'un projet
Chaque syst&egrave;me d'aide comporte au moins un projet. L'&eacute;l&eacute;ment de base du projet est la rubrique.
1
ACTIVATION ET ENREGISTREMENT
PRISE EN MAIN
CHAPITRE 1
Cr&eacute;ation du contenu
Cr&eacute;ation de rubriques. Vous pouvez ajouter des &eacute;l&eacute;ments multim&eacute;dia maintenant ou par la suite, lors de
la personnalisation de la sortie. Collaborez avec le d&eacute;veloppeur de l'application pour lancer la
planification des rubriques &agrave; utiliser &eacute;galement pour l'aide contextuelle. Les rubriques contextuelles
apparaissent lorsque l'utilisateur clique sur un bouton d'aide dans l'interface utilisateur ou lorsqu'il
appuie sur la touche F1.
Importation de fichiers
Vous pouvez importer des fichiers HTML, des fichiers Microsoft Word (.doc, .docx, .docm, .rtf), des livres
et des documents FrameMaker (.book, .bk, .fm, .frm, .mif), des fichiers XML (.xml) et des fichiers Adobe
PDF (.pdf).
D&eacute;veloppement de la navigation
En fonction de la hi&eacute;rarchie, ou du sch&eacute;ma d'organisation, du contenu, cr&eacute;ez des liens parmi les rubriques
et vers du contenu externe, le cas &eacute;ch&eacute;ant. Vous pouvez &eacute;galement lier du texte ou des images &agrave; d'autres
contenus. Cr&eacute;ez une table des mati&egrave;res qui refl&egrave;te la hi&eacute;rarchie du contenu, ainsi qu'un index dans lequel
les utilisateurs peuvent effectuer des recherches. Vous pouvez &eacute;galement cr&eacute;er des s&eacute;quences de
navigation, des chemins qu'un utilisateur peut suivre parmi les rubriques d'aide. Par exemple, si un
utilisateur doit lire plusieurs rubriques pour avoir une compr&eacute;hension compl&egrave;te d'une fonction, vous
pouvez les relier dans une s&eacute;quence de navigation.
Personnalisation de la sortie
Vous pouvez appliquer des mises en page (qui d&eacute;terminent le comportement et l'apparence), ainsi qu'un
formatage. Vous pouvez &eacute;galement utiliser du texte conditionnel pour afficher ou masquer le contenu, en
fonction de l'int&eacute;r&ecirc;t de l'utilisateur, de l'application utilis&eacute;e, du niveau de comp&eacute;tence et d'une s&eacute;rie
d'autres facteurs. Ajoutez des &eacute;l&eacute;ments multim&eacute;dia pour rendre l'aide plus attractive et plus riche.
G&eacute;n&eacute;ration, test et distribution du package d'aide
G&eacute;n&eacute;rez la sortie afin de pouvoir afficher l'aide et v&eacute;rifier les liens, le formatage, etc. Testez toutes les
sorties que vous avez l'intention de distribuer, y compris la documentation imprim&eacute;e.
1.3.
Activation et enregistrement
Pour consulter l'int&eacute;gralit&eacute; des recommandations et de la configuration syst&egrave;me requise relatives au
logiciel Adobe RoboHelp, consultez la page Support et formation de RoboHelp.
Si votre ordinateur n'est pas connect&eacute; &agrave; Internet, vous pouvez consulter le fichier Lisez-moi du disque
d'installation.
2
CHAPITRE 1
ACTIVATION ET ENREGISTREMENT
PRISE EN MAIN
Installation de RoboHelp Classic
RoboHelp Classic est inclus dans le nouveau programme d'installation de RoboHelp (2019 release) Une
fois que vous avez install&eacute; RoboHelp (2019 release), vous obtenez &eacute;galement RoboHelp Classic. Vous
pouvez installer RoboHelp de la mani&egrave;re suivante :
•
DVD Technical Communication Suite : ins&eacute;rez le premier DVD d'installation TCS, ex&eacute;cutez le
programme d'installation TCS et choisissez RoboHelp (2019 release) dans la liste des produits.
•
Lien t&eacute;l&eacute;chargeable RoboHelp (2019 release) : lancez le fichier .exe et suivez les instructions &agrave;
l'&eacute;cran pour installer RoboHelp.
Dans les deux cas, RoboHelp Classic est install&eacute; dans le backend. L'emplacement d'installation se trouve
dans le dossier principal de RoboHelp :
\Program Files\Adobe\Adobe RoboHelp 2019\RoboHTML
Aide &agrave; l'installation
Pour obtenir de l'aide sur les probl&egrave;mes d'installation, voir la section Prise en main sur la page Support et
formation de RoboHelp.
Activation de la licence
Lors du processus d'installation, votre logiciel Adobe contacte le serveur Adobe afin d'achever le
processus d'activation de la licence. Aucune donn&eacute;e personnelle n'est transmise lors de cette op&eacute;ration.
Pour plus de d&eacute;tails sur l'activation du produit, consultez la page Activation et d&eacute;sactivation des produits
Adobe.
Programme d'am&eacute;lioration des produits Adobe
Apr&egrave;s avoir utilis&eacute; le logiciel Adobe un certain nombre de fois, une bo&icirc;te de dialogue s'affiche, vous
proposant de participer au Programme d'am&eacute;lioration des produits Adobe.
Si vous choisissez d'y participer, des donn&eacute;es concernant votre utilisation du logiciel Adobe seront
transmises &agrave; Adobe. Aucune information personnelle n'est enregistr&eacute;e ni envoy&eacute;e. Le Programme
d'am&eacute;lioration des produits Adobe ne rassemble que les informations concernant les fonctionnalit&eacute;s et
les outils que vous utilisez dans le logiciel, ainsi que la fr&eacute;quence d'utilisation.
Vous pouvez accepter ou refuser de participer au programme &agrave; tout moment :
•
Pour participer, choisissez la commande Fichier &gt; Aide &gt; Programme d'am&eacute;lioration des
produits Adobe, puis cliquez sur Oui, participer.
•
Pour mettre fin &agrave; votre participation, choisissez la commande Fichier &gt;Aide &gt; Programme
d'am&eacute;lioration des produits Adobe, puis cliquez sur Non, merci.
Adobe fournit des informations suppl&eacute;mentaires sur le programme d'am&eacute;lioration des produits dans une
liste de questions fr&eacute;quentes sur le Programme d’am&eacute;lioration des produits Adobe.
3
AIDE ET ASSISTANCE
PRISE EN MAIN
CHAPITRE 1
Enregistrement
Enregistrez votre produit afin de b&eacute;n&eacute;ficier gratuitement d'une aide &agrave; l'installation, de notifications de
mises &agrave; jour, ainsi que d'autres services. Pour proc&eacute;der &agrave; l'enregistrement, suivez les instructions
affich&eacute;es dans la bo&icirc;te de dialogue d'enregistrement qui s'affiche apr&egrave;s l'installation du logiciel.
REMARQUE : N'effectuez qu'un seul enregistrement pour RoboHelp.
1.4.
Aide et assistance
Adobe Community Help
L'aide communautaire d'Adobe sur adobe.com est un environnement uniforme vous permettant
d'acc&eacute;der &agrave; diff&eacute;rentes ressources g&eacute;n&eacute;r&eacute;es par la communaut&eacute; et contr&ocirc;l&eacute;es par des experts de
l'industrie et des sp&eacute;cialistes Adobe. Consid&eacute;rez l'aide communautaire comme des ensembles d'&eacute;l&eacute;ments
associ&eacute;s plut&ocirc;t que des manuels. Adobe met continuellement &agrave; jour ces ensembles.
Marquez d'un signet la page centrale d’aide RoboHelp pour rechercher le meilleur contenu sur le Web &agrave;
propos de RoboHelp, y compris les ressources suivantes :
•
Des vid&eacute;os, des didacticiels, des conseils et des techniques, des blogs, des articles et des exemples
destin&eacute;s aux concepteurs comme aux d&eacute;veloppeurs.
•
Aide en ligne compl&egrave;te, r&eacute;guli&egrave;rement mis &agrave; jour.
•
Toutes les autres ressources disponibles sur adobe.com, telles que les articles de la base de
connaissances, les fichiers en t&eacute;l&eacute;chargement et les mises &agrave; jour, Adobe Developer Connection, etc.
Acc&egrave;s &agrave; l'aide RoboHelp
L'aide de RoboHelp Classic est disponible uniquement dans les formats PDF et Microsoft Help (CHM).
Lorsque vous travaillez dans RoboHelp Classic, appuyez sur F1 pour lancer l'aide dans un afficheur d'aide
contextuelle. Cet afficheur d'aide charge la version CHM de l'aide. Si vous voulez acc&eacute;der &agrave; la version PDF
de l'aide, consultez la page Ressource d’aide de RoboHelp.
Services, t&eacute;l&eacute;chargements et extras
Vous pouvez optimiser votre produit en y int&eacute;grant divers services, modules externes et extensions. Vous
pouvez &eacute;galement t&eacute;l&eacute;charger des exemples ou autres &eacute;l&eacute;ments et voir diverses ressources pour
terminer votre travail.
Adobe Exchange
Voir le site Adobe Exchange &agrave; l'adresse www.adobe.com/go/exchange_fr pour t&eacute;l&eacute;charger des exemples,
ainsi que des modules externes et des extensions fournis par Adobe et des d&eacute;veloppeurs tiers. Ces
modules externes et extensions peuvent vous aider &agrave; automatiser des t&acirc;ches, &agrave; personnaliser des
processus et &agrave; cr&eacute;er des effets professionnels sp&eacute;cifiques, entre autres.
4
CHAPITRE 1
AIDE ET ASSISTANCE
PRISE EN MAIN
T&eacute;l&eacute;chargements Adobe
Aller &agrave; l'adresse www.adobe.com/go/downloads_fr pour obtenir gratuitement des mises &agrave; jour, des
versions d'essai et d'autres logiciels utiles.
Adobe Labs
Adobe Labs &agrave; l'adresse www.adobe.com/go/labs_fr vous offre l'opportunit&eacute; de tester et d'&eacute;valuer de
nouvelles technologies &eacute;mergentes et de nouveaux produits Adobe. Adobe Labs donne notamment acc&egrave;s
aux ressources suivantes :
•
Pr&eacute;versions de logiciels et technologies &agrave; venir
•
Exemples de code et pratiques recommand&eacute;es pour un apprentissage rapide
•
Premi&egrave;res versions des produits et de la documentation technique
•
forums, contenu Wiki et autres ressources de collaboration pour vous aider &agrave; interagir avec des
d&eacute;veloppeurs qui partagent vos opinions
Adobe Labs encourage les processus collaboratifs de d&eacute;veloppement de logiciels. Dans cet
environnement, les clients apprennent rapidement &agrave; utiliser les nouveaux produits et les nouvelles
technologies de mani&egrave;re efficace. Adobe Labs comprend &eacute;galement un forum permettant de recueillir les
premiers commentaires. L'&eacute;quipe de d&eacute;veloppement Adobe s'appuie sur ces commentaires pour cr&eacute;er
des logiciels r&eacute;pondant aux besoins et aux attentes de la communaut&eacute;.
Forums Adobe
Pour consulter des experts de la communaut&eacute; Adobe RoboHelp, voir Forum Adobe RoboHelp. Si vous
ajoutez des commentaires sur une page d'aide, ils sont automatiquement publi&eacute;s sur le forum. Les
experts et les autres utilisateurs peuvent y r&eacute;pondre.
Adobe TV
Acc&eacute;dez &agrave; AdobeTV propose des vid&eacute;os permettant de parfaire ses connaissances ou de trouver une
source d'inspiration. La cha&icirc;ne Technical Communications pr&eacute;sente des vid&eacute;os pertinentes pour les
communicateurs techniques. Les vid&eacute;os sur la cha&icirc;ne RoboHelp vous aideront &agrave; d&eacute;marrer.
Si vous &ecirc;tes d&eacute;butant, regardez la vid&eacute;o RoboHelp pour les d&eacute;butants. Si vous &ecirc;tes un utilisateur exp&eacute;riment&eacute;, vous devez regarder la vid&eacute;o RoboHelp pour les utilisateurs exp&eacute;riment&eacute;s.
Exemples de projets et de sorties RoboHelp
Consulter la page Ressources RoboHelp pour t&eacute;l&eacute;charger les exemples de projets cr&eacute;&eacute;s avec RoboHelp et
d'autres ressources, comme les espaces de travail et les applications configur&eacute;s pour l'impl&eacute;mentation de
l'aide contextuelle.
P&ocirc;le de d&eacute;veloppement RoboHelp
Visiter le P&ocirc;le de d&eacute;veloppement RoboHelp pour consulter des articles &eacute;crits par les utilisateurs internes
et externes de RoboHelp sur diff&eacute;rents sujets.
5
R&Eacute;CAPITULATIF DES FONCTIONNALIT&Eacute;S DE ROBOHELP CLASSIC
PRISE EN MAIN
CHAPITRE 1
Aide des versions ant&eacute;rieures de RoboHelp
T&eacute;l&eacute;chargez la documentation des versions ant&eacute;rieures de RoboHelp sur la page centrale d'aide de
RoboHelp.
1.5.
R&eacute;capitulatif des fonctionnalit&eacute;s de RoboHelp Classic
Contenus interactifs &eacute;poustouflants produits avec la publication HTML5 de nouvelle
g&eacute;n&eacute;ration
Mises en forme Responsive HTML5 de nouvelle g&eacute;n&eacute;ration
Pr&eacute;sentez un contenu visuellement enrichi &agrave; votre public &agrave; l'aide des nouvelles mises en forme
HTML5 sans chrome. L'interface offre un aspect plus &eacute;pur&eacute; et pratique, qui permet d'acc&eacute;der
rapidement &agrave; la plupart des informations utiles. Ces mises en forme con&ccedil;ues par des professionnels
offrent une exp&eacute;rience sup&eacute;rieure et intuitive de recherche et de navigation.
Les mises en forme sont pr&eacute;charg&eacute;es avec un large &eacute;ventail de fonctions utiles, comme le curseur
de rubrique en bas de page, l'affichage ou le masquage de widgets tels que les glossaires et les
tables des mati&egrave;res, l'ajout de rubriques en tant que favoris et bien plus encore. Il offre une
conception r&eacute;active qui rend le site Web parfaitement op&eacute;rationnel sur des &eacute;crans et des
p&eacute;riph&eacute;riques de diff&eacute;rentes tailles. Le contenu s'ajuste de fa&ccedil;on dynamique en fonction de la taille
d'&eacute;cran de votre p&eacute;riph&eacute;rique.
Pour plus d'informations, voir Mise en page personnalisable de HTML5 Indigo.
Recherche plus rapide avec saisie semi-automatique
Le champ de recherche dans la sortie Responsive HTML5 affiche des r&eacute;sultats de la recherche
pr&eacute;dictive en fonction des caract&egrave;res saisis.
Lorsque vous saisissez les premi&egrave;res lettres d'une rubrique, d'un sujet ou de mots-cl&eacute;s dans la zone
de recherche, des suggestions appropri&eacute;es apparaissent dans la liste d&eacute;roulante. Les r&eacute;sultats de la
recherche s'affichent instantan&eacute;ment et il n'est pas n&eacute;cessaire d'entrer la cha&icirc;ne compl&egrave;te de
recherche ou de cliquer sur le bouton de recherche. Vos utilisateurs b&eacute;n&eacute;ficient d&eacute;sormais de
meilleurs r&eacute;sultats plus contextuels et pertinents en peu de temps et moins de clics.
L'ex&eacute;cution de l'algorithme en arri&egrave;re-plan affine les r&eacute;sultats de la recherche pour une efficacit&eacute;
de travail plus &eacute;lev&eacute;e. Cela simplifie consid&eacute;rablement la t&acirc;che de recherche et produit des r&eacute;sultats
plus pr&eacute;cis. Les r&eacute;sultats de la recherche sont class&eacute;s de mani&egrave;re intelligente en fonction de la
fr&eacute;quence de l'occurrence du terme recherch&eacute; dans le contenu.
Pour plus d'informations, voir Recherche &agrave; saisie semi-automatique.
6
CHAPITRE 1
R&Eacute;CAPITULATIF DES FONCTIONNALIT&Eacute;S DE ROBOHELP CLASSIC
PRISE EN MAIN
Prise en charge des vignettes
Gr&acirc;ce &agrave; la prise en charge des vignettes, vous pouvez publier et afficher les images sous forme de
vignettes. Cela r&eacute;duit le temps de chargement d'une page et permet l'enregistrement de la bande
passante, ce qui facilite le rendu et l'affichage du contenu sur les p&eacute;riph&eacute;riques mobiles.
Les vignettes sont cliquables, ce qui permet de charger une image volumineuse &agrave; la discr&eacute;tion de
l'utilisateur. Cela rend le contenu convivial, &eacute;vitant &agrave; l'utilisateur d'avoir &agrave; t&eacute;l&eacute;charger des fichiers
images volumineux qu'il n'a pas besoin d'afficher. Avec les vignettes en place, les utilisateurs
peuvent cliquer uniquement sur les images qui sont de leur int&eacute;r&ecirc;t. Les utilisateurs auront une plus
grande souplesse en d&eacute;finissant une taille de vignette standard qui assurera une apparence
coh&eacute;rente des vignettes tout au long de la sortie publi&eacute;e.
Pour plus d'informations, voir Vignettes.
Plus grande accessibilit&eacute; du contenu
La sortie que vous g&eacute;n&eacute;rez avec la mise en page Responsive HTML5 de th&egrave;me Indigo est conforme
&agrave; la norme 508. Avec l'utilisation et l'accessibilit&eacute; am&eacute;lior&eacute;es de votre site Web, vous pouvez
&eacute;tendre la port&eacute;e de votre contenu en ligne. Vous pouvez avantager tous vos clients, quels que
soient leurs besoins sp&eacute;cifiques, en conformit&eacute; avec les normes d'accessibilit&eacute; Web. Un avantage
potentiellement sup&eacute;rieur d'un contenu accessible est une meilleure visibilit&eacute; aux moteurs de
recherche.
Ajout de favoris dans des mises en page Responsive HTML5
Avec la mise en page Responsive HTML5 de th&egrave;me Indigo, vous pouvez marquer des rubriques
comme favoris et ajouter des liens personnalis&eacute;s, &eacute;pargnant ainsi du temps et des efforts lors d'un
nouvel acc&egrave;s au contenu.
Gagnez en productivit&eacute;
Importation d'un dossier pour les fichiers bagage
Gagnez du temps et travaillez efficacement avec la possibilit&eacute; d'importer des dossiers dans des
fichiers bagage. Si vous avez plusieurs fichiers bagage stock&eacute;s dans un dossier, vous pouvez ajouter
tous ces fichiers en un seul clic en ajoutant le dossier au projet. Cela facilite l'importation des
dossiers appropri&eacute;s contenant les informations de prise en charge. La structure hi&eacute;rarchique du
dossier est conserv&eacute;e dans le dossier Fichiers bagage de votre projet.
Pour plus d'informations, voir Ajout de fichiers et de dossiers au dossier Fichiers bagage.
7
A PROPOS DE ROBOHELP SERVER
PRISE EN MAIN
CHAPITRE 1
Activer/d&eacute;sactiver les vues variables
B&eacute;n&eacute;ficiez d'une plus grande accessibilit&eacute; du contenu et gagnez du temps en passant facilement du
nom de la variable &agrave; la valeur qu'elle repr&eacute;sente de diff&eacute;rentes mani&egrave;res - &agrave; l'aide du raccourci
clavier ou du menu contextuel. Cela vous permet d'afficher le contenu comme les utilisateurs finaux
le visualiseront. Vous pouvez activer ou d&eacute;sactiver une variable unique ou toutes les variables
utilis&eacute;es dans votre projet d'un simple clic.
Lorsque vous basculez tous les champs, l'&eacute;tat actuel par d&eacute;faut de la variable s&eacute;lectionn&eacute;e ou de la
premi&egrave;re variable de la rubrique est r&eacute;pliqu&eacute; sur toutes les variables dans le document actif.
Pour plus d'informations, voir Activer/d&eacute;sactiver les vues variables.
1.6.
A propos de RoboHelp Server
Adobe RoboHelp Server est une solution d'aide bas&eacute;e sur serveur qui fournit des commentaires de
l'utilisateur final en temps r&eacute;el sur votre aide et votre base de connaissances. RoboHelp Server rassemble
et journalise les donn&eacute;es &agrave; propos de ce que les utilisateurs demandent lors de leurs recherches de
contenu et sur comment les utilisateurs naviguent dans les rubriques. Les r&eacute;sultats sont pr&eacute;sent&eacute;s dans
un format graphique simple pour une interpr&eacute;tation rapide. Votre syst&egrave;me d'aide r&eacute;side sur un serveur
(par exemple, centre de ressources d'aide Adobe) et vous pouvez proc&eacute;der &agrave; des mises &agrave; jour
instantan&eacute;es du contenu de votre syst&egrave;me d'aide.
8
CHAPITRE 1
A PROPOS DE ROBOHELP SERVER
PRISE EN MAIN
RoboHelp Server contient les processus d'arri&egrave;re-plan, la fonctionnalit&eacute; de base de donn&eacute;es, et les
connexions JDBC n&eacute;cessaires pour l'int&eacute;grer. RoboHelp Server fonctionne avec l'outil de cr&eacute;ation d'aide,
pour permettre aux auteurs de modifier le contenu, de d&eacute;finir les options de projet ma&icirc;tre, d'assurer la
maintenance des fen&ecirc;tres et de consulter les rapports.
Interaction de RoboHelp Server avec diff&eacute;rents composants
REMARQUE : Avec RoboHelp Server, vous pouvez installer votre serveur de base de donn&eacute;es sur un
ordinateur distinct ou utiliser n'importe lequel des serveurs de base de donn&eacute;es existants.
Suivi et rapports
Adobe RoboHelp Server permet aux utilisateurs finaux de trouver des informations lorsqu'ils ont des
questions. Les utilisateurs finaux peuvent afficher le contenu &agrave; partir de n'importe quel navigateur et
syst&egrave;me d'exploitation standard. N'importe quel nombre d'utilisateurs peut acc&eacute;der aux documents
publi&eacute;s.
REMARQUE : Vous pouvez d&eacute;finir le nombre maximal de connexions &agrave; une base de donn&eacute;es pour les
syst&egrave;mes de gestion de bases de donn&eacute;es Oracle et SQL Server &agrave; l'aide de la propri&eacute;t&eacute; maxload dans le
fichier robohelp_server.properties.
9
CHAPITRE 1
A PROPOS DE ROBOHELP SERVER
PRISE EN MAIN
RoboHelp Server assure le suivi des types de donn&eacute;es suivants :
•
L&agrave; o&ugrave; les utilisateurs ont besoin d'assistance : identifie l'emplacement o&ugrave; les utilisateurs font des
demandes r&eacute;p&eacute;t&eacute;es d'informations sp&eacute;cifiques.
•
M&eacute;thodes de recherche des utilisateurs : recherches que les utilisateurs ex&eacute;cutent de fa&ccedil;on
r&eacute;p&eacute;t&eacute;e. Ces donn&eacute;es peuvent &ecirc;tre exploit&eacute;es pour d&eacute;placer les informations fr&eacute;quemment
recherch&eacute;es &agrave; une position plus &eacute;minente dans le contenu afin d'en faciliter l'acc&egrave;s. Vous pouvez
&eacute;galement utiliser ces informations pour rechercher les lacunes d'informations et am&eacute;liorer les
titres afin de permettre une navigation plus intuitive.
•
Navigation des utilisateurs dans le contenu en ligne : assure le suivi des m&eacute;thodes de recherche de
contenu en ligne des utilisateurs et de la fr&eacute;quence d'acc&egrave;s &agrave; des informations particuli&egrave;re telles
que les titres et les articles. Ces informations sont disponible au niveau rubrique.
•
RoboHelp Server permet de suivre toutes les d&eacute;tails relatifs au syst&egrave;me d'exploitation et au
navigateur. Vous pouvez utiliser ces informations pour am&eacute;liorer la qualit&eacute; du contenu pour les
navigateurs pr&eacute;f&eacute;r&eacute;s des utilisateurs.
Fusion automatique de projet
Travaillez simultan&eacute;ment sur plusieurs projets et fusionnez-les dans un projet lors de l'impl&eacute;mentation.
Lors de la cr&eacute;ation d'un syst&egrave;me d'information en ligne, les auteurs peuvent d&eacute;velopper et modifier leur
contenu en fonction de leurs propres planning. RoboHelp Server fournit la fusion de projet automatique,
afin que les auteurs puissent travailler sur diff&eacute;rentes parties d'un projet en m&ecirc;me temps, et les publient
sur le m&ecirc;me serveur. Lorsque les utilisateurs finaux consultent le contenu, ils voient une documentation
en ligne syst&egrave;me int&eacute;gr&eacute;e. Plus d'inqui&eacute;tudes concernant le partage de source et plus besoin de d&eacute;pendre
d'un seul auteur ou projet, tous les projets distincts sont fusionn&eacute;s lorsque les utilisateurs acc&egrave;dent au
contenu. Les utilisateurs peuvent parcourir l'ensemble des projets &agrave; l'aide des boutons d'index, de
contenu et de recherche.
Par d&eacute;faut, les projets sont ajout&eacute;s &agrave; la table des mati&egrave;res dans l'ordre dans lequel ils sont publi&eacute;s sur le
serveur. Vous pouvez personnaliser cet ordre dans la page Projets de l'interface d'administrateur Web.
Lorsque vous fusionnez des projets, chaque fichier de projet dans l'outil de cr&eacute;ation d'aide reste intact,
mais les mots-cl&eacute;s des index et des termes du glossaire sont combin&eacute;s &agrave; l'ex&eacute;cution, ou lorsque les
utilisateurs finaux acc&egrave;dent au syst&egrave;me depuis le serveur.
Prise en charge des langues autres que l'anglais
L'interface d'ex&eacute;cution (table des mati&egrave;res, index, glossaire, et recherche inclus) peut &ecirc;tre
automatiquement localis&eacute;e, et les auteurs peuvent publier des projets &eacute;crits dans diverses langues sur le
m&ecirc;me serveur. RoboHelp Server prend en charge la localisation pour le fran&ccedil;ais, l'allemand et le japonais.
Vous pouvez modifier le texte d'affichage sur l'interface utilisateur du syst&egrave;me en ligne pour qu'elle soit
dans une autre langue, y compris le texte sur les boutons de table des mati&egrave;res, d'index et de recherche.
En outre, les utilisateurs finaux peuvent effectuer une recherche de texte int&eacute;gral du contenu en ligne
dans leur langue native. Cela permet aux auteurs de d&eacute;velopper du contenu dans des langues autres que
l'anglais et de tirer parti des syst&egrave;mes de documentation en ligne bas&eacute;es sur un serveur.
10
INT&Eacute;GRATION AVEC SHAREPOINT
PRISE EN MAIN
CHAPITRE 1
1.7.
Int&eacute;gration avec SharePoint
RoboHelp 10 et les versions ult&eacute;rieures fournissent une int&eacute;gration native &agrave; Microsoft SharePoint. Cette
int&eacute;gration facilite la mise en place d'un flux de travaux de bout en bout en utilisant SharePoint comme
r&eacute;f&eacute;rentiel de contenu. Elle permet aussi le partage des &eacute;l&eacute;ments de RoboHelp entre l'ensemble des
projets et des utilisateurs. Vous pouvez ensuite utiliser l'espace de travail SharePoint en tant que
r&eacute;f&eacute;rentiel pour vos r&eacute;visions de fichiers PDF g&eacute;n&eacute;r&eacute;es par RoboHelp et publier le contenu RoboHelp sur
le serveur SharePoint.
Utiliser SharePoint en tant que r&eacute;f&eacute;rentiel de contenu pour le contenu RoboHelp :
RoboHelp prend en charge le contr&ocirc;le de version avec Microsoft SharePoint 2010 et version
ult&eacute;rieure en mode natif. Cela signifie que vous n'avez pas besoin d'installer de modules externes
tiers. Ajoutez vos projets RoboHelp au r&eacute;f&eacute;rentiel SharePoint. Vous pouvez ensuite archiver et
extraire des fichiers et effectuer d'autres op&eacute;rations de contr&ocirc;le de version depuis RoboHelp. Pour
plus de d&eacute;tails, reportez-vous &agrave; la section Contr&ocirc;le de version avec Microsoft SharePoint.
Publier du contenu multi-&eacute;cran et Responsive HTML5 sur SharePoint en mode natif pour un acc&egrave;s sur
ordinateur de bureau et p&eacute;riph&eacute;riques mobiles :
Publiez du contenu RoboHelp directement sur un site SharePoint depuis RoboHelp et
conform&eacute;ment aux recommandations de s&eacute;curit&eacute; et de compatibilit&eacute; de Microsoft. RoboHelp
prend en charge la publication de sorties multi-&eacute;cran HTML5 et Responsive HTML5 sur SharePoint
dans leur format natif (ASPX), assurant ainsi un affichage sans probl&egrave;me dans SharePoint. Lorsque
vous affichez la sortie publi&eacute;e, les rubriques apparaissent dans le chrome de SharePoint en tant que
page HTML continue unique. Pour plus d'informations sur la publication sur SharePoint, voir les
informations sur les onglets de SharePoint dans la documentation relatives aux bo&icirc;tes de dialogue
correspondante pour :
•
•
G&eacute;n&eacute;ration d'une sortie Multi-&eacute;cran HTML5
G&eacute;n&eacute;rer la sortie Responsive HTML5
Lier les &eacute;l&eacute;ments de SharePoint entre projets et utilisateurs RoboHelp :
vous pouvez lier des &eacute;l&eacute;ments de SharePoint (tels que des images, des fichiers multim&eacute;dias, des
vid&eacute;os Captivate, des fichiers CSS, etc.) entre de multiples projets et auteurs RoboHelp. La liaison
en direct du gestionnaire de ressources de RoboHelp est int&eacute;gr&eacute;e &agrave; SharePoint. Cela signifie que
lorsqu'un &eacute;l&eacute;ment est modifi&eacute; par un auteur, la modification se refl&egrave;te dans toutes les rubriques et
tous les projets RoboHelp qui utilisent (lient) cet &eacute;l&eacute;ment. Pour plus d'informations sur l'ajout d'un
emplacement SharePoint, voir Ajout d'un emplacement partag&eacute;.
H&eacute;berger du contenu RoboHelp sur l'espace de travail SharePoint pour la r&eacute;vision d'un PDF :
s&eacute;lectionnez les rubriques RoboHelp &agrave; envoyer en r&eacute;vision. H&eacute;bergez ce fichier PDF &agrave; r&eacute;viser dans
l'espace de travail SharePoint et envoyez le lien aux r&eacute;viseurs. Vos r&eacute;viseurs peuvent faire des
commentaires de r&eacute;vision &agrave; l'aide du lecteur gratuit de PDF, sans avoir &agrave; installer ou apprendre &agrave;
utiliser des logiciels suppl&eacute;mentaires. Vous pouvez ensuite importer tous les commentaires stock&eacute;s
sur l'espace de travail SharePoint dans le projet RoboHelp en un seul clic. Pour plus de d&eacute;tails,
reportez-vous &agrave; la section R&eacute;vision de fichiers PDF.
11
INT&Eacute;GRATION AVEC SHAREPOINT
PRISE EN MAIN
CHAPITRE 1
Tableau des versions de SharePoint
Le tableau suivant &eacute;num&egrave;re la prise en charge des versions de RoboHelp - SharePoint.
Version de
RoboHelp
Contr&ocirc;le de
version
Publication
Partage de
ressources
R&eacute;vision
11
SharePoint
2010 +
Prise en charge native :
SharePoint 2010 +
Par l'interm&eacute;diaire du
lecteur mapp&eacute; de
SharePoint :
SharePoint 2007
SharePoint 2007,
2010 +
SharePoint 2007,
2010 +
Adobe Acrobat X +
10
SharePoint
2010
Prise en charge native :
SharePoint 2010
Par l'interm&eacute;diaire du
lecteur mapp&eacute; de
SharePoint :
SharePoint 2007
SharePoint 2007,
2010
SharePoint 2007,
2010
Adobe Acrobat X +
12
PR&Eacute;SENTATION DE L'ESPACE DE TRAVAIL
D&Eacute;COUVERTE DE L'ESPACE DE TRAVAIL
CHAPITRE 2
2.
D&eacute;couverte de l'espace de travail
2.1.
Pr&eacute;sentation de l'espace de travail
Vous travaillez dans RoboHelp &agrave; l'aide de divers &eacute;l&eacute;ments, tels que les conteneurs, les volets, les barres
et les fen&ecirc;tres. Un espace de travail d&eacute;signe l'organisation de ces &eacute;l&eacute;ments. L'espace de travail RoboHelp
inclut des conteneurs, des volets et des onglets personnalisables. Personnalisez la barre d'outils Acc&egrave;s
rapide pour inclure vos commandes les plus souvent utilis&eacute;es. Vous pouvez &eacute;galement personnaliser les
raccourcis clavier.
Espace de travail RoboHelp
A.
Barre d'outils Acc&egrave;s rapide
B.
Onglets
C.
Volet Document &agrave; onglets
D.
Conception et volets de vue HTML
E.
S&eacute;lecteurs de zones de document
F.
S&eacute;lecteur d'espace de travail
G, H, I.
Conteneurs club
13
CHAPITRE 2
PR&Eacute;SENTATION DE L'ESPACE DE TRAVAIL
D&Eacute;COUVERTE DE L'ESPACE DE TRAVAIL
Barre d'outils Acc&egrave;s rapide
La barre d'outils Acc&egrave;s rapide dans le coin sup&eacute;rieur droit contient les commandes les plus souvent
utilis&eacute;es.
La liste d&eacute;roulante la plus &agrave; droite contient les options suivantes :
Autres commandes
Dans la bo&icirc;te de dialogue Personnaliser :
Personnalisation des raccourcis clavier RoboHelp
Modification du th&egrave;me de RoboHelp : clair ou sombre; ic&ocirc;nes de couleur ou en niveaux de gris
Ajoutez ou supprimez des commandes sur la barre d'outils Acc&egrave;s rapide.
Afficher en dessous du ruban
Affichez la barre d'outils Acc&egrave;s rapide au-dessus (par d&eacute;faut) ou en dessous des rubans.
R&eacute;duire le ruban
Affichez (par d&eacute;faut) ou masquez le ruban de RoboHelp.
Onglets de RoboHelp
Les onglets de RoboHelp, tels que Projet, Edition, Sortie et R&eacute;vision, vous permettent d'acc&eacute;der
rapidement &agrave; toutes les commandes disponibles de RoboHelp. Pour plus d'informations, voir Utilisation
des onglets de RoboHelp.
Volet Document &agrave; onglets
La fen&ecirc;tre de rubrique ou le volet Document &agrave; onglets affiche la ou les rubriques en cours de
modification. S&eacute;lectionnez Fichier &gt; Options &gt; Autoriser la modification de plusieurs rubriques pour
modifier plusieurs rubriques simultan&eacute;ment. Vous pouvez copier des objets et des s&eacute;lections d'une
rubrique et les coller dans d'autres rubriques. Vous pouvez s&eacute;lectionner une mosa&iuml;que horizontale ou
verticale.
Les boutons Conception et HMTL dans la fen&ecirc;tre de rubrique permettent de basculer entre l'&eacute;diteur de
conception et l'&eacute;diteur HTML.
Lorsque plusieurs rubriques sont ouvertes, cliquez sur la fl&egrave;che vers le bas dans le coin sup&eacute;rieur droit du
volet Document &agrave; onglets pour afficher la liste des rubriques ouvertes et acc&eacute;der &agrave; une rubrique
quelconque.
Utilisez les boutons fixes inclus dans le volet Document &agrave; onglets pour ouvrir et fermer rapidement des
rubriques.
Cliquez sur un onglet avec le bouton droit de la souris afin d'obtenir des options pour enregistrer la
rubrique active, fermer la rubrique active, fermer toutes les rubriques, fermer toutes les fen&ecirc;tres sauf la
rubrique active et cr&eacute;er des groupes d'onglets verticaux ou horizontaux.
14
UTILISATION DES ONGLETS DE ROBOHELP
D&Eacute;COUVERTE DE L'ESPACE DE TRAVAIL
CHAPITRE 2
Conteneurs
Diff&eacute;rents conteneurs, tels que Gestionnaire de projets, Configuration de la sortie, Gestionnaire de
ressources et Mises en page source unique, vous aident &agrave; effectuer les diff&eacute;rentes &eacute;tapes afin de cr&eacute;er le
projet et g&eacute;n&eacute;rer la sortie requise. S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs pour afficher ou masquer
les conteneurs souhait&eacute;s.
REMARQUE : Vous pouvez &eacute;galement acc&eacute;der &agrave; la liste des conteneurs dans les onglets Modification.
A partir du menu contextuel de la barre de titre d'un conteneur, acc&eacute;dez &agrave; des options telles qu'Ancrable,
Flottant et Document &agrave; onglets pour organiser les conteneurs de diverses fa&ccedil;ons. Le menu inclut
&eacute;galement des options pour masquer et fermer le conteneur.
2.2.
Utilisation des onglets de RoboHelp
Les commandes de RoboHelp incluses dans les groupes logiques sont regroup&eacute;es en plusieurs onglets.
Chaque onglet contient les commandes li&eacute;es &agrave; la fonctionnalit&eacute; concern&eacute;e. Les onglets sont &eacute;galement
des groupes li&eacute;s aux t&acirc;ches effectu&eacute;es par un utilisateur &agrave; tout moment. Par exemple, l'onglet Edition
comprend des commandes sp&eacute;cifiques pour modifier le contenu RoboHelp. L'onglet Sortie comprend la
commande li&eacute;e &agrave; la g&eacute;n&eacute;ration de sorties.
Certaines commandes courantes sont incluses dans diff&eacute;rents onglets. Par exemple, la liste d&eacute;roulante de
conteneurs est disponible dans les onglets Projet et Modification. De plus, certains onglets contextuels
n'apparaissent que dans le contexte apparent&eacute;. Par exemple l'onglet Tableau s'affiche uniquement
lorsque vous travaillez dans un tableau.
L'interface de RoboHelp inclut les onglets suivants :
Onglet
Description
Fichier
Contient des options telles qu'Ouvrir, Fermer, Renommer et Liste des projets
r&eacute;cents. Cet onglet contient &eacute;galement des liens vers de nombreuses ressources et
options d'aide ou qui sont relatives &agrave; la communaut&eacute; pour personnaliser les
pr&eacute;f&eacute;rences de RoboHelp.
Projet (Project)
Inclut les commandes associ&eacute;es &agrave; un projet. Vous g&eacute;rez, cr&eacute;ez, importez, modifiez
et supprimez des composants au niveau d'un projet tels que les rubriques, les
extraits de code, les balises et des variables. Vous pouvez enregistrer les
modifications actuellement non enregistr&eacute;es du projet.
Modifier
Vous permet d'effectuer des t&acirc;ches de cr&eacute;ation telles que la cr&eacute;ation et la
modification de feuilles de style. Lors de la cr&eacute;ation de contenus d'une rubrique,
d'un extrait de code ou d'une page principale, vous pouvez s&eacute;lectionner des
commandes dans cet onglet telles que Gras, Italique, Police et Aligner. Vous pouvez
&eacute;galement appliquer des balises au contenu.
Ins&eacute;rer
Vous pouvez utiliser les commandes pour ins&eacute;rer plusieurs types d'objets &agrave;
diff&eacute;rents stades de votre projet. Ces objets incluent les tableaux, les images, le
contenu Captivate et les extraits de code.
15
UTILISATION DES CONTENEURS
D&Eacute;COUVERTE DE L'ESPACE DE TRAVAIL
CHAPITRE 2
Onglet
Description
R&eacute;vision
Lorsque vous configurez ou importez les commentaires d'une r&eacute;vision partag&eacute;e de
PDF, vous pouvez utiliser les commandes de cet onglet. Cet onglet comprend
&eacute;galement des commandes qui vous permettent de suivre, accepter et rejeter les
modifications d'une r&eacute;vision de document.
Collaboration
Inclut des commandes qui vous permettent de partager des ressources de projet
avec les utilisateurs. Vous pouvez &eacute;galement configurer et utiliser le contr&ocirc;le de
version.
Sortie
Les options de cet onglet vous permettent de cr&eacute;er, configurer, g&eacute;n&eacute;rer et afficher
les sorties de RoboHelp.
Outils
Vous pouvez cr&eacute;er et afficher des rapports. RoboHelp est fourni avec un certain
nombre de scripts que vous pouvez utiliser pour ex&eacute;cuter certaines commandes.
S&eacute;lectionnez et ex&eacute;cutez des scripts depuis la liste Scripts de cet onglet.
Tableau
Permet d'acc&eacute;der aux commandes sp&eacute;cifiques aux tableaux telles que la fusion, la
division, les bordures et la trame.
Remarque : Cet onglet est contextuel et s'affiche uniquement lorsque le point
d'insertion se trouve dans le tableau.
Position
Vous permet de positionner et redimensionner une zone de texte positionn&eacute;e.
Remarque : Cet onglet est contextuel et s'affiche uniquement lorsqu'une zone de
texte positionn&eacute;e est s&eacute;lectionn&eacute;e. Pour ins&eacute;rer une zone de texte positionn&eacute;e,
acc&eacute;dez &agrave; l'onglet Ins&eacute;rer et choisissez Zone de texte positionn&eacute;e.
2.3.
Utilisation des conteneurs
Les conteneurs sont des volets de flux de travaux positionnables &agrave; l'emplacement de votre choix dans la
fen&ecirc;tre de l'application. Ils vous permettent d'acc&eacute;der rapidement &agrave; des fonctions regroup&eacute;es de
mani&egrave;re logique &agrave; un m&ecirc;me emplacement. Par exemple, vous pouvez s&eacute;lectionner et g&eacute;n&eacute;rer diff&eacute;rentes
mises en page depuis le conteneur Mises en page source unique.
RoboHelp vous permet d'acc&eacute;der aux conteneurs et aux projets les plus fr&eacute;quemment utilis&eacute;s de diverses
mani&egrave;res. Vous pouvez positionner un conteneur n'importe o&ugrave; sur l'&eacute;cran ou sur un autre moniteur. La
fonction de masquage automatique des conteneurs vous permet de les masquer sur le bureau.
Affichage d'un conteneur
1)
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; [nom du conteneur].
–
S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; [nom du conteneur].
16
UTILISATION DES CONTENEURS
D&Eacute;COUVERTE DE L'ESPACE DE TRAVAIL
CHAPITRE 2
Organisation des conteneurs
•
•
Cliquez sur la barre de titre d'un conteneur et faites-le glisser sur la partie souhait&eacute;e de l'&eacute;cran.
Modifiez l'affichage du conteneur.
a) Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
•
Cliquez sur la fl&egrave;che vers le bas dans le coin sup&eacute;rieur droit d'un conteneur.
•
Cliquez avec le bouton droit de la souris dans la barre de titre du conteneur.
b)
S&eacute;lectionnez l'une des options suivantes :
Ancrable
Ancre le conteneur s'il se trouve dans l'&eacute;tat Document &agrave; onglets ou dans l'&eacute;tat Flottant.
Fermer
Ferme le conteneur
Flottant
Rend le conteneur flottant s'il se trouve dans l'&eacute;tat Document &agrave; onglets ou dans l'&eacute;tat ancr&eacute;.
Masquer automatiquement
Fixe ou lib&egrave;re le conteneur s'il n'est pas dans l'&eacute;tat Document &agrave; onglets.
Document &agrave; onglets
Ouvre le conteneur dans un nouvel onglet dans la fen&ecirc;tre de rubrique.
Types de conteneurs
Conteneur D&eacute;marrage
Ce conteneur fournit des liens vers les commandes les plus courantes et les informations relatives au
produit.
Projets r&eacute;cents
Ouvre les projets r&eacute;cemment utilis&eacute;s (dans la liste comportant jusqu'&agrave; dix projets utilis&eacute;s) et les
autres projets.
Cr&eacute;er nouveau
S&eacute;lectionnez le type d'aide &agrave; g&eacute;n&eacute;rer.
Importer
Vous pouvez importer un projet d'aide du type HTML Help, document Word ou tout type
disponible.
17
CHAPITRE 2
UTILISATION DES CONTENEURS
D&Eacute;COUVERTE DE L'ESPACE DE TRAVAIL
Ressources
Acc&eacute;dez &agrave; des forums, des p&ocirc;les de d&eacute;veloppement, des articles de base de connaissances, l'aide
en ligne compl&egrave;te, des vid&eacute;os, et d'autres types de contenu en ligne.
Profitez du flux pr&eacute;sentant les ressources de formation dans le conteneur D&eacute;marrage. Si ce flux vous
g&ecirc;ne, vous pouvez le masquer en d&eacute;s&eacute;lectionnant l'option Afficher les ressources de formation sur la
page de d&eacute;marrage dans les param&egrave;tres g&eacute;n&eacute;raux.
Conteneur Gestionnaire de projets
Le conteneur Gestionnaire de projets comporte divers dossiers vous permettant de cr&eacute;er et supprimer
des fichiers de projet, ou de modifier leurs propri&eacute;t&eacute;s. Il comporte &eacute;galement des dossiers pour diff&eacute;rents
composants de projet essentiels, tels que la table des mati&egrave;res, l'index et le glossaire.
ASTUCE : Si le projet comporte de nombreuses rubriques, r&eacute;duisez d'abord le dossier Fichiers de projet
pour afficher les autres dossiers.
LIENS CONNEXES :
Dossiers du gestionnaire de projets
Conteneur Configuration de sortie
Le conteneur Configuration de sortie se compose des dossiers suivants :
Fen&ecirc;tres
Conteneurs de sortie. Les fen&ecirc;tres personnalis&eacute;es des projets sont stock&eacute;es dans ce dossier. Pour
modifier les propri&eacute;t&eacute;s d'une fen&ecirc;tre, cliquez deux fois sur l'ic&ocirc;ne qui lui est associ&eacute;e.
Pages principales
Les pages principales permettent de r&eacute;utiliser les informations et de cr&eacute;er une pr&eacute;sentation
standard d'une rubrique &agrave; l'autre.
Habillages
Les habillages dans les projets WebHelp ou FlashHelp permettent de modifier l'apparence du
syst&egrave;me d'aide. Vous pouvez mapper cette pr&eacute;sentation sur celle du site Web d'une entreprise
quelconque ou ajouter des &eacute;l&eacute;ments pertinents et changer le style d'une sortie. Les habillages
permettent de personnaliser les couleurs, les boutons, le texte, les polices, les ic&ocirc;nes, les couleurs
d'arri&egrave;re-plan, les options multim&eacute;dia (projets FlashHelp) ainsi que les images des ic&ocirc;nes de la table
des mati&egrave;res et des boutons de navigation, entre autres.
Profils d'&eacute;cran
Conteneur pour les profils d'&eacute;cran utilis&eacute;s dans la sortie multi-&eacute;cran HTML5.
Mises en forme d'&eacute;cran
Conteneur pour les mises en forme d'&eacute;cran utilis&eacute;es dans la sortie multi-&eacute;cran HTML5.
18
CHAPITRE 2
UTILISATION DES CONTENEURS
D&Eacute;COUVERTE DE L'ESPACE DE TRAVAIL
Aide contextuelle
Ce conteneur correspond aux dossiers Fichiers de mappage et Fichiers d'aide Qu'est-ce que c'est ?.
•
•
Le dossier Fichiers de mappage permet d'acc&eacute;der aux fichiers de mappage et de r&eacute;aliser la plupart
des t&acirc;ches contextuelles au niveau des fen&ecirc;tres.
Le dossier Fichiers d'aide Qu'est-ce que c'est ? permet de r&eacute;aliser des t&acirc;ches contextuelles au
niveau des champs dans les projets HTML Help.
LIENS CONNEXES :
Fen&ecirc;tres
Pages principales
Habillages
Profils d'&eacute;cran
Mises en page d'&eacute;cran
&Agrave; propos de l'aide contextuelle
Fichiers de mappage et ID de mappage
Conteneur Extraits de code
Ajoutez des extraits de code HTML personnalis&eacute;s &agrave; un projet, afin de les ins&eacute;rer plus tard dans les
rubriques de votre choix. Lorsque vous modifiez un extrait de code partag&eacute; par plusieurs rubriques, cette
modification se r&eacute;percute sur l'ensemble des rubriques associ&eacute;es.
Les extraits de code sont stock&eacute;s dans une biblioth&egrave;que d'extraits de code en tant que fichiers distincts
avec l'extension .hts. Dans le conteneur Extraits de code, vous pouvez les organiser en cat&eacute;gories, en
d&eacute;veloppant ou r&eacute;duisant les cat&eacute;gories pour en faciliter l'affichage. Les noms des cat&eacute;gories s'affichent
dans un ordre de tri dans le conteneur Extraits de code et dans la bo&icirc;te de dialogue d'insertion. Pour
ins&eacute;rer un extrait de code dans une rubrique, il vous suffit de le s&eacute;lectionner et de le faire glisser vers
l'emplacement de votre choix dans la rubrique. Vous pouvez &eacute;galement s&eacute;lectionner des extraits de code,
puis les copier, les dupliquer ou les supprimer. S&eacute;lectionnez l'option Aper&ccedil;u dans le menu contextuel pour
afficher un aper&ccedil;u de l'extrait de code.
LIENS CONNEXES :
Source unique pour les extraits de code
Conteneur Styles et formatage
Ce conteneur permet d'appliquer des styles rapidement. S&eacute;lectionnez un style dans le conteneur et
appliquez-le au texte s&eacute;lectionn&eacute; dans la rubrique. Dans ce conteneur, vous pouvez cr&eacute;er et modifier un
style directement. Cliquez avec le bouton droit de la souris sur un style pour le renommer, le supprimer
ou en cr&eacute;er un aper&ccedil;u.
REMARQUE : S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Style et formatage pour afficher le conteneur
Styles et formatage. Pour ce faire, vous devez ouvrir une rubrique.
LIENS CONNEXES :
Cr&eacute;ation d'un style via le conteneur Styles et formatage
19
CHAPITRE 2
UTILISATION DES CONTENEURS
D&Eacute;COUVERTE DE L'ESPACE DE TRAVAIL
Conteneur Variables d&eacute;finies par l'utilisateur
Ce conteneur vous permet d'effectuer les t&acirc;ches suivantes :
•
Cr&eacute;er, modifier et supprimer des variables.
•
Cr&eacute;er, modifier et supprimer des jeux de variables.
•
Fournissez et modifiez les valeurs d'ex&eacute;cution de mani&egrave;re unique pour diff&eacute;rents jeux de variables
lors de la g&eacute;n&eacute;ration de la sortie.
•
Mettre en forme des valeurs de variable.
LIENS CONNEXES :
Variables d&eacute;finies par l'utilisateur
Conteneur Liste d'erreurs
Le conteneur Liste d'erreurs affiche des boutons pour les erreurs, les avertissements et les messages
affich&eacute;s lorsque vous essayez de valider une rubrique ou une page principale. Vous pouvez cliquer sur ces
boutons pour afficher les informations correspondantes dans la liste d'erreurs. La l&eacute;gende des boutons
indique le nombre d'erreurs, d'avertissements et de messages. Vous pouvez cliquer sur tous ces boutons
pour afficher les informations correspondantes.
Conteneur Affichage de la sortie
Le conteneur Affichage de la sortie affiche les erreurs, avertissements et messages importants, captur&eacute;s
par RoboHelp lors de l'importation de contenu ou de la g&eacute;n&eacute;ration de la sortie du projet. Vous pouvez
utiliser la barre d'outils Acc&egrave;s rapide et les options de bouton droit de la souris pour enregistrer, copier,
s&eacute;lectionner ou effacer le journal.
Conteneur Bo&icirc;te &agrave; outils
Le conteneur Bo&icirc;te &agrave; outils fournit les ic&ocirc;nes de raccourci permettant d'acc&eacute;der aux divers outils fournis
avec RoboHelp. Vous pouvez &eacute;galement ajouter des outils.
Graphics Locator, HTML Help Studio et Resize sont autant d'exemples d'outils par d&eacute;faut.
Conteneur Gestionnaire de ressources
Le Gestionnaire de ressources stocke toutes les ressources communes &agrave; utiliser dans diff&eacute;rents projets et
permet d'acc&eacute;der rapidement aux fichiers des ressources communes afin de les g&eacute;rer.
Emplacements partag&eacute;s
Sp&eacute;cifiez les diff&eacute;rents dossiers partag&eacute;s qui stockent les fichiers de ressources &agrave; utiliser dans
l'ensemble des projets. Un emplacement partag&eacute; peut contenir des fichiers de tout type, mais le
Gestionnaire de ressources affiche uniquement ceux qui correspondent aux types de fichier d&eacute;finis
(Ajouter/Modifier des cat&eacute;gories).
Cat&eacute;gories
Sp&eacute;cifiez des cat&eacute;gories pour organiser les ressources en fonction des types de fichier. Par exemple,
vous pouvez ajouter une cat&eacute;gorie appel&eacute;e Vid&eacute;o et lui associer les types de fichiers .flv, .swf et .avi.
20
ENVIRONNEMENTS
D&Eacute;COUVERTE DE L'ESPACE DE TRAVAIL
CHAPITRE 2
Types de fichier
Affichez les extensions associ&eacute;es &agrave; une cat&eacute;gorie. Par exemple, pour la cat&eacute;gorie Images, listez tous
les types de fichier que le Gestionnaire de ressources doit consid&eacute;rer comme des images.
Ressources li&eacute;es
G&eacute;rez les ressources li&eacute;es (ressources utilis&eacute;es dans le projet avec des liens vers les versions
d'origine dans les emplacements partag&eacute;s). Synchronisez la version d'origine et la copie, supprimez
les liens pour arr&ecirc;ter le suivi automatique des mises &agrave; jour ou remplacez les liens pour pointer vers
une autre ressource du m&ecirc;me type de fichier.
LIENS CONNEXES :
Gestion des ressources partag&eacute;es
Conteneur Recherche de contenu externe
Le conteneur Recherche de contenu externe vous permet d'indiquer des URL pour le contenu disponible
&agrave; l'ext&eacute;rieur du syst&egrave;me d'aide (par exemple, dans les blogs) et de les mapper avec des termes que les
utilisateurs sont susceptibles de rechercher. En pr&eacute;sentant le contenu pertinent de cette mani&egrave;re, vous
pouvez optimiser la recherche pour les utilisateurs et faciliter l'acc&egrave;s au contenu g&eacute;n&eacute;r&eacute; par les
utilisateurs.
LIENS CONNEXES :
Recherche de contenu externe
Conteneur RoboHelp Server
Le conteneur RoboHelp Server vous permet de vous connecter &agrave; RoboHelp Server. Vous pouvez
configurer le serveur en s&eacute;lectionnant Responsive HTML5, WebHelp Pro ou FlashHelp Pro comme mise
en page principale.
Vous pouvez entrer le serveur http://&lt;nom-serveur&gt;:&lt;num&eacute;ro-port&gt;/&lt;nom-contexte&gt;/serveur
et vous y connecter pour publier vos projets.
REMARQUE : Par d&eacute;faut, RoboHelp Server utilise le protocole http. Pour sp&eacute;cifier qu'il convient d'utiliser le protocole https, saisissez http://&lt;nom-serveur&gt;:&lt;num&eacute;ro-port&gt;/&lt;nom-contexte&gt;/serveur.
2.4.
Environnements
Un environnement RoboHelp fait r&eacute;f&eacute;rence &agrave; l'organisation des diff&eacute;rents composants de l'espace de
travail, tels que les conteneurs, dans la fen&ecirc;tre principale de l'application. En enregistrant l'espace de
travail actif comme environnement nomm&eacute;, vous pouvez restaurer cet espace m&ecirc;me si vous avez d&eacute;plac&eacute;
ou ferm&eacute; un conteneur. Les noms des environnements enregistr&eacute;s apparaissent dans le menu Espace de
travail sur la droite de la barre de menus.
21
CHAPITRE 2
ENVIRONNEMENTS
D&Eacute;COUVERTE DE L'ESPACE DE TRAVAIL
Cr&eacute;ation et enregistrement d'un environnement
Vous pouvez cr&eacute;er plusieurs environnements pour un projet. Un seul environnement est charg&eacute; &agrave; la fois.
1) Organisez les conteneurs.
2) Cliquez sur la fl&egrave;che vers le bas dans le s&eacute;lecteur d'espace de travail et s&eacute;lectionnez Enregistrer
l'environnement.
3) Saisissez un nom de fichier ainsi que l'extension .rhs.
4) Indiquez un emplacement pour l'environnement. L'emplacement par d&eacute;faut est C:\Documents and
Settings\[nom d'utilisateur]\Mes documents\My RoboHelp Projects.
REMARQUE : Vous pouvez &eacute;changer un fichier RHS avec d'autres auteurs.
Chargement d'un environnement
1)
2)
3)
Cliquez sur la fl&egrave;che vers le bas dans le s&eacute;lecteur d'espace de travail et s&eacute;lectionnez Charger
l'environnement.
Acc&eacute;dez &agrave; un fichier RHS et s&eacute;lectionnez-le.
Cliquez sur Ouvrir.
REMARQUE : Le dernier environnement dans lequel vous avez travaill&eacute; est &agrave; nouveau utilis&eacute; &agrave; l'ouverture
suivante de RoboHelp.
Restauration de l'environnement par d&eacute;faut
1)
Cliquez sur la fl&egrave;che vers le bas dans le s&eacute;lecteur d'espace de travail et s&eacute;lectionnez Environnement
par d&eacute;faut.
Suppression d'un environnement
1)
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Supprimez le fichier RHS de l'emplacement o&ugrave; il &eacute;tait stock&eacute;.
–
Cliquez sur D&eacute;marrer &gt; Ex&eacute;cuter. Dans la bo&icirc;te de dialogue Ouvrir, saisissez regedit, puis
cliquez sur OK. Localisez la variable MRUENVFile[n] dans HKEY_CURRENT_USER &gt; Software &gt;
Adobe &gt; RoboHelp &gt; [version] &gt; Common et supprimez la cha&icirc;ne affect&eacute;e &agrave; la variable.
22
CR&Eacute;ATION ET SUPPRESSION DE RACCOURCIS CLAVIER
D&Eacute;COUVERTE DE L'ESPACE DE TRAVAIL
CHAPITRE 2
2.5.
Cr&eacute;ation et suppression de raccourcis clavier
Cr&eacute;ation de raccourcis clavier
1)
2)
3)
4)
5)
6)
Cliquez sur la fl&egrave;che de d&eacute;roulement &agrave; droite de la barre d'outils Acc&egrave;s rapide et s&eacute;lectionnez Autres
commandes.
Dans l'onglet G&eacute;n&eacute;ral de la bo&icirc;te de dialogue Personnaliser, v&eacute;rifiez Afficher les conseils pour le
clavier pour afficher le raccourci clavier. Appuyez sur la touche Alt, maintenez-la enfonc&eacute;e pendant
quelques secondes et rel&acirc;chez-la.
Cliquez sur Personnaliser les raccourcis clavier.
Dans la liste d&eacute;roulante Cat&eacute;gorie, s&eacute;lectionnez une cat&eacute;gorie d'onglet.
S&eacute;lectionnez une commande depuis la liste Commandes, puis positionnez le point d'insertion dans
le champ Appuyez sur une nouvelle touche de raccourci.
Utilisez le clavier pour choisir une combinaison de touches de raccourci et cliquez sur Assigner.
Suppression ou r&eacute;initialisation de touches de raccourci
1)
2)
3)
4)
Cliquez sur la fl&egrave;che de d&eacute;roulement &agrave; droite de la barre d'outils Acc&egrave;s rapide et s&eacute;lectionnez Autres
commandes.
Cliquez sur Personnaliser les raccourcis clavier.
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Pour supprimer un raccourci clavier, s&eacute;lectionnez la cat&eacute;gorie et la commande du raccourci
clavier &agrave; supprimer. S&eacute;lectionnez le raccourci dans la liste Affectation des touches, puis cliquez
sur Supprimer.
–
Pour r&eacute;initialiser l'ensemble des touches de raccourci sur leurs valeurs par d&eacute;faut, cliquez sur
Tout r&eacute;tablir.
Cliquez sur Exporter pour exporter des raccourcis clavier au format .csv.
Vous pouvez ensuite partager le fichier de raccourcis.
2.6.
1)
Configuration des param&egrave;tres g&eacute;n&eacute;raux
S&eacute;lectionnez Fichier &gt; Options. Cliquez sur G&eacute;n&eacute;ral et d&eacute;finissez les options suivantes d'utilisation
du programme et des fichiers du projet.
D&eacute;finition de la langue par d&eacute;faut et d'autres pr&eacute;f&eacute;rences
Langue par d&eacute;faut pour les nouveaux projets
Permet de changer la langue par d&eacute;faut de tous les projets cr&eacute;&eacute;s &agrave; l'aide de l'application RoboHelp.
23
CHAPITRE 2
CONFIGURATION DES PARAM&Egrave;TRES G&Eacute;N&Eacute;RAUX
D&Eacute;COUVERTE DE L'ESPACE DE TRAVAIL
Utiliser des tirets de soulignement dans les noms de fichiers
Enregistre les noms de fichier des rubriques en s&eacute;parant les mots par des tirets de soulignement
(Ma_rubrique_aide.htm par exemple). Les noms de fichiers des rubriques des projets HTML Help
requi&egrave;rent des caract&egrave;res de soulignement au lieu des espaces. Cette convention permet au livre ou
&agrave; la page de se synchroniser avec le contenu de la rubrique qui s'affiche sur le c&ocirc;t&eacute; droit de
l'afficheur.
Rechercher automatiquement les mises &agrave; jour
Le programme recherche les mises &agrave; jour lorsque vous quittez le programme. Vous pouvez
&eacute;galement activer cette option en s&eacute;lectionnant Fichier &gt; Aide &gt; Rechercher les mises &agrave; jour.
Autoriser la modification de plusieurs rubriques
Ouvre les rubriques dans des onglets diff&eacute;rents dans l'&eacute;diteur de conception et permet leur
modification. D&eacute;sactivez cette option pour travailler en mode de rubrique simple.
Effacer le cache de projet (fichier .cpd) avant l'ouverture d'un projet
Contr&ocirc;le si l'ancien fichier &lt;NomProjet&gt;.cpd sera supprim&eacute; chaque fois lors de l'ouverture d'un
projet et un nouveau &lt;NomProjet&gt;.cpd sera cr&eacute;&eacute; &agrave; partir des fichiers de projet.
M&eacute;moriser l'&eacute;tat du projet
Cochez cette option pour vous assurer que RoboHelp m&eacute;morise l'emplacement des fichiers ouverts
et des conteneurs. La prochaine fois que vous ouvrirez RoboHelp, le projet s'ouvrira dans le m&ecirc;me
&eacute;tat. D&eacute;sactivez cette option pour emp&ecirc;cher RoboHelp de m&eacute;moriser l'&eacute;tat actuel.
Compiler automatiquement les fichiers obsol&egrave;tes
Lors de l'affichage ou de la publication du projet, le programme g&eacute;n&egrave;re automatiquement la mise
en page principale si les fichiers de sortie ne sont plus &agrave; jour. Si cette option est d&eacute;sactiv&eacute;e, le
programme vous demande de g&eacute;n&eacute;rer la mise en page principale si les fichiers de sortie sont
p&eacute;rim&eacute;s.
Vue de la sortie d'affichage auto
Affiche la sortie en bas de la fen&ecirc;tre de l'application lorsqu'un projet est en cours de g&eacute;n&eacute;ration.
Convertir les rubriques modifi&eacute;es avec RoboHelp au format HTML
Convertit les rubriques XHTML cr&eacute;&eacute;es ou modifi&eacute;es dans RoboHelp au format HTML dans la sortie.
Les rubriques cr&eacute;&eacute;es ou modifi&eacute;e par des &eacute;diteurs tiers ne sont pas convertis.
Afficher les ressources d'apprentissage sur la page D&eacute;marrage
Affiche ou masque la zone dans laquelle un flux de ressources d'apprentissage, tels que des
Webinaires, des didacticiels vid&eacute;o et des livres blancs, est affich&eacute; sur la page de d&eacute;marrage.
24
CHAPITRE 2
CONFIGURATION DES PARAM&Egrave;TRES G&Eacute;N&Eacute;RAUX
D&Eacute;COUVERTE DE L'ESPACE DE TRAVAIL
Activation ou d&eacute;sactivation de la confirmation
Avertir lorsqu'un fichier est enregistr&eacute;
L'option Un fichier est enregistr&eacute; est d&eacute;sactiv&eacute;e par d&eacute;faut. Elle permet d'enregistrer
automatiquement les modifications apport&eacute;es &agrave; la rubrique active avant l'ouverture d'une autre
rubrique ou la fermeture du projet. Vous pouvez, le cas &eacute;ch&eacute;ant, d&eacute;sactiver ce param&egrave;tre &agrave; cet
endroit. Vous pouvez par exemple restaurer le contenu modifi&eacute; d'une rubrique en d&eacute;sactivant
temporairement l'enregistrement automatique.
Avertir lorsque des rubriques g&eacute;n&eacute;r&eacute;es automatiquement &agrave; partir de documents li&eacute;s sont modifi&eacute;es
Vous permet d'activer ou d&eacute;sactiver le message affich&eacute; lorsque vous modifiez une rubrique g&eacute;n&eacute;r&eacute;e
&agrave; partir du contenu d'un document Word ou FrameMaker li&eacute;.
Activation, d&eacute;sactivation ou r&eacute;initialisation des notifications
Par d&eacute;faut, les notifications sont activ&eacute;es. Certaines notifications comprennent une option (Ne plus me
demander) permettant de supprimer leur affichage.
•
Pour activer ou d&eacute;sactiver toutes les notifications, d&eacute;s&eacute;lectionnez ou s&eacute;lectionnez Fichier &gt;
Options &gt; G&eacute;n&eacute;ralit&eacute;s &gt; Ne pas afficher les notifications.
•
Pour restaurer les param&egrave;tres par d&eacute;faut de toutes les notifications, cliquez sur Tout r&eacute;tablir.
25
EL&Eacute;MENTS DE BASE DU PROJET
PROJETS
CHAPITRE 3
3.
Projets
3.1.
El&eacute;ments de base du projet
A propos des projets
Les projets contiennent les fichiers source qui deviennent le syst&egrave;me d'aide final. Aidez les auteurs &agrave;
travailler avec les fichiers de projet et les utilisateurs de l'aide &agrave; consulter la sortie. Pour la sortie CHM, le
projet se compose du contenu que vous cr&eacute;ez et des propri&eacute;t&eacute;s que vous configurez ; il peut s'agir par
exemple de l'apparence de la fen&ecirc;tre de sortie. Le d&eacute;veloppeur d&eacute;termine l'apparence de la fen&ecirc;tre des
formats de sortie WebHelp et FlashHelp, ou laisse ces aides s'ex&eacute;cuter dans votre fen&ecirc;tre de navigateur.
Cr&eacute;ez des dossiers dans le gestionnaire de projets pour organiser les rubriques et structurer le syst&egrave;me
d'aide.
Les projets sont des collections de fichiers. Le fichier de projet (fichier XPJ) contient des informations
concernant le contenu et les propri&eacute;t&eacute;s du projet. Chaque fois que vous modifiez le projet, ce fichier (et
tout autre fichier concern&eacute;) est mis &agrave; jour automatiquement. Les fichiers de projet sont constitu&eacute;s des
&eacute;l&eacute;ments suivants :
Contenu
Les fichiers de projet contiennent des rubriques avec le contenu et les informations concernant
l'emplacement des rubriques, des images, de l'index, de la table des mati&egrave;res et des autres fichiers.
Propri&eacute;t&eacute;s
Les projets contiennent des informations de configuration, telles que le titre, la langue et les
fen&ecirc;tres. Lorsque vous cr&eacute;ez un projet, les param&egrave;tres de base (par d&eacute;faut) sont utilis&eacute;s. Modifiez
ces param&egrave;tres en fonction de vos besoins de conception.
Navigation
Les projets comportent une table des mati&egrave;res, un index et une recherche de texte int&eacute;gral.
Vous pouvez voir les &eacute;l&eacute;ments qui constituent un projet &agrave; plusieurs endroits : le gestionnaire de
projets, le conteneur Mises en page source unique et la bo&icirc;te de dialogue Param&egrave;tres du projet.
Vous pouvez &eacute;galement g&eacute;n&eacute;rer diff&eacute;rents rapports (Outils &gt; Rapports) qui identifient l'&eacute;tat du
projet, les rubriques en double, les fichiers distribu&eacute;s avec l'aide, etc.
Composants du projet d'aide
Les syst&egrave;mes d'aide sont constitu&eacute;s de diff&eacute;rents composants qui varient selon le format de l'aide que
vous fournissez.
26
CHAPITRE 3
EL&Eacute;MENTS DE BASE DU PROJET
PROJETS
Projets
RoboHelp HTML cr&eacute;e un fichier de projet principal (avec l'extension .xpj) qui contient des
informations concernant vos rubriques, vos images et d'autres fichiers. (Ouvrez ce fichier pour
ouvrir un projet.) Les fichiers du projet contiennent &eacute;galement les param&egrave;tres qui affectent
l'apparence et les fonctions du syst&egrave;me d'aide.
Rubriques
L'unit&eacute; de base d'un syst&egrave;me d'aide est la rubrique. Les rubriques communiquent le message du
syst&egrave;me d'aide, principalement via du texte et des images. Vous d&eacute;cidez ensuite du contenu,
du format et de l'organisation de vos rubriques.
Table des mati&egrave;res
Si une table des mati&egrave;res est incluse, les utilisateurs voient un onglet ou un bouton Table des
mati&egrave;res &agrave; l'ouverture du syst&egrave;me d'aide. La table des mati&egrave;res pr&eacute;sente le plan hi&eacute;rarchique du
contenu du projet d'aide. Les utilisateurs peuvent rechercher et s&eacute;lectionner les rubriques qu'ils
souhaitent consulter dans l'onglet Table des mati&egrave;res.
Index
Si un index est inclus, les utilisateurs voient un onglet ou un bouton Index &agrave; l'ouverture du syst&egrave;me
d'aide. l'index affiche une liste multi-niveau de rubriques et de mots-cl&eacute;s ou expressions que vous
avez sp&eacute;cifi&eacute;s.
Recherche de texte int&eacute;gral
La recherche de texte int&eacute;gral permet aux utilisateurs de rechercher des termes ou des expressions
qui figurent dans le contenu.
Liens et navigation
La navigation des utilisateurs dans un syst&egrave;me d'aide s'effectue en cliquant sur des liens. C'est vous
qui d&eacute;terminez la strat&eacute;gie permettant de relier vos rubriques les unes aux autres. Les liens les plus
courants vont d'une rubrique &agrave; une autre. Les liens peuvent &eacute;galement pointer vers des rubriques
de diff&eacute;rents syst&egrave;mes d'aide, diff&eacute;rents formats de sortie, voire m&ecirc;me vers un site Web ou une
application.
Styles
Les styles permettent de d&eacute;finir le format des rubriques. Les styles sont des formats portant un nom
que vous concevez et appliquez pour contr&ocirc;ler la mise en page et l'aspect du texte.
Fichiers image et multim&eacute;dia
Les fichiers image et multim&eacute;dia enrichissent l'aide en y ajoutant des images, du son, de la vid&eacute;o,
des animations, etc.
27
CHAPITRE 3
EL&Eacute;MENTS DE BASE DU PROJET
PROJETS
Fen&ecirc;tres
Les fen&ecirc;tres sont les cadres dans lesquels s'affichent les rubriques. Dans certains formats de sortie,
vous pouvez personnaliser l'apparence et les attributs des fen&ecirc;tres. Vous pouvez &eacute;galement
concevoir de nouvelles fen&ecirc;tres qui s'adaptent &agrave; votre contenu. Vous pouvez ouvrir plusieurs
fen&ecirc;tres et dans la bo&icirc;te de dialogue Fen&ecirc;tres, s&eacute;lectionner une fen&ecirc;tre et cliquer sur Activer pour
la rendre active. Cliquez sur Enregistrer pour enregistrer la fen&ecirc;tre en cours d'affichage. A l'aide de
la fonction Windows, vous pouvez renommer le titre du projet pour l'afficher dans la sortie.
Compilateurs
Le compilateur de l'aide ne fait pas partie du fichier d'aide final, mais il est parfois n&eacute;cessaire pour
cr&eacute;er le fichier d'aide. Par exemple, dans les projets d'aide HTML de Microsoft, le compilateur
regroupe les fichiers source et les autres composants du projet. Le compilateur cr&eacute;e ensuite un
fichier du syst&egrave;me d'aide que vous pouvez distribuer aux utilisateurs finals. (Les projets WebHelp et
FlashHelp ne sont pas compil&eacute;s.)
Afficheurs et navigateurs
Les utilisateurs acc&egrave;dent au syst&egrave;me d'aide par un afficheur ou un navigateur.
Fichiers d'un projet
Fichier de projet principal (XPJ)
Le fichier du projet (.xpj) est bas&eacute; sur XML. Vous pouvez ouvrir des fichiers de projet avec l'extension .mpj,
qui correspond au format des versions ant&eacute;rieures de RoboHelp, mais ils sont convertis en fichiers XPJ.
Fichiers de dossiers (FPJ)
Chaque dossier de projet poss&egrave;de un fichier FPJ qui r&eacute;pertorie le contenu du dossier. RoboHelp affiche
uniquement les sous-dossiers et les rubriques qui figurent dans le fichier FPJ d'un dossier.
Tous les sous-dossiers poss&egrave;dent leurs fichiers FPJ respectifs. Le nom d'un fichier FPJ, &agrave; l'exception du
fichier FPJ du dossier du projet, est identique &agrave; celui de ce dossier.
Le nom du fichier FPJ du dossier du projet est root.fpj. Le fichier root.fpj est modifi&eacute; si vous ajoutez,
supprimez ou renommez une rubrique ou un sous-dossier &agrave; l'int&eacute;rieur du dossier respectif. Le fichier
root.fpj est &eacute;galement modifi&eacute; si l'ordre des rubriques ou des sous-dossiers est modifi&eacute; dans le
Gestionnaire de projets.
Fichiers de mise en page source unique (SSL)
Un fichier SSL (single-source layout) est utilis&eacute; pour chaque mise en page source unique. Un fichier SSL
stocke les propri&eacute;t&eacute;s de la mise en page source unique respective. En outre, il est modifi&eacute; lorsque vous
modifiez les propri&eacute;t&eacute;s. Un fichier SSL n'est pas modifi&eacute; lors de la cr&eacute;ation, de l'affichage ou de la
publication d'une mise en page source unique.
28
CHAPITRE 3
EL&Eacute;MENTS DE BASE DU PROJET
PROJETS
Fichiers de projet auxiliaires (APJ)
Les composants suivants poss&egrave;dent des fichiers APJ correspondants, qui sont modifi&eacute;s lorsque vous
modifiez les composants :
•
Fichiers bagage
•
Couleurs
•
Balises de construction conditionnelles
•
Jeux de polices
•
Types d'informations
•
Fichiers de mappage
•
Rubriques de remarques contextuelles
•
Voir aussi Mots-cl&eacute;s
•
Habillages (ajout ou suppression uniquement)
•
Mises en page source unique (lors de l'ajout ou la suppression de mises en page source unique
seulement)
•
Mots-cl&eacute;s de rubrique
•
Mod&egrave;les de rubriques (lors de l'ajout ou de la suppression de mises en page source unique
seulement)
•
Fen&ecirc;tres
Autres types de fichiers
Lorsque vous modifiez les composants suivants, le fichier correspondant est modifi&eacute; :
•
S&eacute;quences de navigation (BRS)
•
Rubriques (HTM)
•
Table des mati&egrave;res (HHC)
•
Index (HHK)
•
Glossaire (GLO)
•
Fichiers image et multim&eacute;dia (l'extension du nom de fichier varie)
•
Feuilles de style en cascade (CSS)
A propos des types de sortie
RoboHelp permet de g&eacute;n&eacute;rer les types de sortie suivants. Leurs caract&eacute;ristiques de base sont identiques,
mais leurs fonctionnalit&eacute;s et la configuration de plate-forme requise diff&egrave;rent.
WebHelp
Le format WebHelp d'Adobe fonctionne avec quasiment toutes les combinaisons de navigateur et
de plate-forme pour les applications Web et de bureau, les aides en ligne ainsi que les manuels en
ligne. WebHelp fournit &eacute;galement des volets de navigation personnalisables et permet des
t&eacute;l&eacute;chargements rapides.
29
CHAPITRE 3
EL&Eacute;MENTS DE BASE DU PROJET
PROJETS
WebHelp Pro
WebHelp Pro sert aux applications Web et poss&egrave;de des fonctionnalit&eacute;s disponibles uniquement
dans les syst&egrave;mes d'aide sur serveur. WebHelp Pro fournit des commentaires sur l'utilisation de
votre syst&egrave;me d'aide. Il permet aux diff&eacute;rents auteurs de travailler sur des projets distincts et de les
publier &agrave; tout moment. En outre, les projets sont fusionn&eacute;s sur le serveur au moment de
l'ex&eacute;cution. RoboHelp Server est requis pour la g&eacute;n&eacute;ration de projets WebHelp Pro.
FlashHelp
Le format FlashHelp&reg; utilise la technologie Adobe Flash&reg; pour fournir un volet de navigation
interactif, des commandes de navigation personnalisables, des animations Flash, des contenus
vid&eacute;o et audio en streaming, ainsi que des images. Flash Player requis.
FlashHelp Pro
FlashHelp Pro sert aux applications Web et poss&egrave;de des fonctionnalit&eacute;s disponibles uniquement
dans les syst&egrave;mes d'aide sur serveur. Il permet aux diff&eacute;rents auteurs de travailler sur des projets
distincts et de les publier &agrave; tout moment. En outre, les projets sont fusionn&eacute;s sur le serveur au
moment de l'ex&eacute;cution. RoboHelp Server est requis pour la g&eacute;n&eacute;ration de projets FlashHelp Pro.
Multi-&eacute;cran HTML5
La sortie Multi-&eacute;cran HTML5 vous permet d'offrir une exp&eacute;rience de lecture optimis&eacute;e pour des
types sp&eacute;cifiques de p&eacute;riph&eacute;riques. Vous pouvez ajouter et configurer diff&eacute;rents profils d'&eacute;cran
pour divers ensembles de p&eacute;riph&eacute;riques et g&eacute;n&eacute;rer une sortie multi-&eacute;cran HTML5 pour ces profils.
Lorsque les utilisateurs consultent la page de renvoi concernant la sortie multi-&eacute;cran HTML5 sur
leurs p&eacute;riph&eacute;riques, ils sont automatiquement redirig&eacute;s vers le contenu optimis&eacute; pour leur
p&eacute;riph&eacute;rique.
Responsive HTML5
A l'aide de Responsive HTML5, vous pouvez cr&eacute;er une sortie unique optimis&eacute;e pour tous vos &eacute;crans.
Responsive HTML5 s'adapte automatiquement &agrave; la taille de l'&eacute;cran de l'utilisateur et prend en
charge les changements de taille d'&eacute;cran dynamique (r&eacute;orientation ou redimensionnement du
navigateur, etc.).
Vous pouvez &eacute;galement publier la sortie Responsive HTML5 vers RoboHelp Server 10.
eBook
La mise en page eBook vous permet de g&eacute;n&eacute;rer une sortie dans les formats EPUB 3 et Kindle Book
(MOBI LINK).
30
CHAPITRE 3
EL&Eacute;MENTS DE BASE DU PROJET
PROJETS
Microsoft HTML Help
Microsoft HTML Help offre des fonctionnalit&eacute;s uniques aux projets d'aide d'application ou aux
syst&egrave;mes d'aide autonomes pour Windows 98 et versions ult&eacute;rieures et requiert Internet
Explorer 4.x ou sup&eacute;rieur.
REMARQUE : En raison des changements dans la s&eacute;curit&eacute; Microsoft, l'application Microsoft HTML
Help est maintenant utilis&eacute;e &agrave; l'emplacement d'ex&eacute;cution de l'aide sur l'ordinateur des utilisateurs ;
elle ne peut pas &ecirc;tre install&eacute;e sur un serveur sans changement dans le registre. Les programmes
WebHelp et FlashHelp sont utilis&eacute;s lorsque l'aide doit &ecirc;tre ex&eacute;cut&eacute;e depuis un serveur. WebHelp et
FlashHelp peuvent &ecirc;tre ex&eacute;cut&eacute;s localement, mais ce n'est pas recommand&eacute;.
XML
Le format de sortie XML exporte le contenu au format Extensible Markup Language (XML), utilis&eacute;
pour structurer, stocker et transmettre les informations. Les fichiers XML sont associ&eacute;s &agrave; des feuilles
de style ainsi qu'&agrave; des fichiers de gestionnaire. Les fichiers de gestionnaire d&eacute;terminent la fa&ccedil;on
dont RoboHelp importe ou g&eacute;n&egrave;re des fichiers XML, les feuilles de style associ&eacute;es et les composants
li&eacute;s.
JavaHelp
Le syst&egrave;me JavaHelp de Sun Microsystems™fonctionne avec les applications Java et constitue un
syst&egrave;me de livraison et non un outil de cr&eacute;ation d'aide. Les fonctions JavaHelp (tables des mati&egrave;res,
index, recherches, contr&ocirc;les, changements globaux, fen&ecirc;tres contextuelles) sont cr&eacute;&eacute;es
automatiquement, en m&ecirc;me temps que les fonctions HTML (liens, boutons Rubriques connexes et
fichiers image).
Oracle Help
Oracle Help pour Java™ s'utilise avec les applications quel que soit le langage de programmation.
Oracle Help et le navigateur ICE 5 fournissent des tables des mati&egrave;res, des index, des recherches de
texte int&eacute;gral, des fen&ecirc;tres et fonctions contextuelles, ainsi que des fen&ecirc;tres personnalisables,
accessibles &agrave; partir de l'afficheur Oracle Help.
Documentation imprim&eacute;e
La sortie de documentation imprim&eacute;e am&eacute;lior&eacute;e de RoboHelp offre un meilleur contr&ocirc;le de la
structure, du contenu et de l'aspect de vos documents imprim&eacute;s. Vous pouvez organiser le contenu
selon vos besoins, appliquer des mises en forme bas&eacute;es sur les styles de mod&egrave;les de Word ou CSS
et produire des documents Word ou des fichiers PDF format&eacute;s et structur&eacute;s.
Adobe AIR
Le type de sortie Adobe AIR vous permet de g&eacute;n&eacute;rer une aide au format Adobe AIR. G&eacute;n&eacute;rez votre
contenu dans le format d'aide Adobe AIR interplate-forme qui offre de nombreuses am&eacute;liorations,
notamment :
•
•
Une navigation facilit&eacute;e dans les chemins, etc
De nouveaux mod&egrave;les et de nouveaux habillages
31
EL&Eacute;MENTS DE BASE DU PROJET
PROJETS
CHAPITRE 3
•
•
•
•
•
Une exp&eacute;rience tr&egrave;s enrichissante et la possibilit&eacute; d'ins&eacute;rer des logos d'entreprise ainsi qu'une bo&icirc;te
de dialogue A propos de dans l'Aide
Des mises &agrave; jour automatiques et des commentaires riches
Aide depuis le navigateur dont le contenu est &agrave; la fois en ligne et hors ligne
Possibilit&eacute; d'ajouter des flux RSS et d'y acc&eacute;der
Une fonction de recherche am&eacute;lior&eacute;e
Exigences de l'afficheur de l'utilisateur final
Syst&egrave;me de
l'utilisateur
Responsive
HTML5
App
mobile
WebHelp/
Pro
Microsoft
HTML Help
EPUB
PDF
Windows&reg;
XP SP4 ou
version ult&eacute;rieure, Windows Vista,
Windows 7
Navigateur
Web
N/A
Navigateur
Web
Afficheur
int&eacute;gr&eacute;
Visionneuse
eBook
Afficheur de
fichiers PDF.
Exemple :
Adobe
Acrobat,
Adobe
Acrobat
Reader
Mac OS,
Linux&reg;
Navigateur
Web
N/A
Navigateur
Web
Non disponible
Visionneuse
eBook
Afficheur de
fichiers PDF.
Exemple :
Adobe
Acrobat,
Adobe
Acrobat
Reader
iOS, Android
(p&eacute;riph&eacute;riques)
Navigateur
Web
Application
mobile
native
N/A
N/A
Visionneuse
eBook
Afficheur de
fichiers PDF.
Exemple :
Adobe
Acrobat,
Adobe
Acrobat
Reader
32
CR&Eacute;ATION ET GESTION DES PROJETS
PROJETS
CHAPITRE 3
Syst&egrave;me de
l'utilisateur
Multi-&eacute;cran HTML5
JavaHelp*
Oracle Help
Aide AIR
Windows&reg; XP SP4 ou
version ult&eacute;rieure,
Windows Vista,
Windows 7
Navigateur Web
Afficheur
JavaHelp
Afficheur Oracle
Help
Ex&eacute;cution de
l'aide AIR
Mac OS, Linux&reg;
Navigateur Web
Afficheur
JavaHelp
Non disponible
Ex&eacute;cution de
l'aide AIR
iOS, Android (p&eacute;riph&eacute;riques)
Navigateur Web
N/A
N/A
N/A
3.2.
Cr&eacute;ation et gestion des projets
Cr&eacute;ation d'un projet
1)
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez Fichier &gt; Nouveau projet.
–
Dans le conteneur D&eacute;marrage, cliquez sur Plus sous Cr&eacute;er un nouveau.
2)
Dans le volet Nouveau de la bo&icirc;te de dialogue Nouveau projet, cliquez deux fois sur un type de
projet. Vous pouvez modifier le type du projet apr&egrave;s l'avoir cr&eacute;&eacute;.
Projet vide
Personnalisez et publiez un projet sur une sortie. Vous pouvez modifier les param&egrave;tres des fen&ecirc;tres
pour les sorties WebHelp, FlashHelp et HTML Help.
Fichier d'application
Cr&eacute;ez un syst&egrave;me d'aide &agrave; installer en local. Le projet d'aide d'application contient des exemples de
rubriques avec des notes sur la personnalisation et la modification des informations. Par exemple,
vous pouvez cr&eacute;er un syst&egrave;me d'aide pour documenter les informations d'un produit d'une
entreprise.
REMARQUE : Par d&eacute;faut, l'aide d'application n'utilise pas de pages principales ni d'extrait de code
mais vous pourrez toujours en ajouter.
Manuel &eacute;lectronique
Cr&eacute;ez un projet pour un manuel &eacute;lectronique, par exemple le manuel d'un employ&eacute; pour une
entreprise. Le mod&egrave;le de projet de manuel &eacute;lectronique fournit les rubriques et les dossiers
pertinents &agrave; renseigner &agrave; l'aide d'informations propres &agrave; l'entreprise.
33
CHAPITRE 3
CR&Eacute;ATION ET GESTION DES PROJETS
PROJETS
e-Learning
Int&eacute;grez et organisez des d&eacute;monstrations Captivate dans un projet. A l'aide de la mise en page et
des recommandations fournies, vous pouvez cr&eacute;er une formation bas&eacute;e sur l'ordinateur et sur le
Web.
Base de connaissances
Cr&eacute;ez une base de connaissances dont l'interface est similaire &agrave; une page wiki. Le mod&egrave;le de projet
de base de connaissances contient des pages principales &agrave; personnaliser. Vous pouvez &eacute;galement
cr&eacute;er des pages qui se mettent &agrave; jour automatiquement.
Aide d'application Web
Cr&eacute;ez un syst&egrave;me d'aide que vous pouvez publier sur un serveur. Le projet d'aide d'application Web
contient des exemples de rubriques avec des notes sur la cr&eacute;ation d'une aide en ligne pour une
application de logiciel.
Directives du service
Cr&eacute;ez un syst&egrave;me d'aide qui d&eacute;crive les directives &agrave; suivre par un service ou une entreprise. Par
exemple, vous pouvez cr&eacute;er une aide pour un service de ressources humaines, qui pr&eacute;sente les
directives concernant le recrutement et la s&eacute;lection, les horaires flexibles, etc.
Plan de reprise apr&egrave;s incident
Cr&eacute;ez un syst&egrave;me d'aide avec des exemples de r&eacute;daction d'un plan de reprise apr&egrave;s sinistre.
Manuel en ligne
Cr&eacute;ez un manuel en ligne concernant le produit ou l'application de logiciel d'une entreprise.
R&egrave;glements et proc&eacute;dures
Cr&eacute;ez un manuel ou un document r&eacute;pertoriant les r&egrave;glements et les proc&eacute;dures propres &agrave; une
organisation.
Personnalis&eacute;
Personnalisez un mod&egrave;le de projet d'aide.
3)
Sp&eacute;cifiez les options dans la bo&icirc;te de dialogue Assistant de cr&eacute;ation de nouveau projet :
–
RoboHelp stocke le titre du projet dans un champ appel&eacute; Titre du projet. Vous pouvez ins&eacute;rer
le champ dans la rubrique contenu, extraits de code, pages principales et mises en forme
d'&eacute;cran.
–
Conservez l'anglais ou s&eacute;lectionnez une autre langue pour localiser le projet. La correction
orthographique, l'indexation avec l'assistant d'index dynamique et des parties de l'interface
utilisateur sont localis&eacute;es.
–
Si vous s&eacute;lectionnez Enregistrer par d&eacute;faut, la langue s&eacute;lectionn&eacute;e est utilis&eacute;e pour tous les
nouveaux projets.
4)
Cliquez sur Terminer.
34
CHAPITRE 3
CR&Eacute;ATION ET GESTION DES PROJETS
PROJETS
La rubrique s'ouvre dans l'&eacute;diteur de conception (&agrave; droite). Le gestionnaire de projets s'ouvre sur la
gauche. La premi&egrave;re rubrique est s&eacute;lectionn&eacute;e dans le dossier Fichiers HTML (Rubriques).
Cr&eacute;ation d'un projet par importation de documents
1)
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Dans le conteneur D&eacute;marrage, s&eacute;lectionnez un nouveau type de projet dans la liste Importer.
–
S&eacute;lectionnez Fichier &gt; Nouveau projet. Cliquez sur l'onglet Importer et s&eacute;lectionnez un
nouveau type de projet.
2)
Suivez les invites. Le nouveau projet s'ouvre dans RoboHelp.
Cr&eacute;ation d'un projet &agrave; l'aide de documents FrameMaker ou Word
Vous pouvez de nouveaux projets en important des documents FrameMaker ou Word. Lors de
l'importation, vous pouvez mapper les styles de ces documents avec les styles de RoboHelp.
1) S&eacute;lectionnez Fichier &gt; Nouveau projet et cliquez sur Importer.
2) S&eacute;lectionnez des documents FrameMaker ou Word et cliquez sur OK.
3) Faites votre choix parmi les fichiers .book, .mif, .fm, .bk et .frm pour FrameMaker et .doc, .docx, .rtf
et .doc pour Word. Vous pouvez importer plusieurs documents FrameMaker ou Word
simultan&eacute;ment. Vous pouvez importer des fichiers .book et .bk un &agrave; la fois.
REMARQUE : Pour tous les formats FrameMaker &agrave; l'exception du format MIF, FrameMaker ou version
ult&eacute;rieure est requis. Si la version correcte n'est pas install&eacute;e, vous ne pouvez pas importer le fichier.
4) Saisissez le titre du projet, le nom de fichier et l'emplacement du projet.
5) Cliquez sur Terminer.
L'assistant de cr&eacute;ation de nouveau projet vous invite &agrave; s&eacute;lectionner les options permettant de
mapper la table des mati&egrave;res, l'index ou le glossaire.
6) S&eacute;lectionnez les options n&eacute;cessaires et cliquez sur Suivant.
7) Cliquez sur Modifier.
8) S&eacute;lectionnez des styles &agrave; mapper avec les styles de RoboHelp.
Pour plus d'informations sur les diff&eacute;rentes options de conversion des documents FrameMaker, voir
Concepts de base de la conversion.
Pour plus d'informations sur les diff&eacute;rentes options de conversion des documents Word, voir
Conversion de styles Word en styles RoboHelp.
9) Cliquez sur OK.
REMARQUE : Si vous cliquez sur Annuler dans l'assistant, aucun fichier n'est import&eacute; et le projet vide
reste ouvert.
10) Cliquez sur Terminer.
35
CHAPITRE 3
CR&Eacute;ATION ET GESTION DES PROJETS
PROJETS
Cr&eacute;ation d'un projet &agrave; l'aide d'un fichier de mappage DITA
IMPORTANT : R&eacute;serv&eacute; aux utilisateurs experts.
Avant d'importer un fichier de mappage DITA, Java JDK et DITA Open Toolkit doivent &ecirc;tre install&eacute;s et
fonctionner correctement. Une exp&eacute;rience de DITA et de DITA Open Toolkit est &eacute;galement requise.
1) S&eacute;lectionnez Fichier &gt; Nouveau projet.
2) Cliquez sur l'onglet Importer.
3) S&eacute;lectionnez Fichier de mappage DITA.
4) Cliquez sur OK.
5) Saisissez les informations suivantes dans l'assistant de cr&eacute;ation de nouveau projet :
Fichier de mappage DITA &agrave; importer
Indiquez le chemin vers un fichier de mappage DITA valide que vous souhaitez importer et cr&eacute;ez un
projet. Cliquez sur le bouton Parcourir pour s&eacute;lectionner le fichier.
Emplacement du projet
Indiquez le chemin d'acc&egrave;s &agrave; l'emplacement du nouveau projet.
6)
7)
8)
Cliquez sur Suivant.
Indiquez la saisie requise dans la bo&icirc;te de dialogue Options de traitement de DITA Open Toolkit.
Cliquez sur Terminer.
LIENS CONNEXES :
Conversion de styles Word en styles RoboHelp
Ajout d'un projet RoboHelp au contr&ocirc;le de version
Enregistrement de projets
Enregistrez vos projets &agrave; intervalles fr&eacute;quents.
•
Pour enregistrer des fichiers individuels, cliquez sur Enregistrer dans la barre d'outils Acc&egrave;s rapide.
•
Pour enregistrer tous les fichiers, cliquez sur Enregistrer dans la barre d'outils Acc&egrave;s rapide.
D&eacute;sactivation de l'enregistrement automatique
Par d&eacute;faut, RoboHelp enregistre les modifications &agrave; la fermeture du projet. Si vous pr&eacute;f&eacute;rez, vous pouvez
d&eacute;sactiver la fonction d'enregistrement automatique.
1) Dans le menu Outils, s&eacute;lectionnez Options.
2) Cliquez sur l'onglet G&eacute;n&eacute;ralit&eacute;s.
3) Sous Options, d&eacute;s&eacute;lectionnez Enregistrer sans invite.
36
CHAPITRE 3
CR&Eacute;ATION ET GESTION DES PROJETS
PROJETS
Ouverture d'un projet
Ouverture d'un projet lors du d&eacute;marrage de RoboHelp
1)
Dans le conteneur D&eacute;marrage r&eacute;pertoriant les projets ouverts, cliquez sur le nom du projet. Si vous
ne voyez pas le projet d&eacute;sir&eacute;, cliquez sur Ouvrir.
Vous pouvez utiliser les contr&ocirc;les suivants pour localiser le projet &agrave; ouvrir :
Barre Mes emplacements
Recherchez des documents en utilisant les raccourcis &agrave; gauche de la liste Dossier et Fichiers.
Bureau
Le dossier Bureau r&eacute;pertorie tous les dossiers et fichiers pr&eacute;sents sur le bureau.
Poste de travail
Le dossier Poste de travail r&eacute;pertorie tous les lecteurs de l'ordinateur.
Mes projets RoboHelp
Le dossier Mes projets RoboHelp constitue le dossier de travail par d&eacute;faut. Il contient tous les
projets RoboHelp. Ce dossier est enregistr&eacute; dans le dossier Mes documents lors de l'installation
d'Adobe RoboHelp. Au d&eacute;marrage d'Adobe RoboHelp, les projets stock&eacute;s dans le dossier Mes
projets RoboHelp sont automatiquement r&eacute;pertori&eacute;s dans le conteneur D&eacute;marrage, sous Projets
r&eacute;cents. Tous les projets RoboHelp utilisent l'extension de nom de fichier .xpj.
Liste Rechercher dans
Par d&eacute;faut, cette liste contient le dossier Mes projets RoboHelp. Si vous avez acc&eacute;d&eacute; &agrave; d'autres
dossiers, le dernier dossier ouvert s'affiche dans cette zone. La liste inclut les dossiers Poste de
travail, Favoris r&eacute;seau et Mes documents sous le dossier Bureau.
Ic&ocirc;ne Acc&eacute;der au dernier dossier ouvert
Affiche le dernier dossier auquel vous avez acc&eacute;d&eacute;. Cliquez sur le triangle pour afficher une liste des
derniers dossiers ouverts. Si vous n'avez pas acc&eacute;d&eacute; &agrave; d'autres dossiers dans cette bo&icirc;te de dialogue,
cette ic&ocirc;ne est d&eacute;sactiv&eacute;e.
Ic&ocirc;ne Monter d'un niveau
Permet d'acc&eacute;der au dossier parent du dossier affich&eacute; dans la liste Rechercher dans.
Ic&ocirc;ne Supprimer
Supprime le dossier ou le fichier s&eacute;lectionn&eacute;. Le dossier ou fichier supprim&eacute; est envoy&eacute; &agrave; la
Corbeille.
Ic&ocirc;ne Cr&eacute;er un dossier
Permet de cr&eacute;er un dossier dans le dossier parent affich&eacute; dans la liste Rechercher dans.
37
CHAPITRE 3
CR&Eacute;ATION ET GESTION DES PROJETS
PROJETS
Ic&ocirc;ne du menu Affichage
Cliquez sur le triangle pour choisir le type d'affichage des dossiers et fichiers. Vous pouvez choisir
parmi Vignettes, Mosa&iuml;ques, Ic&ocirc;nes, Liste, D&eacute;tails.
Ic&ocirc;ne d'outils
Permet de supprimer ou de renommer un dossier ou un fichier, d'ajouter un dossier ou un fichier &agrave;
la barre Mes emplacements, ou de mapper un disque dur avec un ordinateur ou un dossier sur votre
r&eacute;seau. Vous pouvez &eacute;galement afficher les propri&eacute;t&eacute;s d'un dossier ou d'un fichier.
Zone Nom du fichier Permet de sp&eacute;cifier le nom du fichier auquel vous souhaitez acc&eacute;der
(ouverture, importation, etc.)
Menu Fichiers de type
Type de fichier &agrave; r&eacute;pertorier dans la liste des dossiers et fichiers.
Ouverture d'un projet apr&egrave;s le d&eacute;marrage de RoboHelp
1)
2)
3)
S&eacute;lectionnez Fichier &gt; Ouvrir le projet &gt; Chemin local ou r&eacute;seau.
La bo&icirc;te de dialogue Ouvrir un projet s'affiche.
REMARQUE : Vous pouvez &eacute;galement s&eacute;lectionner les dix derniers projets ouverts &agrave; partir de la partie
inf&eacute;rieure du menu Fichier.
Dans le menu Fichiers de type, s&eacute;lectionnez Projet RoboHelp HTML Help (.xpj).
Recherchez le fichier du projet et cliquez deux fois dessus.
Mise &agrave; niveau d'un projet
Si vous ouvrez un projet cr&eacute;&eacute; dans une version pr&eacute;c&eacute;dente de RoboHelp, vous &ecirc;tes invit&eacute; &agrave; indiquer s'il
doit &ecirc;tre converti au pr&eacute;alable.
IMPORTANT : Cr&eacute;ez une copie de votre projet avant de le convertir dans un nouveau format.
LIENS CONNEXES :
Recherche de sortie RoboHelp
Verrouillage d'un projet sur la liste des derniers projets ouverts
Par d&eacute;faut, la liste des projets r&eacute;cents figurant dans le conteneur D&eacute;marrer et dans le menu Fichier affiche
jusqu'aux dix derniers projets. Verrouillez un projet r&eacute;cemment ouvert pour qu'il s'affiche toujours dans
la liste des projets r&eacute;cents. La liste affiche les projets verrouill&eacute;s et les projets r&eacute;cemment utilis&eacute;s jusqu'au
nombre de projets d&eacute;fini dans le champ Nombre max de projets.
1) S&eacute;lectionnez Fichier &gt; Options.
2) Dans l'onglet Projets r&eacute;cents, s&eacute;lectionnez un projet dans la liste Projets r&eacute;cemment ouverts.
3) Cliquez sur Verrouiller. Cliquez sur OK.
REMARQUE : Cliquez sur D&eacute;verrouiller pour supprimer un projet verrouill&eacute; de la liste des projets
r&eacute;cents.
38
CR&Eacute;ATION ET GESTION DES PROJETS
PROJETS
CHAPITRE 3
Modification des param&egrave;tres du projet
1)
2)
S&eacute;lectionnez Projet &gt; Fichier &gt; Param&egrave;tres du projet.
Dans l'onglet G&eacute;n&eacute;ral, modifiez les param&egrave;tres selon vos besoins :
Titre du projet
Saisissez un titre de projet. Ce titre appara&icirc;t dans la barre de la fen&ecirc;tre de la sortie.
Sortie principale/Mise en page
S&eacute;lectionnez une mise en page principale.
Langue
S&eacute;lectionnez la langue par d&eacute;faut du projet.
Avanc&eacute;
Cliquez pour cr&eacute;er ou modifier des listes pour la localisation. D&eacute;finissez les options dans chaque
volet.
Liste d'actions &agrave; faire
Cliquez sur G&eacute;rer pour g&eacute;rer la liste d'actions &agrave; faire de votre projet. Pour plus d'informations, voir
Utilisation de la liste d'actions &agrave; faire.
Index
S&eacute;lectionnez une option pour l'enregistrement des mots-cl&eacute;s :
–
–
–
Fichier d'index (HHK) : permet d'enregistrer les mots-cl&eacute;s d'index dans le fichier d'index du
projet (HHK).
Rubriques : permet d'enregistrer de nouveaux mots-cl&eacute;s d'index dans des fichiers de rubrique
individuels (HTM).
Index binaire : utilise un index binaire dans les projets d'aide Microsoft HTML.
D&eacute;finition des options dans le volet Liste d'exclusion
l'onglet Liste d'exclusion permet de modifier les mots contenus dans le fichier de liste d'exclusion
NomProjet.stp. Une liste d'exclusion contient les mots courants (par exemple : &laquo; un &raquo; ou &laquo; le &raquo;) ignor&eacute;s
lors des recherches dans le but d'am&eacute;liorer la pr&eacute;cision des r&eacute;sultats.
Modifier
S&eacute;lectionnez un mot, puis cliquez sur Modifier. Tapez le nouveau nom. Appuyez sur Entr&eacute;e. Cliquez
avec le bouton droit de la souris sur le mot pour afficher les options Annuler, Couper, Copier, Coller,
Supprimer et S&eacute;lectionner tout.
R&eacute;initialiser &agrave; la valeur par d&eacute;faut
Supprime les nouvelles entr&eacute;es et restaure la liste par d&eacute;faut.
39
CHAPITRE 3
CR&Eacute;ATION ET GESTION DES PROJETS
PROJETS
Nouveau
Ajoute un mot. Cliquez sur Nouveau. Saisissez le nouveau mot. Appuyez sur Entr&eacute;e.
Supprimer
Supprime un mot s&eacute;lectionn&eacute;.
REMARQUE : Dans les projets d'aide Microsoft HTML, le fichier de liste d'exclusion ne peut pas exc&eacute;der
512 Ko. S'il est de taille plus importante, les mots figurant &agrave; la fin de ce fichier ne sont pas inclus dans le
fichier CHM.
D&eacute;finition des options dans le volet Expressions
Modifiez des mots dans le fichier Expressions NomProjet.phr. Cet onglet contient une liste d'expressions
que l'assistant d'index dynamique inclut dans ses recherches de mots-cl&eacute;s. Par exemple, vous pouvez
faire de param&egrave;tres du projet une seule expression et non trois mots. Vous pouvez ajouter, modifier ou
supprimer des mots.
Modifier
S&eacute;lectionnez un mot, puis cliquez sur Modifier. Tapez le nouveau nom. Appuyez sur Entr&eacute;e. Cliquez
avec le bouton droit de la souris sur le mot pour afficher les options Annuler, Couper, Copier, Coller,
Supprimer et S&eacute;lectionner tout.
R&eacute;initialiser &agrave; la valeur par d&eacute;faut
Supprime les nouvelles entr&eacute;es et restaure la liste par d&eacute;faut.
Nouveau
Cliquez sur Nouveau. Saisissez le nouveau mot. Appuyez sur Entr&eacute;e.
D&eacute;finition des options dans le volet des termes &agrave; &laquo; Ignorer toujours &raquo;
Modifiez les mots dans le fichier Toujours ignorer les mots NomProjet.ign. Cette liste contient des mots
&laquo; non significatifs &raquo; tels que &laquo; en &raquo;, &laquo; le &raquo; ou &laquo; un &raquo;. L'assistant d'index dynamique utilise cette liste pour
laisser les mots non significatifs hors de l'index.
Modifier
S&eacute;lectionnez un mot, puis cliquez sur Modifier. Tapez le nouveau nom. Appuyez sur Entr&eacute;e. Cliquez
avec le bouton droit de la souris sur le mot pour afficher les options Annuler, Couper, Copier, Coller,
Supprimer et S&eacute;lectionner tout.
R&eacute;initialiser &agrave; la valeur par d&eacute;faut
Supprime les nouvelles entr&eacute;es et restaure la liste par d&eacute;faut.
Nouveau
Cliquez sur Nouveau. Saisissez le nouveau mot. Appuyez sur Entr&eacute;e.
40
CHAPITRE 3
CR&Eacute;ATION ET GESTION DES PROJETS
PROJETS
D&eacute;finition des options dans le volet Fichier LNG
Changez les &eacute;l&eacute;ments de texte de l'interface utilisateur pour les projets Multi-&eacute;cran HTML5, WebHelp,
WebHelp Pro, FlashHelp, FlashHelp Pro, AIR Help, la documentation imprim&eacute;e ou HTML Help.
Consultez la liste compl&egrave;te des modifications que vous pouvez apporter dans l'onglet Fichier LNG.
Lorsque vous modifiez le fichier LNG, vos modifications remplacent les param&egrave;tres d&eacute;finis dans
Param&egrave;tres du projet dans d'autres emplacements.
1) S&eacute;lectionnez un &eacute;l&eacute;ment et cliquez sur l'une des options suivantes :
Modifier
Modifiez le texte du fichier LNG pour chaque &eacute;l&eacute;ment de l'interface list&eacute;. En mode d'&eacute;dition, vous
pouvez &eacute;galement cliquer avec le bouton droit de la souris sur la ligne de texte modifi&eacute; pour
annuler, couper, copier, coller, supprimer ou s&eacute;lectionner tout.
REMARQUE : Vous pouvez changer la cha&icirc;ne &agrave; afficher pour d&eacute;velopper ou r&eacute;duire des tables des
mati&egrave;res de rubriques dans les param&egrave;tres des pages principales. Pour plus d'informations, voir
Pages principales.
R&eacute;initialiser &agrave; la valeur par d&eacute;faut
Efface les nouvelles entr&eacute;es et restaure la liste par d&eacute;faut.
REMARQUE : Pour acc&eacute;der rapidement &agrave; ces options, vous pouvez s&eacute;lectionner Edition &gt; Fichier LNG.
D&eacute;finition des options dans le volet Synonymes
D&eacute;finissez des mots comme des synonymes. Par exemple, vous pouvez d&eacute;finir &laquo; trouver &raquo; et &laquo; rep&eacute;rer &raquo;
comme des synonymes de &laquo; rechercher &raquo;. Ainsi, dans le r&eacute;sultat g&eacute;n&eacute;r&eacute;, lorsqu'un utilisateur recherche
le mot &laquo; rechercher &raquo;, les rubriques contenant les mots &laquo; trouver &raquo; et &laquo; rep&eacute;rer &raquo; s'affichent &eacute;galement.
R&eacute;initialiser &agrave; la valeur par d&eacute;faut
Supprime les nouvelles entr&eacute;es et restaure la liste par d&eacute;faut.
Modifier
S&eacute;lectionnez un mot, puis cliquez sur Modifier. Tapez le nouveau nom. Appuyez sur Entr&eacute;e. Cliquez
avec le bouton droit de la souris sur le mot pour afficher les options Annuler, Couper, Copier, Coller,
Supprimer et S&eacute;lectionner tout.
Nouveau
Cliquez sur Nouveau pour ajouter un synonyme du mot.
41
CHAPITRE 3
CR&Eacute;ATION ET GESTION DES PROJETS
PROJETS
Supprimer
Cliquez sur Supprimer pour supprimer le mot et ses synonymes.
LIENS CONNEXES :
Mise &agrave; niveau de projets localis&eacute;s
Affichage de la sortie
Modification du nom d'un projet
Lorsque vous modifiez le nom d'un projet, le fichier principal du projet (.xpj) et les autres fichiers du projet
sont &eacute;galement renomm&eacute;s.
REMARQUE : Les fichiers de la table des mati&egrave;res, de l'index et du glossaire ne sont pas renomm&eacute;s.
Lorsque vous modifiez le nom d'un projet, il se ferme puis s'ouvre &agrave; nouveau. Toutes les modifications
effectu&eacute;es depuis le dernier enregistrement sont enregistr&eacute;es.
REMARQUE : Vous ne pouvez pas renommer les projets sous contr&ocirc;le de version.
1)
2)
3)
4)
Ouvrez le projet.
S&eacute;lectionnez Fichier &gt; Renommer le projet.
Dans la zone Nom du projet, saisissez le nouveau nom du projet. (Ne saisissez pas d'extension de
nom de fichier.)
Cliquez sur OK. Pour que les modifications soient appliqu&eacute;es, le programme ferme puis rouvre le
projet.
REMARQUE : Si vous cr&eacute;ez une aide Microsoft HTML, le nom du fichier d'aide HTML compil&eacute; (fichier CHM)
est bas&eacute; sur le nom de fichier du projet. Si vous modifiez le nom du projet, le nom du fichier CHM est
&eacute;galement modifi&eacute;. Vous pouvez renommer le fichier CHM et restaurer le nom pr&eacute;c&eacute;dent.
Affichage de projets
Les syst&egrave;mes d'aide s'affichent dans un navigateur ou dans un afficheur, en fonction du type de sortie, de
la plate-forme de l'application et des plates-formes de vos utilisateurs finals. Les syst&egrave;mes d'aide
s'affichent dans une fen&ecirc;tre principale. Les rubriques figurent dans le volet de droite, tandis que les
onglets, boutons et rubans du volet de gauche et de la partie sup&eacute;rieure de la fen&ecirc;tre permettent la
navigation.
Affichez fr&eacute;quemment votre projet pour tester les liens et vous assurer que les styles sont correctement
appliqu&eacute;s. Affichez chaque source unique dans l'afficheur appropri&eacute; au type de sortie sp&eacute;cifi&eacute;.
LIENS CONNEXES :
Cr&eacute;ation de tables des mati&egrave;res
42
CHAPITRE 3
CR&Eacute;ATION ET GESTION DES PROJETS
PROJETS
D&eacute;finir la mise en page des chapitres
Vous pouvez d&eacute;finir une mise en page de chapitre pour un projet afin d'organiser logiquement les
rubriques et les dossiers dans le conteneur Gestionnaire de projets. RoboHelp utilise cette mise en page
de chapitre pour cr&eacute;er automatiquement une table des mati&egrave;res.
Remarques
•
•
•
•
•
•
Si vous renommez un dossier ou une rubrique, les rubriques et les dossiers conservent leur ordre.
Si vous supprimez un dossier ou une rubrique, les rubriques restantes conservent leur ordre.
Si vous ajoutez une nouvelle rubrique ou un nouveau dossier, cet &eacute;l&eacute;ment est ajout&eacute; dans la partie
sup&eacute;rieure, &agrave; l'int&eacute;rieur du dossier parent.
Si vous d&eacute;posez une rubrique ou un dossier sur un &eacute;l&eacute;ment qui n'est ni une rubrique ni un dossier
(CSS, image ou fichier bagage par exemple), l'objet d&eacute;pos&eacute; est plac&eacute; en derni&egrave;re position &agrave;
l'int&eacute;rieur du dossier parent de la cible.
Lorsque vous mettez &agrave; niveau un projet d'une version pr&eacute;c&eacute;dente de RoboHelp, toutes les rubriques
apparaissent de fa&ccedil;on al&eacute;atoire. Par la suite, vous pouvez personnaliser l'ordre des rubriques.
Vous pouvez cliquer avec le bouton droit de la souris sur un dossier ou une rubrique dans le
conteneur Gestionnaire de projets et s&eacute;lectionnez Explorer pour ouvrir le dossier ou la rubrique
dans l'Explorateur Windows.
D&eacute;placement des dossiers
•
Faites glisser une rubrique ou un dossier au-dessus ou au-dessous d'une autre rubrique ou d'un
autre dossier. Vous ne pouvez faire glisser ces &eacute;l&eacute;ments qu'au-dessus des documents li&eacute;s.
LIENS CONNEXES :
Verrouillage d'un projet sur la liste des derniers projets ouverts
G&eacute;rer des fichiers
Affichage des rubriques par titre ou par nom de fichier
1)
2)
Dans le conteneur Gestionnaire de projets, ouvrez le dossier Fichiers de projet.
S&eacute;lectionnez Projet &gt; Afficher &gt; Afficher les rubriques &gt; Par titre de rubrique ou Par nom de fichier.
Utilisation de la liste d'actions &agrave; faire
La liste des actions &agrave; faire vous permet de suivre les t&acirc;ches d'un projet. Vous pouvez personnaliser cette
liste en y ajoutant des actions &agrave; faire, en en supprimant ou en en modifiant.
REMARQUE : Les param&egrave;tres des actions &agrave; faire sont conserv&eacute;s lorsque vous mettez &agrave; niveau un projet d'une
version pr&eacute;c&eacute;dente de RoboHelp vers une nouvelle version.
Vous pouvez g&eacute;n&eacute;rer un rapport sur la liste d'actions &agrave; faire personnalis&eacute;e.
43
CHAPITRE 3
CR&Eacute;ATION ET GESTION DES PROJETS
PROJETS
Modification d'&eacute;l&eacute;ments sur la liste des actions &agrave; faire
1)
2)
3)
4)
S&eacute;lectionnez Projet &gt; Fichier &gt; Param&egrave;tres du projet.
Cliquez sur l'onglet G&eacute;n&eacute;ralit&eacute;s.
Cliquez sur G&eacute;rer.
Effectuez l'une des op&eacute;rations suivantes :
–
Pour ajouter une t&acirc;che &agrave; la liste, cliquez sur Ajouter. Saisissez le nom de l'&eacute;l&eacute;ment de la t&acirc;che.
–
Pour modifier ou supprimer une t&acirc;che, s&eacute;lectionnez une t&acirc;che puis cliquez sur Modifier ou
Supprimer.
REMARQUE : Dans la bo&icirc;te de dialogue Param&egrave;tres du projet, l'&eacute;l&eacute;ment Index dynamique ex&eacute;cut&eacute; de la liste
d'actions &agrave; faire par d&eacute;faut est invisible. Cette pr&eacute;caution vous assure de ne pas le supprimer par erreur.
Par d&eacute;faut, RoboHelp d&eacute;finit l'option Index dynamique ex&eacute;cut&eacute; pour toutes les rubriques sur lesquelles
vous ex&eacute;cutez l'assistant d'index dynamique.
Mise &agrave; jour de la liste des actions &agrave; faire d'une rubrique
1)
2)
Cliquez avec le bouton droit de la souris sur une rubrique du conteneur Gestionnaire de projets, puis
s&eacute;lectionnez Propri&eacute;t&eacute;s. Cliquez sur l'onglet Etat.
S&eacute;lectionnez ou d&eacute;s&eacute;lectionnez des &eacute;l&eacute;ments de la liste des actions &agrave; faire.
G&eacute;n&eacute;ration d'un rapport d'&eacute;tat
Vous pouvez g&eacute;n&eacute;rer un rapport Etat du projet pour afficher le nombre de rubriques utilisant la liste
d'actions &agrave; faire.
1) S&eacute;lectionnez Outils &gt; Rapports &gt; Etat du projet.
Modification de la liste des derniers projets ouverts
Les projets r&eacute;cemment ouverts sont r&eacute;pertori&eacute;s dans le conteneur D&eacute;marrage de RoboHelp.
1) S&eacute;lectionnez Fichier &gt; Options.
2) Cliquez sur l'onglet Projets r&eacute;cents.
–
Pour modifier le nombre de fichiers r&eacute;pertori&eacute;s, entrez un chiffre dans la zone Projets Max.
–
Pour supprimer un fichier de la liste, s&eacute;lectionnez-le, puis cliquez sur Supprimer.
LIENS CONNEXES :
Rapport sur les liens rompus
44
CHAPITRE 3
CR&Eacute;ATION ET GESTION DES PROJETS
PROJETS
Ajout de fichiers et de dossiers au dossier Fichiers bagage
Il arrive parfois que RoboHelp n'ajoute pas automatiquement les r&eacute;f&eacute;rences aux &eacute;l&eacute;ments externes au
dossier Fichiers bagage. Si n&eacute;cessaire, ajoutez des fichiers au dossier Fichiers bagage afin que les
&eacute;l&eacute;ments externes apparaissent correctement dans la sortie. Gagnez du temps en important le dossier
complet vers les fichiers bagage sans avoir &agrave; ajouter des fichiers individuellement. Cela ajoute non
seulement tout le contenu du dossier s&eacute;lectionn&eacute;, mais conserve &eacute;galement la m&ecirc;me structure de
dossier dans le projet. Suivez les &eacute;tapes ci-dessous pour ajouter le fichier ou le dossier Fichiers bagage au
projet :
1) S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Gestionnaire de projets.
La liste d&eacute;roulante des conteneurs est &eacute;galement disponible dans les rubans Edition et R&eacute;vision.
2) Cliquez avec le bouton droit de la souris sur Fichiers de projet, s&eacute;lectionnez l'option Importer
bagage, puis s&eacute;lectionnez Fichier ou Dossier.
REMARQUE : Vous pouvez &eacute;galement acc&eacute;der &agrave; cette option en cliquant avec le bouton droit de la souris
sur le dossier Fichiers bagage &gt; Nouveau, puis s&eacute;lectionnez Fichier ou Dossier. si le dossier Fichiers
bagage ne s'affiche pas, cliquez sur le bouton Basculer l'affichage du gestionnaire de projets .
3) Pour ajouter un fichier, cliquez deux fois sur le fichier source pour :
–
les images bitmap et les ic&ocirc;nes utilis&eacute;es pour les commandes HTML Help ;
–
les fichiers image utilis&eacute;s dans les feuilles de style, les arri&egrave;re-plans de rubrique et les scripts ;
–
le fichier JavaScript prenant en charge les effets HTML dynamiques (par exemple, les fen&ecirc;tres
contextuelles et les zones cliquables d&eacute;roulantes).
4)
5)
Pour ajouter un dossier, recherchez et s&eacute;lectionnez le dossier contenant les fichiers bagage.
Cliquez sur Ouvrir.
REMARQUE : Vous pouvez cr&eacute;er un lien vers un fichier bagage en appuyant sur la touche MAJ tout en
le glissant-d&eacute;posant dans une rubrique.
Fonctionnalit&eacute;s suppl&eacute;mentaires avec le dossier Fichiers bagage
La fonctionnalit&eacute; Fichiers bagage permet d'effectuer les t&acirc;ches suppl&eacute;mentaires suivantes :
1) Faire glisser et d&eacute;poser le contenu d'un emplacement vers un autre pour organiser le contenu dans
les dossiers Fichiers bagage.
2) Supprimer les fichiers superflus.
3) Renommer les fichiers et les dossiers.
4) Cr&eacute;er un lien vers un fichier bagage en appuyant sur la touche MAJ tout en le glissant-d&eacute;posant dans
une rubrique.
5) Ins&eacute;rer une image &agrave; partir des Fichiers bagage en la faisant glisser et en la d&eacute;posant dans la rubrique
que vous travaillez.
Suppression des fichiers du dossier Fichiers bagage
Pour supprimer un fichier du dossier Fichiers bagage, s&eacute;lectionnez le fichier et cliquez sur Supprimer.
45
CHAPITRE 3
CR&Eacute;ATION ET GESTION DES PROJETS
PROJETS
Types de fichiers de mappage
Types de fichier de mappage &agrave; associer avec les applications utilis&eacute;es pour leur modification.
Association d'une extension de fichier avec une application
1)
2)
3)
4)
5)
6)
S&eacute;lectionnez Fichier &gt; Options.
Cliquez sur l'onglet Association de fichiers.
Pour des programmes associ&eacute;s, cliquez sur Ajouter.
Saisissez une extension de nom de fichier.
S&eacute;lectionnez un &eacute;diteur pour modifier les documents poss&eacute;dant l'extension de nom de fichier
sp&eacute;cifi&eacute;.
Lorsque vous s&eacute;lectionnez un programme, son emplacement appara&icirc;t dans la case Modifier avec.
Les programmes s'affichent dans l'ordre alphab&eacute;tique.
REMARQUE : Seuls les programmes dont l'entr&eacute;e de registre est d&eacute;finie sur &laquo; NoOpenWith &raquo;
apparaissent dans la liste.
S&eacute;lectionnez un programme pour afficher le fichier.
Vous pouvez &eacute;galement acc&eacute;der &agrave; un fichier non r&eacute;pertori&eacute; dans la liste des programmes.
Ajout d'un &eacute;diteur de mappage HTML
1)
2)
3)
4)
5)
S&eacute;lectionnez Fichier &gt; Options.
Cliquez sur l'onglet Association de fichiers.
Pour les &eacute;diteurs HTML, cliquez sur Ajouter.
Choisissez parmi les programmes recommand&eacute;s ou d'autres programmes enregistr&eacute;s pour modifier
ou afficher des fichiers .html ou .htm.
REMARQUE : Lorsque vous s&eacute;lectionnez un programme, son nom et son emplacement apparaissent
dans les zones de texte Nom et Emplacement. Vous pouvez &eacute;galement rechercher un programme qui
n'appara&icirc;t pas dans la liste des programmes.
Cliquez sur OK. Le programme s&eacute;lectionn&eacute; appara&icirc;t dans la liste des &eacute;diteurs HTML.
REMARQUE : Pour modifier l'&eacute;diteur HTML, recherchez et s&eacute;lectionnez un nouveau programme.
Suppression de rubriques de projets
Avant de supprimer des fichiers, sauvegardez tous les fichiers du projet et affichez et imprimez les
rapports si votre projet n'est pas sous contr&ocirc;le de version. Pour &eacute;viter les liens rompus, ne supprimez pas
de fichiers dans l'Explorateur Windows ou dans un logiciel de contr&ocirc;le de version.
1) S&eacute;lectionnez un ou plusieurs fichiers :
–
Pour supprimer une rubrique, utilisez le conteneur Gestionnaire de projets.
–
Pour supprimer plusieurs rubriques, utilisez le conteneur Liste des rubriques.
2)
Appuyez sur la touche Suppr. Si le syst&egrave;me vous y invite, ne supprimez PAS les r&eacute;f&eacute;rences aux
rubriques supprim&eacute;es.
46
CHAPITRE 3
CR&Eacute;ATION ET GESTION DES PROJETS
PROJETS
REMARQUE : Vous pouvez choisir de supprimer les r&eacute;f&eacute;rences, mais, dans ce cas, vous ne pouvez pas
voir l'effet de la suppression dans les autres rubriques. Le fait de NE PAS supprimer les r&eacute;f&eacute;rences
force l'affichage des liens dans Liens rompus. Vous pouvez alors examiner chaque rubrique pour voir
si des modifications sont n&eacute;cessaires.
LIENS CONNEXES :
Rapport sur les fichiers inutilis&eacute;s
D&eacute;finir la mise en page des chapitres
Gestion des dossiers
Cr&eacute;ation de dossiers
Le gestionnaire de projets contient des dossiers par d&eacute;faut pour l'organisation des projets. Vous pouvez
cr&eacute;er des dossiers et des sous-dossiers uniquement dans les dossiers suivants : fichiers HTML (Rubriques),
Images, Multim&eacute;dia, Feuilles de style et Fichiers bagage.
REMARQUE : N'utilisez pas l'Explorateur Windows pour cr&eacute;er des sous-dossiers ou pour ajouter, d&eacute;placer
ou renommer des fichiers car ces modifications ne sont pas prises en compte par RoboHelp.
1) Dans le conteneur Gestionnaire de projets, s&eacute;lectionnez le dossier Fichiers de projet.
REMARQUE : Si le dossier Fichiers de projet ne s'affiche pas, cliquez sur le bouton Basculer l'affichage
du gestionnaire de projets .
2) Cliquez sur le dossier avec le bouton droit de la souris et s&eacute;lectionnez Nouveau &gt;Dossier.
3) Saisissez le nom du fichier. Evitez les caract&egrave;res sp&eacute;ciaux et les espaces.
4) Appuyez sur Entr&eacute;e.
Conseils :
•
•
Faites glisser les fichiers et les dossiers pour les d&eacute;placer dans le gestionnaire de projets.
Vous pouvez faire glisser des &eacute;l&eacute;ments de la liste des rubriques et les d&eacute;poser dans plusieurs
dossiers du Gestionnaire de projets.
Dossiers du gestionnaire de projets
Dans le gestionnaire de projets, vous pouvez modifier, supprimer ou cr&eacute;er des fichiers de projet. Deux
vues sont disponibles dans le gestionnaire de projets. Les deux vues comportent un ensemble des options
utilis&eacute;es r&eacute;guli&egrave;rement pour la cr&eacute;ation. L'une des vues affiche tous les fichiers de projet r&eacute;unis dans un
m&ecirc;me dossier intitul&eacute; Fichiers de projet ; l'autre vue regroupe les fichiers de projet dans diff&eacute;rents
dossiers virtuels en fonction du type de fichier. Cliquez sur le bouton Basculer l'affichage du gestionnaire
de projets ou pour changer de vue.
47
CHAPITRE 3
CR&Eacute;ATION ET GESTION DES PROJETS
PROJETS
La vue Gestionnaire de projets qui affiche les fichiers de projet dans diff&eacute;rents dossiers virtuels contient
les dossiers suivants :
Fichiers HTML (Rubriques)
Stocke les rubriques d'un projet. Les fichiers sont stock&eacute;s par ordre alphanum&eacute;rique (A &agrave; Z, 0 &agrave; 9).
Vous pouvez ajouter des dossiers dans ce dossier. Cette structure permet de g&eacute;n&eacute;rer
automatiquement une table des mati&egrave;res et de cr&eacute;er des s&eacute;quences de navigation.
Images
Les images utilis&eacute;es dans un projet sont stock&eacute;es dans ce dossier. Les mappages d'images et les liens
associ&eacute;s (zones cliquables) sont &eacute;galement r&eacute;pertori&eacute;s. Vous pouvez faire glisser une image de ce
dossier dans l'&eacute;diteur de conception pour ajouter des images aux rubriques. Vous pouvez
&eacute;galement renommer les images de ce dossier en les s&eacute;lectionnant et en appuyant sur la touche F2.
Multim&eacute;dia
Tous les fichiers audio et vid&eacute;o du projet sont enregistr&eacute;s dans ce dossier. Les d&eacute;monstrations
Adobe Captivate (fichiers SWF) y sont &eacute;galement stock&eacute;es. Vous pouvez faire glisser des fichiers
audio ou vid&eacute;o dans l'&eacute;diteur de conception pour ajouter des objets multim&eacute;dia aux rubriques.
Vous pouvez &eacute;galement trouver l'emplacement des fichiers r&eacute;f&eacute;renc&eacute;s dans le projet.
Feuilles de style
Les feuilles de style contr&ocirc;lent le formatage des rubriques. Lorsque vous modifiez une feuille de
style, toutes les rubriques qui lui sont associ&eacute;es sont mises &agrave; jour. Les feuilles de style par d&eacute;faut de
RoboHelp (fichiers CSS) et toute autre feuille de style ajout&eacute;e au projet sont stock&eacute;es dans ce
dossier. Modifiez une feuille de style en cliquant deux fois sur son ic&ocirc;ne.
Fichiers bagage
RoboHelp fournit un m&eacute;canisme pour inclure un contenu qui n'est pas directement li&eacute; au projet en
le t&eacute;l&eacute;chargeant en tant que fichier bagage. Lorsque vous cliquez sur un lien vers un contenu dans
le fichier bagage, le fichier s'ouvre dans l'application associ&eacute;e. Vous pouvez ajouter des fichiers PDF,
des documents Word, des feuilles de calcul Excel, des fichiers PowerPoint, etc. Certains fichiers sont
automatiquement ajout&eacute;s au dossier Fichiers bagage du gestionnaire de projets afin d'afficher
correctement les &eacute;l&eacute;ments suivants dans le projet g&eacute;n&eacute;r&eacute; :
•
•
•
•
Fichiers bitmap et d'ic&ocirc;nes utilis&eacute;s avec les contr&ocirc;les HTML Help
Fichiers image utilis&eacute;s en arri&egrave;re-plan et dans les scripts de rubrique
Fichier JavaScript (ehlpdhtm.js) prenant en charge les effets HTML dynamiques (par exemple, les
fen&ecirc;tres contextuelles des rubriques connexes, les fen&ecirc;tres contextuelles dynamiques et les zones
cliquables d&eacute;roulantes).
Fichier de support des habillages et volet de navigation dans les r&eacute;sultats bas&eacute;s sur le navigateur
(table des mati&egrave;res, index, glossaire et recherche de texte int&eacute;gral).
Vous pouvez faire glisser des fichiers du dossier Fichiers bagage et les d&eacute;poser dans des rubriques
pour cr&eacute;er des liens vers les fichiers.
48
CHAPITRE 3
CR&Eacute;ATION ET GESTION DES PROJETS
PROJETS
Liens rompus
Stocke les liens renvoyant &agrave; des fichiers ne se trouvant pas dans le projet. Cliquez deux fois sur un
lien rompu pour le restaurer ou le supprimer.
URL
Stocke des liens vers des adresses Web, des sites FTP, des groupes de discussion, des adresses
&eacute;lectroniques et des rubriques HTML se trouvant dans des fichiers CHM externes. Vous pouvez
ajouter une URL &agrave; un index &agrave; partir de ce dossier. Vous pouvez faire glisser une URL et la d&eacute;poser
dans l'&eacute;diteur de conception.
Table des mati&egrave;res
Stocke la table des mati&egrave;res par d&eacute;faut ainsi que toutes les autres tables des mati&egrave;res cr&eacute;&eacute;es dans
le projet.
Index
Stocke l'index par d&eacute;faut ainsi que tout autre index cr&eacute;&eacute; dans le projet.
Glossaire
Stocke le glossaire par d&eacute;faut ainsi que tous les autres glossaires cr&eacute;&eacute;s dans le projet.
Voir aussi
Cliquez deux fois sur le dossier Voir aussi pour afficher le conteneur Voir aussi. Vous pouvez ajouter
les mots cl&eacute;s Voir aussi au conteneur Voir aussi.
Modification du nom des dossiers
Le gestionnaire de projets permet de renommer les dossiers.
1) Dans le conteneur Gestionnaire de projets, ouvrez le dossier Fichiers de projet.
2) Cliquez avec le bouton droit de la souris sur le dossier. S&eacute;lectionnez Renommer.
3) Tapez le nouveau nom. N'ajoutez pas de caract&egrave;res sp&eacute;ciaux et &eacute;vitez les espaces, en particulier
avec WebHelp et FlashHelp.
4) Appuyez sur Entr&eacute;e.
D&eacute;placement de dossiers
Le gestionnaire de projets permet de d&eacute;placer des dossiers.
1) Dans le conteneur Gestionnaire de projets, cliquez sur Fichiers de projet.
2) Faites glisser le sous-dossier vers son nouvel emplacement.
Suppression de dossiers personnalis&eacute;s
Avant de supprimer le dossier, d&eacute;placez les &eacute;l&eacute;ments qu'il contient si vous souhaitez les conserver.
1) Dans le conteneur Gestionnaire de projets, s&eacute;lectionnez le dossier personnalis&eacute;.
2) S&eacute;lectionnez Projet &gt; Supprimer.
49
CR&Eacute;ATION ET GESTION DES PROJETS
PROJETS
CHAPITRE 3
Ic&ocirc;nes de fichiers et de dossiers
Les ic&ocirc;nes du gestionnaire de projets indiquent les composants et fichiers inclus dans votre projet.
REMARQUE : Les ic&ocirc;nes associ&eacute;es &agrave; une coche rouge indiquent que le fichier a &eacute;t&eacute; extrait. Cette
fonctionnalit&eacute; s'applique uniquement aux rubriques sous contr&ocirc;le de version.
Ic&ocirc;ne
Description
Dossiers ferm&eacute;s. Les dossiers ferm&eacute;s contenant des fichiers sont associ&eacute;s au signe
plus. Cliquez sur le signe plus pour afficher le contenu du dossier. Cliquez sur avec le
bouton droit de la souris pour acc&eacute;der &agrave; des options suppl&eacute;mentaires.
Dossiers ouverts. Les dossiers ouverts sont associ&eacute;s au signe moins et leur contenu
est affich&eacute; en dessous. Cliquez sur le signe moins pour r&eacute;duire le dossier.
,
Afficher ou masquer la vue. Cliquez pour basculer d'une vue simplifi&eacute;e contenant
moins de dossiers &agrave; une vue affichant tous les dossiers.
Afficher/masquer les fichiers. Cliquez pour s&eacute;lectionner les fichiers que vous voulez
afficher dans le gestionnaire de projets.
Dossiers vides. Aucun signe n'est associ&eacute; aux dossiers vides.
Fichiers HTML (Rubriques). Cliquez deux fois sur les ic&ocirc;nes de page pour ouvrir
l'&eacute;diteur de conception. Cliquez avec le bouton droit de la souris pour acc&eacute;der &agrave; des
options suppl&eacute;mentaires.
Rubriques HTML avec signets. Les rubriques avec signets sont associ&eacute;es au signe
plus. Cliquez sur le signe plus pour afficher tous les signets.
Fichiers manquants. Un X rouge signale les fichiers que le programme ne parvient
pas &agrave; localiser. Ces fichiers n'apparaissent pas dans le chemin du projet. Il est
possible qu'ils aient &eacute;t&eacute; supprim&eacute;s ou enregistr&eacute;s dans un dossier autre que celui du
projet.
Signets. Les signets s'affichent par ordre alphab&eacute;tique sous leurs rubriques
respectives. Cliquez deux fois dessus pour ouvrir une rubrique. Faites glisser les
signets et d&eacute;posez-les dans les rubriques affich&eacute;es dans l'&eacute;diteur de conception
pour cr&eacute;er des liens.
Jeux de cadres. Cliquez deux fois sur cette ic&ocirc;ne pour ouvrir la bo&icirc;te de dialogue
permettant de modifier les attributs de cadre.
URL, adresses Web, sites FTP, groupes de discussion, adresses &eacute;lectroniques ou
rubriques HTML dans des fichiers CHM externes. Cliquez deux fois sur cette ic&ocirc;ne
pour ouvrir la bo&icirc;te de dialogue permettant d'ajouter des mots-cl&eacute;s &agrave; un lien. Faites
glisser les URL et d&eacute;posez-les dans les rubriques ouvertes dans l'&eacute;diteur de
conception pour cr&eacute;er des liens.
50
CR&Eacute;ATION ET GESTION DES PROJETS
PROJETS
CHAPITRE 3
Ic&ocirc;ne
Description
Images (formats GIF, JPEG et JPG). Cliquez deux fois sur cette ic&ocirc;ne pour afficher un
aper&ccedil;u des images, identifier les rubriques qui les utilisent et afficher les
informations relatives &agrave; ces fichiers. Pour ajouter une image, d&eacute;posez-la dans une
rubrique affich&eacute;e dans l'&eacute;diteur de conception.
Mappages d'image. Images avec des liens ou des zones cliquables. Cliquez sur le
signe plus pour afficher les liens. Cliquez deux fois sur cette ic&ocirc;ne pour afficher un
aper&ccedil;u de l'image, identifier les rubriques utilisant les fichiers associ&eacute;s et afficher les
informations de fichier. Pour ajouter un mappage d'image, d&eacute;posez-le dans une
rubrique affich&eacute;e dans l'&eacute;diteur de conception.
Liens de mappages d'image (zones cliquables). Cliquez deux fois sur cette ic&ocirc;ne pour
identifier les rubriques utilisant les mappages d'image.
Fichiers audio (formats AU, MID, RMI et WAV). Cliquez deux fois sur cette ic&ocirc;ne pour
identifier les rubriques utilisant les fichiers associ&eacute;s et afficher les informations
relatives &agrave; ces fichiers. Pour ajouter un fichier audio, d&eacute;posez-le dans une rubrique
affich&eacute;e dans l'&eacute;diteur de conception.
Fichiers vid&eacute;o (formats AVI et MOV). Cliquez deux fois sur cette ic&ocirc;ne pour identifier
les rubriques utilisant les fichiers associ&eacute;s et afficher les informations relatives &agrave; ces
fichiers. Pour ajouter un fichier vid&eacute;o, d&eacute;posez-le dans une rubrique affich&eacute;e dans
l'&eacute;diteur de conception.
Fichiers Adobe Captivate (fichiers SWF). Cliquez deux fois sur cette ic&ocirc;ne pour
identifier les rubriques utilisant les fichiers associ&eacute;s et afficher les informations
relatives &agrave; ces fichiers. Pour ajouter un fichier Adobe Captivate, d&eacute;posez-le dans une
rubrique affich&eacute;e dans l'&eacute;diteur de conception.
Fen&ecirc;tres personnalis&eacute;es. Cliquez deux fois sur cette ic&ocirc;ne pour modifier les
propri&eacute;t&eacute;s de la fen&ecirc;tre.
Feuilles de style en cascade (CSS). Cliquez deux fois sur cette ic&ocirc;ne pour modifier les
styles.
Fichiers texte uniquement pour projets d'aide Qu'est-ce que c'est ? (format TXT).
Cliquez deux fois sur cette ic&ocirc;ne pour cr&eacute;er ou modifier les fichiers texte
uniquement.
Fichiers de mappage pour l'aide contextuelle (.HH) : inclut des fichiers de mappage
import&eacute;s ou des fichiers g&eacute;n&eacute;r&eacute;s automatiquement.
Tous les ID de mappage. Etablit des liens entre les ID de mappage et les rubriques
HTML pour l'aide contextuelle. Cliquez deux fois sur cette ic&ocirc;ne pour travailler avec
les ID de mappage et les fichiers de mappage.
Dossier Table des mati&egrave;res. Affiche la table des mati&egrave;res par d&eacute;faut et les autres
tables des mati&egrave;res du projet.
51
CR&Eacute;ATION DE CONTENU MULTILINGUE
PROJETS
CHAPITRE 3
Ic&ocirc;ne
Description
Dossier Table des mati&egrave;res. D&eacute;velopper pour afficher la table des mati&egrave;res
r&eacute;pertori&eacute;e.
Table des mati&egrave;res. Cliquez deux fois sur cette ic&ocirc;ne pour ouvrir le volet de la table
des mati&egrave;res s&eacute;lectionn&eacute;e.
Dossier Index. Affiche l'index par d&eacute;faut et les &eacute;ventuels autres index r&eacute;pertori&eacute;s.
Dossier Index. D&eacute;veloppez pour afficher les index r&eacute;pertori&eacute;s.
Index. Cliquez deux fois sur cette ic&ocirc;ne pour ouvrir le volet de l'index s&eacute;lectionn&eacute;.
Dossier Glossaire. Affiche le glossaire par d&eacute;faut et les &eacute;ventuels autres glossaires
r&eacute;pertori&eacute;s.
Dossier Glossaire. D&eacute;veloppez pour afficher les glossaires r&eacute;pertori&eacute;s.
Glossaire. Cliquez deux fois sur cette ic&ocirc;ne pour ouvrir le volet du glossaire
s&eacute;lectionn&eacute;.
Voir aussi. Cliquez deux fois sur cette ic&ocirc;ne pour ouvrir le volet Voir aussi et ajouter
des mots-cl&eacute;s.
Fichiers bagage (fichiers BMP, ICO, XML, JS et autres fichiers image). Fichiers tels que
les fichiers bitmap et d'ic&ocirc;nes utilis&eacute;s avec les commandes HTML Help, y compris les
boutons personnalis&eacute;s pour les contr&ocirc;les de lien et les &eacute;crans de d&eacute;marrage. Si
votre projet inclut du code HTML dynamique, le fichier EHLPDHTMJS est inclus dans
le dossier de fichiers bagage. D'autres fichiers image sont &eacute;galement inclus,
notamment les arri&egrave;re-plans de rubriques et les scripts.
ASTUCE : Vous pouvez mapper des extensions de noms de fichier avec des applications. Par exemple, vous
pouvez mapper des fichiers GIF avec Adobe Photoshop&reg;. Si vous cliquez avec le bouton droit de la souris
sur un fichier GIF du dossier Images et s&eacute;lectionnez Modifier, le fichier s'ouvre dans Photoshop.
LIENS CONNEXES :
D&eacute;finition d'une langue pour un paragraphe
3.3.
Cr&eacute;ation de contenu multilingue
Vous pouvez changer la langue d'un projet nouveau ou existant. La langue change le texte de la fen&ecirc;tre
ainsi que le dictionnaire du v&eacute;rificateur orthographique et les param&egrave;tres personnalis&eacute;s de l'indexation
automatique (assistant d'index dynamique).
Vous pouvez &eacute;galement personnaliser le texte affich&eacute;, comme le texte du bouton de la s&eacute;quence de
navigation, les boutons Pr&eacute;c&eacute;dent, Suivant et Afficher/Masquer, certains messages, etc. Vous pouvez
sp&eacute;cifier n'importe quel texte. Par exemple, le texte par d&eacute;faut &laquo; Rechercher &raquo; de l'onglet Rechercher
peut &ecirc;tre remplac&eacute; par &laquo; Trouver &raquo; dans la langue de votre choix.
52
CR&Eacute;ATION DE CONTENU MULTILINGUE
PROJETS
CHAPITRE 3
Lors de la distribution du projet aux traducteurs, indiquez toujours les fichiers source et non les fichiers
de sortie.
REMARQUE : Dans les syst&egrave;mes HTML Help, la langue du syst&egrave;me d'exploitation de l'utilisateur final doit
&ecirc;tre identique &agrave; celle du projet, faute de quoi elle remplace la langue sp&eacute;cifi&eacute;e dans votre projet. L'ordre
du dictionnaire et de l'index n'est pas affect&eacute; dans le syst&egrave;me de l'utilisateur final.
Prise en charge de plusieurs langues
RoboHelp prend en charge plusieurs langues au niveau du paragraphe, de la rubrique et du projet. Vous
pouvez d&eacute;finir la langue au niveau du paragraphe ou de la rubrique dans l'interface utilisateur de
RoboHelp. La langue d&eacute;finie au niveau du paragraphe est prioritaire sur la langue d&eacute;finie au niveau de la
rubrique. La langue d&eacute;finie au niveau de la rubrique est prioritaire sur la langue d&eacute;finie au niveau du
projet. La langue d&eacute;finie au niveau du projet ne peut jamais &ecirc;tre prioritaire sur la langue d&eacute;finie au niveau
du paragraphe. On peut se repr&eacute;senter la langue prioritaire comme la langue effective. La langue en cours
est utilis&eacute;e dans les v&eacute;rifications orthographiques, dans le dictionnaire ou le th&eacute;saurus, dans la
g&eacute;n&eacute;ration d'index dynamique et dans la pr&eacute;paration des recherches en texte int&eacute;gral.
La langue du projet est d&eacute;finie au niveau du projet. Vous pouvez appliquer diff&eacute;rents param&egrave;tres de
langue en utilisant Projet &gt; Param&egrave;tres du projet.
La d&eacute;finition de la langue au niveau de la rubrique s'effectue dans la bo&icirc;te de dialogue Propri&eacute;t&eacute;s de
rubrique.
La d&eacute;finition de la langue au niveau du paragraphe s'effectue dans la bo&icirc;te de dialogue Paragraphe.
S&eacute;lectionner n'importe quel paragraphe dans l'affichage de la conception et choisissez Paragraphe dans
le menu contextuel.
RoboHelp prend en charge les langues suivantes.
Langues
V&eacute;rification
orthographique
Dictionnaire
utilisateur
Th&eacute;saurus
Correction
automatique
Arabe
Oui
Oui
Oui
Oui
Danois (Danemark)
Oui
Oui
Oui
Oui
Allemand (Allemagne)
Oui
Oui
Oui
Oui
Anglais (Etats-Unis)
Oui
Oui
Oui
Oui
Anglais (Royaume-Uni)
Oui
Oui
Oui
Oui
Espagnol (Espagne)
Oui
Oui
Oui
Oui
Fran&ccedil;ais (France)
Oui
Oui
Oui
Oui
H&eacute;breu
Oui
Oui
Oui
Oui
Italien (Italie)
Oui
Oui
Oui
Oui
N&eacute;erlandais (Pays-Bas)
Oui
Oui
Oui
Oui
53
CR&Eacute;ATION DE CONTENU MULTILINGUE
PROJETS
CHAPITRE 3
Langues
V&eacute;rification
orthographique
Dictionnaire
utilisateur
Th&eacute;saurus
Correction
automatique
Norv&eacute;gien Bokm&aring;l
(Norv&egrave;ge)
Oui
Oui
Oui
Oui
Norv&eacute;gien Nynorsk
(Norv&egrave;ge)
Oui
Oui
Non
Oui
Portugais (Br&eacute;sil)
Oui
Oui
Non
Oui
Su&eacute;dois (Su&egrave;de)
Oui
Oui
Oui
Oui
Croate (Croatie)
Oui
Oui
Non
Oui
Portugais (Portugal)
Oui
Oui
Non
Oui
Fran&ccedil;ais (Canada)
Oui
Oui
Oui
Oui
Finnois (Finlande)
Oui
Oui
Non
Oui
Catalan (Espagne)
Oui
Oui
Non
Oui
Russe (Russie)
Oui
Oui
Non
Oui
Bulgare (Bulgarie)
Oui
Oui
Non
Oui
Tch&egrave;que (R&eacute;publique
tch&egrave;que)
Oui
Oui
Non
Oui
Polonais (Pologne)
Oui
Oui
Non
Oui
Roumain (Roumanie)
Oui
Oui
Non
Oui
Hongrois (Hongrie)
Oui
Oui
Non
Oui
Grec (Gr&egrave;ce)
Oui
Oui
Non
Oui
Turc (Turquie)
Oui
Oui
Non
Oui
Estonien (Estonie)
Oui
Oui
Non
Oui
Letton (Lettonie)
Oui
Oui
Non
Oui
Lituanien (Lituanie)
Oui
Oui
Non
Oui
Slov&egrave;ne (Slov&eacute;nie)
Oui
Oui
Non
Oui
Allemand (Suisse)
Oui
Oui
Oui
Oui
Japonais (Japon)
Non
Non
Non
Non
Cor&eacute;en (Cor&eacute;e)
Non
Non
Non
Non
Chinois traditionnel
(Taiwan)
Non
Non
Non
Non
54
CR&Eacute;ATION DE CONTENU MULTILINGUE
PROJETS
CHAPITRE 3
Langues
V&eacute;rification
orthographique
Dictionnaire
utilisateur
Th&eacute;saurus
Correction
automatique
Chinois simplifi&eacute; (Chine)
Non
Non
Non
Non
Tha&iuml; (Tha&iuml;lande)
Non
Non
Non
Non
Vietnamien (Vietnam)
Non
Non
Non
Non
LIENS CONNEXES :
Cr&eacute;er une rubrique
Cr&eacute;ation et modification de mises en page de source unique
Organisation du travail de traduction
Vous pouvez cr&eacute;er du contenu dans diverses langues au sein d'un m&ecirc;me projet RoboHelp HTML en
proc&eacute;dant &agrave; la traduction du contenu. Vous pouvez alors cr&eacute;er des tables des mati&egrave;res, des index, des
glossaires et des balises de construction conditionnelles dans le projet pour les langues souhait&eacute;es. Enfin,
vous pouvez appliquer des balises de construction conditionnelles au contenu multilingue et g&eacute;n&eacute;rer le
r&eacute;sultat conditionnel.
Suivez les &eacute;tapes de ce processus qui traduit de l'anglais vers le fran&ccedil;ais et le japonais (exemple) :
1) Appliquez les param&egrave;tres de projet fran&ccedil;ais en s&eacute;lectionnant Fran&ccedil;ais comme langue de projet.
2) Ouvrez une rubrique en anglais, cr&eacute;ez une rubrique en fran&ccedil;ais et traduisez le contenu, avec le titre
de la rubrique, de l'anglais vers le fran&ccedil;ais. (Ne traduisez pas le nom de fichier des rubriques).
3) Cr&eacute;ez des tables des mati&egrave;res, des index et des glossaires en fran&ccedil;ais.
4) Cr&eacute;ez une balise de construction conditionnelle, telle que FrenchContent.
5) Appliquez la balise FrenchContent au contenu et aux rubriques en fran&ccedil;ais.
6) G&eacute;n&eacute;rez le projet fran&ccedil;ais.
7) Appliquez les param&egrave;tres de projet japonais en s&eacute;lectionnant Japonais comme langue de projet.
8) Ouvrez une rubrique en anglais, cr&eacute;ez une rubrique de langue japonaise et traduisez le contenu de
l'anglais vers le japonais.
9) Cr&eacute;ez des tables des mati&egrave;res, des index et des glossaires en japonais.
10) Cr&eacute;ez une balise de construction conditionnelle appel&eacute;e JapaneseContent.
11) Appliquez la balise JapaneseContent au contenu en japonais.
12) G&eacute;n&eacute;rez le projet japonais.
REMARQUE : Pour afficher la sortie en japonais, vous devez modifier la langue de votre ordinateur et
choisir le japonais.
REMARQUE : Pour traduire un projet WebHelp, commencez par effectuer une copie du projet, ouvrez
cette copie dans RoboHelp et cr&eacute;ez une version dans la langue souhait&eacute;e.
55
CHAPITRE 3
CR&Eacute;ATION DE CONTENU MULTILINGUE
PROJETS
Comparaison entre plusieurs langues
1)
2)
Ouvrez les rubriques cr&eacute;&eacute;es dans diff&eacute;rentes langues.
Dans l'&eacute;diteur de conception, positionnez les rubriques c&ocirc;te &agrave; c&ocirc;te : faites glisser une rubrique
l&eacute;g&egrave;rement vers le bas ou vers la droite et rel&acirc;chez la souris lorsque l'ic&ocirc;ne de la page appara&icirc;t.
Choisissez Nouveau groupe d'onglets horizontal ou Nouveau groupe d'onglets vertical.
S&eacute;lection d'une langue de traduction diff&eacute;rente pour un fichier de projet
1)
2)
S&eacute;lectionnez Sortie &gt; Mots exclus.
Dans les param&egrave;tres avanc&eacute;s de la bo&icirc;te de dialogue de localisation, utilisez les onglets suivants :
Liste d'exclusion
Cliquez sur Nouveau pour ajouter des mots &agrave; ignorer pendant la recherche de texte.
Expressions
Cliquez sur Nouveau pour ajouter une expression que l'assistant d'index dynamique inclura dans sa
recherche de mots-cl&eacute;s contenus dans les rubriques.
Libell&eacute;s
Cliquez sur Modifier pour modifier le texte correspondant &agrave; chaque &eacute;l&eacute;ment de l'interface
utilisateur r&eacute;pertori&eacute;.
Mots &laquo; Ignorer toujours &raquo;
Cliquez sur Nouveau pour ajouter un mot ou une expression qui seront ignor&eacute;s par l'assistant
d'index dynamique lors de la g&eacute;n&eacute;ration de l'index.
Synonymes
Cliquez sur Nouveau pour ajouter un synonyme &agrave; un mot. Cette option vous permet de rechercher
des mots et leurs synonymes. Les r&eacute;sultats renvoy&eacute;s concernent toujours les mots recherch&eacute;s.
Cr&eacute;ation d'un projet dans une langue diff&eacute;rente
1)
2)
3)
4)
5)
S&eacute;lectionnez Fichier &gt; Nouveau projet.
Dans l'onglet Nouveau, cliquez deux fois sur Type de projet. l'assistant de cr&eacute;ation de nouveau
projet s'ouvre.
REMARQUE : Pour cr&eacute;er un projet d'aide JavaHelp ou Oracle, commencez par cr&eacute;er un projet d'aide
Microsoft HTML, puis ajoutez une nouvelle mise en page &agrave; ce projet.
Saisissez les informations relatives au projet.
Dans le menu Langue, s&eacute;lectionnez la langue souhait&eacute;e. Activez la case Enregistrer par d&eacute;faut pour
conserver la langue en tant que param&egrave;tre par d&eacute;faut.
Cliquez sur Terminer.
56
CHAPITRE 3
CR&Eacute;ATION DE CONTENU MULTILINGUE
PROJETS
La premi&egrave;re rubrique s'ouvre dans l'&eacute;diteur de conception. G&eacute;n&eacute;rez et affichez votre projet pour voir le
r&eacute;sultat.
LIENS CONNEXES :
Importation et liaison de documents Microsoft Word
Personnalisation du texte pour la localisation
Vous pouvez personnaliser un texte de l'interface utilisateur pour les projets WebHelp, WebHelp Pro,
FlashHelp, FlashHelp Pro et HTML Help. Voici ce que vous pouvez changer pour chaque format :
WebHelp, WebHelp Pro, FlashHelp et FlashHelp Pro
•
Avec habillage Personnalisez le texte dans l'&eacute;diteur d'habillage. Si vous ne changez pas le texte
par d&eacute;faut (par exemple, Table des mati&egrave;res du bouton du m&ecirc;me nom), il est automatiquement
traduit &agrave; l'aide des param&egrave;tres linguistiques du projet. Si vous personnalisez le texte d'un habillage,
les modifications remplacent les personnalisations effectu&eacute;es dans le fichier LNG. Pour FlashHelp,
le d&eacute;veloppeur Flash utilise le Kit de d&eacute;veloppement d'habillage pour personnaliser le texte.
WebHelp uniquement
•
Sans habillage Modifiez le fichier de langue. Vous pouvez localiser le texte du bouton de
s&eacute;quence de navigation, le texte de l'onglet Glossaire, les boutons Pr&eacute;c&eacute;dent et Suivant, certains
messages, ainsi que les onglets Table des mati&egrave;res, Index et Rechercher. Par exemple, vous pouvez
modifier le texte de l'onglet Rechercher en rempla&ccedil;ant Rechercher par Trouver.
HTML Help
Vous pouvez personnaliser le texte du bouton de s&eacute;quence de navigation et tout le texte de l'onglet
Glossaire. Changez les titres des fen&ecirc;tres dans la bo&icirc;te de dialogue Propri&eacute;t&eacute;s de la fen&ecirc;tre.
Modifier le fichier de libell&eacute;s
1)
2)
3)
4)
Cr&eacute;ez ou ouvrez un projet.
S&eacute;lectionnez Sortie &gt; Libell&eacute;s.
S&eacute;lectionnez le texte d'interface. Cliquez sur Modifier.
Tapez les modifications. Appuyez sur Entr&eacute;e.
Remarques
•
•
•
si RoboHHRE.LNG est d&eacute;j&agrave; stock&eacute; dans le dossier Windows de l'utilisateur, il remplace le fichier
stock&eacute; dans le dossier Fichiers bagage.
Si vous n'incluez pas le fichier RoboHHRE.LNG ou omettez certaines valeurs, les valeurs en anglais
sont appliqu&eacute;es par d&eacute;faut (comme dans l'exemple ci-dessus).
Si vous utilisez un habillage, le texte par d&eacute;faut est traduit dans la langue par d&eacute;faut. Si vous
personnalisez le texte d'un habillage, les modifications remplacent les personnalisations effectu&eacute;es
dans le fichier LNG.
57
CHAPITRE 3
CR&Eacute;ATION DE CONTENU MULTILINGUE
PROJETS
Modification de la langue par d&eacute;faut d'un projet
1)
2)
3)
4)
5)
Ouvrez le projet.
S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet.
Cliquez sur l'onglet G&eacute;n&eacute;ralit&eacute;s, puis s&eacute;lectionnez la langue souhait&eacute;e.
Cliquez sur OK.
G&eacute;n&eacute;rez et affichez le projet.
Remarques
•
•
Si vous utilisez un habillage, le texte par d&eacute;faut utilise les param&egrave;tres linguistiques d&eacute;finis pour votre
projet. Le texte de l'habillage personnalis&eacute; remplace les param&egrave;tres de texte du fichier LNG.
Traduisez les l&eacute;gendes de fen&ecirc;tre dans la bo&icirc;te de dialogue Propri&eacute;t&eacute;s de la fen&ecirc;tre (ne s'applique
pas aux projets WebHelp).
Prise en charge de la langue du dictionnaire associ&eacute;
Si votre projet a &eacute;t&eacute; cr&eacute;&eacute; en plusieurs langues, d&eacute;finissez s&eacute;par&eacute;ment les param&egrave;tres de langue RoboHelp
dans le projet, la rubrique et le paragraphe. La langue en cours est utilis&eacute;e pour le dictionnaire ou le
dictionnaire des synonymes et pour le v&eacute;rificateur orthographique. Supposons par exemple que vous
d&eacute;finissiez la langue du projet sur Anglais (Royaume-Uni) et la langue du paragraphe sur Fran&ccedil;ais pour
plusieurs paragraphes. La v&eacute;rification orthographique du fran&ccedil;ais est activ&eacute;e pour les paragraphes en
fran&ccedil;ais et la v&eacute;rification orthographique de l'anglais (Royaume-Uni) est utilis&eacute;e pour le reste du contenu.
REMARQUE : Tous les param&egrave;tres linguistiques modifi&eacute;s sont stock&eacute;s au m&ecirc;me emplacement, dans le
sous-dossier \!Language! du dossier du projet.
Indexation de texte localis&eacute;
Indexez votre projet localis&eacute; avec l'assistant d'index dynamique. Vous pouvez assigner des mots-cl&eacute;s pour
chaque rubrique en fonction du contenu. l'index est g&eacute;n&eacute;r&eacute; en fonction des crit&egrave;res de langue et de
recherche que vous avez d&eacute;finis dans l'assistant d'index dynamique. l'assistant d'index dynamique
sugg&egrave;re des mots-cl&eacute;s en fonction du contenu des rubriques.
1) S&eacute;lectionnez une langue pour un nouveau projet ou un projet existant.
2) Suivez les &eacute;tapes de cr&eacute;ation automatique d'index.
58
CHAPITRE 3
CR&Eacute;ATION DE CONTENU MULTILINGUE
PROJETS
Jeux de caract&egrave;res universels
RoboHelp vous permet de cr&eacute;er du contenu multilingue. Toutefois, il est plus difficile de cr&eacute;er du contenu
dans un environnement multilingue lorsque ces langues requi&egrave;rent plusieurs pages de code Microsoft
Windows. Pour vous simplifier la t&acirc;che, RoboHelp prend en charge le codage Unicode.
Les syst&egrave;mes d'exploitation qui ne prennent pas en charge le codage Unicode utilisent un environnement
bas&eacute; sur des pages de code, dans lequel chaque script de langue poss&egrave;de sa propre table de caract&egrave;res.
Le contenu bas&eacute; sur la page de code d'un syst&egrave;me d'exploitation est alors converti de mani&egrave;re al&eacute;atoire
sur un autre syst&egrave;me d'exploitation utilisant une page de code diff&eacute;rente. Par exemple, supposons que
vous ex&eacute;cutiez la version anglaise du syst&egrave;me d'exploitation Microsoft Windows&reg; XP/Vista avec la page
de code en allemand. Supposons &eacute;galement que vous ouvriez un fichier de texte brut cr&eacute;&eacute; dans la version
japonaise de Windows XP/Vista. Vous constaterez que les points de code de la page de code japonaise
sont associ&eacute;s &agrave; des caract&egrave;res inattendus ou inexistants du script occidental. Le texte est alors illisible.
Prise en charge d'Unicode
RoboHelp HTML prend en charge le codage de texte Unicode. Vous pouvez cr&eacute;er une rubrique dans
plusieurs langues sans que celles-ci soient forc&eacute;ment prises en charge par le syst&egrave;me d'exploitation
ex&eacute;cutant RoboHelp.
Vous pouvez effectuer les t&acirc;ches suivantes relatives &agrave; Unicode :
•
Cr&eacute;ation de documents contenant plusieurs mots/paragraphes multilingues (exemple : des
caract&egrave;res grecs suivis de caract&egrave;res russes, eux-m&ecirc;mes suivis par du texte fran&ccedil;ais, dans le m&ecirc;me
paragraphe).
•
Utilisation automatique du v&eacute;rificateur orthographique correspondant au contenu Unicode.
•
Cr&eacute;ation, ouverture ou modification de fichiers HTML Unicode et de fichiers texte (fichiers UTF-8 et
UTF-16).
•
Saisie de caract&egrave;res Unicode dans les formulaires et bo&icirc;tes de dialogue.
•
G&eacute;n&eacute;ration d'une table des mati&egrave;res, d'un index et d'un glossaire &agrave; l'aide de cha&icirc;nes Unicode.
•
Conversion et importation de texte non Unicode (HTML, XML, MIGF, etc.).
•
Publication du contenu sur un serveur non anglais en ajoutant des caract&egrave;res multioctets dans le
nom complet du chemin.
•
Cr&eacute;ation, ouverture et modification de fichiers HTML Unicode de type UTF-8 et UTF-16.
•
Sortie Unicode et affichage de contenu Unicode dans des champs, bo&icirc;tes de dialogues, assistants et
formulaires.
59
CHAPITRE 3
CR&Eacute;ATION DE CONTENU MULTILINGUE
PROJETS
Configuration de langues de saisie sous Windows
Avant de commencer &agrave; saisir du texte non anglais ou des caract&egrave;res Unicode dans les fichiers HTML,
assurez-vous que RoboHelp HTML 8 est ex&eacute;cut&eacute; sur des param&egrave;tres r&eacute;gionaux UTF-8. Configurez la
langue r&eacute;gionale ou les param&egrave;tres r&eacute;gionaux sur votre ordinateur pour ajouter d'autres langues pour la
saisie au clavier, sur les syst&egrave;mes d'exploitation.
Utilisez les param&egrave;tres r&eacute;gionaux de Windows&reg; XP pour ajouter d'autres langues et adapter la saisie
clavier. Ces param&egrave;tres linguistiques s'affichent dans la barre de langue du bureau. Apr&egrave;s avoir
s&eacute;lectionn&eacute; une langue dans la barre et un clavier localis&eacute;, vous pouvez commencer la saisie du texte
demand&eacute; dans le document. Microsoft&reg; d&eacute;finit les configurations clavier.
1) Ouvrez le Panneau de configuration et cliquez deux fois sur l'ic&ocirc;ne Options r&eacute;gionales et
linguistiques. La bo&icirc;te de dialogue Options r&eacute;gionales et linguistiques s'affiche.
2) Cliquez sur l'onglet Langues.
3) Cliquez sur D&eacute;tails. La bo&icirc;te de dialogue Services de texte et langues d'entr&eacute;e s'affiche.
4) Dans l'onglet Param&egrave;tres, cliquez sur Ajouter.
5) S&eacute;lectionnez une langue sous Langue d'entr&eacute;e.
6) Cliquez sur OK. La langue s&eacute;lectionn&eacute;e est ajout&eacute;e &agrave; la liste des services install&eacute;s.
7) S&eacute;lectionnez la langue souhait&eacute;e dans la liste des langues d'entr&eacute;e par d&eacute;faut.
8) Cliquez sur Appliquer, puis sur OK pour enregistrer les param&egrave;tres. Ensuite, fermez la bo&icirc;te de
dialogue Services de texte et langues d'entr&eacute;e.
9) Cliquez sur l'onglet Options r&eacute;gionales et choisissez la langue que vous avez s&eacute;lectionn&eacute;e dans la
liste Langue d'entr&eacute;e par d&eacute;faut.
10) Cliquez sur Appliquer, puis sur OK pour enregistrer les param&egrave;tres. Ensuite, fermez la bo&icirc;te de
dialogue Options r&eacute;gionales et linguistiques. La barre de langue s'affiche dans le bureau.
11) Ouvrez RoboHelp et tapez le contenu. Le texte s'affiche dans la langue s&eacute;lectionn&eacute;e.
Vous pouvez changer la langue dans la liste des langues de saisie par d&eacute;faut et dans l'onglet Options
r&eacute;gionales. La langue s&eacute;lectionn&eacute;e dans la barre des langues est mise &agrave; jour automatiquement en
fonction de votre choix.
Mise &agrave; niveau de projets localis&eacute;s
La personnalisation au niveau du produit est plac&eacute;e dans le dossier [dossier_installation]\Language de RoboHelp. Par exemple, l'anglais est renomm&eacute; en_US et en_UK, alors que le fran&ccedil;ais
est renomm&eacute; fr_FR.
La personnalisation au niveau du projet est plac&eacute;e dans le
dossier[dossier_projet]\!Language!\[dossier_langue].
60
IMPORTATION DE FICHIERS PDF
PROJETS
CHAPITRE 3
Personnalisations mineures
1)
2)
3)
Ouvrez le Bloc-notes.
Ouvrez le fichier &agrave; modifier. Ces fichiers sont stock&eacute;s sous C:\Program Files\Adobe\Adobe RoboHelp
[version]\RoboHTML\!Language!\en_US.
Ouvrez le projet. Effectuez les op&eacute;rations suivantes :
–
Modification du fichier LNG.
–
Modification des listes de mots personnalis&eacute;es.
Personnalisations majeures
1)
2)
3)
4)
Ouvrez le Bloc-notes.
Ouvrez l'ancien fichier sous C:\Program Files\Adobe\Adobe RoboHelp
[version]\RoboHTML\Language.
Ouvrez le nouveau fichier dans une fen&ecirc;tre distincte sous \Language.
Copiez les personnalisations de l'ancien fichier vers le nouveau. Consultez le tableau pour les noms
de fichier.
Description du fichier
Noms de fichier avant 7
Noms de fichier 7
Liste d'expressions
Phrases.wlf
NomProjet.phr
Liste Ignorer toujours
AlwaysIgn.wlf
NomProjet.ign
Liste d'exclusion
*.stp
NomProjet.stp
Fichier de langue
*.lng
NomProjet.lng
REMARQUE : La proc&eacute;dure ci-dessus n'est PAS la m&eacute;thode recommand&eacute;e. La m&eacute;thode recommand&eacute;e
est d&eacute;crite dans la section Modification des param&egrave;tres du projet.
3.4.
Importation de fichiers PDF
Vous pouvez convertir un fichier PDF Adobe (version 1.4 ou ult&eacute;rieure) en une rubrique unique ou en
plusieurs rubriques pour un projet nouveau ou existant.
•
Il est impossible d'importer des fichiers SWF, porte-documents PDF et fichiers PDF chiffr&eacute;s (fichiers
n&eacute;cessitant un mot de passe).
•
Si le fichier PDF contient des images 3D, enregistrez-le dans la version 5 afin d'importer les images.
•
Les tables des mati&egrave;res ou les codes de champs d'index sont convertis au format PDF.
•
•
Il n'est pas n&eacute;cessaire d'avoir Adobe Reader&reg; ou Adobe Acrobat&reg; pour importer des fichiers PDF.
Les polices ne sont pas toujours correctement converties dans les fichiers PDF import&eacute;s dans un
fichier HTML.
61
CHAPITRE 3
IMPORTATION DE FICHIERS PDF
PROJETS
Cr&eacute;ation d'un projet par importation de fichier PDF
REMARQUE : Vous ne pouvez pas importer les fichiers PDF prot&eacute;g&eacute;s par un mot de passe.
1)
2)
3)
4)
5)
S&eacute;lectionnez Fichier &gt; Nouveau projet.
Cliquez sur l'onglet Importer. S&eacute;lectionnez Document PDF et cliquez sur OK.
Cliquez sur le bouton Parcourir pour s&eacute;lectionner un ou plusieurs fichiers .mif r&eacute;sidant dans le
m&ecirc;me dossier. Cliquez sur Ouvrir, puis sur Suivant.
Saisissez les informations relatives au projet. Cliquez sur Suivant.
Dans la bo&icirc;te de dialogue Options de conversion, s&eacute;lectionnez les options.
Rubrique
S&eacute;lectionnez le mode de division du PDF en rubriques.
Cr&eacute;er des rubriques bas&eacute;es sur des styles
Active le bouton Suivant. Cliquez dessus pour s&eacute;lectionner des styles.
Cr&eacute;er une seule rubrique
Cr&eacute;e une rubrique &agrave; partir du PDF complet.
Cr&eacute;er une rubrique pour chaque page PDF
Choisissez des options suppl&eacute;mentaires.
Convertir en HTML
Cr&eacute;e une rubrique pour chaque page PDF.
Convertir en image
Affiche chaque page PDF sous forme d'une image distincte.
Convertir en HTML positionn&eacute; absolument (avanc&eacute;)
Cr&eacute;e une rubrique pour chaque page PDF. Le positionnement du contenu peut n&eacute;cessiter le HTML
avanc&eacute; et l'&eacute;dition ult&eacute;rieure peut s'av&eacute;rer difficile. Utilisez cette option si les autres ne produisent
pas les r&eacute;sultats que vous souhaitez. Cette option n'est pas recommand&eacute;e pour la documentation
imprim&eacute;e.
Image (JPG/GIF/PNG)
S&eacute;lectionnez le format des images converties &agrave; partir du PDF. Pour exclure les images, s&eacute;lectionnez
Aucun.
S&eacute;lection de pages
Par d&eacute;faut, toutes les pages d'un PDF sont converties. Vous pouvez &eacute;galement saisir les num&eacute;ros de
page de d&eacute;but et de fin de la s&eacute;lection.
62
CHAPITRE 3
IMPORTATION DE FICHIERS PDF
PROJETS
Cr&eacute;ation de rubriques bas&eacute;es sur des styles
Les styles sont convertis en fonction des &eacute;l&eacute;ments ci-dessous.
•
Le style le plus r&eacute;pandu devient le style Normal, qui ne peut pas servir &agrave; la division de rubriques.
•
Les styles restants sont class&eacute;s du plus grand au plus petit. Le classement des styles tient &eacute;galement
compte de l'affichage en gras (priorit&eacute; la plus &eacute;lev&eacute;e), en italique ou normal (priorit&eacute; la plus basse).
•
Les styles sont class&eacute;s et num&eacute;rot&eacute;s en commen&ccedil;ant par &laquo; En-t&ecirc;te 1 &raquo; pour le style d'en-t&ecirc;te
dominant, puis &laquo; PdfParaStyle01 &raquo; jusqu'&agrave; &laquo; PdfParaStyleX &raquo; pour le reste des styles. Cette bo&icirc;te de
dialogue permet de renommer ces styles.
Cr&eacute;er des rubriques bas&eacute;es sur
R&eacute;pertorie les styles utilis&eacute;s dans le document PDF.
REMARQUE : RoboHelp divise les documents en rubriques &agrave; l'aide des styles de sp&eacute;cifi&eacute;s. Le texte de style
est inclus par d&eacute;faut dans le nom du fichier de la rubrique cr&eacute;&eacute;e. Tous les caract&egrave;res non ASCII dans les
noms de fichier de rubrique sont automatiquement convertis en caract&egrave;res ASCII.
Description
Affiche une description du style s&eacute;lectionn&eacute;.
Aper&ccedil;u paragraphe
Affiche un aper&ccedil;u du style s&eacute;lectionn&eacute;.
Renommer le style
Permet de renommer le style s&eacute;lectionn&eacute; dans votre projet.
Terminer
Permet de terminer le processus d'importation.
Retour
Permet de revenir &agrave; la bo&icirc;te de dialogue Options de conversion.
Importation de fichiers PDF dans un projet
1)
2)
3)
4)
5)
6)
7)
Dans le gestionnaire de projets, cliquez avec le bouton droit de la souris sur Fichiers de projet.
S&eacute;lectionnez le fichier de destination de l'importation.
S&eacute;lectionnez Projet &gt; Importer &gt; Document PDF.
S&eacute;lectionnez un ou plusieurs fichiers PDF. Cliquez sur Ouvrir.
Dans la bo&icirc;te de dialogue Options de conversion, s&eacute;lectionnez Options.
Si l'option Cr&eacute;er des rubriques bas&eacute;es sur des styles a &eacute;t&eacute; s&eacute;lectionn&eacute;e, cliquez sur Suivant pour
s&eacute;lectionner les styles.
Cliquez sur Terminer.
63
IMPORTATION ET LIAISON DE DOCUMENTS WORD ET FRAMEMAKER
PROJETS
CHAPITRE 3
3.5.
Importation et liaison de documents Word et FrameMaker
Vous pouvez importer des documents Microsoft Word et Adobe FrameMaker dans vos projets RoboHelp.
LIENS CONNEXES :
Importation de documents FrameMaker
Balises HTML personnalis&eacute;es
3.6.
Importation et liaison de documents Microsoft Word
Dans RoboHelp, vous pouvez importer ou lier des documents Microsoft Word (extensions de fichier
.docx, .docm, .doc ou .rtf &agrave; la suite du nom du fichier). Vous pouvez cr&eacute;er de nouveaux projets en
important et en liant des documents Word. Il vous est &eacute;galement possible d'utiliser les documents Word
comme fichiers source pour un projet RoboHelp existant. Vous pouvez utiliser ce processus pour int&eacute;grer
le contenu cr&eacute;&eacute; par diff&eacute;rents auteurs dans Word.
Les param&egrave;tres pour l'importation et la liaison de documents Word sont appliqu&eacute;s au niveau du projet.
Pour cette raison, vos param&egrave;tres sont coh&eacute;rents pour tous les documents que vous importez ou liez aux
projets RoboHelp. Vous pouvez &eacute;galement exporter les param&egrave;tres de conversion que vous d&eacute;finissez et
les r&eacute;utiliser dans plusieurs projets. La d&eacute;finition d'un ensemble de param&egrave;tres standard pour la
conversion garantit la coh&eacute;rence entre les projets. Voir Param&egrave;tres de conversion de Word.
Etapes pour importer un document Word dans RoboHelp
1)
2)
3)
4)
5)
6)
Localisez votre document Word.
Optimisez le document Word pour l'importation. Voir Optimisation des documents Word pour les
sorties en ligne.
Parcourez les diff&eacute;rences entre la liaison et l'importation du document Word. Voir Cr&eacute;ation de liens
par rapport &agrave; l'importation de documents Word.
Ouvrez RoboHelp et cr&eacute;ez un projet ou utilisez un projet existant pour importer le document Word.
Importez le document Word. Voir Importation d'un document Word dans un projet RoboHelp.
Exportez vos param&egrave;tres de conversion et r&eacute;utilisez-les lorsque vous importez un autre document
Word. Voir Exportation des param&egrave;tres de conversion.
Etapes pour lier un document Word &agrave; partir de RoboHelp
1)
2)
3)
4)
Localisez votre document Word.
Optimisez le document Word pour la liaison. Voir Optimisation des documents Word pour les sorties
en ligne.
Parcourez les diff&eacute;rences entre la liaison et l'importation du document Word. Voir Cr&eacute;ation de liens
par rapport &agrave; l'importation de documents Word.
Parcourez toutes les options de liaison de documents Word. Voir Cr&eacute;ation de liens dans les options
des documents Word.
64
IMPORTATION ET LIAISON DE DOCUMENTS MICROSOFT WORD
PROJETS
CHAPITRE 3
5)
6)
7)
8)
Ouvrez RoboHelp et cr&eacute;ez un projet ou utilisez un projet existant pour lier le document Word.
Liez le document Word. Voir Liaison d'un document Word &agrave; un projet RoboHelp.
Synchronisez votre document Word li&eacute; avec RoboHelp lorsque vous modifiez votre document Word.
Voir Synchronisation des documents Word li&eacute;s avec des projets RoboHelp.
Exportez vos param&egrave;tres de conversion et r&eacute;utilisez-les lorsque vous liez un autre document Word.
Voir Exportation des param&egrave;tres de conversion.
Cr&eacute;ation de liens par rapport &agrave; l'importation de documents Word
Vous avez deux possibilit&eacute;s pour int&eacute;grer du contenu &agrave; partir de documents Word dans des projets
RoboHelp : la liaison et l'importation. Le tableau suivant r&eacute;pertorie les diff&eacute;rences entre les deux
m&eacute;thodes.
Option
Liaison
Importation
Remarques
Possibilit&eacute; de mettre &agrave;
jour les rubriques
g&eacute;n&eacute;r&eacute;es
Oui. Vous pouvez
mettre &agrave; jour les
rubriques g&eacute;n&eacute;r&eacute;es
chaque fois que le
document source ou
les param&egrave;tres de
votre projet RoboHelp
changent.
Non. Lorsque vous
importez un document
Word dans un projet
RoboHelp, RoboHelp
copie le contenu du
document Word dans
le projet RoboHelp.
RoboHelp g&eacute;n&egrave;re les
rubriques en fonction
des param&egrave;tres de
conversion. Si le document source change,
supprimez les
rubriques g&eacute;n&eacute;r&eacute;es et
r&eacute;importez le document Word.
Utilisez l'option de liaison lorsque le document Word source
peut &ecirc;tre modifi&eacute;. Normalement, si plusieurs
projets partagent le
m&ecirc;me document
Word, liez le document Word.
En revanche, si vous
transf&eacute;rez du contenu
au cours d'une activit&eacute;
ponctuelle, vous pouvez utiliser l'option
d'importation.
Possibilit&eacute; de mettre &agrave;
jour automatiquement
les modifications
apport&eacute;es &agrave; la table
des mati&egrave;res, &agrave; l'index
et au glossaire depuis
le document source
Oui. Lorsque vous liez
un document, des
fichiers de table des
mati&egrave;res, d'index et de
glossaire distincts sont
cr&eacute;&eacute;s et associ&eacute;s au
document Word li&eacute;.
Lorsque le document
Word li&eacute; est mis &agrave; jour,
les fichiers li&eacute;s de table
des mati&egrave;res, d'index
et de glossaire sont
&eacute;galement mis &agrave; jour.
Non. Lorsque vous
importez un document
Word, la table des
mati&egrave;res g&eacute;n&eacute;r&eacute;e est
ajout&eacute;e, et l'index et le
glossaire sont fusionn&eacute;s dans le fichier de
table des mati&egrave;res,
d'index et de glossaire
s&eacute;lectionn&eacute;.
Utilisez l'option de liaison si vous souhaitez
mettre &agrave; jour automatiquement la table des
mati&egrave;res, l'index et le
glossaire lorsque ces
composants sont mis &agrave;
jour dans le document
Word.
65
IMPORTATION ET LIAISON DE DOCUMENTS MICROSOFT WORD
PROJETS
CHAPITRE 3
Option
Liaison
Importation
Remarques
Possibilit&eacute; de r&eacute;g&eacute;n&eacute;rer les rubriques supprim&eacute;es
Oui. Vous pouvez supprimer une rubrique
g&eacute;n&eacute;r&eacute;e &agrave; partir d'un
document Word
import&eacute;, puis r&eacute;g&eacute;n&eacute;rer la m&ecirc;me rubrique
lorsque vous mettez &agrave;
jour le document
Word.
Non. Importez de nouveau le document
source pour g&eacute;n&eacute;rer la
rubrique supprim&eacute;e.
Utilisez l'option de liaison lorsque vous partagez le document
source sur plusieurs
projets.
Possibilit&eacute; de conserver les modifications
dans des rubriques
g&eacute;n&eacute;r&eacute;es
Oui. Vous pouvez marquer des rubriques
g&eacute;n&eacute;r&eacute;es &agrave; partir d'un
document Word li&eacute;
pour vous assurer que
les rubriques marqu&eacute;es
ne sont pas mises &agrave;
jour lors de la mise &agrave;
jour du document li&eacute;.
De cette mani&egrave;re, vous
pouvez conserver
toutes les modifications que vous avez
apport&eacute;es dans
RoboHelp.
Non. Lorsque vous
r&eacute;importez un document Word, toutes les
rubriques g&eacute;n&eacute;r&eacute;es
pr&eacute;c&eacute;demment &agrave; partir du document
import&eacute; sont recr&eacute;&eacute;es,
ce qui remplace les
modifications que vous
avez effectu&eacute;es dans
RoboHelp.
Utilisez l'option de liaison si vous devez
conserver les mises &agrave;
jour apport&eacute;es &agrave; la fois
au document Word li&eacute;
et aux rubriques g&eacute;n&eacute;r&eacute;es.
Possibilit&eacute; de modifier
les noms de fichier et
les titres de rubrique
des fichiers g&eacute;n&eacute;r&eacute;s
depuis le gestionnaire
de projets
Non. Lorsque vous liez
un document Word,
vous ne pouvez pas
modifier les noms de
fichier ni les titres de
rubrique des fichiers
g&eacute;n&eacute;r&eacute;s depuis le gestionnaire de projets.
Oui. Lorsque vous
importez un document
Word, vous pouvez
modifier les noms de
fichier ou les titres de
rubrique des fichiers
g&eacute;n&eacute;r&eacute;s.
Utilisez l'option
d'importation si vous
souhaitez personnaliser les noms de fichier
et les titres de rubrique
depuis le gestionnaire
de projets.
66
CHAPITRE 3
IMPORTATION ET LIAISON DE DOCUMENTS MICROSOFT WORD
PROJETS
Optimisation des documents Word pour les sorties en ligne
Si vous importez des documents Word ayant &eacute;t&eacute; publi&eacute;s dans un format imprim&eacute; ou en ligne, prenez
connaissance de ce qui suit avant de les lier ou de les importer dans des projets.
Hi&eacute;rarchies d'en-t&ecirc;tes
D&eacute;terminez le meilleur mappage des styles d'en-t&ecirc;te Word aux styles RoboHelp afin de pouvoir
obtenir une pagination automatique (division du document en rubriques) bas&eacute;e sur des styles
d'en-t&ecirc;te. Si votre document n'emploie pas de styles d'en-t&ecirc;te hi&eacute;rarchiques, appliquez-les avant la
conversion. Par exemple, vous pouvez appliquer le style En-t&ecirc;te 1 aux articles autonomes de votre
document Word. Mappez ensuite ce style avec un style RoboHelp similaire et d&eacute;finissez la
pagination pour cr&eacute;er une rubrique HTML pour chaque style En-t&ecirc;te 1. Voir Pagination et
d&eacute;signation des rubriques dans les fichiers Word convertis.
Styles en ligne et remplacement des styles
Vous pouvez convertir les styles en ligne en styles CSS dans RoboHelp. Toutefois, la conversion des
styles en ligne en styles CSS peut se traduire par une profusion de styles partageant le m&ecirc;me
formatage. Voir Conversion de styles Word en styles RoboHelp.
Informations sur les en-t&ecirc;tes et pieds de page
RoboHelp peut convertir les en-t&ecirc;tes et pieds de page. Toutefois, afin de garantir la coh&eacute;rence parmi
vos rubriques, vous pouvez d&eacute;finir une page principale contenant les informations d'en-t&ecirc;te et de
pied de page requises. l'utilisation de pages principales permet &eacute;galement de supprimer les
num&eacute;ros de page dans les en-t&ecirc;tes et les pieds de page. Conversion d'en-t&ecirc;tes et de pieds de page
dans des documents Word.
Chapitres et rubriques
Dans la documentation imprim&eacute;e, le chapitre et l'unit&eacute; logique et physique pour le regroupement
du contenu. Dans l'aide en ligne, l'unit&eacute; organisationnelle est la rubrique et les utilisateurs peuvent
consulter une rubrique apr&egrave;s l'autre. Bien qu'il soit possible de grouper le contenu dans des
dossiers qui s'ouvrent lorsque l'utilisateur navigue dans la table des mati&egrave;res, l'&eacute;cran n'affiche
qu'une seule rubrique &agrave; la fois. Essayez de fournir des informations compl&egrave;tes sans redondance en
regroupant des rubriques associ&eacute;es. Voir Pagination et d&eacute;signation des rubriques dans les fichiers
Word convertis.
Tables des mati&egrave;res
Lorsque vous importez des documents Word, vous pouvez &eacute;galement importer la table des mati&egrave;res
de Word dans la table des mati&egrave;res de RoboHelp. Vous pouvez d&eacute;finir la hi&eacute;rarchie des rubriques et
la repr&eacute;senter dans la table des mati&egrave;res de RoboHelp. Voir Importation d'une table des mati&egrave;res,
d'un index et d'un glossaire Word.
67
CHAPITRE 3
IMPORTATION ET LIAISON DE DOCUMENTS MICROSOFT WORD
PROJETS
Contextualit&eacute;
Dans les formats d'aide en ligne, vous pouvez lier des rubriques sp&eacute;cifiques &agrave; des bo&icirc;tes de dialogue
et &agrave; d'autres &eacute;l&eacute;ments que les utilisateurs rencontrent dans l'application. Vous pouvez attribuer des
ID de mappage &agrave; des rubriques dans RoboHelp. Toutefois, vous pouvez &eacute;galement attribuer des
marqueurs d'aide contextuelle dans des documents Word en utilisant des entr&eacute;es de note de bas
de page personnalis&eacute;es. RoboHelp lit ces entr&eacute;es de note de bas de page et attribue les ID de
mappage aux rubriques g&eacute;n&eacute;r&eacute;es. Assurez-vous que les rubriques du document Word source ne
sont pas trop fragment&eacute;es. Une rubrique doit contenir des informations suffisantes pour &ecirc;tre
significative en tant qu'unit&eacute; autonome.
Par exemple, si une t&acirc;che courte est incoh&eacute;rente sans une introduction apportant certaines
informations conceptuelles, ne l'affichez pas en tant que rubrique autonome. Pour &eacute;viter le contenu
trop fragment&eacute;, attribuez des marqueurs d'aide contextuelle aux rubriques &agrave; un niveau sup&eacute;rieur.
De cette mani&egrave;re, la rubrique d'aide g&eacute;n&eacute;r&eacute;e peut contenir le concept, la t&acirc;che et les images
concern&eacute;es. Voir Conversion des marqueurs d'aide contextuelle dans Word en ID de mappage.
Cr&eacute;ation de liens dans les options des documents Word
Pour lier des documents Word &agrave; un projet RoboHelp, vous pouvez sp&eacute;cifier l'une des options suivantes
dans l'onglet Importer des param&egrave;tres du projet (Projet &gt; Param&egrave;tres du projet) :
Cr&eacute;er une r&eacute;f&eacute;rence
Vous cr&eacute;ez une r&eacute;f&eacute;rence vers un document Word externe. Dans ce cas, le document Word source
n'est pas copi&eacute; dans le dossier du projet RoboHelp. Il reste en dehors du projet. Vous pouvez &eacute;diter
et mettre &agrave; jour le document Word de fa&ccedil;on ind&eacute;pendante dans Word. Par la suite, dans RoboHelp,
vous pouvez mettre &agrave; jour les rubriques g&eacute;n&eacute;r&eacute;es &agrave; partir du document li&eacute;.
Utilisez l'option de liaison par r&eacute;f&eacute;rence pour transf&eacute;rer le contenu partag&eacute; dans plusieurs projets.
Du fait qu'il n'existe qu'une copie du document, toute modification du document source se refl&egrave;te
dans tous les projets auxquels ce document est li&eacute;.
Cr&eacute;er une copie et un lien
Vous cr&eacute;ez une copie du document source et la liez au projet RoboHelp. Dans ce cas, une copie du
document source est copi&eacute;e dans le projet RoboHelp et est visible dans le conteneur Gestionnaire
de projets. Vous pouvez &eacute;diter et mettre &agrave; jour la copie Word sans affecter le document source.
Vous mettez &agrave; jour les rubriques g&eacute;n&eacute;r&eacute;es &agrave; partir du document Word copi&eacute; chaque fois que vous
&eacute;ditez le document.
Utilisez l'option Cr&eacute;er une copie avec liaison pour ne pas modifier le document Word dans
RoboHelp et restreindre l'acc&egrave;s au document source en n'autorisant la modification que de la copie
disponible dans le projet RoboHelp. Par exemple, si vous souhaitez transf&eacute;rer du contenu &agrave; partir
d'un document Word statique, liez le document en le copiant dans le projet RoboHelp.
REMARQUE : Cette option n'est disponible que lorsque vous liez des documents Word. Lorsque vous
importez un document Word, RoboHelp ne conserve aucun lien vers le document Word source.
68
CHAPITRE 3
IMPORTATION ET LIAISON DE DOCUMENTS MICROSOFT WORD
PROJETS
Liaison et importation de documents Word
•
•
•
Cr&eacute;ez un projet RoboHelp en liant ou en important un document Word. Vous pouvez importer des
fichiers DOCX, DOC, DOCM ou RTF.
Liez ou importez des documents Word dans un projet RoboHelp.
(Pour les documents li&eacute;s) Mettez &agrave; jour les rubriques g&eacute;n&eacute;r&eacute;es chaque fois que les param&egrave;tres de
conversion ou les documents source changent.
Les fichiers HTML ne sont pas cr&eacute;&eacute;s tant que vous n'avez pas d&eacute;fini les param&egrave;tres de conversion et
g&eacute;n&eacute;r&eacute; les rubriques d'aide. Les documents Word source ne sont pas affect&eacute;s par la liaison et l'&eacute;dition
ult&eacute;rieure. RoboHelp cr&eacute;e une copie des documents Word li&eacute;s ou import&eacute;s avant d'appliquer les
param&egrave;tres de conversion.
Cr&eacute;ation d'un projet par importation d'un document Word
Vous pouvez cr&eacute;er un projet RoboHelp en important un document Word. Pour importer des fichiers
Word, l'application Microsoft Word doit &ecirc;tre install&eacute;e sur votre ordinateur.
REMARQUE : Les formats DOCX et DOCM ne sont pas pris en charge par les versions ant&eacute;rieures &agrave; Microsoft
Word 2007. Voir l'aide de Microsoft Word pour plus d'informations.
1) Dans le conteneur D&eacute;marrage, cliquez sur Document Word sous Importer.
2) S&eacute;lectionnez Documents Word dans le menu Fichiers de type, s&eacute;lectionnez le document Word, puis
cliquez sur Ouvrir.
3) Saisissez les informations pertinentes dans l'assistant de cr&eacute;ation de nouveau projet et cliquez sur
Terminer.
Liaison d'un document Word &agrave; un projet RoboHelp
1)
2)
3)
4)
5)
Cr&eacute;ez un projet dans RoboHelp.
S&eacute;lectionnez Projet &gt; Lien &gt; Fichier Word.
Cliquez sur Parcourir pour s&eacute;lectionner un ou plusieurs documents Word et cliquez sur Ouvrir.
REMARQUE : Pour importer plusieurs documents avec des tables des mati&egrave;res distinctes,
s&eacute;lectionnez-les dans l'ordre dans lequel ils doivent s'afficher dans la table des mati&egrave;res principale.
Cliquez avec le bouton droit de la souris sur le fichier li&eacute; dans le gestionnaire de projets et
s&eacute;lectionnez Propri&eacute;t&eacute;s.
Dans la bo&icirc;te de dialogue Param&egrave;tres des documents Word, effectuez les op&eacute;rations suivantes :
–
Pour g&eacute;n&eacute;rer une table des mati&egrave;res depuis le document source, s&eacute;lectionnez l'option
Convertir la table des mati&egrave;res et indiquez un nom de fichier.
–
Pour g&eacute;n&eacute;rer un index depuis le document source, s&eacute;lectionnez l'option Convertir l'index et
indiquez un nom de fichier.
–
Pour g&eacute;n&eacute;rer un glossaire depuis le document source, s&eacute;lectionnez l'option Convertir le
glossaire et indiquez un nom de fichier.
REMARQUE : Vous pouvez d&eacute;finir les styles de paragraphe d'un terme de glossaire et de sa
d&eacute;finition dans les param&egrave;tres du projet. Voir Conversion de styles de paragraphe Word en
styles RoboHelp.
69
CHAPITRE 3
IMPORTATION ET LIAISON DE DOCUMENTS MICROSOFT WORD
PROJETS
REMARQUE : RoboHelp associe les fichiers g&eacute;n&eacute;r&eacute;s de table des mati&egrave;res, d'index et de glossaire au
6)
document Word source. Par cons&eacute;quent, lors de la mise &agrave; jour du document source, les fichiers de
table des mati&egrave;res, d'index et de glossaire sont &eacute;galement mis &agrave; jour.
Cliquez sur OK.
Importation d'un document Word dans un projet RoboHelp
1)
2)
3)
4)
5)
6)
7)
8)
Cr&eacute;ez un projet dans RoboHelp.
S&eacute;lectionnez Projet &gt; Importer &gt; Document Word.
Cliquez sur Parcourir pour s&eacute;lectionner un ou plusieurs documents Word et cliquez sur Ouvrir.
REMARQUE : Pour importer plusieurs documents avec des tables des mati&egrave;res distinctes,
s&eacute;lectionnez-les dans l'ordre dans lequel ils doivent s'afficher dans la table des mati&egrave;res principale.
Dans la bo&icirc;te de dialogue, d&eacute;finissez les options de conversion pour la table des mati&egrave;res, l'index et
le glossaire, puis cliquez sur Suivant.
Pour plus d'informations sur les diff&eacute;rentes options de conversion, voir Importation d'une table des
mati&egrave;res, d'un index et d'un glossaire Word.
(Facultatif) pour modifier les param&egrave;tres de conversion, cliquez sur Modifier.
Cochez la case Importer le max et indiquez le nombre de pieds de page et d'en-t&ecirc;tes diff&eacute;rents &agrave;
importer &agrave; partir du document MS Word.
REMARQUE : De nouvelles pages principales sont cr&eacute;&eacute;es avec des en-t&ecirc;tes et des pieds de page du
document import&eacute; MS Word.
Modifiez les param&egrave;tres de conversion en fonction de vos besoins, puis cliquez sur OK.
Pour plus d'informations sur la conversion des en-t&ecirc;tes et des pieds de page, voir Conversion
d'en-t&ecirc;tes et de pieds de page dans des documents Word.
Pour plus d'informations sur la conversion des paragraphes, des caract&egrave;res et d'autres styles, voir
Conversion de styles Word en styles RoboHelp.
Cliquez sur Terminer.
Importation d'une table des mati&egrave;res, d'un index et d'un glossaire Word
Lorsque vous importez un document Word dans un projet RoboHelp, vous pouvez &eacute;galement importer la
table des mati&egrave;res. Importez la table des mati&egrave;res dans le projet RoboHelp pour conserver dans l'aide la
structure de navigation que vous avez d&eacute;finie dans votre document Word. Si vous importez une table des
mati&egrave;res g&eacute;n&eacute;r&eacute;e dans Word, le premier en-t&ecirc;te devient un livre. Les en-t&ecirc;tes de niveau inf&eacute;rieur
deviennent des pages (sauf s'il existe un livre &agrave; un niveau inf&eacute;rieur).
Pour importer plusieurs documents avec des tables des mati&egrave;res distinctes, s&eacute;lectionnez les documents
Word dans la bo&icirc;te de dialogue Ouvrir dans l'ordre dans lequel ils doivent s'afficher dans la table des
mati&egrave;res principale. La table des mati&egrave;res convertie est bas&eacute;e sur les codes de champ {TOC} du document
Word. V&eacute;rifiez les conditions suivantes :
•
Les en-t&ecirc;tes des livres principaux doivent pr&eacute;senter des en-t&ecirc;tes de niveau inf&eacute;rieur.
•
Les en-t&ecirc;tes des sous-livres doivent s'afficher sous les en-t&ecirc;tes principaux et pr&eacute;senter des en-t&ecirc;tes
de niveau inf&eacute;rieur.
•
Les en-t&ecirc;tes des livres principaux doivent pr&eacute;senter des en-t&ecirc;tes de niveau inf&eacute;rieur.
70
CHAPITRE 3
IMPORTATION ET LIAISON DE DOCUMENTS MICROSOFT WORD
PROJETS
Supposons que vous importiez un document avec plus de styles que n'en contient la table des mati&egrave;res,
par exemple les niveaux d'en-t&ecirc;te de 1 &agrave; 3, alors que la table des mati&egrave;res ne contient que les entr&eacute;es
d'en-t&ecirc;te 1 et 2. Pour que les styles En-t&ecirc;te 3 apparaissent dans la table des mati&egrave;res, int&eacute;grez En-t&ecirc;te 3
&agrave; la table des mati&egrave;res Word ou cr&eacute;ez automatiquement la table des mati&egrave;res dans RoboHelp.
Importation d'une table des mati&egrave;res Word
1)
2)
3)
S&eacute;lectionnez Projet &gt; Importer &gt; Document Word.
Dans la bo&icirc;te de dialogue Param&egrave;tres de la table des mati&egrave;res, s&eacute;lectionnez Convertir la table des
mati&egrave;res.
S&eacute;lectionnez l'une des options suivantes :
Ajouter &agrave; la table des mati&egrave;res existante
Ajoute les entr&eacute;es de la table des mati&egrave;res &agrave; une table des mati&egrave;res RoboHelp existant dans le
projet. S&eacute;lectionnez une table des mati&egrave;res RoboHelp existante dans la liste.
Cr&eacute;er une nouvelle table des mati&egrave;res associ&eacute;e
Saisissez le nom d'une nouvelle table des mati&egrave;res associ&eacute;e ajout&eacute;e au projet RoboHelp.
Importation des entr&eacute;es d'index Word
RoboHelp cr&eacute;e un index en fonction des marqueurs d'index d&eacute;finis dans le document import&eacute;.
1) S&eacute;lectionnez Projet &gt; Importer &gt; Document Word.
2) Dans la bo&icirc;te de dialogue Param&egrave;tres de la table des mati&egrave;res, s&eacute;lectionnez Convertir l'index, puis
l'une des options suivantes :
Ajouter &agrave; l'index existant
Ajoutez les entr&eacute;es de l'index Word &agrave; l'index RoboHelp existant du projet.
Cr&eacute;er un nouvel index associ&eacute;
Saisissez le nom d'un nouvel index associ&eacute; ajout&eacute; au projet RoboHelp.
Ajouter &agrave; la rubrique
Ajoutez les entr&eacute;es de l'index Word aux rubriques particuli&egrave;res dans lesquelles elles apparaissent.
Importation d'entr&eacute;es de glossaire Word
RoboHelp cr&eacute;e un glossaire &agrave; partir du document Word que vous importez, en fonction des styles de
paragraphe d&eacute;finis pour les termes de glossaire et leur d&eacute;finition dans les param&egrave;tres de projet.
REMARQUE : RoboHelp cr&eacute;e une entr&eacute;e de glossaire en recherchant un terme et sa d&eacute;finition dans les
styles sp&eacute;cifi&eacute;s dans le document Word. Les instances suivantes des styles de terme ou de d&eacute;finition sont
rejet&eacute;es.
1) S&eacute;lectionnez Projet &gt; Importer &gt; Document Word.
2) Dans la bo&icirc;te de dialogue Param&egrave;tres de la table des mati&egrave;res, s&eacute;lectionnez Convertir le glossaire,
puis l'une des options suivantes :
71
CHAPITRE 3
IMPORTATION ET LIAISON DE DOCUMENTS MICROSOFT WORD
PROJETS
Ajouter au glossaire existant
Ajoute les entr&eacute;es de glossaire Word au glossaire RoboHelp existant du projet.
Cr&eacute;er un nouveau glossaire associ&eacute;
Saisissez un nom pour le nouveau glossaire associ&eacute; qui est ajout&eacute; au projet RoboHelp.
Conversion d'en-t&ecirc;tes et de pieds de page dans des documents Word
Vous pouvez convertir les textes d'en-t&ecirc;te et de pied de page de vos documents Word en en-t&ecirc;tes et pieds
de page dans les rubriques HTML g&eacute;n&eacute;r&eacute;es.
REMARQUE : N'utilisez pas cette proc&eacute;dure si vos projets comportent des rubriques cr&eacute;&eacute;es &agrave; l'origine dans
RoboHelp et import&eacute;es ou li&eacute;es &eacute;galement &agrave; partir d'autres sources. Utilisez plut&ocirc;t la fonction des pages
principales dans RoboHelp. l'utilisation de pages principales permet de d&eacute;finir des mises en page
coh&eacute;rentes ainsi que des en-t&ecirc;tes et des pieds de page coh&eacute;rents.
1) S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet .
2) Dans l'onglet Importer de la bo&icirc;te de dialogue Param&egrave;tres du projet, cliquez sur Modifier sous
Document Word.
3) Dans la bo&icirc;te de dialogue Param&egrave;tres de conversion, s&eacute;lectionnez Autres param&egrave;tres, puis proc&eacute;dez
de la fa&ccedil;on suivante :
–
Pour convertir l'en-t&ecirc;te et le pied de page dans des documents Word, Convertir l'en-t&ecirc;te et le
pied de page.
Conversion de styles Word en styles RoboHelp
Vous pouvez s&eacute;lectionner la feuille de style en cascade (CSS) que RoboHelp utilise pour mapper les styles
Word en styles RoboHelp. RoboHelp enregistre tous les param&egrave;tres de conversion de style dans ce fichier
CSS. Par d&eacute;faut, RoboHelp utilise le fichier RHStyleMapping.css pour votre projet.
Vous pouvez &eacute;galement utiliser une feuille de style en cascade personnalis&eacute;e pour votre projet. Vous
pouvez modifier ult&eacute;rieurement les styles dans RoboHelp ou dans un &eacute;diteur externe de feuilles de style
en cascade, tel qu'Adobe Dreamweaver&reg;. Vous pouvez d&eacute;finir comment les styles Word sont convertis en
styles RoboHelp au niveau du projet. Toutes les d&eacute;finitions de style Word dans le document Word
s'affichent dans la bo&icirc;te de dialogue de mappage, qu'elles soient ou non utilis&eacute;es dans le document.
S&eacute;lection de la feuille de style en cascade pour le mappage de styles
1)
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez Projet &gt; Importer &gt; Document Word.
–
S&eacute;lectionnez Projet &gt; Lien &gt; Fichier Word.
–
S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet.
72
CHAPITRE 3
2)
IMPORTATION ET LIAISON DE DOCUMENTS MICROSOFT WORD
PROJETS
Dans l'onglet Importer de la bo&icirc;te de dialogue Param&egrave;tres du projet, proc&eacute;dez de l'une des fa&ccedil;ons
suivantes :
–
S&eacute;lectionnez le fichier CSS dans le menu CSS pour le mappage de styles. RoboHelp affiche la
liste des fichiers CSS contenus dans le dossier racine de votre projet dans laquelle vous pouvez
s&eacute;lectionner un fichier CSS.
–
S&eacute;lectionnez Parcourir CSS &agrave; partir du menu CSS pour le mappage de styles, puis s&eacute;lectionnez
le fichier CSS que vous souhaitez utiliser. Utilisez cette option pour sp&eacute;cifier une feuille de
style en cascade personnalis&eacute;e pour votre projet. Si vous s&eacute;lectionnez cette option, RoboHelp
copie le fichier CSS s&eacute;lectionn&eacute; dans le dossier racine de votre projet et l'utilise pour le
mappage de styles.
REMARQUE : Vous pouvez modifier le fichier CSS que vous souhaitez utiliser pour le mappage de style.
L'option Modifier avec vous permet de s&eacute;lectionner un &eacute;diteur &agrave; partir d'une liste pr&eacute;d&eacute;finie, qui inclut
Editeur CSS RoboHelp et d'autres &eacute;diteurs CSS enregistr&eacute;s.
Mappage automatique des styles
RoboHelp fournit une option rapide pour mapper les styles de paragraphe, de caract&egrave;re et de tableau des
fichiers Word aux styles correspondants dans la feuille CSS s&eacute;lectionn&eacute;e pour le mappage de styles. Les
noms des styles des fichiers Word et de la feuille CSS doivent &ecirc;tre les m&ecirc;mes afin que le mappage
automatique fonctionne correctement.
1) S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet.
2) Cliquez sur l'onglet Importer de la bo&icirc;te de dialogue Param&egrave;tres du projet.
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez le fichier CSS dans le menu CSS pour le mappage de styles.
–
Cliquez sur Ajouter, en regard du menu CSS pour la correspondance des styles, puis
s&eacute;lectionnez un fichier CSS.
Cette option permet de sp&eacute;cifier un fichier CSS personnalis&eacute; pour le projet. Lorsque vous
s&eacute;lectionnez cette option, RoboHelp copie le fichier CSS s&eacute;lectionn&eacute; vers le dossier &agrave; la racine
du projet, puis l'utilise pour la correspondance des styles.
3)
4)
5)
6)
Pour modifier les param&egrave;tres de conversion des documents Word, cliquez sur Modifier.
Dans l'onglet Paragraphe, s&eacute;lectionnez Mapper automatiquement les styles Paragraphe.
Dans l'onglet Caract&egrave;re, s&eacute;lectionnez Mapper automatiquement les styles Caract&egrave;re.
Dans l'onglet Tableau, s&eacute;lectionnez Mapper automatiquement les styles Tableau.
Conversion de styles de paragraphe Word en styles RoboHelp
Par d&eacute;faut, RoboHelp convertit tous les styles Word en CSS, conservant ainsi l'apparence et le
comportement des styles Word dans le projet RoboHelp. Pour assurer la coh&eacute;rence de vos projets Help
en ligne, vous pouvez mapper les styles Word avec les styles RoboHelp et les modifier.
Si les noms des styles dans la feuille de style s&eacute;lectionn&eacute;e pour le mappage de styles correspondent &agrave; des
noms de styles RoboHelp, suivez les &eacute;tapes d&eacute;crites dans Mappage automatique des styles.
73
CHAPITRE 3
IMPORTATION ET LIAISON DE DOCUMENTS MICROSOFT WORD
PROJETS
Pour mapper manuellement les styles, suivez ces &eacute;tapes :
1) Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez Projet &gt; Importer &gt; Document Word.
–
S&eacute;lectionnez Projet &gt; Lien &gt; Fichier Word .
–
S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet .
2)
3)
4)
5)
Dans l'onglet Importer de la bo&icirc;te de dialogue Param&egrave;tres du projet, cliquez sur Modifier sous
Document Word.
Dans la bo&icirc;te de dialogue Param&egrave;tres de conversion, s&eacute;lectionnez le style Word dans le groupe
Paragraphe.
Dans le menu contextuel Style RoboHelp, s&eacute;lectionnez le style RoboHelp que vous souhaitez
mapper avec le style Word. Pour conserver l'apparence du texte Word dans votre format d'aide en
ligne, s&eacute;lectionnez [Source].
S&eacute;lectionnez les propri&eacute;t&eacute;s du style Word s&eacute;lectionn&eacute;. Pour modifier le style RoboHelp s&eacute;lectionn&eacute;,
cliquez sur Modifier le style.
Pour marquer un style pour le glossaire
–
S&eacute;lectionnez Style de la d&eacute;finition du glossaire pour marquer le style devant &ecirc;tre envisag&eacute;
pour la d&eacute;finition du glossaire.
–
S&eacute;lectionnez du terme du glossaire pour marquer le style devant &ecirc;tre envisag&eacute; pour le terme
du glossaire.
REMARQUE : Utilisez le Style de d&eacute;finition du glossaire avec Style de terme du glossaire pour
obtenir une paire compl&egrave;te de d&eacute;finition de terme du glossaire. RoboHelp utilise les termes
marqu&eacute;s par les styles s&eacute;lectionn&eacute;s, pour cr&eacute;er un glossaire.
–
Pour configurer la pagination : s&eacute;lectionnez la pagination (Divis&eacute;e en rubriques bas&eacute;es sur ce
style) pour cr&eacute;er une rubrique d'aide &agrave; chaque occurrence du style de paragraphe Word
s&eacute;lectionn&eacute;. Par exemple, si vous s&eacute;lectionnez En-t&ecirc;te 1 et Pagination (divis&eacute;e en rubriques
sur base de ce style), RoboHelp commence une nouvelle rubrique &agrave; chaque instance de
l'En-t&ecirc;te 1. Pour plus d'informations sur la pagination, voir D&eacute;finition de la pagination des
rubriques d'aide en ligne.
–
Utilisation d'une balise HTML d&eacute;finie par l'utilisateur : s&eacute;lectionnez ou saisissez une balise
HTML d&eacute;finie par l'utilisateur pour le style de paragraphe s&eacute;lectionn&eacute;.
Par exemple :
Un paragraphe avec un style ParaStyleOne est import&eacute; dans RoboHelp comme &lt;p
class=ParaStyleOne&gt; Texte du paragraphe &lt;/p&gt;.
En sp&eacute;cifiant cette cha&icirc;ne comme Pre pour le style ParaStyleOne, RoboHelp importe les
paragraphes avec le style ParaStyleOne comme &lt;pre&gt; Texte du paragraphe &lt;/pre&gt;.
Conversion de styles de caract&egrave;re Word en styles RoboHelp
Vous pouvez mapper les formats de caract&egrave;res Word avec les styles de caract&egrave;re de RoboHelp. Vous
pouvez &eacute;galement modifier les styles dans RoboHelp.
Si les noms des styles dans la feuille de style s&eacute;lectionn&eacute;e pour le mappage de styles correspondent &agrave; des
noms de styles RoboHelp, suivez les &eacute;tapes d&eacute;crites dans Mappage automatique des styles.
74
CHAPITRE 3
IMPORTATION ET LIAISON DE DOCUMENTS MICROSOFT WORD
PROJETS
Pour mapper manuellement les styles, suivez ces &eacute;tapes :
1) Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez Projet &gt; Importer &gt; Document Word.
–
S&eacute;lectionnez Projet &gt; Lien &gt; Fichier Word .
–
S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet .
2)
3)
4)
5)
Dans l'onglet Importer de la bo&icirc;te de dialogue Param&egrave;tres du projet, cliquez sur Modifier sous
Document Word.
Dans la bo&icirc;te de dialogue Param&egrave;tres de conversion, s&eacute;lectionnez le groupe Caract&egrave;re.
S&eacute;lectionnez le style de caract&egrave;re Word dans le volet gauche de la bo&icirc;te de dialogue Param&egrave;tres de
conversion.
S&eacute;lectionnez le style de caract&egrave;re RoboHelp dans le menu contextuel. (Facultatif) Vous pouvez
&eacute;galement proc&eacute;der comme suit :
–
Pour importer le style de caract&egrave;re Word, s&eacute;lectionnez [Source] dans le menu contextuel.
–
Pour modifier le style de caract&egrave;re dans RoboHelp, cliquez sur Modifier le style.
Mappage de liste
Vous pouvez mapper des listes Word avec des listes RoboHelp (listes multi-niveaux) ou des listes HTML
(listes tri&eacute;es ou non de base) dans RoboHelp. Si vous avez d&eacute;fini des listes en tant que styles de
paragraphe dans RoboHelp, vous pouvez mapper ces styles de liste dans RoboHelp. Si vous ne
s&eacute;lectionnez pas d'option de mappage de styles pour une liste, elle est convertie en texte sans propri&eacute;t&eacute;s
de liste.
1) Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez Projet &gt; Importer &gt; Document Word.
–
S&eacute;lectionnez Projet &gt; Lien &gt; Fichier Word .
–
S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet .
2)
3)
4)
Dans l'onglet Importer, cliquez sur Modifier sous Document Word.
Dans la bo&icirc;te de dialogue Param&egrave;tres de conversion, s&eacute;lectionnez le groupe Autres param&egrave;tres.
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Pour convertir les styles de liste Word en listes RoboHelp, s&eacute;lectionnez Liste RoboHelp dans le
menu contextuel Convertir une liste Word en.
–
Pour convertir les styles de liste Word en listes HTML, s&eacute;lectionnez Liste HTML dans le menu
contextuel Convertir une liste Word en.
75
CHAPITRE 3
IMPORTATION ET LIAISON DE DOCUMENTS MICROSOFT WORD
PROJETS
Cr&eacute;ation de balises HTML personnalis&eacute;es
Vous pouvez d&eacute;finir ou appliquer une balise HTML personnalis&eacute;e &agrave; la place de la balise &lt;p&gt; standard pour
les styles de paragraphe dans la sortie HTML correspondant aux formats que vous importez d'un
document Word. Vous pouvez d&eacute;finir des balises HTML distinctes pour chaque format du document
Word.
1) Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez Projet &gt; Importer &gt; Document Word.
–
S&eacute;lectionnez Projet &gt; Lien &gt; Fichier Word .
–
S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet .
2)
3)
4)
Dans l'onglet Importer, cliquez sur Modifier sous Document Word.
Dans la bo&icirc;te de dialogue Param&egrave;tres de conversion, s&eacute;lectionnez un style de paragraphe Word,
puis s&eacute;lectionnez l'option Balise HTML d&eacute;finie par l'utilisateur.
Tapez le nom de la balise HTML personnalis&eacute;e ou s&eacute;lectionnez une balise existante &agrave; utiliser &agrave; la
place de la balise HTML par d&eacute;faut.
Conversion de styles de tableau Word en styles de tableau RoboHelp
Vous pouvez mapper les styles de tableau Word avec les styles de tableau RoboHelp. Vous pouvez
&eacute;galement importer les styles de tableau en tant que formatage en ligne &agrave; partir du document Word.
Vous pouvez &eacute;galement modifier les styles de tableau convertis dans RoboHelp.
Si les noms des styles dans la feuille de style s&eacute;lectionn&eacute;e pour le mappage de styles correspondent &agrave; des
noms de styles RoboHelp, suivez les &eacute;tapes d&eacute;crites dans Mappage automatique des styles.
Pour mapper manuellement les styles, suivez ces &eacute;tapes :
1) Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez Projet &gt; Importer &gt; Document Word.
–
S&eacute;lectionnez Projet &gt; Lien &gt; Fichier Word .
–
S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet .
2)
3)
4)
Dans l'onglet Importer, cliquez sur Modifier sous Document Word.
S&eacute;lectionnez le style de tableau Word dans le volet gauche de la bo&icirc;te de dialogue Param&egrave;tres de
conversion.
S&eacute;lectionnez le style de tableau RoboHelp dans le menu contextuel. (Facultatif) Vous pouvez
&eacute;galement cliquer sur Modifier le style pour modifier le style de tableau dans RoboHelp.
Conversion de r&eacute;f&eacute;rences Word en liens hypertexte
RoboHelp peut convertir les r&eacute;f&eacute;rences crois&eacute;es dans les documents Word. Ces r&eacute;f&eacute;rences apparaissent
sous forme de liens hypertextes dans les rubriques d'aide g&eacute;n&eacute;r&eacute;es.
1) Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez Projet &gt; Importer &gt; Document Word.
–
S&eacute;lectionnez Projet &gt; Lien &gt; Fichier Word .
–
S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet .
76
CHAPITRE 3
2)
3)
IMPORTATION ET LIAISON DE DOCUMENTS MICROSOFT WORD
PROJETS
Dans l'onglet Importer, cliquez sur Modifier sous Document Word.
Dans le groupe Param&egrave;tres de conversion, s&eacute;lectionnez Autres param&egrave;tres, puis s&eacute;lectionnez
Convertir les r&eacute;f&eacute;rences en hyperliens.
Cr&eacute;ation de styles RoboHelp &agrave; partir du formatage en ligne
Bien qu'il soit recommand&eacute; d'&eacute;viter le formatage en ligne dans vos documents Word et d'appliquer des
styles d&eacute;finis de paragraphe et de caract&egrave;re, vous pouvez lier des documents Word &agrave; RoboHelp et les y
importer. Vous pouvez &eacute;galement cr&eacute;er des styles RoboHelp &agrave; partir du formatage en ligne dans vos
documents Word. Ces styles sont ajout&eacute;s au CSS du projet.
1) S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet .
2) Dans l'onglet Importer, cliquez sur Modifier sous Document Word.
3) Dans la bo&icirc;te de dialogue Param&egrave;tres de conversion, s&eacute;lectionnez Autres param&egrave;tres, puis
s&eacute;lectionnez Cr&eacute;er automatiquement des styles CSS &agrave; partir du formatage en ligne.
Pagination et d&eacute;signation des rubriques dans les fichiers Word convertis
En plus de diviser le document en rubriques et de d&eacute;finir les param&egrave;tres de d&eacute;signation des rubriques,
vous pouvez effectuer les op&eacute;rations suivantes :
Conversion d'en-t&ecirc;tes et de pieds de page
Le texte des en-t&ecirc;tes et des pieds de page de vos documents Word est converti et utilis&eacute; dans les
rubriques d'aide. Voir Conversion d'en-t&ecirc;tes et de pieds de page dans des documents Word.
Conversion de la table des mati&egrave;res et des entr&eacute;es d'index
La table des mati&egrave;res et les entr&eacute;es d'index du document Word sont converties dans votre projet
RoboHelp. Voir Importation d'une table des mati&egrave;res, d'un index et d'un glossaire Word.
Mappage des styles de liste Word aux styles RoboHelp
Vous pouvez convertir les styles de liste de Word en styles de liste RoboHelp ou HTML. Voir
Mappage de liste.
Cr&eacute;ation automatique de styles CSS &agrave; partir du formatage en ligne
Voir Cr&eacute;ation de styles RoboHelp &agrave; partir du formatage en ligne.
D&eacute;finition de la pagination des rubriques d'aide en ligne
Lorsque vous importez un document Word, vous d&eacute;finissez le mode d'affichage du fichier Word sous
forme de rubriques dans RoboHelp. Supposons par exemple que votre fichier Word contient dix
rubriques. Si chaque rubrique contient des sous-rubriques, des listes de d&eacute;finition, des t&acirc;ches et des
tableaux, chaque rubrique peut appara&icirc;tre sous la forme d'un fichier HTML distinct. Si chaque en-t&ecirc;te de
rubrique est dans le style En-t&ecirc;te 1, chaque rubrique En-t&ecirc;te 1 peut &ecirc;tre cr&eacute;&eacute;e en tant que rubrique
HTML distincte. En revanche, si vous d&eacute;finissez la pagination au format En-t&ecirc;te 2, des fichiers HTML
distincts sont cr&eacute;&eacute;s pour chaque rubrique En-t&ecirc;te 2.
77
CHAPITRE 3
IMPORTATION ET LIAISON DE DOCUMENTS MICROSOFT WORD
PROJETS
Vous pouvez s&eacute;lectionner plusieurs styles de paragraphe pour la pagination. Par exemple, si vous
s&eacute;lectionnez En-t&ecirc;te 1 et En-t&ecirc;te 2 pour la pagination, RoboHelp d&eacute;marre une nouvelle rubrique &agrave; chaque
instance d'En-t&ecirc;te 1 ainsi que d'En-t&ecirc;te 2.
REMARQUE : La pagination est bas&eacute;e sur les styles de paragraphes Word et non sur les styles RoboHelp. Le
texte du style de paragraphe Word est inclus par d&eacute;faut dans le nom du fichier de la rubrique HTML cr&eacute;&eacute;e.
Tous les caract&egrave;res non ASCII figurant dans le noms du fichier de la rubrique sont automatiquement
convertis en caract&egrave;res ASCII.
Bien que vous puissiez d&eacute;finir la pagination pour n'importe quel style de paragraphe Word, la rubrique
g&eacute;n&eacute;r&eacute;e doit contenir des informations pertinentes et compl&egrave;tes pour le lecteur. Par exemple, si vous
d&eacute;finissez la pagination pour En-t&ecirc;te 3, vous courez le risque de cr&eacute;er des rubriques avec seulement des
instructions au niveau de la t&acirc;che. Dans ce cas, les informations contextuelles requises pour terminer la
t&acirc;che sont isol&eacute;es dans une autre rubrique de niveau En-t&ecirc;te 3. Pour &eacute;viter que les rubriques soient ainsi
disjointes, d&eacute;finissez la pagination &agrave; un niveau sup&eacute;rieur.
1) Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez Projet &gt; Importer &gt; Document Word.
–
S&eacute;lectionnez Projet &gt; Lien &gt; Fichier Word .
–
S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet .
2)
3)
4)
Cliquez sur Modifier sous Document Word.
Dans la bo&icirc;te de dialogue Param&egrave;tres de conversion, dans le groupe Paragraphe, s&eacute;lectionnez le
style de paragraphe sur lequel baser la pagination.
S&eacute;lectionnez la pagination marqu&eacute;e option (divis&eacute;e en rubriques bas&eacute;es sur ce style) et cliquez sur
OK.
RoboHelp divise les documents en rubriques &agrave; l'aide des styles de pagination sp&eacute;cifi&eacute;s.
Conversion des marqueurs d'aide contextuelle dans Word en ID de mappage
Vous pouvez convertir les marqueurs d'aide contextuelle que vous ins&eacute;rez dans vos documents Microsoft
Word et les r&eacute;utiliser en tant qu'ID de mappage. Vous pouvez ins&eacute;rer les marqueurs d'aide contextuelle
en utilisant l'option Note de bas de page personnalis&eacute;e de Word. Vous pouvez ins&eacute;rer les marqueurs
d'aide contextuelle en utilisant la bo&icirc;te de dialogue Note de bas de page et Notes de fin de Word. Pour
ins&eacute;rer les marqueurs d'aide contextuelle, saisissez une cha&icirc;ne personnalis&eacute;e telle que AliasdeRubrique
et ins&eacute;rez l'ID de mappage comme texte du marqueur. La cha&icirc;ne personnalis&eacute;e ne doit pas contenir
d'espaces ou d'autres caract&egrave;res non valides. Voir Aide de Microsoft Word pour plus d'informations
concernant l'insertion des marqueurs de note de bas de page personnalis&eacute;e.
78
CHAPITRE 3
IMPORTATION ET LIAISON DE DOCUMENTS MICROSOFT WORD
PROJETS
Il arrive que des documents Word avec lesquels vous effectuez une liaison ou que vous importez aient
des marqueurs d'aide contextuelle. Dans ce cas, vous pouvez les incorporer dans le fichier d'en-t&ecirc;te d'ID
de mappage que vous g&eacute;n&eacute;rez. Dans le fichier d'en-t&ecirc;te du projet, ajoutez les ID de mappage que vous
avez attribu&eacute;s aux rubriques dans vos documents Word. La cha&icirc;ne du marqueur contextuel est un
param&egrave;tre &agrave; l'&eacute;chelle du projet. Assurez-vous que tous les documents Word que vous liez ou importez
contiennent la m&ecirc;me cha&icirc;ne que le texte du marqueur d'aide contextuelle.
1) Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez Projet &gt; Importer &gt; Document Word.
–
S&eacute;lectionnez Projet &gt; Lien &gt; Fichier Word .
–
S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet .
2)
3)
Cliquez sur Modifier sous Document Word.
Dans la bo&icirc;te de dialogue Param&egrave;tres de conversion, dans le groupe Autres param&egrave;tres, saisissez la
cha&icirc;ne du marqueur d'aide contextuel et cliquez sur OK.
D&eacute;finition du mod&egrave;le de nom pour les rubriques g&eacute;n&eacute;r&eacute;es
Lorsque vous d&eacute;finissez des styles d'en-t&ecirc;te pour la pagination, le texte d'en-t&ecirc;te est inclus par d&eacute;faut
dans le nom du fichier de la rubrique cr&eacute;&eacute; dans RoboHelp. Supposons par exemple que vous d&eacute;finissez
En-t&ecirc;te 2 pour la pagination. Si le document Word a deux rubriques En-t&ecirc;te 2, &laquo; Introduction &raquo; et
&laquo; Au-del&agrave; de l'essentiel &raquo;, les rubriques sont cr&eacute;&eacute;es sous forme de fichiers nomm&eacute;s introduction.htm et
Au-del&agrave;_de_l'essentiel.htm. Il en r&eacute;sulte des fichiers HTML nomm&eacute;s intuitivement qui indiquent le titre
de la rubrique. Outre ce sch&eacute;ma par d&eacute;faut, vous pouvez d&eacute;finir d'autres conventions d'affectation de
noms. En revanche, si le syst&egrave;me d'aide utilise des fichiers num&eacute;rot&eacute;s de fa&ccedil;on s&eacute;quentielle, par exemple
rubriqueaide001.html, rubriqueaide002.html, et ainsi de suite, vous pouvez d&eacute;finir le mod&egrave;le servant de
base &agrave; cette convention.
1) Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez Projet &gt; Importer &gt; Document Word.
–
S&eacute;lectionnez Projet &gt; Lien &gt; Fichier Word .
–
S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet .
2)
Dans la bo&icirc;te de dialogue Param&egrave;tres de conversion, s&eacute;lectionnez Autres param&egrave;tres.
79
IMPORTATION ET LIAISON DE DOCUMENTS MICROSOFT WORD
PROJETS
CHAPITRE 3
3)
Dans l'onglet Autres param&egrave;tres, d&eacute;finissez le mod&egrave;le de nom des rubriques.
Les rubriques sont nomm&eacute;es en fonction du mod&egrave;le s&eacute;lectionn&eacute;. Vous pouvez s&eacute;lectionner l'une des
m&eacute;thodes suivantes pour cr&eacute;er un mod&egrave;le de nom des rubriques.
Par d&eacute;faut
Utilise le texte du titre de rubrique comme nom de fichier de
rubrique.
&lt;$filename_no_ext&gt;-&lt;$paratext
&gt;
Le nom de la rubrique HTML convertie se compose des &eacute;l&eacute;ments
ci-dessous.
•
Nom du fichier Word source sans son extension
Trait d'union comme s&eacute;parateur
Texte du paragraphe utilis&eacute; pour d&eacute;limiter les rubriques HTML
Exemple : un fichier Word nomm&eacute; &laquo; Chapitre.doc &raquo; avec
&laquo; 1.Introduction &raquo; comme texte de paragraphe est converti en rubrique
HTML nomm&eacute;e &laquo; Chapitre-1.Introduction &raquo;.
&lt;$filename_no_ext&gt;-&lt;n&gt;
Le nom de la rubrique HTML convertie se compose des &eacute;l&eacute;ments
ci-dessous.
•
Nom du fichier Word source sans son extension
Trait d'union comme s&eacute;parateur
Num&eacute;ro s&eacute;quentiel
Exemple : &laquo; Chapitre.doc &raquo; est converti en rubrique HTML nomm&eacute;e
&laquo; Chapitre-1 &raquo;.
&lt;$paratext_no_num&gt;
Le nom de la rubrique HTML convertie contient le texte du paragraphe
utilis&eacute; pour d&eacute;limiter la rubrique HTML, sans num&eacute;rotation. Exemple :
un fichier avec &laquo; 1.Introduction &raquo; comme texte de paragraphe est
converti en rubrique HTML nomm&eacute;e &laquo; Introduction &raquo;.
&lt;$paratext&gt;
Le nom de la rubrique HTML convertie contient le texte du paragraphe
utilis&eacute; pour d&eacute;limiter la rubrique HTML. Exemple : un fichier avec
&laquo;Introduction &raquo; comme texte de paragraphe est converti en rubrique
HTML nomm&eacute;e &laquo; Introduction &raquo;.
Synchronisation des documents Word li&eacute;s avec des projets RoboHelp
Apr&egrave;s avoir import&eacute; ou li&eacute; des documents Word &agrave; votre projet RoboHelp, vous g&eacute;n&eacute;rez des rubriques d'aide
en fonction des param&egrave;tres du projet. Lorsque vous importez un document Word dans un projet RoboHelp, les
rubriques sont g&eacute;n&eacute;r&eacute;es imm&eacute;diatement et apparaissent dans le conteneur Gestionnaire de projets. En
revanche, lorsque vous liez un document Word &agrave; un projet RoboHelp, les rubriques ne sont pas g&eacute;n&eacute;r&eacute;es tant
que vous ne les g&eacute;n&eacute;rez pas de fa&ccedil;on explicite. Du fait que RoboHelp conserve un lien actif avec le document
Word li&eacute;, vous pouvez mettre &agrave; jour un document Word li&eacute; si le document source ou les param&egrave;tres de
conversion du projet RoboHelp changent. Les ic&ocirc;nes des fichiers de projet dans le conteneur Gestionnaire de
projets indiquent si les documents sont synchronis&eacute;s avec les rubriques RoboHelp.
80
IMPORTATION ET LIAISON DE DOCUMENTS MICROSOFT WORD
PROJETS
CHAPITRE 3
Mettez &agrave; jour les rubriques g&eacute;n&eacute;r&eacute;es &agrave; partir de documents Word li&eacute;s dans les situations suivantes :
•
Les documents Word source ont &eacute;t&eacute; modifi&eacute;s depuis que vous les avez ajout&eacute;s ou li&eacute;s au projet
RoboHelp.
•
Vous avez chang&eacute; les param&egrave;tres de pagination dans le projet RoboHelp.
•
Vous avez chang&eacute; les styles du projet RoboHelp et souhaitez les r&eacute;tablir tels qu'ils sont d&eacute;finis dans
le document FrameMaker.
•
Vous avez mis &agrave; jour la feuille de style en cascade dans le projet RoboHelp.
Si vous avez import&eacute; des documents dans le projet, le conteneur Gestionnaire de projets n'indique pas
l'&eacute;tat de synchronisation. Si les documents Word ou les param&egrave;tres de conversion changent, r&eacute;importez
les documents Word et remplacez les rubriques RoboHelp d&eacute;j&agrave; g&eacute;n&eacute;r&eacute;es. Si vous mettez &agrave; jour les
documents, RoboHelp met &agrave; jour les rubriques HTML, la table des mati&egrave;res, l'index et le glossaire
convertis.
Indicateurs d'&eacute;tat de la synchronisation de document Word
Le tableau suivant montre les diff&eacute;rents indicateurs d'&eacute;tat qui apparaissent sur le conteneur Gestionnaire
de projets dans RoboHelp pour tous les documents Word li&eacute;s.
Ic&ocirc;ne
Description
Le document Word source qui &eacute;tait li&eacute; par r&eacute;f&eacute;rence est manquant. Le document
source que vous avez li&eacute; au projet RoboHelp est d&eacute;plac&eacute; dans un autre dossier,
renomm&eacute; ou supprim&eacute;. Recherchez le document source et liez-le au nouvel
emplacement.
Le document Word source qui &eacute;tait li&eacute; par copie est manquant, renomm&eacute; ou d&eacute;plac&eacute;
dans un autre dossier. Localisez le document source et liez-le au nouvel emplacement.
Le document Word source qui &eacute;tait li&eacute; par r&eacute;f&eacute;rence est d&eacute;synchronis&eacute; du fait de
modifications dans le document source. Mettez &agrave; jour le document.
Le document Word source qui &eacute;tait li&eacute; par copie dans le projet est d&eacute;synchronis&eacute; du
fait de modifications dans le document source. Mettez &agrave; jour le document.
Le document Word source qui &eacute;tait li&eacute; par r&eacute;f&eacute;rence est d&eacute;synchronis&eacute; du fait de
modifications dans les param&egrave;tres de conversion RoboHelp. Mettez &agrave; jour le
document.
Le document Word source qui &eacute;tait li&eacute; par copie dans le projet est d&eacute;synchronis&eacute; du
fait de modifications dans les param&egrave;tres de conversion RoboHelp. Mettez &agrave; jour le
document.
Le document Word source qui &eacute;tait li&eacute; par r&eacute;f&eacute;rence et les rubriques g&eacute;n&eacute;r&eacute;es sont
synchronis&eacute;s.
Le document Word source qui &eacute;tait li&eacute; par copie dans le projet et les rubriques
g&eacute;n&eacute;r&eacute;es sont synchronis&eacute;s.
81
CHAPITRE 3
IMPORTATION ET LIAISON DE DOCUMENTS MICROSOFT WORD
PROJETS
G&eacute;n&eacute;ration de rubriques &agrave; partir de documents Word li&eacute;s
La g&eacute;n&eacute;ration de rubriques d'aide &agrave; partir de documents Word li&eacute;s est une activit&eacute; ponctuelle. Apr&egrave;s avoir
g&eacute;n&eacute;r&eacute; des rubriques d'aide, vous pouvez les mettre &agrave; jour chaque fois que le document source ou les
param&egrave;tres de conversion changent.
1) Cliquez avec le bouton droit de la souris sur le document Word li&eacute; du conteneur Gestionnaire de
projets, puis s&eacute;lectionnez Mettre &agrave; jour &gt; G&eacute;n&eacute;rer.
Mise &agrave; jour des rubriques g&eacute;n&eacute;r&eacute;es &agrave; partir de documents Word li&eacute;s
RoboHelp ne met pas automatiquement &agrave; jour les documents li&eacute;s lorsque vous liez des documents Word
&agrave; un projet RoboHelp. Vous d&eacute;finissez les param&egrave;tres de conversion, y compris le mappage de styles et la
pagination, puis g&eacute;n&eacute;rez les rubriques. S&eacute;lectionnez les options pour mettre &agrave; jour manuellement un
document li&eacute;.
1) Dans le conteneur Gestionnaire de projets, cliquez avec le bouton droit de la souris sur un
document Word, s&eacute;lectionnez Mettre &agrave; jour et s&eacute;lectionnez l'une des options suivantes :
G&eacute;n&eacute;rer
G&eacute;n&egrave;re pour la premi&egrave;re fois des rubriques HTML &agrave; partir du document Word li&eacute;. Apr&egrave;s la
g&eacute;n&eacute;ration des rubriques, l'option devient Mettre &agrave; jour.
Mettre &agrave; jour
Met &agrave; jour les rubriques g&eacute;n&eacute;r&eacute;es &agrave; partir du document Word s&eacute;lectionn&eacute;. Seules les rubriques
modifi&eacute;es sont mises &agrave; jour.
Tout mettre &agrave; jour
Met &agrave; jour toutes les rubriques g&eacute;n&eacute;r&eacute;es &agrave; partir de tous les documents li&eacute;s y compris tous les
documents Word et FrameMaker. Du fait que tous les documents sont mis &agrave; jour y compris ceux que
vous avez modifi&eacute;s dans RoboHelp, soyez prudent lorsque vous utilisez l'option Tout mettre &agrave; jour.
Forcer la mise &agrave; jour
Remplace l'ensemble actuel des rubriques g&eacute;n&eacute;r&eacute;es &agrave; partir du document Word s&eacute;lectionn&eacute;.
Utilisez cette option pour forcer la mise &agrave; jour des rubriques g&eacute;n&eacute;r&eacute;es &agrave; partir du document Word
li&eacute; apr&egrave;s avoir modifi&eacute; la source dans Microsoft Word. Cette option met &agrave; jour toutes les rubriques
y compris celles qui n'ont pas chang&eacute;.
Forcer la mise &agrave; jour de tous les &eacute;l&eacute;ments
Met &agrave; jour tous les documents li&eacute;s, y compris les documents Word et FrameMaker et remplace
toutes les rubriques g&eacute;n&eacute;r&eacute;es.
82
CHAPITRE 3
IMPORTATION ET LIAISON DE DOCUMENTS MICROSOFT WORD
PROJETS
Conservation des modifications d'une rubrique au cours d'une mise &agrave; jour
Normalement, lorsque vous mettez &agrave; jour un document li&eacute;, toutes les rubriques g&eacute;n&eacute;r&eacute;es &agrave; partir de
celui-ci sont mises &agrave; jour, en rempla&ccedil;ant les autres modifications que vous avez effectu&eacute;es dans les
rubriques g&eacute;n&eacute;r&eacute;es. Toutefois, vous pouvez conserver les modifications de fa&ccedil;on s&eacute;lective dans les
rubriques g&eacute;n&eacute;r&eacute;es pour conserver vos modifications.
1) A partir du conteneur Gestionnaire de projets, cliquez avec le bouton droit sur le document li&eacute;, puis
s&eacute;lectionnez Propri&eacute;t&eacute;s.
2) Dans la bo&icirc;te de dialogue Param&egrave;tres des documents Word, s&eacute;lectionnez l'onglet Param&egrave;tres de
mise &agrave; jour des fichiers.
3) Dans la colonne de gauche, s&eacute;lectionnez les fichiers dans lesquels vous voulez conserver les
modifications au cours de la mise &agrave; jour et cliquez sur OK.
D&eacute;finition d'une alerte lors de la modification de rubriques g&eacute;n&eacute;r&eacute;es
Vous pouvez d&eacute;finir RoboHelp pour &ecirc;tre alert&eacute; lorsque vous apportez des modifications &agrave; des rubriques
g&eacute;n&eacute;r&eacute;es &agrave; partir de documents li&eacute;s. Lorsque vous enregistrez des modifications apport&eacute;es &agrave; des
rubriques de ce type, RoboHelp vous informe que les changements seront perdus lors de la mise &agrave; jour
des documents li&eacute;s.
1) S&eacute;lectionnez Fichier &gt; Options.
2) Dans l'onglet G&eacute;n&eacute;ralit&eacute;s, s&eacute;lectionnez Afficher une alerte en cas de modification de rubriques
automatiquement g&eacute;n&eacute;r&eacute;es &agrave; partir de documents li&eacute;s, puis cliquez sur OK.
Marquage des modifications de rubriques pour leur conservation
Si vous avez activ&eacute; les alertes lors de l'enregistrement des modifications apport&eacute;es aux rubriques
g&eacute;n&eacute;r&eacute;es, vous pouvez marquer les modifications de rubrique pour qu'elles soient conserv&eacute;es pendant
une mise &agrave; jour. Les rubriques marqu&eacute;es pour que les modifications soient conserv&eacute;es pendant les mises
&agrave; jour sont ajout&eacute;es automatiquement &agrave; la liste des rubriques conserv&eacute;es dans la bo&icirc;te de dialogue
Param&egrave;tres de mise &agrave; jour des fichiers.
1) Modifiez une rubrique g&eacute;n&eacute;r&eacute;e et enregistrez les modifications.
2) Dans le message d'alerte qui appara&icirc;t, s&eacute;lectionnez Conserver les modifications apport&eacute;es &agrave; ce
fichier et cliquez sur OK.
Suppression d'une rubrique g&eacute;n&eacute;r&eacute;e
Lorsque vous supprimez une rubrique g&eacute;n&eacute;r&eacute;e, vous avez deux possibilit&eacute;s. Vous pouvez r&eacute;g&eacute;n&eacute;rer la
rubrique supprim&eacute;e lorsque vous mettez &agrave; jour le document Word li&eacute; ou retirer compl&egrave;tement la
rubrique supprim&eacute;e de votre projet. Par d&eacute;faut, RoboHelp r&eacute;g&eacute;n&egrave;re la rubrique supprim&eacute;e lorsque vous
mettez &agrave; jour le document Word.
1) Dans le conteneur Gestionnaire de projets, d&eacute;veloppez le document Word li&eacute; pour afficher les
rubriques g&eacute;n&eacute;r&eacute;es &agrave; partir de celui-ci.
2) Cliquez avec le bouton droit de la souris sur la rubrique que vous voulez supprimer et s&eacute;lectionnez
Supprimer.
83
CHAPITRE 3
3)
IMPORTATION ET LIAISON DE DOCUMENTS MICROSOFT WORD
PROJETS
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Cliquez sur OK pour supprimer d&eacute;finitivement la rubrique du projet. La rubrique supprim&eacute;e
n'est pas r&eacute;g&eacute;n&eacute;r&eacute;e lorsque vous mettez &agrave; jour le document Word.
–
S&eacute;lectionnez G&eacute;n&eacute;rer ce fichier &agrave; la prochaine mise &agrave; jour et cliquez sur OK pour supprimer la
rubrique. Lorsque vous mettez &agrave; jour le document Word, la rubrique supprim&eacute;e est
r&eacute;g&eacute;n&eacute;r&eacute;e.
R&eacute;g&eacute;n&eacute;ration d'une rubrique supprim&eacute;e
Si vous supprimez une rubrique g&eacute;n&eacute;r&eacute;e &agrave; partir d'un document Word, cette rubrique est supprim&eacute;e du
projet. Toutefois, vous pouvez r&eacute;g&eacute;n&eacute;rer des rubriques supprim&eacute;es d'un document li&eacute;.
1) Cliquez avec le bouton droit de la souris sur le document Word li&eacute; du conteneur Gestionnaire de
projets, puis s&eacute;lectionnez Propri&eacute;t&eacute;s.
2) Dans la bo&icirc;te de dialogue Param&egrave;tres des documents Word, s&eacute;lectionnez l'onglet Param&egrave;tres de
mise &agrave; jour des fichiers.
3) Dans la colonne de droite, s&eacute;lectionnez les fichiers supprim&eacute;s que vous voulez r&eacute;cup&eacute;rer et cliquez
sur OK.
4) Mettez &agrave; jour le document Word.
Modification d'un document Word li&eacute;
Vous pouvez modifier des documents Word li&eacute;s directement dans Microsoft Word.
1) Cliquez avec le bouton droit de la souris sur un document et s&eacute;lectionnez Modifier.
2) Modifiez le document Word dans Microsoft Word.
3) Cliquez sur Enregistrer. Le document Word modifi&eacute; appara&icirc;t &agrave; pr&eacute;sent dans le conteneur
Gestionnaire de projets avec une ic&ocirc;ne diff&eacute;rente. Cette ic&ocirc;ne indique que le contenu de la source
est &agrave; pr&eacute;sent d&eacute;synchronis&eacute; avec les rubriques g&eacute;n&eacute;r&eacute;es &agrave; partir du document Word li&eacute;.
REMARQUE : Forcez la mise &agrave; jour du document apr&egrave;s avoir modifi&eacute; la source dans Microsoft Word.
Suppression d'un document Word li&eacute;
Vous pouvez supprimer directement des documents li&eacute;s par copie du dossier Fichiers de projet et vous
pouvez supprimer les r&eacute;f&eacute;rences des documents li&eacute;s par r&eacute;f&eacute;rence.
1) Cliquez avec le bouton droit de la souris sur un document et s&eacute;lectionnez Supprimer.
Lorsque vous supprimez un fichier li&eacute;, tous ses documents associ&eacute;s, tels que les fichiers CSS, les fichiers
image, les fichiers bagage et les fichiers multim&eacute;dia, sont &eacute;galement supprim&eacute;s.
Remarques :
•
•
•
Si un fichier r&eacute;f&eacute;renc&eacute; est d&eacute;plac&eacute;, son ic&ocirc;ne change. Vous pouvez restaurer le lien vers le document
Word en pointant vers son nouvel emplacement.
Ne renommez pas les fichiers g&eacute;n&eacute;r&eacute;s apr&egrave;s la liaison d'un document Word.
Vous ne pouvez pas faire glisser les rubriques g&eacute;n&eacute;r&eacute;es en dehors du dossier du document
Microsoft Word parent vers un autre emplacement dans le conteneur Gestionnaire de projets.
84
CHAPITRE 3
IMPORTATION ET LIAISON DE DOCUMENTS MICROSOFT WORD
PROJETS
Restauration d'un lien vers un document Word manquant ou renomm&eacute;
Si l'un des documents Word li&eacute;s est d&eacute;plac&eacute; ou renomm&eacute;, RoboHelp affiche l'ic&ocirc;ne d'un lien manquant
pour le document li&eacute; dans le conteneur Gestionnaire de projets. Vous pouvez restaurer le lien vers un
fichier d&eacute;plac&eacute; ou renomm&eacute; et conserver dans le projet toutes les rubriques d&eacute;j&agrave; g&eacute;n&eacute;r&eacute;es &agrave; partir du
document.
1) Dans le conteneur Gestionnaire de projets, cliquez avec le bouton droit de la souris sur le document
Word ayant l'ic&ocirc;ne du lien manquant.
2) S&eacute;lectionnez Restaurer le lien vers le fichier Word, puis recherchez et s&eacute;lectionnez le nouvel
emplacement du fichier manquant.
Param&egrave;tres de conversion de Word
Vous pouvez cr&eacute;er un ensemble standard de param&egrave;tres de conversion pour importer du contenu Word
dans des projets RoboHelp, puis utiliser ces param&egrave;tres de fa&ccedil;on homog&egrave;ne dans plusieurs projets.
Vous d&eacute;finissez ces param&egrave;tres une fois. Pour les projets ult&eacute;rieurs, importez ces param&egrave;tres dans le
projet. De cette mani&egrave;re, vous pouvez rapidement configurer l'environnement du projet et publier un
contenu Word dans plusieurs formats en ligne.
Ces param&egrave;tres comprennent :
•
Feuilles de style en cascade (CSS) pour les projets RoboHelp
•
Mappage de styles entre les styles Word et les styles RoboHelp
•
Conversion de style et autres param&egrave;tres
Exportation des param&egrave;tres de conversion
1)
2)
3)
S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet.
Dans l'onglet Importer de la bo&icirc;te de dialogue Param&egrave;tres du projet, cliquez sur Exporter.
Sp&eacute;cifiez le nom du fichier des param&egrave;tres d'importation RoboHelp (ISF), puis cliquez sur
Enregistrer.
Importation des param&egrave;tres de conversion dans un projet
1)
2)
3)
S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet.
Dans l'onglet Importer de la bo&icirc;te de dialogue Param&egrave;tres du projet, cliquez sur Parcourir.
S&eacute;lectionnez un fichier des param&egrave;tres d'importation RoboHelp (ISF). Cliquez sur Ouvrir.
85
CHAPITRE 3
IMPORTATION ET LIAISON DE DOCUMENTS MICROSOFT WORD
PROJETS
Composants d'un document Word convertis vers RoboHelp
RoboHelp convertit la plupart des composants Word lorsque vous liez ou importez des documents Word.
Les tableaux suivants r&eacute;pertorient les principaux composants d'un document Word et montrent de quelle
mani&egrave;re ils sont convertis dans RoboHelp.
Composant de
document Word
Table des mati&egrave;res
Conversion si elle est s&eacute;lectionn&eacute;e. Voir Importation d'une table des
mati&egrave;res, d'un index et d'un glossaire Word.
Index
Conversion si elle est s&eacute;lectionn&eacute;e. Voir Importation d'une table des
mati&egrave;res, d'un index et d'un glossaire Word.
Glossaire
Vous pouvez cr&eacute;er un glossaire dans RoboHelp &agrave; partir des styles de
paragraphe s&eacute;lectionn&eacute;s dans Word. Voir Importation d'une table des
mati&egrave;res, d'un index et d'un glossaire Word.
Equations
Equations
Ignor&eacute;es lors de l'importation du document dans RoboHelp.
Marqueurs
R&eacute;f&eacute;rences crois&eacute;es,
hypertexte, URL
Les r&eacute;f&eacute;rences crois&eacute;es sont converties en liens hypertexte si l'option
Convertir les r&eacute;f&eacute;rences en liens hypertexte est s&eacute;lectionn&eacute;e dans RoboHelp
lors de l'importation d'un document Word. Dans le cas contraire, elles sont
import&eacute;es sous forme de texte brut. Les r&eacute;f&eacute;rences crois&eacute;es et les entr&eacute;es
hypertexte non r&eacute;solues apparaissent sous forme de texte dans l'aide en
ligne.
Les URL deviennent des liens hypertexte dans la sortie de l'aide en ligne. Voir
Conversion de r&eacute;f&eacute;rences Word en liens hypertexte.
Marqueurs d'aide
contextuelle
Convertis en ID de mappage dans RoboHelp. Voir Conversion des marqueurs
d'aide contextuelle dans Word en ID de mappage.
Formats
Formats de
paragraphes
Conversion. Vous pouvez mapper les formats de paragraphe Microsoft Word
avec les styles RoboHelp ou importer le formatage de source. Voir
Conversion de styles de paragraphe Word en styles RoboHelp.
Formats de caract&egrave;res
Conversion. Vous pouvez mapper les formats de caract&egrave;re Microsoft Word
avec les styles RoboHelp ou importer le formatage source. Voir Conversion
de styles de caract&egrave;re Word en styles RoboHelp.
86
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
CHAPITRE 3
Formats de tableaux
Conversion. Vous pouvez mapper les formats de tableau Microsoft Word
avec les styles RoboHelp ou importer le formatage source. Voir Conversion
de styles de tableau Word en styles de tableau RoboHelp.
Listes
Elles sont converties en fonction des param&egrave;tres que vous d&eacute;finissez. Voir
Mappage de liste.
Mises en page
Mise en page, taille et
pagination Word
Elles sont ignor&eacute;es. Ces &eacute;l&eacute;ments ne sont pas applicables &agrave; l'aide en ligne.
En-t&ecirc;tes/pieds de
page
Conversion. Voir Conversion d'en-t&ecirc;tes et de pieds de page dans des
documents Word.
Images
Images
Conversion. Les images PNG sont import&eacute;s telles quelles si l'option Autoriser
PNG sous forme de format graphique est s&eacute;lectionn&eacute;e dans les options Web
de Microsoft Word. Toutes les autres images sont converties au format gif ou
jpg.
Dessins
Conversion en images.
3.7.
Importation de documents FrameMaker
Vous pouvez importer dans votre projet RoboHelp un livre FrameMaker, les fichiers XML qui font partie
de ce livre, les fichiers FM ou les fichiers MIF cr&eacute;&eacute;s dans FrameMaker. Ce chapitre explique les conseils et
les param&egrave;tres de conversion qui doivent &ecirc;tre pris en compte lors de l'importation de documents
FrameMaker dans RoboHelp.
Optimisation pour la sortie en ligne avant conversion
Si votre processus de cr&eacute;ation de contenu dans FrameMaker est optimis&eacute; pour l'impression, lisez ce qui
suit avant de lier des documents FrameMaker &agrave; vos projets ou de les y importer.
Formats d'intitul&eacute;
D&eacute;terminez les meilleurs correspondances entre formats d'intitul&eacute; FrameMaker et styles RoboHelp.
Les documents FrameMaker d&eacute;finissent de nombreux formats d'intitul&eacute; sp&eacute;cialement destin&eacute;s &agrave; la
documentation imprim&eacute;e. Ces formats comprennent notamment les titres de marge ou les styles
d'intitul&eacute; commen&ccedil;ant sur une nouvelle page. Ces formats ne s'appliquent pas aux documents en
ligne. Vous pouvez g&eacute;n&eacute;ralement mapper ces styles d'intitul&eacute; &agrave; un certain nombre de styles
standard dans un projet RoboHelp.
87
CHAPITRE 3
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
Param&egrave;tres de mise en page
Les mod&egrave;les de chapitre FrameMaker sp&eacute;cifient souvent un nombre de pages pour que les
nouveaux chapitres puissent commencer au recto d'une page. Cette pagination ne s'applique pas &agrave;
l'aide en ligne.
En-t&ecirc;tes et pieds de page
RoboHelp ignore les en-t&ecirc;tes et les pieds de page lors de la conversion, y compris les mentions
l&eacute;gales ou le texte de copyright. Vous devez inclure ce type de texte dans les en-t&ecirc;tes ou pieds de
page de mani&egrave;re s&eacute;par&eacute;e, une fois la conversion effectu&eacute;e. De m&ecirc;me, dans RoboHelp, vous devez
recr&eacute;er le texte ou les images en filigrane de la documentation imprim&eacute;e. Vous pouvez utiliser la
fonctionnalit&eacute; de page principale de RoboHelp pour effectuer ces modifications.
Navigation
Dans un document imprim&eacute;, les r&eacute;f&eacute;rences crois&eacute;es indiquent souvent des num&eacute;ros de pages qui
n'ont aucune utilit&eacute; dans l'aide. Vous pouvez mapper des formats de r&eacute;f&eacute;rence crois&eacute;e dans
FrameMaker &agrave; un format ne contenant pas le num&eacute;ro du chapitre ou de la page. Les titres de
chapitres ou de sections dans les en-t&ecirc;tes ou les pieds de page sont supprim&eacute;s lors de la conversion
vers un format d'aide en ligne. Vous pouvez am&eacute;liorer les fonctions de navigation &agrave; l'aide d'un fil
d'Ariane, de boutons fl&eacute;ch&eacute;s ou encore d'une s&eacute;quence de navigation pr&eacute;d&eacute;finie.
Contenu redondant
Afin d'offrir du contexte dans diff&eacute;rentes sections d'un document imprim&eacute;, les r&eacute;dacteurs ajoutent
souvent des informations redondantes, telles que des r&eacute;sum&eacute;s succincts de concepts abord&eacute;s dans
les sections pr&eacute;c&eacute;dentes. L'aide en ligne constituant un support non lin&eacute;aire et &eacute;tant donn&eacute; qu'il est
possible de choisir la section &agrave; consulter, le contenu se doit d'&ecirc;tre moins redondant. Utilisez des
r&eacute;f&eacute;rences crois&eacute;es et du texte conditionnel afin de r&eacute;duire la quantit&eacute; de contenu redondant dans
vos sorties.
Chapitre contre rubrique
La cr&eacute;ation d'une documentation imprim&eacute;e implique de diviser le contenu en chapitres autonomes,
permettant au lecteur de s&eacute;parer le contenu de mani&egrave;re logique et physique. Dans l'aide en ligne,
le contenu est divis&eacute; en rubriques, auxquelles l'on acc&egrave;de individuellement. Bien qu'il soit possible
de regrouper le contenu des chapitres en dossiers que l'utilisateur peut d&eacute;velopper en parcourant
la table des mati&egrave;res, il n'est possible d'afficher qu'une seule rubrique &agrave; la fois. Dans un tel cas,
essayez de fournir des informations d&eacute;taill&eacute;es non redondantes, au lieu de regrouper les rubriques
associ&eacute;es.
88
CHAPITRE 3
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
Contextualit&eacute;
Les formats d'aide en ligne permettent de lier des rubriques sp&eacute;cifiques &agrave; du contenu associ&eacute; au
sein m&ecirc;me de l'application. Bien qu'il soit possible d'attribuer des ID de correspondance aux
rubriques dans RoboHelp, il est &eacute;galement possible d'attribuer des marqueurs d'aide contextuelle
dans des documents FrameMaker. RoboHelp lit ces marqueurs et attribue les ID de mappage aux
rubriques g&eacute;n&eacute;r&eacute;es. V&eacute;rifiez que les rubriques cr&eacute;&eacute;es &agrave; partir de FrameMaker contiennent
suffisamment d'informations.
Par exemple, une proc&eacute;dure courte sous forme d'une rubrique autonome ne fournit pas les
informations conceptuelles au lecteur. Afin d'&eacute;viter d'avoir &agrave; cr&eacute;er des rubriques avec des
informations incompl&egrave;tes, attribuez des marqueurs d'aide contextuelle &agrave; des rubriques de niveau
sup&eacute;rieur, afin que la rubrique d'aide g&eacute;n&eacute;r&eacute;e contienne le concept, la proc&eacute;dure et les &eacute;l&eacute;ments
visuels correspondants.
Pr&eacute;paration de documents FrameMaker &agrave; la conversion en fichiers d'aide
Si le document FrameMaker que vous importez est un livre FrameMaker non structur&eacute;, vous pouvez
d&eacute;finir un mod&egrave;le FrameMaker unique pour la conversion. Vous pouvez ensuite sp&eacute;cifier ce mod&egrave;le
comme mod&egrave;le de projet qui remplacera les formats des documents particuliers au niveau du projet
RoboHelp. Vous pouvez &eacute;galement r&eacute;utiliser les param&egrave;tres de conversion dans d'autres projets en les
exportant.
Portez une attention toute particuli&egrave;re aux mod&egrave;les FrameMaker avant d'importer les documents dans
RoboHelp, notamment quand vous utilisez un mod&egrave;le FrameMaker &agrave; usage g&eacute;n&eacute;ral. Si ce mod&egrave;le
contient des formats qui ne sont pas utilis&eacute;s dans le livre, omettez-les dans le mod&egrave;le que vous utilisez
pour la conversion.
1) Cr&eacute;ez un mod&egrave;le FrameMaker contenant les formats dont vous avez besoin dans l'aide. Vous
pouvez &eacute;galement personnaliser le mod&egrave;le FrameMaker. Il n'est pas n&eacute;cessaire d'appliquer le
mod&egrave;le manuellement. Vous pouvez configurer RoboHelp pour qu'il applique un mod&egrave;le
s&eacute;lectionn&eacute; aux fichiers FrameMaker avant qu'ils ne soient associ&eacute;s &agrave; RoboHelp ou qu'ils n'y soient
import&eacute;s.
Dans FrameMaker structur&eacute;, le document de d&eacute;finition des &eacute;l&eacute;ments (fichier EDD) ou le fichier DTD
utilis&eacute; dans le mod&egrave;le FrameMaker structur&eacute; contr&ocirc;le automatiquement la mise en page.
FrameMaker structur&eacute; appliquant un format et une structure valides, les documents structur&eacute;s ne
contiennent pas de formats personnalis&eacute;s.
2) Appliquez des marqueurs d'aide contextuelle aux rubriques appropri&eacute;es. Voir Conversion des
marqueurs d'aide contextuelle de documents FrameMaker.
3) Ins&eacute;rez les graphiques, les l&eacute;gendes et les cadres graphiques ou de texte que vous avez cr&eacute;&eacute;s avec
les outils graphiques de FrameMaker dans des cadres ancr&eacute;s. RoboHelp importe uniquement les
graphiques FrameMaker qui sont situ&eacute;s dans des cadres ancr&eacute;s. Par d&eacute;faut, si vous importez des
graphiques et des fichiers multim&eacute;dia dans un document FrameMaker, ils sont plac&eacute;s dans des
cadres ancr&eacute;s. N&eacute;anmoins, si votre document FrameMaker contient des graphiques inclus dans des
cadres graphiques, vous devez les placer dans des cadres ancr&eacute;s avant de lier les fichiers
FrameMaker &agrave; RoboHelp ou de les y importer.
89
CHAPITRE 3
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
REMARQUE : Si le d&eacute;calage d'une image dans le fichier FrameMaker est d&eacute;fini sur une valeur n&eacute;gative,
4)
5)
6)
7)
8)
l'image peut &ecirc;tre partiellement masqu&eacute;e dans le code HTML. Modifiez la valeur avant de proc&eacute;der
&agrave; l'importation.
Pour maintenir la qualit&eacute; d'origine des images, ins&eacute;rez-les dans des documents FrameMaker par
r&eacute;f&eacute;rence. RoboHelp copie les images r&eacute;f&eacute;renc&eacute;es directement de la source si l'image compl&egrave;te est
visible dans le cadre ancr&eacute;. De la m&ecirc;me mani&egrave;re, si les images sont importantes, ins&eacute;rez-les dans le
document source par r&eacute;f&eacute;rence.
Corrigez les &eacute;ventuels probl&egrave;mes, tels que des r&eacute;f&eacute;rences crois&eacute;es non r&eacute;solues, des polices
manquantes ou des probl&egrave;mes de num&eacute;rotation. Voir Aide de FrameMaker pour plus
d'informations.
Configurez un autre texte ou d'autres l&eacute;gendes pour les images et les graphiques afin de cr&eacute;er un
contenu en ligne accessible. Voir Cr&eacute;ation de texte de substitution pour des images.
Appliquez des param&egrave;tres de texte conditionnel dans les documents FrameMaker. Voir Aide de
FrameMaker.
Modifiez les pages de r&eacute;f&eacute;rence de la table des mati&egrave;res FrameMaker afin d'obtenir des intitul&eacute;s
hi&eacute;rarchiques indent&eacute;s avec des styles diff&eacute;rents. Voir Conversion d'une table des mati&egrave;res
FrameMaker.
Importation de documents FrameMaker
Le processus RoboHelp de liaison ou d'importation de documents FrameMaker vous permet d'effectuer
les t&acirc;ches suivantes :
•
Cr&eacute;er un projet RoboHelp en important un livre FrameMaker. Vous pouvez importer des fichiers
BOOK ou BK.
•
Importer des documents FrameMaker dans un projet RoboHelp. Vous pouvez importer des fichiers
FM ou MIF cr&eacute;&eacute;s dans FrameMaker. Les fichiers XML qui font partie d'un livre FrameMaker peuvent
&ecirc;tre import&eacute;s.
Avant d'importer des documents FrameMaker, v&eacute;rifiez dans FrameMaker s'ils comportent des erreurs
telles que des r&eacute;f&eacute;rences crois&eacute;es non r&eacute;solues et des remplacements de format. Voir Pr&eacute;paration de
documents FrameMaker &agrave; la conversion en fichiers d'aide.
Cr&eacute;ation d'un projet RoboHelp en important des livres ou des documents FrameMaker
Vous pouvez cr&eacute;er un projet RoboHelp en important des livres ou des documents FrameMaker.
l'importation de ces fichiers n&eacute;cessite que FrameMaker 8 ou une version ult&eacute;rieure soit install&eacute; sur votre
ordinateur.
1) Sur la page D&eacute;marrage de RoboHelp, cliquez sur Plus sous Importer ou s&eacute;lectionnez Fichier &gt;
Nouveau projet.
2) Dans l'onglet Importer de la bo&icirc;te de dialogue Nouveau projet, s&eacute;lectionnez Document
FrameMaker, puis cliquez sur OK.
3) S&eacute;lectionnez Livre ou document FrameMaker (BOOK, BK, FM, MIF ou FRM) dans le menu d&eacute;roulant
Fichiers de type, recherchez et s&eacute;lectionnez le livre FrameMaker, puis cliquez sur Ouvrir.
90
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
CHAPITRE 3
REMARQUE :
Utilisez la proc&eacute;dure ci-dessus pour cr&eacute;er un projet de toutes pi&egrave;ces et importer le contenu
FrameMaker dans le nouveau projet. Toutefois, la liaison de documents FrameMaker n'est pas autoris&eacute;e
dans ce cas.
Importation d'un livre FrameMaker dans un nouveau projet RoboHelp
1)
2)
3)
4)
Cr&eacute;ez un projet dans RoboHelp.
S&eacute;lectionnez Projet &gt; Importer &gt; Document &gt; Document FrameMaker.
Dans le menu contextuel Fichiers de type, s&eacute;lectionnez Livre FrameMaker (BOOK).
Parcourez la liste et s&eacute;lectionnez le fichier du livre FrameMaker, puis cliquez sur Ouvrir.
Si vous importez un document FrameMaker, vous pouvez s&eacute;lectionner les composants que vous voulez
importer dans l'assistant d'importation qui s'affiche. Vous pouvez s&eacute;lectionner la table des mati&egrave;res,
l'index et le glossaire, puis sp&eacute;cifier les param&egrave;tres de conversion.
REMARQUE : Utilisez la proc&eacute;dure ci-dessus si vous avez d&eacute;j&agrave; un projet avec du contenu et souhaitez
importer le contenu FrameMaker. La liaison du document FrameMaker est autoris&eacute;e dans ce cas.
Importation de documents FrameMaker dans un projet RoboHelp existant
1)
2)
3)
S&eacute;lectionnez Projet &gt; Importer &gt; Document &gt; Document FrameMaker.
S&eacute;lectionnez le type de document FrameMaker &agrave; importer.
S&eacute;lectionnez les documents, puis cliquez sur Ouvrir.
Composants d'un document FrameMaker convertis vers RoboHelp
RoboHelp convertit la plupart des composants FrameMaker lorsque vous liez ou importez des documents
FrameMaker. Les tableaux suivants r&eacute;pertorient les principaux composants d'un document FrameMaker
et indiquent la mani&egrave;re dont ils sont convertis dans RoboHelp.
Fichiers FrameMaker
Fichiers du livre
Les documents contenus dans le livre sont convertis (fichiers FM, XML, MIF,
HTM et HTML). Les fichiers XHTML inclus dans le livre FrameMaker doivent
&ecirc;tre valides. Vous pouvez valider le langage XHTML directement dans
FrameMaker. Les autres fichiers du livre FrameMaker sont ignor&eacute;s. Les livres
enfants, les dossiers et les groupes des livres FrameMaker 9 sont convertis et
apparaissent sous forme de dossiers dans les projets RoboHelp. Voir
Structure hi&eacute;rarchique d'un livre FrameMaker 9.
Table des mati&egrave;res
Conversion si elle est s&eacute;lectionn&eacute;e. Voir Conversion d'une table des mati&egrave;res
FrameMaker.
Encarts de texte
Les encarts de texte dans les documents FrameMaker sont consid&eacute;r&eacute;s
comme faisant partie du document FrameMaker proprement dit et sont
ins&eacute;r&eacute;s sous forme de texte dans la rubrique RoboHelp. Lorsque le contenu
est ins&eacute;r&eacute;, il ne peut pas &ecirc;tre modifi&eacute; en tant qu'encart de texte dans
FrameMaker mais uniquement en tant que texte dans RoboHelp.
91
CHAPITRE 3
Index et glossaire
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
Les fichiers d'index et de glossaire g&eacute;n&eacute;r&eacute;s dans le livre FrameMaker ne sont
pas convertis alors que les marqueurs d'index et de glossaire des documents
FrameMaker import&eacute;s le sont s'ils sont s&eacute;lectionn&eacute;s. Voir Importation des
entr&eacute;es d'index FrameMaker et Importation des d&eacute;finitions de glossaire.
Variables et texte
conditionnel
Variables
Conversion. Les variables d&eacute;finies par l'utilisateur dans FrameMaker sont
converties en tant que telles dans RoboHelp et peuvent &ecirc;tre red&eacute;finies.
Appliquez les balises de texte de condition appropri&eacute;es afin de supprimer les
variables ne devant pas appara&icirc;tre dans le format en ligne. Vous pouvez par
exemple supprimer la variable Suite de tableau dans les en-t&ecirc;tes des
tableaux r&eacute;partis sur plusieurs pages dans les documents FrameMaker.
Balises
conditionnelles
Elles sont converties tout comme les balises de construction conditionnelles
de RoboHelp.
Equations
Convertissez les &eacute;quations en images et ins&eacute;rez-les dans les rubriques
RoboHelp apr&egrave;s la conversion.
Marqueurs
R&eacute;f&eacute;rences crois&eacute;es,
hypertexte, URL
Converties en liens hypertexte. Vous pouvez mapper les formats de
r&eacute;f&eacute;rences crois&eacute;es dans RoboHelp afin de pouvoir supprimer les r&eacute;f&eacute;rences
de volume, de chapitre et de page, qui ne sont pas appropri&eacute;es dans le
format en ligne. Les r&eacute;f&eacute;rences crois&eacute;es et les entr&eacute;es hypertexte non
r&eacute;solues apparaissent sous forme de texte dans l'aide en ligne. Les URL
deviennent des liens hypertexte dans la sortie de l'aide en ligne. Voir
Conversion des formats de r&eacute;f&eacute;rences crois&eacute;es FrameMaker en styles
RoboHelp.
Marqueurs d'index et
de glossaire
Conversion en index et glossaire lors de la cr&eacute;ation d'un projet. Voir
Importation des entr&eacute;es d'index FrameMaker et Importation des d&eacute;finitions
de glossaire.
Marqueurs de noms
de rubrique
Convertis si vous s&eacute;lectionnez cette option dans les param&egrave;tres de
conversion du projet. Utilisez des marqueurs de nom de rubrique pour cr&eacute;er
des titres de rubrique et des noms de fichier de rubrique pour le texte du
marqueur. Voir D&eacute;finition de la pagination et des noms de rubrique.
Marqueurs d'aide
contextuelle
Convertis si vous s&eacute;lectionnez cette option dans les param&egrave;tres de
conversion du projet. Utilisez les marqueurs d'aide contextuelle dans
FrameMaker pour sp&eacute;cifier du texte dans un document FrameMaker pour la
cr&eacute;ation de l'aide contextuelle. Voir D&eacute;finition de la pagination et des noms
de rubrique.
92
CHAPITRE 3
Marqueurs
personnalis&eacute;s
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
Conversion. Vous pouvez utiliser ces marqueurs pour d&eacute;limiter des rubriques
de la source FrameMaker ou pour indiquer des instructions de traitement &agrave;
RoboHelp, notamment pour les images et les tableaux.
Formats
Formats de
paragraphes
Conversion. Vous pouvez mapper les formats de paragraphes FrameMaker
avec les styles RoboHelp ou importer la mise en forme source. Voir
Conversion des formats de paragraphes FrameMaker en styles RoboHelp.
Formats de caract&egrave;res
Conversion. Vous pouvez mapper les formats de caract&egrave;res FrameMaker
avec les styles RoboHelp ou importer la mise en forme source. Voir
Conversion des formats de caract&egrave;res FrameMaker en styles RoboHelp.
Formats de tableaux
Conversion. Vous pouvez mapper les formats de tableau FrameMaker &agrave; des
styles RoboHelp ou importer le formatage source. Voir Conversion des
formats de tableaux FrameMaker en styles de tableau RoboHelp.
Propri&eacute;t&eacute;s des notes
de bas de page et
notes de bas de page
de tableau
Conversion. Le titre et le pied de page d'un tableau ayant un format de
paragraphe dans FrameMaker, vous devez sp&eacute;cifier des param&egrave;tres de
conversion pour ces formats s&eacute;par&eacute;ment.
Listes
Elles sont converties en fonction des param&egrave;tres que vous d&eacute;finissez.
Voir Sc&eacute;narios de mise en correspondance de listes.
Mises en page
Pages principales
Les pages principales de FrameMaker sont ignor&eacute;es. Les pages principales
sont utilis&eacute;es pour la mise en page, les bordures et les num&eacute;ros de page dans
FrameMaker. Elles ne sont par cons&eacute;quent pas utiles pour l'aide en ligne.
RoboHelp offre une prise en charge des gabarits pour les chemins de
navigation, les tables des mati&egrave;res de rubriques, les en-t&ecirc;tes et les pieds de
page s&eacute;lectionnables lorsque vous publiez &agrave; partir d'une source unique.
Pages de r&eacute;f&eacute;rence
Elles sont ignor&eacute;es. N&eacute;anmoins, vous pouvez utiliser la prise en charge de
script avanc&eacute;e de RoboHelp afin de convertir les images et les graphiques
plac&eacute;s dans les pages de r&eacute;f&eacute;rence associ&eacute;es aux formats de paragraphes.
Mise en page, taille et
pagination
Elles sont ignor&eacute;es. Ces &eacute;l&eacute;ments ne sont pas applicables pour l'aide en ligne.
Voir D&eacute;finition de la pagination et des noms de rubrique.
93
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
CHAPITRE 3
En-t&ecirc;tes/pieds de
page
Elles sont ignor&eacute;es. Les en-t&ecirc;tes et les pieds de page dans FrameMaker
contiennent g&eacute;n&eacute;ralement des noms ou des num&eacute;ros de chapitre ou des
num&eacute;ros de page, qui ne sont pas applicables &agrave; des formats en ligne. Une
fois les rubriques g&eacute;n&eacute;r&eacute;es dans RoboHelp, vous pouvez cr&eacute;er des en-t&ecirc;tes
et des pieds de page dans RoboHelp, afin de pouvoir placer des informations
importantes au sommet et au bas des rubriques.
Texte inclin&eacute;
Conversion en texte, par exemple dans des cellules de tableau. (Le texte
inclin&eacute; n'est pas pris en charge dans HTML.)
Images et cadres
ancr&eacute;s
Images
Elles sont converties uniquement si elles se trouvent dans des cadres ancr&eacute;s.
Si les images ne se trouvent pas dans des cadres ancr&eacute;s, ins&eacute;rez-les &agrave;
nouveau une fois les fichiers FrameMaker import&eacute;s. Par d&eacute;faut, FrameMaker
place les images import&eacute;es et li&eacute;es dans des cadres ancr&eacute;s, ce qui les
convertit automatiquement. N&eacute;anmoins, les images plac&eacute;es dans des cadres
de graphiques ne sont pas converties. Si des images contenues dans des
cadres ancr&eacute;s sont manquantes, RoboHelp cr&eacute;e des images vides avec le
nom de fichier dans un ordre s&eacute;quentiel. Voir Param&egrave;tres de conversion
d'image.
Dessins
Les dessins cr&eacute;&eacute;s dans des cadres ancr&eacute;s sont convertis en images. Vous
pouvez d&eacute;finir les param&egrave;tres de conversion d'image. Voir Param&egrave;tres de
conversion d'image.
Cadres ancr&eacute;s
Conversion en images. Voir Param&egrave;tres de conversion d'image.
AUTRE texte des
images et des cadres
ancr&eacute;s
Conversion. Si aucun texte de remplacement n'est fourni dans le document
pour les images dans FrameMaker, RoboHelp utilise le nom de fichier des
images converties comme texte alternatif. Voir Cr&eacute;ation de texte de
substitution pour des images.
Zones r&eacute;actives
Conversion en mappages d'images.
Cadres de texte,
cadres de graphique
et images dans les
cadres ancr&eacute;s
Les cadres ancr&eacute;s et leur contenu sont convertis en images. Le contenu d'un
cadre ancr&eacute;, y compris les cadres de texte, les images multiples et les
l&eacute;gendes, est converti en une image unique. RoboHelp ins&egrave;re le nom de
fichier de l'image cr&eacute;&eacute;e comme AUTRE texte si aucun AUTRE texte n'est
d&eacute;fini pour le cadre ancr&eacute;.
Equations
Ins&eacute;rez les &eacute;quations dans des cadres ancr&eacute;s afin qu'elles soient converties
en images lors de leur conversion par RoboHelp. Voir Aide de FrameMaker.
94
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
CHAPITRE 3
Composants
FrameMaker
structur&eacute;s
Fichiers XML du livre
Convertis en documents FrameMaker.
Fichiers XHTML du
livre
Convertis en documents FrameMaker.
R&eacute;f&eacute;rences de
contenu
Le texte ou les fichiers ins&eacute;r&eacute;s dans des documents FrameMaker en tant que
contenu seront affich&eacute;s comme faisant partie des rubriques. Ils ne s'affichent
pas comme r&eacute;f&eacute;rences dans les sorties d'aide en ligne. Voir R&eacute;f&eacute;rence au
contenu.
Concepts de base de la conversion
Conversion d'une table des mati&egrave;res FrameMaker
Lorsque vous importez un livre FrameMaker dans un projet RoboHelp, vous pouvez &eacute;galement importer
la table des mati&egrave;res. Importez-la dans le projet RoboHelp afin de conserver la structure de navigation
d&eacute;finie dans le livre FrameMaker.
1) S&eacute;lectionnez Projet &gt; Importer &gt; Document FrameMaker. S&eacute;lectionnez le fichier FrameMaker.
2) Dans la bo&icirc;te de dialogue Param&egrave;tres de contenu, s&eacute;lectionnez Convertir la table des mati&egrave;res
FrameMaker, puis parcourez la liste et s&eacute;lectionnez le fichier Table des mati&egrave;res FrameMaker.
REMARQUE : Si vous importez une carte DITA FrameMaker, RoboHelp utilise la table des mati&egrave;res que
FrameMaker cr&eacute;e en fonction des param&egrave;tres dans le fichier ditafm_output.ini. Pour plus
d'informations concernant le fichier ditafm_output.ini, voir l'aide de FrameMaker.
3) S&eacute;lectionnez l'une des options suivantes :
Ajouter &agrave; la table des mati&egrave;res existante
Ajoute les entr&eacute;es de la table des mati&egrave;res &agrave; une table des mati&egrave;res RH d&eacute;j&agrave; pr&eacute;sente dans le projet.
S&eacute;lectionnez une table des mati&egrave;res RoboHelp existante dans la liste.
Cr&eacute;er une nouvelle table des mati&egrave;res associ&eacute;e
Saisissez le nom d'une nouvelle table des mati&egrave;res associ&eacute;e ajout&eacute;e au projet RoboHelp.
Les styles pr&eacute;sents dans la table des mati&egrave;res FrameMaker d&eacute;terminent quels &eacute;l&eacute;ments deviennent des
livres, des sous-livres ou encore des pages. L'indentation &agrave; gauche, la taille de police et la graisse sont des
&eacute;l&eacute;ments importants permettant de d&eacute;finir le niveau dans la hi&eacute;rarchie. Les entr&eacute;es de la table des
mati&egrave;res dont des &eacute;l&eacute;ments sont en retrait deviennent des livres dans la table des mati&egrave;res RoboHelp. Si
toutes les entr&eacute;es de la table des mati&egrave;res ont les m&ecirc;mes retrait, taille et &eacute;paisseur de police, la table des
mati&egrave;res appara&icirc;t &agrave; plat dans RoboHelp.
•
Pour transformer un intitul&eacute; en livre, incluez des niveaux indent&eacute;s sous cet intitul&eacute; ou utilisez une
plus petite taille ou une graisse diff&eacute;rente pour les polices des autres intitul&eacute;s.
95
CHAPITRE 3
•
•
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
Pour transformer un intitul&eacute; en sous-livre, placez-le sous un intitul&eacute; principal. Incluez ensuite des
niveaux indent&eacute;s sous cet intitul&eacute; de sous-livre ou utilisez une plus petite taille ou une graisse
diff&eacute;rente pour les polices des autres intitul&eacute;s.
Pour transformer un intitul&eacute; en page, n'incluez aucun niveau sous cet intitul&eacute;. Indentez l'intitul&eacute; de
la page ou utilisez une taille ou une graisse diff&eacute;rente pour les polices.
Diff&eacute;rences entre les tables des mati&egrave;res FrameMaker et RoboHelp
Vous pouvez importer la table des mati&egrave;res FrameMaker ou cr&eacute;er automatiquement une table des
mati&egrave;res sous RoboHelp &agrave; partir de rubriques g&eacute;n&eacute;r&eacute;es.
•
Dans FrameMaker, la table des mati&egrave;res est g&eacute;n&eacute;r&eacute;e en fonction des styles d'intitul&eacute; que vous
incluez. Dans RoboHelp, la table des mati&egrave;res est g&eacute;n&eacute;r&eacute;e en fonction des titres des rubriques. Si
vous utilisez des marqueurs de nom de rubrique dans FrameMaker pour nommer les rubriques lors
de l'importation de documents FrameMaker, les fichiers dans RoboHelp prennent un nom diff&eacute;rent.
•
La cr&eacute;ation automatique d'une table des mati&egrave;res pour un livre FrameMaker 9 (ou version
ult&eacute;rieure) peut cr&eacute;er plusieurs calques de contenu en raison de la structure de dossier d'un livre
FrameMaker 9 (ou version ult&eacute;rieure).
•
Dans RoboHelp, vous pouvez ins&eacute;rer un espace r&eacute;serv&eacute; de table des mati&egrave;res dans une autre table
des mati&egrave;res, ce qui permet de cr&eacute;er des tables des mati&egrave;res imbriqu&eacute;es.
Importation des entr&eacute;es d'index FrameMaker
RoboHelp cr&eacute;e un index en fonction des marqueurs d'index se trouvant dans le document que vous
importez. Toutefois, le fichier d'index g&eacute;n&eacute;r&eacute; dans le livre FrameMaker n'est pas import&eacute; dans le projet
RoboHelp.
1) S&eacute;lectionnez Projet &gt; Importer &gt; Document FrameMaker, puis s&eacute;lectionnez le livre ou le document
FrameMaker.
2) Dans la bo&icirc;te de dialogue Param&egrave;tres de la table des mati&egrave;res, s&eacute;lectionnez Convertir l'index, puis
l'une des options suivantes :
Ajouter &agrave; l'index existant
Ajoutez les entr&eacute;es de l'index FrameMaker &agrave; l'index RoboHelp existant du projet.
Cr&eacute;er un nouvel index associ&eacute;
Saisissez le nom d'un nouvel index associ&eacute; ajout&eacute; au projet RoboHelp.
Ajouter &agrave; la rubrique
Ajoutez les entr&eacute;es de l'index FrameMaker aux rubriques particuli&egrave;res dans lesquelles elles
apparaissent.
REMARQUE : RoboHelp ne dispose pas de param&egrave;tre au niveau du projet associ&eacute; au type d'index. Les
entr&eacute;es d'index peuvent appara&icirc;tre dans un index ou une rubrique de projet. La liaison FrameMaker
vous permet de s&eacute;lectionner le type d'index &agrave; partir de diff&eacute;rentes options d'indexation possibles.
Lorsque la sortie est g&eacute;n&eacute;r&eacute;e depuis RoboHelp, les entr&eacute;es d'index pr&eacute;sentes dans la rubrique et
celles pr&eacute;sentes dans l'index s&eacute;lectionn&eacute; (dans la mise en page SSL) sont plac&eacute;es dans la sortie.
96
CHAPITRE 3
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
Importation des d&eacute;finitions de glossaire
RoboHelp cr&eacute;e un glossaire en fonction des marqueurs de glossaire d&eacute;finis dans le document import&eacute;. Le
texte du marqueur de glossaire correspond au terme de glossaire et le contenu du paragraphe dans
lequel figure ce marqueur correspond &agrave; la d&eacute;finition du terme de glossaire.
1) S&eacute;lectionnez Projet &gt; Importer &gt; Document FrameMaker, puis s&eacute;lectionnez le livre ou le document
FrameMaker.
2) Dans la bo&icirc;te de dialogue Param&egrave;tres de la table des mati&egrave;res, s&eacute;lectionnez Convertir le glossaire,
puis l'une des options suivantes :
Ajouter au glossaire existant
Ajoutez le glossaire FrameMaker au glossaire RoboHelp du projet. Vous pouvez s&eacute;lectionner le
glossaire dans la liste.
Cr&eacute;er un nouveau glossaire associ&eacute;
Saisissez un nom pour le nouveau glossaire associ&eacute; dans le projet RoboHelp.
Application de conditions &agrave; partir d'un fichier Ditaval
Lors de l'importation d'une carte DITA FrameMaker, vous pouvez appliquer un fichier Ditaval. RoboHelp
traite les conditions sp&eacute;cifi&eacute;es dans le fichier Ditaval pour filtrer le contenu &agrave; importer.
1) S&eacute;lectionnez Projet &gt; Importer &gt; Document FrameMaker, puis s&eacute;lectionnez la carte DITA
FrameMaker.
2) S&eacute;lectionnez le fichier .ditaval &agrave; appliquer et cliquez sur Ouvrir.
Conversion des formats FrameMaker en styles RoboHelp
Vous pouvez d&eacute;finir dans quelle mesure les formats FrameMaker sont convertis en styles RoboHelp au
niveau du projet. Toutes les d&eacute;finitions de format FrameMaker dans le document FrameMaker
apparaissent dans la bo&icirc;te de dialogue des param&egrave;tres de conversion, m&ecirc;me si elles ne sont pas utilis&eacute;es.
Sp&eacute;cifiez les &eacute;l&eacute;ments ci-dessous.
•
Le mod&egrave;le FrameMaker utilis&eacute; pour la conversion. Cette &eacute;tape est facultative.
•
Feuille de style RoboHelp pour le mappage de styles.
S&eacute;lection d'un mod&egrave;le FrameMaker de conversion
Vous pouvez ensuite l'utiliser comme mod&egrave;le du projet, rempla&ccedil;ant les formats des documents
individuels au niveau du projet RoboHelp. Vous pouvez &eacute;galement r&eacute;utiliser les param&egrave;tres de conversion
dans d'autres projets en les exportant.
1) S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet.
2) Cliquez sur l'onglet Importer de la bo&icirc;te de dialogue Param&egrave;tres du projet. S&eacute;lectionnez Appliquer
le mod&egrave;le FrameMaker.
3) Cliquez sur Parcourir, puis s&eacute;lectionnez le mod&egrave;le FrameMaker &agrave; utiliser pour le projet.
97
CHAPITRE 3
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
REMARQUE : Lors de l'importation, RoboHelp commence par copier le mod&egrave;le dans le projet puis
applique ce dernier aux documents en cours d'importation. Toutes les modifications sont apport&eacute;es
au mod&egrave;le dans l'emplacement d'origine.
S&eacute;lection de la feuille de style en cascade pour le mappage de styles
Vous pouvez s&eacute;lectionner la feuille CSS que RoboHelp utilise pour mapper les formats FrameMaker aux
styles RoboHelp. Par d&eacute;faut, RoboHelp utilise le fichier RHStyleMapping.css pour le projet. Vous pouvez
&eacute;galement utiliser un fichier CSS personnalis&eacute;. Vous pouvez modifier les styles ult&eacute;rieurement dans
RoboHelp ou dans une application de cr&eacute;ation de feuilles CSS externe, par exemple Adobe&reg;
Dreamweaver&reg;.
1) S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet.
2) Cliquez sur l'onglet Importer de la bo&icirc;te de dialogue Param&egrave;tres du projet. Proc&eacute;dez de l'une des
fa&ccedil;ons suivantes :
–
S&eacute;lectionnez le fichier CSS dans le menu CSS pour le mappage de styles.
–
Cliquez sur Ajouter, en regard du menu CSS pour la correspondance des styles, puis
s&eacute;lectionnez un fichier CSS.
Cette option permet de sp&eacute;cifier un fichier CSS personnalis&eacute; pour le projet. Lorsque vous
s&eacute;lectionnez cette option, RoboHelp copie le fichier CSS s&eacute;lectionn&eacute; vers le dossier &agrave; la racine
du projet, puis l'utilise pour la correspondance des styles.
Mise &agrave; niveau de RoboHelp 7 vers RoboHelp 11
RoboHelp 7 prenait en charge les param&egrave;tres de conversion au niveau du document pour les documents
FrameMaker ajout&eacute;s &agrave; un projet RoboHelp. Dans RoboHelp 8, les param&egrave;tres de conversion sont
appliqu&eacute;s au niveau du projet, ce qui vous permet d'obtenir un ensemble de param&egrave;tres coh&eacute;rent. Si
vous ouvrez un projet RoboHelp 7 dont les documents FrameMaker ont &eacute;t&eacute; ajout&eacute;s par r&eacute;f&eacute;rence ou par
copie, vous pouvez conserver les param&egrave;tres sp&eacute;cifiques au document d&eacute;finis dans le projet RoboHelp 7.
Vous pouvez ajouter ou supprimer des documents dans un projet mis &agrave; niveau avec les param&egrave;tres de
conversion au niveau du document. Vous pouvez &eacute;galement d&eacute;finir des param&egrave;tres de conversion au
niveau du document pour les documents FrameMaker que vous ajoutez. Cette option vous permet de
conserver le comportement RoboHelp 7 dans votre projet mis &agrave; niveau. Cependant, pour b&eacute;n&eacute;ficier des
fonctionnalit&eacute;s am&eacute;lior&eacute;es de RoboHelp 9 et de son int&eacute;gration &agrave; FrameMaker, la mise &agrave; niveau compl&egrave;te
du projet est recommand&eacute;e. Par exemple, RoboHelp 7 fournissait des options de mappage limit&eacute;es pour
la num&eacute;rotation automatique et les styles de liste. En revanche, RoboHelp 8 permet de mapper des
formats de num&eacute;rotation automatique complexes et des styles de liste &agrave; plusieurs niveaux &agrave; des styles
RoboHelp ou &agrave; des listes HTML. Dans RoboHelp 9, l'importation de listes et de tableaux est encore
am&eacute;lior&eacute;e.
REMARQUE : Vous pouvez rejeter les param&egrave;tres de document &agrave; tout moment, m&ecirc;me si vous avez choisi de
les conserver au moment de la mise &agrave; niveau. N&eacute;anmoins, si vous d&eacute;cidez de les rejeter, vous ne pourrez
pas les r&eacute;cup&eacute;rer.
Conservation ou rejet des param&egrave;tres RoboHelp 7 lors de la mise &agrave; niveau
98
CHAPITRE 3
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
Pour conserver les param&egrave;tres de document afin de convertir du contenu FrameMaker vers votre projet
RoboHelp, vous devez remplacer les param&egrave;tres de projet pour le projet converti par les param&egrave;tres de
document h&eacute;rit&eacute;s du projet RoboHelp 7. Par d&eacute;faut, RoboHelp vous permet de conserver les param&egrave;tres
de document en rempla&ccedil;ant ceux du projet.
1) Ouvrez le projet RoboHelp 7 dans RoboHelp 9.
2) S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet.
3) Dans l'onglet Importer de la bo&icirc;te de dialogue Param&egrave;tres du projet, proc&eacute;dez de l'une des fa&ccedil;ons
suivantes :
–
Pour conserver les param&egrave;tres de document dans le projet mis &agrave; niveau, s&eacute;lectionnez l'option
Remplacer les param&egrave;tres du projet au niveau du document. Il s'agit du comportement par
d&eacute;faut.
–
Pour rejeter les param&egrave;tres de document et utiliser les param&egrave;tres du projet, d&eacute;sactivez
l'option Remplacer les param&egrave;tres du projet au niveau du document.
Modification des param&egrave;tres de conversion au niveau du document
Si vous conservez les param&egrave;tres de document et remplacez ainsi les param&egrave;tres du projet pour un projet
converti &agrave; partir d'une version ant&eacute;rieure de RoboHelp, vous avez la possibilit&eacute; de modifier ces
param&egrave;tres.
1) Dans le conteneur de gestionnaire de projets, cliquez avec le bouton droit de la souris sur le
document FrameMaker ajout&eacute;, puis s&eacute;lectionnez Caract&eacute;ristiques.
2) Dans la bo&icirc;te de dialogue Propri&eacute;t&eacute;s du document FrameMaker, s&eacute;lectionnez l'onglet Param&egrave;tres
de conversion et d&eacute;finissez les options ci-apr&egrave;s.
Appliquer une expression FrameMaker de cr&eacute;ation de texte conditionnel
S&eacute;lectionnez cette option pour appliquer des param&egrave;tres de texte conditionnel avant de convertir
le document FrameMaker.
Convertir la num&eacute;rotation automatique en liste HTML
S&eacute;lectionnez cette option pour convertir la num&eacute;rotation automatique FrameMaker en listes HTML
dans les rubriques HTML converties.
Marqueur d'aide contextuelle
Sp&eacute;cifiez le marqueur d'aide contextuelle que RoboHelp doit utiliser pour g&eacute;n&eacute;rer l'aide contextuelle.
Balise HTML d&eacute;finie par l'utilisateur
S&eacute;lectionnez la balise HTML d&eacute;finie par l'utilisateur &agrave; utiliser au lieu des balises &lt;p&gt; standard dans
les rubriques g&eacute;n&eacute;r&eacute;es.
REMARQUE : Pour s&eacute;lectionner des formats FrameMaker sur lesquels cette balise doit &ecirc;tre appliqu&eacute;e,
s&eacute;lectionnez les formats appropri&eacute;s dans la bo&icirc;te de dialogue Param&egrave;tres du projet.
Mod&egrave;le de nom de rubrique
Sp&eacute;cifiez le syst&egrave;me de nom des rubriques g&eacute;n&eacute;r&eacute;es &agrave; partir du document FrameMaker.
99
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
CHAPITRE 3
Styles FrameMaker pour la pagination
Sp&eacute;cifiez la liste des formats de paragraphe FrameMaker sur lesquels une pagination pour rubriques
d'aide en ligne doit &ecirc;tre effectu&eacute;e. D&eacute;limitez les formats de paragraphe par des virgules.
3)
REMARQUE :
La pagination se base sur les formats de paragraphe FrameMaker.
Structure hi&eacute;rarchique d'un livre FrameMaker 9
FrameMaker 9 ou une version ult&eacute;rieure vous permet d'appliquer une structure ou un regroupement
hi&eacute;rarchique dans le livre. Elle vous permet &eacute;galement d'inclure des livres enfant dans un livre et de cr&eacute;er
des dossiers et des groupes dans un livre.
Lorsque vous liez ou importez un livre FrameMaker structur&eacute;, le conteneur de gestionnaire de projets
dans RoboHelp indique la hi&eacute;rarchie du livre. Une fois li&eacute;s ou import&eacute;s dans RoboHelp, les livres enfants
h&eacute;ritent de la table des mati&egrave;res, de l'index et du glossaire du livre parent. Voir Aide de FrameMaker pour
plus d'informations.
Hi&eacute;rarchie d'un livre FrameMaker affich&eacute;e dans le conteneur de gestionnaire de projets lors de la liaison de ce livre dans
RoboHelp
Conversion des formats de r&eacute;f&eacute;rences crois&eacute;es FrameMaker en styles RoboHelp
1)
2)
3)
4)
5)
S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet.
Dans l'onglet Importer de la bo&icirc;te de dialogue Param&egrave;tres du projet, sous Document FrameMaker,
cliquez sur Modifier.
S&eacute;lectionnez un format de r&eacute;f&eacute;rence crois&eacute;e dans le groupe R&eacute;f&eacute;rence crois&eacute;e de la bo&icirc;te de
dialogue Param&egrave;tres de conversion.
S&eacute;lectionnez un style RoboHelp pour le mapper ou saisissez le champ du style pour red&eacute;finir les
r&eacute;f&eacute;rences crois&eacute;es dans le document FrameMaker.
Cliquez deux fois sur une composante pour l'ajouter &agrave; la d&eacute;finition de la r&eacute;f&eacute;rence crois&eacute;e.
100
CHAPITRE 3
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
R&eacute;f&eacute;rence au contenu
Le texte ou les fichiers ins&eacute;r&eacute;s dans des documents FrameMaker en tant que contenu seront affich&eacute;s
comme faisant partie des rubriques dans lesquelles il y est fait r&eacute;f&eacute;rence. Ils ne s'affichent pas comme
r&eacute;f&eacute;rences dans les sorties d'aide en ligne. Voir Aide de FrameMaker pour plus d'informations.
Param&egrave;tres de conversion
RoboHelp vous permet de d&eacute;finir les param&egrave;tres de projet pour chaque type de source. Pour tous les
documents FrameMaker, vous ne d&eacute;finissez les param&egrave;tres de conversion qu'une seule fois. De la m&ecirc;me
mani&egrave;re, les param&egrave;tres de conversion des documents Microsoft Word restent les m&ecirc;mes pour les
documents Word import&eacute;s.
Les param&egrave;tres de conversion de projet garantissent la coh&eacute;rence non seulement dans votre projet, mais
dans plusieurs projets. Vous pouvez configurer un projet RoboHelp rapidement sans avoir &agrave; d&eacute;finir de
param&egrave;tres de conversion pour les paragraphes, les tableaux, les images, etc.
Ces param&egrave;tres sont les suivants :
•
D&eacute;finition d'un mod&egrave;le FrameMaker
•
Feuilles de style en cascade (CSS) pour les projets RoboHelp
•
Mise en correspondance de styles et formats FrameMaker avec des styles RoboHelp
•
Param&egrave;tres de conversion de format et d'image et bien d'autres param&egrave;tres
Exportation des param&egrave;tres de conversion
1)
2)
3)
S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet.
Dans l'onglet Importer, cliquez sur Exporter.
Sp&eacute;cifiez le nom du fichier des param&egrave;tres d'importation RoboHelp (ISF), puis cliquez sur
Enregistrer.
Importation des param&egrave;tres de conversion dans un projet
1)
2)
3)
S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet.
Dans l'onglet Importer, cliquez sur Parcourir.
S&eacute;lectionnez un fichier ISF et cliquez sur Ouvrir.
D&eacute;finition de la pagination et des noms de rubrique
Principes de base de la pagination
Lorsque vous liez ou importez un document FrameMaker, vous devez d&eacute;finir la mani&egrave;re dont le contenu
du fichier FrameMaker sera pagin&eacute; ou divis&eacute; en rubriques dans RoboHelp. Pour paginer un document
FrameMaker, vous pouvez s&eacute;lectionner un ou plusieurs styles de paragraphe (par exemple, En-t&ecirc;te 1)
et/ou un type de marqueur (par exemple, PageBreak) utilis&eacute;s dans le document.
REMARQUE : PageBreak est le type de marqueur par d&eacute;faut RoboHelp fourni dans le param&egrave;tre Rubriques
divis&eacute;es &agrave; l'aide du marqueur. Vous pouvez sp&eacute;cifier n'importe quel type de marqueur utilis&eacute; dans le
document FrameMaker pour la pagination.
101
CHAPITRE 3
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
Prenons un exemple. Si un document FrameMaker contient dix rubriques, et que chaque rubrique
contient des sous-rubriques, t&acirc;ches et tableaux, vous pouvez choisir de faire appara&icirc;tre chaque rubrique
en tant que fichier HTML s&eacute;par&eacute;. Si chaque en-t&ecirc;te de ces rubriques est au format En-t&ecirc;te 1, vous pouvez
faire en sorte que chaque rubrique En-t&ecirc;te 1 soit cr&eacute;&eacute;e en tant que rubrique HTML s&eacute;par&eacute;e. Par ailleurs,
si vous d&eacute;finissez la pagination au format En-t&ecirc;te 2, des fichiers HTML distincts sont cr&eacute;&eacute;s pour chaque
rubrique En-t&ecirc;te 2. Si vous s&eacute;lectionnez les deux En-t&ecirc;te 1 et En-t&ecirc;te 2 pour la pagination, le contenu
entre deux rubriques cons&eacute;cutives de ces styles de paragraphe est utilis&eacute; pour cr&eacute;er une rubrique.
REMARQUE : RoboHelp divise les documents FrameMaker en rubriques &agrave; l'aide des styles de paragraphe
et/ou du type de marqueur sp&eacute;cifi&eacute;s. Le texte de style de paragraphe/texte de marqueur est inclus par
d&eacute;faut dans le nom du fichier de rubrique cr&eacute;&eacute;. Tous les caract&egrave;res non ASCII figurant dans le noms du
fichier de la rubrique sont automatiquement convertis en caract&egrave;res ASCII.
Pour paginer un document &agrave; l'aide de marqueurs, appliquez les marqueurs dans les paragraphes o&ugrave; vous
souhaitez cr&eacute;er les rubriques et s&eacute;lectionnez le type de marqueur dans RoboHelp. Vous pouvez, par
exemple, appliquer les marqueurs PageBreak &agrave; tous les paragraphes En-t&ecirc;te 1 dans le document
FrameMaker.
Dans certains cas, vous pouvez utiliser une combinaison de styles de paragraphe et un type de marqueur
pour la pagination. Par exemple, vous souhaitez paginer au niveau de tous les paragraphes En-t&ecirc;te 1 et
de certains paragraphes En-t&ecirc;te 2. Dans ce cas, appliquez les marqueurs PageBreak aux paragraphes
En-t&ecirc;te 2 respectifs dans le document FrameMaker, puis s&eacute;lectionnez le style de paragraphe En-t&ecirc;te 1
pour la pagination et le type de marqueur PageBreak dans RoboHelp.
Vous pouvez m&ecirc;me arr&ecirc;ter la pagination d'un document sur un style de paragraphe particulier en
appliquant un type de marqueur PageBreak avec le texte du marqueur &lt;NoSplit&gt;.
REMARQUE : Le texte du marqueur &lt;NoSplit&gt; n'est pas sensible &agrave; la casse.
Si RoboHelp ne trouve aucun contenu entre deux paragraphes cons&eacute;cutifs, il ne paginera pas ni ne
fractionnera les paragraphes en rubriques en fonction du param&egrave;tre de style de paragraphe pour la
pagination. Vous pouvez appliquer un marqueur PageBreak au deuxi&egrave;me paragraphe pour indiquer
explicitement que des rubriques diff&eacute;rentes doivent &ecirc;tre cr&eacute;&eacute;es.
REMARQUE : PageBreak est un exemple. Vous pouvez appliquer un marqueur de mani&egrave;re coh&eacute;rente pour
la pagination et le sp&eacute;cifier dans le param&egrave;tre Rubriques divis&eacute;es &agrave; l'aide du marqueur.
Suivez ces recommandations pour la pagination d'un document :
Exhaustivit&eacute; du contenu de la rubrique
V&eacute;rifiez que la rubrique g&eacute;n&eacute;r&eacute;e contient des informations pertinentes et compl&egrave;tes pour le lecteur.
Si, par exemple, vous d&eacute;finissez la pagination au niveau Intitul&eacute; 3 pour un paragraphe, il est possible
que la rubrique contienne uniquement les informations de t&acirc;ches, sans les informations
contextuelles n&eacute;cessaires abord&eacute;es dans une autre rubrique Intitul&eacute; 3. Pour &eacute;viter cela, d&eacute;finissez
la pagination &agrave; un niveau sup&eacute;rieur afin qu'une seule rubrique contienne toutes les informations
n&eacute;cessaires.
Texte de liste d&eacute;roulante
V&eacute;rifiez que le format de paragraphe du corps de texte d&eacute;roulant n'est pas d&eacute;fini pour la pagination.
Les paragraphes auxquels ce format est appliqu&eacute; doivent accompagner le format de paragraphe de
la l&eacute;gende du texte de la liste d&eacute;roulante. Voir Optimisation pour la sortie en ligne avant conversion.
102
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
CHAPITRE 3
Principes de base de nom de rubrique
Lorsque vous avez d&eacute;fini les styles d'intitul&eacute; pour la pagination, le texte d'intitul&eacute; devient le nom par
d&eacute;faut du fichier de rubrique cr&eacute;&eacute; dans RoboHelp. Prenons l'exemple d'un Intitul&eacute; 2 d&eacute;fini pour la
pagination et d'un document FrameMaker qui comporte deux rubriques Intitul&eacute; 2, Introduction et
Explication. Dans ce cas, RoboHelp cr&eacute;e les rubriques Introduction et Allez plus loin que les principes de
base avec les noms de fichier introduction.htm et beyond_basics.htm. Vous obtenez ainsi des fichiers
HTML dont le nom indique le titre de la rubrique.
RoboHelp prend en charge plusieurs fa&ccedil;ons de personnaliser les noms de rubrique dans les situations
suivantes :
Pagination bas&eacute;e sur le style
Les rubriques sont nomm&eacute;es en fonction du mod&egrave;le que vous s&eacute;lectionnez dans l'onglet Autres
param&egrave;tres de la bo&icirc;te de dialogue Param&egrave;tres de conversion. Vous pouvez s&eacute;lectionner l'une des
options suivantes ou cr&eacute;er un mod&egrave;le de nom de rubrique &agrave; l'aide des blocs fonctionnels Mod&egrave;le
de nom de rubrique fournis par RoboHelp. En outre, vous pouvez ajouter texte statique, tel que
&laquo; Rubrique d'aide &raquo;, suivi d'un &lt;n&gt; pour cr&eacute;er des rubriques comme par exemple Rubrique d'aide 1,
Rubrique d'aide 2 et ainsi de suite.
Mod&egrave;le de nom de rubrique
Description
par d&eacute;faut
La rubrique HTML g&eacute;n&eacute;r&eacute;e dispose du texte du paragraphe
comme le titre de la rubrique et le nom du fichier.
&lt;$filename_no_ext&gt;-&lt;$paratext&gt;
La rubrique HTML g&eacute;n&eacute;r&eacute;e dispose du nom de fichier compos&eacute;
du nom de fichier du document FrameMaker sans l'extension
.fm et du texte de paragraphe, s&eacute;par&eacute;s par un trait d'union.
Par exemple, le document FrameMaker portant le nom
&laquo; Chapter.fm &raquo; ayant comme texte de paragraphe
&laquo; 1-Introduction &raquo; est converti en rubrique HTML avec le titre
&laquo; Chapter-1-Introduction &raquo; et le nom de fichier
&laquo; Chapter-1-Introduction.htm &raquo;
&lt;$filename_no_ext&gt;-&lt;n&gt;
Le nom de fichier de la rubrique HTML g&eacute;n&eacute;r&eacute;e se compose du
nom de fichier du document FrameMaker sans l'extension .fm
et du num&eacute;ro du paragraphe, s&eacute;par&eacute;s par un trait d'union. Par
exemple, le document FrameMaker &laquo; Chapter.fm &raquo; est
converti en une rubrique HTML avec le titre &laquo; Chapter-1 &raquo; et le
nom de fichier &laquo; Chapter-1.htm &raquo;
103
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
CHAPITRE 3
Mod&egrave;le de nom de rubrique
Description
&lt;$texte_para_sans_num&eacute;ro&gt;
La rubrique HTML g&eacute;n&eacute;r&eacute;e dispose d'un nom de fichier
compos&eacute; de texte de paragraphe du format de paragraphe sur
lequel la pagination est d&eacute;finie, sans le num&eacute;ro de paragraphe.
Par exemple, un paragraphe d'en-t&ecirc;te 1 &laquo; 1. Introduction &raquo; est
converti en rubrique HTML avec le titre &laquo; Introduction &raquo; et le
nom de fichier &laquo; Introduction.htm &raquo;
&lt;$paratext&gt;
Le nom de fichier de la rubrique HTML se compose du texte du
paragraphe du format pour lequel la pagination est d&eacute;finie.
Par exemple, un paragraphe d'en-t&ecirc;te 1 &laquo; Introduction &raquo; est
converti en rubrique HTML avec le m&ecirc;me titre et le nom de
fichier &laquo; Introduction.htm &raquo;
Pagination en fonction de marqueur
Pour attribuer un nom &agrave; des rubriques bas&eacute;es sur le marqueur utilis&eacute; pour la pagination, configurez
chaque marqueur dans le document FrameMaker et sp&eacute;cifiez le nom de fichier et le titre comme
texte de marqueur dans le nom de fichier | format de titre.
REMARQUE : Le nom de fichier et le titre sont facultatifs. Si vous ne sp&eacute;cifiez pas de nom de fichier (par
exemple, vous pouvez sp&eacute;cifier | &lt;title&gt;), RoboHelp cr&eacute;e un nom de fichier valide &agrave; partir du titre. Si vous
ne sp&eacute;cifiez pas un titre (par exemple, vous sp&eacute;cifiez &lt;filename&gt;), RoboHelp cr&eacute;e le titre &agrave; partir du
mod&egrave;le de nom de rubrique. Si le texte du marqueur est vide, RoboHelp utilise le mod&egrave;le de nom de
rubrique pour cr&eacute;er la titre de rubrique et un nom de fichier valide.
D&eacute;finir la pagination et les noms de rubrique
1)
2)
3)
4)
5)
S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet.
Dans l'onglet Importer de la bo&icirc;te de dialogue Param&egrave;tres du projet, cliquez sur Modifier sous
Document FrameMaker.
Pour diviser le document en rubriques, proc&eacute;dez &agrave; l'une ou l'autre ou les deux &eacute;tapes suivantes :
–
Dans l'onglet Styles de paragraphe, s&eacute;lectionnez un style de paragraphe pour diviser le
document sur ce style de paragraphe.
–
Dans l'onglet Autres param&egrave;tres, s&eacute;lectionnez Rubriques divis&eacute;es &agrave; l'aide de marqueur et
sp&eacute;cifiez un marqueur qui est utilis&eacute; dans le document FrameMaker pour la pagination.
Par d&eacute;faut, RoboHelp attribue un nom &agrave; des rubriques sur base du texte de paragraphe des styles
qui sont utilis&eacute;s pour paginer le document FrameMaker. Pour sp&eacute;cifier une autre convention
d'appellation de rubriques qui sont cr&eacute;&eacute;s en fonction de styles de paragraphe, s&eacute;lectionnez un
mod&egrave;le de nom de rubrique dans la liste de mod&egrave;le de nom de rubrique ou sp&eacute;cifiez un mod&egrave;le
personnalis&eacute;.
Cliquez sur OK.
104
CHAPITRE 3
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
Conversion des marqueurs d'aide contextuelle de documents FrameMaker
Vous pouvez convertir les marqueurs d'aide contextuelle que vous ins&eacute;rez dans vos documents
FrameMaker et les r&eacute;utiliser en tant qu'ID de mappage. Vous indiquez le marqueur d'aide contextuelle
dans la bo&icirc;te de dialogue Param&egrave;tres du projet avant de lier des documents FrameMaker. Vous pouvez
&eacute;galement sp&eacute;cifier ce param&egrave;tre lorsque vous importez des documents FrameMaker. Vous pouvez
utiliser les marqueurs d'aide contextuelle dans les documents FrameMaker de deux mani&egrave;res :
Conversion automatique des ID de mappage depuis les documents FrameMaker
Vous appliquez les marqueurs d'aide contextuelle dans vos documents FrameMaker et indiquez le
type de marqueur dans les param&egrave;tres de conversion. RoboHelp importe les marqueurs des
documents FrameMaker et ajoute les ID de mappage des cha&icirc;nes contenues dans les marqueurs
d'aide contextuelle.
Ajout manuel d'un fichier d'ID de mappage
Si vous avez re&ccedil;u des ID de mappage de votre &eacute;quipe de d&eacute;veloppement, vous les utilisez en tant
que cha&icirc;nes de texte pour le marqueur &agrave; utiliser en tant que marqueur d'aide contextuelle dans vos
documents FrameMaker. Vous cr&eacute;ez ult&eacute;rieurement un fichier d'ID de mappage en associant les ID
de mappage de l'&eacute;quipe de d&eacute;veloppement et le texte du marqueur d'aide contextuelle que vous
avez ins&eacute;r&eacute; dans les documents FrameMaker. Vous ajoutez ensuite ce fichier au projet. Lorsque vous
liez ou importez les fichiers FrameMaker, vous indiquez le marqueur d'aide contextuelle dans les
param&egrave;tres de conversion.
1)
2)
3)
S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet.
Dans l'onglet Importer de la bo&icirc;te de dialogue Param&egrave;tres du projet, sous Document FrameMaker,
cliquez sur Modifier.
Dans le groupe Autres param&egrave;tres de la bo&icirc;te de dialogue Param&egrave;tres de conversion, saisissez le
marqueur d'aide contextuelle.
Application d'expressions FrameMaker de cr&eacute;ation de texte conditionnel
Vous pouvez appliquer les param&egrave;tres Afficher/Masquer des expressions de construction de texte
conditionnel au contenu de vos documents FrameMaker import&eacute;s dans les projets RoboHelp. RoboHelp
importe le contenu apr&egrave;s avoir appliqu&eacute; les param&egrave;tres Afficher/Masquer au contenu FrameMaker. Le
texte masqu&eacute; n'est pas transf&eacute;r&eacute; dans le projet RoboHelp.
1) S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet.
2) Dans l'onglet Importer de la bo&icirc;te de dialogue Param&egrave;tres du projet, sous Document FrameMaker,
cliquez sur Modifier.
3) Dans le groupe Autres param&egrave;tres de la bo&icirc;te de dialogue Param&egrave;tres de conversion, s&eacute;lectionnez
Appliquer une expression de construction de texte conditionnel FrameMaker.
105
CHAPITRE 3
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
Conversion de contenu FrameMaker
Conversion des formats de paragraphes FrameMaker en styles RoboHelp
Par d&eacute;faut, RoboHelp convertit tous les formats de paragraphe de FrameMaker vers des styles CSS
RoboHelp, conservant ainsi l'apparence et le comportement des formats FrameMaker dans un projet
RoboHelp. Pour garantir la coh&eacute;rence des projets d'aide en ligne, faites correspondre les formats
FrameMaker aux styles RoboHelp et modifiez-les.
1) S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet.
2) Dans l'onglet Importer de la bo&icirc;te de dialogue Param&egrave;tres du projet, sous Document FrameMaker,
cliquez sur Modifier.
3) Dans le volet Param&egrave;tres de conversion, s&eacute;lectionnez le format FrameMaker dans le groupe
Paragraphe.
4) Dans le menu Style RoboHelp, s&eacute;lectionnez le style &agrave; mapper au format FrameMaker. Pour
conserver l'apparence du texte FrameMaker dans le format de l'aide, s&eacute;lectionnez [Source].
Pour modifier le style RoboHelp s&eacute;lectionn&eacute;, cliquez sur Modifier le style.
5) S&eacute;lectionnez les caract&eacute;ristiques du style RoboHelp mapp&eacute;.
Exclure du r&eacute;sultat
A s&eacute;lectionner pour ignorer le contenu du document FrameMaker auquel le format de paragraphe
FrameMaker s&eacute;lectionn&eacute; est appliqu&eacute;.
Pagination (Divis&eacute;e en rubriques sur base de ce style)
S&eacute;lectionnez cette option pour cr&eacute;er une rubrique d'aide &agrave; chaque occurrence pour le format de
paragraphe FrameMaker s&eacute;lectionn&eacute;. Par exemple, si vous s&eacute;lectionnez En-t&ecirc;te 1 et Pagination
(divis&eacute;e en rubriques sur base de ce style), RoboHelp commence une nouvelle rubrique &agrave; chaque
instance de l'En-t&ecirc;te 1.
Balise HTML d&eacute;finie par l'utilisateur
A s&eacute;lectionner ou &agrave; saisir pour le format de paragraphe s&eacute;lectionn&eacute;.
Si les propri&eacute;t&eacute;s de num&eacute;rotation automatique sont d&eacute;finies pour le format FrameMaker
s&eacute;lectionn&eacute;, indiquez comment la num&eacute;rotation automatique est convertie.
LIENS CONNEXES :
Mise en correspondance des styles de num&eacute;rotation automatique
Cr&eacute;ation d'un projet
Conversion des formats de caract&egrave;res FrameMaker en styles RoboHelp
Vous pouvez mapper les formats de caract&egrave;res FrameMaker avec les styles de caract&egrave;re de RoboHelp.
Vous pouvez &eacute;galement modifier les styles dans RoboHelp.
1) S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet.
2) Dans l'onglet Importer de la bo&icirc;te de dialogue Param&egrave;tres du projet, sous Document FrameMaker,
cliquez sur Modifier.
106
CHAPITRE 3
3)
4)
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
S&eacute;lectionnez le format de caract&egrave;re FrameMaker dans le volet gauche de la bo&icirc;te de dialogue
Param&egrave;tres de conversion.
S&eacute;lectionnez le style de caract&egrave;re RoboHelp dans le menu contextuel. (Facultatif) Vous pouvez
&eacute;galement proc&eacute;der comme suit :
–
Pour importer le format de caract&egrave;re FrameMaker, s&eacute;lectionnez [Source] dans le menu
contextuel.
–
Pour modifier le style RoboHelp s&eacute;lectionn&eacute;, cliquez sur Modifier le style.
–
Pour exclure le texte dans le document FrameMaker auquel est appliqu&eacute; le format de
caract&egrave;re s&eacute;lectionn&eacute;, s&eacute;lectionnez Exclure du r&eacute;sultat.
–
Pour appliquer une balise HTML d&eacute;finie par l'utilisateur au texte import&eacute; dans la sortie HTML,
s&eacute;lectionnez Balise HTML d&eacute;finie par l'utilisateur, puis la balise dans le menu contextuel. Vous
pouvez &eacute;galement saisir une nouvelle balise HTML. La balise HTML personnalis&eacute;e du format
de caract&egrave;re remplace la balise &lt;span&gt; dans le fichier HTML g&eacute;n&eacute;r&eacute;.
Exclusion d'un format de paragraphe FrameMaker des rubriques RoboHelp
Vous pouvez exclure de la sortie convertie le contenu de documents FrameMaker ayant un format de
paragraphe sp&eacute;cifi&eacute;. Cette option permet de supprimer du contenu qui n'est pas requis dans la sortie en
ligne, par exemple des notes sp&eacute;ciales.
1) S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet.
2) Dans l'onglet Importer de la bo&icirc;te de dialogue Param&egrave;tres du projet, sous Document FrameMaker,
cliquez sur Modifier.
3) Dans les param&egrave;tres du projet, s&eacute;lectionnez un format de paragraphe dans le volet de gauche.
4) Cliquez sur Exclure du r&eacute;sultat.
Balises HTML personnalis&eacute;es
Vous pouvez d&eacute;finir ou appliquer une balise HTML personnalis&eacute;e pour remplacer la balise standard &lt;p&gt;
pour les styles de paragraphe et la balise &lt;span&gt; pour les styles de caract&egrave;re dans la sortie HTML pour les
formats que vous importez &agrave; partir de FrameMaker. Vous pouvez d&eacute;finir des balises HTML distinctes pour
chaque format du document FrameMaker.
1) S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet.
2) Dans l'onglet Importer de la bo&icirc;te de dialogue Param&egrave;tres du projet, sous Document FrameMaker,
cliquez sur Modifier.
3) Dans la bo&icirc;te de dialogue Param&egrave;tres de conversion, s&eacute;lectionnez l'option Balise HTML d&eacute;finie par
l'utilisateur.
4) Tapez le nom de la balise HTML personnalis&eacute;e ou s&eacute;lectionnez une balise existante &agrave; utiliser &agrave; la
place de la balise HTML par d&eacute;faut.
Mise en correspondance des styles de num&eacute;rotation automatique
S&eacute;lectionnez le param&egrave;tre pour convertir les formats de num&eacute;rotation automatique du document
FrameMaker au format de l'aide. Si le document FrameMaker contient des listes num&eacute;rot&eacute;es
hi&eacute;rarchiques, vous pouvez s&eacute;lectionner l'une des options suivantes.
107
CHAPITRE 3
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
Ignorer la num&eacute;rotation automatique
S&eacute;lectionnez cette option si le texte de la num&eacute;rotation automatique est important pour la version
imprim&eacute;e uniquement. Le paragraphe converti ne contient pas de num&eacute;rotation automatique. Vous
pouvez par exemple choisir d'ignorer la num&eacute;rotation automatique pour le format de paragraphe
FrameMaker Niveau Section2. Dans ce cas, le texte Section 1.1: Configuration requise dans la
source deviendra Configuration requise dans la rubrique RoboHelp g&eacute;n&eacute;r&eacute;e.
Convertir la num&eacute;rotation automatique en texte
S&eacute;lectionnez cette option pour conserver l'apparence des listes num&eacute;rot&eacute;es FrameMaker. La partie
de num&eacute;rotation automatique perd ses propri&eacute;t&eacute;s de s&eacute;quencement et appara&icirc;t sous forme de
texte de paragraphe dans la rubrique RoboHelp.
Convertir la num&eacute;rotation automatique en liste HTML
S&eacute;lectionnez cette option pour convertir la num&eacute;rotation automatique en listes HTML &agrave; l'aide de
balises telles que &lt;ol&gt;, &lt;ul&gt; et &lt;li&gt;.
Convertir la num&eacute;rotation automatique en liste RoboHelp
S&eacute;lectionnez cette option si vous souhaitez modifier les rubriques HTML g&eacute;n&eacute;r&eacute;es dans RoboHelp
ou utiliser les styles RoboHelp pour contr&ocirc;ler les propri&eacute;t&eacute;s de num&eacute;rotation.
Sc&eacute;narios de mise en correspondance de listes
RoboHelp vous permet de convertir les propri&eacute;t&eacute;s de liste des formats de paragraphes FrameMaker de
plusieurs fa&ccedil;ons. Etudiez les sc&eacute;narios ci-dessous.
Mappage d'une liste num&eacute;rot&eacute;e FrameMaker avec [Source]
La caract&eacute;ristique de num&eacute;rotation automatique du format de paragraphe FrameMaker est convertie en
liste en fonction des param&egrave;tres d&eacute;finis pour ce format de paragraphe.
Ignorer la num&eacute;rotation automatique
La partie num&eacute;rot&eacute;e du format de paragraphe FrameMaker est ignor&eacute;e. Le style de paragraphe
converti dans la rubrique RoboHelp ne contient pas la liste.
Convertir la num&eacute;rotation automatique en texte
La partie num&eacute;rot&eacute;e du paragraphe est convertie en texte et fera partie du texte du paragraphe
dans la rubrique RoboHelp.
Convertir le champ de num&eacute;rotation automatique en liste HTML
Le format de num&eacute;rotation automatique est converti en &eacute;l&eacute;ments de liste HTML utilisant des balises
telles que &lt;ol&gt;, &lt;ul&gt; et &lt;li&gt;.
108
CHAPITRE 3
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
Convertir la num&eacute;rotation automatique en liste RoboHelp
Les caract&eacute;ristiques de num&eacute;rotation automatique du style de paragraphe sont converties en liste
RoboHelp.
Exemple :
•
Cr&eacute;ez un style de paragraphe FM_Para1 dans FrameMaker, avec une num&eacute;rotation automatique
d&eacute;finie en tant que &lt;a+&gt; et appliquez-le aux paragraphes. Ils seront ainsi class&eacute;s selon le format a,
b, c, etc.
•
Faites correspondre ce format &agrave; [Source].
Le style de liste est appliqu&eacute; aux paragraphes g&eacute;n&eacute;r&eacute;s dans les rubriques RoboHelp. Les caract&eacute;ristiques
de la liste sont identiques &agrave; celles du document source.
Mappage d'une liste num&eacute;rot&eacute;e FrameMaker avec le style non num&eacute;rot&eacute; RoboHelp
Vous pouvez mapper un format de paragraphe FrameMaker avec des caract&eacute;ristiques de num&eacute;rotation
automatique &agrave; un style de paragraphe RoboHelp qui n'est li&eacute; &agrave; aucun style de liste. Dans ce cas, la
num&eacute;rotation automatique est convertie en liste en fonction des param&egrave;tres de conversion d&eacute;finis pour
le format de paragraphe.
Ignorer la num&eacute;rotation automatique
La num&eacute;rotation automatique de paragraphe FrameMaker est ignor&eacute;e et n'appara&icirc;t pas dans la
rubrique RoboHelp. mais le style de paragraphe est mapp&eacute;.
Convertir la num&eacute;rotation automatique en texte
La partie num&eacute;rot&eacute;e FrameMaker est convertie en texte et fera partie du texte du paragraphe dans
la rubrique RoboHelp. Le style de paragraphe est mapp&eacute;.
Convertir la num&eacute;rotation automatique en liste HTML
Le format de paragraphe FrameMaker est converti en &eacute;l&eacute;ments de liste HTML &agrave; l'aide de balises
HTML telles que &lt;ol&gt;, &lt;ul&gt; et &lt;li&gt;.
Convertir la num&eacute;rotation automatique en liste RoboHelp
Les caract&eacute;ristiques de num&eacute;rotation automatique du format de paragraphe FrameMaker sont
ignor&eacute;es. Le style de paragraphe est mapp&eacute;.
109
CHAPITRE 3
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
Mappage du format non num&eacute;rot&eacute; FrameMaker avec le style num&eacute;rot&eacute; RoboHelp
Dans ce cas, le paragraphe converti est pourvu du style de paragraphe RoboHelp et h&eacute;rite du style de liste
RoboHelp. Les options de conversion de la num&eacute;rotation automatique n'affectent pas le comportement
du paragraphe dans la rubrique RoboHelp.
Exemple :
•
Dans le document FrameMaker, cr&eacute;ez un format de paragraphe FM_Para 1 sans propri&eacute;t&eacute;s de
num&eacute;rotation automatique.
•
D&eacute;finissez un style de liste RoboHelp RH_Liste1 dans la feuille CSS de mise en correspondance de
style RH.
•
Cr&eacute;ez un style de paragraphe &laquo; Para1_RH &raquo; et liez le premier niveau du style de liste &laquo; Liste1_RH &raquo;
au style de paragraphe &laquo; Para1_RH &raquo;.
•
Mappez le style de paragraphe FrameMaker, &laquo; Para1_FM &raquo;, avec le style de paragraphe RoboHelp,
&laquo; Para1_RH &raquo;.
Le paragraphe g&eacute;n&eacute;r&eacute; dans la rubrique RoboHelp h&eacute;rite des caract&eacute;ristiques du style RH_Liste1.
Mappage d'une liste num&eacute;rot&eacute;e FrameMaker avec une liste non num&eacute;rot&eacute;e RoboHelp
Le paragraphe converti prend le style de paragraphe RoboHelp et h&eacute;rite du style de liste RoboHelp. Les
options de conversion de la num&eacute;rotation automatique n'affectent pas le comportement du paragraphe
dans la rubrique RoboHelp.
Exemple :
•
Dans FrameMaker, cr&eacute;ez le format de paragraphe FM_Para1, avec une num&eacute;rotation automatique
d&eacute;finie sous la forme &lt;a+&gt; et appliquez-le &agrave; un paragraphe. Ainsi, la liste tri&eacute;e du paragraphe sera
du type a, b, c, etc.
•
D&eacute;finissez le style de liste num&eacute;rique RH_Liste1 dans la feuille CSS de mise en correspondance de
styles RoboHelp, avec la d&eacute;finition du premier niveau &lt;x&gt;.
•
Dans RoboHelp, d&eacute;finissez un style de paragraphe &laquo; Para1_RH &raquo; et liez le premier niveau du style
de liste &laquo; Liste1_RH &raquo; au style de paragraphe &laquo; Para1_RH &raquo;.
•
Faites correspondre le format de paragraphe FrameMaker FM_Para1 au style de paragraphe
RoboHelp RH_Para1.
Le paragraphe g&eacute;n&eacute;r&eacute; dans la rubrique RoboHelp h&eacute;rite des caract&eacute;ristiques du style de liste RH_Liste1
et affiche une liste de type 1, 2, 3, etc.
Conversion des formats de tableaux FrameMaker en styles de tableau RoboHelp
Vous pouvez mapper les formats de tableaux FrameMaker avec les styles de tableau RoboHelp. Vous
pouvez &eacute;galement importer des formats de tableau &agrave; partir du document FrameMaker. Vous pouvez
&eacute;galement modifier les formats de tableaux dans RoboHelp. Dans le document FrameMaker, il est
impossible d'annuler la fusion des cellules. Les cellules fusionn&eacute;es dans un document FrameMaker
apparaissent n&eacute;anmoins comme telles dans la rubrique RoboHelp.
110
CHAPITRE 3
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
Si les formats de tableau FrameMaker contiennent des titres et des pieds de page de tableau, convertissez
s&eacute;par&eacute;ment ces formats de paragraphe FrameMaker en styles de paragraphe RoboHelp. Vous pouvez
choisir de conserver ou non la num&eacute;rotation automatique dans les styles de titre de tableau et sp&eacute;cifier
les caract&eacute;ristiques de num&eacute;rotation pour le style de paragraphe RoboHelp mapp&eacute;. Si par exemple les
formats de titre de tableau des documents FrameMaker incluent un num&eacute;ro de chapitre, comme Tableau
2-3 : R&eacute;sultats trimestriels, vous pouvez choisir d'ignorer la num&eacute;rotation automatique et conserver
uniquement le nom de ce tableau. Voir Sc&eacute;narios de mise en correspondance de listes.
1) S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet.
2) Dans l'onglet Importer de la bo&icirc;te de dialogue Param&egrave;tres du projet, sous Document FrameMaker,
cliquez sur Modifier.
3) S&eacute;lectionnez le format de tableau FrameMaker dans le volet gauche de la bo&icirc;te de dialogue
Param&egrave;tres de conversion.
Param&egrave;tres de conversion d'image
Certains documents FrameMaker, notamment ceux optimis&eacute;s pour une impression PDF haute qualit&eacute;,
contiennent des images au format EPS. Convertissez les images EPS aux formats d'image Web tels que
JPEG, GIF ou PNG pour l'aide en ligne.
Sp&eacute;cifiez les param&egrave;tres de conversion d'image dans la bo&icirc;te de dialogue Param&egrave;tres de conversion.
Utiliser Distiller pour g&eacute;n&eacute;rer une image
S&eacute;lectionnez cette option pour g&eacute;n&eacute;rer des formats d'image adapt&eacute;s au Web &agrave; partir de graphiques
li&eacute;s et ins&eacute;r&eacute;s dans des documents FrameMaker. Vous devez utiliser cette option notamment si vous
avez des formats graphiques vectoriels, tels qu'EPS ou AI, ou des graphiques contenant du texte.
Ne pas r&eacute;g&eacute;n&eacute;rer d'images
S&eacute;lectionnez cette option pour gagner du temps si vous importez &agrave; nouveau des documents
FrameMaker et n'avez pas besoin de mettre &agrave; jour les images dans le contenu import&eacute;.
Conserver les images 3D
S&eacute;lectionnez cette option pour convertir les graphiques 3D en fichier PDF avec le rendu 3D intact au
sein du fichier PDF. Pour vous assurer que l'image 3D conserve son rendu, activez l'incorporation
dans FrameMaker.
Dimensions
Sp&eacute;cifiez les dimensions des images. S&eacute;lectionnez l'une des options ci-dessous.
Mettre &agrave; l'&eacute;chelle
Mettez les images &agrave; l'&eacute;chelle en appliquant un pourcentage &agrave; la taille existante. Le rapport de
grandeur des images est conserv&eacute;.
Largeur et hauteur
Sp&eacute;cifiez la taille absolue de l'image en hauteur et en largeur, en nombre de points. S&eacute;lectionnez
Conserver le rapport de grandeur pour vous assurer que les images ne sont d&eacute;form&eacute;es.
111
CHAPITRE 3
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
REMARQUE : Pour convertir les images de documents FrameMaker &agrave; leurs dimensions r&eacute;elles, sp&eacute;cifiez une
hauteur et une largeur de 0 point. La balise &lt;img&gt; dans la version HTML g&eacute;n&eacute;r&eacute;e ne sp&eacute;cifie aucune
valeur de hauteur ou de largeur. La conversion ne tient pas compte des dimensions des cadres ancr&eacute;s
contenant les images.
Dimensions maximales
D&eacute;finissez les dimensions maximales des images au format en ligne. Les images qui exc&egrave;dent ces
dimensions sont automatiquement r&eacute;duites en proportion pour s'adapter &agrave; la taille maximale que
vous sp&eacute;cifiez. Si vous mettez &agrave; l'&eacute;chelle les images et sp&eacute;cifiez un rapport de grandeur, RoboHelp
les met &agrave; l'&eacute;chelle dans les dimensions maximales et conserve le rapport de grandeur.
Utilisez cette option pour ne pas avoir &agrave; faire d&eacute;filer verticalement ou horizontalement la fen&ecirc;tre
du navigateur pour visionner des images volumineuses. Exemple : si vous sp&eacute;cifiez la taille de la
fen&ecirc;tre sur 800 x 600 pixels, vous pouvez d&eacute;finir les dimensions maximales sur 640 x 480, afin que
les images n'exc&egrave;dent pas la taille de la fen&ecirc;tre.
Marges
Sp&eacute;cifiez les marges des images.
•
•
D&eacute;finissez des marges &eacute;gales pour tous les c&ocirc;t&eacute;s dans Tous les c&ocirc;t&eacute;s.
Pour d&eacute;finir des marges sur des c&ocirc;t&eacute;s particuliers, d&eacute;finissez-les c&ocirc;t&eacute; par c&ocirc;t&eacute;.
Bordures
D&eacute;finissez la bordure des images:
•
•
•
•
Pour d&eacute;finir une bordure uniforme sur tous les c&ocirc;t&eacute;s, s&eacute;lectionnez Tout dans le menu contextuel
Bordure. Vous pouvez &eacute;galement sp&eacute;cifier le c&ocirc;t&eacute; auquel appliquer la bordure dans le menu
contextuel.
Pour d&eacute;finir le style de bordure, s&eacute;lectionnez le style dans le menu contextuel Style.
Pour d&eacute;finir la couleur de bordure, s&eacute;lectionnez la couleur dans le menu contextuel Couleur.
Le menu d&eacute;roulant Largeur permet de d&eacute;finir la largeur de la bordure.
Format
D&eacute;finissez les param&egrave;tres de format, de profondeur de couleur et de qualit&eacute; des images Web
converties &agrave; partir des images du document FrameMaker.
En l'&eacute;tat
S&eacute;lectionnez cette option pour conserver les images au format actuel.
JPG
S&eacute;lectionnez cette option pour les images en couleurs, telles que des captures d'&eacute;cran ou des
photographies. Le format JPG, disposant d'une profondeur des couleurs &eacute;lev&eacute;e, offre une qualit&eacute;
optimale pour un affichage en ligne, mais cr&eacute;e des fichiers de grande taille. S&eacute;lectionnez cette
option pour les photographies.
112
CHAPITRE 3
IMPORTATION DE DOCUMENTS FRAMEMAKER
PROJETS
GIF
S&eacute;lectionnez cette option si le document FrameMaker contient des graphiques en mode point, tels
que des diagrammes sch&eacute;matiques.
BMP
S&eacute;lectionnez cette option uniquement pour de petites images telles que des ic&ocirc;nes et des logos. Les
images au format BMP sont de grandes dimensions et non compress&eacute;es, mais riches en couleurs et
de bonne qualit&eacute;. En outre, ces images ne s'adaptent pas ou n'offrent pas de bonnes possibilit&eacute;s de
compression. Par cons&eacute;quent, ce format n'est pas adapt&eacute; au Web.
PNG
S&eacute;lectionnez cette option pour les captures d'&eacute;cran.
Qualit&eacute; JPEG
D&eacute;finissez le pourcentage de qualit&eacute; pour les images JPG.
Profondeur de bit de couleur
D&eacute;finissez la profondeur de bit de couleur pour les images bitmap. Les formats JPG et PNG peuvent
avoir une profondeur de couleur de 8 ou 24 bits et les images BMP de 1, 4, 8, 16, 24 ou 32 bits. Les
images GIF peuvent &ecirc;tre associ&eacute;es uniquement &agrave; une profondeur des couleurs 8 bits.
Niveaux de gris
S&eacute;lectionnez cette option pour les images monochromes.
Conservation d'images converties
RoboHelp convertit les images et les cadres ancr&eacute;s dans les documents FrameMaker &agrave; chaque mise &agrave; jour
ou g&eacute;n&eacute;ration des rubriques. Vous pouvez ignorer la mise &agrave; jour des images si les images correspondantes
ou les fichiers SWF des cadres ancr&eacute;s correspondants sont d&eacute;j&agrave; pr&eacute;sents dans le projet RoboHelp. Utilisez
cette option dans les cas ci-dessous.
•
Vous ne souhaitez pas r&eacute;g&eacute;n&eacute;rer les images &agrave; chaque mise &agrave; jour du document FrameMaker.
•
Vous avez modifi&eacute; les images dans le projet RoboHelp &agrave; l'aide d'un autre outil de retouche d'images
et vous ne souhaitez pas &eacute;craser les images modifi&eacute;es.
•
Vous souhaitez conserver l'image g&eacute;n&eacute;r&eacute;e pr&eacute;c&eacute;demment dans le projet RoboHelp, alors que
l'image dans le document FrameMaker a &eacute;t&eacute; modifi&eacute;e.
Si le nom ou l'ordre d'apparition des images dans le document a chang&eacute;, vous devez d&eacute;sactiver cette
option et laisser RoboHelp mettre &agrave; jour les images.
1) Dans l'onglet Image de la bo&icirc;te de dialogue Param&egrave;tres de conversion, s&eacute;lectionnez Ne pas
r&eacute;g&eacute;n&eacute;rer les images.
113
IMPORTATION D'UN FICHIER DE MAPPAGE DITA
PROJETS
CHAPITRE 3
Cr&eacute;ation de texte de substitution pour des images
Pour cr&eacute;er du contenu accessible, cr&eacute;ez du texte de substitution (texte ALT) pour les images, afin de
permettre aux malvoyants d'y acc&eacute;der par le biais de lecteurs d'&eacute;cran. Si vous liez ou importez des livres
FrameMaker complets dans RoboHelp en vue d'une publication, ajoutez du texte de substitution aux
graphiques utilis&eacute;s dans les documents FrameMaker. Ces entr&eacute;es ne sont pas visibles dans les fichiers PDF,
mais s'affichent dans le contenu en ligne lorsque vous placez le pointeur de la souris sur les images. Voir
Aide de FrameMaker pour en savoir plus sur le texte de substitution pour les graphiques et les images.
3.8.
Importation d'un fichier de mappage DITA
Une carte DITA est comparable &agrave; une table des mati&egrave;res qui r&eacute;pertorie et lie les rubriques pour une sortie
sp&eacute;cifique. Les mappages DITA rassemblent les rubriques sous une s&eacute;quence et une hi&eacute;rarchie d&eacute;finies
selon le type d'informations &agrave; g&eacute;rer. Plusieurs mappages peuvent &ecirc;tre utilis&eacute;s, chacun d'entre eux
organisant les rubriques en fonction des besoins, selon qu'il s'agisse d'un manuel de r&eacute;f&eacute;rence, d'un
didacticiel ou d'une aide en ligne. Le fichier de mappage DITA a pour extension .ditamap.
Vous pouvez importer des fichiers de carte DITA dans RoboHelp pour g&eacute;n&eacute;rer une sortie XHTML. DITA
Open Toolkit traite les informations du fichier de mappage DITA et fournit la sortie XHTML. RoboHelp lit
la sortie XHTML pour g&eacute;n&eacute;rer les rubriques XHTML, la table des mati&egrave;res et l'index. RoboHelp affiche les
informations de traitement du kit d'outils DITA dans le conteneur Vue du r&eacute;sultat.
REMARQUE : RoboHelp d&eacute;pend de DITA Open Toolkit pour traiter le contenu de mappage DITA. RoboHelp
ne corrige pas les erreurs g&eacute;n&eacute;r&eacute;es par DITA Open Toolkit. Par exemple, si DITA Open Toolkit ne g&eacute;n&egrave;re pas
des fichiers transitionnels compatibles XHTML 1.0, RoboHelp ne g&eacute;n&egrave;re pas d'erreurs. Par cons&eacute;quent, les
rubriques XHTML g&eacute;n&eacute;r&eacute;es par l'importation d'un fichier de carte DITA ne contiennent pas la balise meta
&lt;meta name=&quot;generator&quot; content=&quot;Adobe RoboHelp - www.adobe.com&quot; /&gt;
REMARQUE : Le fichier XHTML doit comporter du XML bien form&eacute;.
1)
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez Projet &gt; Importer &gt; Carte DITA.
–
Dans le conteneur Gestionnaire de projets, cliquez avec le bouton droit de la souris sur le
dossier Fichiers de projet. S&eacute;lectionnez Importer, puis le type de fichier Carte DITA.
2)
3)
S&eacute;lectionnez un fichier de mappage DITA. Cliquez sur Ouvrir.
Dans la bo&icirc;te de dialogue Options de traitement de DITA Open Toolkit, sp&eacute;cifiez les options
suivantes :
Remplacer le fichier XSLT par d&eacute;faut pour la conversion
S&eacute;lectionnez un fichier XSL &agrave; utiliser pour la transformation des fichiers DITA en XHTML au lieu du
fichier XSL par d&eacute;faut utilis&eacute; par DITA Open Toolkit. Le param&egrave;tre &eacute;quivalent du traitement Ant du
fichier DITA Open Toolkit est args.xsl.
114
CHAPITRE 3
IMPORTATION D'UN FICHIER DE MAPPAGE DITA
PROJETS
Utiliser DITA Val pour le traitement conditionnel
Sp&eacute;cifiez un fichier DITA Val &agrave; utiliser pour le traitement conditionnel des fichiers DITA. Le fichier
XHTML est g&eacute;n&eacute;r&eacute; &agrave; partir du fichier Val. Un fichier DITA Val contient des informations de filtre, de
signalisation et de r&eacute;vision. Le param&egrave;tre &eacute;quivalent du traitement Ant du fichier DITA Open Toolkit
est args.filter.
Afficher les entr&eacute;es d'index dans les rubriques
S&eacute;lectionnez cette option pour afficher les entr&eacute;es d'index (marqu&eacute;es par &lt;indexterm&gt; dans les
rubriques DITA) dans les rubriques RoboHelp. Le param&egrave;tre &eacute;quivalent du traitement Ant du fichier
DITA Open Toolkit est args.indexshow.
Afficher le nom de fichier de l'image dans l'annotation
S&eacute;lectionnez cette option pour ajouter des annotations aux images affichant le nom de fichier de
l'image ou le chemin d'acc&egrave;s complet &agrave; inclure dans les rubriques. Le param&egrave;tre &eacute;quivalent du
traitement Ant du fichier DITA Open Toolkit est args.artlbl.
Inclure le brouillon et le contenu du nettoyage
S&eacute;lectionnez cette option pour inclure le brouillon et le contenu du nettoyage requis (&eacute;l&eacute;ments
identifi&eacute;s comme &agrave; traiter avant publication). Le param&egrave;tre &eacute;quivalent du traitement Ant du fichier
DITA Open Toolkit est args.draft.
S&eacute;lectionner le fichier XHTML &agrave; placer dans la zone d'en-t&ecirc;te (hdf)
S&eacute;lectionnez l'emplacement du fichier contenant le XHTML &agrave; placer dans la zone d'en-t&ecirc;te du
fichier de sortie. Le param&egrave;tre &eacute;quivalent du traitement Ant du fichier DITA Open Toolkit est
args.hdf.
S&eacute;lectionner le fichier XHTML &agrave; placer dans la zone corps-en-t&ecirc;te (hdr)
S&eacute;lectionnez l'emplacement du fichier contenant le XHTML &agrave; placer dans la zone corps-en-t&ecirc;te du
fichier de sortie. Le param&egrave;tre &eacute;quivalent du traitement Ant du fichier DITA Open Toolkit est
args.hdr.
S&eacute;lectionner le fichier XHTML &agrave; placer dans la zone corps-pied de page (ftr)
S&eacute;lectionnez l'emplacement du fichier contenant le XHTML &agrave; placer dans la zone corps-pied de page
du fichier de sortie. Le param&egrave;tre &eacute;quivalent du traitement Ant du fichier DITA Open Toolkit est
args.ftr.
R&eacute;pertoire personnel DITA Open Toolkit
S&eacute;lectionnez l'emplacement absolu du dossier personnel DITA Open Toolkit. Sp&eacute;cifiez le dossier
d'origine DITA Open Toolkit valide. Vous ne pr&eacute;cisez cet emplacement qu'une fois. Il n'est pas stock&eacute;
dans le registre. Vous pouvez modifier cet emplacement.
4)
Cliquez sur Terminer.
REMARQUE :
RoboHelp v&eacute;rifie l'emplacement des fichiers s&eacute;lectionn&eacute;s mais ne valide pas les fichiers car
DITA Open Toolkit traite toutes les informations.
115
IMPORTATION DE FICHIERS XML
PROJETS
CHAPITRE 3
3.9.
Importation de fichiers XML
Lorsque vous importez un fichier XML dans un projet existant, RoboHelp cr&eacute;e une rubrique pour le fichier
XML.
1) Dans le gestionnaire de projets, s&eacute;lectionnez le fichier de destination de l'importation.
2) S&eacute;lectionnez Projet &gt; Importer &gt; Fichier XML.
3) S&eacute;lectionnez un ou plusieurs fichiers XML. Cliquez sur Ouvrir.
4) S&eacute;lectionnez les options de votre choix dans la bo&icirc;te de dialogue de s&eacute;lection du gestionnaire
d'importation XML.
5) (Facultatif) Pour d&eacute;finir les options avanc&eacute;es, s&eacute;lectionnez Importer XML (CSS/XSL).
6) Cliquez sur Avanc&eacute;.
7) S&eacute;lectionnez l'option souhait&eacute;e :
Traiter comme du texte
Importez le fichier XML en tant que texte HTML sans formatage.
Traiter comme une vue d'arborescence XML
Importez le fichier XML dans la vue d'arborescence XML. HTML est import&eacute; sous forme de code.
Utiliser un fichier CSS/XSL personnalis&eacute;
S&eacute;lectionnez un fichier dans le menu contextuel.
8)
Cliquez sur OK.
REMARQUE : Si plusieurs rubriques import&eacute;es ont le m&ecirc;me nom de rubrique, cette erreur est due au fichier
XSL utilis&eacute; au cours du processus d'importation. Le fichier XSL utilis&eacute; pour transformer le fichier XML en
fichier HTML contient le champ sp&eacute;cifi&eacute; &lt;title&gt;. Modifiez le fichier XSL et importez de nouveau le fichier
XML.
S&eacute;lection du gestionnaire d'importation XML
Nom du gestionnaire
Les gestionnaires pr&eacute;d&eacute;finis sont les suivants :
Importer les fichiers DocBook en tant que rubriques
Un fichier DocBook est import&eacute; en tant que rubrique HTML.
Importer XML (CSS/XSL)
Si une feuille de style (fichier CSS ou XSL) est associ&eacute;e au fichier XML, le fichier est import&eacute; en tant
que rubrique HTML. Dans le cas contraire, le fichier est import&eacute; en tant que fichier HTML sans
contr&ocirc;le d'affichage.
116
CHAPITRE 3
IMPORTATION DE FICHIERS XML
PROJETS
Avanc&eacute;
Actif si vous s&eacute;lectionnez Importer XML (CSS/XSL). Cliquez sur ce bouton pour obtenir des options
d'importation suppl&eacute;mentaires.
Remplacer automatiquement les rubriques import&eacute;es d'une session pr&eacute;c&eacute;dente
Remplace les anciennes donn&eacute;es.
Valider XML avant importation
RoboHelp valide le fichier XML avant de l'importer.
Bo&icirc;te de dialogue Options d'importation XML avanc&eacute;es
Ces options ne sont disponibles pour l'importation de XML avec ce gestionnaire que s'il n'existe aucune
feuille de style XML associ&eacute;e.
Traiter comme du texte
Importe le fichier XML en tant que texte HTML sans formatage.
Traiter comme une vue d'arborescence XML
Importe le fichier XML dans la vue d'arborescence XML. HTML est import&eacute; sous forme de code.
Utiliser un fichier CSS/XSL personnalis&eacute;
S&eacute;lectionnez le fichier personnalis&eacute;.
REMARQUE : Vous pouvez cr&eacute;er et modifier les fichiers de gestionnaire personnalis&eacute;s &agrave; l'aide du
programme de supervision des gestionnaires XML et de l'&eacute;diteur de fichier de description de gestionnaire
(HDF).
A propos du Programme de supervision des gestionnaires XML
Les gestionnaires d&eacute;terminent la m&eacute;thode d'importation de XML. S&eacute;lectionnez l'un des gestionnaires
pr&eacute;d&eacute;finis ou cr&eacute;ez un gestionnaire personnalis&eacute; r&eacute;pondant &agrave; vos exigences. Vous pouvez s&eacute;lectionner un
gestionnaire &agrave; l'importation d'un fichier XML dans un projet ou &agrave; la g&eacute;n&eacute;ration d'une sortie XML.
Le programme de supervision des gestionnaires XML r&eacute;pertorie les fichiers de description de gestionnaire
(fichiers HDF) export&eacute;s &agrave; partir de l'&eacute;diteur HDF.
Fichiers de description de gestionnaire (fichiers HDF)
Contiennent des gestionnaires individuels et les fichiers n&eacute;cessaires pour effectuer la
transformation XML. Les fichiers HDF pr&eacute;d&eacute;finis sont organis&eacute;s par type (XHMTL, par exemple) et
contiennent tous les gestionnaires connexes :
DocBookS
Ce type de gestionnaire inclut : Importer DocBook en tant que rubriques, Exporter le projet vers
DocBook, Exporter des rubriques vers DocBook.
117
CHAPITRE 3
IMPORTATION DE PROJETS MICROSOFT HTML HELP
PROJETS
XHTML
Ce type de gestionnaire inclut : Importer XHTML (XML), Importer XHTML (XHTML), Exporter des
rubriques vers XHTML, Exporter le projet vers XHMTL.
XML/CSS
Ce type de gestionnaire inclut : Importer XML (CSS/XSL).
ASTUCE : Pour ouvrir un fichier HDF et afficher les gestionnaires qu'il contient, cliquez sur le signe plus situ&eacute;
&agrave; gauche d'un fichier HDF.
Modifier
Apr&egrave;s avoir s&eacute;lectionn&eacute; un fichier HDF (XHTML, par exemple) ou un gestionnaire sp&eacute;cifique, cliquez
ici pour ouvrir l'&eacute;diteur HDF et modifier un gestionnaire.
Supprimer
Apr&egrave;s avoir s&eacute;lectionn&eacute; un fichier HDF (XHTML, par exemple), cliquez ici pour supprimer tous les
gestionnaires du fichier.
Importer
Importe un gestionnaire existant.
REMARQUE : Initialement, un gestionnaire est un fichier HDF avec un sous-dossier de fichiers de support.
Pour transf&eacute;rer un fichier de gestionnaire de l'&eacute;diteur HDF vers ce programme, exportez le fichier HDF en
tant que fichier ZDF. Utilisez l'&eacute;diteur HDF pour cette t&acirc;che.
3.10. Importation de projets Microsoft HTML Help
Lorsque vous importez un fichier HHP, un nouveau fichier de projet RoboHelp (XPJ) est cr&eacute;&eacute;.
1) S&eacute;lectionnez Fichier &gt; Ouvrir le projet &gt; Chemin local ou r&eacute;seau.
2) Dans le menu Fichiers de type, s&eacute;lectionnez Projet HTML Help (*HHP).
3) Acc&eacute;dez au fichier HHP et ouvrez-le.
ASTUCE : Vous pouvez &eacute;galement importer des fichiers FrameMaker (.fm, .book et .mif), Word (.doc,
.docx), PDF et XML.
REMARQUE : Si vous utilisez un &eacute;diteur HTML diff&eacute;rent de l'&eacute;diteur de conception de pour cr&eacute;er votre
contenu, vous pouvez toujours utiliser RoboHelp pour le projet.
LIENS CONNEXES :
Editeurs HTML tiers
Editeurs HTML tiers
118
CHAPITRE 3
IMPORTATION DE PROJETS WINHELP
PROJETS
3.11. Importation de projets WinHelp
Vous pouvez importer le fichier WinHelp 4.0 (HLP) compil&eacute; ou le fichier de projet WinHelp (HPJ) dans un
projet.
Le fichier HPJ constitue le fichier d'organisation principal. Il contient tous les fichiers source. Lors de la
g&eacute;n&eacute;ration de WinHelp, RoboHelp cr&eacute;e un fichier HLP et un fichier CNT. Le fichier HLP ne contient pas les
rubriques exclues par une expression de construction conditionnelle, de sorte que le nouveau projet peut
ne pas refl&eacute;ter l'original.
Vous pouvez importer les fichiers HLP vers des projets HTML, mais le processus s'effectue plus facilement
avec le fichier HPJ.
Vous ne pouvez pas g&eacute;n&eacute;rer un fichier WinHelp &agrave; partir de RoboHelp HTML.
Importation des param&egrave;tres projet WinHelp
Fen&ecirc;tres contextuelles
Fen&ecirc;tres contextuelles dynamiques
Cr&eacute;e des liens affichant des fen&ecirc;tres contextuelles dont la dimension s'adapte au contenu. Tous les
formatages HTML sont pris en charge.
Hyperliens standard
Cr&eacute;e des liens qui s'ouvrent dans la fen&ecirc;tre dans laquelle le lien appara&icirc;t.
Aide Qu'est-ce que c'est ?
Fichiers de rubrique compos&eacute;s de texte uniquement
Cr&eacute;e et enregistre des rubriques au format texte uniquement (TXT). Cette option s'utilise pour les
rubriques d'aide Qu'est-ce que c'est ?
Fichiers HTML individuels
Cr&eacute;e et enregistre les rubriques en tant que rubriques HTML classiques pour les pages d'aide
contextuelle sur les fen&ecirc;tres.
Rubriques externes
Liens vers une rubrique HTML Help externe
Convertit des liens de rubrique WinHelp en liens de rubrique HTML dans les fichiers CHM externes.
Conserver les liens des rubriques WinHelp externes
Les rubriques HTML incluent des contr&ocirc;les de rubrique WinHelp. Utilisez cette option lors de la
liaison de rubriques HTML &agrave; des rubriques WinHelp.
119
CHAPITRE 3
IMPORTATION DE PROJETS WINHELP
PROJETS
Images
Convertit les images BMP en images GIF ou JPEG.
Puces/Num&eacute;rotation
Puces et num&eacute;rotation HHTML
(Param&egrave;tre recommand&eacute;) Convertit les listes num&eacute;rot&eacute;es et les listes &agrave; puce vers leur &eacute;quivalent
HTML &agrave; l'aide des balises HTML pur (&lt;ol&gt;, &lt;ul&gt;, &lt;li&gt;). Il s'agit de listes &agrave; puces ou &agrave; num&eacute;rotation
automatique. Les formatages de paragraphes sp&eacute;ciaux utilis&eacute;s dans les fichiers RTF ne sont pas
transf&eacute;r&eacute;s.
Texte format&eacute;
Conserve les retraits, l'espacement des lignes et d'autres formats de paragraphe issus des fichiers
RTF. Convertit les listes num&eacute;rot&eacute;es en listes num&eacute;rot&eacute;es d&eacute;finies dans le code du programme.
Convertit les &eacute;l&eacute;ments de liste &agrave; puce en symboles d&eacute;finis dans le code du programme.
Conseils :
•
•
Supprime les num&eacute;ros et puces d&eacute;finis dans le code du programme et les remplace par des listes &agrave;
puces et &agrave; num&eacute;rotation automatique dans l'&eacute;diteur de conception.
Cr&eacute;e des styles sp&eacute;ciaux de liste &agrave; puce et de liste num&eacute;rot&eacute;e et les applique aux paragraphes apr&egrave;s
leur conversion.
Options d'importation des dossiers WinHelp
Dossier de fichiers HTML
Ne pas cr&eacute;er de sous-dossier
Enregistrer toutes les rubriques HTML &agrave; la racine du dossier de projet.
Cr&eacute;er un sous-dossier
Enregistrer toutes les rubriques HTML dans un sous-dossier.
Cr&eacute;er des sous-dossiers bas&eacute;s sur des noms de documents source
Cr&eacute;e et enregistre des rubriques HTML dans des sous-dossiers bas&eacute;s sur les fichiers DOC.
Cr&eacute;er des sous-dossiers bas&eacute;s sur la structure de la table des mati&egrave;res
Cr&eacute;e et enregistre des rubriques HTML dans des sous-dossiers bas&eacute;s sur la table des mati&egrave;res
WinHelp. Les livres se trouvant dans un livre sont cr&eacute;&eacute;s en tant que sous-dossiers du dossier
correspondant. Toutes les rubriques non utilis&eacute;es dans la table des mati&egrave;res WinHelp sont
enregistr&eacute;es &agrave; la racine du dossier de projet.
120
CHAPITRE 3
IMPORTATION DE PROJETS WINHELP
PROJETS
Dossiers pour les images
Ne pas cr&eacute;er de sous-dossier
Enregistrer tous les fichiers image &agrave; la racine du dossier de projet
Cr&eacute;er un sous-dossier
Enregistre tous les fichiers image dans un sous-dossier.
Options du fichier
Extension de fichier HTML
Enregistre toutes les rubriques HTML en utilisant l'extension s&eacute;lectionn&eacute;e.
Toujours utiliser des minuscules
Enregistre les extensions de nom de fichier en minusScules. S&eacute;lectionnez cette option pour les
serveurs UNIX&reg;.
Options d'importation du formatage WinHelp
Fonctionne avec ou sans feuille de style. Sans feuille de style, les rubriques sont format&eacute;es &agrave; l'aide des
styles en ligne. Pour les feuilles de style externes, cr&eacute;ez des feuilles de style selon le formatage des
documents WinHelp ou s&eacute;lectionnez une feuille de style d&eacute;j&agrave; utilis&eacute;e.
Styles en ligne (sans feuille de style externe)
Convertit tout le formatage en styles en ligne HTML. Avec cette option, aucun style et aucune feuille
de style ne sont cr&eacute;&eacute;s ni appliqu&eacute;s aux rubriques. Le formatage est contr&ocirc;l&eacute; par paragraphe et par
caract&egrave;re. Appliquez les styles apr&egrave;s avoir import&eacute; le projet. Appliquez manuellement les attributs
de caract&egrave;re et de paragraphe aux nouvelles rubriques.
Feuilles de style externes (une pour chaque document source)
Cr&eacute;e une feuille de style pour chaque fichier DOC import&eacute;.
Feuille de style externe bas&eacute;e sur un document source
Cr&eacute;e une feuille de style externe unique bas&eacute;e sur un fichier DOC. Les noms et formatages utilis&eacute;s
dans la feuille de style sont identiques aux styles d&eacute;finis dans les documents WinHelp. Le texte de
la rubrique HTML est format&eacute; &agrave; l'aide de ces styles.
Feuille de style externe bas&eacute;e sur une feuille de style existante
Relie une feuille de style &agrave; toutes les rubriques. Chaque style d&eacute;fini dans les fichiers DOC doit &ecirc;tre
li&eacute; &agrave; un style unique de la feuille de style et inversement. Cette contrainte inclut les noms des styles.
Appliquez les styles aux paragraphes et caract&egrave;res qui les utilisent. Avec une telle relation
biunivoque entre les styles, les styles des rubriques HTML perdent les m&ecirc;mes noms et formatages
que les styles des documents WinHelp.
121
CHAPITRE 3
IMPORTATION DE PROJETS WINHELP
PROJETS
Options d'importation g&eacute;n&eacute;rales WinHelp
Volet de navigation
Table des mati&egrave;res
l'onglet Table des mati&egrave;res affiche les livres et les pages contenus dans la table des mati&egrave;res. l'index
affiche les mots-cl&eacute;s.
Glossaire
Fournit les d&eacute;finitions du syst&egrave;me d'aide.
Favoris
Cr&eacute;e une liste personnalis&eacute;e des rubriques fr&eacute;quemment utilis&eacute;es.
Historique
Permet d'acc&eacute;der aux rubriques affich&eacute;es pr&eacute;c&eacute;demment. D&eacute;finit les options du volet de
navigation.
Recherche :
Aucune recherche
S&eacute;lectionnez cette fonction pour d&eacute;sactiver la recherche de texte int&eacute;gral.
Classique
Affiche la liste des titres de rubriques.
Avanc&eacute;
Fournit des capacit&eacute;s avanc&eacute;es de recherche de texte int&eacute;gral incluant des expressions bool&eacute;ennes,
g&eacute;n&eacute;riques et imbriqu&eacute;es. Vous pouvez limiter la recherche aux r&eacute;sultats pr&eacute;c&eacute;dents ou aux titres
des rubriques et rechercher des mots similaires.
Emplacement de l'onglet
S&eacute;lectionnez Haut, Gauche ou Bas.
Volet par d&eacute;faut
D&eacute;finit les options des projets d'aide.
WebSearch
Permet de trouver rapidement des rubriques sur le Web. Un bouton WebSearch est ajout&eacute; &agrave;
l'afficheur d'aide.
Cr&eacute;er des s&eacute;quences de navigation
Transf&egrave;re les s&eacute;quences de navigation WinHelp en aide HTML.
122
CHAPITRE 3
IMPORTATION DE PROJETS WINHELP
PROJETS
Ignorer les fen&ecirc;tres secondaires
Formate les sauts de mani&egrave;re &agrave; afficher les rubriques HTML dans l'afficheur.
REMARQUE : Les pages des fichiers CNT WinHelp s'affichent dans des fen&ecirc;tres personnalis&eacute;es. HTML prend
en charge les sauts d&eacute;finis dans les pages de table des mati&egrave;res vers les fen&ecirc;tres personnalis&eacute;es.
Ajouter des mots-cl&eacute;s &agrave;
S&eacute;lectionne l'emplacement pour enregistrer les mots-cl&eacute;s :
Fichier d'index (HHK)
Enregistre tous les mots-cl&eacute;s dans un fichier d'index unique.
Chaque rubrique
Enregistre tous les mots-cl&eacute;s dans les fichiers de rubrique HTML qui y font r&eacute;f&eacute;rence.
REMARQUE : Le projet compile un index binaire lorsque des mots-cl&eacute;s sont ajout&eacute;s aux rubriques HTML.
Les mots-cl&eacute;s de rubrique sont automatiquement tri&eacute;s dans l'index et ne peuvent pas faire l'objet d'une
r&eacute;f&eacute;rence crois&eacute;e. Ils ne peuvent &ecirc;tre associ&eacute;s qu'&agrave; des rubriques HTML locales. Les rubriques de
destination ne peuvent s'afficher que dans la fen&ecirc;tre d'aide par d&eacute;faut.
Avanc&eacute;
Ouvrez la bo&icirc;te de dialogue Param&egrave;tres avanc&eacute;s de HTML Help pour personnaliser davantage l'afficheur.
Fichiers HLP et HPJ
Lorsque vous importez des fichiers WinHelp 4.0 compil&eacute;s, RoboHelp :
•
Cr&eacute;e un projet HTML. Le fichier de projet (HHP) et un fichier de projet RoboHelp (XPJ) sont cr&eacute;&eacute;s &agrave;
l'aide des informations contenues dans le fichier HLP ou HPJ.
•
Cr&eacute;e des rubriques HTML. Les informations du fichier HPJ sont utilis&eacute;es pour cr&eacute;er un fichier HTML
Help et un fichier de projet RoboHelp (XPJ). Ouvrez le projet pour ouvrir le fichier XPJ. Une rubrique
HTML distincte est cr&eacute;&eacute;e pour chaque rubrique WinHelp. Ces fichiers sont enregistr&eacute;s dans le
dossier des fichiers HTML (Rubriques).
•
Convertit les graphiques WinHelp en images HTML. Les fichiers bitmap WinHelp (BMP, MRB) et les
m&eacute;tafichiers (WMF) sont convertis au format Graphic Interchange Format (GIF). Les images align&eacute;es
&agrave; droite sont align&eacute;es &agrave; gauche dans les rubriques HTML. Modifiez la taille et l'emplacement de ces
images dans l'&eacute;diteur de conception.
•
Convertit les images cliquables en mappages d'images. Les images cliquables WinHelp (fichiers SHG)
sont converties en mappages d'images HTML (GIF).
•
Maintient les boutons param&eacute;trables. Les boutons texte, mini-boutons et boutons graphiques
param&eacute;trables sont convertis et disponibles dans les rubriques HTML. Modifiez les boutons
param&eacute;trables dans l'&eacute;diteur de conception. Les boutons param&eacute;trables sont constitu&eacute;s des
contr&ocirc;les Lien et des contr&ocirc;les HTML Help.
123
CHAPITRE 3
•
•
IMPORTATION DE PROJETS WINHELP
PROJETS
Cr&eacute;e une table des mati&egrave;res HTML. La table des mati&egrave;res HTML Help (fichier HHC) est cr&eacute;&eacute;e &agrave; partir
du fichier de contenu WinHelp (CNT). Modifiez la table des mati&egrave;res dans le module de composition
de table des mati&egrave;res.
Cr&eacute;e un index HTML. Un index HTML Help (fichier HHK) est cr&eacute;&eacute;. Dans cet index, les mots-cl&eacute;s sont
identiques &agrave; ceux de WinHelp. Un nouvel index inclut les mots-cl&eacute;s correspondant aux sauts &agrave;
l'int&eacute;rieur des rubriques.
Un index HTML incluant les m&ecirc;mes mots-cl&eacute;s est cr&eacute;&eacute; &agrave; partir des fichiers RTF. Modifiez les mots-cl&eacute;s dans
le Concepteur d'index et automatisez les t&acirc;ches d'indexation &agrave; l'aide de l'assistant d'index dynamique.
REMARQUE : Ces informations ne s'appliquent pas &agrave; tous les projets HLP ou HPJ.
Questions fr&eacute;quentes sur la cr&eacute;ation de projets HTML &agrave; partir de WinHelp
Les macros WinHelp fonctionnent-elles dans le projet HTML ?
Toutes les macros WinHelp pour lesquelles il existe un &eacute;quivalent HTML sont converties et incluses dans
le projet HTML. Les macros WinHelp non standard sans &eacute;quivalent HTML ne sont pas converties.
Est-il possible d'ouvrir les rubriques HTML dans des fen&ecirc;tres personnalis&eacute;es comme dans WinHelp ?
Vous pouvez formater les livres et les pages dans la table des mati&egrave;res afin d'afficher les rubriques de
destination dans des fen&ecirc;tres ou des cadres personnalis&eacute;s. Microsoft HTML Help ne prend pas en charge
les liens vers des fen&ecirc;tres personnalis&eacute;es, mais vous pouvez formater ces liens pour utiliser les fen&ecirc;tres
de remarque et les cadres contextuels.
Est-il possible d'utiliser les onglets dans les rubriques HTML ?
HTML ne prend pas en charge les onglets et les convertit en espaces. Utilisez les tableaux plut&ocirc;t que de
positionner le texte dans une rubrique HTML.
Comment ajouter des espaces pour positionner le texte dans une rubrique HTML ?
Vous pouvez modifier les rubriques dans l'&eacute;diteur RoboHelp HTML et ajouter des espaces ins&eacute;cables pour
positionner le texte. Toutefois, des probl&egrave;mes d'affichage peuvent survenir si la fen&ecirc;tre d'aide est
redimensionn&eacute;e. Utilisez les tableaux plut&ocirc;t que de positionner le texte dans une rubrique HTML.
Les tableaux sont convertis dans les rubriques HTML, mais les colonnes ne sont pas correctement
redimensionn&eacute;es et une barre de d&eacute;filement horizontale s'affiche.
Redimensionnez les cellules et les tableaux &agrave; l'aide de l'&eacute;diteur de conception.
Comment arranger les listes &agrave; puce dont le format est incorrect ?
Vous pouvez supprimer les r&eacute;f&eacute;rences de bitmap rompues &agrave; partir des rubriques, appliquer les styles de
liste &agrave; puce HTML, puis ajuster les retraits n&eacute;gatifs. En outre, l'option Texte format&eacute; permet d'importer
les formatages de paragraphes &agrave; partir de documents Word.
Mes rubriques WinHelp contiennent des listes num&eacute;rot&eacute;es manuellement avec des champs {SEQ}.
Qu'advient-il de ces champs ?
HTML ne prend pas en charge les champs {SEQ}, mais reconna&icirc;t les s&eacute;quences num&eacute;rot&eacute;es et convertit
les listes en paragraphes num&eacute;rot&eacute;s. Vous pouvez supprimer ces num&eacute;ros et appliquer un style num&eacute;rot&eacute;
HTML &agrave; la liste.
124
IMPORTATION DE PROJETS WINHELP
PROJETS
CHAPITRE 3
Qu'advient-il des zones sans d&eacute;filement ?
Les projets HTML ne prennent pas en charge les zones sans d&eacute;filement et elles ne sont pas requises dans
la fen&ecirc;tre de sortie &agrave; trois volets.
L'arri&egrave;re-plan de l'&eacute;diteur de conception est gris mais, dans la fen&ecirc;tre d'aper&ccedil;u, il est blanc. Comment
proc&eacute;der pour qu'il s'affiche toujours en blanc ?
l'arri&egrave;re-plan des feuilles de style est gris (couleur par d&eacute;faut dans HTML), tandis que l'arri&egrave;re-plan de la
fen&ecirc;tre d'aper&ccedil;u est sp&eacute;cifi&eacute; dans le navigateur. Pour modifier l'arri&egrave;re-plan d'une feuille de style, voir
Utilisation des couleurs et des images.
Lorsque je clique sur un hyperlien, un message d'erreur indique que le syst&egrave;me ne parvient pas &agrave; ouvrir
le site ou que le chemin est introuvable. Que signifie ce message ?
Le lien renvoie &agrave; un fichier inexistant ou &agrave; une rubrique se trouvant dans un fichier DOC ou un fichier
d'aide WinHelp non inclus dans le projet.
Une fois le fichier HTML cr&eacute;&eacute;, est-il pr&ecirc;t &agrave; &ecirc;tre distribu&eacute; ?
Ouvrez le projet HTML dans RoboHelp, puis v&eacute;rifiez les rubriques, la table des mati&egrave;res, l'index, etc.
Affichez les rubriques et testez les liens.
Les rubriques contextuelles sont-elles transf&eacute;r&eacute;es vers un projet HTML ?
Il est possible de convertir les rubriques de type Qu'est-ce que c'est ? de RoboHelp pour Word en
rubriques textuelles. Il est possible de convertir les rubriques au niveau des bo&icirc;tes de dialogue en
rubriques HTML individuelles &agrave; utiliser sous forme d'aide au niveau des fen&ecirc;tres dans RoboHelp.
Importation d'un fichier WinHelp HLP dans un projet HTML
1)
2)
3)
4)
Dans le conteneur D&eacute;marrage, cliquez sur Plus sous Importer.
S&eacute;lectionnez WinHelp (*.hlp) et cliquez sur OK.
Cliquez sur Naviguer, acc&eacute;dez au fichier HLP et ouvrez-le.
Cliquez sur Suivant. D&eacute;finissez les options de fichier.
R&eacute;sultat souhait&eacute;
Action
Sp&eacute;cifier un disque dur et un dossier dans
lesquels enregistrer le projet HTML et les
fichiers image (GIF) (le m&ecirc;me dossier pour
les deux).
Cliquez sur Parcourir et acc&eacute;dez au
lecteur/dossier, puis s&eacute;lectionnez-le. Vous
pouvez &eacute;galement saisir le nom du dossier
dans la zone de texte.
Limiter la longueur des fichiers HTML &agrave; huit
caract&egrave;res
S&eacute;lectionnez Noms de fichier courts. (Saisissez
les trois premiers caract&egrave;res dans Pr&eacute;fixe pour
que les noms de fichier utilisent des r&egrave;gles
d'affectation des noms similaires.)
Distribuer le projet HTML au format HTML
Help non compil&eacute; (sans utiliser Adobe
WebHelp)
Saisissez le nom de la page de lancement dans
Nom de la page de d&eacute;but.
125
IMPORTATION DE PROJETS WINHELP
PROJETS
CHAPITRE 3
R&eacute;sultat souhait&eacute;
Distribuer le projet en tant que syst&egrave;me
Microsoft HTML Help ou syst&egrave;me d'aide
multiplate-forme compil&eacute; &agrave; l'aide d'une
sortie Adobe WebHelp, JavaHelp ou Oracle
Help
Action
Ne saisissez aucune information dans Nom de
la page de d&eacute;but.
R&eacute;sultat souhait&eacute;
Action
Formater les rubriques HTML sans y lier des
feuilles de style
S&eacute;lectionnez &lt;Aucune feuille de style&gt;. Toutes les
rubriques utilisent les styles HTML par d&eacute;faut :
arri&egrave;re-plan gris, police &agrave; empattement noire.
Formater les rubriques HTML pour que leur
apparence soit parfaitement identique &agrave; celle des
rubriques WinHelp
S&eacute;lectionnez &lt;Imbriqu&eacute;&gt;. Les feuilles de style ne
sont pas li&eacute;es aux rubriques. Tous les formatages
d'une rubrique sont imbriqu&eacute;s dans celle-ci. Le
style En-t&ecirc;te 1 est associ&eacute; au titre de la rubrique.
Le style Normal est associ&eacute; au texte restant,
ind&eacute;pendamment des styles utilis&eacute;s dans
WinHelp.
Lier une feuille de style personnalis&eacute;e &agrave; toutes les
rubriques HTML
Cliquez sur Parcourir, acc&eacute;dez au lecteur/dossier
dans lequel se trouve le fichier de la feuille de
style (CSS) et s&eacute;lectionnez-le.
5)
Cliquez sur Suivant. D&eacute;finissez les options pour HTML Help.
R&eacute;sultat souhait&eacute;
6)
Actions
Sp&eacute;cifier l'emplacement d'affichage des
onglets Table des mati&egrave;res, Index et Recherche
dans l'afficheur
S&eacute;lectionnez Haut, C&ocirc;t&eacute; ou Bas.
Convertir les fen&ecirc;tres contextuelles WinHelp
en liens HTML standard
D&eacute;sactivez Afficher des fen&ecirc;tres contextuelles
dans une fen&ecirc;tre Active Popup.
Cliquez sur Terminer.
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
126
CHAPITRE 3
IMPORTATION DE PROJETS WINHELP
PROJETS
Conseils :
•
•
Si vous liez une feuille de style aux rubriques HTML, un fichier de feuille de style g&eacute;n&eacute;rique,
StylesCSS, est cr&eacute;&eacute; et ajout&eacute; au dossier de projet. A tout moment, vous pouvez modifier les styles
d&eacute;finis dans cette feuille de style.
Si vous s&eacute;lectionnez Convertir les listes num&eacute;rot&eacute;es, le formatage des listes num&eacute;rot&eacute;es
apparaissant dans les rubriques WinHelp est conserv&eacute; dans les rubriques HTML.
Limitations HTML avec les fichiers HLP
Puces
Assurez-vous qu'aucune puce des rubriques WinHelp n'est constitu&eacute;e d'une r&eacute;f&eacute;rence bitmap. Une
option permet de conserver les listes &agrave; puces. Cette option ne s'applique qu'aux rubriques dans
lesquelles les puces sont des caract&egrave;res, non des images. Si vous utilisez des images, les retraits
n&eacute;gatifs risquent de dispara&icirc;tre dans la sortie HTML.
Sauts HTML
Les sauts vers les pages HTML ne sont pas convertis. Vous pouvez facilement recr&eacute;er les liens dans
l'&eacute;diteur de conception une fois les rubriques HTML cr&eacute;&eacute;es.
Sauts vers des rubriques WinHelp externes
Les sauts vers les rubriques WinHelp externes sont supprim&eacute;s des rubriques HTML. Si vous travaillez
avec des projets WinHelp (notamment des projets ma&icirc;tres) contenant des sauts externes, utilisez le
fichier HPJ plut&ocirc;t que le fichier HLP.
Macros, boutons et raccourcis
Ces macros sont converties : Jump Context, JumpId et PopupId. Les autres macros ne sont pas
converties. Les macros Jump Context qui dirigent la sortie vers une fen&ecirc;tre ne sont pas converties
car les liens dirigeant la sortie vers des fen&ecirc;tres personnalis&eacute;es ne sont pas pris en charge. Seuls les
boutons sont convertis pour les macros Popup Context. Les boutons graphiques conservent leurs
images, mais le bouton n'est pas inclus.
Styles HTML Microsoft Word
Les styles HTML Microsoft Word ne sont pas utilis&eacute;s pour le formatage des rubriques HTML.
Mod&egrave;les Microsoft Word
Les mod&egrave;les Word utilis&eacute;s pour formater les fichiers RTF dans WinHelp ne sont pas convertis en
feuilles de style HTML.
Sauts de rubrique interm&eacute;diaire
Les sauts de rubrique interm&eacute;diaire sont convertis en signets. Le nom du signet n'utilise pas l'ID de
rubrique du saut de rubrique interm&eacute;diaire cr&eacute;&eacute; dans WinHelp. Au lieu de cela, une s&eacute;rie de
num&eacute;ros lui est attribu&eacute;e pour lui permettre de lire le fichier HLP.
127
CHAPITRE 3
IMPORTATION DE PROJETS WINHELP
PROJETS
Fichiers multim&eacute;dia (AVI et WAV)
Ces fichiers ne peuvent pas &ecirc;tre convertis avec les fichiers HLP. Vous pouvez ajouter du son et de la
vid&eacute;o aux rubriques HTML dans l'&eacute;diteur de conception. Les rubriques HTML peuvent utiliser des
fichiers AVI, AU, MID, RMI, WAV et d'autres fichiers.
Zones sans d&eacute;filement
La sortie HTML ne prend pas en charge les zones sans d&eacute;filement.
Listes num&eacute;rot&eacute;es
Par d&eacute;faut, les listes num&eacute;rot&eacute;es utilisent une police Serif de 12 points. Vous pouvez cr&eacute;er un style
de liste num&eacute;rot&eacute;e et l'utiliser pour reformater les listes num&eacute;rot&eacute;es.
Boutons de rubriques connexes
Les mots-cl&eacute;s des rubriques connexes sont convertis en termes de Rubriques connexes. Les boutons
personnalisables apparaissent lors de l'affichage des rubriques.
Fen&ecirc;tres secondaires
Les fen&ecirc;tres secondaires WinHelp ne sont pas converties. Contrairement aux rubriques WinHelp,
les rubriques HTML ne prennent pas en charge les liens affichant des informations dans des fen&ecirc;tres
secondaires. Vous pouvez concevoir des fen&ecirc;tres personnalis&eacute;es dans RoboHelp et les utiliser pour
afficher des rubriques s&eacute;lectionn&eacute;es &agrave; l'aide des boutons Rubriques connexes, des commandes Lien
de mot-cl&eacute; et Voir aussi, ainsi qu'&agrave; l'aide de la table des mati&egrave;res et de l'index.
Table des mati&egrave;res
Le fichier Table des mati&egrave;res (TOC) ne prend pas en charge les pages WinHelp qui renvoient &agrave; des
rubriques ou &agrave; des macros de r&eacute;f&eacute;rence WinHelp externes, ni les pages qui contiennent des
d&eacute;clarations de lien. Vous pouvez lier les &eacute;l&eacute;ments de table des mati&egrave;res HTML &agrave; des rubriques
HTML, des adresses Web et adresses de courriel, des sites FTP, des groupes de discussion et des
fichiers multim&eacute;dia.
Aide Qu'est-ce que c'est ? Aide
L'aide contextuelle n'est pas convertie. Aide de style Qu'est-ce que c'est ? ou de dialogue sont
converties en rubriques HTML Help standard. Vous pouvez importer des fichiers de mappage et
attribuer des ID de mappage pour les rubriques d'aide applicables aux fen&ecirc;tres. Dans le cas des
rubriques d'aide Qu'est-ce que c'est ?, il est possible de saisir &agrave; nouveau le texte de ces rubriques
HTML Help dans une bo&icirc;te de dialogue de texte uniquement et de cr&eacute;er des rubriques textuelles.
Vous pouvez &eacute;galement importer l'aide contextuelle cr&eacute;&eacute;e avec l'outil de composition d'aide
Qu'est-ce que c'est ? dans vos projets HTML Help. Si vous utilisez le fichier HPJ, vous pouvez
transf&eacute;rer les rubriques d'aide contextuelle dans HTML Help.
Formatage Microsoft Word
Le formatage non converti en rubriques HTML inclut le soulignement, l'espacement des
paragraphes, les retraits, les alignements, les bordures de tableaux, les feuilles de calcul, les
couleurs d'arri&egrave;re-plan et les filigranes.
128
CHAPITRE 3
IMPORTATION DE PROJETS WINHELP
PROJETS
Conseils pour la cr&eacute;ation de projets HTML avec des fichiers HLP
•
•
•
•
Les rubriques HTML ne peuvent pas utiliser les styles et le formatage des projets WinHelp. Les titres
des rubriques sont format&eacute;s dans le style En-t&ecirc;te 1 et le reste de la rubrique est format&eacute; au style
Normal.
Imbriquez le formatage lors de la s&eacute;lection des options de style. Au lieu de lier une feuille de style,
les rubriques HTML sont format&eacute;es pour que leur formatage soit tr&egrave;s similaire &agrave; celui qu'utilisent
les rubriques WinHelp.
Une feuille de style n'est pas n&eacute;cessaire. Vous pouvez la cr&eacute;er apr&egrave;s la g&eacute;n&eacute;ration.
Si l'int&eacute;gralit&eacute; du projet WinHelp est disponible, cr&eacute;ez le projet HTML &agrave; l'aide du fichier HPJ au lieu
du fichier HLP.
Importation d'un fichier WinHelp HPJ dans un projet HTML
1)
2)
3)
4)
5)
6)
7)
S&eacute;lectionnez Fichier &gt; Nouveau projet.
Cliquez sur l'onglet Importer.
S&eacute;lectionnez WinHelp Project. Cliquez sur OK.
Cliquez sur le bouton Parcourir et s&eacute;lectionnez le fichier HPJ &agrave; importer. Cliquez sur Suivant.
Sp&eacute;cifiez le dossier de sortie et le nom de fichier.
Sous Choisir les documents source, s&eacute;lectionnez les documents Word &agrave; importer.
Cliquez sur Terminer ou sur Suivant pour parcourir les &eacute;tapes suivantes de l'assistant.
Conseils pour la cr&eacute;ation de projets HTML avec des fichiers HPJ
•
•
•
•
•
•
Pour vous assurer que le projet HTML est adapt&eacute; &agrave; vos pr&eacute;f&eacute;rences, consultez les &eacute;tapes ci-dessous
avant de commencer.
Tous les fichiers r&eacute;f&eacute;renc&eacute;s par le projet WinHelp (HPJ) doivent se trouver aux emplacements
sp&eacute;cifi&eacute;s avant la g&eacute;n&eacute;ration des fichiers de projet.
Vous pouvez cr&eacute;er une feuille de style et l'appliquer &agrave; toutes les rubriques ou utiliser diff&eacute;rentes
feuilles de style pour les diff&eacute;rentes rubriques.
Pour les rubriques WinHelp, vous pouvez utiliser une combinaison de styles d&eacute;finis et de formatage
manuel des caract&egrave;res et des paragraphes. Dans ce cas, cr&eacute;ez des feuilles de style qui utilisent les
m&ecirc;mes styles que ceux des rubriques WinHelp afin de conserver les formats sp&eacute;ciaux.
Vous pouvez s&eacute;lectionner une feuille de style existante, utilis&eacute;e dans d'autres projets HTML. Les
noms de style des rubriques WinHelp doivent &ecirc;tre identiques aux noms de style dans la feuille de
style. De la m&ecirc;me fa&ccedil;on, les paragraphes des rubriques WinHelp doivent &ecirc;tre format&eacute;s pour utiliser
ces styles. Dans le cas contraire, vous devrez appliquer les styles de la feuille de style aux
paragraphes des rubriques HTML une fois le projet g&eacute;n&eacute;r&eacute;.
l'utilisation d'une feuille de style n'est pas obligatoire. Les rubriques HTML incluent le formatage des
fichiers DOC (en tant que styles en ligne constitu&eacute;s de paragraphes et caract&egrave;res format&eacute;s
individuellement). Vous pouvez toujours cr&eacute;er des styles et les appliquer aux rubriques une fois le
projet HTML cr&eacute;&eacute;. Dans le cas d'un projet de grande envergure, cr&eacute;ez des rubriques HTML &agrave; l'aide
de feuilles de style. Lorsque vous r&eacute;visez les styles, les rubriques sont automatiquement mises &agrave; jour.
129
CHAPITRE 3
•
•
•
•
AJOUT DE PROJETS AU CONTR&Ocirc;LE DE VERSION
PROJETS
Soumettez le projet &agrave; un petit test afin de vous familiariser avec les options. Exp&eacute;rimentez avec les
diverses options jusqu'&agrave; l'obtention de la sortie HTML qui vous convient.
Si vous g&eacute;n&eacute;rez un projet de grande envergure, d&eacute;cidez au pr&eacute;alable comment vous souhaitez
l'organiser. Dans HTML, il existe un fichier de rubrique HTML pour chaque rubrique WinHelp.
Plusieurs options sont &agrave; votre disposition pour l'organisation de ces fichiers. Vous pouvez les
enregistrer toutes &agrave; la racine du dossier du projet ou dans un sous-dossier. Vous pouvez cr&eacute;er des
sous-dossiers sur la base des noms de fichier et y enregistrer les rubriques correspondantes. Vous
pouvez enfin enregistrer des rubriques en fonction de leur utilisation en tant que pages dans la table
des mati&egrave;res. Des dossiers sont cr&eacute;&eacute;s pour chaque livre tandis que des sous-dossiers sont cr&eacute;&eacute;s pour
les sous-livres de votre fichier CNT.
Un projet est souvent utilis&eacute; en combinaison avec plusieurs autres projets WinHelp (en tant que
projet ma&icirc;tre, par exemple). Si tel est le cas, cr&eacute;ez des projets HTML s&eacute;par&eacute;ment avec chaque fichier
HPJ afin que tous les liens soient fonctionnels.
Une fois le projet g&eacute;n&eacute;r&eacute;, vous souhaiterez probablement apporter des modifications &agrave; la feuille de
style. Par d&eacute;faut, son arri&egrave;re-plan est gris. Pour le remplacer par un arri&egrave;re-plan blanc, il suffit de
modifier les propri&eacute;t&eacute;s de document associ&eacute;es &agrave; la feuille de style.
3.12. Ajout de projets au contr&ocirc;le de version
REMARQUE : Les auteurs doivent utiliser la commande Ajouter au contr&ocirc;le de version depuis l'application
cliente de cr&eacute;ation RoboHelp lors de l'ajout d'un nouveau projet au contr&ocirc;le de version. N'ajoutez pas de
dossiers et de fichiers dans l'interface de l'explorateur RoboSource Control car vous risqueriez
d'endommager les fichiers.
A propos du contr&ocirc;le de version
RoboHelp fonctionne avec le logiciel de contr&ocirc;le de version pour extraire automatiquement les fichiers
(s'ils ne sont pas d&eacute;j&agrave; extraits) au moment o&ugrave; vous commencez l'&eacute;dition et assurer le suivi de leur
utilisation. Vous pouvez &eacute;galement afficher les fichiers en les ouvrant &agrave; partir du contr&ocirc;le de version sans
les extraire.
Pour pouvoir fonctionner avec RoboHelp, votre logiciel de contr&ocirc;le de version doit prendre en charge
l'API Microsoft SCC. Vous pouvez utiliser Adobe RoboSource Control (install&eacute; avec RoboHelp), Microsoft
SharePoint (int&eacute;gr&eacute; nativement &agrave; RoboHelp) ou un autre package tiers. Dans tous les cas, les t&acirc;ches de
contr&ocirc;le de version sont effectu&eacute;es dans RoboHelp.
Lisez les articles suivants si vous envisagez d'int&eacute;grer des projets RoboHelp dans Microsoft Team
Foundation Server ou Subversion :
•
Int&eacute;gration de projets RoboHelp avec Team Foundation Server
•
Int&eacute;gration de projets RoboHelp avec Subversion
130
CHAPITRE 3
AJOUT DE PROJETS AU CONTR&Ocirc;LE DE VERSION
PROJETS
Lorsque vous avez termin&eacute; d'utiliser un fichier, vous pouvez l'archiver dans le contr&ocirc;le de version ou
laisser le programme archiver tous les fichiers &agrave; la fermeture du projet. Une fois que vos modifications
ont &eacute;t&eacute; archiv&eacute;es, les autres auteurs peuvent y acc&eacute;der. Vous pouvez &eacute;galement d&eacute;finir RoboHelp pour
que les fichiers soient automatiquement archiv&eacute;s &agrave; la fermeture du projet.
REMARQUE : S'il est impossible d'extraire un fichier, v&eacute;rifiez si un ou plusieurs fichiers sont contr&ocirc;l&eacute;s par un
autre utilisateur. Vous pouvez &eacute;galement vous assurer que le fichier n'est pas en contr&ocirc;le de version.
De nombreuses rubriques sont li&eacute;es &agrave; d'autres rubriques ou font partie de la table des mati&egrave;res, de l'index
ou de s&eacute;quences de navigation. Lorsque vous modifiez un fichier ou la structure du projet, RoboHelp
extrait automatiquement tous les fichiers d&eacute;pendants affect&eacute;s (dans la mesure de leur disponibilit&eacute;).
Lorsque vous d&eacute;placez un fichier, l'auteur est invit&eacute; &agrave; extraire les fichiers source et de destination.
Pour d&eacute;sactiver les invites lorsque vous effectuez des t&acirc;ches de contr&ocirc;le de version manuellement,
d&eacute;sactivez l'option correspondante dans l'onglet Contr&ocirc;le de version (S&eacute;lectionnez Fichier &gt; Options). Les
fichiers sont extraits automatiquement. il n'est pas possible d'extraire les fichiers qui ne sont pas
s&eacute;lectionn&eacute;s dans la liste. RoboHelp affiche les fichiers &agrave; extraire et indique s'ils l'ont d&eacute;j&agrave; &eacute;t&eacute;.
REMARQUE : RoboHelp extrait automatiquement tous les fichiers d&eacute;pendants.
Pour annuler les modifications apport&eacute;es &agrave; la copie extraite d'un fichier sous contr&ocirc;le de version, annulez
le contr&ocirc;le du fichier r&eacute;pertori&eacute;. Puis revenez &agrave; la derni&egrave;re copie du contr&ocirc;le de version. Cette commande
Annuler l'extraction ignore les modifications apport&eacute;es &agrave; la copie du fichier local.
Le contr&ocirc;le de version prot&egrave;ge vos fichiers au cours de votre travail, permet le suivi des modifications, les
sauvegardes et offre des fonctions de partage et d'organisation des fichiers. Tous les fichiers ajout&eacute;s &agrave; un
projet sous contr&ocirc;le de version sont automatiquement ajout&eacute;s au contr&ocirc;le de version et extraits. Tous les
fichiers supprim&eacute;s d'un projet sont automatiquement supprim&eacute;s du contr&ocirc;le de version, mais leur
historique est conserv&eacute;.
Vous pouvez effectuer des t&acirc;ches de contr&ocirc;le de version &agrave; partir des panneaux du projet : cliquez avec le
bouton droit de la souris sur le fichier, s&eacute;lectionnez une commande, s&eacute;lectionnez le fichier et cliquez sur
Ajouter au contr&ocirc;le de version dans le ruban Collaborer. Vous pouvez &eacute;galement s&eacute;lectionner le fichier
puis s&eacute;lectionner une option dans le ruban Collaborer.
Application du contr&ocirc;le de version
1)
2)
3)
Installez un logiciel de contr&ocirc;le de version prenant en charge l'API Microsoft SCC.
Contactez votre administrateur r&eacute;seau pour obtenir des droits d'acc&egrave;s utilisateur. Consultez la
documentation de votre logiciel de contr&ocirc;le de version.
Ajoutez le projet au contr&ocirc;le de version.
Acc&egrave;s aux options de contr&ocirc;le de version dans les conteneurs
Conteneur Etat du fichier
S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Etat du fichier. Affiche la liste de l'&eacute;tat des fichiers et
des t&acirc;ches de contr&ocirc;le de version. La barre d'outils de contr&ocirc;le de version permet d'acc&eacute;der aux
t&acirc;ches du contr&ocirc;le de version.
131
CHAPITRE 3
AJOUT DE PROJETS AU CONTR&Ocirc;LE DE VERSION
PROJETS
Conteneur Liste des rubriques
S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Liste des rubriques. Il permet d'ouvrir, d'afficher et de
trier les rubriques.
Conteneur de gestionnaire de projets
S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Gestionnaire de projets. Affiche les ic&ocirc;nes de fichiers.
Une coche rouge indique qu'un fichier a &eacute;t&eacute; extrait.
REMARQUE : L'interface utilisateur de RoboHelp est optimis&eacute;e pour RoboSource Control, Microsoft Team
Foundation Server 2005 et Microsoft Visual SourceSafe.
Questions fr&eacute;quentes sur le contr&ocirc;le de version
Fonctionnement du contr&ocirc;le de version
Un projet d'aide comprend un fichier par rubrique, graphique, feuille de style, table des mati&egrave;res, fen&ecirc;tre,
etc. Cette configuration permet aux auteurs de travailler ind&eacute;pendamment sur chaque composant.
Comment plusieurs auteurs peuvent-ils utiliser le contr&ocirc;le de version ?
•
•
•
•
Modifiez les composants de projet pendant que les autres auteurs modifient les autres composants.
Affichez les composants de projet m&ecirc;me s'ils sont en cours de modification par d'autres auteurs.
Consultez les derni&egrave;res modifications (une fois les fichiers archiv&eacute;s par leurs auteurs).
Configurez et utilisez le contr&ocirc;le de version &agrave; partir de RoboHelp. Il est d&eacute;conseill&eacute; d'effectuer le
contr&ocirc;le de version de votre projet &agrave; l'ext&eacute;rieur de RoboHelp.
Les projets &agrave; un seul utilisateur peuvent-ils utiliser le contr&ocirc;le de version ?
Oui, pour utiliser le suivi des marques de r&eacute;vision et pour centraliser les projets sur un r&eacute;seau &agrave; des fins
de sauvegarde.
Est-il possible de proc&eacute;der &agrave; une extraction multi-utilisateur ?
l'extraction multi-utilisateur est d&eacute;conseill&eacute;e.
O&ugrave; puis-je d&eacute;finir les options de contr&ocirc;le de version pour RoboHelp ?
Cliquez sur Fichier &gt; Options &gt; Contr&ocirc;le de version.
Mon programme de contr&ocirc;le de version est-il n&eacute;cessaire &agrave; l'ext&eacute;rieur de RoboHelp ?
Lorsque vous supprimez des fichiers ou des dossiers, supprimez-les &eacute;galement du contr&ocirc;le de version.
Utilisez &eacute;galement votre logiciel de contr&ocirc;le de version pour cr&eacute;er des comptes utilisateur ou d&eacute;finir des
propri&eacute;t&eacute;s de programme. Vous pouvez utiliser le contr&ocirc;le de version &agrave; partir de RoboHelp.
132
CHAPITRE 3
AJOUT DE PROJETS AU CONTR&Ocirc;LE DE VERSION
PROJETS
Faut-il extraire le fichier de projet (XPJ) pour modifier le projet ?
Il n'est pas n&eacute;cessaire d'extraire le fichier XPJ pour effectuer des modifications. Vous devez l'extraire
uniquement pour modifier les param&egrave;tres du projet.
Les &eacute;l&eacute;ments ajout&eacute;s au projet sont-ils &eacute;galement ajout&eacute;s au contr&ocirc;le de version ?
Oui. Les nouvelles rubriques sont imm&eacute;diatement ajout&eacute;es. l'ajout des nouveaux dossiers s'effectue lors
de l'enregistrement du projet. Lorsque vous renommez un fichier ou un dossier, celui-ci n'est pas
renomm&eacute; dans le contr&ocirc;le de version. Le nouvel &eacute;l&eacute;ment est ajout&eacute; mais l'&eacute;l&eacute;ment d'origine conserve son
nom. Supprimez l'&eacute;l&eacute;ment en acc&eacute;dant au contr&ocirc;le de version.
Enregistrez votre projet chaque fois que vous ajoutez des fichiers, mais assurez-vous de r&eacute;archiver les
fichiers pour que les modifications soient ajout&eacute;es au contr&ocirc;le de version. Les modifications enregistr&eacute;es
sur votre disque dur local ne sont pas ajout&eacute;es.
Les &eacute;l&eacute;ments supprim&eacute;s du projet sont-ils &eacute;galement supprim&eacute;s du contr&ocirc;le de version ?
Les fichiers sont supprim&eacute;s du contr&ocirc;le de version lorsque vous les effacez. Les &eacute;l&eacute;ments renomm&eacute;s sont
ajout&eacute;s sous leur nouveau nom, mais l'ancienne version est conserv&eacute;e, avec son ancien nom.
O&ugrave; sont les derni&egrave;res modifications effectu&eacute;es par l'&eacute;quipe ?
Vous pouvez obtenir les versions de fichiers les plus r&eacute;centes (archiv&eacute;es par les autres utilisateurs) &agrave;
l'ouverture du projet ou manuellement.
Comment ajouter des fichiers de sortie au contr&ocirc;le de version ?
Si d'autres personnes doivent acc&eacute;der &agrave; vos fichiers de sortie, ajoutez-les au contr&ocirc;le de version.
Ajout d'un projet RoboHelp au contr&ocirc;le de version
REMARQUE : Cette rubrique traite de l'ajout d'un projet RoboHelp &agrave; RoboSource Control. Si vous souhaitez
utiliser SharePoint comme syst&egrave;me de contr&ocirc;le de version, reportez-vous &agrave; Contr&ocirc;le de version avec
Microsoft SharePoint.
Quand vous ajoutez un projet RoboHelp au contr&ocirc;le de version, cr&eacute;ez une connexion de base de donn&eacute;es
lors de votre premi&egrave;re connexion &agrave; RoboSource Control. RoboHelp utilise cette connexion pour acc&eacute;der
&agrave; la base de donn&eacute;es. Voir Aide d'Adobe RoboSource Control pour plus d'informations.
1) Ouvrez le projet dans RoboHelp HTML.
2) S&eacute;lectionnez Collaborer &gt; Ajouter au contr&ocirc;le de version.
3) S&eacute;lectionnez RoboSource Control, puis cliquez sur OK.
4) S'il s'agit d'une premi&egrave;re connexion &agrave; la base de donn&eacute;es de RoboSource Control, reportez-vous &agrave;
l'&eacute;tape 5 pour cr&eacute;er une connexion. Dans le cas contraire, v&eacute;rifiez dans la liste des connexions que
la connexion s&eacute;lectionn&eacute;e est appropri&eacute;e. Passez ensuite &agrave; l'&eacute;tape 9.
5) Dans la liste des connexions, s&eacute;lectionnez Cr&eacute;er.
133
CHAPITRE 3
6)
AJOUT DE PROJETS AU CONTR&Ocirc;LE DE VERSION
PROJETS
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Si le serveur RoboSource Control est install&eacute; sur votre ordinateur, s&eacute;lectionnez la connexion
de base de donn&eacute;es dans la liste situ&eacute;e &agrave; gauche.
–
Si le logiciel serveur RoboSource Control est install&eacute; sur un serveur, renseignez les champs
suivants :
Nom de la connexion
Saisissez un nom permettant d'identifier la base de donn&eacute;es du client RoboSource Control. Si vous
le souhaitez, vous pouvez utiliser le nom de la base de donn&eacute;es.
Serveur
Saisissez soit l'adresse IP, soit le nom unique du serveur du r&eacute;seau local.
Base de donn&eacute;es
Saisissez le nom de la base de donn&eacute;es exactement tel que vous l'avez saisi dans la bo&icirc;te de dialogue
Cr&eacute;er une base de donn&eacute;es.
7)
8)
9)
Cliquez sur Cr&eacute;er, puis sur Connecter.
Connectez-vous &agrave; RoboSource Control.
Dans la bo&icirc;te de dialogue Configurer le contr&ocirc;le source, cliquez sur le bouton Parcourir en regard
du champ Chemin racine.
10) Si vous y &ecirc;tes invit&eacute;, saisissez le m&ecirc;me mot de passe que celui que vous avez saisi pour vous
connecter.
11) REMARQUE : Lorsque la bo&icirc;te de dialogue Connexion est cach&eacute;e derri&egrave;re la fen&ecirc;tre de RoboHelp,
votre &eacute;cran semble se figer. Utilisez les touches Alt + Tab pour afficher la bo&icirc;te de dialogue
Connexion.
12) Cliquez sur le nœud racine $ afin de le s&eacute;lectionner et cliquez sur OK, puis sur Oui dans le message
qui s'affiche.
Tous les fichiers du projet RoboHelp sont &agrave; pr&eacute;sent copi&eacute;s dans la base de donn&eacute;es du serveur et signal&eacute;s
comme &eacute;tant extraits par vous. Lorsque vous fermez le projet, vous &ecirc;tes invit&eacute; &agrave; archiver les fichiers dans
la base de donn&eacute;es. Si vous cliquez sur Oui, tous les fichiers sont archiv&eacute;s.
REMARQUE : Un conteneur Etat du fichier suppl&eacute;mentaire s'affiche dans l'interface utilisateur de
RoboHelp. Il contient la liste de tous les fichiers de projet sous contr&ocirc;le de version et indique le statut de
chaque fichier (archiv&eacute; ou extrait). L'application RoboSource Control installe des documentations
suppl&eacute;mentaires. Ce fichier d'aide est accessible depuis l'application d'exploration RoboSource Control.
Archivage/extraction de fichiers
Lorsque vous commencez &agrave; modifier un fichier de projet dans RoboHelp, le fichier de rubrique est extrait
du contr&ocirc;le de version (s'il n'est pas en cours d'utilisation).
De nombreuses rubriques sont li&eacute;es &agrave; d'autres rubriques ou font partie de la table des mati&egrave;res, de l'index
ou de s&eacute;quences de navigation. Lorsque vous modifiez un fichier ou la structure du projet, RoboHelp
extrait automatiquement tous les fichiers d&eacute;pendants affect&eacute;s (dans la mesure de leur disponibilit&eacute;).
134
CHAPITRE 3
CONTR&Ocirc;LE DE VERSION AVEC MICROSOFT SHAREPOINT
PROJETS
Si le projet contient des fichiers d&eacute;pendants, RoboHelp vous invite &agrave; les extraire. Si certains d'entre eux
ont d&eacute;j&agrave; &eacute;t&eacute; extraits, demandez aux utilisateurs de les archiver.
REMARQUE : Une fois que vous avez ajout&eacute; un projet dans le syst&egrave;me de contr&ocirc;le de version, vous pouvez
afficher les propri&eacute;t&eacute;s et l'historique des versions du fichier, ainsi que les diff&eacute;rences entre la copie locale
du fichier et sa version archiv&eacute;e.
3.13. Contr&ocirc;le de version avec Microsoft SharePoint
RoboHelp prend en charge le contr&ocirc;le de version avec Microsoft SharePoint 2010 et version ult&eacute;rieure en
mode natif, ce qui signifie que vous n'avez pas besoin d'installer des modules externes tiers.
Le programme d'installation de RoboHelp installe automatiquement tous les composants n&eacute;cessaires,
y compris les composants requis suivants qui permettent &agrave; la fonction de contr&ocirc;le de version de
fonctionner correctement :
•
Structure .NET 4.0
•
SQL Server Compact 3.5 SP2
Configuration des param&egrave;tres RoboHelp pour SharePoint
1)
2)
3)
Dans RoboHelp, cliquez sur Fichier &gt; Options &gt; Contr&ocirc;le de version pour afficher les param&egrave;tres de
contr&ocirc;le de version.
Dans la zone Param&egrave;tres SharePoint, entrez le chemin d'acc&egrave;s d'un programme de comparaison de
fichiers install&eacute; sur le syst&egrave;me et les arguments (param&egrave;tres) appropri&eacute;s. RoboHelp l'utilise pour les
op&eacute;rations de comparaison de fichiers. Vous pouvez t&eacute;l&eacute;charger un programme de comparaison
gratuit, WinMerge, depuis le site http://winmerge.org/.
REMARQUE : Si vous utilisez WinMerge, entrez son chemin d'acc&egrave;s sur votre syst&egrave;me dans le
param&egrave;tre Chemin, et les arguments %1 %2. %1 et %2 indiquent que les deux fichiers peuvent &ecirc;tre
compar&eacute;s.
Configurez les options suivantes :
Informer de l'&eacute;crasement des fichiers accessibles en &eacute;criture
Avertit l'utilisateur avant d'&eacute;craser les fichiers accessibles en &eacute;criture qui ne sont pas extraits.
Remplacer le fichier local m&ecirc;me si la version du serveur est identique
Force RoboHelp &agrave; extraire les derni&egrave;res versions des fichiers &agrave; partir du serveur, m&ecirc;me si la version
locale et celle du serveur sont identiques.
Option d'archivage par d&eacute;faut
S&eacute;lectionnez si vous souhaitez archiver les fichiers en tant que version principale ou version
secondaire. La premi&egrave;re option ci-dessus est la valeur par d&eacute;faut.
REMARQUE : L'option d'archivage par d&eacute;faut entre en vigueur &agrave; la fermeture de la bo&icirc;te de dialogue
d'archivage au cours de l'archivage.
135
CHAPITRE 3
CONTR&Ocirc;LE DE VERSION AVEC MICROSOFT SHAREPOINT
PROJETS
Par d&eacute;faut, RoboHelp n'affiche pas les notifications pour les op&eacute;rations de contr&ocirc;le de version. Pour
afficher les notifications, activez les options appropri&eacute;es dans la zone Afficher la bo&icirc;te de dialogue de
confirmation si de la page Contr&ocirc;le de version de la bo&icirc;te de dialogue Options (Fichier &gt; Options).
Configuration des param&egrave;tres de SharePoint
Pour ajouter un projet RoboHelp &agrave; une biblioth&egrave;que de documents dans SharePoint, configurez les
param&egrave;tres de la biblioth&egrave;que de documents :
REMARQUE : Cette section r&eacute;pertorie les &eacute;tapes plus larges dont vous avez besoin pour configurer votre
serveur SharePoint. Reportez-vous &agrave; la documentation du produit pour plus de d&eacute;tails.
1) Connectez-vous &agrave; SharePoint.
2) Cr&eacute;ez un site.
Pour cr&eacute;er un site, vous devez fournir les d&eacute;tails tels que le titre du site, l'adresse du site Web, le
mod&egrave;le et l'administrateur du site.
3) Cr&eacute;ez une biblioth&egrave;que de documents pour le site que vous avez cr&eacute;&eacute; &agrave; l'&eacute;tape 2.
4) Activez les param&egrave;tres de version de la biblioth&egrave;que :
a) Cliquez sur la biblioth&egrave;que de documents &agrave; modifier dans la liste des biblioth&egrave;ques de
documents affich&eacute;e.
b) Acc&eacute;dez aux param&egrave;tres de la biblioth&egrave;que.
c)
Ouvrez les param&egrave;tres de version, puis configurez les param&egrave;tres suivants :
Exiger l'approbation du contenu pour les &eacute;l&eacute;ments envoy&eacute;s
Cliquez sur Non.
Cr&eacute;er une version &agrave; chaque modification d'un fichier dans cette biblioth&egrave;que de documents ?
S&eacute;lectionnez Cr&eacute;er des versions principales et secondaires (brouillon).
REMARQUE : L'option Cr&eacute;er des versions principales est &eacute;galement prise en charge. Dans ce cas, les fichiers
ne peuvent pas &ecirc;tre archiv&eacute;s en tant que versions secondaires.
Conserver le nombre suivant de versions principales
D&eacute;sactivez cette option.
Conserver des brouillons pour le nombre suivant de versions principales
D&eacute;sactivez cette option.
Qui doit voir les brouillons dans cette biblioth&egrave;que de documents ?
Les utilisateurs disposant de droits d'acc&egrave;s en lecture.
Exiger l'extraction des documents avant de pouvoir les modifier ? Forcer l'extraction)
Cliquez sur Oui.
136
CHAPITRE 3
FUSION DE PROJETS D'AIDE
PROJETS
REMARQUE : Pour fournir aux utilisateurs un acc&egrave;s en lecture/&eacute;criture aux fichiers de RoboHelp sur votre
serveur SharePoint, assurez-vous qu'ils disposent des autorisations utilisateur SharePoint appropri&eacute;es.
Ajout d'un projet &agrave; une biblioth&egrave;que de documents SharePoint
1)
2)
3)
4)
Cliquez sur Collaborer puis sur l'ic&ocirc;ne Ajouter au contr&ocirc;le de version.
S&eacute;lectionnez RoboHelp SharePoint Connector et cliquez sur OK.
Sp&eacute;cifiez le site SharePoint qui contient la biblioth&egrave;que de documents, ainsi que le nom d'utilisateur
et le mot de passe pour vous connecter &agrave; SharePoint. Cliquez sur OK pour vous connecter &agrave;
SharePoint.
REMARQUE : Vous pouvez utiliser l'authentification LDAP si elle est configur&eacute;e sur le serveur
SharePoint, en s&eacute;lectionnant l'option Utiliser l'authentification Windows.
Lorsque vous vous connectez au site SharePoint, toutes les biblioth&egrave;ques de documents de ce site
sont affich&eacute;es.
Cr&eacute;ez un dossier &agrave; l'int&eacute;rieur d'une biblioth&egrave;que de documents ou utilisez un dossier vide existant
pour t&eacute;l&eacute;charger les fichiers RoboHelp et cliquez sur OK.
RoboHelp ajoute les fichiers de projet &agrave; SharePoint.
REMARQUE : Vous pouvez ajouter le projet dans n'importe quel dossier dans la biblioth&egrave;que de
documents. Le dossier doit &ecirc;tre vide. Vous ne pouvez pas ajouter le projet directement &agrave; une
biblioth&egrave;que de documents.
3.14. Fusion de projets d'aide
A propos des projets d'aide fusionn&eacute;s
RoboHelp vous permet de cr&eacute;er des projets dans une configuration d'entreprise ou distribu&eacute;e dans
laquelle plusieurs projets de documentation sont regroup&eacute;s en un projet commun. La cr&eacute;ation &agrave; plusieurs
auteurs est possible sans logiciel de contr&ocirc;le des sources, car plusieurs r&eacute;dacteurs peuvent travailler sur
leurs projets individuels que vous fusionnez afin de cr&eacute;er le projet commun. L'utilisation d'habillages et
de mod&egrave;les dans le projet commun permet d'obtenir une apparence unifi&eacute;e dans les projets fusionn&eacute;s.
La fusion s'effectue lors de l'ex&eacute;cution, apr&egrave;s la g&eacute;n&eacute;ration des projets. Avant de fusionner les projets, il
vous suffit de placer des r&eacute;f&eacute;rences &agrave; d'autres projets dans un projet ma&icirc;tre (le projet ma&icirc;tre ne contient
pas r&eacute;ellement les projets enfants). Vous pouvez ins&eacute;rer chaque r&eacute;f&eacute;rence dans la table des mati&egrave;res du
projet ma&icirc;tre en la pla&ccedil;ant &agrave; l'endroit o&ugrave; vous souhaitez que la table des mati&egrave;res du projet enfant
apparaisse. Cette &eacute;tape vous permet de contr&ocirc;ler l'endroit depuis lequel les utilisateurs finals acc&egrave;dent
au projet enfant ; elle permet &eacute;galement de donner l'apparence d'un seul syst&egrave;me d'aide unifi&eacute;. Les
utilisateurs finals voient un seul syst&egrave;me d'aide en ligne complet, avec une table des mati&egrave;res, un index,
une recherche de texte int&eacute;gral, un glossaire (dans le cas de projets WebHelp) et des contr&ocirc;les Lien.
IMPORTANT : Les projets enfants ne doivent pas comporter de cat&eacute;gories de contenu.
La fusion de plusieurs projets comprend les &eacute;tapes suivantes :
137
CHAPITRE 3
•
•
FUSION DE PROJETS D'AIDE
PROJETS
Cr&eacute;ez un projet ma&icirc;tre avec des r&eacute;f&eacute;rences aux projets enfants dans la table des mati&egrave;res. Voir
Cr&eacute;ation d'un projet ma&icirc;tre.
Publiez les projets enfants. Voir Publication de projets enfants.
REMARQUE : Pour les projets ma&icirc;tres dont le type de sortie est Application Adobe AIR, publiez les
projets enfants comme aide Adobe AIR accessible par navigateur.
S&eacute;lection du type de sortie d'aide accessible par navigateur
•
(Type de sortie Application Adobe AIR uniquement) R&eacute;g&eacute;n&eacute;rez la sortie du projet ma&icirc;tre. Voir
Configuration de la mise en page Adobe AIR.
REMARQUE :
Les projets Responsive HTML5, WebHelp Pro et FlashHelp Pro sont publi&eacute;s automatiquement
par RoboHelp Server.
Cr&eacute;ation d'un projet ma&icirc;tre
Cette proc&eacute;dure s'applique aux projets HTML Help, WebHelp, FlashHelp, Application Adobe AIR, ainsi
qu'aux projets Adobe AIR accessibles par navigateur.
1) Cr&eacute;ez le projet ma&icirc;tre et les projets que vous souhaitez fusionner.
ASTUCE : En vue de faciliter la maintenance, le projet ma&icirc;tre doit &ecirc;tre id&eacute;alement un conteneur vide
ou contenir uniquement une rubrique par d&eacute;faut. Les projets enfants doivent stocker l'ensemble du
contenu. Pour plus d'informations, voir Quel projet est le plus appropri&eacute; pour &ecirc;tre projet ma&icirc;tre ?
in Questions fr&eacute;quentes sur la fusion des projets.
2) Ouvrez le projet ma&icirc;tre. Dans la rubrique par d&eacute;faut, ajoutez le contenu &agrave; afficher sur la page
d'accueil de l'aide fusionn&eacute;e.
3) S&eacute;lectionnez un habillage. L'habillage du projet ma&icirc;tre est utilis&eacute; comme habillage de l'aide
fusionn&eacute;e.
138
CHAPITRE 3
FUSION DE PROJETS D'AIDE
PROJETS
4)
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez la table des mati&egrave;res par d&eacute;faut du projet ma&icirc;tre depuis le conteneur
Gestionnaire de projets.
–
Cr&eacute;ez une table des mati&egrave;res pour le projet ma&icirc;tre.
5)
6)
7)
Pour ins&eacute;rer des projets enfants, placez votre curseur dans la table des mati&egrave;res.
Dans le conteneur Table des mati&egrave;res, cliquez sur l'ic&ocirc;ne Nouveau projet fusionn&eacute;.
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Pour les projets HTML Help, cliquez sur l'onglet HTML Help de la bo&icirc;te de dialogue Projet
fusionn&eacute;.
–
Pour les projets WebHelp/FlashHelp/Adobe AIR, cliquez sur l'onglet
WebHelp/FlashHelp/Adobe AIR.
8)
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Pour les projets HTML Help, s&eacute;lectionnez un fichier CHM figurant d&eacute;j&agrave; dans le dossier du
projet actuel ou acc&eacute;dez &agrave; l'emplacement de ce fichier CHM.
Une ic&ocirc;ne accompagn&eacute;e du nom du fichier s'affiche dans le conteneur Table des mati&egrave;res o&ugrave;
vous avez ins&eacute;r&eacute; les projets enfants. Le nom du fichier est au format &lt;fichier CHM&gt;
.chm::/&lt;fichier CHM&gt;.hhc. Le fichier HHC repr&eacute;sente la table des mati&egrave;res du fichier CHM
fusionn&eacute;. Cette ic&ocirc;ne appara&icirc;t &agrave; l'endroit o&ugrave; les tables des mati&egrave;res des projets enfants se
trouvent dans le projet fusionn&eacute;. Si n&eacute;cessaire, vous pouvez d&eacute;placer l'ic&ocirc;ne et la d&eacute;poser &agrave; un
autre emplacement de la table des mati&egrave;res.
–
Pour les projets WebHelp/FlashHelp/Adobe AIR, saisissez le nom d'un projet RoboHelp (XPJ)
ou cliquez sur Ouvrir pour acc&eacute;der au fichier de projet.
Dans le cas de projets WebHelp/FlashHelp/Adobe AIR, l'espace r&eacute;serv&eacute; affiche le nom du
projet.
9)
G&eacute;n&eacute;rez le projet ma&icirc;tre.
Lorsque le projet g&eacute;n&eacute;r&eacute; contient des r&eacute;f&eacute;rences &agrave; un projet fusionn&eacute; dans sa table des mati&egrave;res, un
dossier &laquo; mergedProjects &raquo; appara&icirc;t dans le dossier de sortie SSL. Le dossier mergedProjects
contient un dossier pour chaque projet enfant r&eacute;f&eacute;renc&eacute;. Dans le cas d'aides
WebHelp/FlashHelp/Adobe AIR, le projet enfant correspondant doit &ecirc;tre g&eacute;n&eacute;r&eacute; dans son propre
dossier.
REMARQUE : Le nom mergedProjects est r&eacute;serv&eacute;. N'attribuez le nom mergedProjects &agrave; aucun dossier
du dossier de projet.
10) Dans la bo&icirc;te de dialogue R&eacute;sultat, cliquez sur Afficher pour voir les r&eacute;sultats et tester le projet
fusionn&eacute;.
139
CHAPITRE 3
FUSION DE PROJETS D'AIDE
PROJETS
Remarques
•
•
•
•
Les projets fusionn&eacute;s HTML Help utilisent des fichiers de contenu non binaires (.HHC). Les noms de
fichier de sortie compil&eacute;e (.CHM) et de table des mati&egrave;res (.HHC) ne peuvent pas contenir
d'espaces. (Pour savoir s'ils contiennent des espaces, consultez-les dans votre dossier de projet,
dans l'Explorateur Windows. Cependant, ne renommez pas les fichiers dans l'Explorateur
Windows.) Si l'un des noms de fichier comporte des espaces, ouvrez le projet et renommez le fichier
correspondant. G&eacute;n&eacute;rez ensuite le projet et changez le nom du fichier de sortie (fichier CHM). Le
nom du fichier HHC est mis &agrave; jour automatiquement lorsque vous modifiez le nom du projet.
N'associez pas la fonction de table de mati&egrave;res binaire &agrave; votre projet. Sinon, les tables des mati&egrave;res
externes n'apparaissent pas dans l'onglet Tables des mati&egrave;res de l'afficheur HTML Help.
Si vous g&eacute;n&eacute;rez une sortie WebHelp/FlashHelp/Adobe AIR &agrave; l'aide d'un habillage, l'habillage du
projet ma&icirc;tre remplace celui du projet enfant dans le projet fusionn&eacute;. Si vous acc&eacute;dez aux projets
individuellement sans passer par le projet fusionn&eacute;, l'habillage propre au projet est utilis&eacute;.
Si vous devez ajouter des liens entre projets, assurez-vous de configurer la structure de dossiers
pour les projets source de la m&ecirc;me mani&egrave;re que celle des fichiers g&eacute;n&eacute;r&eacute;s et publi&eacute;s.
Dans le cas contraire, lors de la cr&eacute;ation des hyperliens, vous devez construire manuellement l'URL
en fonction de la structure de dossiers des fichiers g&eacute;n&eacute;r&eacute;s et publi&eacute;s et l'indiquer dans la zone de
texte Lien vers. Pour les &eacute;tapes d&eacute;taill&eacute;es, voir cet article.
Publication de projets enfants
Cette proc&eacute;dure s'applique aux projets Microsoft HTML Help, WebHelp, FlashHelp, Application
Adobe AIR, ainsi qu'aux projets Adobe AIR accessibles par navigateur.
Apr&egrave;s la cr&eacute;ation du projet ma&icirc;tre, publiez les projets enfants pour les placer &agrave; l'emplacement correct. La
publication de projets vous permet de les afficher tous lors de l'ex&eacute;cution. Vous pouvez conserver des
projets enfants &agrave; diff&eacute;rents emplacements et les fusionner dans un autre emplacement. Vous pouvez
publier le projet fusionn&eacute; sur un intranet d'entreprise, un site Internet, un disque dur local, un r&eacute;seau ou
un serveur FTP. Les fichiers de sortie du projet fusionn&eacute; sont stock&eacute;s uniquement sur le site publi&eacute;, mais
pas dans les emplacements des diff&eacute;rents projets enfants.
1) Ouvrez un projet enfant.
2) Cliquez avec le bouton droit de la souris sur la mise en page dans le conteneur Mises en page source
unique et s&eacute;lectionnez G&eacute;n&eacute;rer.
REMARQUE : Dans le cas de projets ma&icirc;tres dont le type de sortie est Application Adobe AIR,
s&eacute;lectionnez le type de sortie Aide accessible par navigateur pour chaque projet enfant.
3) Pour les projets ma&icirc;tres dont le type de sortie est Application Adobe AIR, s&eacute;lectionnez le type de
sortie Aide accessible par navigateur pour le projet enfant.
4) Affichez les param&egrave;tres de publication.
–
(Adobe AIR/WebHelp) Cliquez sur l'onglet Publier dans la bo&icirc;te de dialogue des propri&eacute;t&eacute;s de
mise en page.
–
(FlashHelp/Microsoft HTML Help) Cliquez sur Suivant jusqu'&agrave; ce que la bo&icirc;te de dialogue
Publier s'affiche.
140
CHAPITRE 3
5)
6)
7)
8)
FUSION DE PROJETS D'AIDE
PROJETS
Indiquez une destination. Par exemple, [dossier_du_projet_ma&icirc;tre]/SSL!/[nom_de_la_mise_en_page]/mergedProjects/[nom_du_projet_enfant] ou //nom_serveur/mergedProjects/[nom_du_projet_enfant].
Cliquez sur Enregistrer et g&eacute;n&eacute;rer. La mise en page est g&eacute;n&eacute;r&eacute;e.
Dans la bo&icirc;te de dialogue R&eacute;sultat, cliquez sur Publier.
Au terme du processus, une bo&icirc;te de dialogue affiche les statistiques se rapportant au processus,
ainsi que la liste des fichiers publi&eacute;s.
Cliquez sur Fermer.
Affichage des projets d'aide fusionn&eacute;s
1)
2)
Pour afficher le syst&egrave;me d'aide fusionn&eacute; depuis la copie locale du projet ma&icirc;tre (au lieu de
l'emplacement publi&eacute;), copiez les fichiers WebHelp des projets enfants dans le dossier
mergedProject\&lt;NomProjet&gt; du projet ma&icirc;tre.
REMARQUE : Pour ex&eacute;cuter l'aide accessible par navigateur &agrave; partir d'un lecteur local, le dossier
d'installation doit &ecirc;tre ajout&eacute; &agrave; la liste des dossiers approuv&eacute;s d&eacute;finie dans le fichier RoboHelp.cfg
du dossier FlashPlayerTrust. Voir Distribution de la sortie Adobe AIR.
Cliquez avec le bouton droit de la souris sur le dossier Mises en page source unique et s&eacute;lectionnez
Afficher. Si vous utilisez cette m&eacute;thode, veillez &agrave; ne pas utiliser l'option Republier tout dans le projet
ma&icirc;tre car cette op&eacute;ration pourrait remplacer les derniers fichiers des projets enfants sur le r&eacute;seau
ou sur le serveur.
Suppression de projets enfants fusionn&eacute;s
1)
Pour supprimer un projet d'aide fusionn&eacute;, cliquez sur Supprimer dans le conteneur Table des
mati&egrave;res. L'ic&ocirc;ne du projet enfant est supprim&eacute;e. R&eacute;g&eacute;n&eacute;rez (et publiez le cas &eacute;ch&eacute;ant) le projet
ma&icirc;tre pour supprimer le projet enfant de la sortie. Pour les projets WebHelp, publiez les projets
enfants pour que la modification prenne effet.
Personnalisation des projets Responsive HTML5, WebHelp Pro, ou FlashHelp Pro
fusionn&eacute;s
RoboHelp Server fusionne automatiquement les projets Responsive HTML5, WebHelp Pro ou
FlashHelp Pro. Les projets apparaissent dans la table des mati&egrave;res dans l'ordre alphab&eacute;tique. Pour
imbriquer la table des mati&egrave;res d'un projet dans la table des mati&egrave;res d'un autre projet, vous pouvez
r&eacute;organiser les projets dans la table des mati&egrave;res. Vous pouvez demander &agrave; l'administrateur du serveur
de modifier l'ordre des projets dans RoboHelp Server ou vous pouvez personnaliser les projets par
vous-m&ecirc;me.
1) Demandez &agrave; l'administrateur du serveur de d&eacute;s&eacute;lectionner l'option Fusionner automatiquement
tous les projets dans l'onglet Projets de RoboHelp Server (interface Admin Web).
2) Ouvrez le projet ma&icirc;tre. S&eacute;lectionnez un projet quelconque ou un projet vide en tant que projet
ma&icirc;tre.
141
CHAPITRE 3
3)
4)
5)
6)
7)
8)
FUSION DE PROJETS D'AIDE
PROJETS
Dans le conteneur Table des mati&egrave;res, cliquez sur l'ic&ocirc;ne Nouveau projet fusionn&eacute;. La bo&icirc;te de
dialogue Projet fusionn&eacute; s'ouvre.
Dans la zone Nom du projet, saisissez un nom de projet Responsive HTML5, WebHelp Pro ou
FlashHelp Pro (XPJ). Vous pouvez &eacute;galement cliquer sur Ouvrir pour acc&eacute;der au fichier de projet.
Une r&eacute;f&eacute;rence &agrave; ce projet est ins&eacute;r&eacute;e dans la table des mati&egrave;res du projet actuel sur lequel vous avez
cliqu&eacute;.
Cliquez sur OK. Une ic&ocirc;ne accompagn&eacute;e du nom du projet s'affiche dans la table des mati&egrave;res dans
laquelle vous avez ins&eacute;r&eacute; le projet enfant. L'ic&ocirc;ne est un espace r&eacute;serv&eacute; qui indique l'emplacement
de la table des mati&egrave;res du projet enfant dans le projet fusionn&eacute;. Si n&eacute;cessaire, vous pouvez
d&eacute;placer l'ic&ocirc;ne et la d&eacute;poser &agrave; un autre emplacement de la table des mati&egrave;res.
G&eacute;n&eacute;rez tous les projets pour mettre &agrave; jour toutes les modifications.
Publiez le projet ma&icirc;tre.
REMARQUE : (Pour la sortie HTML5 uniquement) Si, en raison d'un probl&egrave;me technique, le projet
enfant n'appara&icirc;t pas correctement dans la sortie publi&eacute;e, r&eacute;g&eacute;n&eacute;rez le projet enfant localement et
remplacez-le sur le serveur (dans la m&ecirc;me zone) par la sortie (locale) nouvellement g&eacute;n&eacute;r&eacute;e.
Affichez le projet fusionn&eacute; &agrave; partir du serveur.
REMARQUE : (Pour la sortie HTML5 uniquement) Dans la console d'administration, vous ne verrez que
le projet parent. Une entit&eacute; distincte du projet enfant n'est pas affich&eacute;e. Lorsque vous ouvrez le
projet parent, le contenu du projet enfant s'affiche dans le projet parent.
Questions fr&eacute;quentes sur la fusion des projets
Ces informations s'appliquent aux projets Adobe AIR, WebHelp et Microsoft HTML Help.
Projets ma&icirc;tres
Quel projet est le plus appropri&eacute; pour &ecirc;tre projet ma&icirc;tre ?
Un projet vide sans rubrique utilis&eacute; comme conteneur pour les projets enfants donne les meilleurs
r&eacute;sultats en tant que projet ma&icirc;tre. Si vous devez inclure du contenu dans le projet ma&icirc;tre, &eacute;vitez de cr&eacute;er
des liens entre projets.
La table des mati&egrave;res du projet ma&icirc;tre ne peut comporter que des r&eacute;f&eacute;rences aux projets enfants. Les
tables des mati&egrave;res des projets enfants apparaissent dans la sortie.
Le projet ma&icirc;tre peut-il inclure des cat&eacute;gories de contenu ?
Combien de projets enfants le projet ma&icirc;tre peut-il r&eacute;f&eacute;rencer ?
Il n'y a aucune limite au nombre de projets enfants que vous pouvez r&eacute;f&eacute;rencer dans le projet ma&icirc;tre.
Un projet ma&icirc;tre peut-il &ecirc;tre un projet enfant d'un autre projet ma&icirc;tre ?
Oui. Par exemple, le Projet A peut &ecirc;tre un projet ma&icirc;tre qui fait r&eacute;f&eacute;rence au Projet B et qui peut
&eacute;galement &ecirc;tre ajout&eacute; en tant que projet enfant du Projet C. Voici des exemples de chaque type de
sortie :
Pour les projets WebHelp : pour utiliser le Projet A en tant que projet enfant, publiez-le dans le dossier
\mergedProjects\ du Projet C.
142
CHAPITRE 3
FUSION DE PROJETS D'AIDE
PROJETS
Pour les projets HTML Help : pour utiliser le Projet A en tant que projet enfant, ajoutez le fichier CHM au
Projet C et g&eacute;n&eacute;rez les projets fusionn&eacute;s.
O&ugrave; dois-je placer le projet enfant dans la table des mati&egrave;res ?
Vous pouvez placer le projet enfant &agrave; n'importe quel endroit de la table des mati&egrave;res du projet ma&icirc;tre (en
tant que livre de niveau secondaire ou de premier niveau). Apr&egrave;s avoir ins&eacute;r&eacute; les projets enfants dans la
table des mati&egrave;res, vous pouvez les placer &agrave; l'emplacement s&eacute;lectionn&eacute; de la table des mati&egrave;res en les
faisant glisser. Cependant, vous ne pouvez pas s&eacute;parer ou diviser la table des mati&egrave;res du projet enfant
dans la table des mati&egrave;res principale. La table des mati&egrave;res du projet enfant appara&icirc;t dans son int&eacute;gralit&eacute;,
&agrave; l'endroit o&ugrave; vous la placez.
La g&eacute;n&eacute;ration ou la publication du projet ma&icirc;tre mettent-elles &agrave; jour les projets enfants ?
Non. Pour mettre &agrave; jour un projet enfant dans le syst&egrave;me d'aide fusionn&eacute;, g&eacute;n&eacute;rez le projet enfant. Dans
les projets WebHelp, publiez &eacute;galement les projets enfants dans le dossier correct.
Fonctionnalit&eacute;s
Dois-je fusionner l'index s&eacute;par&eacute;ment ?
Non. La nouvelle version mise &agrave; jour de la fonction de fusion de RoboHelp fusionne l'index
automatiquement.
Que se passe-t-il si les projets fusionn&eacute;s ont des mots-cl&eacute;s d'index, des termes de glossaire ou des
contr&ocirc;les Liens identiques ?
–
Mots-cl&eacute;s d'index
Les mots-cl&eacute;s d'index identiques sont combin&eacute;s lors de l'ex&eacute;cution. Par exemple, si le projet A
et le projet B ont tous deux le mot-cl&eacute; &laquo; Installation &raquo;, ce mot-cl&eacute; contient toutes les rubriques
et mots-cl&eacute;s secondaires des deux projets.
–
Termes du glossaire
Dans les projets WebHelp, si le m&ecirc;me terme est utilis&eacute; dans le projet ma&icirc;tre et dans les projets
enfants, les d&eacute;finitions sont combin&eacute;es lors de l'ex&eacute;cution (si les d&eacute;finitions sont diff&eacute;rentes,
elles sont plac&eacute;es sur des lignes distinctes dans le volet D&eacute;finition de).
Dans les projets HTML Help, si le m&ecirc;me terme est utilis&eacute; dans le projet ma&icirc;tre et dans les
projets enfants, la d&eacute;finition du projet ma&icirc;tre remplace la d&eacute;finition des projets enfants.
–
Voir aussi Mots-cl&eacute;s
•
Dans WebHelp, les mots-cl&eacute;s Voir aussi identiques ne sont pas combin&eacute;s lors de
l'ex&eacute;cution. Chaque projet utilise ses propres mots-cl&eacute;s Voir aussi. Par exemple, m&ecirc;me
si le Projet A et le Projet B utilisent tous les deux le mot-cl&eacute; &laquo; Configuration &raquo;, les
rubriques affich&eacute;es sont celles des projets individuels uniquement.
•
Dans l'aide HTML, les mots-cl&eacute;s Voir aussi identiques sont combin&eacute;s lors de l'ex&eacute;cution.
Pouvez-vous fusionner les s&eacute;quences de navigation ?
Non, les s&eacute;quences de navigation ne sont pas fusionn&eacute;es. Toutefois, toutes les s&eacute;quences de navigation
d&eacute;finies dans chaque projet fusionn&eacute; sont disponibles dans l'aide fusionn&eacute;e.
143
CHAPITRE 3
FUSION DE PROJETS D'AIDE
PROJETS
Quel est le mode de gestion du texte conditionnel ?
Les projets enfants g&eacute;n&eacute;r&eacute;s avec une expression de construction conditionnelle sont pris en charge dans
le projet ma&icirc;tre. Par exemple, si un projet enfant d&eacute;finit une expression de construction conditionnelle
visant &agrave; exclure la balise A, toutes les rubriques et le contenu de rubrique ayant une balise A appliqu&eacute;e
sont exclus du projet enfant et du projet ma&icirc;tre.
Pour les projets HTML Help, les liens vers les rubriques externes sont-ils conserv&eacute;s ?
Pour les projets fusionn&eacute;s HTML Help, les mots-cl&eacute;s d'index, les livres et les pages de table des mati&egrave;res,
ainsi que les rubriques HTML peuvent renvoyer &agrave; des rubriques externes de tous les fichiers CHM inclus
dans le projet ma&icirc;tre. (Les rubriques distantes ne sont pas prises en charge dans WebHelp.)
Projets WebHelp
Comment puis-je distribuer des projets WebHelp fusionn&eacute;s ?
Publiez les projets WebHelp fusionn&eacute;s vers un intranet ou une adresse Web, un disque local ou r&eacute;seau ou
un serveur FTP.
O&ugrave; puis-je publier les projets ?
Vous publiez le projet ma&icirc;tre &agrave; l'endroit habituel, mais les projets enfants sont publi&eacute;s dans un
emplacement particulier.
Qu'arrive-t-il aux r&eacute;f&eacute;rences aux projets enfants qui ne sont pas publi&eacute;s ?
Si vous ajoutez un projet enfant au projet ma&icirc;tre mais que vous ne le publiez pas, le projet enfant n'est
pas affich&eacute; lors de la publication du projet ma&icirc;tre.
Projets d'aide HTML
Quel type d'index dois-je utiliser ?
Le projet ma&icirc;tre doit disposer d'un index. Si ce n'est pas le cas, l'index fusionn&eacute; est vide. Pour la fusion de
fichiers CHM, le projet ma&icirc;tre doit avoir un index binaire lors de sa g&eacute;n&eacute;ration. Avec un index binaire, tous
les mots-cl&eacute;s des projets enfants sont fusionn&eacute;s, class&eacute;s dans l'ordre alphab&eacute;tique et enregistr&eacute;s dans le
fichier d'index (HHK) du projet ma&icirc;tre. Le format binaire est id&eacute;al car il est tr&egrave;s compress&eacute;, utilise moins
d'espace et est plus rapide &agrave; charger. Les fichiers d'index des projets enfants ne doivent pas
n&eacute;cessairement &ecirc;tre au format binaire.
D&eacute;finissez l'option Index binaire sur le projet ma&icirc;tre avant de fusionner les projets.
Comment puis-je distribuer les projets HTML Help ?
Distribuez les fichiers CHM de tous les projets et enregistrez-les dans le m&ecirc;me dossier que le projet
ma&icirc;tre. Lorsque vous fusionnez des projets, le fichier CHM du projet enfant est copi&eacute; dans le dossier du
projet ma&icirc;tre. D&egrave;s que vous mettez &agrave; jour et g&eacute;n&eacute;rez le projet enfant, copiez le fichier CHM mis &agrave; jour
dans le dossier du projet ma&icirc;tre.(Vous pouvez utiliser l'Explorateur Windows pour effectuer cette
op&eacute;ration.) Distribuez les versions les plus actuelles de tous les fichiers CHM.
144
CHAPITRE 3
RAPPORTS
PROJETS
Projets Adobe AIR
Comment distribuer les projets du type Application Adobe AIR fusionn&eacute;s ?
Un projet Application Adobe AIR correspond &agrave; un seul fichier .air. Pour distribuer ce fichier .air, copiez le
fichier depuis l'emplacement de sortie &agrave; l'emplacement partag&eacute; requis.
Comment ex&eacute;cuter une aide Adobe AIR accessible par navigateur fusionn&eacute;e &agrave; partir d'un dossier local ?
Ajoutez le dossier de sortie dans la liste des dossiers approuv&eacute;s d&eacute;finie dans le fichier RoboHelp.cfg du
dossier FlashPlayerTrust. Voir Distribution de la sortie Adobe AIR.
3.15. Rapports
Exportation de rapports de projet
1)
2)
3)
4)
5)
6)
7)
Cliquez sur Outils. S&eacute;lectionnez le type de rapport.
Personnalisez le rapport.
Cliquez sur Enregistrer sous.
Acc&eacute;dez &agrave; l'emplacement dans lequel enregistrer le fichier.
Saisissez le nom du fichier.
Dans la liste Type, s&eacute;lectionnez RTF ou TXT.
Cliquez sur Enregistrer.
Impression des rapports
1)
2)
3)
4)
S&eacute;lectionnez Outils.
S&eacute;lectionnez le type de rapport.
Personnalisez les options du rapport.
Cliquez sur Imprimer.
ASTUCE : Vous pouvez imprimer la table des mati&egrave;res ou l'index dans le conteneur Table des mati&egrave;res ou
le conteneur Index. Choisissez Fichier &gt; Imprimer.
Envoi de rapports
Vous pouvez partager les rapports en envoyant leur contenu par courrier &eacute;lectronique.
1) S&eacute;lectionnez Outils.
2) S&eacute;lectionnez le type de rapport. La bo&icirc;te de dialogue Rapports s'affiche.
3) Utilisez les options disponibles pour personnaliser le rapport. Tous les rapports ne sont pas
personnalisables.
145
CHAPITRE 3
4)
5)
RAPPORTS
PROJETS
Cliquez sur Courrier vers.
Votre programme de messagerie &eacute;lectronique cr&eacute;e un message. Les informations contenues dans le
rapport sont ins&eacute;r&eacute;es en tant que contenu du message. Vous pouvez ajouter ou modifier ces
informations comme pour tout autre courrier &eacute;lectronique.
Saisissez l'adresse du ou des destinataires et envoyez le message &eacute;lectronique.
REMARQUE : Si vous avez besoin d'aide pour utiliser la fonction Courrier vers (par exemple, le syst&egrave;me vous
invite &agrave; configurer un profil), contactez votre administrateur de messagerie &eacute;lectronique.
G&eacute;n&eacute;ration et personnalisation de rapports
Tous les rapports sont disponibles dans le menu Outils.
Rapport sur les liens rompus
Ce rapport (disponible dans Outils &gt; ID de mappage &gt; Liens rompus) trouve les fichiers contenant des
liens rompus. Il est impossible de personnaliser ce rapport.
Remarques :
•
•
Dans un environnement multi-auteur, sous contr&ocirc;le de version, assurez-vous qu'il n'existe pas de
liens vers des rubriques d&eacute;plac&eacute;es, renomm&eacute;es ou supprim&eacute;es. Ces liens seront rompus.
Pour un projet de contr&ocirc;le de version, faites tester les liens rompus de la derni&egrave;re version par une
personne avant la publication de la sortie finale.
Rapport sur les balises de construction conditionnelles
Ce rapport fournit des informations sur l'utilisation de balises de construction au niveau des rubriques,
du contenu ou de la table des mati&egrave;res dans l'int&eacute;gralit&eacute; du projet.
Il affiche un r&eacute;capitulatif du projet. Il identifie les balises de construction conditionnelles utilis&eacute;es dans le
projet. Pour chaque balise, il affiche le chemin d'acc&egrave;s vers toutes les rubriques dans lesquelles est
utilis&eacute;e la balise.
1) S&eacute;lectionnez Outils &gt; Propri&eacute;t&eacute;s de rubriques &gt; Balises. l'onglet Balises de construction de la bo&icirc;te
de dialogue Rapports affiche le rapport sur les balises de construction conditionnelles.
Par d&eacute;faut, le rapport trie les balises par nom de balise de construction.
2) (Facultatif) Pour modifier l'ordre de tri, s&eacute;lectionnez Options. La bo&icirc;te de dialogue Option du
rapport Balises de construction s'affiche.
3) S&eacute;lectionnez Nom de rubrique, de table des mati&egrave;res et d'index.
4) Cliquez sur OK. Vous pouvez afficher le rapport d'utilisation des balises tri&eacute; par nom de rubrique, de
table des mati&egrave;res et d'index.
Rapport Voir aussi
1)
2)
S&eacute;lectionnez Outils &gt; Table des mati&egrave;res &gt; Voir aussi. Le rapport Voir aussi s'affiche.
Personnalisez ces options le cas &eacute;ch&eacute;ant :
146
CHAPITRE 3
RAPPORTS
PROJETS
Mots-cl&eacute;s
Inclut tous les mots-cl&eacute;s de l'index.
Mots-cl&eacute;s et rubriques
Contient une liste de mots-cl&eacute;s. Chaque mot-cl&eacute; fournit une liste des rubriques qui l'utilisent. Vous
pouvez voir si les mots-cl&eacute;s ne sont li&eacute;s &agrave; aucune rubrique et identifier les rubriques &agrave; supprimer
des mots-cl&eacute;s.
Rubriques et mots-cl&eacute;s
Contient une liste de rubriques. Chaque rubrique fournit une liste des mots-cl&eacute;s qui y sont associ&eacute;s.
Vous pouvez voir si des mots-cl&eacute;s manquent dans une rubrique, d&eacute;tecter les incoh&eacute;rences d'emploi
des termes et identifier les mots-cl&eacute;s &agrave; supprimer des rubriques.
Rapport sur l'index
1)
2)
S&eacute;lectionnez Outils &gt; Table des mati&egrave;res &gt; Index.
Pour le personnaliser, s&eacute;lectionnez l'une des options suivantes :
Mots-cl&eacute;s
Inclut tous les mots-cl&eacute;s de l'index.
Mots-cl&eacute;s et rubriques
Contient une liste de mots-cl&eacute;s. Chaque mot-cl&eacute; fournit une liste des rubriques qui l'utilisent. Vous
pouvez voir si les mots-cl&eacute;s ne sont li&eacute;s &agrave; aucune rubrique et identifier les rubriques &agrave; supprimer
des mots-cl&eacute;s.
Rubriques et mots-cl&eacute;s
Contient une liste de rubriques. Chaque rubrique fournit une liste des mots-cl&eacute;s qui y sont associ&eacute;s.
Vous pouvez identifier les mots-cl&eacute;s manquants, les formulations incoh&eacute;rentes et les mots-cl&eacute;s &agrave;
supprimer des rubriques.
Bo&icirc;te de dialogue S&eacute;lectionner l'index
S&eacute;lectionnez un index dans la liste pour g&eacute;n&eacute;rer un rapport le concernant.
Rapport sur les ID de mappage en double
Chaque num&eacute;ro de mappage de votre projet doit &ecirc;tre unique. Cette bo&icirc;te de dialogue permet de
supprimer les ID de mappage en double.
Si votre projet inclut des rubriques d'aide contextuelle, assurez-vous que les num&eacute;ros de mappage dans
vos fichiers de mappage sont uniques. Si certains fichiers de mappage utilisent les m&ecirc;mes num&eacute;ros de
mappage, l'onglet ID de mappage en double permet de les identifier.
147
CHAPITRE 3
RAPPORTS
PROJETS
REMARQUE : En cas d'existence d'ID de mappage en double dans votre projet, certaines rubriques d'aide
contextuelle risquent de ne pas fonctionner correctement.
1) S&eacute;lectionnez Outils &gt; ID de mappage &gt; ID de mappage en double.
ASTUCE : Ce rapport permet de tester votre projet d'aide. Vous pouvez tester les num&eacute;ros de
mappage et les rubriques &agrave; l'aide de l'outil RoboHelp BugHunter.
Rapport sur les rubriques externes
Le rapport sur les rubriques externes (Outils &gt; ID de mappage &gt; Rubriques externes) contient des
donn&eacute;es sur les rubriques suivantes :
•
URL
•
Liens vers les rubriques HTML d'autres fichiers CHM
•
Adresses FTP
•
Adresses de groupes de discussion
•
Adresses &eacute;lectroniques
Conseils :
•
•
Ce rapport permet de tester les liens.
Partagez ce rapport avec les auteurs susceptibles d'en avoir besoin pour l'utilisation de ces URL.
Rapport sur le glossaire
1)
2)
S&eacute;lectionnez Outils &gt; Table des mati&egrave;res &gt; Glossaire.
S&eacute;lectionnez l'une de ces options dans le menu Rapports :
Listes d&eacute;taill&eacute;es
Termes et d&eacute;finitions
Listes de pr&eacute;sentations
Termes sans d&eacute;finition
Le rapport sur le glossaire s&eacute;lectionn&eacute; s'affiche.
Rapport sur les images
1)
S&eacute;lectionnez Outils &gt; Propri&eacute;t&eacute;s de rubriques &gt; Images. Le rapport sur les images s'affiche.
Afficher une liste alphab&eacute;tique des images
Sous chaque image se trouve la liste de toutes les rubriques qui l'utilisent.
Afficher une liste alphab&eacute;tique des rubriques
Sous chaque rubrique se trouve la liste de toutes les images qu'elles comportent.
148
CHAPITRE 3
RAPPORTS
PROJETS
Rapport sur les ID de mappage
Utilisez ce rapport (Outils &gt; ID de mappage &gt; ID de mappage) pour g&eacute;n&eacute;rer un r&eacute;capitulatif de projet. Il
inclut le nombre d'ID de mappage, l'ID et l'emplacement des rubriques, le num&eacute;ro de mappage et le nom
de fichier de mappage.
Le rapport sur les ID de mappage fournit des informations &agrave; propos de l'ensemble des rubriques d'aide
contextuelle utilis&eacute;es dans votre projet, notamment sur les ID de mappage et les rubriques textuelles
(pour l'aide).
Tout d'abord, le rapport affiche un r&eacute;capitulatif de la totalit&eacute; du projet. Il identifie le nombre d'ID de
mappage et fournit des informations sp&eacute;cifiques. Chaque rubrique du projet comprenant un ID de
mappage figure dans la liste avec l'ID de rubrique, le num&eacute;ro de mappage, le nom de fichier de mappage
et l'emplacement de la rubrique.
ASTUCE : Vous pouvez utiliser ce rapport comme r&eacute;f&eacute;rence pour le test de l' aide.
Rapport sur l'&eacute;tat du projet
Vous pouvez g&eacute;n&eacute;rer des informations pour un groupe de rubriques (Outils &gt; Etat du projet) en
s&eacute;lectionnant un dossier sp&eacute;cifique dans la liste de dossiers.
•
Nombre total de rubriques termin&eacute;es, en cours et pr&ecirc;tes pour la r&eacute;vision
•
Nombre total de rubriques du projet
•
Dur&eacute;e estim&eacute;e pour la r&eacute;daction de l'ensemble des rubriques.
•
Informations sur les actions &agrave; faire
Rapport sur les extraits de code
S&eacute;lectionnez Outils &gt; Propri&eacute;t&eacute;s de rubriques &gt; Extraits de code. Le rapport sur les extraits de code
appara&icirc;t et affiche les extraits de codes d&eacute;finis dans le projet. Le rapport sur les extraits de code pr&eacute;sente
&eacute;galement les rubriques dans lesquelles un extrait particulier a &eacute;t&eacute; utilis&eacute;.
Rapport sur les feuilles de style
Utilisez ce rapport (Outils &gt; Propri&eacute;t&eacute;s de rubriques &gt; Feuilles de style) pour afficher la liste des feuilles
de style ou des rubriques par ordre alphab&eacute;tique. La liste des feuilles de style affiche les feuilles de style
en fonction des rubriques auxquelles elles sont li&eacute;es. La liste des rubriques identifie la feuille de style li&eacute;e
&agrave; chacune des rubriques. Pour les trier, choisissez une option dans le menu Trier par.
Rapport sur la table des mati&egrave;res
Utilisez ce rapport (Outils &gt; Table des mati&egrave;res &gt; Table des mati&egrave;res) pour afficher des informations sur
vos tables des mati&egrave;res. Sp&eacute;cifiez le niveau de d&eacute;tail que vous voulez afficher :
D&eacute;tails
Inclut les titres des livres et des pages, les noms des rubriques li&eacute;es et l'emplacement des fichiers.
149
CHAPITRE 3
RAPPORTS
PROJETS
Pr&eacute;sentation
Inclut les titres des livres et des pages et les noms des rubriques li&eacute;es.
Le rapport sur la table des mati&egrave;res s&eacute;lectionn&eacute;e s'affiche.
ASTUCE : Vous pouvez modifier votre table des mati&egrave;res &agrave; chaque fois que vous modifiez les titres ou les
noms de fichier d'une rubrique.
Rapport sur les propri&eacute;t&eacute;s de rubriques
Utilisez ce rapport (Outils &gt; Propri&eacute;t&eacute;s de rubriques &gt; Propri&eacute;t&eacute;s de rubriques) pour filtrer les rapports en
fonction de diverses propri&eacute;t&eacute;s. Pour personnaliser le rapport, cliquez sur Options et s&eacute;lectionnez les
informations &agrave; ajouter :
G&eacute;n&eacute;ralit&eacute;s
Noms et emplacements des dossiers et des signets.
Etat de la rubrique
Etat, priorit&eacute;, heure, &eacute;l&eacute;ments des actions &agrave; faire r&eacute;alis&eacute;s et commentaires.
R&eacute;f&eacute;rences
Liens vers la rubrique, Liens &agrave; partir de la rubrique, ID de mappage, Table des mati&egrave;res, vois aussi
mots-cl&eacute;s, Mots-cl&eacute;s.
Avanc&eacute;
Types d'informations, balises de construction conditionnelles, mots-cl&eacute;s de la recherche et feuilles
de style, ainsi qu'exclure de la recherche.
Vous pouvez filtrer la liste des rubriques incluses dans le rapport en s&eacute;lectionnant un dossier sp&eacute;cifique
dans la liste de dossiers.
Rapport sur les r&eacute;f&eacute;rences de rubriques
Utilisez ce rapport (Outils &gt; Propri&eacute;t&eacute;s de rubriques &gt; R&eacute;f&eacute;rences de rubriques) pour assurer le suivi des
r&eacute;f&eacute;rences de rubriques. Les r&eacute;f&eacute;rences incluent :
•
Liens de rubriques.
•
Livres et pages de table des mati&egrave;res utilisant la rubrique.
•
Mots-cl&eacute;s et expressions utilisant la rubrique.
S&eacute;lectionnez la liste Dossier pour g&eacute;n&eacute;rer les informations relatives &agrave; un groupe de rubriques.
150
CHAPITRE 3
RAPPORTS
PROJETS
Conseils :
•
•
•
Ce rapport permet d'obtenir les r&eacute;f&eacute;rences &agrave; supprimer lors de la mise &agrave; jour des rubriques.
Avant de supprimer une rubrique, vous pouvez supprimer toutes les r&eacute;f&eacute;rences &agrave; cette rubrique. Ce
rapport permet d'identifier les r&eacute;f&eacute;rences de la rubrique et de les lier &agrave; nouveau &agrave; des rubriques
diff&eacute;rentes.
Si vous ne supprimez pas les r&eacute;f&eacute;rences lors de la suppression d'une rubrique, ce rapport identifie
les ruptures de r&eacute;f&eacute;rences potentielles.
Rapport sur les rubriques par priorit&eacute;
Le rapport sur les rubriques par priorit&eacute; (Outils &gt; Propri&eacute;t&eacute;s de rubriques &gt; Rubriques par priorit&eacute;) fournit
un r&eacute;capitulatif de votre projet. Il r&eacute;pertorie les rubriques tri&eacute;es en fonction de la priorit&eacute; attribu&eacute;e &agrave;
l'auteur. Ces informations sont collect&eacute;es &agrave; partir des propri&eacute;t&eacute;s de rubriques. Par cons&eacute;quent, pour que
ce rapport vous soit utile, vous devez modifier les propri&eacute;t&eacute;s de la rubrique pendant votre travail de
composition de l'aide.
Pour personnaliser les informations de ce rapport, cliquez sur Options et s&eacute;lectionnez les informations
que vous souhaitez inclure. Vous pouvez s&eacute;lectionner une plage de priorit&eacute;s &agrave; afficher ou toutes les
priorit&eacute;s. Vous pouvez &eacute;galement filtrer la liste des rubriques incluses dans le rapport en s&eacute;lectionnant
un dossier dans la liste de dossiers.
Rapport sur les rubriques non r&eacute;f&eacute;renc&eacute;es
Ce rapport personnalisable (Outils &gt; Propri&eacute;t&eacute;s de rubriques &gt; Rubriques non r&eacute;f&eacute;renc&eacute;es) permet
d'effectuer le suivi des rubriques non r&eacute;f&eacute;renc&eacute;es dans la table des mati&egrave;res, l'index, les s&eacute;quences de
navigation et d'autres rubriques. Il permet d'identifier :
•
Les rubriques inaccessibles. (Pour y rem&eacute;dier, cr&eacute;ez des liens &agrave; partir des autres rubriques.)
•
Les rubriques exclues de la table des mati&egrave;res.
•
Les rubriques sans index ou mots-cl&eacute;s Voir aussi. (Pour y rem&eacute;dier, ajoutez des mots-cl&eacute;s ou ajoutez
la rubrique &agrave; un mot-cl&eacute; Voir aussi.)
REMARQUE : Certaines rubriques n'utilisent pas de r&eacute;f&eacute;rences. Par exemple, si vous cr&eacute;ez une aide
contextuelle au niveau des fen&ecirc;tres, les rubriques ne sont accessibles que lorsque les utilisateurs finals
appuient sur la touche F1 ou cliquent sur Aide. Les r&eacute;f&eacute;rences sont dans ce cas inutiles. Vous pouvez
identifier les rubriques non r&eacute;f&eacute;renc&eacute;es que vous utilisez en tant que rubriques d'aide contextuelle.
Rapport sur les fichiers inutilis&eacute;s
Utilisez ce rapport (Outils &gt; Propri&eacute;t&eacute;s de rubriques &gt; Fichiers inutilis&eacute;s) pour afficher les fichiers
inutilis&eacute;s dans un emplacement. Vous pouvez trier par nom de fichier ou par type de fichier en
s&eacute;lectionnant dans le menu Trier par.
La suppression de ces fichiers est impossible &agrave; partir du projet. R&eacute;pertoriez les fichiers inutilis&eacute;s et leur
chemin d'acc&egrave;s, puis utilisez l'Explorateur Windows pour supprimer les fichiers.
IMPORTANT : Avant de supprimer des fichiers, faites une copie de sauvegarde du projet pour le cas o&ugrave; vous
devriez annuler vos modifications.
151
CHAPITRE 3
RAPPORTS
PROJETS
REMARQUE : La suppression syst&eacute;matique des fichiers non r&eacute;pertori&eacute;s dans le rapport des fichiers inutilis&eacute;s
provoque la rupture de liens, la perte de fichiers et d'autres cons&eacute;quences ind&eacute;sirables.
Rapport sur les mots-cl&eacute;s d'index inutilis&eacute;s
Utilisez ce rapport (Outils &gt; ID de mappage &gt; Mots-cl&eacute;s d'index inutilis&eacute;s) pour effectuer un suivi de tous
les mots-cl&eacute;s non li&eacute;s &agrave; des rubriques. Vous pouvez l'utiliser pour :
•
Identifier les mots-cl&eacute;s d'index que vous pourrez supprimer de votre projet.
•
Trouver les mots-cl&eacute;s d'index qui doivent &ecirc;tre associ&eacute;s &agrave; des rubriques.
•
V&eacute;rifier les r&eacute;f&eacute;rences crois&eacute;es incluses dans votre index.
Rapport sur les fichiers utilis&eacute;s
Utilisez ce rapport (Outils &gt; Propri&eacute;t&eacute;s de rubriques &gt; Fichiers utilis&eacute;s) pour obtenir un inventaire de tous
les fichiers du projet.
Rapport sur les rubriques manquantes
Utilisez ce rapport (Outils &gt; Propri&eacute;t&eacute;s de rubriques &gt; Rubriques manquantes) pour effectuer le suivi des
rubriques manquantes et plusieurs &eacute;l&eacute;ments associ&eacute;s :
•
Les tables des mati&egrave;res, livres et pages qui r&eacute;f&eacute;rencent les rubriques manquantes
•
Les mots-cl&eacute;s d'index et les expressions qui r&eacute;f&eacute;rencent les rubriques manquantes
S&eacute;lectionnez un dossier dans la liste Dossier pour g&eacute;n&eacute;rer les informations de groupe de rubriques.
Conseils :
•
•
Avant de supprimer une rubrique, supprimez toutes les r&eacute;f&eacute;rences qui y sont faites.
Si vous ne supprimez pas les r&eacute;f&eacute;rences lors de la suppression d'une rubrique, ce rapport identifie
les ruptures de r&eacute;f&eacute;rences potentielles.
Rapport sur les variables
Utilisez ce rapport (Outils &gt; Propri&eacute;t&eacute;s de rubriques &gt; Variables) pour r&eacute;pertorier des variables dans
l'ordre o&ugrave; elles ont &eacute;t&eacute; cr&eacute;&eacute;es ainsi que leurs valeurs et les informations sur leur utilisation.
Si vous affichez toutes les variables du projet, le rapport indique celles qui sont d&eacute;finies dans les
ensembles de variables et les fichiers dans lesquels elles sont utilis&eacute;es. Vous pouvez aussi trouver des
variables qui n'ont pas &eacute;t&eacute; utilis&eacute;es.
Ce rapport est utile lorsque vous voulez supprimer des variables. Recherchez toutes les rubriques dans
lesquelles les variables sont utilis&eacute;es et supprimez toutes les r&eacute;f&eacute;rences &agrave; ces variables avant de
supprimer les variables.
152
CHAPITRE 3
R&Eacute;F&Eacute;RENCES
PROJETS
3.16. R&eacute;f&eacute;rences
Bo&icirc;te de dialogue Propri&eacute;t&eacute;s de l'URL
Cette bo&icirc;te de dialogue permet de cr&eacute;er une liaison entre les mots-cl&eacute;s d'index et les URL de votre projet.
Mots-cl&eacute;s
Saisissez le mot ou l'expression que les utilisateurs finals doivent saisir dans l'index pour acc&eacute;der &agrave;
l'URL.
Bo&icirc;te de dialogue de suppression d'ancien projet
Supprimez l'ancien projet WebHelp Pro du serveur RoboHelp avant de publier le projet renomm&eacute;.
Bo&icirc;te de dialogue D&eacute;placer le fichier dans le projet
Restaurez un lien de rubrique rompu en recherchant un fichier ou en cr&eacute;ant un lien.
Essayer de trouver
Recherche le fichier li&eacute;.
Cr&eacute;er nouveau
Cr&eacute;e une rubrique et l'enregistre dans le dossier du projet pour r&eacute;parer le lien rompu.
Aide pour les options de style HTML
S&eacute;lectionner la feuille de style &agrave; utiliser
Sp&eacute;cifie le nom de la feuille de style &agrave; lier &agrave; toutes les rubriques HTML cr&eacute;&eacute;es.
Aucune feuille de style
Aucune feuille de style n'est li&eacute;e. Toutes les rubriques utilisent le formatage par d&eacute;faut.
Styles imbriqu&eacute;s
Aucune feuille de style n'est li&eacute;e aux rubriques. Toutes les rubriques HTML utilisent le formatage
WinHelp. Le formatage est imbriqu&eacute; dans chaque &eacute;l&eacute;ment HTML.
Convertir les listes &agrave; puces
Utilise les &eacute;l&eacute;ments de liste &agrave; puces des rubriques WinHelp dans les rubriques (conserve les listes &agrave;
puce).
Convertir les listes num&eacute;rot&eacute;es
Utilise les &eacute;l&eacute;ments de listes num&eacute;rot&eacute;es des rubriques WinHelp dans les rubriques (conserve les
listes num&eacute;rot&eacute;es).
153
CHAPITRE 3
R&Eacute;F&Eacute;RENCES
PROJETS
Conseils :
•
•
•
Une fois le projet converti, vous pouvez modifier les feuilles de style de votre choix.
Une fois la conversion termin&eacute;e, cr&eacute;ez de nouvelles feuilles de style, puis liez-les aux rubriques.
Les projets peuvent inclure plusieurs feuilles de style.
Param&egrave;tres avanc&eacute;s de HTML help – Trois volets
Boutons
D&eacute;finit les boutons/commandes &agrave; inclure &agrave; la barre d'outils. Options :
Masquer/Afficher
Masque les composants de l'onglet gauche dans les trois volets.
Options
Affiche un menu d&eacute;roulant proposant des options.
Localiser
Synchronise les volets gauche et droit (lorsque la synchronisation automatique de la table des
mati&egrave;res n'est pas s&eacute;lectionn&eacute;e).
Volet de navigation
D&eacute;finit l'apparence de la table des mati&egrave;res dans l'afficheur. Options :
Afficher/Masquer automatiquement le volet de navigation
Masque le volet de navigation de gauche lorsque les utilisateurs finals passent d'un fichier d'aide
compil&eacute; &agrave; un programme. Le contenu reste affich&eacute; dans le volet droit. Pour afficher les onglets de
gauche, l'utilisateur doit s&eacute;lectionner la fen&ecirc;tre.
Synchroniser automatiquement la table des mati&egrave;res
Formate les volets gauche et droit afin qu'ils se synchronisent &agrave; mesure que l'utilisateur navigue
dans le contenu.
REMARQUE : Les noms de fichier utilis&eacute;s pour les projets ne peuvent pas inclure des espaces. Une fois le
projet cr&eacute;&eacute;, vous pouvez remplacer automatiquement les espaces par des tirets de soulignement.
Largeur
D&eacute;finit la largeur du volet de navigation en pixels.
REMARQUE : Les noms de fichier utilis&eacute;s pour les projets ne peuvent pas inclure des espaces. Une fois le
projet cr&eacute;&eacute;, vous pouvez remplacer automatiquement les espaces par des tirets de soulignement.
Largeur
D&eacute;finit la largeur du volet de navigation en pixels.
154
CHAPITRE 3
R&Eacute;F&Eacute;RENCES
PROJETS
Police
S&eacute;lectionne une police d'affichage des titres dans l'onglet Contenu.
S&eacute;lectionnez
Ouvre la bo&icirc;te de dialogue Police.
Par d&eacute;faut
D&eacute;finit la police &agrave; utiliser avec vos param&egrave;tres syst&egrave;me par d&eacute;faut.
Param&egrave;tres avanc&eacute;s de HTML Help – Onglet Table des mati&egrave;res
Bordures
Ajoute une bordure autour du volet de table des mati&egrave;res.
Cadre de la bo&icirc;te de dialogue
Ajoute un cadre autour du volet de table des mati&egrave;res.
Lignes &agrave; partir de la racine
Permet d'afficher les lignes connectant les livres et les pages &agrave; partir de la racine.
Carr&eacute;s plus/moins
Affichage de carr&eacute;s et pour indiquer les livres ferm&eacute;s et ouverts.
Dossiers au lieu de livres
Affiche une ic&ocirc;ne de dossier &agrave; la place d'une ic&ocirc;ne de livre dans la table des mati&egrave;res.
Clic unique pour l'ouverture d'un livre
Formate les &eacute;l&eacute;ments du livre &agrave; ouvrir d'un seul clic. Lorsque cette fonctionnalit&eacute; n'est pas
s&eacute;lectionn&eacute;e, vous devez cliquer deux fois sur les livres pour les ouvrir.
Lignes entre &eacute;l&eacute;ments
Pour ajouter des lignes entre les livres et les pages
Bord relev&eacute;
Formate la table des mati&egrave;res afin qu'elle s'affiche en relief dans les trois volets.
Bord rentr&eacute;
Formate la table des mati&egrave;res afin qu'elle s'affiche enfonc&eacute;e dans les trois volets.
155
CR&Eacute;ATION, ENREGISTREMENT ET OUVERTURE DES RUBRIQUES
UTILISATION DES RUBRIQUES
CHAPITRE 4
4.
Utilisation des rubriques
4.1.
Cr&eacute;ation, enregistrement et ouverture des rubriques
Cr&eacute;er une rubrique
1)
2)
3)
Dans le conteneur Gestionnaire de projets, ouvrez le dossier Fichiers XHTML.
Pour stocker la rubrique dans un dossier sp&eacute;cifique, s&eacute;lectionnez le dossier requis.
Effectuez l'une des op&eacute;rations suivantes :
–
Cliquez sur l'ic&ocirc;ne Nouvelle rubrique .
–
Pour cr&eacute;er la rubrique &agrave; l'aide d'un autre &eacute;diteur HTML, cliquez avec le bouton droit de la
souris et s&eacute;lectionnez Nouveau &gt; Rubrique avec. S&eacute;lectionnez ensuite l'&eacute;diteur.
REMARQUE : Vous pouvez &eacute;galement cliquer avec le bouton droit de la souris sur la Liste des
rubriques et s&eacute;lectionnez Nouvelle rubrique avec &gt; [&eacute;diteur].
4)
5)
Sp&eacute;cifiez un titre pour la rubrique.
S&eacute;lectionnez une variable d&eacute;finie par l'utilisateur dans la liste Variables pour l'ins&eacute;rer dans le titre
de la rubrique et cliquez sur Ins&eacute;rer. Cliquez sur OK. Par exemple, au lieu d'incorporer un nom de
produit dans le titre, utilisez une variable d&eacute;finie par l'utilisateur pour le nom du produit. Les
variables d&eacute;finies par l'utilisateur vous aideront &agrave; g&eacute;rer les changements et garantir la coh&eacute;rence.
6) Si n&eacute;cessaire, modifiez le nom de fichier que RoboHelp cr&eacute;e &agrave; partir du titre de la rubrique.
Pour des r&eacute;sultats optimaux, utilisez des tirets de soulignement au lieu d'espaces dans les noms de
fichiers et suivez le protocole de nommage de fichiers HTML. &Eacute;vitez d'utiliser les caract&egrave;res suivants
dans les noms de fichier : \ / : * ? &lt; &gt; | # &quot;, $, &amp;, [ ]
(Appliquez les m&ecirc;mes conventions aux noms de fichier.)
7) (Facultatif) S&eacute;lectionnez une page principale.
8) Indiquez une langue pour la nouvelle rubrique.
REMARQUE : Si vous n'indiquez pas de langue pour la rubrique que vous cr&eacute;ez, RoboHelp utilise le
param&egrave;tre de langue du projet. RoboHelp utilise le param&egrave;tre de langue d'une rubrique pour la
v&eacute;rification orthographique, le dictionnaire des synonymes, l'index dynamique et l'indexation de la
recherche de texte int&eacute;gral. L'interface utilisateur de sortie est contr&ocirc;l&eacute;e par le param&egrave;tre de langue
du projet. Pour plus d'informations sur la prise en charge des langues, voir Cr&eacute;ation de contenu
multilingue.
9) Ajoutez des mots-cl&eacute;s pour aider les utilisateurs &agrave; rechercher le contenu de cette rubrique. Pour
s&eacute;parer les mots-cl&eacute;s, vous pouvez utiliser les caract&egrave;res fr&eacute;quemment utilis&eacute;s tels que la virgule, le
point-virgule et l'espace. L'espace est adapt&eacute; &agrave; la plupart des langues.
REMARQUE : Les mots-cl&eacute;s que vous indiquez sont ajout&eacute;s &agrave; l'index. Pour plus d'informations, voir
Mots-cl&eacute;s de rubrique.
10) S&eacute;lectionnez l'option Exclure cette rubrique de la recherche uniquement si vous ne souhaitez pas
afficher cette rubrique dans les r&eacute;sultats de recherche.
156
CHAPITRE 4
CR&Eacute;ATION, ENREGISTREMENT ET OUVERTURE DES RUBRIQUES
UTILISATION DES RUBRIQUES
REMARQUE : Exclure de la recherche n'est pas disponible pour la recherche dans Microsoft HTML
Help (CHM).
ASTUCE : Pour ouvrir une rubrique dans un &eacute;diteur tiers, cliquez avec le bouton droit de la souris dans le
gestionnaire de projets ou dans la Liste des rubriques puis s&eacute;lectionnez Modifier avec. La rubrique s'ouvre
dans l'&eacute;diteur s&eacute;lectionn&eacute; (la zone Editeur indique toujours l'&eacute;diteur d&eacute;fini pour le projet).
LIENS CONNEXES :
Ajout de tirets de soulignement aux noms de fichier
Enregistrement de rubriques
Enregistrement d'une rubrique
•
•
Appuyez sur Ctrl + S.
Sur la barre d'outils, cliquez sur l'ic&ocirc;ne Enregistrer.
Activation ou d&eacute;sactivation de l'enregistrement
Si vous d&eacute;sactivez la case Enregistrer sans invite, vous &ecirc;tes invit&eacute; &agrave; enregistrer les rubriques.
1) S&eacute;lectionnez Fichier &gt; Options.
2) Cliquez sur l'onglet G&eacute;n&eacute;ralit&eacute;s.
3) Dans la bo&icirc;te de dialogue Options, activez ou d&eacute;sactivez la case Enregistrer sans invite.
4) Cliquez sur OK.
Modification du nom des fichiers de rubrique
REMARQUE : &Eacute;vitez d'utiliser l'Explorateur Windows ou votre application de contr&ocirc;le de version pour
renommer des fichiers. Le gestionnaire de projets ne peut pas mettre les r&eacute;f&eacute;rences de fichier &agrave; jour.
1) Effectuez l'une des op&eacute;rations suivantes :
–
Dans le gestionnaire de projets, d&eacute;veloppez le dossier appropri&eacute;. S&eacute;lectionnez Projet &gt;
Afficher &gt; Afficher les rubriques &gt; Par nom de fichier. Cliquez avec le bouton droit de la souris
sur le fichier et s&eacute;lectionnez Renommer.
–
Dans le conteneur Liste des rubriques, cliquez sur le fichier avec le bouton droit. S&eacute;lectionnez
Propri&eacute;t&eacute;s.
2)
Tapez le nouveau nom.
Pour obtenir de meilleurs r&eacute;sultats, utilisez des tirets de soulignement &agrave; la place d'espaces et suivez
le protocole d'attribution de nom de fichier HTML. &Eacute;vitez d'utiliser les caract&egrave;res suivants dans les
noms de fichier : \ / : * ? &lt; &gt; | # &quot;, $, &amp;, [ ]
Si le nom de fichier est constitu&eacute; de plusieurs mots, remplacez les espaces par des tirets de
soulignement.
157
CR&Eacute;ATION DE CODE XHTML
UTILISATION DES RUBRIQUES
CHAPITRE 4
Ouverture de rubriques
Vous pouvez ouvrir des rubriques dans l'&eacute;diteur de conception tout en vous servant de RoboHelp pour
ajouter des fonctions d'aide en ligne.
1) Dans le conteneur Gestionnaire de projets ou Liste des rubriques, proc&eacute;dez de l'une des mani&egrave;res
suivantes :
–
Pour ouvrir la rubrique dans l'&eacute;diteur de conception (ou dans un &eacute;diteur tiers d&eacute;fini par
d&eacute;faut), cliquez deux fois sur la rubrique.
–
Pour ouvrir la rubrique dans un &eacute;diteur, cliquez avec le bouton droit de la souris sur la
rubrique, puis choisissez la commande Modifier avec &gt; [&eacute;diteur].
Si un message vous invite &agrave; poursuivre les modifications &eacute;ventuelles du code HTML, cliquez sur
Oui. Si vous souhaitez cependant &eacute;viter d'apporter des modifications d'un &eacute;diteur &agrave; l'autre,
modifiez les rubriques dans le m&ecirc;me &eacute;diteur et cliquez sur Non.
LIENS CONNEXES :
Editeur de conception RoboHelp
Editeurs HTML tiers
Prise en charge de plusieurs documents dans la m&ecirc;me interface
Vous pouvez ouvrir plusieurs rubriques dans l'&eacute;diteur de conception. Vous pouvez modifier des rubriques
simultan&eacute;ment, comparer des rubriques et copier le contenu d'une rubrique dans une autre.
Chaque rubrique ouverte poss&egrave;de un onglet correspondant dans le conteneur Editeur de conception.
Cliquez sur un onglet pour rendre active la fen&ecirc;tre de cette rubrique. Cliquez sur les fl&egrave;ches de d&eacute;filement
pour faire d&eacute;filer les onglets et r&eacute;v&eacute;ler les onglets masqu&eacute;s. Faites glisser les onglets pour positionner les
fen&ecirc;tres des rubriques horizontalement ou verticalement dans l'&eacute;diteur de conception.
4.2.
Cr&eacute;ation de code XHTML
RoboHelp permet de cr&eacute;er des fichiers de rubrique en code XHTML, ainsi que des fichiers sp&eacute;cifiques au
projet en XML. La cr&eacute;ation de documents structur&eacute;e en XHTML garantit que le code est correctement
&eacute;crit, que les balises sont bien ferm&eacute;es et qu'elles ne se chevauchent pas. De plus, les attributs sont bien
plac&eacute;s entre des guillemets et accompagn&eacute;s de valeurs explicites et vous n'&ecirc;tes pas confront&eacute; &agrave; des
attributs propri&eacute;taires. RoboHelp convertit l'ensemble des anciennes rubriques RoboHelp pour HTML au
format XHTML lorsqu'il les importe.
REMARQUE : Pour les projets mis &agrave; niveau, la mise en forme des listes &agrave; puces sera peut-&ecirc;tre incorrecte
dans la sortie. Une fois la mise &agrave; niveau d'un projet effectu&eacute;e, assurez-vous que le style des listes &agrave; puces
du CSS indique bien Z&eacute;ro ou une valeur positive pour la marge gauche.
158
CHAPITRE 4
CR&Eacute;ATION DE CODE XHTML
UTILISATION DES RUBRIQUES
L'&eacute;diteur RoboHelp cr&eacute;e l'ensemble des rubriques au format XHTML. Tous les fichiers de rubriques sont
conformes avec XHTML 1.0 Transitional. Le format XHTML g&eacute;n&eacute;r&eacute; &agrave; partir de RoboHelp est conforme &agrave; la
sp&eacute;cification XHTML 1.0 Transitional du World Wide Web Consortium (W3C). Toutes les rubriques
incluent le doctype XHTML 1.0 Transitional :
&lt;!DOCTYPE html PUBLIC &quot;-//W3C//DTD XHTML 1.0 Transitional//EN&quot;
&quot;http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd&quot;&gt;
Chaque rubrique XHTML comprend une balise HTML et une valeur d'attribut xmlns correspondant &agrave;
http://www.w3.org/1999/xhtml.
REMARQUE : Pour afficher la source XHTML d'une rubrique, ouvrez la rubrique dans l'&eacute;diteur de conception
et s&eacute;lectionnez la vue HTML.
Vous pouvez utiliser des &eacute;diteurs tiers, tels que le Bloc-notes, Microsoft Word ou Adobe Dreamweaver,
pour modifier vos fichiers et les conserver dans leur format actuel. Pour apporter des modifications &agrave; des
rubriques, utilisez un &eacute;diteur XHTML tiers. RoboHelp conserve ses instructions de traitement (PI,
processing instructions) sous la forme de commentaires, afin d'&eacute;viter toute perte de donn&eacute;es. Ce
programme vous permet &eacute;galement de modifier des rubriques HTML ou XHTML provenant d'&eacute;diteurs
tiers et de g&eacute;n&eacute;rer une sortie XHTML.
REMARQUE : Les extraits de code, les pages principales et les jeux de cadres sont cr&eacute;&eacute;s au format XHTML
uniquement.
Lors de la cr&eacute;ation d'un projet, RoboHelp g&eacute;n&egrave;re un certain nombre de fichiers propres &agrave; ce projet
(fichiers APJ, CSS, BRS...) au format XML. Par exemple, il cr&eacute;e la table des mati&egrave;res, l'index, le glossaire et
les extensions de nom de fichier de projet ci-apr&egrave;s, en XML :
.ali, .brs, .phr, .stp, .ign, .lng, .ssl, .xpj, .apj, .syn, .glo, .hhk, .hhc, .ppf, .fpj
Ces fichiers se trouvent &agrave; la racine du dossier de projet RoboHelp. Pour ouvrir ces fichiers et en lire le
contenu, utilisez des processeurs XML.
Conversion de code XHTML en HTML
1)
2)
S&eacute;lectionnez Fichier &gt; Options &gt; G&eacute;n&eacute;ral.
S&eacute;lectionnez Convertir les rubriques RoboHelp modifi&eacute;es en HTML.
En s&eacute;lectionnant cette option, vous convertissez l'ensemble des rubriques au format HTML dans la sortie
SSL. La cr&eacute;ation d'une sortie SSL vous permet de v&eacute;rifier que les fichiers de sortie sont bien au format
HTML ou XHTML. Les pages XHTML prennent en charge tous les effets DHTML applicables &agrave; l'aide de
RoboHelp HTML. Les pages HTML sont capables de traiter correctement le format DHTML. Dans une
rubrique, cliquez avec le bouton droit de la souris et s&eacute;lectionnez Afficher la rubrique ou Aper&ccedil;u de la
rubrique. Affichez la source du fichier de sortie ou g&eacute;n&eacute;rez un aper&ccedil;u de la rubrique pour v&eacute;rifier son
format (XHTML ou HTML).
LIENS CONNEXES :
Editeurs RoboHelp
159
IMPORTATION ET COPIE DE RUBRIQUES
UTILISATION DES RUBRIQUES
CHAPITRE 4
Validation de code XHTML
Vous pouvez valider le code XHTML g&eacute;n&eacute;r&eacute; par RoboHelp en fonction des sp&eacute;cifications W3C de
conformit&eacute; avec XHTML Transitional 1.0. Cliquez avec le bouton droit de la souris sur une rubrique dans
le gestionnaire de projets, puis s&eacute;lectionnez Valider la conformit&eacute; W3C pour valider la rubrique. Vous
pouvez s&eacute;lectionner Valider tout pour valider l'ensemble des rubriques.
Le langage XHTML ne prend pas en charge les fonctionnalit&eacute;s suivantes :
•
Textes d&eacute;filants dans les rubriques
•
Couleur de bordure dans les jeux de cadres
•
Son en arri&egrave;re-plan dans les propri&eacute;t&eacute;s de rubrique
L'utilisation de ces fonctionnalit&eacute;s entra&icirc;ne la g&eacute;n&eacute;ration d'un code XHTML non valide. Supprimez-les.
LIENS CONNEXES :
Conformit&eacute; W3C
4.3.
Importation et copie de rubriques
Importation de rubriques
1)
2)
3)
4)
5)
6)
7)
8)
S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Gestionnaire de projets. Le gestionnaire de projets
s'affiche.
Ouvrez le dossier Fichiers HTML (Rubriques).
Pour enregistrer le fichier dans un sous-dossier, s&eacute;lectionnez le dossier.
S&eacute;lectionnez Projet &gt; Importer &gt; Fichier HTML.
Acc&eacute;dez au fichier HTML/XHTML.
S&eacute;lectionnez le fichier. Appuyez sur la touche Ctrl pour s&eacute;lectionner plusieurs fichiers.
Cliquez sur Ouvrir.
Cliquez sur Oui pour copier le fichier dans le dossier du projet. Cliquez sur Oui pour tout pour copier
le fichier et tous ses composants.
REMARQUE : Vous pouvez &eacute;galement importer des documents FrameMaker (*.mif, *.fm, *.book,
*.bk), PDF (*.pdf) et Word (*.docx, *.docm, *.doc, *.rtf), des fichiers XML (*.xml), des cartes DITA
(*.ditamap) et des rubriques DITA (*.xml, *.dita).
Copie de rubriques dans un projet
1)
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Gestionnaire de projets. Le gestionnaire de
projets s'affiche.
–
S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Liste des rubriques. Le conteneur Liste des
rubriques s'affiche.
160
AFFICHAGE DES RUBRIQUES ET DES &Eacute;L&Eacute;MENTS DE CONCEPTION
UTILISATION DES RUBRIQUES
CHAPITRE 4
2)
3)
4)
5)
6)
7)
8)
S&eacute;lectionnez une rubrique.
Cliquez avec le bouton droit de la souris et s&eacute;lectionnez Dupliquer la rubrique.
Dans la zone Titre de la rubrique, saisissez le titre.
Si la rubrique est associ&eacute;e &agrave; une page principale, elle appara&icirc;t dans le menu contextuel Page
principale. Si Aucun est indiqu&eacute;, la rubrique utilise la feuille de style par d&eacute;faut.
Cliquez sur l'ic&ocirc;ne Afficher pour afficher la page principale. Vous pouvez aussi rechercher une
nouvelle page principale.
Cliquez sur l'onglet Pr&eacute;sentation pour modifier la feuille de style.
Cliquez sur OK.
La nouvelle rubrique est attach&eacute;e au projet. Elle s'affiche dans le volet Gestionnaire de projets.
4.4.
Affichage des rubriques et des &eacute;l&eacute;ments de conception
Aper&ccedil;u des rubriques
Affichez un aper&ccedil;u des rubriques au lieu de g&eacute;n&eacute;rer un projet dans son int&eacute;gralit&eacute;. Cliquez sur les liens et
les boutons Rubriques connexes, visualisez les effets HTML dynamiques, acc&eacute;dez aux cadres et aux
formulaires et affichez les fonctions.
IMPORTANT : Si les rubriques contiennent des liens vers des fichiers PDF, assurez-vous qu'Adobe&reg; Acrobat&reg;
10 est install&eacute; sur votre ordinateur. La pr&eacute;visualisation d'un fichier PDF dans Acrobat 9 ou dans une
version ant&eacute;rieure risque de ne pas fonctionner correctement.
Si plusieurs navigateurs sont install&eacute;s sur votre ordinateur, vous pouvez s&eacute;lectionner un navigateur dans
la liste Afficher avec de la fen&ecirc;tre d'aper&ccedil;u. RoboHelp affiche la rubrique dans le navigateur s&eacute;lectionn&eacute;.
1) Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Ouvrez la rubrique dans l'affichage de conception et cliquez sur l'ic&ocirc;ne Afficher de la barre
d'outils.
–
Cliquez avec le bouton droit de la souris sur la rubrique dans le conteneur Liste des rubriques
ou Gestionnaire de projets et s&eacute;lectionnez Afficher.
2)
3)
(Facultatif) Pour afficher un aper&ccedil;u des zones de texte conditionnel, s&eacute;lectionnez une expression de
balise de construction conditionnelle dans le menu.
REMARQUE : Pour modifier la balise de construction conditionnelle pendant l'aper&ccedil;u dans le
navigateur, modifiez-la dans la bo&icirc;te de dialogue d'aper&ccedil;u et cliquez sur Actualiser dans le
navigateur.
Cliquez sur Afficher avec et s&eacute;lectionnez le navigateur dans la liste des navigateurs install&eacute;s sur votre
ordinateur.
161
CHAPITRE 4
AFFICHAGE DES RUBRIQUES ET DES &Eacute;L&Eacute;MENTS DE CONCEPTION
UTILISATION DES RUBRIQUES
Remarques
•
•
•
•
•
Certaines fonctions, telles que les contr&ocirc;les Voir aussi et Lien de mot-cl&eacute;, ne fonctionnent pas en
mode Aper&ccedil;u, ni dans la bo&icirc;te de dialogue Aper&ccedil;u, ni dans le navigateur.
Les fen&ecirc;tres contextuelles purement textuelles ne peuvent pas &ecirc;tre affich&eacute;es dans Firefox, Chrome
ni Safari.
Si vous fermez la bo&icirc;te de dialogue Aper&ccedil;u, la rubrique affich&eacute;e dans le navigateur appara&icirc;t jusqu'&agrave;
l'actualisation de l'affichage du navigateur.
(Bo&icirc;te de dialogue Aper&ccedil;u) Les options Avant et Arri&egrave;re du menu contextuel facilitent la navigation
entre les rubriques ouvertes en cliquant sur les liens dans la rubrique d'aper&ccedil;u. Vous pouvez
&eacute;galement appuyer sur la touche Retour arri&egrave;re.
(Bo&icirc;te de dialogue Aper&ccedil;u) Si vous modifiez la rubrique dans l'&eacute;diteur de conception et faites glisser
la bo&icirc;te de dialogue Aper&ccedil;u, RoboHelp met &agrave; jour le contenu pour afficher les nouvelles
modifications.
D&eacute;finition d'une expression de construction conditionnelle
1)
2)
Dans la fen&ecirc;tre d'aper&ccedil;u, cliquez sur D&eacute;finir.
Indiquez les balises &agrave; exclure de la sortie :
–
Pour d&eacute;placer une balise, s&eacute;lectionnez-la et cliquez sur le bouton &agrave; fl&egrave;che unique.
–
Pour d&eacute;placer toutes les balises, cliquez sur le bouton &agrave; fl&egrave;che double.
3)
(Facultatif) Cliquez sur Avanc&eacute;. S&eacute;lectionnez une balise de construction conditionnelle dans le
menu. Cliquez sur Ajouter une balise. Cliquez sur l'op&eacute;rateur AND, OR ou NOT pour d&eacute;finir une
expression. Cliquez sur Effacer pour supprimer cette expression.
NOT
Exclut les rubriques qui utilisent la balise de construction conditionnelle indiqu&eacute;e. NOT est
l'expression de construction ayant la plus haute priorit&eacute;.
AND
Inclut ou exclut les rubriques qui utilisent des balises de construction conditionnelles sp&eacute;cifi&eacute;es.
AND est le deuxi&egrave;me op&eacute;rateur prioritaire.
OR
Inclut ou exclut les rubriques qui utilisent des balises de construction conditionnelles sp&eacute;cifi&eacute;es.
4)
5)
Cliquez sur OK pour revenir &agrave; la fen&ecirc;tre d'aper&ccedil;u.
Pour supprimer la condition de l'aper&ccedil;u, s&eacute;lectionnez Aucun dans le menu.
162
PAGES PRINCIPALES
UTILISATION DES RUBRIQUES
CHAPITRE 4
Affichage des &eacute;l&eacute;ments de conception
1)
S&eacute;lectionnez Modifier &gt; Affichage &gt; Afficher/masquer &gt; [&eacute;l&eacute;ment de conception].
El&eacute;ment de conception
Apparence dans l'&eacute;diteur de conception
Signets
Marqueurs de paragraphe
Grille du tableau
Glyphes
Champs
Balises inconnues
Zones conditionnelles
Commentaires
4.5.
Pages principales
REMARQUE : Les pages principales remplacent les mod&egrave;les de RoboHelp HTML 7 et des versions
pr&eacute;c&eacute;dentes.
Une page HTML se compose de trois &eacute;l&eacute;ments : le contenu, la mise en page et le style. Pour les sources
uniques, il est conseill&eacute; de s&eacute;parer le contenu du style et de la mise en page. Bien que les fichiers CSS
permettent de s&eacute;parer le style du contenu, la mise en page reste int&eacute;gr&eacute;e au code HTML. En utilisant les
pages principales, vous pouvez s&eacute;parer la mise en page et le style du contenu. Une page principale
comporte les informations de mise en page et est associ&eacute;e &agrave; un fichier CSS.
Une page principale correspond &agrave; un mod&egrave;le pour les rubriques HTML. Vous d&eacute;finissez l'insertion
d'en-t&ecirc;tes, de pieds de pages et d'espaces r&eacute;serv&eacute;s pour le corps, les chemins de navigation et la table
des mati&egrave;res de rubrique. Les pages principales peuvent inclure les extraits de code ainsi que les variables
d&eacute;finies par l'utilisateur. Vous pouvez cr&eacute;er une rubrique en utilisant une page principale ou associer une
rubrique existante &agrave; une page principale. Lorsque vous cr&eacute;ez une rubrique &agrave; l'aide d'une page principale,
le contenu du corps est plac&eacute; dans la rubrique en r&eacute;sultant. Si vous appliquez une page principale &agrave; une
rubrique existante, le contenu du corps est ignor&eacute;.
163
CHAPITRE 4
PAGES PRINCIPALES
UTILISATION DES RUBRIQUES
Les informations de mise en page d&eacute;finies dans les pages principales ne sont pas visibles dans l'onglet
Conception. Toutefois, vous pouvez y afficher la feuille CSS de la page principale. La mise en page s'affiche
lorsque vous g&eacute;n&eacute;rez un r&eacute;sultat ou un aper&ccedil;u. Le contenu de la rubrique est plac&eacute; dans l'espace r&eacute;serv&eacute;
du corps et la mise en page est h&eacute;rit&eacute;e de la page principale. Tous les espaces r&eacute;serv&eacute;s d&eacute;finis dans la page
principale sont &eacute;galement remplac&eacute;s par les informations pertinentes lorsque vous g&eacute;n&eacute;rez un r&eacute;sultat.
Vous pouvez utiliser des tableaux pour cr&eacute;er une mise en page pr&eacute;cise o&ugrave; chaque espace r&eacute;serv&eacute; est plac&eacute;
dans une cellule du tableau.
Espace r&eacute;serv&eacute; du corps
Lorsque vous cr&eacute;ez une rubrique &agrave; partir d'une page principale, cette rubrique comprend le contenu
de la page principale. Les informations de copyright en sont un bon exemple. Lorsque vous
appliquez une page principale &agrave; une rubrique, le contenu r&eacute;el de la rubrique remplace l'espace
r&eacute;serv&eacute; du corps au moment de l'aper&ccedil;u et de la g&eacute;n&eacute;ration.
REMARQUE : Lorsque vous appliquez une page principale &agrave; une rubrique, l'en-t&ecirc;te et le pied de page de la
rubrique sont remplac&eacute;s par ceux des pages principales.
Espace r&eacute;serv&eacute; de la table des mati&egrave;res de rubrique
Il affiche la table des mati&egrave;res de rubrique g&eacute;n&eacute;r&eacute;e automatiquement lors de la cr&eacute;ation de l'aper&ccedil;u
ou de la g&eacute;n&eacute;ration de la rubrique d'aide. D&eacute;finissez l'emplacement exact et le format de la table
des mati&egrave;res de rubrique en d&eacute;terminant la mise en page de la page principale. Par d&eacute;faut, les
niveaux autoris&eacute;s pour une mise en page de table des mati&egrave;res vont de titre 2 &agrave; titre 6.
Espace r&eacute;serv&eacute; de chemin de navigation
Il affiche les chemins de navigation g&eacute;n&eacute;r&eacute;s automatiquement lors de la g&eacute;n&eacute;ration de la rubrique
d'aide. Les chemins de navigation sont g&eacute;n&eacute;r&eacute;s &agrave; partir de la table des mati&egrave;res. Lorsque vous
affichez l'aper&ccedil;u d'une rubrique, les chemins de navigation r&eacute;els ne sont pas g&eacute;n&eacute;r&eacute;s et seule la
mise en page des chemins de navigation est visible.
Vous pouvez appliquer des balises de construction conditionnelles aux espaces r&eacute;serv&eacute;s de table des
mati&egrave;res de rubrique et de chemin de navigation, mais pas &agrave; celui du corps. Cependant, il est possible
d'appliquer une balise de construction conditionnelle au contenu dans l'espace r&eacute;serv&eacute; du corps ou en
dehors de ce dernier.
Cr&eacute;ation d'une page principale
1)
2)
3)
4)
5)
6)
S&eacute;lectionnez Sortie &gt; Page Principale &gt; Nouvelle page principale.
Indiquez un nom pour cette page dans l'onglet G&eacute;n&eacute;ralit&eacute;s.
REMARQUE : L'extension de fichier des pages principales est .htt.
Cliquez sur l'onglet Pr&eacute;sentation.
S&eacute;lectionnez une feuille de style &agrave; appliquer &agrave; la page principale.
(Facultatif) S&eacute;lectionnez les options relatives au son en arri&egrave;re-plan.
Cliquez sur OK.
164
CHAPITRE 4
PAGES PRINCIPALES
UTILISATION DES RUBRIQUES
Une nouvelle page principale affiche par d&eacute;faut l'espace r&eacute;serv&eacute; du corps. Vous pouvez ins&eacute;rer des tables
des mati&egrave;res de rubriques en cliquant sur l'ic&ocirc;ne Table des mati&egrave;res de rubrique , ainsi que des espaces
r&eacute;serv&eacute;s aux chemins de navigation en cliquant sur l'ic&ocirc;ne Chemins de navigation sur la barre d'outils
de l'&eacute;diteur de conception des pages principales. Toutefois, cette barre d'outils ne s'affiche pas pour les
pages normales. De m&ecirc;me, vous pouvez ins&eacute;rer autant de tables des mati&egrave;res de rubriques ou de
chemins de navigation que vous le souhaitez dans la page principale, &agrave; l'emplacement de votre choix.
Cr&eacute;ation d'une page principale &agrave; partir d'une rubrique
1)
2)
Ouvrez une rubrique.
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Cliquez avec le bouton droit de la souris dans l'&eacute;diteur de conception et s&eacute;lectionnez l'option
Ajouter &gt; Pages principales.
–
S&eacute;lectionnez Sortie &gt; Page Principale &gt; Ajouter la rubrique s&eacute;lectionn&eacute;e aux pages principales.
L'ensemble du contenu de la rubrique est boucl&eacute; dans l'espace r&eacute;serv&eacute; du corps. Si vous ajoutez une
rubrique &agrave; une page principale, toute rubrique cr&eacute;&eacute;e &agrave; partir de cette derni&egrave;re inclura le contenu de son
espace r&eacute;serv&eacute; de corps.
Lorsque les rubriques sont associ&eacute;es &agrave; une page principale, la feuille de style, l'en-t&ecirc;te et le pied de page
de cette derni&egrave;re remplacent les propri&eacute;t&eacute;s de style de la rubrique. Vous pouvez choisir de modifier plus
tard la feuille CSS d'une rubrique.
REMARQUE : Utilisez l'option Propri&eacute;t&eacute;s de rubrique pour modifier la page principale associ&eacute;e &agrave; une
rubrique.
LIENS CONNEXES :
En-t&ecirc;tes de page, pieds de page et sauts de page
Mise en forme des pages principales
Lorsque vous g&eacute;n&eacute;rez une mise en page ou en cr&eacute;ez un aper&ccedil;u, les propri&eacute;t&eacute;s de bordure et de trame des
pages principales prennent le pas sur celles des rubriques. Si les propri&eacute;t&eacute;s n'entrent pas en conflit, elles
sont appliqu&eacute;es de mani&egrave;re ind&eacute;pendante. Par exemple, si vous d&eacute;finissez les propri&eacute;t&eacute;s de bordure
d'une page principale et la couleur d'arri&egrave;re-plan d'une rubrique, elles seront dans les deux cas affect&eacute;es
&agrave; la rubrique de r&eacute;sultat finale.
Modification d'une page principale
1)
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Cliquez avec le bouton droit de la souris sur une page principale du conteneur Configuration
de sortie, puis choisissez l'option Modifier.
–
Cliquez deux fois sur une page principale du conteneur Configuration de sortie.
2)
Effectuez les modifications de votre choix.
165
CHAPITRE 4
PAGES PRINCIPALES
UTILISATION DES RUBRIQUES
Modifiez le fichier CSS associ&eacute; &agrave; la page principale
1)
2)
3)
4)
Cliquez avec le bouton droit de la souris et s&eacute;lectionnez l'option Propri&eacute;t&eacute;s.
Cliquez sur l'onglet Pr&eacute;sentation.
S&eacute;lectionnez une feuille de style dans la liste des feuilles de style disponibles dans un projet.
Cliquez sur OK.
REMARQUE : S&eacute;lectionnez l'onglet Utilis&eacute; dans la bo&icirc;te de dialogue Propri&eacute;t&eacute;s de la page principale pour
afficher un rapport sur les rubriques associ&eacute;es &agrave; la page principale.
Insertion d'un espace r&eacute;serv&eacute;
Vous pouvez ins&eacute;rer des espaces r&eacute;serv&eacute;s pour les tables des mati&egrave;res de rubriques, les chemins de
navigation et les rubriques des pages principales. Par d&eacute;faut, l'espace r&eacute;serv&eacute; du corps est ins&eacute;r&eacute; dans une
nouvelle page principale.
1) Placez le curseur en dessous de ou apr&egrave;s l'espace r&eacute;serv&eacute; du corps.
2) S&eacute;lectionnez Ins&eacute;rer &gt; Conception de page &gt; Tables des mati&egrave;res de rubriques ou Chemins de navigation.
REMARQUE : Vous ne pouvez pas ins&eacute;rer un espace r&eacute;serv&eacute; dans un paragraphe sous la forme de texte en
ligne, ni dans les en-t&ecirc;tes ou dans les pieds de page.
LIENS CONNEXES :
En-t&ecirc;tes de page, pieds de page et sauts de page
Mise en forme et modification des espaces r&eacute;serv&eacute;s
Vous pouvez mettre les styles en forme dans les espaces r&eacute;serv&eacute;s via l'option Formater les espaces
r&eacute;serv&eacute;s du menu contextuel. Ouvrez une page principale dans l'&eacute;diteur de conception et suivez l'une de
ces proc&eacute;dures :
•
Cliquez sur un espace r&eacute;serv&eacute; avec le bouton droit de la souris. S&eacute;lectionnez l'option Formater un
espace r&eacute;serv&eacute;.
•
S&eacute;lectionnez un espace r&eacute;serv&eacute; et cliquez sur l'ic&ocirc;ne Formater un espace r&eacute;serv&eacute; sur la barre
d'outils de l'&eacute;diteur de conception.
•
Cliquez deux fois sur l'espace r&eacute;serv&eacute;.
Remarques :
•
•
•
Si un espace r&eacute;serv&eacute; de corps est supprim&eacute; de la page principale ou n'y figure pas, les en-t&ecirc;tes de la
rubrique g&eacute;n&eacute;r&eacute;e (s'il y en a) appara&icirc;tront en premier, suivis du contenu HTML de la page principale,
du contenu de la rubrique et du pied de page (le cas &eacute;ch&eacute;ant).
Vous ne pouvez pas appliquer d'effets DHTML sur les espaces r&eacute;serv&eacute;s. En revanche, le contenu
plac&eacute; dans l'espace r&eacute;serv&eacute; du corps est de type HTML normal. De ce fait, vous pouvez lui appliquer
des effets DHTML.
Vous pouvez cr&eacute;er un aper&ccedil;u des pages principales, afin de v&eacute;rifier l'affichage du contenu des espaces
r&eacute;serv&eacute;s dans la sortie finale. Si des espaces r&eacute;serv&eacute;s de table des mati&egrave;res de rubrique et de chemin de
navigation sont ins&eacute;r&eacute;s dans la page principale associ&eacute;e, les tables des mati&egrave;res de rubriques et les
chemins de navigation sont g&eacute;n&eacute;r&eacute;s lors de la cr&eacute;ation de l'aper&ccedil;u ou de la mise en page.
166
CHAPITRE 4
PAGES PRINCIPALES
UTILISATION DES RUBRIQUES
LIENS CONNEXES :
Ajout de chemins de navigation aux rubriques
Importation de pages principales
Vous pouvez importer des pages principales &agrave; partir d'autres projets et les appliquer aux rubriques dans
votre projet actuel. Lorsque vous mettez &agrave; niveau RoboHelp 7 ou une version ant&eacute;rieure, les mod&egrave;les des
rubriques se transforment en pages principales si vous les importez. L'ensemble du contenu du mod&egrave;le
de la rubrique est boucl&eacute; dans l'espace r&eacute;serv&eacute; de corps, except&eacute; l'en-t&ecirc;te et le pied de page.
Application de pages principales
Vous pouvez appliquer ou modifier la page principale &agrave; une ou plusieurs rubriques simultan&eacute;ment.
Utilisez cette option pour modifier la page principale d'une ou plusieurs rubriques de votre projet, mais
pas toutes. Vous pouvez appliquer la page principale &agrave; toutes les rubriques lorsque vous g&eacute;n&eacute;rez le
r&eacute;sultat d'aide.
Application d'une page principale &agrave; une rubrique
1)
2)
3)
Dans le conteneur Liste des rubriques, cliquez avec le bouton droit de la souris sur la rubrique et
s&eacute;lectionnez l'option Propri&eacute;t&eacute;s.
Dans la bo&icirc;te de dialogue Propri&eacute;t&eacute;s de rubrique, cliquez sur l'onglet G&eacute;n&eacute;ral.
Toutes les pages principales d'un projet sont r&eacute;pertori&eacute;es dans le menu Page principale.
S&eacute;lectionnez une page principale, puis cliquez sur OK. (Facultatif) Vous pouvez &eacute;galement proc&eacute;der
comme suit :
–
Pour afficher l'aper&ccedil;u d'une page principale s&eacute;lectionn&eacute;e, cliquez sur l'ic&ocirc;ne Aper&ccedil;u.
–
Pour s&eacute;lectionner une page principale qui ne fait pas partie du projet en cours, cliquez sur le
bouton Parcourir.
Application d'une page principale &agrave; plusieurs rubriques
1)
2)
3)
4)
5)
Dans la liste de rubriques, classez les rubriques selon la page principale qui leur est associ&eacute;e.
REMARQUE : Si la colonne Page principale n'est pas visible, cliquez avec le bouton droit de la souris
sur un en-t&ecirc;te de colonne, puis s&eacute;lectionnez l'option Page principale dans le menu.
S&eacute;lectionnez les rubriques associ&eacute;es &agrave; la page principale que vous souhaitez remplacer. Si vous
appliquez des pages principales pour la premi&egrave;re fois, s&eacute;lectionnez les rubriques qui ne sont pas
associ&eacute;es &agrave; une page principale. Vous pouvez aussi s&eacute;lectionner plusieurs ensembles de rubriques
auxquelles diff&eacute;rentes pages principales sont appliqu&eacute;es.
Cliquez avec le bouton droit de la souris et s&eacute;lectionnez l'option Propri&eacute;t&eacute;s.
Dans la bo&icirc;te de dialogue Propri&eacute;t&eacute;s de rubrique, cliquez sur l'onglet G&eacute;n&eacute;ral.
S&eacute;lectionnez la page principale dans le menu Page principale, puis cliquez sur le bouton OK.
167
CHAPITRE 4
PAGES PRINCIPALES
UTILISATION DES RUBRIQUES
Application d'une page principale ou d'une feuille CSS lors de la g&eacute;n&eacute;ration
Les mises en page source unique vous permettent de remplacer la page principale ou la feuille CSS
lorsque vous g&eacute;n&eacute;rez un r&eacute;sultat. Pour obtenir des r&eacute;sultats diff&eacute;rents, appliquez d'autres pages
principales ou une autre feuille de style CSS.
Hormis Documentation imprim&eacute;e, chaque mise en page source unique fournit une option permettant
d'appliquer des pages principales ou des feuilles CSS. Vous pouvez opter pour l'application d'une page
principale ou d'une feuille CSS sur l'ensemble des rubriques d'un projet.
REMARQUE : Pour la mise en page Documentation imprim&eacute;e, vous pouvez appliquer uniquement une
feuille CSS diff&eacute;rente.
•
Si vous ne choisissez pas l'option Appliquer &agrave; toutes les rubriques, les pages principales associ&eacute;es
aux rubriques seront appliqu&eacute;es. Si aucune page principale n'est associ&eacute;e aux rubriques
individuelles, RoboHelp n'applique aucune page principale lors de la g&eacute;n&eacute;ration du r&eacute;sultat.
•
Si vous choisissez d'utiliser une page principale, celles qui se rapportent aux rubriques sont
ignor&eacute;es. La feuille CSS li&eacute;e &agrave; la page principale est alors appliqu&eacute;e et remplace celle qui est attach&eacute;e
aux rubriques.
•
Si vous d&eacute;cidez d'appliquer une feuille CSS, les pages principales associ&eacute;es aux rubriques prennent
effet. La feuille CSS s&eacute;lectionn&eacute;e porte sur l'ensemble des rubriques, qu'une page principale leur
soit li&eacute;e ou non.
Ajout d'en-t&ecirc;tes et de pieds de page pour la documentation imprim&eacute;e
Vous pouvez ajouter des en-t&ecirc;tes et des pieds de page sur les pages principales pour la documentation
imprim&eacute;e. Lorsque vous ajoutez un en-t&ecirc;te et/ou un pied de page, vous pouvez ajouter des informations
statiques. Par exemple, vous pouvez ajouter le nom de l'auteur du document au pied de page. Toutefois,
en plus des informations statiques, vous pouvez &eacute;galement ajouter des informations sp&eacute;cifiques au
document.
Pour ajouter des en-t&ecirc;tes et des pieds de page pour la documentation imprim&eacute;e:
1) Aller dans le conteneur Configuration de sortie.
2) D&eacute;veloppez le dossier des pages principales et cliquez deux fois pour ouvrir une page principale.
Sinon, pour cr&eacute;er une nouvelle page principale, cliquez avec le bouton droit de la souris sur l'ic&ocirc;ne
du dossier de pages principales et s&eacute;lectionnez Nouvelle page principale.
3) Pour ajouter ou modifier un en-t&ecirc;te &agrave; la page principale, cliquez sur l'ic&ocirc;ne de modification
d'en-t&ecirc;te dans l'angle sup&eacute;rieur droit du volet Page principale.
De m&ecirc;me, pour ajouter ou modifier un pied de page sur la page principale, cliquez sur l'ic&ocirc;ne de
modification de pied de page dans le coin sup&eacute;rieur droit du volet Page principale.
4) Dans l'en-t&ecirc;te ou le pied de page, ajoutez le contenu statique comme n&eacute;cessaire.
5) En plus du contenu statique, vous pouvez &eacute;galement ajouter les variables suivantes :
Num&eacute;ro de page :
Pour ajouter un num&eacute;ro de page &agrave; l'en-t&ecirc;te ou au pied de page, cliquez sur l'ic&ocirc;ne d'insertion de
num&eacute;ro de page dans le coin sup&eacute;rieur droit du volet Page principale.
168
GESTION DES RUBRIQUES
UTILISATION DES RUBRIQUES
CHAPITRE 4
Nom de chapitre
Pour ajouter un nom de chapitre &agrave; l'en-t&ecirc;te ou au pied de page, cliquez sur l'ic&ocirc;ne d'insertion de
nom de chapitre dans le coin sup&eacute;rieur droit du volet Page principale.
Le contenu statique des en-t&ecirc;tes et des pieds de page d'un document s'affiche tel quel, tandis que les
num&eacute;ros de page et les noms de chapitre s'affichent de fa&ccedil;on dynamique.
4.6.
Gestion des rubriques
Modification du nom d'une rubrique
Lorsque vous renommez une rubrique, le titre est mis &agrave; jour dans les propri&eacute;t&eacute;s de la rubrique. Les liens
vers la rubrique continuent de fonctionner. D'autres r&eacute;f&eacute;rences ne sont pas automatiquement mises &agrave;
jour. Par exemple, vous devrez peut-&ecirc;tre modifier le titre de la page de table des mati&egrave;res dans l'&eacute;diteur
de tables des mati&egrave;res.
Si vous cr&eacute;ez des rubriques &agrave; l'aide d'une page principale, les titres de rubriques sont automatiquement
mis &agrave; jour lorsque vous modifiez un titre de rubrique dans la bo&icirc;te de dialogue Propri&eacute;t&eacute;s de rubrique.
1) Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Gestionnaire de projets.
–
S&eacute;lectionnez Projet &gt; Conteneurs &gt; Liste des rubriques.
2)
3)
4)
5)
6)
S&eacute;lectionnez une rubrique.
Sur la barre d'outils, cliquez sur l'ic&ocirc;ne Propri&eacute;t&eacute;s . Cliquez sur l'onglet G&eacute;n&eacute;ral.
Dans la zone Titre de la rubrique, saisissez le titre.
Cliquez sur OK. Le titre de la rubrique est mis &agrave; jour.
Pour modifier le titre de la rubrique, ouvrez la rubrique dans l'&eacute;diteur de conception. Modifiez le
texte de l'en-t&ecirc;te.
REMARQUE : Pour faire correspondre le nom du fichier au nouveau nom de rubrique, vous devez remplacer
le nom du fichier lorsque vous modifiez le titre de la rubrique.
LIENS CONNEXES :
Modification du nom des fichiers de rubrique
G&eacute;rer des fichiers
Mise &agrave; jour des r&eacute;f&eacute;rences de rubriques
Si vous renommez un titre de rubrique, pensez &agrave; mettre &agrave; jour les &eacute;l&eacute;ments suivants comme indiqu&eacute;.
Lien de texte
Le chemin du lien est mis &agrave; jour, mais le texte du lien affich&eacute; sur l'&eacute;cran de l'utilisateur ne l'est pas.
Si le texte du lien d'une ou plusieurs rubriques inclut le titre de la rubrique, mettez &agrave; jour chaque
rubrique concern&eacute;e.
169
CHAPITRE 4
GESTION DES RUBRIQUES
UTILISATION DES RUBRIQUES
En-t&ecirc;te de rubrique
Pour faire correspondre l'en-t&ecirc;te de rubrique au titre de rubrique, effectuez vos modifications dans
l'&eacute;diteur de conception.
Table des mati&egrave;res
Mettez &agrave; jour le nouveau titre d'un livre ou d'une page. Dans le conteneur Table des mati&egrave;res,
cliquez avec le bouton droit de la souris sur le livre ou sur la page, puis s&eacute;lectionnez Renommer.
Saisissez le nouveau titre.
Index
Si le titre de la rubrique est un mot-cl&eacute; d'index, mettez le mot-cl&eacute; &agrave; jour dans le conteneur Index.
Cliquez avec le bouton droit de la souris sur le mot-cl&eacute; dans le volet sup&eacute;rieur, puis s&eacute;lectionnez
Renommer. Saisissez le nouveau titre.
Ajout de tirets de soulignement aux noms de fichier
Si les noms de fichier des rubriques se composent de plusieurs mots, vous pouvez configurer RoboHelp
HTML afin de remplacer les tirets de soulignement par des espaces. Cette convention permet aux livres
et aux pages de la table des mati&egrave;res de se synchroniser avec le contenu de la rubrique affich&eacute;e.
Les noms de fichier existants ne sont pas affect&eacute;s sauf si vous les modifiez.
1) S&eacute;lectionnez Fichier &gt; Options.
2) Cliquez sur l'onglet G&eacute;n&eacute;ralit&eacute;s.
3) S&eacute;lectionnez Utiliser des tirets de soulignement dans les noms de fichier.
Modification des propri&eacute;t&eacute;s de rubriques
Les rubriques disposent de propri&eacute;t&eacute;s d&eacute;finissant leur apparence et leurs mots-cl&eacute;s d'index. Vous pouvez
modifier les propri&eacute;t&eacute;s d'une seule rubrique ou d'un groupe de rubriques.
1) Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Cliquez avec le bouton droit de la souris sur une ou plusieurs rubriques dans le conteneur Liste
des rubriques. S&eacute;lectionnez Propri&eacute;t&eacute;s.
–
Cliquez avec le bouton droit de la souris sur une rubrique du conteneur Gestionnaire de
projets. S&eacute;lectionnez Propri&eacute;t&eacute;s.
–
Cliquez avec le bouton droit de la souris sur une rubrique dans l'&eacute;diteur de conception et
s&eacute;lectionnez Propri&eacute;t&eacute;s de la rubrique.
2)
3)
Cliquez sur un onglet et effectuez les modifications de votre choix.
Cliquez sur OK.
ASTUCE : Utilisez les options de l'onglet Etat pour effectuer le suivi du d&eacute;veloppement de la rubrique et
g&eacute;rer le projet. Pour acc&eacute;der &agrave; la barre d'&eacute;tat, cliquez avec le bouton droit de la souris sur une rubrique
puis s&eacute;lectionnez Propri&eacute;t&eacute;s. Dans la bo&icirc;te de dialogue Propri&eacute;t&eacute;s de rubrique, cliquez sur l'onglet Etat.
Vous pouvez &eacute;galement g&eacute;n&eacute;rer des rapports de projet en fonction des propri&eacute;t&eacute;s d&eacute;finies.
170
CHAPITRE 4
GESTION DES RUBRIQUES
UTILISATION DES RUBRIQUES
Modification des propri&eacute;t&eacute;s de rubrique sur l'onglet Index (WebHelp Pro)
Cet onglet permet d'utiliser des mots-cl&eacute;s r&eacute;f&eacute;renc&eacute;s par la rubrique.
Bo&icirc;te de dialogue S&eacute;lectionner l'index
S&eacute;lectionnez un index afin d'ajouter des mots-cl&eacute;s ou afficher les mots-cl&eacute;s r&eacute;f&eacute;renc&eacute;s connexes.
Mots-cl&eacute;s d'index
Cr&eacute;ez et modifiez des mots-cl&eacute;s.
Ajouter
Ajoutez un mot-cl&eacute; contenu dans la zone Mots-cl&eacute;s d'index.
Ajouter un &eacute;l&eacute;ment existant
Copiez un mot-cl&eacute; &agrave; partir d'autres rubriques.
Supprimer
Suppression d'un mot-cl&eacute;.
Remplacer
Remplacez un mot-cl&eacute; par le texte figurant dans la zone.
Index dynamique
Ouvrez l'assistant d'index dynamique.
Propri&eacute;t&eacute;s
Ouvrez l'onglet G&eacute;n&eacute;ral. Enregistrez le mot-cl&eacute; dans le fichier d'index ou dans la rubrique actuelle.
Modification de pages principales
Pour modifier la page principale &agrave; appliquer &agrave; une rubrique, s&eacute;lectionnez une page principale dans le
menu Pages principales. Par d&eacute;faut, la derni&egrave;re page principale est appliqu&eacute;e &agrave; la rubrique. Vous pouvez
afficher la page principale en cliquant sur le bouton Afficher ou rechercher une autre page principale
en cliquant sur le bouton Parcourir.
LIENS CONNEXES :
Mise &agrave; jour de la liste des actions &agrave; faire d'une rubrique
Association d'une feuille de style aux rubriques ou aux pages principales
Application de balises de construction conditionnelles &agrave; plusieurs rubriques
Identification des s&eacute;quences de navigation auxquelles une rubrique est assign&eacute;e
R&eacute;paration de liens rompus
171
CHAPITRE 4
GESTION DES RUBRIQUES
UTILISATION DES RUBRIQUES
Recherche d'une rubrique
Recherchez des rubriques dans votre projet &agrave; partir des conteneurs Table des mati&egrave;res, Index et
Gestionnaire de projets.
La recherche peut porter sur tout ou partie du titre d'une rubrique ou sur les propri&eacute;t&eacute;s d'une rubrique.
1) Cliquez sur le conteneur pour lancer une recherche :
–
Pour savoir dans quel dossier se trouve une rubrique, cliquez sur l'onglet Gestionnaire de
projets.
–
Pour savoir o&ugrave; se trouve une rubrique dans la table des mati&egrave;res, cliquez sur le conteneur
Table des mati&egrave;res.
–
Pour savoir &agrave; quel endroit de l'index une rubrique est r&eacute;f&eacute;renc&eacute;e, cliquez sur le conteneur
Index.
–
Pour savoir si une rubrique se trouve dans votre projet, cliquez sur le conteneur Liste des
rubriques.
2)
3)
4)
S&eacute;lectionnez Projet &gt; Afficher &gt; Localiser l'&eacute;l&eacute;ment.
Pour mener une recherche simple, cliquez sur l'onglet Recherche et indiquez l'ensemble ou une
partie du titre de rubrique dans la zone Le titre de la rubrique comprend.
Pour mener une recherche avanc&eacute;e, cliquez sur l'onglet Avanc&eacute;. Vous pouvez effectuer vos
recherches en fonction des options suivantes :
Le titre de la rubrique comprend
Entrez votre texte pour rechercher la rubrique par son titre.
Le nom du fichier comprend
Entrez votre texte pour rechercher la rubrique par nom de fichier.
Vous pouvez rechercher les propri&eacute;t&eacute;s de rubrique suivantes :
Etat
Cliquez pour ignorer l'&eacute;tat de la recherche ou au contraire rechercher des rubriques auxquelles un
&eacute;tat sp&eacute;cifique a &eacute;t&eacute; attribu&eacute;.
Fichier modifi&eacute;
Cliquez pour ignorer les dates de modification des fichiers ou au contraire rechercher des fichiers
modifi&eacute;s avant ou apr&egrave;s une date sp&eacute;cifique. Vous pouvez sp&eacute;cifier une date &agrave; droite de cette
option.
172
CHAPITRE 4
GESTION DES RUBRIQUES
UTILISATION DES RUBRIQUES
Priorit&eacute;
Cliquez pour ignorer les priorit&eacute;s des rubriques ou au contraire rechercher des rubriques auxquelles
une propri&eacute;t&eacute; sp&eacute;cifique a &eacute;t&eacute; attribu&eacute;e. Vous pouvez sp&eacute;cifier un num&eacute;ro &agrave; droite de cette option.
REMARQUE : La recherche par auteur n'est pas prise en charge.
La zone Rubriques trouv&eacute;es comprend les &eacute;l&eacute;ments suivants :
Rubriques trouv&eacute;es
Affiche les rubriques r&eacute;pondant aux crit&egrave;res de la recherche. S&eacute;lectionnez une rubrique dans cette
liste pour en afficher un aper&ccedil;u ou modifier ses propri&eacute;t&eacute;s.
Bouton Afficher
Affiche la rubrique s&eacute;lectionn&eacute;e dans la fen&ecirc;tre d'aper&ccedil;u.
Par titre
Cliquez pour rechercher du texte dans les titres de rubrique plut&ocirc;t que dans les noms de fichier.
Rubriques contenant &lt;&eacute;l&eacute;ment&gt;
Affiche les rubriques r&eacute;pondant aux crit&egrave;res de la recherche. S&eacute;lectionnez une rubrique dans cette
liste pour en afficher un aper&ccedil;u ou modifier ses propri&eacute;t&eacute;s.
Recherchez les rubriques ou les images dans le Gestionnaire de projets
Si vous travaillez actuellement sur une rubrique ou un extrait de code, vous pouvez parcourir
l'emplacement o&ugrave; la rubrique ou l'extrait de code existe dans le projet RoboHelp. Ou l'emplacement o&ugrave;
l'image s&eacute;lectionn&eacute;e existe dans la rubrique. Vous pouvez &eacute;galement rechercher une image s&eacute;lectionn&eacute;e
dans le Gestionnaire de projets.
1) Dans le ruban Projet, cliquez sur Localiser l'&eacute;l&eacute;ment .
La rubrique, l'extrait du code, ou l'image s'affiche comme &eacute;tant s&eacute;lectionn&eacute; dans le conteneur
Gestionnaire de projets.
Assignation d'une rubrique par d&eacute;faut
La rubrique par d&eacute;faut s'affiche dans le panneau Rubrique lorsque le syst&egrave;me d'aide est ouvert.
1) Dans le conteneur Mises en page source unique, cliquez sur la mise en page avec le bouton droit de
la souris. S&eacute;lectionnez Propri&eacute;t&eacute;s.
2) Cliquez sur S&eacute;lectionner en regard de la zone Rubrique par d&eacute;faut.
3) S&eacute;lectionnez une rubrique. Cliquez sur OK.
4) Cliquez sur Enregistrer.
5) G&eacute;n&eacute;rez et affichez la mise en page.
173
GESTION DES RUBRIQUES
UTILISATION DES RUBRIQUES
CHAPITRE 4
Etat du suivi de la rubrique
L'&eacute;tat des nouvelles rubriques est En cours par d&eacute;faut. Vous pouvez modifier cet &eacute;tat au cours de votre
travail.
Les informations sur l'&eacute;tat sont utilis&eacute;es dans le rapport Etat du projet.
1) Dans le conteneur Liste des rubriques, s&eacute;lectionnez des rubriques.
2) Cliquez sur le bouton Propri&eacute;t&eacute;s .
3) Cliquez sur l'onglet Etat.
4) D&eacute;finissez les options de votre choix:
Etat
Cliquez sur le triangle
pour s&eacute;lectionner une phase de d&eacute;veloppement.
Priorit&eacute;
Saisissez un nombre.
Heures
Saisissez un nombre afin d'attribuer le nombre d'heures estim&eacute; ou r&eacute;el pour le d&eacute;veloppement de
rubriques.
Liste d'actions &agrave; faire
S&eacute;lectionnez les &eacute;l&eacute;ments au moment o&ugrave; vous les terminez.
Commentaires
Saisissez du texte.
LIENS CONNEXES :
G&eacute;n&eacute;ration et personnalisation de rapports
Affichez et g&eacute;rez les informations sur les rubriques dans le conteneur Listes des rubriques
1)
Dans le conteneur Liste des rubriques, proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Pour afficher les informations sur ces rubriques, choisissez Projet &gt; Afficher l'&eacute;l&eacute;ment.
–
Pour trier les rubriques, cliquez sur l'en-t&ecirc;te de la colonne.
–
Pour choisir les d&eacute;tails &agrave; faire appara&icirc;tre dans le conteneur Liste des rubriques, cliquez avec le
bouton droit de la souris sur un en-t&ecirc;te de colonne, s&eacute;lectionnez Plus, puis choisissez les d&eacute;tails.
–
Pour afficher ou mettre &agrave; jour les propri&eacute;t&eacute;s de rubrique, s&eacute;lectionnez une ou plusieurs
rubriques, puis cliquez sur le bouton Propri&eacute;t&eacute;s .
–
Pour cr&eacute;er des r&eacute;f&eacute;rences de rubrique, faites glisser des rubriques de la liste pour cr&eacute;er une
table des mati&egrave;res, un index et des mots-cl&eacute;s Voir aussi.
LIENS CONNEXES :
Rapports
174
V&Eacute;RIFICATION D'ORTHOGRAPHE ET FONCTION RECHERCHER/REMPLACER
UTILISATION DES RUBRIQUES
CHAPITRE 4
Utilisation de la liste de balises
La liste de balises de l'onglet Conception affiche la structure hi&eacute;rarchique de la page HTML. La partie
sup&eacute;rieure de la hi&eacute;rarchie se trouve sur la gauche (toujours le document). L'&eacute;l&eacute;ment actuellement
s&eacute;lectionn&eacute; se trouve sur la droite.
•
Pour afficher la liste des balises, s&eacute;lectionnez Vue &gt; Afficher &gt; Afficher/masquer &gt; Liste de balises.
•
Pour s&eacute;lectionner un &eacute;l&eacute;ment dans l'&eacute;diteur de conception, cliquez sur cet &eacute;l&eacute;ment dans la liste de
balises.
•
Cliquez deux fois sur un &eacute;l&eacute;ment de la liste des balises pour en modifier les propri&eacute;t&eacute;s. D&eacute;finissez
les options.
Sp&eacute;cifiez les attributs de formatage &agrave; supprimer:
Balise
Balise HTML cr&eacute;ant le type de format sp&eacute;cifi&eacute;.
Texte
Texte auquel le formatage est appliqu&eacute;.
Classe
Classe (style sp&eacute;cifi&eacute; dans la feuille de style) utilis&eacute;e dans la balise HTML. Certaines balises n'ont pas
de classe attribu&eacute;e.
ID
ID (balise pour JavaScript ou HTML dynamique) utilis&eacute;e dans la balise HTML. Certaines balises n'ont
pas d'ID.
4.7.
V&eacute;rification d'orthographe et fonction rechercher/remplacer
REMARQUE : Si le projet est localis&eacute;, la v&eacute;rification orthographique repose sur un dictionnaire de la langue
de localisation.
V&eacute;rification orthographique dans la table des mati&egrave;res, l'index ou le glossaire
Lorsque le v&eacute;rificateur d'orthographe d&eacute;tecte une erreur, vous pouvez ignorer le mot, le modifier ou
l'ajouter au dictionnaire.
1) Ouvrez le composant &agrave; v&eacute;rifier.
2) S&eacute;lectionnez l'option Outils, puis V&eacute;rification orthographique (Table des mati&egrave;res, Index ou Glossaire).
3) S&eacute;lectionnez un mot sugg&eacute;r&eacute; ou entrez un mot de remplacement dans le champ Absent du dictionnaire.
4) S&eacute;lectionnez les options.
5) Pour ajouter le mot au dictionnaire personnalis&eacute;, cliquez sur Ajouter.
REMARQUE : Les glossaires en ligne sont disponibles dans les projets WebHelp et Microsoft HTML Help.
175
CHAPITRE 4
V&Eacute;RIFICATION D'ORTHOGRAPHE ET FONCTION RECHERCHER/REMPLACER
UTILISATION DES RUBRIQUES
D&eacute;finition des options de v&eacute;rification orthographique
1)
S&eacute;lectionnez R&eacute;vision &gt; Options orthographiques et effectuez une s&eacute;lection dans les ensembles
d'options suivants :
Options principales
V&eacute;rification orthographique au cours de la frappe
V&eacute;rifie l'orthographe des mots au cours de la frappe.
Corriger automatiquement lorsque c'est possible
Corrige les fautes d'orthographe au cours de la frappe. Pour afficher une liste des mots souvent mal
orthographi&eacute;s, ouvrez l'&eacute;diteur de dictionnaire.
Respecter la casse
Recherche les mots en majuscules ou minuscules comme indiqu&eacute;.
REMARQUE : Les options Corriger automatiquement lorsque c'est possible et Respecter la casse ne
fonctionnent pas si vous ne s&eacute;lectionnez pas l'option V&eacute;rification orthographique au cours de la frappe.
Options sp&eacute;ciales
Ignorer tous les mots en majuscules
Ignore tous les mots en majuscules.
Ignorer les mots contenant des chiffres
Ignore les cha&icirc;nes comportant &agrave; la fois des lettres et des chiffres.
Ignorer les doublons
Ignore les mots r&eacute;p&eacute;t&eacute;s.
Dictionnaire utilisateur
Vous permet de modifier le dictionnaire existant.
Options de correction orthographique automatique
Vous pouvez corriger automatiquement l'orthographe, &agrave; condition de s&eacute;lectionner l'option Corriger
automatiquement lorsque c'est possible et l'option V&eacute;rification orthographique au cours de la frappe
dans la bo&icirc;te de dialogue Options de v&eacute;rification orthographique. (S&eacute;lectionnez R&eacute;vision &gt; Options
orthographiques). Vous pouvez d&eacute;finir les mots mal orthographi&eacute;s ainsi que leur orthographe correcte.
Par exemple, vous pouvez ajouter &laquo; al&quot;atoiez&quot; &raquo; comme mauvaise orthographe et d&eacute;finir la bonne
orthographe : &laquo; al&eacute;atoire &raquo;.
REMARQUE : Les mauvaises orthographes ne sont pas pr&eacute;d&eacute;finies : pensez &agrave; les ajouter de mani&egrave;re
explicite. Cette fonction est conforme Unicode. Vous pouvez ajouter des mots dans n'importe quelle
langue, y compris le russe et le japonais, et ce dans le m&ecirc;me projet, une rubrique ou un paragraphe.
176
CHAPITRE 4
V&Eacute;RIFICATION D'ORTHOGRAPHE ET FONCTION RECHERCHER/REMPLACER
UTILISATION DES RUBRIQUES
Remplacer
Indiquez une mauvaise orthographe dans la zone Remplacer.
Avec
Indiquez le mot correct dans la zone Par.
Ajouter
Cliquez pour ajouter le mot &agrave; la liste Correction automatique.
Supprimer
Cliquez pour supprimer les entr&eacute;es mal orthographi&eacute;es.
Annuler
Annule tous les changements effectu&eacute;s dans les champs de la bo&icirc;te de dialogue.
OK
Cliquez sur ce bouton pour enregistrer les modifications effectu&eacute;es dans les champs de la bo&icirc;te de
dialogue.
Affichage de la liste Mots ignor&eacute;s
1)
S&eacute;lectionnez l'onglet Mots ignor&eacute;s. Utilisez cette bo&icirc;te de dialogue pour afficher la liste des mots
ignor&eacute;s au cours des v&eacute;rifications orthographiques.
Mots ignor&eacute;s
R&eacute;pertorie les mots ignor&eacute;s au cours de la v&eacute;rification orthographique.
Supprimer tout
Cliquez pour supprimer tous les mots de la liste Mots ignor&eacute;s.
Supprimer
Cliquez pour supprimer les mots s&eacute;lectionn&eacute;s de la liste Mots ignor&eacute;s.
V&eacute;rification orthographique dans les rubriques ou les projets
1)
Ouvrez une rubrique dans l'&eacute;diteur de conception. Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez R&eacute;vision &gt; V&eacute;rifier l'orthographe.
–
S&eacute;lectionnez Outils &gt; V&eacute;rifier l'orthographe de toutes les rubriques. (Facultatif) Cliquez sur le
bouton Ignorer la rubrique.
–
S&eacute;lectionnez R&eacute;vision &gt; V&eacute;rifier l'orthographe du projet. (Facultatif) Cliquez sur le bouton
Ignorer.
2)
S&eacute;lectionnez un mot sugg&eacute;r&eacute; ou entrez un mot de remplacement dans le champ Absent du
dictionnaire.
177
CHAPITRE 4
3)
4)
V&Eacute;RIFICATION D'ORTHOGRAPHE ET FONCTION RECHERCHER/REMPLACER
UTILISATION DES RUBRIQUES
S&eacute;lectionnez les options de votre choix.
Pour ajouter le mot au dictionnaire personnalis&eacute;, cliquez sur Ajouter.
Options de v&eacute;rification orthographique pour les rubriques
Absent du dictionnaire
Affiche le mot concern&eacute;.
Suggestions
R&eacute;pertorie toutes les orthographes sugg&eacute;r&eacute;es pour le mot en question.
ASTUCE : Si l'orthographe correcte du mot ne figure pas dans la liste, saisissez-la dans Absent du
dictionnaire.
Ajouter
Ajoute le mot au dictionnaire.
Ignorer
Ignore le mot et poursuit la v&eacute;rification orthographique.
Ignorer tout
Ajoutez le mot &agrave; la liste des mots &agrave; ignorer.
Modifier
Remplace le mot figurant dans Absent du dictionnaire par celui de la liste Suggestions.
Modifier tout
Remplace toutes les occurrences du mot figurant dans Absent du dictionnaire par celui de la liste
Suggestions.
Fermer
Permet de terminer la commande de v&eacute;rification orthographique et de fermer la bo&icirc;te de dialogue.
REMARQUE : La v&eacute;rification orthographique fonctionne pour la langue s&eacute;lectionn&eacute;e. Si la langue
s&eacute;lectionn&eacute;e ne prend pas en charge la v&eacute;rification orthographique, cette option est d&eacute;sactiv&eacute;e dans le
menu Outils.
Options de v&eacute;rification orthographique pour les projets
Contr&ocirc;le en cours
Affiche la rubrique en cours de v&eacute;rification.
Ignorer
Ignore la rubrique actuelle.
178
CHAPITRE 4
V&Eacute;RIFICATION D'ORTHOGRAPHE ET FONCTION RECHERCHER/REMPLACER
UTILISATION DES RUBRIQUES
Absent du dictionnaire
Affiche le mot ne figurant pas dans le dictionnaire.
Ajouter
Ajoute le mot au dictionnaire.
Suggestions
Affiche une liste des mots semblables au mot absent du dictionnaire.
Ignorer
Ignore le mot ne figurant pas dans le dictionnaire.
Ignorer tout
Ignore toutes les suggestions pour le mot s&eacute;lectionn&eacute;.
Modifier
Remplace le mot figurant dans la liste Absent du dictionnaire par celui de la liste Suggestions.
Modifier tout
Modifie toutes les occurrences du mot.
REMARQUE : Les mots sont ajout&eacute;s au dictionnaire personnalis&eacute; de la langue utilis&eacute;e par le projet.
LIENS CONNEXES :
Cr&eacute;ation de contenu multilingue
Personnalisation d'un dictionnaire
Utilisez l'&eacute;diteur de dictionnaire pour ajouter des mots, par exemple &laquo; RoboHelp &raquo;, &agrave; votre dictionnaire.
Le dictionnaire est sp&eacute;cifique &agrave; la langue et &agrave; l'utilisateur. Chaque langue dispose de son propre
dictionnaire et chaque utilisateur peut enregistrer ses modifications apport&eacute;es au dictionnaire.
REMARQUE : L'&eacute;diteur de dictionnaire fait la distinction entre les majuscules et les minuscules.
1) S&eacute;lectionnez R&eacute;vision &gt; Options orthographiques.
2) Cliquez sur l'onglet Options.
3) Cliquez sur Modifier.
4) Dans l'&eacute;diteur de dictionnaire, sous la liste Mot, saisissez une nouvelle entr&eacute;e, puis cliquez sur le
bouton Ajouter. Pour supprimer une entr&eacute;e, s&eacute;lectionnez-la et cliquez sur le bouton Supprimer.
REMARQUE : Vous ne pouvez pas annuler des ajouts ou des suppressions effectu&eacute;es dans l'&eacute;diteur du
dictionnaire, le bouton Annuler est donc d&eacute;sactiv&eacute;.
179
CHAPITRE 4
V&Eacute;RIFICATION D'ORTHOGRAPHE ET FONCTION RECHERCHER/REMPLACER
UTILISATION DES RUBRIQUES
Utilisation du th&eacute;saurus
1)
2)
3)
4)
Ouvrez une rubrique dans l'&eacute;diteur de conception.
S&eacute;lectionnez un mot.
S&eacute;lectionnez R&eacute;vision &gt; Th&eacute;saurus.
S&eacute;lectionnez un synonyme ou un antonyme et cliquez sur le bouton Remplacer.
Consult&eacute;
Affiche le mot s&eacute;lectionn&eacute; dans la rubrique ou saisi par l'utilisateur.
Remplacer par
Affiche un remplacement sugg&eacute;r&eacute; pour le mot.
Cat&eacute;gorie
Affiche la signification et la cat&eacute;gorie grammaticale du mot. Si plusieurs cat&eacute;gories s'affichent,
s&eacute;lectionnez-en une pour conna&icirc;tre les synonymes du mot.
Synonyme
R&eacute;pertorie les synonymes du mot s&eacute;lectionn&eacute;. S&eacute;lectionnez un mot pour remplacer le mot que vous
avez saisi.
Remplacer
Remplace le mot actuel par son synonyme.
Consulter
Ajoute des mots dans le menu contextuel Consult&eacute;.
Fermer
Fermez la bo&icirc;te de dialogue.
Recherche et remplacement
La fonctionnalit&eacute; Rechercher et remplacer de RoboHelp vous permet de rechercher (et &eacute;ventuellement
remplacer) du texte, des balises et des attributs HTML dans la rubrique actuelle, le projet actuel ou les
fichiers et dossiers dans le chemin sp&eacute;cifi&eacute;. Vous pouvez rechercher du texte dans l'&eacute;diteur HTML, les
index, et les tables des mati&egrave;res dans un projet. Vous pouvez ainsi rechercher du texte dans les
conteneurs d'index et de tables des mati&egrave;res. La fonctionnalit&eacute; Remplacer vous permet &eacute;galement de
remplacer du texte dans ces conteneurs.
Dans le conteneur Rechercher et remplacer, d&eacute;finissez les options de recherche. RoboHelp affiche
ensuite les r&eacute;sultats dans le conteneur R&eacute;sultats de la recherche et vous permet &eacute;galement d'ouvrir
chaque fichier modifi&eacute; dans le conteneur de l'&eacute;diteur des r&eacute;sultats de recherche (vue HTML). Lorsque
vous effectuez une op&eacute;ration de remplacement, RoboHelp fournit &eacute;galement la possibilit&eacute; de
sauvegarder les fichiers qui ont fait l'objet d'un remplacement de texte.
180
V&Eacute;RIFICATION D'ORTHOGRAPHE ET FONCTION RECHERCHER/REMPLACER
UTILISATION DES RUBRIQUES
CHAPITRE 4
REMARQUE : Le fonctionnement de l'outil est optimal avec les fichiers texte.
D&eacute;finition des options de recherche et remplacement
1)
Utilisez la combinaison de touches Ctrl+Maj+F ou effectuez l'une des op&eacute;rations suivantes :
–
Dans le ruban Projet, cliquez sur Rechercher et remplacer.
–
Dans la liste d&eacute;roulante des conteneurs des rubans Projet, Edition ou R&eacute;vision, s&eacute;lectionnez
Rechercher et remplacer.
2)
Indiquez les &eacute;l&eacute;ments &agrave; rechercher &agrave; l'aide de l'une des m&eacute;thodes suivantes :
–
(Mode de base) Saisissez le texte, la balise ou l'attribut que vous souhaitez rechercher dans la
zone Rechercher.
REMARQUE : Pour rechercher du texte, tel que Bureau Windows sur plusieurs lignes, tapez
Bureau(.|\n)*Windows et veillez &agrave; s&eacute;lectionner Utiliser l'expression r&eacute;guli&egrave;re.
–
(Mode Avanc&eacute;) Cliquez sur l'ic&ocirc;ne Mode avanc&eacute;. S&eacute;lectionnez les filtres et indiquez le texte,
la balise ou l'attribut pour que RoboHelp cr&eacute;e une expression r&eacute;guli&egrave;re.
Commence par
Sp&eacute;cifiez les expressions, mots ou caract&egrave;res qui doivent appara&icirc;tre au d&eacute;but des occurrences
trouv&eacute;es.
Se termine par
Sp&eacute;cifiez les expressions, mots ou caract&egrave;res qui doivent appara&icirc;tre &agrave; la fin des occurrences
trouv&eacute;es.
Contient
Sp&eacute;cifiez les expressions, mots ou caract&egrave;res qui doivent appara&icirc;tre dans les occurrences trouv&eacute;es.
Ne contient pas
Sp&eacute;cifiez les expressions, mots ou caract&egrave;res qui ne doivent pas appara&icirc;tre dans les occurrences
trouv&eacute;es.
REMARQUE : En mode avanc&eacute;, l'outil de recherche et de remplacement multifichiers effectue la
recherche multilignes.
3)
4)
Saisissez le texte, la balise ou l'attribut que vous souhaitez remplacer dans la zone Remplacer par.
Si vous souhaitez rechercher des cha&icirc;nes sans les remplacer, laissez la zone Remplacer par vide.
Utilisez l'option Rechercher dans pour rechercher les &eacute;l&eacute;ments suivants :
Projet actuel
(Par d&eacute;faut) Recherche dans le projet actuel.
Fen&ecirc;tre actuelle
Recherche dans la rubrique actuelle.
181
CHAPITRE 4
V&Eacute;RIFICATION D'ORTHOGRAPHE ET FONCTION RECHERCHER/REMPLACER
UTILISATION DES RUBRIQUES
Fichiers ouverts
Recherchez tous les fichiers actuellement ouverts dans RoboHelp.
Chemin
Recherchez tous les fichiers dans le chemin de dossier s&eacute;lectionn&eacute;.
REMARQUE : Dans le cas d'une recherche dans un chemin s&eacute;lectionn&eacute;, RoboHelp recherche
5)
6)
uniquement les fichiers pr&eacute;sents dans le conteneur Etat du fichier (Projet &gt; Ouvrir &gt; Conteneurs &gt;
Etat du fichier).
Pour limiter la recherche &agrave; des types de fichier sp&eacute;cifiques au sein du projet en cours, ou aux fichiers
ou dossiers que vous avez s&eacute;lectionn&eacute;s &agrave; l'&eacute;tape pr&eacute;c&eacute;dente, utilisez l'option Fichiers de type.
REMARQUE : La fonctionnalit&eacute; Rechercher et remplacer fonctionne mieux avec les fichiers texte.
(Facultatif) Utilisez les options suivantes pour limiter ou filtrer votre recherche :
Respecter la casse
La recherche porte sur le texte dont la casse correspond exactement &agrave; celle du texte que vous
voulez rechercher. Par exemple, si vous souhaitez rechercher portez ce vieux whisky, vous
ne trouverez pas Portez ce vieux whisky.
Utiliser l'expression r&eacute;guli&egrave;re
Permet d'utiliser les expressions de style Microsoft Word ou UNIX devant &ecirc;tre interpr&eacute;t&eacute;es comme
des op&eacute;rateurs d'expression r&eacute;guli&egrave;re. Pour plus d'informations, voir Utilisation des expressions
r&eacute;guli&egrave;res de style Microsoft.
Utiliser des caract&egrave;res g&eacute;n&eacute;riques
Permet d'utiliser des caract&egrave;res g&eacute;n&eacute;riques (tels que *,?) pour repr&eacute;senter un ou plusieurs
caract&egrave;res lorsque vous effectuez une recherche. Par exemple, index* trouve toutes les
occurrences du mot index ainsi que tous les fichiers qui commencent par index, comme
index.doc et index.txt.
REMARQUE : Lorsque vous utilisez des caract&egrave;res g&eacute;n&eacute;riques ou des expressions r&eacute;guli&egrave;res, les options
Rechercher le mot entier et Ignorer les balises HTML ne sont pas disponibles, indiquant ainsi que ces
options sont automatiquement d&eacute;sactiv&eacute;es. Vous ne pouvez pas activer ces options.
Rechercher le mot entier
Recherche du texte qui correspond &agrave; un ou plusieurs mots entiers. Par exemple, si vous entrez
nation comme terme de recherche, vous ne trouverez pas d&eacute;sig nation.
182
CHAPITRE 4
V&Eacute;RIFICATION D'ORTHOGRAPHE ET FONCTION RECHERCHER/REMPLACER
UTILISATION DES RUBRIQUES
Exclure les balises HTML
Recherche d'une cha&icirc;ne particuli&egrave;re de texte uniquement dans le contenu, en ignorant toute
occurrence dans des balises HTML. Par exemple, la recherche de la cha&icirc;ne title ne recherche que
les occurrences de la cha&icirc;ne dans le contenu et non dans des balises HTML, telles que &lt;title&gt;.
REMARQUE : Si vous souhaitez rechercher des attributs, d&eacute;sactivez l'option Exclure les balises HTML.
7)
(Facultatif) Utilisez les options suivantes lorsque vous remplacez du texte dans des fichiers.
Sauvegarder les fichiers modifi&eacute;s
Sauvegarde les fichiers d'origine avant le remplacement de texte.
Remplacer les sauvegardes
Permet de remplacer les sauvegardes existantes lorsque vous s&eacute;lectionnez Faire des sauvegardes.
Ouvrir les fichiers modifi&eacute;s apr&egrave;s l'action Tout remplacer
Ouvre chaque fichier modifi&eacute; dans l'&eacute;diteur HTML apr&egrave;s le remplacement du texte. Vous pouvez
passer en revue les modifications, les annuler si n&eacute;cessaire, puis enregistrer le fichier.
REMARQUE : Si cette option n'est pas s&eacute;lectionn&eacute;e, RoboHelp enregistre chaque fichier modifi&eacute; apr&egrave;s le
remplacement de toutes les instances.
8)
Pour rechercher des cha&icirc;nes sans les remplacer, cliquez sur les boutons Tout rechercher ou
Rechercher suivant.
Rechercher suivant
Recherche de mani&egrave;re it&eacute;rative dans les fichiers. Si votre recherche renvoie des occurrences dans
plusieurs fichiers, alors le premier fichier s'ouvre avec la premi&egrave;re occurrence du r&eacute;sultat
s&eacute;lectionn&eacute;e. Si vous utilisez Rechercher suivant, RoboHelp commence par parcourir les
occurrences dans le fichier actuel. Une fois toutes les occurrences du fichier parcourues, RoboHelp
ouvre le fichier suivant. RoboHelp continue ainsi de suite dans tous les fichiers contenant les
occurrences de la recherche. Vous pouvez sp&eacute;cifier le sens de la recherche (avant ou arri&egrave;re).
Tout rechercher
Affiche toutes les occurrences du texte ou des balises de recherche dans le panneau R&eacute;sultats de la
recherche.
9)
Les r&eacute;sultats de la recherche s'affichent dans la bo&icirc;te de dialogue R&eacute;sultats de la recherche Pour plus
d'informations, voir Affichage des r&eacute;sultats de la recherche.
Pour remplacer les cha&icirc;nes ou balises trouv&eacute;es, cliquez sur les boutons Tout remplacer ou
Remplacer.
Utilisation des expressions r&eacute;guli&egrave;res de style Microsoft
RoboHelp prend en charge diff&eacute;rentes expressions r&eacute;guli&egrave;res de style Microsoft :
183
CHAPITRE 4
V&Eacute;RIFICATION D'ORTHOGRAPHE ET FONCTION RECHERCHER/REMPLACER
UTILISATION DES RUBRIQUES
?
v?tre permet de trouver votre et vitre
*
m*e permet de trouver musique et madame
[]
[mg]are permet de trouver mare et gare
[-]
[g-q]lace permet de trouver glace et place
@
bal@ade permet de trouver balade et ballade
Pour plus d'informations, voir Expressions r&eacute;guli&egrave;res de style Microsoft et ces exemples sont disponibles
sur le site de Peter Grainge.
Affichage des r&eacute;sultats de la recherche
L'outil de recherche et de remplacement multifichiers affiche les r&eacute;sultats dans le conteneur R&eacute;sultats de
la recherche.
Pour afficher le conteneur R&eacute;sultats de recherche, effectuez les op&eacute;rations suivantes :
1) S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; R&eacute;sultats de la recherche.
La bo&icirc;te de dialogue R&eacute;sultats de la recherche affiche les fichiers dans lesquels le texte de recherche
s'affiche. Les num&eacute;ros de la ligne et de la colonne permettent de localiser le texte recherch&eacute; ou
remplac&eacute; dans une rubrique.
Utilisez les options suivantes pour parcourir et remplacer rapidement :
Zone de recherche
Vous permet de sp&eacute;cifier un crit&egrave;re de recherche des r&eacute;sultats. La fonctionnalit&eacute; de recherche vous
permet de rechercher par n'importe quel champ dans la liste de r&eacute;sultats. Vous pouvez ainsi
rechercher par nom de fichier, num&eacute;ro de ligne ou chemin de fichier.
Afficher
Affiche le contenu du fichier s&eacute;lectionn&eacute; dans le navigateur.
Modifier
Ouvre le fichier s&eacute;lectionn&eacute; dans l'&eacute;diteur Rechercher et remplacer. Si aucun r&eacute;sultat n'est
s&eacute;lectionn&eacute;, la premi&egrave;re correspondance sera mise en surbrillance. Dans le cas contraire, le r&eacute;sultat
s&eacute;lectionn&eacute; est mis en surbrillance.
Annuler
Annule la recherche.
184
CONFORMIT&Eacute; W3C
UTILISATION DES RUBRIQUES
CHAPITRE 4
Activer/d&eacute;sactiver le d&eacute;filement
Permet d'alterner entre le d&eacute;filement automatique pour afficher la derni&egrave;re correspondance et
l'arr&ecirc;t sur la derni&egrave;re correspondance affich&eacute;e.
Tout remplacer
Remplace toutes les occurrences de la correspondance.
4.8.
Conformit&eacute; W3C
Vous pouvez valider des rubriques XHTML ou HTML pour la conformit&eacute; W (World Wide Web Consortium)
et afficher les messages d'erreur, les messages d'informations ou les avertissements. Vous pouvez valider
les &eacute;l&eacute;ments suivants pour la conformit&eacute; W3C :
Rubriques
Cliquez avec le bouton droit de la souris sur une rubrique du conteneur Gestionnaire de projets, puis
s&eacute;lectionnez Valider la conformit&eacute; W3C.
Projet (Project)
Cliquez avec le bouton droit de la souris sur Fichiers de projet au niveau du conteneur Gestionnaire
de projets, puis s&eacute;lectionnez Valider la conformit&eacute; W3C.
RoboHelp valide toutes les rubriques HTML/XHTML et affiche les avertissements ou messages d'erreur
relatifs &agrave; un probl&egrave;me de non-conformit&eacute; dans le conteneur Vue de sortie ou Liste des erreurs. RoboHelp
affiche les erreurs, avertissements et informations dans diff&eacute;rentes situations :
•
Des erreurs s'affichent si vous avez ajout&eacute; une balise incorrecte ou si vous n'avez pas ferm&eacute; une
balise.
•
Des avertissements s'affichent si une balise n'est pas valide pour le format XHTML.
•
Des informations apparaissent lorsque toutes les rubriques sont valid&eacute;es.
REMARQUE :
Vous pouvez cliquer deux fois sur un message d'erreur ou un avertissement de la liste des
erreurs pour l'ouvrir. Lorsque vous placez le curseur sur une erreur se trouvant dans le conteneur Liste des
erreurs, la ligne de rubrique contenant l'erreur s'affiche.
4.9.
R&eacute;f&eacute;rences
Volet g&eacute;n&eacute;ral pour les projets Oracle
Le volet G&eacute;n&eacute;ral s'applique aux bo&icirc;tes de dialogue Propri&eacute;t&eacute;s de rubrique et Nouvelle rubrique des
projets Oracle Help.
Utilisez le volet G&eacute;n&eacute;ralit&eacute;s pour cr&eacute;er des titres de rubrique et des noms de fichier.
185
CHAPITRE 4
R&Eacute;F&Eacute;RENCES
UTILISATION DES RUBRIQUES
Titre de la rubrique
Titre tel qu'il appara&icirc;t dans l'afficheur ou dans le gestionnaire de projets (lorsque les rubriques sont
affich&eacute;es par titre).
Nom du fichier
Nom du fichier de rubrique (par d&eacute;faut, titre de rubrique). Ce nom s'affiche lorsque les rubriques
sont pr&eacute;sent&eacute;es par noms de fichier dans le gestionnaire de projets.
ASTUCE : Vous pouvez automatiquement enregistrer les noms de fichier avec des tirets de soulignement,
ce qui vous permet de synchroniser les pages et les livres de table des mati&egrave;res de l'onglet Table des
mati&egrave;res avec le contenu du volet d'affichage.
Mod&egrave;le
Permet de s&eacute;lectionner un mod&egrave;le pour la rubrique. S&eacute;lectionnez Aucun pour utiliser le formatage
de la feuille de style par d&eacute;faut. Pour voir le mod&egrave;le affich&eacute;, cliquez sur le bouton Afficher.
Editeur (pour Propri&eacute;t&eacute;s de rubrique)
Affiche l'&eacute;diteur HTML du projet. Modifiez ce param&egrave;tre pour utiliser un &eacute;diteur autre que l'&eacute;diteur
de conception de RoboHelp.
REMARQUE : Oracle Help utilise les ID de rubrique (dans un fichier de mappage) pour effectuer des appels
d'aide contextuelle. Pour modifier l'ID, modifiez la balise META de la rubrique.
LIENS CONNEXES :
Ajout de tirets de soulignement aux noms de fichier
186
EDITEURS ROBOHELP
MODIFICATION ET FORMATAGE
CHAPITRE 5
5.
Modification et formatage
5.1.
Editeurs RoboHelp
Par d&eacute;faut, RoboHelp fournit deux &eacute;diteurs : l'&eacute;diteur de conception et l'&eacute;diteur HTML. Vous pouvez
&eacute;galement utiliser des &eacute;diteurs tiers pour modifier leurs documents respectifs. Vous pouvez par exemple
utiliser Microsoft Word pour modifier un document Word li&eacute; &agrave; un projet.
Editeur de conception RoboHelp
Lorsque vous s&eacute;lectionnez un fichier de rubrique dans le conteneur Gestionnaire de projets, la rubrique
s'ouvre dans l'Editeur de conception. L'&eacute;diteur de conception RoboHelp permet d'effectuer des t&acirc;ches de
traitement de texte et d'ins&eacute;rer des &eacute;l&eacute;ments en ligne (par exemple des liens, des objets multim&eacute;dia, des
&eacute;l&eacute;ments HTML dynamiques et des boutons Voir aussi/Rubriques connexes). Vous pouvez &eacute;galement
ajouter des mots-cl&eacute;s d'index aux rubriques, appliquer du texte conditionnel, parcourir des s&eacute;quences,
mapper des ID et modifier les pages principales.
Vous pouvez modifier n'importe quel fichier XHTML ou HTML standard dans l'Editeur de conception.
(Vous pouvez importer des fichiers HTML autonomes dans un projet et les modifier.)
REMARQUE : Pour basculer vers l'Editeur HTML depuis l'Editeur de conception, cliquez sur l'onglet HTML.
Editeur RoboHelp HTML
Vous pouvez concevoir des rubriques dans RoboHelp en &eacute;crivant le code XHTML correspondant dans
l'&eacute;diteur RoboHelp HTML. l'&eacute;diteur RoboHelp HTML permet de traiter le texte, les balises XHTML et les
balises HTML comme un &eacute;diteur de texte classique.
Ouverture de l'&eacute;diteur RoboHelp HTML
1)
2)
Dans le gestionnaire de projets, s&eacute;lectionnez un fichier de rubrique. La rubrique s'ouvre dans
l'Editeur de conception.
Cliquez sur l'onglet HTML situ&eacute; pour afficher le code HTML de la rubrique.
Annulation d'une modification
1)
Cliquez sur le bouton Annuler la derni&egrave;re action.
REMARQUE : Si vous basculez entre des vues apr&egrave;s avoir effectu&eacute; une modification, vous ne pouvez pas
annuler cette modification.
Affichage des num&eacute;ros de ligne
1)
Cliquez avec le bouton droit de la souris sur le corps de la rubrique et s&eacute;lectionnez Num&eacute;ros de
ligne.
Toutes les lignes de code sont num&eacute;rot&eacute;es dans l'&eacute;diteur HTML.
187
CHAPITRE 5
EDITEURS ROBOHELP
MODIFICATION ET FORMATAGE
Ajout d'extensions de mots-cl&eacute;s
Les extensions de mots-cl&eacute;s permettent l'affichage des mots-cl&eacute;s correspondant au texte saisi dans
l'&eacute;diteur. La correspondance la plus proche s'affiche en surbrillance. Cliquez sur une entr&eacute;e de la liste
pour l'ins&eacute;rer.
Supposons par exemple que vous ajoutez &laquo; RoboHelp &raquo; comme extension. Lorsque vous saisissez un R, la
liste des mots-cl&eacute;s commen&ccedil;ant par un R appara&icirc;t. Lorsque vous tapez la lettre suivante, &laquo; o &raquo;, le mot-cl&eacute;
&laquo; RoboHelp &raquo; est mis en surbrillance. Cliquez dessus pour l'ins&eacute;rer dans l'&eacute;diteur HTML. Le texte attribu&eacute;
&agrave; ce mot-cl&eacute; (par exemple Adobe RoboHelp) s'affiche dans l'&eacute;diteur HTML.
REMARQUE : Si aucun mot-cl&eacute; ne correspond aux caract&egrave;res que vous avez saisis, la fen&ecirc;tre contextuelle
dispara&icirc;t.
Vous pouvez ajouter des extensions de mots-cl&eacute;s dans l'&eacute;diteur HTML.
1) Dans l'&eacute;diteur HTML, cliquez avec le bouton droit de la souris et s&eacute;lectionnez Modifier les
extensions.
2) Cliquez sur Nouveau.
3) (Facultatif) Saisissez un nouveau mot-cl&eacute; dans la zone mot-cl&eacute;.
4) Saisissez la l&eacute;gende correspondant au mot-cl&eacute; dans la zone L&eacute;gende.
5) Dans la zone Texte &agrave; ins&eacute;rer, saisissez du texte. Ce texte s'affiche lorsque vous s&eacute;lectionnez un
mot-cl&eacute; dans la liste de l'&eacute;diteur HTML.
6) Cliquez sur OK.
Modification de la couleur du code
l'&eacute;diteur RoboHelp HTML permet de modifier la couleur du code. Cependant, le texte du contenu est
toujours noir.
1) Dans la vue HTML, cliquez avec le bouton droit de la souris et s&eacute;lectionnez Couleurs.
2) Dans la bo&icirc;te de dialogue Tableau de couleurs, s&eacute;lectionnez un &eacute;l&eacute;ment et sp&eacute;cifiez une couleur
pour le texte, la surbrillance ou les deux.
3) Cliquez sur OK.
LIENS CONNEXES :
Modification des couleurs
188
CHAPITRE 5
EDITEURS ROBOHELP
MODIFICATION ET FORMATAGE
Editeurs HTML tiers
Utilisation de RoboHelp avec d'autres &eacute;diteurs HTML
Si vous utilisez RoboHelp avec un &eacute;diteur HTML tiers, gardez les d&eacute;tails suivants &agrave; l'esprit :
•
Vous pouvez modifier des fichiers HTML dans un autre &eacute;diteur tout en laissant RoboHelp ouvert.
Lorsque vous ouvrez une rubrique dans un &eacute;diteur HTML tiers, la fonctionnalit&eacute; RoboHelp n'est pas
disponible. Il est possible d'ins&eacute;rer du code et des &eacute;l&eacute;ments HTML, mais vous ne pouvez pas ins&eacute;rer
ou modifier des fonctionnalit&eacute;s RoboHelp telles que les fen&ecirc;tres contextuelles purement textuelles
et les contr&ocirc;les Lien.
•
Fermez les fichiers dans l'&eacute;diteur tiers avant de les ouvrir dans RoboHelp.
•
Si vous ins&eacute;rez une image via un &eacute;diteur tiers, ajoutez-la dans le dossier Fichiers bagage du projet.
La m&ecirc;me chose s'applique aux effets sp&eacute;ciaux JavaScript avec des images, notamment les fichiers
.js d'accompagnement.
Ajout d'un &eacute;diteur HTML
Pour g&eacute;n&eacute;rer une liste des &eacute;diteurs HTML d&eacute;tect&eacute;s, s&eacute;lectionnez Fichiers &gt; Options &gt; Associations.
1) S&eacute;lectionnez Fichier &gt; Options.
2) Cliquez sur l'onglet Associations. Cliquez sur Ajouter dans la zone Editeurs HTML.
3) Faites l'une des actions qui suivent : saisissez le nom de l'&eacute;diteur HTML. Appuyez sur Entr&eacute;e.
–
S&eacute;lectionnez un &eacute;diteur dans le dossier Programmes recommand&eacute;s ou Autres programmes.
Les champs Nom et Emplacement affichent les informations concernant le programme
s&eacute;lectionn&eacute;.
–
Cliquez sur le bouton Parcourir . S&eacute;lectionnez le fichier EXE pour l'&eacute;diteur HTML et cliquez
sur Ouvrir. Saisissez un nom pour l'&eacute;diteur.
REMARQUE : Si vous installez un nouvel &eacute;diteur HTML, vous ne pourrez l'ajouter qu'une fois RoboHelp
red&eacute;marr&eacute;.
Suppression d'un &eacute;diteur HTML ou modification de son nom
1)
2)
3)
S&eacute;lectionnez Fichier &gt; Options.
Cliquez sur l'onglet Associations.
S&eacute;lectionnez un &eacute;diteur. Cliquez sur le bouton Modifier.
–
Pour renommer l'&eacute;diteur, cliquez sur Modifier et saisissez un nom dans la zone Nom.
–
Pour supprimer l'&eacute;diteur, cliquez sur Supprimer.
REMARQUE : L'&eacute;diteur de conception, l'&eacute;diteur HTML de RoboHelp et le Bloc-notes Windows ne
peuvent &ecirc;tre modifi&eacute;s ou supprim&eacute;s de la liste.
189
CHAPITRE 5
EDITEURS ROBOHELP
MODIFICATION ET FORMATAGE
S&eacute;lection automatique d'un &eacute;diteur HTML ou d&eacute;finition d'un &eacute;diteur HTML par d&eacute;faut
RoboHelp peut ouvrir automatiquement un &eacute;diteur HTML tiers. RoboHelp d&eacute;termine l'&eacute;diteur &agrave; ouvrir en
fonction du fichier HTML proprement dit. l'option S&eacute;lectionner automatiquement vous permet
&eacute;galement d'associer un &eacute;diteur avec sa balise Meta/Generator, de mani&egrave;re &agrave; ce que les rubriques soient
automatiquement ouvertes dans l'&eacute;diteur qui les a cr&eacute;&eacute;es.
REMARQUE : Pour conna&icirc;tre l'&eacute;diteur associ&eacute; &agrave; une installation de RoboHelp, s&eacute;lectionnez Fichier &gt; Options
et v&eacute;rifiez le param&egrave;tre d'&eacute;diteur par d&eacute;faut, dans l'onglet Associations.
Vous pouvez d&eacute;finir un &eacute;diteur HTML par d&eacute;faut. Il vous permettra de cr&eacute;er des rubriques, m&ecirc;me si la
fonction de s&eacute;lection automatique est activ&eacute;e.
1) S&eacute;lectionnez Fichier &gt; Options.
2) Cliquez sur l'onglet Associations. Vous pouvez effectuer ou combiner les op&eacute;rations suivantes :
–
S&eacute;lectionnez Utiliser l'&eacute;diteur par d&eacute;faut. Cliquez sur D&eacute;finir par d&eacute;faut.
–
S&eacute;lectionnez l'option S&eacute;lectionner automatiquement l'&eacute;diteur.
3)
Pour modifier les associations existant entre l'&eacute;diteur et une balise, choisissez l'option S&eacute;lectionner
automatiquement. Vous pouvez modifier l'&eacute;diteur HTML, mais pas la balise Generator. Qui plus est,
vous ne pouvez pas supprimer les balises. S&eacute;lectionnez une ou plusieurs des balises Generator
suivantes :
&lt;Non&gt;
L'&eacute;diteur associ&eacute; &agrave; cette balise s'utilise avec des fichiers sans balise Meta/Generator.
&lt;Inconnu&gt;
L'&eacute;diteur associ&eacute; &agrave; cette balise s'utilise avec des fichiers contenant des balises Meta/Generator qui
ne sont pas dans la liste des &eacute;diteurs HTML des associations.
&lt;Robohelp&gt;
L'&eacute;diteur associ&eacute; &agrave; cette balise s'utilise avec des fichiers cr&eacute;&eacute;s avec toutes les versions de RoboHelp.
Pour modifier les associations existant entre l'&eacute;diteur et une balise, utilisez les options suivantes :
Ajouter
Associe un &eacute;diteur &agrave; une balise Meta/Generator.
Supprimer
Supprime une association entre un &eacute;diteur et une balise Meta/Generator.
D&eacute;finir l'&eacute;diteur
Affiche les &eacute;diteurs dans l'onglet Associations. Permet de modifier les associations entre les
&eacute;diteurs et les balises Meta/Generator.
190
FORMATAGE DE CARACT&Egrave;RES ET POLICES
MODIFICATION ET FORMATAGE
CHAPITRE 5
D&eacute;finir la balise
Modifiez les associations entre les &eacute;diteurs et les balises Meta/Generator en saisissant une balise
Meta/Generator dans le champ ou en localisant l'emplacement d'un fichier HTML contenant la
balise Meta/Generator.
4)
Lorsque vous avez termin&eacute;, cliquez sur OK.
Remarques :
•
•
Vous pouvez &eacute;galement utiliser des &eacute;diteurs HTML tiers diff&eacute;rents d'une rubrique &agrave; l'autre, m&ecirc;me
si vous avez d&eacute;fini un &eacute;diteur par d&eacute;faut. Cliquez avec le bouton droit de la souris sur la rubrique
dans le conteneur Gestionnaire de projets ou Liste des rubriques et s&eacute;lectionnez l'option Modifier
avec.
Tous les &eacute;diteurs doivent &ecirc;tre associ&eacute;s &agrave; une balise Meta/Generator.
Sp&eacute;cification d'un &eacute;diteur &agrave; associer aux nouvelles rubriques
Pr&eacute;cisez l'&eacute;diteur par d&eacute;faut des nouvelles rubriques.
1) Dans le conteneur Gestionnaire de projets, cliquez avec le bouton droit de la souris sur une
rubrique. S&eacute;lectionnez Nouveau &gt; Rubrique avec.
2) S&eacute;lectionnez un &eacute;diteur. Cliquez sur OK. Cliquez sur l'onglet G&eacute;n&eacute;ralit&eacute;s et d&eacute;finissez les options.
3) S&eacute;lectionnez Fichier &gt; Options. Cliquez sur l'onglet Associations. S&eacute;lectionnez Utiliser l'&eacute;diteur par
d&eacute;faut.
5.2.
Formatage de caract&egrave;res et polices
Si vous formatez des caract&egrave;res en utilisant la barre d'outils Modifier ou l'option Modifier &gt; Formatage
de caract&egrave;res &gt; Police, vous cr&eacute;ez des styles en ligne. Les styles en ligne remplacent les feuilles de style.
Pour un usage r&eacute;p&eacute;t&eacute;, cr&eacute;ez ou modifiez un style de caract&egrave;re dans une feuille de style.
Application ou suppression d'un formatage de caract&egrave;res
1)
S&eacute;lectionnez le texte &agrave; formater. Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Sur la barre d'outils, cliquez sur l'outil associ&eacute; &agrave; l'option de formatage.
–
Choisissez Modifier &gt; Caract&egrave;re &gt; Formatage de caract&egrave;res &gt; Police.
191
CHAPITRE 5
FORMATAGE DE CARACT&Egrave;RES ET POLICES
MODIFICATION ET FORMATAGE
Application d'une couleur au texte
1)
2)
3)
S&eacute;lectionnez du texte.
Dans la barre d'outils Modifier, cliquez sur la fl&egrave;che sur le bouton Modifier la couleur de la police
Cliquez sur une nuance de couleur ou cliquez sur Autres couleurs pour s&eacute;lectionner d'autres
nuances ou pour appliquer une couleur personnalis&eacute;e.
.
LIENS CONNEXES :
Cr&eacute;ation de styles pour des feuilles de style
D&eacute;finition des options de police avanc&eacute;es
1)
2)
S&eacute;lectionnez Modifier &gt; Caract&egrave;re &gt; Formatage de caract&egrave;res &gt; Police.
Cliquez sur Avanc&eacute;.
Pour les polices, vous pouvez d&eacute;finir les options avanc&eacute;es suivantes :
Style
Sp&eacute;cifie l'affichage de la police (normal, italique ou oblique).
Grammage
D&eacute;finit la graisse de la police (texte plus fin ou plus &eacute;pais). Les valeurs plus fin et plus gras d&eacute;pendent
de la graisse de la police h&eacute;rit&eacute;e. Les autres sont des valeurs absolues. Certaines polices ne
disposent pas de toutes les valeurs de graisse.
Texte surlign&eacute;
Ins&egrave;re une ligne au-dessus du texte s&eacute;lectionn&eacute;.
Aper&ccedil;u
Affiche le texte dans l'&eacute;diteur de conception selon les options de police s&eacute;lectionn&eacute;es. Cette
repr&eacute;sentation est mise &agrave; jour &agrave; mesure que vous modifiez les param&egrave;tres dans l'onglet.
Modification de l'espacement entre les caract&egrave;res
1)
2)
3)
S&eacute;lectionnez Modifier &gt; Caract&egrave;re &gt; Formatage de caract&egrave;res &gt; Police.
Cliquez sur l'onglet Espacement.
S&eacute;lectionnez Normal, D&eacute;velopper ou Compresser. D&eacute;finissez les options suivantes :
Par
(Pour D&eacute;velopper ou Compresser) Indiquez la valeur d'intervalle entre les caract&egrave;res.
192
CHAPITRE 5
FORMATAGE DE CARACT&Egrave;RES ET POLICES
MODIFICATION ET FORMATAGE
Position
Emplacement du texte.
4)
Cliquez sur OK.
Modification des tailles de police
1)
2)
S&eacute;lectionnez le texte.
Sur la barre d'outils, s&eacute;lectionnez une taille de police.
ASTUCE : Vous pouvez &eacute;galement modifier la taille des polices des volets de navigation &agrave; l'aide de l'&eacute;diteur
d'habillage WebHelp.
Cr&eacute;ation d'un jeu de polices
Un jeu de polices constitue un ensemble de polices appliqu&eacute;es par l'interm&eacute;diaire d'une feuille de style
ou du formatage de caract&egrave;res ou de paragraphes. Par exemple, vous pouvez cr&eacute;er un jeu de polices dont
la premi&egrave;re police est Verdana, la deuxi&egrave;me Arial&reg; et la troisi&egrave;me Sans Serif. Si la police Verdana n'est pas
install&eacute;e sur l'ordinateur d'un utilisateur, l'afficheur utilise Arial, puis Sans Serif.
1) S&eacute;lectionnez Modifier &gt; Caract&egrave;re &gt; Formatage de caract&egrave;res &gt; Jeux de polices.
2) Cliquez sur Nouveau, saisissez un nom, puis cliquez sur Modifier. S&eacute;lectionnez la premi&egrave;re police,
puis cliquez sur Ajouter.
REMARQUE : Les jeux de polices sont enregistr&eacute;s avec les projets.
Application d'un jeu de polices &agrave; un texte
1)
2)
Ouvrez une rubrique dans l'onglet Conception. S&eacute;lectionnez le texte &agrave; formater.
S&eacute;lectionnez une police.
Modification de jeux de polices
1)
2)
3)
4)
5)
S&eacute;lectionnez Modifier &gt; Caract&egrave;re &gt; Formatage de caract&egrave;res &gt; Jeux de polices.
S&eacute;lectionnez une police.
Cliquez sur Modifier.
Ajoutez des polices de la liste Caract&egrave;res disponibles ou supprimez-les de la liste S&eacute;lections de jeu
de polices.
Cliquez sur OK.
193
MISE EN FORME DES PARAGRAPHES
MODIFICATION ET FORMATAGE
CHAPITRE 5
Suppression de jeux de polices
REMARQUE : Avant de supprimer un jeu de polices, reformatez le texte associ&eacute; &agrave; ce jeu. Dans le cas
contraire, le jeu de polices supprim&eacute; est recr&eacute;&eacute;.
1) S&eacute;lectionnez Modifier &gt; Caract&egrave;re &gt; Formatage de caract&egrave;res &gt; Jeux de polices.
2) S&eacute;lectionnez la police &agrave; supprimer.
3) Cliquez sur Supprimer.
Insertion de symboles et de caract&egrave;res sp&eacute;ciaux
1)
2)
3)
Ouvrez une rubrique dans l'&eacute;diteur de conception. S&eacute;lectionnez l'emplacement du caract&egrave;re.
S&eacute;lectionnez Ins&eacute;rer &gt; Multim&eacute;dia &gt; Symbole.
Cliquez deux fois sur le symbole.
Insertion d'un espace ins&eacute;cable
1)
Placez le point d'insertion &agrave; l'endroit o&ugrave; vous voulez ins&eacute;rer l'espace ins&eacute;cable. Appuyez sur
Ctrl+Alt+Espace.
5.3.
Mise en forme des paragraphes
Si vous formatez un paragraphe en utilisant la barre d'outils Modifier ou l'option Modifier &gt; Paragraphe &gt;
Formatage de paragraphe &gt; Paragraphe, vous cr&eacute;ez des styles en ligne. Les styles en ligne remplacent les
feuilles de style. Pour un usage r&eacute;p&eacute;t&eacute;, cr&eacute;ez ou modifiez un style de paragraphe dans une feuille de style.
Alignement des paragraphes
1)
2)
Ouvrez une rubrique dans l'onglet Conception. S&eacute;lectionnez le paragraphe &agrave; aligner.
Sur la barre d'outils, cliquez sur un bouton d'alignement.
194
MISE EN FORME DES PARAGRAPHES
MODIFICATION ET FORMATAGE
CHAPITRE 5
Retrait de paragraphes
1)
2)
Cliquez sur le paragraphe.
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Sur la barre d'outils, cliquez sur le bouton Diminuer le retrait ou Augmenter le retrait
dans la barre d'outils.
–
S&eacute;lectionnez Modifier &gt; Paragraphe &gt; Formatage de paragraphe &gt; Paragraphe. D&eacute;finissez les
retraits :
•
Pour un retrait par rapport &agrave; la marge gauche ou droite, cliquez sur la fl&egrave;che vers le haut
ou vers le bas et s&eacute;lectionnez un nombre dans la liste.
•
Pour un retrait par rapport &agrave; la premi&egrave;re ligne, cliquez sur le triangle situ&eacute; sous Sp&eacute;cial
et s&eacute;lectionnez Premi&egrave;re ligne. Sous Par, cliquez sur la fl&egrave;che vers le haut ou vers le bas
et s&eacute;lectionnez un num&eacute;ro dans la liste.
•
Pour un retrait n&eacute;gatif, cliquez sur le triangle situ&eacute; sous Sp&eacute;cial et s&eacute;lectionnez Retrait
n&eacute;gatif. Sous Par, cliquez sur la fl&egrave;che vers le haut ou vers le bas et s&eacute;lectionnez un
num&eacute;ro dans la liste.
Retrait de lignes de texte
1)
2)
3)
S&eacute;lectionnez Modifier &gt; Afficher &gt; Afficher/masquer &gt; R&egrave;gle.
Dans l'&eacute;diteur de conception, placez le curseur au point d'insertion du retrait ou s&eacute;lectionnez le
texte &agrave; mettre en retrait.
Sur la r&egrave;gle, effectuez l'une des op&eacute;rations suivantes :
–
Pour cr&eacute;er un retrait n&eacute;gatif, faites glisser le marqueur inf&eacute;rieur jusqu'au point d&eacute;finissant le
d&eacute;but du retrait.
Position du marqueur pour un retrait n&eacute;gatif
–
Pour cr&eacute;er un retrait de premi&egrave;re ligne, faites glisser le marqueur sup&eacute;rieur jusqu'au point
d&eacute;finissant le d&eacute;but du texte.
Position du marqueur pour un retrait de premi&egrave;re ligne
195
CHAPITRE 5
MISE EN FORME DES PARAGRAPHES
MODIFICATION ET FORMATAGE
Modification de marges
Appliquez la proc&eacute;dure suivante pour modifier une seule rubrique. Dans le cas contraire, utilisez une
feuille de style.
1) S&eacute;lectionnez Modifier &gt; Afficher &gt; Afficher/masquer &gt; R&egrave;gle.
2) Dans l'&eacute;diteur de conception, placez le curseur sur la marge de votre choix ou s&eacute;lectionnez le texte
&agrave; modifier.
3) Sur la r&egrave;gle, faites glisser les marqueurs de marge.
Conseils
•
•
•
•
Dans les tableaux, appliquez des param&egrave;tres de marge diff&eacute;rents &agrave; chaque cellule en d&eacute;pla&ccedil;ant le
curseur dans le tableau.
Pour sp&eacute;cifier des marges pr&eacute;cises, s&eacute;lectionnez Modifier &gt; Paragraphe &gt; Formatage de
paragraphe &gt; Paragraphe.
Pour sp&eacute;cifier un param&egrave;tre de marge qui s'applique &agrave; un style, modifiez votre feuille de style.
Cliquez avec le bouton droit de la souris sur la r&egrave;gle pour acc&eacute;der &agrave; l'option Aligner sur les
graduations. S&eacute;lectionnez cette option et faites glisser les marqueurs sur la r&egrave;gle, de graduation en
graduation. Pour d&eacute;placer les marqueurs plus pr&eacute;cis&eacute;ment, d&eacute;sactivez l'option Aligner sur les
graduations.
LIENS CONNEXES :
Cr&eacute;ation de styles pour des feuilles de style
Modification de l'unit&eacute; de mesure de la r&egrave;gle
1)
2)
3)
S&eacute;lectionnez Modifier &gt; Afficher &gt; Afficher/masquer &gt; R&egrave;gle.
Cliquez avec le bouton droit de la souris sur la r&egrave;gle.
S&eacute;lectionnez une unit&eacute; de mesure.
D&eacute;finition d'une langue pour un paragraphe
S&eacute;lectionnez une langue pour le paragraphe. Si aucune langue n'est s&eacute;lectionn&eacute;e, la langue du projet
s'applique au paragraphe.
1) Cliquez avec le bouton droit de la souris et s&eacute;lectionnez Paragraphe. S&eacute;lectionnez une langue dans
le menu d&eacute;roulant Langue.
LIENS CONNEXES :
Prise en charge de plusieurs langues
196
CHAPITRE 5
MISE EN FORME DES PARAGRAPHES
MODIFICATION ET FORMATAGE
Application d'un habillage de texte
1)
2)
3)
Dans l'&eacute;diteur de conception, cliquez deux fois sur un objet.
Sous Habillage de texte, s&eacute;lectionnez une option.
REMARQUE : Pour l'utilisation de l'option Autour (pour les tableaux), le tableau doit &ecirc;tre align&eacute; &agrave;
gauche ou &agrave; droite.
(Facultatif) Pour d&eacute;finir l'espacement entre l'objet et le texte qui l'entoure, cliquez sur Marges.
–
Saisissez les valeurs d'intervalle entre l'objet s&eacute;lectionn&eacute; et le texte qui l'entoure.
–
D&eacute;finissez l'espacement entre le texte et l'objet ou saisissez une valeur en centim&egrave;tres. En
fonction des param&egrave;tres que vous avez appliqu&eacute;s &agrave; l'habillage de texte, vous pouvez d&eacute;finir
un espacement pour Tous les c&ocirc;t&eacute;s ou Droite/Gauche et Haut/Bas.
4)
Cliquez sur OK.
Remarques
•
•
Les tableaux doivent &ecirc;tre align&eacute;s &agrave; gauche ou &agrave; droite pour permettre l'utilisation de l'habillage de
texte et leur taille doit &ecirc;tre inf&eacute;rieure &agrave; 100 %.
Si un habillage de texte est appliqu&eacute; &agrave; l'image, celle-ci ne peut pas &ecirc;tre align&eacute;e.
R&eacute;glage de l'espacement des lignes
1)
2)
S&eacute;lectionnez Modifier &gt; Paragraphe &gt; Formatage de paragraphe &gt; Paragraphe.
D&eacute;finissez les options d'espacement :
Avant
Valeur d'intervalle avant chaque paragraphe.
Apr&egrave;s
Valeur d'intervalle apr&egrave;s chaque paragraphe.
A
(Pour Multiple et Exactement) Espacement (en points) entre les lignes s&eacute;lectionn&eacute;es.
3)
Cliquez sur OK.
Ajout de sauts de ligne dans les paragraphes
Un saut de ligne manuel termine la ligne actuelle et aligne le texte sur la ligne suivante.
1) Ouvrez la rubrique dans l'&eacute;diteur de conception. Cliquez &agrave; l'endroit o&ugrave; vous souhaitez ins&eacute;rer le saut
de ligne.
2) S&eacute;lectionnez Ins&eacute;rer &gt; Conception de page &gt; Saut de ligne. Vous pouvez &eacute;galement appuyer sur
Maj + Entr&eacute;e.
197
BORDURES, ARRI&Egrave;RE-PLANS, COULEUR ET SONS
MODIFICATION ET FORMATAGE
CHAPITRE 5
5.4.
Bordures, arri&egrave;re-plans, couleur et sons
l'application de formatages sans utilisation de styles cr&eacute;e des styles en ligne. Les styles en ligne
remplacent les feuilles de style.
Ajout ou modification de bordures et d'arri&egrave;re-plans de rubriques
1)
2)
3)
4)
5)
Ouvrez une rubrique. S&eacute;lectionnez la rubrique ou des &eacute;l&eacute;ments de la rubrique, par exemple des
paragraphes ou des cellules du tableau.
S&eacute;lectionnez Modifier &gt; Paragraphe &gt; Formatage de paragraphe &gt; Bordures et trame.
Cliquez sur l'onglet Bordures et trame.
Sp&eacute;cifiez les options de bordure et de trame. Cliquez sur OK.
Cliquez sur le bouton Enregistrer tout .
LIENS CONNEXES :
Ajout ou modification des bordures ou des arri&egrave;re-plans dans les feuilles de style
Ajout de bordures &agrave; des images
1)
2)
3)
4)
Dans l'&eacute;diteur de conception, cliquez deux fois sur l'image.
Cliquez sur l'onglet Image. Cliquez sur Bordures.
D&eacute;finissez les options des bordures.
Cliquez sur OK.
LIENS CONNEXES :
Ajout ou modification des bordures ou des arri&egrave;re-plans dans les feuilles de style
Suppression de bordures ou d'arri&egrave;re-plans
1)
2)
3)
Ouvrez une rubrique.
S&eacute;lectionnez l'&eacute;l&eacute;ment comportant la bordure ou la trame.
Vous pouvez effectuer ou combiner les op&eacute;rations suivantes :
–
Sur la barre d'outils, cliquez sur le bouton Type de bordure et choisissez l'option sans
bordure.
–
Sur la barre d'outils, cliquez sur le bouton Couleur de remplissage et choisissez Aucun.
–
S&eacute;lectionnez Modifier &gt; Paragraphe &gt; Formatage de paragraphe &gt; Bordures et trame. Cliquez
sur l'onglet Bordures et trame. D&eacute;finissez la bordure sur Aucun ou la couleur de remplissage
sur Transparent. Pour supprimer une image d'arri&egrave;re-plan, supprimez le nom de l'image du
champ Image de la zone Motif.
198
BORDURES, ARRI&Egrave;RE-PLANS, COULEUR ET SONS
MODIFICATION ET FORMATAGE
CHAPITRE 5
Ajout ou suppression de lignes horizontales
Ajout d'une ligne horizontale
Vous pouvez ins&eacute;rer un fichier GIF contenant une image de lignes horizontales ou suivre les proc&eacute;dures
ci-dessous pour ajouter et modifier des lignes.
1) Ouvrez la rubrique dans l'&eacute;diteur de conception et cliquez sur l'emplacement o&ugrave; vous souhaitez
ajouter la ligne.
2) S&eacute;lectionnez Ins&eacute;rer &gt; HTML &gt; Zone de texte &gt; Ligne horizontale.
3) S&eacute;lectionnez les options de ligne.
–
Pour modifier la longueur de la ligne, saisissez une valeur dans Largeur.
–
Pour modifier l'&eacute;paisseur de la ligne, saisissez une valeur dans Hauteur. Plus la valeur est
faible, plus la ligne est &eacute;troite.
–
Pour sp&eacute;cifier l'alignement, s&eacute;lectionnez une position de ligne.
–
Pour modifier la couleur de la ligne, cliquez sur Personnalis&eacute; et s&eacute;lectionnez une couleur.
–
Pour ajouter des marges, cliquez sur l'option Marges et choisissez les options correspondantes.
–
Pour ajouter une bordure, cliquez sur Bordure et s&eacute;lectionnez les options souhait&eacute;es.
Suppression d'une ligne horizontale
S&eacute;lectionnez la ligne et cliquez sur le bouton Supprimer
.
Modification des couleurs
1)
2)
3)
S&eacute;lectionnez Modifier &gt; Caract&egrave;re &gt; Formatage de caract&egrave;res &gt; Couleurs.
Cliquez sur Nouveau. Attribuez un nom &agrave; la couleur.
Cliquez sur Modifier. Vous pouvez effectuer ou combiner les op&eacute;rations suivantes :
–
Cliquez sur une nuance de couleur de base.
–
Cliquez sur la bo&icirc;te de dialogue du spectre de couleurs et sur la barre de couleurs verticale
pour ajuster la quantit&eacute; de noir et de blanc pr&eacute;sente dans la couleur.
–
Dans les champs Teinte, Saturation et Luminosit&eacute;, Sp&eacute;cifiez des valeurs comprises entre 0 et 255.
–
Dans les champs Rouge, Vert et Bleu, sp&eacute;cifiez des valeurs comprises entre 0 et 255.
–
Faites glisser le curseur pour r&eacute;gler la luminosit&eacute;.
–
S&eacute;lectionnez l'option Aligner sur la grille pour remplacer la couleur s&eacute;lectionn&eacute;e par la couleur
adapt&eacute;e au Web la plus proche.
Suppression de couleurs
REMARQUE : Avant de supprimer une couleur, formatez le texte auquel elle est appliqu&eacute;e.
1)
2)
3)
S&eacute;lectionnez Modifier &gt; Caract&egrave;re &gt; Formatage de caract&egrave;res &gt; Couleurs.
S&eacute;lectionnez la couleur &agrave; supprimer.
Cliquez sur Supprimer.
199
TABLEAUX
MODIFICATION ET FORMATAGE
CHAPITRE 5
Ajout de son aux rubriques
1)
2)
3)
4)
S&eacute;lectionnez une ou plusieurs rubriques dans le conteneur Liste des rubriques.
Cliquez sur le bouton Propri&eacute;t&eacute;s.
Cliquez sur l'onglet Pr&eacute;sentation.
Saisissez le nom du fichier audio dans la zone Son en arri&egrave;re-plan. Les formats pris en charge sont
les suivants :
.au
Utilis&eacute; sur les syst&egrave;mes UNIX. Pris en charge par Microsoft Windows et HTML Help.
.mid, .rmi
Format Musical Instrument Digital Interface. Norme du son synth&eacute;tique cr&eacute;&eacute; par des instruments
de musique &eacute;lectroniques.
.wav
Format audio natif utilis&eacute; sous Windows.
5)
Saisissez le nombre de r&eacute;p&eacute;titions du fichier audio dans la zone D&eacute;compte de boucles audio.
5.5.
Tableaux
A propos des tableaux
Dans RoboHelp pour HTML, vous pouvez cr&eacute;er des tableaux de mani&egrave;re &agrave; r&eacute;organiser les donn&eacute;es
complexes selon un format simplifi&eacute;. Vous pouvez regrouper diff&eacute;rents &eacute;l&eacute;ments dans un tableau, les
diff&eacute;rencier en utilisant des couleurs diff&eacute;rentes ou cr&eacute;er des mod&egrave;les permettant de faciliter
l'identification des &eacute;l&eacute;ments distincts au sein d'un groupe.
Les styles d'un tableau vous permettent de s&eacute;lectionner diff&eacute;rents formats de tableau. Gr&acirc;ce &agrave; eux, vous
pouvez d&eacute;finir les lignes et colonnes d'en-t&ecirc;te, la premi&egrave;re ou la derni&egrave;re ligne d'un tableau, des groupes
de lignes ou de colonnes &agrave; r&eacute;p&eacute;ter, des marges au sein d'une cellule, etc. l'option Propri&eacute;t&eacute;s du tableau
vous permet de d&eacute;finir les marges d'un tableau, la largeur et la hauteur de certaines cellules ainsi que
diff&eacute;rents styles. Pour afficher diff&eacute;rents types de donn&eacute;es, vous pouvez utiliser les styles de tableau
pr&eacute;d&eacute;finis de RoboHelp pour HTML ou cr&eacute;er vos propres styles. Partons du principe que vous disposez de
tableaux simples indiquant les &eacute;l&eacute;ments constitutifs d'un salaire ou de tableaux plus complexes affichant
le total de ces &eacute;l&eacute;ments, plus les d&eacute;ductions fiscales incluant des investissements li&eacute;s &agrave; l'&eacute;pargne fiscale.
Dans ce cas, il sera possible d'appliquer des styles de tableau g&eacute;n&eacute;raux, qui porteront sur diff&eacute;rentes
rubriques.
Vous avez la possibilit&eacute; d'importer des tableaux &agrave; partir de documents FrameMaker ou Word. Vous
pourrez alors mapper leurs styles de tableau sur ceux de RoboHelp ou conserver les styles d'origine.
200
CHAPITRE 5
TABLEAUX
MODIFICATION ET FORMATAGE
RoboHelp vous permet &eacute;galement d'ajouter du texte, des r&eacute;f&eacute;rences crois&eacute;es, des images et des liens
hypertexte au contenu d'un tableau. Il est &eacute;galement possible d'appliquer des balises de construction
conditionnelles aux lignes et aux colonnes afin de les masquer ou de les afficher dans certains documents
de sortie. Vous pouvez, par exemple, cr&eacute;er un tableau d&eacute;crivant les fonctions de chaque sortie RoboHelp.
Vous pouvez aussi appliquer des balises de construction conditionnelles &agrave; chaque colonne, afin de
r&eacute;pertorier les fonctionnalit&eacute;s d'une sortie sp&eacute;cifique et de ne les afficher que lorsque cette sortie est
g&eacute;n&eacute;r&eacute;e.
Les tableaux prennent en charge les tables des mati&egrave;res de rubriques ainsi que les chemins de navigation,
ce qui leur permet d'afficher les donn&eacute;es d'une mani&egrave;re plus efficace, plus conviviale et mieux organis&eacute;e.
Processus de cr&eacute;ation d'un tableau
1)
2)
3)
Ins&eacute;rez un tableau via la barre d'outils ou le menu Tableau. S&eacute;lectionnez ensuite le nombre de lignes
et de colonnes dans la grille du tableau.
Voir Insertion de tableaux.
Choisissez un style global &agrave; appliquer au tableau. Vous pouvez &eacute;galement cr&eacute;er vos propres styles
de tableau via l'onglet Modifier &gt; Styles.
REMARQUE : Si vous ne s&eacute;lectionnez aucun style, un style par d&eacute;faut sera appliqu&eacute; au tableau.
Voir Styles de tableau.
La bo&icirc;te de dialogue Propri&eacute;t&eacute;s du tableau permet de modifier les propri&eacute;t&eacute;s du tableau. Vous
pouvez d&eacute;finir les marges, aligner les cellules dans le tableau et appliquer des options de bordure
et de trame.
Voir Modification de tableaux.
Insertion de tableaux
Vous pouvez ins&eacute;rer un tableau partout dans une rubrique ou dans une page principale, y compris dans
les en-t&ecirc;tes et les pieds de page. Vous pouvez &eacute;galement ins&eacute;rer un tableau dans un tableau. Vous pouvez
appliquer diff&eacute;rentes propri&eacute;t&eacute;s au tableau ins&eacute;r&eacute; pour afficher des donn&eacute;es complexes.
Insertion d'un tableau de base
1)
2)
3)
4)
Cliquez &agrave; l'endroit o&ugrave; vous souhaitez ins&eacute;rer le tableau.
S&eacute;lectionnez Ins&eacute;rer &gt; Tableau.
Sur la grille de tableau, faites glisser la souris pour d&eacute;terminer le nombre de colonnes et de lignes &agrave;
ajouter.
Cliquez pour ins&eacute;rer le tableau.
Insertion d'un tableau personnalis&eacute;
1)
2)
3)
Cliquez &agrave; l'endroit o&ugrave; vous souhaitez ins&eacute;rer le tableau.
S&eacute;lectionnez Ins&eacute;rer &gt; Tableau.
Sp&eacute;cifiez le nombre de lignes et de colonnes.
201
CHAPITRE 5
4)
5)
TABLEAUX
MODIFICATION ET FORMATAGE
S&eacute;lectionnez un mod&egrave;le de tableau ou choisissez un style personnalis&eacute; dans Styles CSS.
Cliquez sur OK.
ASTUCE : Pour ajouter une ligne &agrave; la fin d'un tableau, cliquez dans la cellule du tableau se trouvant en bas
&agrave; droite. Lorsque le curseur clignote, appuyez sur la fl&egrave;che vers la droite ou vers le bas sur le clavier.
Appuyez sur Entr&eacute;e pour cr&eacute;er une ligne.
Insertion de tableaux dans des tableaux
Lorsque vous ins&eacute;rez un tableau dans un tableau, le deuxi&egrave;me tableau r&eacute;side dans une seule cellule du
premier. Vous pouvez modifier les propri&eacute;t&eacute;s de chaque tableau pour diff&eacute;rencier leur contenu.
Le deuxi&egrave;me tableau s'&eacute;tend sur toute la largeur de la cellule dans laquelle il a &eacute;t&eacute; ins&eacute;r&eacute;. Vous pouvez
modifier ce param&egrave;tre apr&egrave;s l'insertion.
Copie et collage de tableaux
Vous pouvez couper, copier et coller des tableaux.
1) S&eacute;lectionnez le contour en pointill&eacute;s du tableau. Les carr&eacute;s autour du tableau indiquent qu'il est
s&eacute;lectionn&eacute;.
2) Effectuez un clic droit. S&eacute;lectionnez Copier ou Couper pour d&eacute;placer le tableau.
3) Cliquez avec le bouton droit de la souris sur le point de destination. S&eacute;lectionnez Coller.
ASTUCE : Pour ajouter une ligne &agrave; la fin d'un tableau, cliquez dans la cellule du tableau se trouvant en bas
&agrave; droite. Lorsque le curseur clignote, appuyez sur la fl&egrave;che vers la droite ou vers le bas sur le clavier.
Appuyez sur Entr&eacute;e pour cr&eacute;er une ligne.
Modification de tableaux
Pour une d&eacute;monstration sur la modification des tableaux, voir la section relative &agrave; la manipulation des
tableaux dans la vid&eacute;o concernant les M&eacute;thodes faciles de cr&eacute;ation et de gestion de tableaux et de styles
de tableau.
Insertion de lignes et de colonnes dans un tableau
•
•
•
•
Cliquez dans un tableau. S&eacute;lectionnez Formater la ligne ou la colonne.
Pour ins&eacute;rer plusieurs lignes ou colonnes, s&eacute;lectionnez plusieurs cellules du tableau. S&eacute;lectionnez
Format &gt; Ins&eacute;rer &gt; Ligne ou Colonne.
S&eacute;lectionnez les lignes ou les colonnes. Copiez ou coupez la s&eacute;lection et collez-la au nouvel
emplacement.
Vous pouvez supprimer un tableau entier ou seulement certaines parties de tableau. Pour
supprimer un tableau, une ligne, une colonne ou une cellule, s&eacute;lectionnez l'&eacute;l&eacute;ment souhait&eacute; et
cliquez avec le bouton droit de la souris. S&eacute;lectionnez Supprimer [objet].
REMARQUE : Vous pouvez &eacute;galement couper ou copier et coller des lignes, des colonnes et des cellules au
sein d'un m&ecirc;me tableau ou d'un tableau &agrave; l'autre.
202
TABLEAUX
MODIFICATION ET FORMATAGE
CHAPITRE 5
Modification des propri&eacute;t&eacute;s de tableau
1)
2)
3)
Cliquez dans un tableau.
S&eacute;lectionnez Format &gt; Tableau &gt; Propri&eacute;t&eacute;s.
D&eacute;finissez les options.
D&eacute;finition des propri&eacute;t&eacute;s d'ajustement automatique d'un tableau
1)
2)
3)
Cliquez dans un tableau.
S&eacute;lectionnez Format &gt; Taille &gt; Ajuster automatiquement le contenu.
D&eacute;finit la largeur de la colonne en fonction de la largeur du contenu de la colonne.
OR
S&eacute;lectionnez Format &gt; Taille &gt; Ajuster automatiquement la fen&ecirc;tre.
R&egrave;gle la largeur de la colonne sur une taille fixe.
Modification des propri&eacute;t&eacute;s d'une cellule
Pour modifier les propri&eacute;t&eacute;s d'une cellule, vous pouvez placer votre curseur dans le tableau et cliquer sur
Format &gt; Tableau &gt; Propri&eacute;t&eacute;s &gt; l'onglet Cellule.
•
Vous pouvez &eacute;galement d&eacute;finir l'espace s&eacute;parant deux cellules. Si, dans un tableau, l'espacement
entre deux cellules ou la mise en forme des colonnes ou des lignes sont d&eacute;termin&eacute;s via une feuille
de style CSS, cette option n'est pas activ&eacute;e dans l'onglet Propri&eacute;t&eacute;s du tableau &gt; Cellule.
•
S&eacute;lectionnez l'alignement vertical du texte au sein d'une cellule.
REMARQUE :
Les param&egrave;tres d'espacement et d'alignement d&eacute;finis dans l'onglet Cellule s'appliquent &agrave;
toutes les cellules du tableau.
Modification de l'espacement dans les cellules
Vous pouvez d&eacute;finir l'intervalle entre le contenu d'une cellule et ses bords int&eacute;rieurs. D&eacute;finissez des
marges int&eacute;rieures assez larges afin de ne pas trop charger le tableau.
1) S&eacute;lectionnez une ou plusieurs cellules.
2) Cliquez sur Modifier &gt; Paragraphe &gt; Formatage de paragraphe &gt; Bordures et trame.
3) Cliquez sur l'onglet Bordures. Cliquez sur Marge int&eacute;rieure.
4) Saisissez une valeur dans les zones Haut, Bas, Gauche et Droite.
5) Cliquez &agrave; deux reprises sur OK pour appliquer les modifications.
REMARQUE :
L'option Marges permet de d&eacute;finir l'espacement autour du tableau.
203
LISTES
MODIFICATION ET FORMATAGE
CHAPITRE 5
Fusion ou division de cellules de tableau
1)
2)
S&eacute;lectionnez les cellules &agrave; fusionner ou &agrave; diviser.
S&eacute;lectionnez Format &gt; Fusionner &gt; Fusionner ou formater &gt; Diviser les cellules.
ASTUCE : Vous pouvez diviser une cellule en plusieurs lignes et colonnes pour cr&eacute;er un tableau.
LIENS CONNEXES :
Styles de tableau
5.6.
Listes
Application d'un retrait aux listes
1)
S&eacute;lectionnez les &eacute;l&eacute;ments de la liste &agrave; placer en retrait. Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Sur la barre d'outils, cliquez sur Diminuer le retrait ou Augmenter le retrait.
REMARQUE : Vous pouvez &eacute;galement appuyer sur les touches Maj+Tab et Tab pour
respectivement r&eacute;duire et augmenter le retrait.
–
Dans le menu Format, s&eacute;lectionnez Paragraphe. Saisissez un chiffre dans le champ Gauche ou
Droite.
–
(Liste multi-niveau) Sur la r&egrave;gle, faites glisser les marqueurs pour d&eacute;finir l'espacement entre le
chiffre ou la lettre et l'&eacute;l&eacute;ment de la liste.
Application de styles de puce
REMARQUE : Le formatage de listes &agrave; l'aide de la barre d'outils ou du menu Format entra&icirc;ne la cr&eacute;ation de
styles en ligne. Les feuilles de style ne sont pas affect&eacute;es.
Sp&eacute;cification d'un style de puces en ligne
1)
2)
3)
4)
Ouvrez la rubrique dans l'&eacute;diteur de conception.
S&eacute;lectionnez du texte.
Cliquez avec le bouton droit de la souris sur la liste et choisissez Puces et num&eacute;rotation.
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez un style de puces.
–
Pour cr&eacute;er une puce personnalis&eacute;e, cliquez sur Parcourir. S&eacute;lectionnez un fichier GIF. Cliquez
sur OK. Le fichier est ajout&eacute; aux fichiers bagage.
Cr&eacute;ation d'un style de puce pour une feuille de style
1)
2)
3)
4)
Ouvrez la rubrique contenant le style de puce &agrave; personnaliser.
Dans le menu Format, s&eacute;lectionnez Styles.
Dans Liste, s&eacute;lectionnez Tous les styles.
Sous Disponible dans, choisissez une feuille de style externe ou imbriqu&eacute;e.
204
CHAPITRE 5
5)
6)
7)
8)
9)
LISTES
MODIFICATION ET FORMATAGE
Dans la liste Styles, s&eacute;lectionnez un style et cliquez sur le bouton Cr&eacute;er un nouveau style .
Sous Type de style, s&eacute;lectionnez Style de paragraphe.
Saisissez un nom pour le nouveau style. Le nom ne peut contenir que des lettres et des chiffres et
ne peut pas commencer par un chiffre.
Sous Style pour le paragraphe suivant, s&eacute;lectionnez l'option (Pas de modification).
Cliquez sur Format et pr&eacute;cisez les param&egrave;tres.
Mise en correspondance des couleurs des puces et du texte
Mise en correspondance des couleurs &agrave; l'aide d'un style en ligne
1)
S&eacute;lectionnez la liste &agrave; puces et choisissez Modifier &gt; Caract&egrave;re &gt; Formatage de caract&egrave;res &gt; Police.
Les couleurs des puces et du texte deviennent des styles en ligne.
Mise en correspondance des couleurs &agrave; l'aide d'une feuille de style
1)
Placez votre curseur dans l'&eacute;diteur de conception, puis s&eacute;lectionnez Modifier &gt; Styles &gt; Conteneur
de style.
2) Dans la liste Styles, s&eacute;lectionnez le style et cliquez sur le bouton Cr&eacute;er un nouveau style .
3) Sous Type de style, s&eacute;lectionnez Style de paragraphe.
4) Saisissez un nom pour le nouveau style. Le nom ne peut contenir que des lettres et des chiffres et
ne peut pas commencer par un chiffre.
5) Sous Style pour le paragraphe suivant, s&eacute;lectionnez un style.
Les styles de paragraphe s'appliquent aux paragraphes entiers et affectent la police, l'espacement
des lignes, la num&eacute;rotation, les bordures et les trames, ainsi que les effets DHTML du texte.
6) S&eacute;lectionnez Format &gt; Police.
7) S&eacute;lectionnez une couleur.
8) Cliquez deux fois sur OK.
9) S&eacute;lectionnez le texte &agrave; formater, puis cliquez sur Liste &agrave; puces.
10) Dans la liste des styles, s&eacute;lectionnez le style cr&eacute;&eacute;.
Suppression des puces et de la num&eacute;rotation
1)
2)
S&eacute;lectionnez les &eacute;l&eacute;ments de la liste num&eacute;rot&eacute;e ou de la liste &agrave; puces.
Dans le menu Modifier, cliquez sur le bouton bascule Cr&eacute;er une liste num&eacute;rot&eacute;e ou Cr&eacute;er une liste
&agrave; puces.
205
CHAPITRE 5
LISTES
MODIFICATION ET FORMATAGE
Application d'un format de num&eacute;rotation
REMARQUE : Le formatage de listes &agrave; l'aide de la barre d'outils ou du menu Format entra&icirc;ne la cr&eacute;ation de
styles en ligne. Les feuilles de style ne sont pas affect&eacute;es.
1) Ouvrez la rubrique dans l'&eacute;diteur de conception.
2) S&eacute;lectionnez la liste num&eacute;rot&eacute;e.
3) Cliquez avec le bouton droit de la souris sur la liste et choisissez Puces et num&eacute;rotation.
4) Cliquez sur l'onglet Num&eacute;rot&eacute;. S&eacute;lectionnez un format de num&eacute;rotation.
Ajout d'un paragraphe &agrave; une liste
Appliquez la proc&eacute;dure suivante pour ins&eacute;rer des paragraphes entre des &eacute;l&eacute;ments num&eacute;rot&eacute;s ou &agrave; puces
d'une liste.
1) Cliquez &agrave; la fin de la ligne pour ins&eacute;rer un paragraphe au-dessus.
2) Appuyez sur Maj+Entr&eacute;e.
3) Pour arr&ecirc;ter le saut de ligne et red&eacute;marrer la num&eacute;rotation ou les puces, appuyez sur Entr&eacute;e.
4) (Facultatif) Pour mettre le paragraphe en retrait, d&eacute;placez le curseur situ&eacute; en haut de l'&eacute;diteur de
conception.
ASTUCE : Pour commencer et arr&ecirc;ter une liste, cliquez sur le bouton Liste num&eacute;rot&eacute;e de la barre d'outils.
Reprise ou poursuite de la num&eacute;rotation num&eacute;rique ou alphab&eacute;tique
Apr&egrave;s avoir ins&eacute;r&eacute; une liste imbriqu&eacute;e, vous pouvez r&eacute;gler la num&eacute;rotation ou les lettres de la liste.
1) Cliquez sur la ligne au niveau de laquelle vous souhaitez commencer la nouvelle s&eacute;quence de
num&eacute;rotation ou de lettres.
2) Cliquez avec le bouton droit de la souris sur la liste et choisissez Puces et num&eacute;rotation.
3) S&eacute;lectionnez l'onglet Num&eacute;ros.
4) Dans la zone Recommencer la num&eacute;rotation &agrave;, saisissez la valeur de d&eacute;part.
Pour obtenir une liste alphab&eacute;tique, saisissez l'&eacute;quivalent chiffr&eacute; de la premi&egrave;re lettre. Par exemple,
saisissez 4 pour la lettre D.
5) Cliquez sur OK.
206
EN-T&Ecirc;TES DE PAGE, PIEDS DE PAGE ET SAUTS DE PAGE
MODIFICATION ET FORMATAGE
CHAPITRE 5
5.7.
En-t&ecirc;tes de page, pieds de page et sauts de page
En-t&ecirc;tes et pieds de page
Vous pouvez cr&eacute;er des en-t&ecirc;tes ou des pieds de page dans les rubriques ou les pages principales.
Si vous modifiez ou supprimez un en-t&ecirc;te ou un pied de page, les rubriques et les pages principales seront
&eacute;dit&eacute;es comme suit :
Dans une rubrique
Les modifications sont appliqu&eacute;es &agrave; la rubrique.
Dans une page principale
Les modifications sont appliqu&eacute;es &agrave; toutes les rubriques associ&eacute;es au mod&egrave;le.
Dans une rubrique associ&eacute;e &agrave; une page principale
Vous pouvez d&eacute;cider d'appliquer les modifications &agrave; la rubrique en cours ou &agrave; la page principale et
&agrave; l'ensemble des rubriques associ&eacute;es.
Cr&eacute;ation ou modification d'en-t&ecirc;tes et de pieds de page
1)
2)
3)
4)
5)
6)
Ouvrez la rubrique ou la page principale.
S&eacute;lectionnez Ins&eacute;rer &gt; Conception de page &gt; Table des mati&egrave;res des rubriques &gt; Saut de ligne.
Saisissez le contenu de l'en-t&ecirc;te ou du pied de page. Les fen&ecirc;tres contextuelles purement textuelles
ne sont pas prises en charge.
(Facultatif) Pour ajouter ou modifier des marges, des bordures, une couleur ou une image, cliquez
avec le bouton droit de la souris sur l'en-t&ecirc;te ou le pied de page, puis s&eacute;lectionnez Propri&eacute;t&eacute;s
d'en-t&ecirc;te ou Propri&eacute;t&eacute;s de pied de page.
REMARQUE : Les fichiers image s&eacute;lectionn&eacute;s sont ajout&eacute;s au dossier Fichiers bagage et sont inclus
dans le projet Lors de sa g&eacute;n&eacute;ration.
Cliquez hors de l'en-t&ecirc;te ou du pied de page.
Cliquez sur le bouton Enregistrer tout.
Suppression d'en-t&ecirc;tes et de pieds de page
1)
2)
3)
4)
Ouvrez la rubrique ou la page principale contenant l'en-t&ecirc;te ou le pied de page &agrave; modifier.
Cliquez sur le bouton En-t&ecirc;te ou Pied de page.
Cliquez avec le bouton droit de la souris sur l'en-t&ecirc;te ou le pied de page et s&eacute;lectionnez Supprimer
un en-t&ecirc;te ou Supprimer un pied de page.
Cliquez sur le bouton Enregistrer tout.
207
ZONES DE TEXTE
MODIFICATION ET FORMATAGE
CHAPITRE 5
Insertion de sauts de page
Ins&eacute;rez des sauts de page dans les rubriques pour introduire de nouvelles pages dans la documentation
imprim&eacute;e obtenue.
1) Ouvrez la rubrique dans l'&eacute;diteur de conception. Cliquez l&agrave; o&ugrave; vous souhaitez ins&eacute;rer le saut de
page.
2) S&eacute;lectionnez Ins&eacute;rer &gt; Conception de page &gt; Saut de page. Vous pouvez &eacute;galement appuyer sur
Ctrl + Entr&eacute;e.
5.8.
Zones de texte
Insertion de zones de texte dans les rubriques
Remarques
•
•
•
S&eacute;lectionnez Positionnement dans le menu Affichage.
le texte peut entourer une zone de texte.
si les utilisateurs poss&egrave;dent Internet Explorer version 4.0 ou ult&eacute;rieure, vous pouvez appliquer des
effets DHTML &agrave; un paragraphe en le pla&ccedil;ant dans une zone de texte.
Insertion d'une zone de texte
1)
2)
3)
4)
Cliquez &agrave; l'endroit o&ugrave; vous souhaitez ins&eacute;rer la zone de texte.
S&eacute;lectionnez Ins&eacute;rer &gt; HTML &gt; Zone de texte.
(Facultatif) Cliquez avec le bouton droit de la souris sur la zone de texte et s&eacute;lectionnez Propri&eacute;t&eacute;s
de Zone de texte. Modifiez les propri&eacute;t&eacute;s.
Cliquez dans la zone de texte pour saisir du texte ou pour ins&eacute;rer une image ou un autre &eacute;l&eacute;ment.
Insertion d'une zone de texte positionn&eacute;e
Ce type de zone de texte permet de placer pr&eacute;cis&eacute;ment les informations dans la page, avec les autres
&eacute;l&eacute;ments en arri&egrave;re-plan.
1) S&eacute;lectionnez Ins&eacute;rer &gt; HTML &gt; Zone de texte &gt; Zone de texte positionn&eacute;e.
2) S&eacute;lectionnez la zone de texte positionn&eacute;e et faites-la glisser vers la position souhait&eacute;e.
3) Cliquez avec le bouton droit de la souris sur la zone de texte positionn&eacute;e et s&eacute;lectionnez Propri&eacute;t&eacute;s
de Zone de texte positionn&eacute;e. D&eacute;finissez les propri&eacute;t&eacute;s.
Superposition de zones de texte positionn&eacute;es
Les effets Dynamic HTML (DHTML) permettent de superposer des zones de texte positionn&eacute;es en
sp&eacute;cifiant leur ordre d'affichage.
1) S&eacute;lectionnez la zone de texte &agrave; placer en arri&egrave;re-plan.
2) Dans le menu Z de la barre d'outils de positionnement, s&eacute;lectionnez 1.
208
VARIABLES D&Eacute;FINIES PAR L'UTILISATEUR
MODIFICATION ET FORMATAGE
CHAPITRE 5
3)
R&eacute;p&eacute;tez la proc&eacute;dure pour les autres zones de texte.
Zones de texte superpos&eacute;es
Modification des propri&eacute;t&eacute;s de zone de texte
1)
2)
Cliquez avec le bouton droit de la souris sur la zone de texte. S&eacute;lectionnez Propri&eacute;t&eacute;s de Zone de
texte ou Propri&eacute;t&eacute;s de Zone de texte positionn&eacute;e.
Modifiez les propri&eacute;t&eacute;s.
Suppression de zones de texte d'une rubrique
1)
2)
S&eacute;lectionnez la zone de texte.
Dans la barre d'outils Modifier, cliquez sur le bouton Supprimer.
5.9.
Variables d&eacute;finies par l'utilisateur
Les variables d&eacute;finies par l'utilisateur vous permettent de stocker des informations statiques globales
r&eacute;currentes dans un projet. Ainsi, elles rendent les donn&eacute;es portables et facilitent leur mise &agrave; jour. La
modification d'une variable ou d'une valeur entra&icirc;ne une mise &agrave; jour de cette variable ou valeur dans
l'ensemble du projet. Le conteneur Variables d&eacute;finies par l'utilisateur (disponible dans le menu Projet &gt;
Ouvrir &gt; Conteneurs) r&eacute;pertorie l'ensemble des variables d&eacute;finies par l'utilisateur dans un projet.
ASTUCE : Vous pouvez importer des documents avec des variables dans un projet.
REMARQUE : Lorsque vous proc&eacute;dez &agrave; une mise &agrave; niveau depuis des versions ult&eacute;rieures de RoboHelp, les
valeurs des variables sont converties en texte HTML et ces valeurs de variables apparaissent dans le jeu
par d&eacute;faut.
209
CHAPITRE 5
VARIABLES D&Eacute;FINIES PAR L'UTILISATEUR
MODIFICATION ET FORMATAGE
Cr&eacute;ation d'une variable d&eacute;finie par l'utilisateur
Avant de cr&eacute;er une variable globale, assurez-vous que toutes les variables requises existent.
1) Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Variables d&eacute;finies par l'utilisateur.
–
Cliquez avec le bouton droit de la souris dans la rubrique. S&eacute;lectionnez Ajouter &agrave; &gt; Variable
d&eacute;finie par l'utilisateur.
2)
3)
Saisissez un nom et une valeur pour la variable.
Les noms de variable ne peuvent contenir que des caract&egrave;res alphanum&eacute;riques, des tirets de
soulignement ou des tirets et ne doivent pas d&eacute;passer 255 caract&egrave;res. Une valeur de variable peut
&ecirc;tre vide.
Cliquez sur OK. La variable est ins&eacute;r&eacute;e.
ASTUCE : Appuyez sur Ctrl+F9, puis sp&eacute;cifiez le nom de variable entre les accolades qui s'affichent dans la
rubrique. Cliquez deux fois sur la variable pour sp&eacute;cifier sa valeur dans la bo&icirc;te de dialogue Champs et
variables.
REMARQUE : Vous ne pouvez cr&eacute;er des variables que dans le jeu de variables par d&eacute;faut, mais il est possible
de modifier la valeur d'une variable dans d'autres jeux de variables.
Cr&eacute;ation d'un jeu de variables
Les jeux de variables permettent de modifier les valeurs de variables d&eacute;finies par l'utilisateur avant de les
utiliser dans diff&eacute;rentes sorties.
Le jeu de variables par d&eacute;faut est le jeu de variables principal. Lors de l'insertion d'une variable, elle
provient du jeu de variables par d&eacute;faut.
Vous pouvez cr&eacute;er diff&eacute;rents jeux de variables dans le conteneur Variables d&eacute;finies par l'utilisateur, afin
de remplacer les valeurs des variables du jeu de variables par d&eacute;faut et les utiliser dans diff&eacute;rentes sorties.
Pour utiliser un jeu de variables autre que le jeu de variables par d&eacute;faut, s&eacute;lectionnez-le dans le volet
Contenu des propri&eacute;t&eacute;s de mise en page.
1) Cliquez sur l'ic&ocirc;ne Ajouter/modifier un jeu de variables.
2) Cliquez sur Ajouter et entrez le nom du nouveau jeu de variables.
3) Cliquez sur OK.
REMARQUE :
Vous pouvez modifier et supprimer un jeu de variables en cliquant sur les boutons
correspondants de la bo&icirc;te de dialogue Jeu de variables.
210
CHAPITRE 5
VARIABLES D&Eacute;FINIES PAR L'UTILISATEUR
MODIFICATION ET FORMATAGE
Modification d'une variable d&eacute;finie par l'utilisateur
1)
2)
3)
4)
5)
Dans le conteneur Variables d&eacute;finies par l'utilisateur, s&eacute;lectionnez une variable dans le jeu de
variables par d&eacute;faut.
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Cliquez avec le bouton droit de la souris et s&eacute;lectionnez Modifier.
–
S&eacute;lectionnez et modifiez sa valeur dans l'&eacute;diteur Variables d&eacute;finies par l'utilisateur.
–
Dans le menu Modifier, s&eacute;lectionnez Modifier [nom de la variable].
(Facultatif) S&eacute;lectionnez un autre jeu de variables.
Modifiez la valeur.
Cliquez sur OK.
REMARQUE : Vous pouvez formater une variable d&eacute;finie par l'utilisateur dans l'&eacute;diteur Variables d&eacute;finies
par l'utilisateur. Les boutons Conception et HMTL de l'&eacute;diteur vous permettent de basculer entre l'&eacute;diteur
de conception et l'&eacute;diteur HTML.
Mise en forme d'une variable d&eacute;finie par l'utilisateur
Vous pouvez mettre en forme des valeurs de variable dans l'&eacute;diteur Variables d&eacute;finies par l'utilisateur.
L'&eacute;diteur de conception permet &eacute;galement d'effectuer les op&eacute;rations suivantes :
•
Ins&eacute;rer des images, des liens hypertexte et des fichiers multim&eacute;dia dans les valeurs de variable.
•
Appliquer des balises de construction conditionnelles aux valeurs.
•
V&eacute;rifier la syntaxe des valeurs de variables.
Insertion d'une variable d&eacute;finie par l'utilisateur
Vous pouvez faire glisser une variable d&eacute;finie par l'utilisateur depuis le conteneur Variables d&eacute;finies par
l'utilisateur vers l'emplacement souhait&eacute; dans une rubrique ouverte dans l'&eacute;diteur de conception. Si la
liste des variables est longue, sp&eacute;cifiez le nom ou la valeur de la variable &agrave; rechercher. Vous pouvez
&eacute;galement ins&eacute;rer des variables &agrave; l'aide des &eacute;tapes suivantes :
1) Placez le point d'insertion &agrave; l'emplacement souhait&eacute; dans une rubrique.
2) S&eacute;lectionnez Ins&eacute;rer &gt; Variables &gt; Variable.
3) S&eacute;lectionnez une variable, puis cliquez sur OK.
ASTUCE : Sp&eacute;cifiez le nom ou la valeur de la variable &agrave; rechercher. Au fur et &agrave; mesure que vous tapez votre
cha&icirc;ne de recherche, RoboHelp affine la liste des variables.
211
CHAPITRE 5
VARIABLES D&Eacute;FINIES PAR L'UTILISATEUR
MODIFICATION ET FORMATAGE
Affichage des propri&eacute;t&eacute;s d'une variable d&eacute;finie par l'utilisateur
1)
2)
3)
Dans le conteneur Variables d&eacute;finies par l'utilisateur, s&eacute;lectionnez le jeu de variables par d&eacute;faut.
S&eacute;lectionnez une variable.
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Effectuez un clic droit et s&eacute;lectionnez Propri&eacute;t&eacute;s.
–
S&eacute;lectionnez Edition &gt; Propri&eacute;t&eacute;s.
4)
Les d&eacute;tails de la variable s'affichent (Nom de variable, Jeu de variables, Valeur de la variable,
Description et Utilis&eacute; dans les rubriques).
Cliquez sur OK.
5)
Activer/d&eacute;sactiver les vues variables
Utilisez la fonction de champs &agrave; variable de basculement pour basculer entre le nom et la valeur de la
variable s&eacute;lectionn&eacute;e. Lorsque vous basculez tous les champs, l'&eacute;tat actuel par d&eacute;faut de la variable
s&eacute;lectionn&eacute;e ou de la premi&egrave;re variable de la rubrique est r&eacute;pliqu&eacute; sur toutes les variables dans le
document actif.
Vous avez d&eacute;sormais la possibilit&eacute; de basculer entre le nom de la variable et la valeur qu'il repr&eacute;sente de
l'une des fa&ccedil;ons suivantes :
1) En utilisant la combinaison de touches : Cliquez sur la variable dans la rubrique et utilisez la
combinaison de touches Maj+F9 pour activer/d&eacute;sactiver un seul champ ou utilisez la combinaison
de touches Maj+F11 pour activer ou d&eacute;sactiver tous les champs.
2) En utilisant le menu contextuel : Cliquez avec le bouton droit sur la variable, s&eacute;lectionnez Champ &gt;
Basculer le champ pour activer ou d&eacute;sactiver une seule variable ou s&eacute;lectionnez Basculer tous les
champs pour activer ou d&eacute;sactiver toutes les variables.
Vous pouvez &eacute;galement passer le pointeur de la souris sur la variable pour afficher le nom de la
variable.
REMARQUE : L'option Activer/d&eacute;sactiver les vues variables et le menu contextuel est visible uniquement
lorsque vous choisissez le nom de la variable.
Suppression d'une variable d&eacute;finie par l'utilisateur
1)
2)
3)
Dans le conteneur Variables d&eacute;finies par l'utilisateur, s&eacute;lectionnez le jeu de variables par d&eacute;faut.
Cliquez avec le bouton droit de la souris sur une variable d&eacute;finie par l'utilisateur, puis s&eacute;lectionnez
Supprimer.
S&eacute;lectionnez l'une des options suivantes :
Supprimer la variable et ses r&eacute;f&eacute;rences
Supprime la variable et les r&eacute;f&eacute;rences &agrave; cette variable dans l'ensemble des rubriques, tables des
mati&egrave;res, index, SSL et mod&egrave;les. Aucun avertissement de suppression ne s'affiche.
REMARQUE : G&eacute;n&eacute;rez un rapport sur les variables pour localiser les variables &agrave; supprimer.
212
CHAPITRE 5
SOURCE UNIQUE POUR LES EXTRAITS DE CODE
MODIFICATION ET FORMATAGE
Supprimer uniquement la variable
Supprime la valeur de la variable en local. La suppression d'une variable d&eacute;finie par l'utilisateur dans
la table des mati&egrave;res ne la supprime pas de l'index.
REMARQUE : Si la valeur de la variable est remplac&eacute;e dans le fichier de mises en page source unique, elle
est supprim&eacute;e de la liste des variables figurant dans la bo&icirc;te de dialogue Mises en page source unique.
Supprimer la variable et la remplacer par son contenu r&eacute;el
Supprime la variable dans l'ensemble des rubriques, tables des mati&egrave;res, index, SSL et mod&egrave;les. Les
r&egrave;gles de formatage de la variable restent inchang&eacute;es.
Modification du nom d'une variable d&eacute;finie par l'utilisateur
REMARQUE : Vous ne pouvez pas changer le nom des variables sauvegard&eacute;es.
1)
2)
3)
4)
5)
S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Variables d&eacute;finies par l'utilisateur. Le conteneur
Variables d&eacute;finies par l'utilisateur s'affiche.
Cliquez avec le bouton droit de la souris sur une variable et s&eacute;lectionnez Renommer.
Dans le champ Nom de la variable, saisissez un nom.
Dans le champ Valeur de la variable, modifiez la valeur.
Cliquez sur OK.
5.10. Source unique pour les extraits de code
Un extrait de code est un &eacute;l&eacute;ment que vous pouvez cr&eacute;er dans une source unique et r&eacute;utiliser &agrave; plusieurs
endroits. Il peut s'agir d'un paragraphe de texte, de code, d'un objet tel qu'une image ou d'une rubrique
enti&egrave;re. Lorsque vous cr&eacute;ez un extrait de code, RoboHelp l'ajoute dans le conteneur Extrait de code sous
la forme d'un fichier portant l'extension .hts. Si vous modifiez un extrait de code, il est automatiquement
mis &agrave; jour dans toutes les rubriques qui le partagent. Les extraits de code peuvent contenir des images,
des variables et des balises de texte conditionnel. Lorsqu'ils sont partag&eacute;s dans une rubrique, ils
conservent le formatage du texte en ligne. Le formatage CSS change en fonction de la feuille de style CSS
appliqu&eacute;e dans la rubrique contenant l'extrait de code.
Le conteneur Extrait de code pr&eacute;sente un aper&ccedil;u de tous les extraits de code avec leur s&eacute;lection
individuelle. Cliquez avec le bouton droit de la souris sur le conteneur Extrait de code pour activer ou
d&eacute;sactiver le mode Aper&ccedil;u. Faites glisser les extraits de code depuis le conteneur vers une rubrique ou
depuis l'Explorateur Windows vers le conteneur Extrait de code. Vous pouvez &eacute;galement s&eacute;lectionner un
ou plusieurs extraits de code, puis les copier, les dupliquer ou les supprimer.
REMARQUE : Vous pouvez g&eacute;n&eacute;rer des rapports sur les extraits de code inutilis&eacute;s et supprimer ces derniers.
Vous pouvez glisser-d&eacute;poser des extraits de code depuis le conteneur Extrait de code vers le gestionnaire
de ressources pour les exporter vers le dossier cible. l'extrait de code export&eacute; existe &agrave; un niveau global et
peut &ecirc;tre affich&eacute; par tous les utilisateurs. Glissez un extrait de code depuis le conteneur Gestionnaire de
ressources vers le conteneur Extrait de code pour que RoboHelp importe le fichier d'extrait de code
s&eacute;lectionn&eacute; et ses fichiers associ&eacute;s dans le projet.
213
CHAPITRE 5
SOURCE UNIQUE POUR LES EXTRAITS DE CODE
MODIFICATION ET FORMATAGE
REMARQUE : Vous pouvez glisser-d&eacute;poser un extrait de code dans l'&eacute;diteur de conception pour modifier son
contenu.
LIENS CONNEXES :
Gestion des ressources partag&eacute;es
Cr&eacute;ation et gestion des extraits de code
•
•
•
•
•
•
•
•
•
•
Pour cr&eacute;er int&eacute;gralement un extrait de code, s&eacute;lectionnez Ins&eacute;rer &gt; Variables &gt; Extrait de code.
Sp&eacute;cifiez un nom de cat&eacute;gorie (si vous ne sp&eacute;cifiez pas de nom de cat&eacute;gorie, RoboHelp ajoute
l'extrait de code dans la cat&eacute;gorie Par d&eacute;faut).
Pour cr&eacute;er un extrait de code &agrave; partir d'un contenu existant, s&eacute;lectionnez le texte. Cliquez avec le
bouton droit de la souris et s&eacute;lectionnez Ajouter &agrave; &gt; Extraits de code. Sp&eacute;cifiez un nom de cat&eacute;gorie
(si vous ne sp&eacute;cifiez pas de nom de cat&eacute;gorie, RoboHelp ajoute l'extrait de code dans la cat&eacute;gorie
Par d&eacute;faut).
Pour afficher les propri&eacute;t&eacute;s de l'extrait de code, cliquez avec le bouton droit de la souris sur l'extrait
de code dans le conteneur Extraits de code et s&eacute;lectionnez Propri&eacute;t&eacute;s. Dans l'onglet Utilis&eacute; dans,
vous pouvez voir les noms des rubriques dans lesquelles l'extrait est utilis&eacute;.
Pour joindre une feuille de style &agrave; un extrait de code, cliquez avec le bouton droit de la souris sur
l'extrait de code dans le conteneur Extraits de code et s&eacute;lectionnez Propri&eacute;t&eacute;s. Cliquez sur l'onglet
Aspect et s&eacute;lectionnez une feuille de style.
Pour copier un extrait de code, cliquez dessus avec le bouton droit de la souris dans le conteneur
Extraits de code et s&eacute;lectionnez Copier dans le menu contextuel.
Pour importer un extrait de code, s&eacute;lectionnez Projet &gt; Importer &gt; Extrait de code et acc&eacute;dez au
dossier source.
Pour exporter un extrait de code, s&eacute;lectionnez-le dans le conteneur Extraits de code, cliquez sur
sur la barre d'outils et acc&eacute;dez au dossier de destination.
Pour cr&eacute;er un fichier PDF &agrave; r&eacute;viser avec le contenu de l'extrait de code, cliquez avec le bouton droit
de la souris sur l'extrait de code dans le conteneur Extraits de code et s&eacute;lectionnez Cr&eacute;er un fichier
PDF &agrave; r&eacute;viser. Personnalisez les param&egrave;tres et cliquez sur OK.
Pour ins&eacute;rer une variable dans un extrait de code, ins&eacute;rez le pointeur et faites glisser une variable &agrave;
partir du conteneur Variables d&eacute;finies par l'utilisateur.
Pour afficher l'aper&ccedil;u d'un extrait de code, cliquez avec le bouton droit sur l'extrait de code dans le
conteneur Extraits de code et s&eacute;lectionnez Afficher l'aper&ccedil;u.
214
CHAPITRE 5
SOURCE UNIQUE POUR LES EXTRAITS DE CODE
MODIFICATION ET FORMATAGE
Insertion d'un extrait de code dans une rubrique
1)
2)
Ouvrez une rubrique.
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Sur la barre d'outils Objet, cliquez sur Ins&eacute;rer un extrait de code .
–
Dans le conteneur Extrait de code, s&eacute;lectionnez un extrait de code et faites-le glisser dans la
rubrique.
–
S&eacute;lectionnez Ins&eacute;rer &gt; Variables &gt; Extrait de code. S&eacute;lectionnez un extrait de code dans la liste
et cliquez sur OK.
3)
REMARQUE :
Cliquez avec le bouton droit de la souris sur un extrait de code au niveau du gestionnaire
de ressources, puis s&eacute;lectionnez Ajouter au projet pour ajouter l'extrait de code au projet.
Insertion d'un extrait de code dans un &eacute;diteur de texte d&eacute;roulant
1)
2)
3)
4)
Ouvrez une rubrique.
S&eacute;lectionnez du texte &agrave; d&eacute;velopper.
S&eacute;lectionnez Ins&eacute;rer &gt; DHTML &gt; Texte d&eacute;roulant.
Faites glisser un extrait de code depuis le conteneur Extrait de code et d&eacute;placez-le dans l'&eacute;diteur
Texte d&eacute;roulant.
REMARQUE : Vous pouvez afficher l'aper&ccedil;u de la rubrique et cliquer sur le texte DHTML. L'extrait de
code appara&icirc;t au niveau du texte d&eacute;roulant.
Application de balises de construction conditionnelles &agrave; un extrait de code
Utilisez le conteneur Balises de construction conditionnelles ou cliquez avec le bouton droit de la souris
pour appliquer du texte conditionnel &agrave; un extrait de code en totalit&eacute; ou en partie. l'option d'aper&ccedil;u
permet d'appliquer une balise conditionnelle au texte s&eacute;lectionn&eacute;, &agrave; du code ou &agrave; une image. Vous
pouvez inclure une balise de construction conditionnelle dans la sortie ou l'en exclure.
Insertion de variables dans des extraits de code
Choisissez une variable dans le conteneur Variables d&eacute;finies par l'utilisateur ou cliquez avec le bouton
droit de la souris sur une rubrique et choisissez Ins&eacute;rer une variable d&eacute;finie par l'utilisateur. l'extrait de
code pr&eacute;sente la valeur de la variable au point d'insertion.
Conversion d'un extrait de code en texte
Convertissez un extrait de code ins&eacute;r&eacute; en texte incorpor&eacute;. RoboHelp ne met pas &agrave; jour le texte incorpor&eacute;
si l'extrait de code est mis &agrave; jour.
1) Cliquez sur l'extrait de code dans la rubrique.
2) Cliquez avec le bouton droit de la souris et s&eacute;lectionnez l'option Convertir en texte HTML.
215
CHAPITRE 5
R&Eacute;F&Eacute;RENCES
MODIFICATION ET FORMATAGE
Suppression d'un extrait de code
1)
2)
Dans le conteneur Extraits de code, s&eacute;lectionnez l'extrait de code que vous souhaitez supprimer,
puis cliquez sur Supprimer l'&eacute;l&eacute;ment s&eacute;lectionn&eacute;.
S&eacute;lectionnez l'une des options suivantes :
Supprimer l'extrait de code et ses r&eacute;f&eacute;rences
Supprime l'extrait de code et ses r&eacute;f&eacute;rences dans l'ensemble des rubriques, tables des mati&egrave;res,
index, protocoles SSL et mod&egrave;les. Aucun avertissement de suppression ne s'affiche.
REMARQUE : Utilisez le rapport Extraits de code pour localiser les variables &agrave; supprimer.
Supprimer uniquement l'extrait de code
Supprime le contenu de l'extrait de code localement. Par exemple, si vous s&eacute;lectionnez un extrait
de code dans une table des mati&egrave;res et le supprimez lorsque cette option est s&eacute;lectionn&eacute;e,
le contenu de l'extrait de code n'est pas supprim&eacute; de l'index.
Supprimer l'extrait de code et remplacer les r&eacute;f&eacute;rences par leur contenu r&eacute;el
Supprime l'extrait de code et remplace les r&eacute;f&eacute;rences dans le projet par le contenu.
5.11. R&eacute;f&eacute;rences
Editeur par d&eacute;faut de balises META
Cliquez sur Oui pour faire de l'&eacute;diteur de conception de RoboHelp l'&eacute;diteur par d&eacute;faut des rubriques sans
balises META. Cliquez sur Non pour conserver l'&eacute;diteur actuel. La rubrique s'ouvre alors dans l'&eacute;diteur
s&eacute;lectionn&eacute;.
216
TYPES DE STYLES
STYLES ET FEUILLES DE STYLE
CHAPITRE 6
6.
Styles et feuilles de style
6.1.
Types de styles
Vous pouvez g&eacute;rer les feuilles de style au niveau du projet, tout en appliquant des styles au niveau de la
rubrique. Les pages principales vous fournissent une mise en page pour les rubriques et vous aident &agrave; en
contr&ocirc;ler le style. Voici les types de styles disponibles :
Styles en ligne
Le formatage d'un bloc de texte contenu dans un fichier HTML (rubrique) s'effectue directement
dans l'&eacute;diteur de conception. Si le fichier est li&eacute; &agrave; une feuille de style, les styles en ligne remplacent
les styles d&eacute;finis dans cette feuille de style ainsi que les styles int&eacute;gr&eacute;s. Voir Styles en ligne.
Styles int&eacute;gr&eacute;s
Il s'agit des d&eacute;finitions de style enregistr&eacute;es dans un fichier HTML (rubrique). Si le fichier est li&eacute; &agrave;
une feuille de style, les styles int&eacute;gr&eacute;s remplacent les styles d&eacute;finis dans cette feuille de style. Vous
pouvez cr&eacute;er un style de caract&egrave;re ou un style de paragraphe.
Styles des feuilles de style en cascade (CSS)
D&eacute;finitions de styles stock&eacute;es dans un fichier CSS. Vous pouvez cr&eacute;er un style de caract&egrave;re, de
paragraphe, de tableau ou de liste multi-niveaux.
Une fois le projet WinHelp converti au format HTML, les styles suivants sont disponibles :
Projet cr&eacute;&eacute; depuis un fichier HPJ
Vous pouvez cr&eacute;er des styles utilisant le m&ecirc;me formatage que ceux des mod&egrave;les Word. Ces styles
sont enregistr&eacute;s dans les feuilles de style li&eacute;es aux rubriques HTML. Si vous ne voulez pas utiliser de
feuilles de style, vous pouvez convertir le formatage Word en styles en ligne dans les rubriques
HTML.
Projet cr&eacute;&eacute; depuis un fichier HLP
Les feuilles de style pr&eacute;format&eacute;es peuvent &ecirc;tre appliqu&eacute;es &agrave; des rubriques HTML. Les rubriques sont
format&eacute;es pour utiliser les styles HTML par d&eacute;faut.
LIENS CONNEXES :
Pages principales
217
R&Egrave;GLES ET ATTRIBUTS DE SUPPORTS DANS LES STYLES
STYLES ET FEUILLES DE STYLE
CHAPITRE 6
6.2.
R&egrave;gles et attributs de supports dans les styles
Les r&egrave;gles et les attributs de supports vous aident &agrave; contr&ocirc;ler l'apparence de la sortie de votre projet sur
divers supports, comme les &eacute;crans de bureau traditionnels, les imprimantes et les p&eacute;riph&eacute;riques les plus
r&eacute;pandus, tels que l'iPad ou l'iPhone. Dans RoboHelp, vous pouvez modifier des d&eacute;finitions de style de
sorte &agrave; ajouter des r&egrave;gles et des attributs de supports.
D&eacute;finition des styles sp&eacute;cifiques au m&eacute;dia dans une feuille de style
Dans le conteneur de gestionnaire de projet, cliquez avec le bouton droit de la souris sur la feuille de style,
puis cliquez sur Modifier.
1) Dans la bo&icirc;te de dialogue Styles, s&eacute;lectionnez un style &agrave; modifier pour un support donn&eacute;.
2) S&eacute;lectionnez le type de support dans la liste des supports.
Non
Utilis&eacute; pour d&eacute;finir les styles g&eacute;n&eacute;riques
Imprimer
Utilis&eacute; pour les imprimantes
&lt;nom du profil de l'&eacute;cran&gt;
Chaque profil d'&eacute;cran du projet
3)
4)
Modifiez le style comme n&eacute;cessaire. Par exemple, s&eacute;lectionnez une taille de police plus petite.
Cliquez sur OK.
Ajout d'une r&egrave;gle de support dans les styles de la rubrique
Suivez cette proc&eacute;dure lorsque vous souhaitez d&eacute;finir diff&eacute;rentes r&egrave;gles de supports pour un style dans
la feuille de style actuellement li&eacute;e &agrave; une rubrique :
1) S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Style et formatage.
2) Dans le conteneur Styles et mise en forme, s&eacute;lectionnez un style &agrave; modifier d'un support donn&eacute;.
Cliquez avec le bouton droit de la souris et s&eacute;lectionnez Modifier.
3) S&eacute;lectionnez le support ou le nom du profil d'&eacute;cran &agrave; partir de la liste des supports.
4) Modifiez le style comme n&eacute;cessaire. Par exemple, s&eacute;lectionnez une taille de police plus petite.
5) Cliquez sur OK.
Appliquez le style et affichez le r&eacute;sultat.
218
CHAPITRE 6
R&Egrave;GLES ET ATTRIBUTS DE SUPPORTS DANS LES STYLES
STYLES ET FEUILLES DE STYLE
Association de fichiers CSS sp&eacute;cifiques aux supports &agrave; une rubrique et ajouts d'attributs
de supports dans le code HTML
Cr&eacute;ez des fichiers CSS distincts, cr&eacute;ez un lien vers une rubrique et modifiez le code HTML pour ajouter un
attribut de supports dans la balise de liaison.
Syntaxe de la balise de liaison
&lt;link rel=&quot;StyleSheet&quot; href=&quot;&lt;stylesheet_filename&gt;&quot; type=&quot;text/css&quot;
media=&quot;&lt;media_type&gt;&quot;/&gt;
Exemples
&lt;link rel=&quot;StyleSheet&quot; href=&quot;screen.css&quot; type=&quot;text/css&quot; media=&quot;screen&quot;/&gt;
&lt;link rel=&quot;StyleSheet&quot; href=&quot;print.css&quot; type=&quot;text/css&quot; media=&quot;print&quot;/&gt;
REMARQUE : Les exemples ci-dessus indiquent que .screen.css et print.css sont utilis&eacute;s respectivement
pour la sortie d'affichage des &eacute;crans et des imprimantes. L'attribut de support n&eacute;cessite des valeurs
pr&eacute;d&eacute;finies, comme &eacute;cran, impression, projection et ordinateur de poche.
Mappage de styles dans du contenu Word/FrameMaker vers des styles sp&eacute;cifiques au
support
Lors de l'importation ou de la liaison du contenu &agrave; partir de Microsoft Word ou FrameMaker, vous pouvez
mapper les styles existants &agrave; diff&eacute;rents m&eacute;dias. S&eacute;lectionnez Projet &gt; Importer.
Affichage du contenu dans les styles sp&eacute;cifiques au support dans la vue Conception
Apr&egrave;s l'application de styles sp&eacute;cifiques au support &agrave; une rubrique, &agrave; un extrait ou &agrave; la page principale,
vous pouvez v&eacute;rifier l'aspect du contenu d'un support sp&eacute;cifique et modifier les styles si n&eacute;cessaire. La
vue Conception affiche le contenu avec les styles du support s&eacute;lectionn&eacute;.
Les styles associ&eacute;s au support sont affich&eacute;es dans le conteneur Styles et mise en forme et dans la barre
d'outils Formatage.
1) S&eacute;lectionnez le type de support dans la liste des supports de la barre d'outils Format.
219
DEMANDES DE SUPPORTS
STYLES ET FEUILLES DE STYLE
CHAPITRE 6
Suppression d'un style sp&eacute;cifique au support
Lorsque vous cr&eacute;ez un style sp&eacute;cifique au support, RoboHelp utilise un style g&eacute;n&eacute;rique. Lorsque vous
supprimez le style sp&eacute;cifique au support, seul ce dernier est supprim&eacute;. Le style g&eacute;n&eacute;rique n'est pas
supprim&eacute;.
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
•
Avec le bouton droit de la souris, cliquez sur la feuille de style dans le Gestionnaire de projets et
choisissez Modifier. Dans la bo&icirc;te de dialogue Styles, s&eacute;lectionnez le style sp&eacute;cifique au support &agrave;
supprimer, puis cliquez sur Supprimer.
•
S&eacute;lectionnez le support dans la barre d'outils Format. S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt;
Style et formatage. Dans le conteneur Styles et mise en forme, s&eacute;lectionnez le style sp&eacute;cifique au
support que vous souhaitez supprimer. Cliquez avec le bouton droit de la souris et s&eacute;lectionnez
Supprimer.
6.3.
Demandes de supports
Les demandes de supports permettent un contr&ocirc;le accru des styles sp&eacute;cifiques aux supports, en
combinant diff&eacute;rents types de supports avec les fonctions de supports, tels que la largeur d'un
p&eacute;riph&eacute;rique. Par exemple, le code suivant vous permet de d&eacute;finir un attribut de style pour les
p&eacute;riph&eacute;riques avec une largeur d'&eacute;cran minimale de 980 px :
@media screen and (min-width:980px)
{ p { color: blue; } }
Si votre feuille de style comprend des d&eacute;finitions de style qui utilisent des demandes de supports, les
valeurs minimales et maximales de largeur se refl&egrave;tent dans la sortie g&eacute;n&eacute;r&eacute;e &agrave; partir de RoboHelp.
Gestion des demandes de supports pour les profils d'&eacute;cran
Si vous modifiez la largeur d'un profil d'&eacute;cran, la demande de supports pour ce profil d'&eacute;cran d&eacute;finie dans
la feuille de style devient non d&eacute;finie. RoboHelp ne met pas automatiquement &agrave; jour la demande de
supports.
Pour mapper les styles d'une demande de supports non d&eacute;finie &agrave; un support, suivez ces &eacute;tapes :
1) Cliquez avec le bouton droit de la souris sur le fichier CSS et s&eacute;lectionnez Modifier.
2) Dans la bo&icirc;te de dialogue Styles, s&eacute;lectionnez G&eacute;rer les demandes de supports dans la liste des
supports.
3) S&eacute;lectionnez la demande de supports non d&eacute;finie avec la largeur que vous avez sp&eacute;cifi&eacute;e et cliquez
sur Mapper.
4) S&eacute;lectionnez le profil de l'&eacute;cran.
5) Cliquez sur OK.
Pour supprimer les styles d'une demande de supports, s&eacute;lectionnez cette derni&egrave;re dans la bo&icirc;te de
dialogue G&eacute;rer les demandes de supports, puis cliquez sur Supprimer.
220
GESTION DES FEUILLES DE STYLE
STYLES ET FEUILLES DE STYLE
CHAPITRE 6
6.4.
Gestion des feuilles de style
Association d'une feuille de style aux rubriques ou aux pages principales
Vous pouvez associer une feuille de style &agrave; autant de rubriques HTML que vous le souhaitez, y compris &agrave;
celles de l'Affichage de la conception, &agrave; une nouvelle rubrique ou &agrave; des rubriques multiples.
Si vous cr&eacute;ez une feuille de style dans un projet et l'appliquez &agrave; une nouvelle rubrique, toutes les
rubriques cr&eacute;&eacute;es par la suite utiliseront la nouvelle feuille de style. Liez une rubrique &agrave; une autre,
au besoin.
1) S&eacute;lectionnez une ou plusieurs rubriques dans le conteneur Liste des rubriques.
2) Dans la barre d'outils Projet, cliquez sur l'ic&ocirc;ne Propri&eacute;t&eacute;s dans la barre d'outils. Cliquez sur
l'onglet Pr&eacute;sentation.
3) S&eacute;lectionnez une feuille de style. Le cas &eacute;ch&eacute;ant, cliquez sur le bouton Parcourir pour explorer
une feuille de style ou cliquez sur le bouton Nouveau pour cr&eacute;er une feuille de style.
4) (Facultatif) Modifiez la feuille de style :
Modifier
Ajoutez, modifiez ou supprimez des styles dans la feuille de style.
Son en arri&egrave;re-plan
Ajoutez un son &agrave; l'ouverture de la rubrique dans l'afficheur ou le navigateur.
Nombre de boucles son
D&eacute;finissez le nombre de lectures du son &agrave; l'ouverture de la rubrique. S&eacute;lectionnez l'option Infini
pour &eacute;mettre le son en continu, tant que la rubrique est ouverte.
5)
Cliquez sur OK.
REMARQUE : Proc&eacute;dez de m&ecirc;me pour lier une feuille de style &agrave; une rubrique dans l'&eacute;diteur de conception.
LIENS CONNEXES :
Application d'une page principale ou d'une feuille CSS lors de la g&eacute;n&eacute;ration
Suppression de l'association d'une feuille de style aux rubriques ou aux pages
principales
Apr&egrave;s la suppression de l'association d'une feuille de style &agrave; une rubrique, le formatage de la feuille de
style est supprim&eacute; de la rubrique.
1) S&eacute;lectionnez une ou plusieurs rubriques dans le conteneur Liste des rubriques.
2) Dans la barre d'outils Projet, cliquez sur l'ic&ocirc;ne Propri&eacute;t&eacute;s dans la barre d'outils. Cliquez sur
l'onglet Pr&eacute;sentation.
221
CHAPITRE 6
3)
4)
GESTION DES FEUILLES DE STYLE
STYLES ET FEUILLES DE STYLE
S&eacute;lectionnez Aucun dans la liste des feuilles de style ou cliquez sur le bouton Parcourir
s&eacute;lectionner une autre feuille de style &agrave; appliquer.
Cliquez sur OK.
pour
Cr&eacute;ation d'une feuille de style
La nouvelle feuille de style (default.css) constitue la feuille de style par d&eacute;faut jusqu'&agrave; la cr&eacute;ation d'une
autre feuille ou la liaison d'une autre feuille de style &agrave; une nouvelle rubrique.
1) Modifier &gt; CSS &gt; Nouvelle feuille de style.
2) S&eacute;lectionnez Nouvelle variable.
3) Dans le champ Nom, indiquez un nom de fichier en ajoutant l'extension .css.
4) Dans Dossier, s&eacute;lectionnez un emplacement.
5) (Facultatif) Pour baser la nouvelle feuille de style sur une feuille de style existante, s&eacute;lectionnez
Copier les styles depuis, puis choisissez une feuille de style.
6) Cliquez sur Cr&eacute;er, cr&eacute;ez le style de votre choix et s&eacute;lectionnez OK.
Cr&eacute;ation simultan&eacute;e d'une feuille de style et d'une rubrique
1)
2)
3)
4)
5)
S&eacute;lectionnez Projet &gt; Nouveau &gt; Rubrique. Cliquez sur l'onglet Pr&eacute;sentation.
Cliquez sur Nouveau.
Indiquez un nom de fichier en ajoutant l'extension .css.
Cr&eacute;ez ou modifiez des styles pr&eacute;d&eacute;finis dans la bo&icirc;te de dialogue Styles.
Cliquez sur OK.
Exportation d'une feuille de style
1)
2)
3)
4)
S&eacute;lectionnez l'&eacute;diteur de conception.
S&eacute;lectionnez Format &gt; Exporter les styles.
Acc&eacute;dez &agrave; l'emplacement dans lequel vous souhaitez exporter la feuille de style.
Le cas &eacute;ch&eacute;ant, renommez la feuille de style, en conservant l'extension de nom de fichier .css.
REMARQUE : Cette fonctionnalit&eacute; ne concerne que les styles appliqu&eacute;s dans une rubrique et non au
niveau d'un projet.
Cliquez sur Enregistrer.
REMARQUE : Vous pouvez uniquement exporter les styles incorpor&eacute;s sp&eacute;cifiques aux rubriques.
222
CR&Eacute;ATION DE STYLES POUR DES FEUILLES DE STYLE
STYLES ET FEUILLES DE STYLE
CHAPITRE 6
6.5.
Cr&eacute;ation de styles pour des feuilles de style
Cr&eacute;ation d'un style dans la bo&icirc;te de dialogue Styles
1)
2)
3)
4)
5)
Dans le conteneur Gestionnaire de projets, cliquez avec le bouton droit de la souris sur la feuille de
style dans laquelle cr&eacute;er le style et cliquez sur Modifier.
Cliquez sur Nouveau et s&eacute;lectionnez un type de style (paragraphe, par exemple). Par d&eacute;faut, le
nouveau style est cr&eacute;&eacute; et porte un nom par d&eacute;faut de type Style 1.
Vous pouvez modifier ce nom dans la bo&icirc;te de dialogue Styles. N'indiquez aucun caract&egrave;re sp&eacute;cial
ni espace.
REMARQUE : Si vous utilisez des caract&egrave;res sp&eacute;ciaux, RoboHelp vous demande de corriger le nom
saisi. En effet, certains navigateurs ne peuvent pas lire les styles dont les noms comprennent ce type
de caract&egrave;res.
S&eacute;lectionnez les options dans la zone Formatage de la bo&icirc;te de dialogue Styles. Les modifications
apparaissent dans la section Aper&ccedil;u du paragraphe.
(Facultatif) Pour d&eacute;finir des valeurs suppl&eacute;mentaires, cliquez sur Format et s&eacute;lectionnez une option.
Police
Permet de s&eacute;lectionner des familles, des tailles et des attributs de police (gras ou italique, par
exemple).
Paragraphe
Permet de d&eacute;finir des retraits, un interligne et un alignement.
Bordures et trame
Gr&acirc;ce &agrave; l'onglet Bordures, vous pouvez d&eacute;terminer des types de bordure, ainsi que l'&eacute;paisseur du
trait et l'espacement. L'onglet Trame vous permet quant &agrave; lui de configurer des options relatives aux
images et aux couleurs d'arri&egrave;re-plan.
Effets DHTML
S&eacute;lectionnez l'effet DHTML &agrave; inclure, ainsi que le moment de son ajout.
REMARQUE : Si vous modifiez un style afin d'inclure un effet DHTML, n'oubliez pas d'enregistrer de
nouveau les rubriques li&eacute;es &agrave; la feuille de style. S&eacute;lectionnez Outils &gt; Scripts &gt; Mettre &agrave; jour DHTML.
Lorsque vous r&eacute;enregistrez les fichiers li&eacute;s &agrave; la feuille de style, les rubriques con&ccedil;ues avec des
&eacute;diteurs tiers sont converties en rubriques RoboHelp HTML. Des balises HTML sp&eacute;ciales sont
ajout&eacute;es afin de prendre en charge les fonctions d'aide sp&eacute;cifiques de ce programme.
223
STYLES DE TABLEAU
STYLES ET FEUILLES DE STYLE
CHAPITRE 6
Cr&eacute;ation d'un style via le conteneur Styles et formatage
1)
2)
3)
4)
Pour ouvrir ce conteneur, ouvrez une rubrique et s&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Style
et formatage.
Sur la barre d'outils Styles et formatage, cliquez sur le bouton Cr&eacute;er un style et s&eacute;lectionnez un
type de style (liste, par exemple).
Indiquez un nom de style et cliquez sur OK.
S&eacute;lectionnez les options relatives aux polices et &agrave; la mise en forme et cliquez sur OK.
LIENS CONNEXES :
Conteneur Styles et formatage
Cr&eacute;ation d'un style via l'&eacute;diteur de conception
1)
2)
3)
4)
Dans l'&eacute;diteur de conception, s&eacute;lectionnez du texte dans une rubrique.
Appliquez-lui un format (gras par exemple).
V&eacute;rifiez que le texte est toujours s&eacute;lectionn&eacute;, choisissez un nom de style dans la liste Style de la
barre d'outils et appuyez sur Entr&eacute;e.
Cliquez sur Cr&eacute;er.
6.6.
Styles de tableau
Avec l'Editeur de style, vous pouvez cr&eacute;er et personnaliser les styles de tableau en fonction de vos
besoins. L'application d'un style de tableau au lieu d'une mise en forme en ligne vous aide &agrave; ajouter des
tableaux standard et faciles &agrave; conserver. Si vous modifiez un style de tableau, tous les tableaux utilisant
ce style changent &eacute;galement.
Vous pouvez modifier l'aspect des tableaux existants en appliquant un style. RoboHelp vous demande si
vous souhaitez supprimer la mise en forme en ligne &eacute;galement.
Pour obtenir des conseils et des solutions de rechange concernant la personnalisation des tableaux, voir
la section Tableau de la visite de RoboHelp de Peter Grainge.
Styles de tableau globaux
Vous pouvez s&eacute;lectionner des styles de tableau pr&eacute;d&eacute;finis. Ces styles permettent de d&eacute;finir des tableaux diff&eacute;rents sur plusieurs projets. Les styles de tableau globaux se trouvent dans C:\Documents and Settings\[nom
d'utilisateur]\Application Data\Adobe\RoboHTML\[version]\Templates\Tables. Pour Windows
Vista&reg;, les styles de tableau globaux se trouvent dans le r&eacute;pertoire suivant : C:\users\[nom d'utilisateur]\AppData\Roaming\Adobe\RoboHTML\[version]\Templates\Tables.
REMARQUE : M&ecirc;me si vous supprimez le dossier Tableaux situ&eacute; &agrave; l'emplacement indiqu&eacute;, les styles globaux
appara&icirc;tront dans la liste Styles globaux. Vous pouvez toujours les r&eacute;cup&eacute;rer &agrave; l'emplacement suivant :
C:\Program Files\Adobe\Adobe RoboHelp [version]\RoboHTML\Gallery\Tables.
224
CHAPITRE 6
STYLES DE TABLEAU
STYLES ET FEUILLES DE STYLE
Vous pouvez &eacute;galement copier des styles de tableau dans un dossier du projet et les coller &agrave;
l'emplacement suivant : C:\Documents and Settings\[nom d'utilisateur]\Application
Data\Adobe\RoboHTML\[version]\Templates\Tables. Ces styles seront disponibles pour l'ensemble
des projets.
ASTUCE : Pour appliquer un style &agrave; un tableau, cliquez sur l'ic&ocirc;ne Appliquer le style de tableau global
la barre d'outils Tableaux et bordures.
sur
Application de styles de tableau
Pour appliquer un style de tableau &agrave; un tableau existant, proc&eacute;dez comme suit :
1) S&eacute;lectionnez un tableau dans une rubrique.
2) Pour appliquer un style &agrave; un tableau, cliquez sur l'ic&ocirc;ne Appliquer le style de tableau global sur
la barre d'outils Tableaux et bordures.
3) Dans la bo&icirc;te de dialogue S&eacute;lectionner un style de tableau, s&eacute;lectionnez l'option Supprimer la mise
en forme en ligne du tableau. Cette option permet de supprimer tout style en ligne utilis&eacute; dans le
tableau.
4) S&eacute;lectionnez un style dans la liste Styles disponibles ou s&eacute;lectionnez un style de tableau global
(mod&egrave;le de tableau).
5) Cliquez sur OK.
REMARQUE : Vous pouvez cliquer deux fois sur un style dans la bo&icirc;te de dialogue Style de tableau pour
l'appliquer &agrave; un tableau.
Cr&eacute;ation et gestion des styles de tableau
Vous pouvez utiliser des styles de tableau globaux (mod&egrave;les de tableau) et pr&eacute;d&eacute;finis dans les feuilles CSS,
mais aussi cr&eacute;er les v&ocirc;tres, afin de garantir la coh&eacute;rence de la mise en page des tableaux, des bordures,
de l'alignement, des options de trame et des polices. Vous pouvez modifier les caract&eacute;ristiques d&eacute;finies,
comme les couleurs, les polices, le gras, l'italique et les alignements appliqu&eacute;s aux lignes et aux colonnes.
John Daigle effectue une d&eacute;monstration de certains moyens faciles de cr&eacute;er et g&eacute;rer des tableaux et des
styles de tableau.
Cr&eacute;ation de styles de tableau
1)
2)
3)
4)
5)
S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Style et formatage.
Cliquez sur Cr&eacute;er un style et s&eacute;lectionnez Style de tableau.
Saisissez un nom pour le nouveau style de tableau et cliquez sur OK.
Appliquez le format voulu &agrave; l'ensemble du tableau ou &agrave; la premi&egrave;re ou &agrave; la derni&egrave;re colonne ou ligne
ou encore &agrave; un groupe de lignes ou de colonnes. Dans la liste Appliquer le formatage &agrave;, s&eacute;lectionnez
les lignes ou colonnes &agrave; mettre en forme. Vous pouvez par exemple choisir un arri&egrave;re-plan bleu pour
la premi&egrave;re ligne et mettre la premi&egrave;re colonne en jaune.
S&eacute;lectionnez la police, la taille et la couleur.
225
STYLES DE LISTE
STYLES ET FEUILLES DE STYLE
CHAPITRE 6
6)
7)
S&eacute;lectionnez la bordure et sa couleur.
Cliquez sur Appliquer. Le nouveau style appara&icirc;t dans la liste Styles CSS de la bo&icirc;te de dialogue Styles
de tables. S&eacute;lectionnez ce style pour cr&eacute;er des tableaux associ&eacute;s.
Remarques :
•
•
Pour appliquer un style &agrave; un tableau, cliquez sur l'ic&ocirc;ne Appliquer le style de tableau global sur
la barre d'outils Tableaux et bordures.
D'apr&egrave;s la s&eacute;quence de modifications, dans les premi&egrave;re et derni&egrave;re cellules d'une ligne, la couleur
de ligne pr&eacute;vaut sur la couleur de colonne.
L'aspect d'un tableau d&eacute;pend de plusieurs classes, comme le Tableau, le TR et le TD. RoboHelp applique
ces sous-classes &agrave; l'&eacute;l&eacute;ment du tableau respectif lorsque vous appliquez une classe de tableau. Par
cons&eacute;quent, si vous souhaitez modifier un style de tableau par le biais d'un code ou d'un script, r&eacute;digez
un attribut de classe (class=&quot;myTableClass&quot;) dans la balise du tableau. RoboHelp applique tous les
mod&egrave;les de tableau aux &eacute;l&eacute;ments restants dans l'&eacute;diteur de conception.
Application de balises de construction conditionnelles aux tableaux
Les balises de construction conditionnelles permettent d'exclure du contenu de la sortie.
1) S&eacute;lectionnez une ligne, une colonne, un tableau ou du texte dans le tableau.
2) S&eacute;lectionnez Modifier &gt; Balises &gt; Appliquer &gt; Nouveau/Plusieurs.
3) S&eacute;lectionnez des balises. Cliquez sur OK.
6.7.
Styles de liste
A propos des styles de liste
RoboHelp fournit trois types de listes : listes HTML, listes avanc&eacute;es et listes num&eacute;rot&eacute;es
automatiquement. Les listes avanc&eacute;es peuvent pr&eacute;senter un ou plusieurs niveaux. Vous pouvez d&eacute;finir le
style de liste HTML sous l'option Listes et les listes avanc&eacute;es sous l'option Listes multi-niveau. D&eacute;finissez
les listes num&eacute;rot&eacute;es automatiquement sous l'option Styles de paragraphe.
Listes HTML
Toutes les listes ordonn&eacute;es &lt;ol&gt; et non ordonn&eacute;es &lt;ul&gt; sont r&eacute;pertori&eacute;es dans les listes HTML.
Listes avanc&eacute;es
Ce type de liste comprend les styles d'en-t&ecirc;te num&eacute;rot&eacute;s (du type 1, 1.1, 1.1.1, etc.). Comme dans
le cas des listes num&eacute;rot&eacute;es simples, les listes num&eacute;rot&eacute;es hi&eacute;rarchis&eacute;es et les styles de paragraphe
associ&eacute;s partagent une seule et m&ecirc;me mise en forme. Les listes multi-niveaux d&eacute;finissent des
&eacute;tapes int&eacute;gr&eacute;es complexes (&eacute;tapes, r&eacute;sultats d'&eacute;tapes, sous-&eacute;tapes, etc.). Les listes multi-niveaux
d&eacute;finissent uniquement les propri&eacute;t&eacute;s de num&eacute;rotation. Les listes multi-niveaux ne disposent pas
de leur propre formatage jusqu'&agrave; ce qu'elles soient li&eacute;es &agrave; des styles de paragraphe.
226
CHAPITRE 6
STYLES DE LISTE
STYLES ET FEUILLES DE STYLE
Pour consulter un exemple sur la fa&ccedil;on de cr&eacute;er une liste multi-niveau bas&eacute;e sur un style fourni
(mod&egrave;le de liste), voir la section sur la num&eacute;rotation de contour de la visite de RoboHelp de Peter
Grainge.
Listes num&eacute;rot&eacute;es
Les listes num&eacute;rot&eacute;es sont li&eacute;es aux styles de paragraphe. Pour num&eacute;roter un paragraphe
automatiquement, vous pouvez lui appliquer la num&eacute;rotation automatique. Pour num&eacute;roter des
figures ou des tableaux de mani&egrave;re s&eacute;quentielle, d&eacute;finissez un format simple de liste num&eacute;rot&eacute;e,
appel&eacute; par exemple Num&eacute;ros de figure ou Num&eacute;ros de tableau. Dans les listes num&eacute;rot&eacute;es simples,
le style de paragraphe et les styles de num&eacute;rotation partagent la m&ecirc;me police (m&ecirc;me taille, m&ecirc;me
graisse et m&ecirc;me couleur).
Pour visionner une pr&eacute;sentation vid&eacute;o r&eacute;alis&eacute;e par John Daigle, voir M&eacute;thodes de cr&eacute;ation ais&eacute;es de listes
et num&eacute;rotation automatique, &agrave; la page des didacticiels vid&eacute;o Adobe RoboHelp.
Cr&eacute;ation de listes HTML
1)
2)
3)
4)
5)
6)
Cliquez avec le bouton droit de la souris sur l'option Style de liste dans la bo&icirc;te de dialogue Styles.
Cliquez sur Nouveau.
Nommez la nouvelle liste.
S&eacute;lectionnez une police, une taille de police ou une couleur pour le nouveau style de liste.
Cliquez sur le bouton Cr&eacute;er une liste num&eacute;rot&eacute;e pour cr&eacute;er une liste num&eacute;rot&eacute;e ou sur le bouton
Cr&eacute;er une liste &agrave; puces pour cr&eacute;er une liste &agrave; puces.
(Facultatif) S&eacute;lectionnez d'autres options de formatage dans la zone Formatage de l'&eacute;diteur de
style.
REMARQUE : Pour modifier un style de liste, s&eacute;lectionnez d'autres options de formatage dans la zone
Formatage de l'&eacute;diteur de style, puis affichez-en un aper&ccedil;u dans la zone Aper&ccedil;u.
Cr&eacute;ation de listes multi-niveaux
1)
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Dans le conteneur Styles et formatage, cliquez sur le bouton Cr&eacute;er un style et s&eacute;lectionnez
l'option Style de liste multi-niveau. Indiquez ensuite un nom pour cette liste, puis cliquez sur
OK.
–
Cliquez avec le bouton droit de la souris sur un style de liste multi-niveau dans le conteneur
Style et Formatage et s&eacute;lectionnez Modifier.
2)
S&eacute;lectionnez un niveau de liste dans le menu Appliquer le formatage &agrave;. L'option Aper&ccedil;u de la liste
affiche la position hi&eacute;rarchique du niveau s&eacute;lectionn&eacute;.
(Pour les listes multi-niveaux uniquement) S&eacute;lectionnez le style de paragraphe &agrave; appliquer au
niveau de liste actuel.
3)
227
CHAPITRE 6
4)
5)
6)
STYLES DE LISTE
STYLES ET FEUILLES DE STYLE
S&eacute;lectionnez un style de liste pr&eacute;d&eacute;fini dans le menu contextuel Style de liste ou cliquez sur le
bouton Nouveau pour cr&eacute;er un style de liste. Par exemple, vous pouvez disposer d'un style de liste
s&eacute;quentiel de type Mois, puis y ajouter la s&eacute;quence des 12 mois.
Vous pouvez ajouter un pr&eacute;fixe &agrave; une s&eacute;quence ou une liste multi-niveau. Pour ajouter un pr&eacute;fixe &agrave;
un style de liste, saisissez du texte ou des chiffres en pr&eacute;fixe dans le champ Modifier le style. Pour
sp&eacute;cifier le niveau auquel ajouter un pr&eacute;fixe, s&eacute;lectionnez ce niveau dans le menu Ins&eacute;rer un niveau.
Vous pouvez ajouter un pr&eacute;fixe au niveau dans le champ Modifier le style en s&eacute;parant le niveau et
le pr&eacute;fixe &agrave; l'aide d'un s&eacute;parateur, par exemple un point (.) ou un signe sup&eacute;rieur &agrave; (&gt;).
Appliquez une mise en forme au style de liste :
–
Police, taille de police, couleur, couleur de mise en surbrillance et soulignement
–
Retrait de liste, espacement entre le pr&eacute;fixe de la liste et le texte du paragraphe associ&eacute;
Pour plus d'informations sur le comportement de la num&eacute;rotation, le contr&ocirc;le du retrait et de la marge,
ou les formats de pr&eacute;fixe, voir www.adobe.com/go/learn_rh_blog_multilist_fr.
Cr&eacute;ation d'un style avec num&eacute;rotation automatique
La num&eacute;rotation automatique est li&eacute;e aux styles de paragraphe. Vous pouvez appliquer une
num&eacute;rotation automatique &agrave; un style de paragraphe et l'appliquer en tant que style de liste num&eacute;rot&eacute;e.
1) Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez un style de paragraphe dans la bo&icirc;te de dialogue Styles.
–
Cr&eacute;ez un style de paragraphe.
2)
3)
4)
5)
Cliquez sur le bouton Liste num&eacute;rot&eacute;e .
(Facultatif) S&eacute;lectionnez l'option H&eacute;riter la propri&eacute;t&eacute; de num&eacute;rotation de la liste multi-niveau afin
d'h&eacute;riter le style de liste multi-niveau pour appliquer la num&eacute;rotation automatique. S&eacute;lectionnez le
style de liste multi-niveau dans le menu contextuel Classe de liste, puis s&eacute;lectionnez le niveau
auquel appliquer la num&eacute;rotation automatique. Cliquez sur OK.
Indiquez un pr&eacute;fixe pour le nouveau style de num&eacute;rotation automatique dans le champ Format.
S&eacute;lectionnez une option de num&eacute;rotation pr&eacute;d&eacute;finie dans le menu contextuel Num&eacute;rotation ou
s&eacute;lectionnez l'option Nouveau, afin de cr&eacute;er un style de num&eacute;rotation automatique s&eacute;quentielle.
Pour de plus amples informations, voir www.adobe.com/go/learn_rh_blog_autonumber_fr.
Cr&eacute;ation d'un pr&eacute;fixe de s&eacute;quencement
Vous pouvez cr&eacute;er des pr&eacute;fixes de s&eacute;quen&ccedil;age personnalis&eacute;s &agrave; attribuer aux listes avanc&eacute;es.
1) Dans la bo&icirc;te de dialogue Styles, cliquez sur Nouveau.
2) Dans la bo&icirc;te de dialogue Cr&eacute;er/Modifier une s&eacute;quence personnalis&eacute;e, cliquez sur l'ic&ocirc;ne en forme
de signe plus pour cr&eacute;er une s&eacute;quence.
3) Indiquez un nom de s&eacute;quence unique, par exemple Mois, puis cliquez sur le bouton OK.
228
STYLES HTML
STYLES ET FEUILLES DE STYLE
CHAPITRE 6
4)
5)
S&eacute;lectionnez la police de la s&eacute;quence dans le menu contextuel Police de la s&eacute;quence et cliquez sur
Ajouter.
Cliquez sur la bo&icirc;te de dialogue Modifier la s&eacute;quence et indiquez celle de votre choix. Par exemple,
Janvier, F&eacute;vrier, etc. Apr&egrave;s avoir indiqu&eacute; Janvier, cliquez sur Ajouter pour ajouter F&eacute;vrier et ainsi de
suite.
Pour plus d'informations sur le s&eacute;quen&ccedil;age personnalis&eacute;, voir www.adobe.com/go/learn_rh_blog_multilist_fr.
Modification d'un pr&eacute;fixe de s&eacute;quencement
1)
2)
Dans la bo&icirc;te de dialogue Styles, cliquez sur Nouveau.
S&eacute;lectionnez la s&eacute;quence dans le menu contextuel S&eacute;quence et choisissez l'une des proc&eacute;dures
suivantes :
–
Pour apporter des modifications &agrave; une entr&eacute;e de s&eacute;quence, s&eacute;lectionnez-la dans la liste
Modifier la s&eacute;quence et cliquez sur Modifier. Effectuez vos modifications dans la bo&icirc;te de
dialogue Modifier la s&eacute;quence.
–
Pour supprimer une entr&eacute;e de s&eacute;quence, s&eacute;lectionnez-la dans la liste Modifier la s&eacute;quence et
cliquez sur Supprimer.
–
Pour r&eacute;organiser la s&eacute;quence, supprimez les entr&eacute;es et r&eacute;int&eacute;grez-les dans l'ordre voulu.
Suppression d'une s&eacute;quence personnalis&eacute;e
1)
2)
3)
Dans la bo&icirc;te de dialogue Styles, cliquez sur Nouveau.
S&eacute;lectionnez la s&eacute;quence. Cliquez sur le signe plus (+).
Cliquez sur Oui pour confirmer. Cliquez ensuite sur OK.
6.8.
Styles HTML
Vous pouvez modifier les styles Div, Hyperlien et Image en utilisant l'&eacute;diteur Styles ou le conteneur Styles
et formatage. Le style Div peut &ecirc;tre utilis&eacute; pour les zones de texte et les zones de texte positionn&eacute;es. Le
style Hyperlien peut &ecirc;tre utilis&eacute; pour les hyperliens, les zones cliquables d&eacute;roulantes, les zones cliquables
&agrave; d&eacute;velopper et les termes du glossaire. Le style Image peut &ecirc;tre utilis&eacute; pour placer une image.
Cr&eacute;ation de styles en fonction des styles Div, Hyperlien et Image
Vous pouvez cr&eacute;er des styles en fonction de styles disponibles ou modifier les propri&eacute;t&eacute;s des styles existants.
1) Cliquez deux fois sur un fichier CSS dans le conteneur Gestionnaire de projets pour ouvrir l'&eacute;diteur
Styles.
2) S&eacute;lectionnez la cat&eacute;gorie de style dans la liste des styles. Par exemple, s&eacute;lectionnez Hyperlien.
3) Cliquez avec le bouton droit de la souris et s&eacute;lectionnez Nouveau. Nommez le style et d&eacute;finissez les
propri&eacute;t&eacute;s en fonction de vos besoins.
229
CHAPITRE 6
STYLES HTML
STYLES ET FEUILLES DE STYLE
Modification du style Div
Vous pouvez modifier les propri&eacute;t&eacute;s des styles Div dans l'&eacute;diteur Styles ou le conteneur Styles et
formatage. Vous pouvez modifier les attributs de taille, de marge, de mobilit&eacute; et de bordure d'une
division ou d'une partie du texte. Utilisez l'attribut Flotter pour positionner le texte vers la droite ou vers
la gauche de la division. Par exemple, si vous d&eacute;finissez l'attribut Flotter &agrave; gauche, le texte est plac&eacute; sur
la droite.
Utilisez la propri&eacute;t&eacute; D&eacute;bordement pour sp&eacute;cifier ce qui doit se passer si le texte d&eacute;borde dans une
division. Par exemple, si vous attribuez la sp&eacute;cificit&eacute; D&eacute;filement &agrave; la propri&eacute;t&eacute; D&eacute;bordement, une barre
de d&eacute;filement est ajout&eacute;e &agrave; l'affichage du contenu qui d&eacute;borde.
Modification des styles Hyperlien
Vous pouvez modifier les propri&eacute;t&eacute;s des styles Hyperlien dans l'&eacute;diteur Styles ou le conteneur Styles et
formatage.
Utilisation des pseudo-classes
Dans les fichiers CSS, les pseudo-classes sont utilis&eacute;es pour ajouter divers effets &agrave; un hyperlien. Il est ainsi
possible de modifier l'aspect d'un hyperlien en fonction de son &eacute;tat. Par exemple, vous pouvez d&eacute;finir des
propri&eacute;t&eacute;s CSS sp&eacute;cifiques pour un hyperlien qui n'est pas activ&eacute; et un autre jeu de propri&eacute;t&eacute;s CSS pour
un hyperlien activ&eacute;.
Exemples d'utilisation des pseudo-classes :
•
Il ne peut y avoir qu'une seule couleur pour une pseudo-classe Visit&eacute; dans un style (par exemple,
une zone cliquable &agrave; d&eacute;velopper) et une autre couleur pour une pseudo-classe Visit&eacute; dans un autre
style (par exemple, un terme de glossaire).
•
Il peut y avoir plusieurs objets avec plusieurs styles Hyperlien et Div dans la m&ecirc;me rubrique. Deux
hyperliens dans la m&ecirc;me rubrique peuvent avoir des styles diff&eacute;rents.
Pour plus d'informations sur ces pseudo-classes, voir www.w3schools.com/css/css_pseudo_classes.asp.
Utilisation des images Twisty
Vous pouvez ajouter une image Twisty &agrave; un style Hyperlien et appliquer le style &agrave; des zones cliquables &agrave;
d&eacute;velopper, des zones cliquables d&eacute;roulantes et des termes d'un glossaire. Pour d&eacute;finir une image Twisty,
cliquez sur le bouton D&eacute;finir les Twisties, puis s&eacute;lectionnez les propri&eacute;t&eacute;s de l'image.
Utilisation des hyperliens Style de bloc
Vous pouvez ajouter un attribut de bloc &agrave; un style Hyperlien. Les hyperliens style du bloc sont utiles pour
les sorties affich&eacute;es sur des appareils tels qu'iPad ou iPhone.
1) Dans l'&eacute;diteur Styles, s&eacute;lectionnez le style Hyperlien &agrave; modifier.
2) S&eacute;lectionnez Bloc dans la liste d'affichage.
3) Sp&eacute;cifiez la hauteur et la largeur du bloc.
230
APPLICATION DES STYLES
STYLES ET FEUILLES DE STYLE
CHAPITRE 6
Modifications des styles d'images
Vous pouvez modifier les propri&eacute;t&eacute;s des styles Image dans l'&eacute;diteur Styles ou le conteneur Styles et
formatage.
Vous avez la possibilit&eacute; de modifier les attributs Taille, Marge, Flotter et Bordure d'une image.
Utilisez l'attribut Flotter pour positionner une image vers la droite ou vers la gauche, entour&eacute;e du texte
du paragraphe. Par exemple, si vous d&eacute;finissez l'attribut Flotter &agrave; gauche, l'image est plac&eacute;e &agrave; droite et le
texte l'entoure par la gauche.
6.9.
Application des styles
Une fois que vous avez li&eacute; un fichier CSS, une feuille de style externe ou des styles int&eacute;gr&eacute;s &agrave; une rubrique,
vous pouvez appliquer les styles.
1) Dans l'Affichage de la conception, utilisez l'une des m&eacute;thodes suivantes :
–
S&eacute;lectionnez le texte &agrave; formater.
–
Cliquez dans le paragraphe &agrave; mettre en forme. Pour appliquer un style &agrave; plusieurs
paragraphes, s&eacute;lectionnez tous les paragraphes concern&eacute;s.
2)
Dans le conteneur Styles et formatage, cliquez deux fois sur un style.
–
Les styles de caract&egrave;re s'appliquent aux blocs de texte s&eacute;lectionn&eacute;s et affectent les polices et
les effets DHTML du texte.
–
Les styles de paragraphe s'appliquent aux paragraphes entiers et affectent la police,
l'espacement des lignes, la num&eacute;rotation, les bordures et les trames, ainsi que les effets
DHTML du texte.
–
Les styles de tableau portent quant &agrave; eux sur le contenu des tableaux.
–
Les styles de liste s'appliquent &agrave; l'ensemble des styles de puces et de num&eacute;rotation.
–
Les styles de liste multi-niveau s'appliquent aux listes hi&eacute;rarchiques.
ASTUCE : Pour supprimer un style de caract&egrave;re, s&eacute;lectionnez le texte, puis choisissez un autre style dans la
liste des styles. Pour supprimer un style de paragraphe, s&eacute;lectionnez le style Aucun.
6.10. Modification de styles dans les fichiers CSS
Lorsque vous modifiez les styles d'un fichier CSS, toutes les rubriques li&eacute;es au fichier sont mises &agrave; jour.
IMPORTANT : Vous ne pouvez pas utiliser la commande Annuler pour annuler les modifications apport&eacute;es
&agrave; un fichier CSS. Modifiez le fichier CSS pour revenir &agrave; un style pr&eacute;c&eacute;dent.
231
CHAPITRE 6
SUPPRESSION DE STYLES DE FEUILLES DE STYLE
STYLES ET FEUILLES DE STYLE
Modification d'un style via la bo&icirc;te de dialogue Styles
1)
2)
3)
4)
5)
6)
7)
Dans le conteneur Gestionnaire de projets, cliquez avec le bouton droit de la souris sur le
fichier CSS. Cliquez sur le bouton Modifier.
D&eacute;sactivez l'option Masquer les styles h&eacute;rit&eacute;s.
Sous Disponible dans, choisissez une feuille de style.
Dans Styles, s&eacute;lectionnez un style.
Cliquez sur Format et s&eacute;lectionnez les attributs ad&eacute;quats.
(Facultatif) S&eacute;lectionnez des options de mise en forme dans la section Formatage.
Cliquez sur OK.
Modification d'un style via le conteneur Styles et formatage
1)
2)
3)
4)
S&eacute;lectionnez un style dans le conteneur Styles et formatage.
Cliquez sur Modifier l'&eacute;l&eacute;ment s&eacute;lectionn&eacute;.
Dans la bo&icirc;te de dialogue Styles, s&eacute;lectionnez les options de mise en forme.
Cliquez sur OK.
ASTUCE : Pour emp&ecirc;cher l'affichage dans le navigateur d'une couleur d'arri&egrave;re-plan d&eacute;finie par
l'utilisateur, d&eacute;finissez le style de texte d'arri&egrave;re-plan sur du blanc. Ce style concerne le texte de rubrique
normal (en-t&ecirc;tes et paragraphes, par exemple). Il g&egrave;re les param&egrave;tres par d&eacute;faut des images et couleurs
d'arri&egrave;re-plans ainsi que des bordures.
Modification des styles dans un &eacute;diteur HTML
1)
2)
3)
Dans le conteneur Gestionnaire de projets, cliquez avec le bouton droit de la souris sur le
fichier CSS. Cliquez sur Modifier avec.
S&eacute;lectionnez Editeur HTML.
RoboHelp ouvre la feuille de style dans une nouvelle fen&ecirc;tre de rubrique.
Modifiez les styles en fonction de vos besoins.
6.11. Suppression de styles de feuilles de style
1)
2)
3)
4)
Dans le conteneur Gestionnaire de projets, cliquez avec le bouton droit de la souris sur la feuille de
style incluant le style &agrave; supprimer et cliquez sur Modifier.
Si l'option Masquer les styles h&eacute;rit&eacute;s est s&eacute;lectionn&eacute;e, d&eacute;sactivez-la pour afficher les styles
disponibles.
Sous le menu Disponible dans, choisissez une feuille de style. Pour un style int&eacute;gr&eacute;, s&eacute;lectionnez un
nom de rubrique.
Dans le menu Styles, s&eacute;lectionnez le style &agrave; supprimer.
Pour supprimer un formatage personnalis&eacute; d'un style par d&eacute;faut, s&eacute;lectionnez le style.
232
CHAPITRE 6
5)
6)
UTILISATION DES COULEURS ET DES IMAGES
STYLES ET FEUILLES DE STYLE
Cliquez sur Supprimer.
Cliquez sur Oui &agrave; l'invite.
REMARQUE : Pour supprimer un style de la feuille de style ou de la barre d'outils Formatage,
s&eacute;lectionnez Aucun dans le menu Styles.
6.12. Utilisation des couleurs et des images
Modification de la couleur du texte et des liens dans une feuille de style
RoboHelp int&egrave;gre les modifications apport&eacute;es &agrave; un fichier CSS dans chaque rubrique li&eacute;e au fichier CSS.
Vous ne pouvez pas annuler les modifications apport&eacute;es &agrave; un fichier CSS.
A l'aide de l'&eacute;diteur d'habillage WebHelp, vous pouvez modifier la couleur du texte dans la table des
mati&egrave;res, l'index et les panneaux de recherche de WebHelp et WebHelp Pro.
1) Dans le conteneur Gestionnaire de projets, cliquez avec le bouton droit de la souris sur le
fichier CSS. S&eacute;lectionnez Modifier.
2) D&eacute;sactivez l'option Masquer les styles h&eacute;rit&eacute;s.
3) Dans la liste Disponible dans, choisissez un fichier CSS.
4) Dans la bo&icirc;te de dialogue Styles, s&eacute;lectionnez Caract&egrave;re.
5) D&eacute;veloppez Style de caract&egrave;re et s&eacute;lectionnez un style de lien ou de texte dans les options
disponibles, parmi lesquelles :
Arri&egrave;re-plan + Texte (Corps)
Dans la feuille de style par d&eacute;faut, il s'agit du texte du corps du document (texte normal). Ce style
s'applique au texte, aux tableaux et aux en-t&ecirc;tes de rubrique. Il g&egrave;re &eacute;galement les param&egrave;tres par
d&eacute;faut des images et couleurs d'arri&egrave;re-plans ainsi que des bordures.
Lien hypertexte (non visit&eacute;)
Un lien hypertexte non visit&eacute;.
Lien hypertexte (visit&eacute;)
Un lien hypertexte visit&eacute;.
Lien hypertexte (actif)
Lien hypertexte s&eacute;lectionn&eacute;.
6)
7)
S&eacute;lectionnez Modifier &gt; Caract&egrave;re &gt; Formatage de caract&egrave;res &gt; Police.
Sous Couleur de la police, s&eacute;lectionnez une couleur. Cliquez sur OK.
LIENS CONNEXES :
Cr&eacute;ation de styles pour des feuilles de style
Habillages
233
CHAPITRE 6
STYLES EN LIGNE
STYLES ET FEUILLES DE STYLE
Ajout ou modification des bordures ou des arri&egrave;re-plans dans les feuilles de style
1)
2)
3)
4)
5)
6)
Dans le conteneur Gestionnaire de projets, cliquez avec le bouton droit de la souris sur la feuille de
style dans laquelle vous souhaitez modifier les bordures ou l'arri&egrave;re-plan et s&eacute;lectionnez Modifier.
D&eacute;sactivez l'option Masquer les styles h&eacute;rit&eacute;s.
Dans la liste Disponible dans, choisissez un fichier CSS.
Dans l'option Autre de la bo&icirc;te de dialogue Styles, s&eacute;lectionnez Arri&egrave;re-plan + Texte (Corps).
S&eacute;lectionnez Format, puis Bordures et trame.
Cliquez sur l'onglet de ce nom, d&eacute;finissez les bordures ou l'arri&egrave;re-plan et cliquez sur OK.
REMARQUE : Tout fichier image utilis&eacute; pour les bordures ou les arri&egrave;re-plans est ajout&eacute; au dossier Fichiers
bagage du projet et inclus dans le r&eacute;sultat g&eacute;n&eacute;r&eacute;.
LIENS CONNEXES :
Ajout ou modification de bordures et d'arri&egrave;re-plans de rubriques
6.13. Styles en ligne
Application ou modification des styles en ligne
1)
2)
Dans l'&eacute;diteur de conception, s&eacute;lectionnez le bloc de texte &agrave; formater.
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez une option de formatage dans la barre d'outils.
–
Dans le ruban Edition, s&eacute;lectionnez la mise en forme ad&eacute;quate pour les options Police,
Paragraphe, Puces et num&eacute;rotation, Bordures et trame ou Bordures et trame de la rubrique.
Mettre &agrave; jour les styles en ligne
Vous pouvez modifier le formatage d'un style de caract&egrave;re ou de paragraphe puis mettre &agrave; jour tous les
caract&egrave;res ou paragraphes de votre projet auxquels le m&ecirc;me style est appliqu&eacute;.
1) S&eacute;lectionnez un fragment de texte ou de paragraphe du style que vous souhaitez mettre &agrave; jour.
2) Dans le ruban Edition, utilisez les diff&eacute;rents formatages de caract&egrave;res ou de paragraphes pour
modifier le style.
3) S&eacute;lectionnez Modifier &gt; Styles &gt; Mettre &agrave; jour le style .
Le formatage du contenu auquel le style s&eacute;lectionn&eacute; est appliqu&eacute; est mis &agrave; jour dans toutes les rubriques
du projet.
234
CHAPITRE 6
R&Eacute;INITIALISATION DES STYLES
STYLES ET FEUILLES DE STYLE
Suppression de styles en ligne du texte
1)
2)
Dans l'&eacute;diteur de conception, s&eacute;lectionnez le bloc de texte avec le style en ligne.
Sur la barre d'outils, cliquez sur le menu Options en regard de la bo&icirc;te de dialogue Styles.
Menu Options
3)
S&eacute;lectionnez Police de paragraphe par d&eacute;faut.
6.14. R&eacute;initialisation des styles
Chaque cat&eacute;gorie de style dans le conteneur Styles et formatage dispose d'une option appel&eacute;e
(R&eacute;initialiser le style). Si vous souhaitez supprimer toutes les mises en forme appliqu&eacute;es par un style dans
une cat&eacute;gorie de style d'un contenu s&eacute;lectionn&eacute;, suivez les &eacute;tapes ci-apr&egrave;s :
1) S&eacute;lectionnez la cat&eacute;gorie de style dans la liste de styles du conteneur Styles et formatage.
Par exemple, s&eacute;lectionnez Style de tableau.
2) Cliquez deux fois sur R&eacute;initialiser le style. (Vous pouvez &eacute;galement cliquer avec le bouton droit de
la souris sur R&eacute;initialiser le style, puis cliquez sur Appliquer.)
Par exemple (R&eacute;initialiser un style de tableau)
L'exemple suivant illustre comment un style de tableau est r&eacute;initialis&eacute;.
Exemple de tableau avec application d'un style
235
CHAPITRE 6
SUPPRESSION DU FORMATAGE
STYLES ET FEUILLES DE STYLE
Formatage en ligne ajout&eacute; aux en-t&ecirc;tes. Aucun formatage en ligne n'a &eacute;t&eacute; appliqu&eacute; &agrave; l'ensemble du tableau, des lignes
s&eacute;lectionn&eacute;es ou des cellules (RoboHelp tient compte de ces s&eacute;lections en tant qu'&eacute;l&eacute;ments de tableau et supprime la
mise en forme en ligne appliqu&eacute;e &agrave; ces &eacute;l&eacute;ments lorsque vous r&eacute;initialisez un style de tableau (tout comme la fonction
Nettoyer la mise en forme en ligne du tableau dans la bo&icirc;te de dialogue S&eacute;lectionner un style de tableau).
Apr&egrave;s avoir appliqu&eacute; R&eacute;initialiser le style, le style de tableau est supprim&eacute;. Le formatage en ligne des en-t&ecirc;tes (&eacute;l&eacute;ment
n'appartenant pas au tableau) est conserv&eacute;.
6.15. Suppression du formatage
Pour supprimer tous les styles et le formatage d'une s&eacute;lection dans l'&eacute;diteur de conception :
•
Dans la section Caract&egrave;re de l'onglet Edition, s&eacute;lectionnez Effacer le formatage.
ASTUCE : Pour effacer le formatage d'un paragraphe, placez le curseur dans le paragraphe et cliquez sur
Effacer le formatage.
236
TABLES DES MATI&Egrave;RES
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
CHAPITRE 7
7.
Tables des mati&egrave;res, index et glossaires
7.1.
Tables des mati&egrave;res
El&eacute;ments de base sur les tables des mati&egrave;res
A propos des tables des mati&egrave;res
La table des mati&egrave;res comprend une organisation hi&eacute;rarchis&eacute;e des dossiers, rubriques et sous-dossiers
&eacute;ventuels du gestionnaire de projets. RoboHelp cr&eacute;e des livres &agrave; partir des dossiers personnalis&eacute;s et des
pages &agrave; partir des rubriques contenues dans ces dossiers. Toute rubrique non enregistr&eacute;e dans les
dossiers personnalis&eacute;s s'affiche en tant que page de premier niveau de la table des mati&egrave;res.
Vous pouvez r&eacute;organiser les livres et les pages une fois la table des mati&egrave;res cr&eacute;&eacute;e.
Cr&eacute;ation de tables des mati&egrave;res
Cr&eacute;ez automatiquement une table des mati&egrave;res en fonction de la mise en page des chapitres d&eacute;finie dans
le conteneur Gestionnaire de projets.
1) Dans le Gestionnaire de projets, cliquez avec le bouton droit sur le dossier Table des mati&egrave;res, puis
s&eacute;lectionnez Nouvelle Table des mati&egrave;res.
ASTUCE : Si le projet poss&egrave;de de nombreuses rubriques, r&eacute;duisez d'abord le dossier Fichiers de projet
pour afficher le dossier Table des mati&egrave;res.
2) Sp&eacute;cifiez un nom pour la table des mati&egrave;res.
3) (Facultatif) S&eacute;lectionnez Copier une table des mati&egrave;res existante et acc&eacute;dez &agrave; un fichier de table des
mati&egrave;res existant (fichier .hhc), afin de cr&eacute;er la table des mati&egrave;res &agrave; partir d'une table des mati&egrave;res
disponible.
4) Cliquez sur OK. RoboHelp ouvre le conteneur Table des mati&egrave;res.
5) Dans le conteneur Table des mati&egrave;res, cliquez sur le bouton Cr&eacute;er automatiquement la table des
mati&egrave;res .
6) S&eacute;lectionnez une des options de cette bo&icirc;te de dialogue :
Supprimer la table des mati&egrave;res actuelle avant d'en cr&eacute;er une nouvelle
Les livres et pages sont supprim&eacute;s, puis la table des mati&egrave;res est automatiquement cr&eacute;&eacute;e. Si cette
option est d&eacute;s&eacute;lectionn&eacute;e, les livres et pages existants sont inclus dans la table des mati&egrave;res.
Cr&eacute;er les pages de la table des mati&egrave;res pour les liens de rubrique interm&eacute;diaire (signets)
Cr&eacute;e des pages dans la table des mati&egrave;res, en fonction des signets. RoboHelp convertit la rubrique
contenant le signet en livre et tous les signets en pages.
7)
Cliquez sur OK.
237
CHAPITRE 7
TABLES DES MATI&Egrave;RES
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
REMARQUE : Dans les projets Microsoft HTML Help, la table des mati&egrave;res peut &ecirc;tre synchronis&eacute;e dans les
propri&eacute;t&eacute;s de la fen&ecirc;tre. Les noms de dossiers et de fichiers (y compris ceux des rubriques) pourront
contenir des caract&egrave;res de soulignement, mais aucun espace.
LIENS CONNEXES :
R&eacute;organisation des livres et des pages d'une table des mati&egrave;res
D&eacute;finir la mise en page des chapitres
Impression des tables des mati&egrave;res
1)
2)
3)
Cliquez sur le conteneur Table des mati&egrave;res.
Sur la barre d'outils, cliquez sur Imprimer.
Dans le menu contextuel, s&eacute;lectionnez les informations &agrave; imprimer.
Pr&eacute;sentation
Imprimez tous les titres de livres et de pages.
D&eacute;tails
Permet d'imprimer tous les titres de livres et de pages, les liens vers les titres de rubriques et les
dossiers dans lesquels se trouvent les rubriques.
4)
Cliquez sur Propri&eacute;t&eacute;s, puis sur Configuration de la page pour sp&eacute;cifier les options d'impression.
Cr&eacute;ation de livres et de pages de table des mati&egrave;res
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
Cr&eacute;ation de livres de table des mati&egrave;res
1)
2)
3)
4)
Ouvrez le conteneur Table des mati&egrave;res en cliquant deux fois sur la table des mati&egrave;res requise dans
le Gestionnaire de projets.
Sur la barre d'outils, cliquez sur le bouton Nouveau livre de table des mati&egrave;res .
Dans la bo&icirc;te de dialogue Titre du livre, saisissez le nom &agrave; afficher dans la table des mati&egrave;res.
Cliquez sur OK.
REMARQUE : Un livre doit comprendre au moins une page pour pouvoir appara&icirc;tre dans la sortie.
Cr&eacute;ation de livres et de pages de table des mati&egrave;res avec liens cibl&eacute;s
Vous pouvez lier des livres et des pages d'une table des mati&egrave;res &agrave; du contenu sp&eacute;cifi&eacute;. Lorsqu'un
utilisateur clique sur une ic&ocirc;ne de livre ou de page, le contenu li&eacute; appara&icirc;t dans le volet Rubrique. Vous
pouvez cr&eacute;er des liens vers des rubriques, des sites Web, etc.
1) Dans le conteneur Table des mati&egrave;res, effectuez l'une des op&eacute;rations suivantes :
–
Cliquez sur Nouveau livre de table des mati&egrave;res . S&eacute;lectionnez l'option Livre avec lien.
–
Cliquez sur le bouton Nouvelle page de table des mati&egrave;res .
238
CHAPITRE 7
TABLES DES MATI&Egrave;RES
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
2)
Sous Destination du livre (ou de la page), sp&eacute;cifiez une destination :
–
S&eacute;lectionnez un &eacute;l&eacute;ment dans la liste. Au besoin, s&eacute;lectionnez-le dans le menu contextuel et
acc&eacute;dez &agrave; l'&eacute;l&eacute;ment. Vous pouvez &eacute;tablir des liens vers des &eacute;l&eacute;ments dans d'autres projets.
–
Pour cr&eacute;er une rubrique, cliquez sur Nouvelle rubrique. Inscrivez un titre, modifiez le nom du
fichier le cas &eacute;ch&eacute;ant, puis s&eacute;lectionnez une page principale. Associez-lui un livre ou une page.
3)
Cliquez sur OK.
Cr&eacute;ation de livres de table des mati&egrave;res &agrave; partir de pages
1)
2)
Dans le conteneur Table des mati&egrave;res, cliquez avec le bouton droit de la souris sur une page.
S&eacute;lectionnez Cr&eacute;er un livre &agrave; partir de la page.
Le livre cr&eacute;&eacute; porte le m&ecirc;me titre que la page. La page est ins&eacute;r&eacute;e dans le nouveau livre.
Cr&eacute;ation de pages de table des mati&egrave;res en faisant glisser les rubriques
1)
2)
3)
Ouvrez le conteneur Table des mati&egrave;res et le conteneur Liste des rubriques.
S&eacute;lectionnez une ou plusieurs rubriques dans le conteneur Liste des rubriques.
Faites glisser les rubriques dans le conteneur Table des mati&egrave;res.
REMARQUE : Les titres des rubriques que vous faites glisser dans le conteneur Table des mati&egrave;res sont
inchang&eacute;s. Pour changer un titre de rubrique, cliquez dessus avec le bouton droit de la souris, puis
s&eacute;lectionnez Renommer.
Cr&eacute;ation de livres et de pages de table des mati&egrave;res avec des variables d&eacute;finies par l'utilisateur
1)
2)
3)
4)
5)
Dans le conteneur Table des mati&egrave;res, cliquez avec le bouton droit de la souris et s&eacute;lectionnez
Nouveau &gt; Livre ou page.
Dans le menu Variables disponibles, s&eacute;lectionnez une variable. Cliquez sur Ajouter. La variable
appara&icirc;t dans la zone Titre de la page.
(Facultatif) Dans la bo&icirc;te de dialogue Titre de la page, ajoutez un pr&eacute;fixe ou un suffixe &agrave; la variable.
Ajoutez par exemple le pr&eacute;fixe &laquo; Adobe &raquo; &agrave; la variable &laquo; RoboHelp &raquo;.
Dans la liste Rubriques existantes, s&eacute;lectionnez une rubrique pour la nouvelle page.
Cliquez sur OK. Le livre ou la page appara&icirc;t dans la table des mati&egrave;res. Son titre affiche la variable
d&eacute;finie par l'utilisateur avec le texte que vous avez ajout&eacute;.
ASTUCE : Pour afficher ou modifier la variable appliqu&eacute;e &agrave; un &eacute;l&eacute;ment de table des mati&egrave;res, cliquez avec
le bouton droit de la souris sur l'&eacute;l&eacute;ment et s&eacute;lectionnez Propri&eacute;t&eacute;s.
239
CHAPITRE 7
TABLES DES MATI&Egrave;RES
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
Edition de livres et de pages de table des mati&egrave;res
Modification du nom des livres et des pages de table des mati&egrave;res
REMARQUE : Le fait de renommer une page de table des mati&egrave;res n'affecte pas le titre de la rubrique qui
lui est associ&eacute;e. De la m&ecirc;me mani&egrave;re, le nom de la page de la table des mati&egrave;res ne sera pas affect&eacute; si
vous changez le titre d'une rubrique. Renommez s&eacute;par&eacute;ment la page de table des mati&egrave;res, le cas
&eacute;ch&eacute;ant.
1) Dans le conteneur Table des mati&egrave;res, cliquez avec le bouton droit de la souris sur un livre ou sur
une page. S&eacute;lectionnez Renommer.
2) Tapez le nouveau nom. Appuyez sur Entr&eacute;e.
ASTUCE : Vous pouvez &eacute;galement renommer un livre ou une page en modifiant ses propri&eacute;t&eacute;s.
R&eacute;organisation des livres et des pages d'une table des mati&egrave;res
1)
2)
Dans le conteneur Table des mati&egrave;res, s&eacute;lectionnez un livre ou une page.
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Faites glisser l'&eacute;l&eacute;ment vers un emplacement diff&eacute;rent.
–
Cliquez sur les fl&egrave;ches de la barre d'outils pour d&eacute;placer l'&eacute;l&eacute;ment.
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
Suppression de livres ou de pages de table des mati&egrave;res
La suppression d'une page de la table des mati&egrave;res ne supprime pas la rubrique &agrave; laquelle elle est li&eacute;e.
1) Dans le conteneur Table des mati&egrave;res, s&eacute;lectionnez une ic&ocirc;ne de livre ou de page.
2) Sur la barre d'outils, cliquez sur le bouton Supprimer.
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
Modification des propri&eacute;t&eacute;s de livres et de pages de table des mati&egrave;res
Modifiez le nom d'un livre ou d'une page, modifiez une destination ou un cadre de fen&ecirc;tre ou
personnalisez une ic&ocirc;ne.
1) Dans le conteneur Table des mati&egrave;res, cliquez avec le bouton droit de la souris sur un livre ou sur
une page. S&eacute;lectionnez Propri&eacute;t&eacute;s.
2) Effectuez des modifications dans les onglets G&eacute;n&eacute;ralit&eacute;s et Avanc&eacute;.
REMARQUE : La mise en page principale contr&ocirc;le les propri&eacute;t&eacute;s des livres et des pages. Par exemple,
vous pouvez ajouter des ic&ocirc;nes personnalis&eacute;es pour les livres et les pages uniquement si la mise en
page principale est Microsoft HTML Help.
3) Cliquez sur OK.
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
240
CHAPITRE 7
TABLES DES MATI&Egrave;RES
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
Gestion des tables des mati&egrave;res
Gestion de tables de mati&egrave;res via des rapports
RoboHelp fournit plusieurs rapports permettant de g&eacute;rer les tables des mati&egrave;res et de corriger les erreurs.
1) S&eacute;lectionnez Outils &gt; Rapports &gt; [nom du rapport].
Vous pouvez enregistrer, imprimer, copier et envoyer des rapports par e-mail.
Rapport sur la table des mati&egrave;res
Il affiche la hi&eacute;rarchie des livres et des pages contenus dans la table des mati&egrave;res. Vous pouvez afficher
seulement une partie de la table des mati&egrave;res en s&eacute;lectionnant un dossier sp&eacute;cifique dans la liste des
dossiers. Si vous modifiez des titres de rubrique ou des noms de fichier, vous pouvez les comparer avec
les titres des pages et des livres.
Choisissez parmi les formats de rapport ci-dessous.
D&eacute;tails
Inclut les titres des livres et pages, les noms des rubriques li&eacute;es et ceux des dossiers dans lesquels
les fichiers r&eacute;sident.
Pr&eacute;sentation
Inclut les titres des livres et des pages ainsi que les noms des rubriques li&eacute;es.
ASTUCE : Ce rapport peut servir de structure de projet.
Rapport sur les propri&eacute;t&eacute;s de rubriques
Personnalisez ce rapport pour afficher les &eacute;l&eacute;ments suivants au choix :
•
Titres de rubrique
•
Noms de fichier
•
Noms des dossiers
•
Livres et pages faisant r&eacute;f&eacute;rence &agrave; des rubriques
Rapport sur les r&eacute;f&eacute;rences de rubriques
Ce rapport r&eacute;pertorie les r&eacute;f&eacute;rences aux rubriques d'un projet, y compris les livres et les pages de la table
des mati&egrave;res li&eacute;es &agrave; des rubriques.
Rapport sur les rubriques non r&eacute;f&eacute;renc&eacute;es
Ce rapport r&eacute;pertorie les rubriques d'un projet qui ne sont pas utilis&eacute;es par la table des mati&egrave;res, l'index
ou les composants de navigation.
Rapport sur les liens rompus
Ce rapport affiche les liens rompus dans un projet. Ils sont regroup&eacute;s par fichier.
241
CHAPITRE 7
TABLES DES MATI&Egrave;RES
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
Identification et r&eacute;paration des liens rompus dans une table des mati&egrave;res
Un X rouge signale les liens rompus &eacute;ventuels des livres ou des pages dans le conteneur Table des
mati&egrave;res.
1) S&eacute;lectionnez Projet &gt; Navigation &gt; Liens rompus.
R&eacute;f&eacute;rences de la rubrique s&eacute;lectionn&eacute;e
Affiche toutes les r&eacute;f&eacute;rences de la rubrique manquante. L'ic&ocirc;ne de livre ouvert
r&eacute;f&eacute;rences dont les liens vers la table des mati&egrave;res ont &eacute;t&eacute; rompus.
indique des
Toutes les rubriques manquantes
Affiche les rubriques manquantes dans le projet.
2)
Pour supprimer un &eacute;l&eacute;ment de table des mati&egrave;res, s&eacute;lectionnez-le sous R&eacute;f&eacute;rences de la rubrique
s&eacute;lectionn&eacute;e, puis cliquez sur Supprimer.
LIENS CONNEXES :
R&eacute;paration de liens rompus
Tables des mati&egrave;res multiples
A propos de la cr&eacute;ation de plusieurs tables des mati&egrave;res
Vous pouvez cr&eacute;er plusieurs tables des mati&egrave;res pour un m&ecirc;me projet. Vous pouvez utiliser cette
fonctionnalit&eacute; pour la publication de source unique. Vous pouvez par exemple cr&eacute;er des tables des
mati&egrave;res s&eacute;par&eacute;es pour un projet contenant plusieurs langues ou types de sorties, pour diff&eacute;rents types
de public.
REMARQUE : Pour d&eacute;finir une table des mati&egrave;res comme &eacute;tant par d&eacute;faut, cliquez dessus avec le bouton
droit de la souris dans le conteneur Gestionnaire de projets, puis s&eacute;lectionnez D&eacute;finir par d&eacute;faut.
Si vous fusionnez des sous-projets dans un projet ma&icirc;tre, les tables des mati&egrave;res des sous-projets sont
disponibles dans le projet ma&icirc;tre.
D&eacute;placement de livres et de pages vers les tables des mati&egrave;res
1)
2)
Dans le conteneur Gestionnaire de projets, cliquez deux fois sur la table des mati&egrave;res de votre choix
dans le dossier Table des mati&egrave;res.
Faites glisser des livres et des pages d'un conteneur Table des mati&egrave;res &agrave; un autre.
242
CHAPITRE 7
TABLES DES MATI&Egrave;RES
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
Cr&eacute;ation de plusieurs tables des mati&egrave;res pour un projet
1)
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Dans le conteneur Gestionnaire de projets, cliquez avec le bouton droit de la souris sur le
dossier Table des mati&egrave;res. S&eacute;lectionnez Nouvelle table des mati&egrave;res.
–
Cliquez sur le bouton Cr&eacute;er/Afficher la table des mati&egrave;res . Dans la bo&icirc;te de dialogue
S&eacute;lectionner la table des mati&egrave;res, cliquez sur Nouveau.
2)
3)
Saisissez un nom.
(Facultatif) Pour donner une base &agrave; la nouvelle table des mati&egrave;res, s&eacute;lectionnez Copier une table
des mati&egrave;res existante. Cliquez sur le bouton Parcourir pour rechercher le fichier HHC dans le
dossier du projet, puis s&eacute;lectionnez-le.
Cliquez sur OK.
4)
Par d&eacute;faut, une table des mati&egrave;res vide portant le nom du projet s'affiche dans le dossier Table des
mati&egrave;res.
REMARQUE : Cliquez sur le bouton Cr&eacute;er automatiquement la table des mati&egrave;res
pour cr&eacute;er
automatiquement une table des mati&egrave;res.
Fusion de tables des mati&egrave;res
Suivez cette proc&eacute;dure pour fusionner les tables des mati&egrave;res au sein d'un projet.
1) Dans le conteneur Table des mati&egrave;res, s&eacute;lectionnez le livre ou la page o&ugrave; vous souhaitez fusionner
la table des mati&egrave;res.
2) Cliquez sur le bouton Ins&eacute;rer un espace r&eacute;serv&eacute; pour la table des mati&egrave;res . La bo&icirc;te de dialogue
Ins&eacute;rer un espace r&eacute;serv&eacute; pour la table des mati&egrave;res s'affiche.
3) Dans le menu S&eacute;lectionner la table des mati&egrave;res, s&eacute;lectionnez la table des mati&egrave;res &agrave; fusionner.
4) Cliquez sur OK.
Lorsque vous g&eacute;n&eacute;rez une mise en page, s&eacute;lectionnez la table des mati&egrave;res fusionn&eacute;e dans la liste de
l'&eacute;cran de mise en page de l'assistant. La table des mati&egrave;res s&eacute;lectionn&eacute;e s'affiche dans la vue Sortie de
l'aide.
LIENS CONNEXES :
Fusion de projets d'aide
Cr&eacute;ation de s&eacute;quences de navigation &agrave; partir d'une table des mati&egrave;res
Vous pouvez utiliser plusieurs tables des mati&egrave;res pour g&eacute;n&eacute;rer des s&eacute;quences de navigation.
1) S&eacute;lectionnez Projet &gt; Navigation &gt; Editeur de s&eacute;quence de navigation.
2) Cliquez sur Cr&eacute;er automatiquement &agrave; l'aide de la table des mati&egrave;res.
La bo&icirc;te de dialogue Cr&eacute;er automatiquement la s&eacute;quence de navigation &agrave; l'aide de la table des
mati&egrave;res vous permet de s&eacute;lectionner l'une des options suivantes :
243
INDEX
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
CHAPITRE 7
Cr&eacute;er une s&eacute;quence avec la table des mati&egrave;res telle quelle :
Par d&eacute;faut. Cr&eacute;er une s&eacute;quence de navigation bas&eacute;e sur la table des mati&egrave;res. Utilisez cette option
s'il existe un nombre limit&eacute; d'entr&eacute;es dans la table des mati&egrave;res.
Cr&eacute;er une s&eacute;quence distincte pour chaque livre jusqu'au niveau :
S&eacute;lectionnez cette option et indiquez le niveau le plus profond &agrave; mettre en s&eacute;quence dans la table
des mati&egrave;res.
3)
S&eacute;lectionnez le type de table des mati&egrave;res dans la liste d&eacute;roulante S&eacute;lectionner la table des
mati&egrave;res :
–
All-Test
–
CSH
–
Developers
–
EPUB
–
Feature Topics
–
HTML5-CSH
–
Salesbuilder (par d&eacute;faut)
4)
Cliquez sur OK pour appliquer les modifications.
7.2.
Index
El&eacute;ments de bases de l'index
A propos des index et des mots-cl&eacute;s
Cr&eacute;ez un index en ajoutant des mots-cl&eacute;s et en les associant &agrave; des rubriques. Vous pouvez v&eacute;rifier
l'orthographe d'un index et utiliser des listes d'actions &agrave; faire des rubriques pour effectuer un suivi de
votre travail au cours de l'indexation. Modifiez la mise en majuscules des mots-cl&eacute;s dans le conteneur
Index.
L'index peut inclure plusieurs niveaux de mots-cl&eacute;s et de r&eacute;f&eacute;rences crois&eacute;es &agrave; d'autres mots-cl&eacute;s. Les
mots-cl&eacute;s secondaires peuvent &ecirc;tre r&eacute;pertori&eacute;s sous un mot-cl&eacute; principal ou dans une fen&ecirc;tre Rubriques
trouv&eacute;es. Si un mot-cl&eacute; parent est reli&eacute; &agrave; plus de deux rubriques, des mots-cl&eacute;s secondaires sont
n&eacute;cessaires.
244
CHAPITRE 7
INDEX
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
Mots-cl&eacute;s de rubrique
Les mots-cl&eacute;s de rubrique s'affichent de la m&ecirc;me fa&ccedil;on que les mots-cl&eacute;s de fichiers d'index (HHK), mais
ils sont stock&eacute;s dans des rubriques HTML individuelles. Le concepteur d'index identifie un mot-cl&eacute; de
rubrique par une ic&ocirc;ne de cl&eacute;/page .
Lorsque vous travaillez avec des mots-cl&eacute;s de rubrique, soyez attentif aux points ci-dessous.
•
Lorsque vous importez des rubriques dans un projet, tous leurs mots-cl&eacute;s sont ajout&eacute;s &agrave; l'index.
•
Vous pouvez copier des mots-cl&eacute;s de rubrique dans d'autres rubriques et cr&eacute;er des mots-cl&eacute;s de
fichiers d'index &agrave; partir de ceux-ci.
•
Vous pouvez les utiliser avec les commandes Lien de mot-cl&eacute;.
•
Si vous supprimez une rubrique du projet, les mots-cl&eacute;s associ&eacute;s sont conserv&eacute;s dans l'index en
caract&egrave;res gras (indiquant qu'ils ne sont associ&eacute;s &agrave; aucune rubrique). Les mots-cl&eacute;s ne s'affichent
pas dans l'index tant que vous ne les associez pas &agrave; d'autres rubriques.
•
Les mots-cl&eacute;s de rubrique ne peuvent &ecirc;tre associ&eacute;s qu'&agrave; des rubriques HTML locales. La rubrique ne
peut s'afficher que dans la fen&ecirc;tre d'aide par d&eacute;faut.
•
Les mots-cl&eacute;s de rubrique ne peuvent pas faire de r&eacute;f&eacute;rence crois&eacute;e (&ecirc;tre li&eacute;s) &agrave; d'autres mots-cl&eacute;s
de l'index. Cr&eacute;ez la r&eacute;f&eacute;rence crois&eacute;e &agrave; l'aide d'un mot-cl&eacute; de fichier d'index.
•
Les mots-cl&eacute;s de rubrique sont class&eacute;s dans l'index par ordre alphab&eacute;tique. Il n'est pas possible de
classer les mots-cl&eacute;s diff&eacute;remment.
Informations suppl&eacute;mentaires sur les projets HTML Help
•
•
Vous pouvez fusionner dans un projet ma&icirc;tre des mots-cl&eacute;s de rubrique issus de plusieurs fichiers
CHM.
Si vous ajoutez des contr&ocirc;les d'index aux rubriques, le fichier d'index (HHK) du contr&ocirc;le n'affiche
que des mots-cl&eacute;s de fichier d'index.
Informations suppl&eacute;mentaires sur les projets WinHelp
•
Lorsque vous convertissez un fichier de projet WinHelp (HPJ) en fichier de projet RoboHelp, les
mots-cl&eacute;s des rubriques WinHelp sont enregistr&eacute;s en tant que mots-cl&eacute;s dans le fichier d'index.
Mots-cl&eacute;s du fichier d'index
Les mots-cl&eacute;s du fichier d'index sont enregistr&eacute;s dans le fichier d'index du projet (HHK) plut&ocirc;t que dans
le code des rubriques HTML. Le concepteur d'index identifie les mots-cl&eacute;s de fichier d'index par une ic&ocirc;ne
de cl&eacute; . Vous pouvez cr&eacute;er et g&eacute;rer plusieurs index pour un projet.
Lorsque vous travaillez avec des mots-cl&eacute;s de fichier d'index, soyez attentif aux points ci-dessous.
•
Vous pouvez utiliser des mots-cl&eacute;s de fichier d'index avec tous les types de sorties et contr&ocirc;les de
liens de mots-cl&eacute;s pris en charge.
•
Les mots-cl&eacute;s du fichier d'index peuvent &eacute;tablir des r&eacute;f&eacute;rences crois&eacute;es (&ecirc;tre li&eacute;s) &agrave; d'autres
mots-cl&eacute;s de fichier d'index.
•
Les mots-cl&eacute;s du fichier d'index peuvent &ecirc;tre li&eacute;s &agrave; des rubriques HTML locales, &agrave; des fichiers
multim&eacute;dia, &agrave; des fichiers bagage et &agrave; des URL. Selon le format d'aide, une rubrique peut s'afficher
dans la fen&ecirc;tre d'aide par d&eacute;faut, une fen&ecirc;tre personnalis&eacute;e ou un cadre.
245
CHAPITRE 7
•
•
•
•
•
•
INDEX
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
Si vous ne cr&eacute;ez pas un index binaire et si le projet ne contient pas de mots-cl&eacute;s de rubrique, vous
pouvez classer les mots-cl&eacute;s dans l'ordre de votre choix.
Lorsque vous supprimez une rubrique du projet, les mots-cl&eacute;s du fichier de l'index restent dans
l'index si d'autres rubriques y font appel. Vous pouvez supprimer ou conserver les mots-cl&eacute;s, que
d'autres rubriques les utilisent ou non.
Vous pouvez fusionner les fichiers d'index avec d'autres projets. Des index binaires sont n&eacute;cessaires
pour fusionner les projets HTML Help. Les mots-cl&eacute;s des index binaires sont exclusivement class&eacute;s
par ordre alphab&eacute;tique.
Si vous importez des rubriques dans un projet, vous devez affecter des mots-cl&eacute;s de fichier d'index
s&eacute;par&eacute;ment. Les mots-cl&eacute;s du fichier d'index ne sont pas inclus aux rubriques, contrairement aux
mots-cl&eacute;s de rubrique.
Lorsque vous supprimez un mot-cl&eacute; de fichier d'index d'un index, il est &eacute;galement supprim&eacute; des
rubriques auxquelles il &eacute;tait affect&eacute;.
Si vous supprimez une rubrique d'un projet sans pour autant supprimer les r&eacute;f&eacute;rences aux mots-cl&eacute;s
de fichier d'index qu'elle utilise, les mots-cl&eacute;s sont marqu&eacute;s comme &eacute;tant inutilis&eacute;s (Exception : si
d'autres rubriques les utilisent.) Si ces mots-cl&eacute;s ne sont pas utilis&eacute;s par d'autres mots-cl&eacute;s, le projet
inclut les liens rompus.
D&eacute;finition des types de mots-cl&eacute;s utilis&eacute;s dans un projet
Un projet peut inclure des mots-cl&eacute;s de fichier d'index et/ou de rubrique. Pour choisir le type de mot-cl&eacute;
&agrave; utiliser, modifiez les param&egrave;tres du projet.
1) S&eacute;lectionnez Projet &gt; Param&egrave;tres du projet.
2) Cliquez sur l'onglet G&eacute;n&eacute;ral.
3) Dans Ajouter de nouveaux mots-cl&eacute;s &agrave;, s&eacute;lectionnez le type de mot-cl&eacute;.
–
Pour ajouter des mots-cl&eacute;s au fichier d'index, s&eacute;lectionnez Fichier d'index (HKK).
–
Pour ajouter des mots-cl&eacute;s de rubrique, s&eacute;lectionnez Rubriques.
4)
Cliquez sur OK.
Les nouveaux mots-cl&eacute;s sont fonction du type sp&eacute;cifi&eacute; jusqu'&agrave; ce que vous modifiiez les param&egrave;tres.
Remarques :
•
•
Lorsque vous ajoutez un mot-cl&eacute; &agrave; un index, il est automatiquement ajout&eacute; au fichier d'index (HHK)
ou de rubrique (HTM).
Les mots-cl&eacute;s du fichier d'index utilisent l'ic&ocirc;ne de cl&eacute; . Les mots-cl&eacute;s de rubrique utilisent l'ic&ocirc;ne
de page .
246
CHAPITRE 7
INDEX
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
Impression d'index
1)
2)
3)
4)
Cliquez sur le conteneur Index.
Dans le menu contextuel, s&eacute;lectionnez les &eacute;l&eacute;ments &agrave; imprimer.
Dans la barre d'outils, cliquez sur Imprimer.
Cliquez sur Propri&eacute;t&eacute;s, puis sur Configuration de la page pour sp&eacute;cifier les options d'impression.
ASTUCE : Le rapport d'index ou le rapport Voir aussi permettent d'imprimer des listes de mots-cl&eacute;s
personnalisables.
Ajout de mots-cl&eacute;s d'index et cr&eacute;ation de liens
•
•
•
Si vous ajoutez le m&ecirc;me mot-cl&eacute; &agrave; un index en en modifiant la casse, le concepteur d'index ajoute
les mots-cl&eacute;s en tant qu'entr&eacute;e unique sur la base de la premi&egrave;re entr&eacute;e.
Si l'index comprend des mots-cl&eacute;s de fichier d'index et des mots-cl&eacute;s de rubrique identiques, les
mots-cl&eacute;s sont fusionn&eacute;s lorsque vous g&eacute;n&eacute;rez le projet. Dans l'onglet Index, ils s'affichent sous un
seul mot-cl&eacute;, mais ils apparaissent comme mots-cl&eacute;s distincts dans le concepteur d'index.
Lorsque vous convertissez un projet WinHelp (HPJ) en projet RoboHelp (fichier XPJ), les mots-cl&eacute;s
des rubriques WinHelp sont enregistr&eacute;s en tant que mots-cl&eacute;s dans le fichier d'index.
LIENS CONNEXES :
Cr&eacute;ation automatique d'index
Ajout de mots-cl&eacute;s d'index &agrave; l'aide de la barre d'outils
1)
Dans le conteneur Index, proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Pour ajouter un mot-cl&eacute;, cliquez sur le bouton Nouveau mot-cl&eacute; d'index .
–
Pour ajouter un mot-cl&eacute; secondaire, s&eacute;lectionnez un mot-cl&eacute; parent dans la liste. Cliquez sur
le bouton Nouveau mot-cl&eacute; secondaire d'index .
2)
Saisissez le mot-cl&eacute; dans la zone de texte. Appuyez sur Entr&eacute;e.
Le mot-cl&eacute; est ajout&eacute; &agrave; l'index et s'affiche en caract&egrave;res gras pour indiquer qu'il n'est encore associ&eacute;
&agrave; aucune rubrique.
ASTUCE : Pour ajouter rapidement un mot-cl&eacute; et des mots-cl&eacute;s secondaires, ignorez l'&eacute;tape 1 et tapez
le mot-cl&eacute; et les mots-cl&eacute;s secondaires en les s&eacute;parant par \, puis cliquez sur Ajouter un mot-cl&eacute;.
S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Liste des rubriques. Le conteneur Liste des rubriques
s'affiche.
Pour lier les mots-cl&eacute;s &agrave; des rubriques, faites glisser ces derni&egrave;res du conteneur Liste des rubriques
au panneau inf&eacute;rieur du conteneur Index.
Le mot-cl&eacute; li&eacute; s'affiche alors en texte brut.
3)
4)
247
CHAPITRE 7
INDEX
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
Ajout de mots-cl&eacute;s d'index sur la base d'un titre de rubrique
1)
2)
3)
4)
Ouvrez le conteneur Index.
S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Liste des rubriques.
Dans le conteneur Liste des rubriques, s&eacute;lectionnez une rubrique.
Une ic&ocirc;ne en forme de point d'interrogation indique qu'une rubrique n'est pas ajout&eacute;e dans l'index.
Faites glisser la rubrique dans le volet sup&eacute;rieur du concepteur d'index.
Le nom du mot-cl&eacute; est bas&eacute; sur le titre de la rubrique. Vous pouvez le renommer.
Ajout de mots-cl&eacute;s d'index &agrave; l'aide des propri&eacute;t&eacute;s de rubrique
1)
2)
3)
4)
5)
Dans le conteneur Liste des rubriques ou Gestionnaire de projets, s&eacute;lectionnez une rubrique.
Cliquez sur le bouton Propri&eacute;t&eacute;s .
Dans la bo&icirc;te de dialogue Propri&eacute;t&eacute;s de rubrique, cliquez sur l'onglet Index.
Dans la zone de texte, saisissez un mot-cl&eacute;. Pour ajouter un mot-cl&eacute; secondaire, saisissez le mot-cl&eacute;
principal suivi d'une barre oblique inverse, puis le mot-cl&eacute; secondaire.
Cliquez sur Ajouter.
Ajout de mots-cl&eacute;s d'index par s&eacute;lection de texte de rubrique
1)
2)
3)
Cliquez deux fois sur une rubrique pour l'ouvrir dans la vue Conception.
S&eacute;lectionnez le texte &agrave; utiliser comme mot-cl&eacute;.
Cliquez avec le bouton droit de la souris sur le texte, puis s&eacute;lectionnez Ajouter &agrave; &gt; Mot-cl&eacute; d'index
[index].
Copie de mots-cl&eacute;s d'index
Vous pouvez copier des mots-cl&eacute;s d'index d'une rubrique &agrave; l'autre. Une fois les copies effectu&eacute;es, vous
pouvez les personnaliser pour les associer &agrave; chaque rubrique.
1) Dans le conteneur Liste des rubriques, cliquez avec le bouton droit de la souris sur une rubrique et
s&eacute;lectionnez le bouton Propri&eacute;t&eacute;s .
2) Cliquez sur l'onglet Index.
3) Cliquez sur Ajouter existant.
Sur la gauche, une liste de tous les mots-cl&eacute;s du projet s'affiche. Sur la droite, la liste de tous les
mots-cl&eacute;s de la rubrique en cours s'affiche. Si la rubrique n'a pas encore &eacute;t&eacute; index&eacute;e, aucun mot-cl&eacute;
ne s'affiche.
4) Copiez les mots-cl&eacute;s d'index dans la rubrique :
–
Pour copier un mot-cl&eacute; unique, s&eacute;lectionnez-le &agrave; gauche et cliquez sur le bouton &agrave; fl&egrave;che unique.
–
Pour copier tous les mots-cl&eacute;s, cliquez sur le bouton &agrave; fl&egrave;che double.
5)
Cliquez sur OK. Les mots-cl&eacute;s sont associ&eacute;s &agrave; la rubrique actuelle.
ASTUCE : Pour modifier les mots-cl&eacute;s d'index que vous copiez, s&eacute;lectionnez un mot-cl&eacute;. Saisissez le texte
sous Mots-cl&eacute;s d'index. Cliquez sur Remplacer.
248
CHAPITRE 7
INDEX
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
S&eacute;lection d'une destination de mot-cl&eacute; d'index
Vous pouvez lier des mots-cl&eacute;s &agrave; plusieurs destinations. Lorsqu'un utilisateur clique sur le mot-cl&eacute;,
la destination s'ouvre dans le volet de la rubrique.
1) Dans le conteneur Index, s&eacute;lectionnez un mot-cl&eacute;.
2) Sous Rubriques pour, cliquez avec le bouton droit de la souris sur un mot-cl&eacute;.
3) S&eacute;lectionnez Propri&eacute;t&eacute;s.
4) Dans Rubriques existantes, indiquez une destination et cliquez sur OK.
–
S&eacute;lectionnez un &eacute;l&eacute;ment dans la liste. Au besoin, s&eacute;lectionnez-le dans le menu contextuel et
acc&eacute;dez &agrave; l'&eacute;l&eacute;ment. Vous pouvez &eacute;tablir des liens vers des &eacute;l&eacute;ments dans d'autres projets.
–
Pour cr&eacute;er une rubrique comportant des mots-cl&eacute;s d'index, cliquez sur Nouvelle rubrique.
Inscrivez un titre, modifiez le nom du fichier le cas &eacute;ch&eacute;ant, puis s&eacute;lectionnez une page
principale.
–
Pour lier la rubrique &agrave; un autre type de destination, cliquez sur le menu contextuel Lien vers
et s&eacute;lectionnez un type de destination. Saisissez l'URL correspondante, l'adresse e-mail,
l'adresse du FTP ou le nom du fichier bagage du type de destination.
Remarques :
•
•
Les champs Nom et Lien vers sont d&eacute;sactiv&eacute;s lorsque vous utilisez des mots-cl&eacute;s de rubrique. Avec
les mots-cl&eacute;s de rubrique, un mot-cl&eacute; peut &ecirc;tre uniquement li&eacute; &agrave; la rubrique dans laquelle il est
stock&eacute;. Le titre de la rubrique est utilis&eacute; comme nom.
L'option Rechercher une rubrique permet de localiser une rubrique au sein du projet afin d'ajouter
une rubrique de mot-cl&eacute; d'index ou de modifier ses propri&eacute;t&eacute;s.
Cr&eacute;ation de mots-cl&eacute;s d'index &agrave; l'aide de variables d&eacute;finies par l'utilisateur
Les variables d&eacute;finies par l'utilisateur vous permettent de cr&eacute;er plusieurs versions d'un mot-cl&eacute; d'index.
1) Dans le conteneur Index, cliquez avec le bouton droit de la souris sur un mot-cl&eacute;. S&eacute;lectionnez
Propri&eacute;t&eacute;s.
2) Dans le menu Variables disponibles, s&eacute;lectionnez une variable. Cliquez sur Ajouter.
La variable appara&icirc;t dans la zone Mot-cl&eacute; d'index.
3) (Facultatif) Dans la bo&icirc;te de dialogue Mot-cl&eacute; d'index, ajoutez un pr&eacute;fixe ou un suffixe &agrave; la variable.
Ajoutez par exemple le pr&eacute;fixe &laquo; Adobe &raquo; &agrave; la variable &laquo; RoboHelp &raquo;.
4) Dans la liste Rubriques, s&eacute;lectionnez une rubrique &agrave; laquelle lier ce nouveau mot-cl&eacute;.
5) Cliquez sur OK.
249
CHAPITRE 7
INDEX
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
Mots-cl&eacute;s d'index avec r&eacute;f&eacute;rence crois&eacute;e
Vous pouvez &eacute;tablir des r&eacute;f&eacute;rences crois&eacute;es pour les mots-cl&eacute;s de fa&ccedil;on &agrave; ce qu'un mot-cl&eacute; associ&eacute;
s'affiche lorsqu'un mot-cl&eacute; est s&eacute;lectionn&eacute;. L'utilisateur peut le s&eacute;lectionner pour que celui-ci affiche une
rubrique.
Vous pouvez choisir de ne r&eacute;f&eacute;rencer que les mots-cl&eacute;s d'index.
1) Dans le conteneur Index, ajoutez un mot-cl&eacute; pour lequel vous voulez cr&eacute;er une r&eacute;f&eacute;rence crois&eacute;e.
Il sera ainsi li&eacute; &agrave; un autre mot-cl&eacute;.
2) Cliquez avec le bouton droit de la souris sur un mot-cl&eacute;. S&eacute;lectionnez Propri&eacute;t&eacute;s.
3) S&eacute;lectionnez R&eacute;f&eacute;rences crois&eacute;es. Dans le menu contextuel, s&eacute;lectionnez un autre mot-cl&eacute;.
La r&eacute;f&eacute;rence crois&eacute;e appara&icirc;t dans le panneau inf&eacute;rieur du concepteur d'index.
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
Modification de mots-cl&eacute;s d'index
D&eacute;placement et classement des mots-cl&eacute;s d'index
Si vous d&eacute;placez un mot-cl&eacute; d'index, ses mots-cl&eacute;s secondaires seront &eacute;galement d&eacute;plac&eacute;s.
Les mots-cl&eacute;s de rubrique sont automatiquement class&eacute;s, d'abord sous forme de liste num&eacute;rot&eacute;e, puis
par ordre alphab&eacute;tique.
1) Dans le conteneur Index, proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lection d'un mot-cl&eacute;. Dans la bo&icirc;te d'outils, cliquez sur un bouton repr&eacute;sentant une fl&egrave;che.
Un bouton est disponible si cette action n'est pas autoris&eacute;e.
–
Faites glisser le mot-cl&eacute;.
–
Cliquez avec le bouton droit de la souris sur un mot-cl&eacute;. S&eacute;lectionnez Classer &gt; [option de
classement].
REMARQUE : La commande Classer n'est pas disponible pour les index binaires. La fonction de
classement n'est activ&eacute;e que lorsque la mise en page principale est HTML Help et que l'index
est d&eacute;fini sur Fichier d'index sans index binaire. Pour toutes les autres mises en page, l'index
reste class&eacute;, mais dans la sortie HTML, le classement de l'index peut &ecirc;tre modifi&eacute;. Le
classement active les touches fl&eacute;ch&eacute;es haut et bas du conteneur Index.
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
Modification des mots-cl&eacute;s d'un projet
Cette m&eacute;thode permet de renommer les mots-cl&eacute;s de l'index et des rubriques.
1) Dans le conteneur Index, cliquez avec le bouton droit de la souris sur un mot-cl&eacute;. S&eacute;lectionnez
Renommer.
2) Saisissez le nouveau mot-cl&eacute; dans la zone de texte.
250
CHAPITRE 7
INDEX
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
Modification des mots-cl&eacute; d'une rubrique
Pour renommer un mot-cl&eacute; de rubrique r&eacute;f&eacute;renc&eacute; par une rubrique sp&eacute;cifique, modifiez les propri&eacute;t&eacute;s de
la rubrique. Si d'autres rubriques utilisent le m&ecirc;me mot-cl&eacute;, le mot-cl&eacute; d'origine reste dans l'index. Seule
la rubrique que vous avez modifi&eacute;e est mise &agrave; jour.
1) Dans le conteneur Liste des rubriques, s&eacute;lectionnez une rubrique.
2) Cliquez sur le bouton Propri&eacute;t&eacute;s .
3) Cliquez sur l'onglet Index. S&eacute;lectionnez un mot-cl&eacute;.
4) Saisissez le nouveau mot-cl&eacute; dans la zone de texte.
5) Cliquez sur Remplacer.
Modification de la casse d'un mot-cl&eacute;
1)
2)
Dans le Concepteur d'index, s&eacute;lectionnez un mot-cl&eacute;.
Sur la barre d'outils, cliquez sur le bouton Minuscules
ou Majuscules
.
Suppression de mots-cl&eacute;s d'index du conteneur Index
Si vous supprimez un mot-cl&eacute; du conteneur Index, il sera &eacute;galement supprim&eacute; de toutes les rubriques
auxquelles il &eacute;tait li&eacute;.
1) Dans le conteneur Index, s&eacute;lectionnez un mot-cl&eacute;.
2) Dans la barre d'outils, cliquez sur Supprimer.
ASTUCE : Les mots-cl&eacute;s non utilis&eacute;s dans l'index ne sont pas r&eacute;f&eacute;renc&eacute;s par les autres rubriques. Les
mots-cl&eacute;s apparaissent en caract&egrave;res gras dans le conteneur Index. Vous pouvez les supprimer
automatiquement.
Suppression de mots-cl&eacute;s d'index des rubriques
Si vous supprimez un mot-cl&eacute; d'une rubrique, seule la rubrique que vous modifiez est affect&eacute;e. Les autres
rubriques faisant r&eacute;f&eacute;rence au mot-cl&eacute; sont toujours reli&eacute;es &agrave; celui-ci.
1) Dans le conteneur Liste des rubriques, s&eacute;lectionnez une rubrique.
2) Cliquez sur le bouton Propri&eacute;t&eacute;s .
3) Cliquez sur l'onglet Index.
4) S&eacute;lectionnez un mot-cl&eacute; dans la liste.
5) Cliquez sur Supprimer.
Gestion des index
Gestion des index &agrave; l'aide des rapports
RoboHelp fournit des rapports &agrave; utiliser lors de la gestion des index, par exemple les rapports Index et
Mots-cl&eacute;s d'index inutilis&eacute;s. Le rapport Index vous permet de choisir les options d&eacute;finissant le mode
d'affichage des informations dans le rapport. Vous pouvez afficher l'ensemble des mots-cl&eacute;s, une liste des
mots-cl&eacute;s et des rubriques associ&eacute;es ou une liste des rubriques et des mots-cl&eacute;s correspondants.
251
CHAPITRE 7
INDEX
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
Le rapport Mots-cl&eacute;s d'index inutilis&eacute;s r&eacute;pertorie les mots-cl&eacute;s non r&eacute;f&eacute;renc&eacute;s par les rubriques. Ces
mots-cl&eacute;s se trouvent dans le fichier d'index. Ce rapport identifie les mots-cl&eacute;s &agrave; supprimer ou &agrave; associer
aux rubriques.
Vous pouvez enregistrer, imprimer, copier et envoyer des rapports par e-mail.
1) S&eacute;lectionnez Outils &gt; Rapports.
2) S&eacute;lectionnez un rapport (Index, par exemple) et affichez les r&eacute;sultats.
3) Cliquez sur Fermer.
Identification et correction des r&eacute;f&eacute;rences rompues dans les rubriques de mots cl&eacute;s
1)
2)
Dans le conteneur Gestionnaire de projets, ouvrez le dossier Liens rompus.
Les rubriques manquantes y sont r&eacute;pertori&eacute;es. Elles apparaissent marqu&eacute;es d'un X rouge.
Cliquez avec le bouton droit de la souris sur une rubrique manquante. S&eacute;lectionnez Propri&eacute;t&eacute;s.
Les mots-cl&eacute;s qui font r&eacute;f&eacute;rence &agrave; une rubrique manquante apparaissent avec une ic&ocirc;ne de cl&eacute; .
Vous pouvez supprimer la r&eacute;f&eacute;rence de rubrique ou lui associer &agrave; nouveau une liaison dans le
conteneur Index.
Suppression des r&eacute;f&eacute;rences de rubrique des mots-cl&eacute;s
REMARQUE : Si vous supprimez toutes les rubriques du mot-cl&eacute;, le conteneur Index affiche le mot-cl&eacute; en
gras pour indiquer qu'il n'est pas r&eacute;f&eacute;renc&eacute;.
Si vous s&eacute;lectionnez un mot-cl&eacute; d'index dans le conteneur Index, le volet inf&eacute;rieur affiche toutes les
rubriques qui y font r&eacute;f&eacute;rence. Vous pouvez supprimer la rubrique de votre choix de ce volet afin de
supprimer le mot-cl&eacute; de la rubrique. Le nom de la rubrique ne faisant plus partie de votre projet, mais
faisant r&eacute;f&eacute;rence au mot-cl&eacute; s&eacute;lectionn&eacute; s'affiche. Si vous supprimez la rubrique de ce volet, la liste des
liens rompus est supprim&eacute;e et le fichier d'index est mis &agrave; jour.
1) Dans le conteneur Index, s&eacute;lectionnez un mot-cl&eacute;.
Le volet inf&eacute;rieur du conteneur Index r&eacute;pertorie toutes les rubriques faisant r&eacute;f&eacute;rence au mot-cl&eacute;.
2) S&eacute;lectionnez une rubrique. Sur la barre d'outils, cliquez sur le bouton Supprimer .
Suppression de mots-cl&eacute;s d'index inutilis&eacute;s
Les mots-cl&eacute;s inutilis&eacute;s ne sont pas li&eacute;s &agrave; des rubriques. Le conteneur Index affiche les mots-cl&eacute;s d'index
inutilis&eacute;s en caract&egrave;res gras. Les mots-cl&eacute;s inutilis&eacute;s n'apparaissent pas dans l'index.
L'index conserve les mots-cl&eacute;s inutilis&eacute;s m&ecirc;me lorsque vous supprimez les rubriques qui y font r&eacute;f&eacute;rence.
Ainsi, vous pouvez les affecter &agrave; d'autres rubriques sans avoir &agrave; lire ces derni&egrave;res.
REMARQUE : Cette proc&eacute;dure ne supprime pas les mots-cl&eacute;s auxquels sont associ&eacute;s un ou plusieurs
mots-cl&eacute;s secondaires.
1) Dans le conteneur Index, s&eacute;lectionnez un mot-cl&eacute;. Sur la barre d'outils, cliquez sur le bouton
Supprimer .
ASTUCE : Pour identifier les mots-cl&eacute;s inutilis&eacute;s, s&eacute;lectionnez Outils &gt; Rapports &gt; Mots-cl&eacute;s d'index
inutilis&eacute;s.
252
CHAPITRE 7
INDEX
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
Application de balises de construction conditionnelles &agrave; un index
1)
2)
3)
4)
Dans le conteneur Index, s&eacute;lectionnez un mot-cl&eacute;.
Cliquez sur Modifier &gt; Balises &gt; Appliquer &gt; Nouveau/Plusieurs.
S&eacute;lectionnez les balises ou cliquez sur V&eacute;rifier tout.
Cliquez sur OK.
Indexation automatique via l'assistant d'index dynamique
Cr&eacute;ation automatique d'index
L'assistant d'index dynamique effectue des recherches dans le contenu des rubriques. S&eacute;lectionnez un
mot-cl&eacute; parmi ceux sugg&eacute;r&eacute;s.
REMARQUE : Vous devez fermer tous les fichiers d'applications tierces avant de d&eacute;marrer l'assistant d'index
dynamique.
1) S&eacute;lectionnez Outils &gt; Assistant d'index dynamique.
2) S&eacute;lectionnez les crit&egrave;res de recherche.
Rechercher les mots-cl&eacute;s d'index existants et nouveaux
Ajout de mots-cl&eacute;s en fonction du contenu des rubriques et des entr&eacute;es d'index existantes.
Ajouter les mots-cl&eacute;s d'index existants aux rubriques
Recherche de mots-cl&eacute;s d&eacute;j&agrave; utilis&eacute;s et liaison de ces mots-cl&eacute;s aux rubriques.
Utiliser des param&egrave;tres de recherche personnalis&eacute;s
S&eacute;lectionnez Param&egrave;tres et d&eacute;finissez vos options de recherche personnalis&eacute;es. Dans la bo&icirc;te de
dialogue Param&egrave;tres d'index dynamique, vous pouvez d&eacute;finir une langue pour rechercher les
mots-cl&eacute;s d'index. Par exemple, si vous d&eacute;finissez le fran&ccedil;ais comme &eacute;tant la langue du projet et que
le paragraphe est en anglais, l'index dynamique utilise le dictionnaire anglais pour identifier les
mots-cl&eacute;s du paragraphe.
REMARQUE : Cette option s'applique &agrave; l'anglais uniquement.
Dans la zone Param&egrave;tres de la bo&icirc;te de dialogue Param&egrave;tres d'index dynamique, vous pouvez
s&eacute;lectionner des options &agrave; inclure en tant que mots-cl&eacute;s dans l'index. Il peut s'agir par exemple de
mots en majuscules, de mots en majuscules et en minuscules, d'expressions, de mots dans une
expression ou encore de mots qui ne figurent pas dans le dictionnaire.
Dans la zone Autres param&egrave;tres, vous pouvez s&eacute;lectionner des options &agrave; exclure en tant que
mots-cl&eacute;s dans l'index. Par exemple, s&eacute;lectionnez des verbes ou des adverbes &agrave; exclure et incluez
des adjectifs ou des noms en tant que mots-cl&eacute;s.
3)
4)
S&eacute;lectionnez les &eacute;l&eacute;ments dans lesquels effectuer la recherche des mots-cl&eacute;s d'index.
Pour sp&eacute;cifier des mots ou des expressions &agrave; ignorer par l'assistant d'index dynamique, s&eacute;lectionnez
Ignorer toujours ou Expressions. Modifier, ajouter ou supprimer des entr&eacute;es.
253
CHAPITRE 7
5)
6)
7)
8)
INDEX
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
Pour mettre en majuscule la premi&egrave;re lettre du mot-cl&eacute;, s&eacute;lectionnez Mettre tous les nouveaux
mots-cl&eacute;s d'index en majuscules. (Vous pouvez modifier la casse ult&eacute;rieurement dans le concepteur
Index.)
Cliquez sur Suivant.
S&eacute;lectionnez Confirmer l'ajout de mots-cl&eacute;s d'index pour chaque rubrique.
Pour ajouter des mots-cl&eacute;s sans afficher de message de confirmation, s&eacute;lectionnez Ajouter
automatiquement les mots-cl&eacute;s d'index de toutes les rubriques et cliquez sur Terminer.
(Facultatif) S&eacute;lectionnez des options de filtre pour la recherche.
Dossier
Recherchez parmi les rubriques d'un dossier sp&eacute;cifique.
Etat
Recherchez les rubriques par &eacute;tat.
V&eacute;rifier uniquement les nouvelles rubriques (n'ayant pas d'index dynamique)
Recherchez uniquement les rubriques non index&eacute;es.
9) Cliquez sur Suivant. Les mots-cl&eacute;s sugg&eacute;r&eacute;s de la premi&egrave;re rubrique s'affichent.
10) S&eacute;lectionnez, d&eacute;s&eacute;lectionnez, renommez ou supprimez des mots-cl&eacute;s.
Pour passer &agrave; la rubrique suivante, cliquez sur Ignorer. Cliquez sur Options pour ajouter des verbes,
des synonymes et des mots-cl&eacute;s d'index existants.
REMARQUE : La bo&icirc;te de dialogue Phrase(s) contenant indique le mot-cl&eacute; sugg&eacute;r&eacute; dans son contexte.
Le champ Info signale si le mot-cl&eacute; s&eacute;lectionn&eacute; est nouveau ou existant.
11) Cliquez sur Suivant, puis sur Fermer dans la bo&icirc;te de dialogue R&eacute;sultats.
Les nouveaux mots-cl&eacute;s s'affichent dans le conteneur Index.
Remarques :
•
•
•
Vous pouvez modifier la casse des mots-cl&eacute;s et des mots-cl&eacute;s secondaires.
Vous pouvez associer les mots-cl&eacute;s &agrave; des destinations autres que des rubriques.
Les mots-cl&eacute;s d'index sont diff&eacute;rents des mots-cl&eacute;s Voir aussi.
D&eacute;finition des mots-cl&eacute;s &agrave; ignorer
Vous pouvez cr&eacute;er une liste de mots ou d'expressions qui seront ignor&eacute;s par l'assistant d'index
dynamique. Il s'agit de la liste Ignorer toujours.
Lorsque l'assistant d'index dynamique lance une recherche sur des rubriques, il v&eacute;rifie la liste Ignorer
toujours. Si une de ses suggestions correspond exactement &agrave; l'un des mots &agrave; ignorer, il ne la sugg&egrave;re pas
en tant que mot-cl&eacute; potentiel.
1) S&eacute;lectionnez Outils &gt; Assistant d'index dynamique.
2) Cliquez sur Ignorer toujours.
254
CHAPITRE 7
3)
INDEX
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Pour ajouter un mot, cliquez sur Nouveau et saisissez votre texte.
–
Pour modifier un mot, s&eacute;lectionnez-le, cliquez sur Modifier, puis saisissez votre texte.
–
Pour supprimer un mot, s&eacute;lectionnez-le. Cliquez sur Supprimer.
La liste est stock&eacute;e en tant que fichier WLF dans le dossier du projet.
REMARQUE : Les mots et les expressions saisis respectent la casse uniquement lorsqu'il s'agit de termes en
majuscules ou comportant &agrave; la fois des majuscules et des minuscules. Dans ce cas, l'assistant d'index
dynamique doit d&eacute;tecter le terme exact avant de sugg&eacute;rer l'ajout d'un nouveau mot-cl&eacute;.
LIENS CONNEXES :
Modification des param&egrave;tres du projet
D&eacute;finition des mots courants &agrave; ignorer
Vous pouvez cr&eacute;er une liste de mots courants (tels que un) qui sont ignor&eacute;s dans les r&eacute;sultats de la
recherche de la sortie publi&eacute;e. Il s'agit de la liste d'exclusion.
Une liste d'exclusion ne peut contenir que 512 caract&egrave;res. Chaque mot de la liste d'exclusion comprend
un caract&egrave;re invisible qui lui est ajout&eacute;. Si la limite de caract&egrave;res est atteinte au milieu d'un mot, le mot
dans son ensemble ne sera pas compil&eacute;.
1) S&eacute;lectionnez Outils &gt; Assistant d'index dynamique.
2) Cliquez sur Ignorer toujours.
3) Cliquez sur l'onglet Liste d'exclusion.
4) Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Pour ajouter un mot, cliquez sur Nouveau et saisissez votre texte.
–
Pour modifier un mot, s&eacute;lectionnez-le, cliquez sur Modifier, puis saisissez votre texte.
–
Pour supprimer un mot, s&eacute;lectionnez-le. Cliquez sur Supprimer.
La liste est stock&eacute;e en tant que fichier STP dans le dossier du projet.
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
LIENS CONNEXES :
Modification des param&egrave;tres du projet
D&eacute;finition des expressions personnalis&eacute;es
Pour un contr&ocirc;le accru des mots-cl&eacute;s d'index (mots et expressions) sugg&eacute;r&eacute;s par l'assistant d'index
dynamique, &eacute;tablissez une liste d'expressions personnalis&eacute;e. Cette liste de mots-cl&eacute;s est sp&eacute;cifique au
projet. Vous pouvez par exemple y inclure des noms de produits.
Lorsque l'assistant d'index dynamique lance une recherche sur des rubriques, il v&eacute;rifie la liste des
expressions. Si une expression-cl&eacute; est d&eacute;tect&eacute;e dans une rubrique et si cette expression-cl&eacute; n'est pas d&eacute;j&agrave;
d&eacute;finie en tant que mot-cl&eacute; dans la rubrique, l'assistant d'index dynamique sugg&egrave;re de l'ajouter.
1) S&eacute;lectionnez Outils &gt; Assistant d'index dynamique.
2) Cliquez sur Expressions.
255
CHAPITRE 7
3)
INDEX
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
Cliquez sur Nouveau.
–
Pour ajouter un mot, cliquez sur Nouveau et saisissez votre texte.
–
Pour modifier une expression, s&eacute;lectionnez-la, cliquez sur Modifier, puis saisissez votre texte.
–
Pour modifier une expression, s&eacute;lectionnez-la. Cliquez sur Supprimer.
La liste est stock&eacute;e en tant que fichier PHR dans le dossier du projet. Vous pouvez modifier ce fichier dans
un &eacute;diteur de texte tel que le Bloc-notes de Windows.
REMARQUE : Les mots et les expressions saisis respectent la casse uniquement lorsqu'il s'agit de termes en
majuscules ou comportant &agrave; la fois des majuscules et des minuscules. Dans ce cas, l'assistant d'index
dynamique doit d&eacute;tecter le terme exact avant de sugg&eacute;rer l'ajout d'un nouveau mot-cl&eacute;.
Consultation de synonymes lors de l'indexation
REMARQUE : Cette option est uniquement disponible en langue anglaise.
1)
2)
3)
4)
5)
6)
7)
8)
S&eacute;lectionnez Outils &gt; Assistant d'index dynamique.
Cliquez deux fois sur Suivant.
S&eacute;lectionnez un mot-cl&eacute;.
Cliquez sur Options. S&eacute;lectionnez Synonymes.
Le mot-cl&eacute; appara&icirc;t dans la zone Mot.
(Facultatif) Cliquez sur Antonymes pour conna&icirc;tre les antonymes du mot-cl&eacute;.
Sous Cat&eacute;gories, s&eacute;lectionnez le mot le plus appropri&eacute;.
Sous Synonymes, s&eacute;lectionnez un mot &agrave; ajouter en tant que mot-cl&eacute;. Cliquez sur Ajouter &agrave; la rubrique.
Cliquez sur Fermer.
ASTUCE : Pour conna&icirc;tre les synonymes et antonymes d'autres mots, tapez un mot dans la zone Mot et
cliquez sur Consulter.
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
Index multiples
Cr&eacute;ation de plusieurs index
Vous pouvez cr&eacute;er plusieurs index dans le m&ecirc;me projet. Les nouveaux index sont ajout&eacute;s au dossier
Index. Lorsque vous disposez de plusieurs index, vous pouvez cliquer avec le bouton droit de la souris sur
l'un des index et s&eacute;lectionner D&eacute;finir par d&eacute;faut pour d&eacute;finir l'index s&eacute;lectionn&eacute; comme index par d&eacute;faut.
Vous pouvez &eacute;galement cliquer avec le bouton droit de la souris sur un index et s&eacute;lectionner Renommer.
Vous pouvez copier et faire glisser les mots-cl&eacute;s vers plusieurs index.
1) Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Dans le conteneur Gestionnaire de projets, cliquez avec le bouton droit de la souris dans le
dossier Index. S&eacute;lectionnez Nouvel index.
–
Cliquez sur le bouton Cr&eacute;er/Afficher le fichier d'index. Cliquez sur Nouveau.
2)
Saisissez un nom dans la zone de texte.
256
TABLES DES MATI&Egrave;RES ET INDEX MICROSOFT HTML HELP
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
CHAPITRE 7
3)
4)
(Facultatif) Pour copier un index existant, s&eacute;lectionnez Copier un index existant. Cliquez sur le
bouton Parcourir pour acc&eacute;der &agrave; l'index.
Cliquez sur OK.
Fusion des index
Suivez cette proc&eacute;dure pour fusionner les index au sein d'un projet.
1) Dans le conteneur Gestionnaire de projets, ouvrez le dossier Index.
2) Cliquez deux fois sur un index.
3) Dans le conteneur Index, s&eacute;lectionnez un mot-cl&eacute; &agrave; partir duquel l'index fusionn&eacute; s'affichera.
4) Cliquez sur le bouton Ins&eacute;rer un espace r&eacute;serv&eacute; pour l'index .
5) Dans le menu S&eacute;lectionner l'index, choisissez l'index &agrave; ins&eacute;rer.
6) Cliquez sur OK.
L'index fusionn&eacute; s'affiche avec l'ic&ocirc;ne Nouvel index .
7) Cliquez deux fois sur l'ic&ocirc;ne, puis cliquez sur Afficher.
L'index fusionn&eacute; s'affiche dans le conteneur Index.
LIENS CONNEXES :
Indexation automatique via l'assistant d'index dynamique
Cr&eacute;ation d'index binaires (HTML Help)
Tables des mati&egrave;res et index Microsoft HTML Help
Fusion de projets d'aide
7.3.
Tables des mati&egrave;res et index Microsoft HTML Help
Assignation d'ic&ocirc;nes de table des mati&egrave;res personnalis&eacute;es (HTML Help)
1)
2)
3)
4)
5)
Dans le conteneur Table des mati&egrave;res, cliquez avec le bouton droit de la souris sur un livre ou sur
une page. S&eacute;lectionnez Propri&eacute;t&eacute;s.
Cliquez sur l'onglet Avanc&eacute;.
Sous Image, Automatique indique que le livre ou la page utilise l'ic&ocirc;ne standard.
Dans le menu contextuel, s&eacute;lectionnez une ic&ocirc;ne.
Vous pourrez attribuer d'autres ic&ocirc;nes aux livres et aux pages apr&egrave;s avoir ajout&eacute; le fichier bitmap
(BMP) &agrave; votre projet.
(Facultatif) S&eacute;lectionnez Marquer comme nouveau pour afficher une &eacute;toile rouge sur l'ic&ocirc;ne
standard. L'&eacute;toile indique que l'&eacute;l&eacute;ment table des mati&egrave;res contient de nouvelles informations.
REMARQUE : L'option Marquer comme nouveau est disponible lorsque la mise en page principale est
Microsoft HTML Help.
Cliquez sur OK.
257
CHAPITRE 7
TABLES DES MATI&Egrave;RES ET INDEX MICROSOFT HTML HELP
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
REMARQUE : Le conteneur Table des mati&egrave;res affiche des ic&ocirc;nes standard pour tous les livres et pages,
ind&eacute;pendamment de la s&eacute;lection effectu&eacute;e dans l'onglet Avanc&eacute;. Apr&egrave;s la g&eacute;n&eacute;ration du projet, vous
pouvez afficher les ic&ocirc;nes dans le volet de table des mati&egrave;res.
Cr&eacute;ation de fichiers de contenu binaire (HTML Help)
Les fichiers de contenu binaire vous permettent de r&eacute;duire le temps n&eacute;cessaire &agrave; l'ouverture des projets
volumineux.
IMPORTANT : Ne fusionnez pas des projets utilisant des fichiers de contenu binaire.
1) Dans le conteneur Gestionnaire de projets, cliquez deux fois sur la table des mati&egrave;res de votre choix
dans le dossier Table des mati&egrave;res. Le conteneur Table des mati&egrave;res s'affiche.
2) S&eacute;lectionnez Sortie &gt; Ouvrir &gt; Configuration de sortie.
3) D&eacute;veloppez le dossier Mises en page source unique.
4) Cliquez avec le bouton droit de la souris sur une mise en page. S&eacute;lectionnez Propri&eacute;t&eacute;s.
5) Cliquez sur le bouton Modifier.
6) Cliquez sur l'onglet Styles de la table des mati&egrave;res.
7) S&eacute;lectionnez Table des mati&egrave;res binaire.
8) Cliquez sur OK.
9) G&eacute;n&eacute;rez le projet.
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
Cr&eacute;ation d'index binaires (HTML Help)
Dans certains cas, les projets Microsoft HTML Help requi&egrave;rent des index binaires :
•
Lorsque les projets poss&egrave;dent des mots-cl&eacute;s de rubrique. Les mots-cl&eacute;s de rubrique sont enregistr&eacute;s
dans les fichiers HTML qui les r&eacute;f&eacute;rencent.
•
Lorsque des projets HTML sont fusionn&eacute;s. Lorsque vous fusionnez des projets, chaque fichier CHM
est conserv&eacute; dans son propre projet, tandis que les mots-cl&eacute;s de chacun des fichiers d'index sont
combin&eacute;s dans le projet ma&icirc;tre. Distribuez chaque fichier CHM avec le fichier CHM ma&icirc;tre.
1)
2)
3)
4)
5)
6)
7)
V&eacute;rifiez que la mise en page principale est d&eacute;finie en fonction de Microsoft HTML Help.
S&eacute;lectionnez Projet &gt; Fichier &gt; Param&egrave;tres du projet.
Dans l'onglet G&eacute;n&eacute;ralit&eacute;s, s&eacute;lectionnez Index binaire.
Cliquez sur OK.
Ajoutez des mots-cl&eacute;s de rubrique (marqu&eacute;s d'une ic&ocirc;ne de cl&eacute; ).
Fusionnez-les sous-projets le cas &eacute;ch&eacute;ant.
G&eacute;n&eacute;rez et affichez le projet.
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
258
CHAPITRE 7
TABLES DES MATI&Egrave;RES ET INDEX MICROSOFT HTML HELP
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
LIENS CONNEXES :
Fusion de projets d'aide
G&eacute;n&eacute;ration, affichage et publication d'une sortie
Personnalisation d'une table des mati&egrave;res (HTML Help)
S&eacute;lectionnez une police personnalis&eacute;e pour l'affichage des titres de livres et de pages et synchronisez les
livres et les pages avec le contenu des rubriques. Utilisez des bords relev&eacute;s ou rentr&eacute;s pour donner une
impression tridimensionnelle.
1) Dans le conteneur Mises en page source unique, cliquez avec le bouton droit de la souris sur une
mise en page pour une sortie HTML Help.
2) S&eacute;lectionnez Propri&eacute;t&eacute;s.
3) Cliquez sur Modifier en regard des Param&egrave;tres avanc&eacute;s.
4) Cliquez sur l'onglet Styles de la table des mati&egrave;res.
5) D&eacute;finissez les options de style :
Bordures
Pour ajouter une bordure autour de la table des mati&egrave;res.
Cadre de la bo&icirc;te de dialogue
Pour ajouter un cadre autour de la table des mati&egrave;res.
Carr&eacute;s plus/moins
Pour afficher des ic&ocirc;nes plus et moins qui permettent d'ouvrir et de fermer les livres.
Toujours afficher la s&eacute;lection
Pour afficher la rubrique s&eacute;lectionn&eacute;e dans l'onglet Table des mati&egrave;res (m&ecirc;me si cet onglet
n'appara&icirc;t pas dans le volet gauche).
Dossiers au lieu de livres
Pour afficher des ic&ocirc;nes de dossier plut&ocirc;t que de livre.
Clic unique pour l'ouverture d'un livre
Pour ouvrir des livres en un seul clic.
Bord relev&eacute; ou Bord rentr&eacute;
Pour cr&eacute;er une apparence tridimensionnelle.
Lignes entre &eacute;l&eacute;ments
Pour ajouter des lignes entre les livres et les pages
259
CHAPITRE 7
TABLES DES MATI&Egrave;RES ET INDEX MICROSOFT HTML HELP
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
Lignes &agrave; partir de la racine
Permet d'afficher les lignes connectant les livres et les pages &agrave; partir de la racine.
6)
7)
Indiquez une police.
D&eacute;finissez les options de fen&ecirc;tre, de cadre, etc. :
–
Pour afficher la rubrique dans une fen&ecirc;tre personnalis&eacute;e, s&eacute;lectionnez le nom de la fen&ecirc;tre
dans Fen&ecirc;tre par d&eacute;faut.
–
Pour afficher la rubrique dans un cadre personnalis&eacute;, s&eacute;lectionnez le nom du cadre dans Cadre
par d&eacute;faut.
–
Pour utiliser des ic&ocirc;nes de livre et de page personnalis&eacute;es, s&eacute;lectionnez un fichier BMP dans
le fichier Image personnalis&eacute;e. N'oubliez pas d'inclure le chemin de l'image, sur le mod&egrave;le
C:\Program Files\Adobe RoboHelp[version]\My.bmp.
REMARQUE : Pour utiliser des ic&ocirc;nes de livre et de page personnalis&eacute;es, vous devez cr&eacute;er une
bande d'ic&ocirc;nes. Consultez la MSDN Library sur le site Web de Microsoft.
8)
Cliquez sur OK.
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
REMARQUE : L'option Table des mati&egrave;res binaire est uniquement recommand&eacute;e pour les syst&egrave;mes d'aide
volumineux. Elle requiert une aide compil&eacute;e au format HTML Help et ne prend pas en charge les fichiers
de contenu personnalis&eacute;s ou externes.
Personnalisation d'un index (HTML Help)
Le type d'index du projet HTML Help d&eacute;termine les propri&eacute;t&eacute;s d'index :
Mots-cl&eacute;s du fichier d'index
Vous pouvez personnaliser les polices des mots-cl&eacute;s de fichier d'index dans les index non binaires.
Cliquez sur l'onglet Index dans l'afficheur HTML Help.
Index fusionn&eacute;s
Si vous fusionnez des index &agrave; partir de fichiers CHM, s&eacute;lectionnez l'option Index binaire.
Mots-cl&eacute;s de rubrique
Si votre index contient des mots-cl&eacute;s de rubrique, cr&eacute;ez un index binaire.
1)
2)
3)
4)
Dans le conteneur Mises en page source unique, cliquez avec le bouton droit de la souris sur une
mise en page pour une sortie HTML Help.
S&eacute;lectionnez Propri&eacute;t&eacute;s.
Cliquez sur le bouton Modifier.
Cliquez sur l'onglet Index. D&eacute;finition des propri&eacute;t&eacute;s :
260
CHAPITRE 7
TABLES DES MATI&Egrave;RES ET INDEX MICROSOFT HTML HELP
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
Fen&ecirc;tre par d&eacute;faut
S&eacute;lectionnez la fen&ecirc;tre personnalis&eacute;e d'affichage des rubriques. Les fen&ecirc;tres personnalis&eacute;es ne
peuvent &ecirc;tre li&eacute;es qu'aux mots-cl&eacute;s de fichier d'index.
Cadre par d&eacute;faut
S&eacute;lectionnez un cadre par d&eacute;faut pour afficher les rubriques. Les cadres personnalis&eacute;s ne peuvent
&ecirc;tre li&eacute;s qu'aux mots-cl&eacute;s de fichier d'index.
S&eacute;lectionner une police
S&eacute;lectionnez un nom et une taille de police.
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
Ajout de contr&ocirc;les de table des mati&egrave;res (HTML Help)
Lorsqu'un utilisateur ouvre une rubrique, la table des mati&egrave;res s'affiche.
Si la rubrique est plac&eacute;e dans un sous-dossier, copiez le fichier de contenu dedans avant d'ajouter le
contr&ocirc;le.
1) Ouvrez une rubrique dans l'onglet Conception.
2) Cliquez &agrave; l'endroit o&ugrave; vous souhaitez ajouter la table des mati&egrave;res.
3) S&eacute;lectionnez Ins&eacute;rer &gt; HTML &gt; Javascript &gt; Table des mati&egrave;res. Le contr&ocirc;le Table des mati&egrave;res
s'affiche dans l'&eacute;diteur de conception.
4) Pour tester le contr&ocirc;le, g&eacute;n&eacute;rez le projet. La m&ecirc;me table des mati&egrave;res s'affiche dans le r&eacute;sultat final.
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
ASTUCE : Vous pouvez lier d'autres fichiers de contenu de votre projet. Copiez le fichier HHC dans votre
projet si vous voulez l'associer &agrave; un contr&ocirc;le Table des mati&egrave;res.
Ajout de contr&ocirc;les d'index (HTML Help)
Si votre projet ne prend pas en charge la pr&eacute;sentation &agrave; trois volets, vous pouvez ajouter un contr&ocirc;le
Index &agrave; une rubrique pour que le fichier d'index soit disponible. L'index appara&icirc;t lorsque la rubrique est
ouverte avec le contr&ocirc;le d'index.
1) Si la rubrique se trouve dans un sous-dossier, copiez le fichier d'index (HHK) dans ce sous-dossier.
2) Ouvrez la rubrique contenant le contr&ocirc;le dans l'&eacute;diteur de conception.
3) Cliquez &agrave; l'endroit o&ugrave; vous souhaitez ins&eacute;rer l'index.
4) S&eacute;lectionnez Ins&eacute;rer &gt; HTML &gt; Javascript &gt; Index.
Le contr&ocirc;le d'index s'affiche.
Pour tester le contr&ocirc;le Index, compilez le projet. Le m&ecirc;me index s'affiche dans le r&eacute;sultat final.
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
261
GLOSSAIRES
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
CHAPITRE 7
ASTUCE : Vous pouvez utiliser d'autres fichiers d'index dans votre projet. Copiez le fichier HHK et les
fichiers qui lui sont associ&eacute;s (rubriques, images, fichiers multim&eacute;dia) pour s&eacute;lectionner le fichier HHK
contenant le contr&ocirc;le d'index.
Association de mots-cl&eacute;s et d'&eacute;l&eacute;ments de table des mati&egrave;res pour personnaliser les
fen&ecirc;tres et les cadres (HTML Help)
Les fen&ecirc;tres personnalis&eacute;es peuvent afficher l'aide contextuelle et les liens &agrave; partir des mots-cl&eacute;s d'index,
des livres et des pages de table des mati&egrave;res.
1) Cr&eacute;ez une fen&ecirc;tre ou un cadre personnalis&eacute;.
2) Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Dans le conteneur Table des mati&egrave;res, cliquez avec le bouton droit de la souris sur un livre ou
sur une page. S&eacute;lectionnez Propri&eacute;t&eacute;s.
–
Dans le conteneur Index, cliquez avec le bouton droit de la souris sur un mot-cl&eacute; de fichier
d'index. S&eacute;lectionnez Propri&eacute;t&eacute;s.
3)
4)
5)
6)
Cliquez sur l'onglet Avanc&eacute;.
Dans le menu contextuel Fen&ecirc;tre, s&eacute;lectionnez une fen&ecirc;tre personnalis&eacute;e.
Dans le menu contextuel Cadre, s&eacute;lectionnez un cadre personnalis&eacute;.
Cliquez sur OK.
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
REMARQUE : Microsoft HTML Help ne prend pas en charge les liens &agrave; partir de rubriques vers des fen&ecirc;tres
personnalis&eacute;es (uniquement les liens vers des fen&ecirc;tres contextuelles).
LIENS CONNEXES :
Lien vers des fen&ecirc;tres contextuelles
Indexation automatique via l'assistant d'index dynamique
7.4.
Glossaires
Cr&eacute;ation de termes de glossaire
1)
2)
3)
Dans le conteneur Gestionnaire de projets, cliquez deux fois sur un glossaire dans le dossier
Glossaire.
Dans le conteneur Glossaire, saisissez un terme dans la zone Terme.
Cliquez sur le bouton Ajouter le terme (signe plus) ou appuyez sur Entr&eacute;e.
Le terme s'affiche en caract&egrave;res gras, indiquant qu'il n'est pas d&eacute;fini.
262
CHAPITRE 7
4)
5)
GLOSSAIRES
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
Dans le volet D&eacute;finition de, saisissez une d&eacute;finition.
Vous ne pouvez pas utiliser de texte format&eacute;, d'onglets ou de retours.
ASTUCE : Ajoutez des zones cliquables de glossaire &agrave; d&eacute;velopper pour que les termes et d&eacute;finitions
s'affichent dans les rubriques.
Le cas &eacute;ch&eacute;ant, activez l'onglet Glossaire dans l'assistant de mise en page source unique de sorte
qu'il apparaisse dans la sortie. Ajoutez au minimum un terme et sa d&eacute;finition pour activer la case &agrave;
cocher du glossaire dans l'assistant de mise en page source unique.
REMARQUE : (Microsoft HTML Help) Lorsque vous distribuez la sortie finale, ajoutez un fichier
HHActiveX.DLL au fichier CHM. Ce fichier DLL est le contr&ocirc;le ActiveX&reg; qui prend en charge les glossaires
en ligne. Ce fichier doit &ecirc;tre copi&eacute; et enregistr&eacute; sur le syst&egrave;me Windows de l'utilisateur final.
Importation de termes de glossaire et de d&eacute;finitions
ASTUCE : Avant d'importer un fichier de glossaire (GLO), imprimez un rapport d&eacute;taill&eacute; sur les deux
glossaires. Ce rapport peut vous aider &agrave; distinguer les termes qui apparaissent dans les deux glossaires et
&agrave; comparer les d&eacute;finitions.
1) Dans le conteneur Gestionnaire de projets, s&eacute;lectionnez un glossaire dans le dossier Glossaire.
2) S&eacute;lectionnez Projet &gt; Importer &gt; Glossaire.
3) Cliquez sur le bouton Parcourir pour acc&eacute;der &agrave; un fichier GLO.
4) Vous pouvez effectuer ou combiner les op&eacute;rations suivantes :
–
Pour remplacer les d&eacute;finitions du glossaire par celles des termes correspondants du glossaire
externe, s&eacute;lectionnez Remplacer des d&eacute;finitions existantes du glossaire.
–
S&eacute;lectionnez un ou plusieurs termes dans la liste Termes du glossaire import&eacute;. Cliquez sur
Ajouter.
–
Pour importer tous les termes, cliquez sur Ajouter tout .
5)
Cliquez sur OK.
Test et impression de glossaires
Test du glossaire dans le r&eacute;sultat
1)
2)
3)
4)
5)
V&eacute;rifiez que le conteneur Glossaire est activ&eacute;.
G&eacute;n&eacute;rez une mise en page.
Cliquez sur Afficher le r&eacute;sultat.
Cliquez sur Glossaire.
S&eacute;lectionnez les termes et affichez leurs d&eacute;finitions.
263
CHAPITRE 7
GLOSSAIRES
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
Impression de glossaire
1)
2)
3)
Cliquez sur le conteneur Glossaire.
Sur la barre d'outils, cliquez sur Imprimer.
Dans le menu contextuel, s&eacute;lectionnez les informations &agrave; imprimer.
Pr&eacute;sentation
Imprimez tous les termes.
D&eacute;tails
Imprimez tous les termes et d&eacute;finitions.
4)
5)
Cliquez sur Propri&eacute;t&eacute;s, puis sur Configuration de la page pour sp&eacute;cifier les options d'impression.
Cliquez sur OK.
Suppression de termes du glossaire
La suppression de termes ne supprime pas les zones cliquables &agrave; d&eacute;velopper du glossaire. Supprimez les
zones cliquables s&eacute;par&eacute;ment.
1) Dans le conteneur Gestionnaire de projets, cliquez deux fois sur un glossaire dans le dossier
Glossaire.
2) Dans le conteneur Glossaire, s&eacute;lectionnez un terme dans la liste.
3) Dans la barre d'outils, cliquez sur Supprimer.
LIENS CONNEXES :
Zones cliquables de glossaire
Modification des d&eacute;finitions de glossaire
REMARQUE : Pour modifier une d&eacute;finition de zone cliquable de glossaire &agrave; d&eacute;velopper, mettez le projet &agrave;
jour &agrave; l'aide de l'assistant de cr&eacute;ation de zones cliquables de glossaire.
1) Dans le conteneur Glossaire, s&eacute;lectionnez le terme &agrave; modifier.
2) Modifiez le texte de la d&eacute;finition.
264
CHAPITRE 7
GLOSSAIRES
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
Cr&eacute;ation de plusieurs glossaires
Vous pouvez cr&eacute;er plusieurs glossaires dans le m&ecirc;me projet. Les nouveaux glossaires sont ajout&eacute;s au
dossier Glossaire.
Vous pouvez copier et faire glisser les termes vers plusieurs index.
REMARQUE : Vous ne pouvez pas supprimer le glossaire par d&eacute;faut.
1) Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Dans le conteneur Gestionnaire de projets, cliquez avec le bouton droit de la souris dans le
dossier Glossaire. S&eacute;lection du nouveau glossaire.
–
Cliquez sur le bouton Cr&eacute;er/Afficher un glossaire . Cliquez sur Nouveau.
2)
3)
Saisissez un nom dans la zone de texte.
(Facultatif) Pour copier un glossaire existant, s&eacute;lectionnez Copier un glossaire existant. Cliquez sur
le bouton Parcourir pour acc&eacute;der au glossaire.
ASTUCE : Cliquez sur le bouton Assistant de cr&eacute;ation de zones cliquables de glossaire
de la barre d'outils
pour marquer les termes de glossaire existants dans les rubriques.
Fusion de glossaires
1)
2)
3)
4)
5)
6)
7)
Dans le conteneur Gestionnaire de projets, ouvrez le dossier Glossaire.
Cliquez deux fois sur un glossaire.
Cliquez sur le bouton Importer un glossaire .
Cliquez sur le bouton Dossier . S&eacute;lectionnez le glossaire &agrave; fusionner. Cliquez sur Ouvrir.
Si n&eacute;cessaire, d&eacute;s&eacute;lectionnez Remplacer des d&eacute;finitions existantes du glossaire.
S&eacute;lectionnez cette option pour remplacer les d&eacute;finitions existantes du glossaire par les d&eacute;finitions du
glossaire fusionn&eacute;.
S&eacute;lectionnez des termes dans la liste du glossaire import&eacute;. Cliquez sur la fl&egrave;che droite simple pour
les fusionner. Cliquez sur la fl&egrave;che droite double pour fusionner tous les termes.
REMARQUE : S&eacute;lectionnez des termes dans la liste du projet en cours et cliquez sur les fl&egrave;ches gauches
pour d&eacute;s&eacute;lectionner les termes s&eacute;lectionn&eacute;s pour la fusion.
Cliquez sur OK.
Les termes fusionn&eacute;s s'affichent dans le conteneur Glossaire.
LIENS CONNEXES :
Zones cliquables de glossaire
265
ZONES CLIQUABLES DE GLOSSAIRE
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
CHAPITRE 7
7.5.
Zones cliquables de glossaire
A propos des zones cliquables de glossaire &agrave; d&eacute;velopper
L'assistant de cr&eacute;ation de zones cliquables de glossaire trouve les termes de glossaire dans les rubriques
et les marque. Vous pouvez marquer tous les termes &agrave; convertir en zones cliquables &agrave; d&eacute;velopper
pendant la g&eacute;n&eacute;ration ou la pr&eacute;visualisation de la sortie.
Remarques
•
•
•
•
•
Pour utiliser des zones cliquables de glossaire, vous devez disposer d'Internet Explorer 4.0 ou
version ult&eacute;rieure. Leur utilisation dans un style n&eacute;cessite Internet Explorer 5.0 ou version
ult&eacute;rieure. Netscape Navigator ne prend pas en charge les zones cliquables de glossaire &agrave;
d&eacute;velopper.
Le volet Glossaire n'est pas pris en charge dans Oracle Help. Les d&eacute;finitions apparaissent en ligne et
non dans une zone cliquable.
Le glossaire appara&icirc;t &agrave; la fin de la page dans la version imprim&eacute;e de la documentation.
Contr&ocirc;lez l'apparence de la zone cliquable en modifiant le terme de glossaire et le style de caract&egrave;re
dans l'&eacute;diteur Styles (accessible depuis le bouton Feuilles de style du conteneur Gestionnaire de
produit).
Le script Output Generator With Glossary Restyling modifie le style du glossaire sous forme de
fen&ecirc;tres contextuelles ou infos-bulle et g&eacute;n&egrave;re une sortie pour une mise en page s&eacute;lectionn&eacute;e. Voir
A propos de la prise en charge de ExtendScript Toolkit.
Ajout de zones cliquables de glossaire &agrave; d&eacute;velopper
1)
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Faites glisser un terme du conteneur Glossaire vers une rubrique.
Utilisez cette m&eacute;thode si le terme n'appara&icirc;t pas dans la rubrique ou s'il se trouve dans une
zone o&ugrave; il sera malais&eacute; de le d&eacute;velopper.
–
Dans le conteneur Glossaire, cliquez sur le bouton de l'assistant de cr&eacute;ation de zones
cliquables de glossaire .
L'assistant de cr&eacute;ation de zones cliquables de glossaire trouve les termes de glossaire dans les
rubriques et les marque. Vous pouvez marquer tous les termes &agrave; convertir en zones cliquables
&agrave; d&eacute;velopper pendant la g&eacute;n&eacute;ration ou la pr&eacute;visualisation de la sortie.
Affichez un aper&ccedil;u de la zone cliquable en cliquant deux fois dessus dans l'&eacute;diteur de conception.
266
CHAPITRE 7
ZONES CLIQUABLES DE GLOSSAIRE
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
Mise &agrave; jour de zones cliquables de glossaire &agrave; d&eacute;velopper
L'assistant de cr&eacute;ation de zones cliquables de glossaire ins&egrave;re des marqueurs pour les termes d&eacute;finis dans
le glossaire s&eacute;lectionn&eacute;. Il n'ins&egrave;re pas de d&eacute;finitions pour les termes de la rubrique. Lorsque vous
g&eacute;n&eacute;rez un aper&ccedil;u ou une sortie, RoboHelp ajoute des d&eacute;finitions pour les termes. Ainsi, les rubriques
disposent toujours des d&eacute;finitions mises &agrave; jour des termes marqu&eacute;s.
1) S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Glossaire et cliquez sur Assistant de cr&eacute;ation de zones
cliquables de glossaire.
2) S&eacute;lectionnez les options. Dans le menu S&eacute;lectionner un terme, s&eacute;lectionnez un terme seul ou tous
les termes.
Confirmer le marquage des termes pour chaque rubrique
S&eacute;lectionnez cette option pour choisir les termes des rubriques devant &ecirc;tre marqu&eacute;s afin d'&ecirc;tre
d&eacute;velopp&eacute;s comme zones cliquables de glossaire.
Marquer automatiquement les termes pour toutes les rubriques
Indiquez &agrave; l'assistant de cr&eacute;ation de zones cliquables de glossaire qu'il doit marquer tous les termes
de glossaire trouv&eacute;s dans les rubriques afin de les d&eacute;velopper en tant que zones cliquables de
glossaire.
Respect de la casse
Rend la recherche sensible &agrave; la casse.
Marquer uniquement la premi&egrave;re instance du terme dans la rubrique et ne pas marquer les instances
suivantes
S&eacute;lectionnez cette option pour faire de la premi&egrave;re instance marqu&eacute;e d'un terme une zone
cliquable de glossaire &agrave; d&eacute;velopper lorsque vous g&eacute;n&eacute;rez un aper&ccedil;u ou une sortie.
3)
4)
5)
6)
Cliquez sur Suivant.
S&eacute;lectionnez un terme &agrave; marquer dans un chapitre.
Pour assigner la nouvelle d&eacute;finition au terme, cochez la case en regard du terme qui ne correspond
pas.
Cliquez sur Suivant. R&eacute;p&eacute;tez ces &eacute;tapes pour chaque rubrique qui s'affiche dans l'assistant de
cr&eacute;ation de zones cliquables de glossaire.
Cliquez sur Terminer.
Test des zones cliquables de glossaire &agrave; d&eacute;velopper
1)
2)
3)
4)
Dans le conteneur Liste des rubriques, cliquez avec le bouton droit de la souris sur la rubrique
contenant la zone cliquable.
Cliquez sur Afficher.
Cliquez sur le terme de glossaire dans la rubrique.
Cliquez &agrave; nouveau sur le terme pour fermer la zone cliquable.
267
CHAPITRE 7
ZONES CLIQUABLES DE GLOSSAIRE
TABLES DES MATI&Egrave;RES, INDEX ET GLOSSAIRES
Annulation du marquage des zones cliquables de glossaire &agrave; d&eacute;velopper
Annulation du marquage des zones cliquables &agrave; l'aide de l'assistant de cr&eacute;ation de zones cliquables de
glossaire
1)
2)
3)
4)
5)
6)
7)
S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Glossaire et cliquez sur Assistant de cr&eacute;ation de zones
cliquables de glossaire.
S&eacute;lectionnez Confirmer l'ajout de d&eacute;finitions pour chaque rubrique.
S&eacute;lectionnez un dossier et un &eacute;tat dans lesquels faire des recherches.
Dans le menu S&eacute;lectionner un terme, s&eacute;lectionnez le terme &agrave; supprimer.
Cliquez sur Suivant.
A mesure que chaque rubrique s'affiche, d&eacute;s&eacute;lectionnez les cases &agrave; cocher en regard des termes
dont vous souhaitez supprimer les zones cliquables de glossaire &agrave; d&eacute;velopper.
Cliquez sur Terminer.
Annulation du marquage des zones cliquables dans la vue Conception
1)
2)
Ouvrez la rubrique dans l'onglet Conception. S&eacute;lectionnez le terme.
Cliquez dessus avec le bouton droit de la souris et s&eacute;lectionnez Supprimer le texte d&eacute;velopp&eacute;.
Vous pouvez cliquer sur les d&eacute;finitions des termes de glossaire marqu&eacute;s dans l'affichage des d&eacute;finitions
du glossaire, mais vous ne pouvez pas modifier la d&eacute;finition du terme.
REMARQUE : Lorsque vous proc&eacute;dez &agrave; la mise &agrave; niveau d'un glossaire depuis une version ant&eacute;rieure, toutes
les modifications locales sont perdues.
268
EL&Eacute;MENTS DE NAVIGATION DE BASE
LIAISON, NAVIGATION ET RECHERCHE
CHAPITRE 8
8.
Liaison, navigation et recherche
8.1.
El&eacute;ments de navigation de base
Options de navigation
Les options de navigation suivantes sont disponibles dans les syst&egrave;mes d'aide.
Liens hypertexte
Ouvrent la destination du lien.
Fen&ecirc;tres contextuelles
Affichent une rubrique HTML dans une fen&ecirc;tre contextuelle plut&ocirc;t que dans l'afficheur par d&eacute;faut.
Les fen&ecirc;tres contextuelles ne peuvent &ecirc;tre li&eacute;es qu'&agrave; une autre rubrique HTML ou &agrave; des signets.
Contr&ocirc;les Lien
Objet cliquable permettant d'acc&eacute;der &agrave; une liste de rubriques connexes. Il existe trois types
de contr&ocirc;les Lien : Voir aussi, Rubriques connexes et Lien de mot-cl&eacute;.
Chemins de navigation
Ces liens s'affichent dans la page d'aide pour indiquer l'emplacement de la page dans la table
des mati&egrave;res ou dans la structure du r&eacute;pertoire du projet.
S&eacute;quences de navigation
S&eacute;rie de rubriques. Vous d&eacute;finissez l'ordre des rubriques dans la s&eacute;quence.
Recherche
Recherchez des rubriques contenant des mots-cl&eacute;s de recherche. Les r&eacute;sultats de la recherche
s'affichent sous la forme de liens dans l'onglet Rechercher du volet de navigation. Les mots-cl&eacute;s
de recherche sont mis en surbrillance dans le volet de la rubrique.
Barres de navigation dans une rubrique
Barres de navigation ajout&eacute;es dans une mise en page &agrave; l'aide du type de sortie WebHelp.
Zones cliquables &agrave; d&eacute;velopper, zones cliquables d&eacute;roulantes et images Twisties
Lien de texte qui se d&eacute;veloppe pour afficher des informations suppl&eacute;mentaires, mais pas d'autre
rubrique. Ces zones cliquables sont disponibles dans les navigateurs prenant en charge le format
HTML dynamique (DHTML).
269
CHAPITRE 8
EL&Eacute;MENTS DE NAVIGATION DE BASE
LIAISON, NAVIGATION ET RECHERCHE
Fen&ecirc;tre contextuelle texte uniquement
Il s'agit d'une fen&ecirc;tre qui n'affiche que du texte, pas de rubriques ni de pages Web. Les fen&ecirc;tres
contextuelles purement textuelles s'utilisent notamment pour les d&eacute;finitions ou les d&eacute;tails.
Contrairement aux fen&ecirc;tres contextuelles classiques, une fen&ecirc;tre contextuelle texte uniquement
r&eacute;side dans la rubrique qui la contient. Il ne s'agit pas d'une rubrique s&eacute;par&eacute;e.
Mappages d'image
Image dans une rubrique HTML qui contient des liens graphiques vers d'autres rubriques. Il faut
cliquer sur l'image.
Liens d'image
Lien d'une image qui envoie les utilisateurs vers une destination ou qui ouvre une fen&ecirc;tre contextuelle.
La cr&eacute;ation de liens d'image est similaire &agrave; celle des liens de texte.
Signets
Lien qui renvoie les utilisateurs &agrave; un endroit sp&eacute;cifique d'une rubrique.
Contr&ocirc;le de rubrique WinHelp
(Microsoft HTML Help uniquement) Un objet cliquable qui ouvre un syst&egrave;me WinHelp.
Vous pouvez sp&eacute;cifier nombre de ses fonctionnalit&eacute;s via les param&egrave;tres de la bo&icirc;te de dialogue
Propri&eacute;t&eacute;s &gt; Navigation correspondant &agrave; la mise en page sp&eacute;cifique.
Afficher le lien du volet de navigation dans les rubriques
Inclut un lien vers le volet de navigation dans les rubriques d'aide contextuelle.
Ajouter des liens de chemins de navigation
Ajoute des chemins de navigation dans les pages des rubriques.
Afficher la table des mati&egrave;res fusionn&eacute;e dans le projet enfant
Permet d'afficher la table des mati&egrave;res fusionn&eacute;e dans le projet enfant.
Format
Permet de modifier le format des chemins de navigation.
Afficher le contexte dans les r&eacute;sultats de la recherche
(WebHelp, FlashHelp) Permet d'afficher le contexte des rubriques dans les r&eacute;sultats de la recherche.
Activer la mise en surbrillance des r&eacute;sultats de recherche
Met en surbrillance les r&eacute;sultats de recherche dans les rubriques. S&eacute;lectionnez la couleur de mise
en surbrillance des r&eacute;sultats de recherche.
270
CHAPITRE 8
EL&Eacute;MENTS DE NAVIGATION DE BASE
LIAISON, NAVIGATION ET RECHERCHE
Ajouter la bo&icirc;te de dialogue A propos de
Permet de d&eacute;finir les informations affich&eacute;es dans une fen&ecirc;tre dynamique lorsque les utilisateurs
cliquent sur l'image de la barre d'outils principale.
Exemple de champ A propos
S&eacute;quences de navigation
Cr&eacute;ez des s&eacute;quences de navigation avant de les activer.
D&eacute;tail
Permet de modifier le texte affich&eacute; pour les &eacute;l&eacute;ments de la barre de navigation dans une rubrique.
Champ de saisie de la recherche dans la barre d'outils
Permet d'ins&eacute;rer un champ de recherche dans la barre d'outils principale.
Synchroniser la table des mati&egrave;res
Synchronisez la table des mati&egrave;res avec la rubrique affich&eacute;e dans le volet droit afin que les utilisateurs
puissent se rep&eacute;rer au sein de la structure.
•
•
Pour synchroniser automatiquement la table des mati&egrave;res, cliquez sur le menu contextuel, puis
s&eacute;lectionnez Automatiquement.
Pour ajouter un bouton permettant aux utilisateurs de synchroniser la table des mati&egrave;res, cliquez
sur le menu contextuel (), puis s&eacute;lectionnez Manuellement.
REMARQUE : Si vous utilisez des habillages personnalis&eacute;s, fournissez une ic&ocirc;ne de bouton dans l'&eacute;diteur
d'habillages WebHelp.
A propos des chemins de navigation
Les chemins de navigation sont des liens permettant de naviguer au sein des diff&eacute;rentes pages Web
composant le syst&egrave;me d'aide. Ces liens indiquent la position de la page dans la table des mati&egrave;res
ou la structure de r&eacute;pertoires du projet. Vous pouvez d&eacute;finir des chemins de navigation dans une page
principale ou une rubrique. Ils peuvent &eacute;galement &ecirc;tre configur&eacute;s au moment de l'ex&eacute;cution afin d'appara&icirc;tre
en haut ou en bas d'une page.
L'utilisateur peut cliquer sur une partie du chemin de navigation pour acc&eacute;der directement &agrave; une page.
Par exemple, si le chemin de navigation est Accueil &gt; Installation &gt; Configuration mat&eacute;rielle requise,
l'utilisateur peut cliquer sur Installation pour acc&eacute;der directement &agrave; la page Installation.
Les chemins de navigation s'affichent dans les projets fusionn&eacute;s. Dans le cas d'un projet fusionn&eacute;, le chemin
de navigation indique la position de la page par rapport au projet fusionn&eacute;, mais &eacute;galement par rapport
au projet ma&icirc;tre.
271
CHAPITRE 8
EL&Eacute;MENTS DE NAVIGATION DE BASE
LIAISON, NAVIGATION ET RECHERCHE
Supposons par exemple que le projet ma&icirc;tre MultiCuisine contient le projet Cuisine asiatique. Le projet
Cuisine asiatique contient &agrave; son tour le projet Recettes japonaises. Le chemin de navigation de la rubrique
&laquo; Ingr&eacute;dients japonais courants &raquo; est le suivant :
Accueil &gt; MultiCuisine &gt; Cuisine asiatique &gt; Recettes japonaises
Les chemins de navigation sont g&eacute;n&eacute;r&eacute;s uniquement dans WebHelp, WebHelp Pro, FlashHelp, FlashHelp
Pro, HTML Help et AIR Help. Pour toutes les autres mises en page, les chemins de navigation ne sont pas
g&eacute;n&eacute;r&eacute;s, m&ecirc;me si des espaces r&eacute;serv&eacute;s sont pr&eacute;sents.
Ajout de chemins de navigation aux rubriques
1)
2)
S&eacute;lectionnez Sortie &gt; Ouvrir &gt; Sorties (SSL).
Cliquez deux fois sur la mise en page WebHelp/WebHelp Pro/FlashHelp/FlashHelp Pro et proc&eacute;dez
comme suit :
–
(WebHelp) Dans le volet Navigation, s&eacute;lectionnez l'option Ajouter des liens de chemins
de navigation, puis cliquez sur Format.
–
(WebHelp Pro/FlashHelp/FlashHelp Pro) Cliquez sur Suivant. S&eacute;lectionnez l'option Ajouter
des liens de chemins de navigation et cliquez sur Format.
3)
Dans la zone Mise en page, s&eacute;lectionnez le positionnement et l'alignement des chemins
de navigation.
4) Dans la zone Texte, s&eacute;lectionnez un nom ou sp&eacute;cifiez-en un pour le lien vers la page d'aide
principale. Ce nom s'affiche sur chaque page de rubrique.
5) S&eacute;lectionnez un s&eacute;parateur de chemins de navigation.
6) Saisissez un libell&eacute; pr&eacute;c&eacute;dant les chemins de navigation. Vous pouvez par exemple ajouter le texte
statique &laquo; Vous &ecirc;tes ici &raquo; avant le chemin de navigation.
7) Affichez un aper&ccedil;u de la mise en page et du formatage des chemins de navigation dans le conteneur
Aper&ccedil;u.
8) S&eacute;lectionnez une couleur pour l'arri&egrave;re-plan.
9) (Facultatif) S&eacute;lectionnez Utiliser le format au niveau sup&eacute;rieur pour appliquer les param&egrave;tres
de format par d&eacute;faut.
10) (Facultatif) Cliquez sur Format pour modifier les param&egrave;tres de police par d&eacute;faut.
11) Cliquez sur OK, puis sur Terminer.
Dans le syst&egrave;me WebHelp g&eacute;n&eacute;r&eacute;, toutes les pages de rubrique affichent les chemins de navigation
refl&eacute;tant la hi&eacute;rarchie de la table des mati&egrave;res.
LIENS CONNEXES :
Insertion d'un espace r&eacute;serv&eacute;
272
CR&Eacute;ATION DE LIENS DE TEXTE
LIAISON, NAVIGATION ET RECHERCHE
CHAPITRE 8
8.2.
Cr&eacute;ation de liens de texte
Vous pouvez cr&eacute;er des liens avec la plupart des &eacute;l&eacute;ments que vous voyez dans le gestionnaire de projets
et le module de composition de la table des mati&egrave;res. Ces &eacute;l&eacute;ments regroupent les rubriques, les signets,
les URL, les fichiers bagage, les groupes de discussion, les sites FTP, les fichiers (par exemple, les fichiers PDF)
associ&eacute;s &agrave; d'autres programmes et les rubriques distantes.
Cr&eacute;ation de liens de texte avec l'&eacute;diteur de conception
1)
2)
3)
4)
Dans l'&eacute;diteur de conception, s&eacute;lectionnez le point d'insertion du lien.
Cliquez sur le bouton Ins&eacute;rer un hyperlien .
S&eacute;lectionnez une option dans le menu Lien vers. Dans le champ, sp&eacute;cifiez l'emplacement source.
Si l'option Afficher dans cadre est s&eacute;lectionn&eacute;e, s&eacute;lectionnez une option dans le menu contextuel.
Afficher dans cadre
Si la destination est un cadre, cette option permet de d&eacute;finir le jeu de cadres dans lequel s'affichera
le contenu. Vous pouvez s&eacute;lectionner le type de cadre ou saisir les informations sur un cadre
personnalis&eacute;. Cette option n'est pas disponible pour les liens vers les rubriques.
Afficher dans fen&ecirc;tre contextuelle &agrave; redimensionnement auto
Affiche la rubrique de destination dans une fen&ecirc;tre contextuelle plut&ocirc;t que dans l'afficheur
ou le navigateur. La taille de la fen&ecirc;tre s'adapte au contenu. Si la rubrique est longue, utilisez plut&ocirc;t
une fen&ecirc;tre contextuelle redimensionn&eacute;e de mani&egrave;re personnalis&eacute;e.
Afficher dans fen&ecirc;tre contextuelle redimensionn&eacute;e de mani&egrave;re personnalis&eacute;e
Affiche la rubrique de destination dans une fen&ecirc;tre contextuelle. Pour d&eacute;finir manuellement
les dimensions de la fen&ecirc;tre, saisissez des chiffres dans les champs Largeur et Hauteur. Si le texte
d&eacute;passe les dimensions indiqu&eacute;es, des barres de d&eacute;filement seront incluses dans la fen&ecirc;tre.
Cette option n'est disponible que pour les liens vers des rubriques.
5)
6)
Ajoutez du texte d'aide &agrave; l'&eacute;cran devant appara&icirc;tre lorsque vous placez la souris sur le lien.
S&eacute;lectionnez une rubrique, un signet, une URL ou un cadre local existant dans votre projet en tant
que destination du lien. Pour filtrer la liste, cliquez sur le triangle.
Cr&eacute;ation de liens par glisser-d&eacute;poser
1)
2)
3)
Dans l'&eacute;diteur de conception, s&eacute;lectionnez l'&eacute;l&eacute;ment dans la rubrique correspondant &agrave; la zone
cliquable. S&eacute;lectionnez un texte, une image ou un objet multim&eacute;dia.
Dans le conteneur Gestionnaire de projets, ouvrez le dossier contenant l'&eacute;l&eacute;ment de destination
(tel qu'une URL dans le dossier du m&ecirc;me nom ou une rubrique dans un dossier personnalis&eacute;).
Recherchez et s&eacute;lectionnez l'&eacute;l&eacute;ment de destination.
273
LIEN VERS DES FEN&Ecirc;TRES CONTEXTUELLES
LIAISON, NAVIGATION ET RECHERCHE
CHAPITRE 8
4)
5)
(Facultatif) Cliquez sur l'onglet Table des mati&egrave;res pour afficher le module de composition de table
des mati&egrave;res ou sur l'onglet Projet pour afficher le gestionnaire de projets.
Faites glisser l'&eacute;l&eacute;ment de destination depuis le conteneur Gestionnaire de projets ou Liste des rubriques
vers l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans l'&eacute;diteur de conception.
REMARQUE : Les rubriques associ&eacute;es &agrave; des types d'informations ne sont pas prises en charge en tant que
liens.
LIENS CONNEXES :
Mappages d'image
8.3.
Lien vers des fen&ecirc;tres contextuelles
Vous pouvez cr&eacute;er un lien permettant d'afficher une rubrique HTML dans une fen&ecirc;tre contextuelle plut&ocirc;t
que dans le navigateur ou l'afficheur par d&eacute;faut. Une fen&ecirc;tre contextuelle prend en charge la mise en forme
HTML, les images, le format HTML dynamique, les contr&ocirc;les Lien et les autres fonctionnalit&eacute;s HTML
de la rubrique de destination. Lorsqu'un utilisateur clique sur le lien, la fen&ecirc;tre contextuelle s'affiche
et adapte ses dimensions au contenu de la rubrique ou aux param&egrave;tres pr&eacute;alablement d&eacute;finis.
Une fen&ecirc;tre contextuelle s'utilise uniquement pour lier un &eacute;l&eacute;ment vers une rubrique ou un signet du projet.
1) Dans l'&eacute;diteur de conception, placez le curseur sur l'emplacement souhait&eacute; ou s&eacute;lectionnez du texte
ou une image pour cr&eacute;er une zone cliquable.
2) Dans la barre d'outils, cliquez sur le bouton Ins&eacute;rer une fen&ecirc;tre contextuelle .
3) S&eacute;lectionnez les options d'hyperlien.
4) S&eacute;lectionnez une option de taille. Si vous choisissez une fen&ecirc;tre contextuelle redimensionn&eacute;e
de mani&egrave;re personnalis&eacute;e, indiquez des valeurs (en points) dans les champs Largeur et Hauteur.
REMARQUE : Sur certains p&eacute;riph&eacute;riques, le d&eacute;filement peut ne pas fonctionner dans les fen&ecirc;tres
contextuelles automatiques/personnalis&eacute;es des sorties Multi-&eacute;cran HTML5.
5) Sous S&eacute;lectionner une destination (fichier ou URL), s&eacute;lectionnez une rubrique , un signet
ou un jeu de cadres.
6) Cliquez sur OK.
REMARQUE : Les liens vers une fen&ecirc;tre contextuelle d&eacute;finis dans une autre fen&ecirc;tre contextuelle ne
s'affichent pas dans l'afficheur HTML Help ou dans Internet Explorer.
Exclusion des fen&ecirc;tres contextuelles des recherches de texte int&eacute;gral
1)
2)
3)
4)
Cr&eacute;ez un mini-projet HTML Help avec des rubriques contextuelles.
G&eacute;n&eacute;rez le projet pour cr&eacute;er un fichier CHM.
Liez-le aux rubriques contextuelles dans le second fichier CHM. (Ne fusionnez pas les deux syst&egrave;mes
d'aide.)
Distribuez les deux fichiers CHM aux utilisateurs.
LIENS CONNEXES :
Fen&ecirc;tres contextuelles purement textuelles
274
SIGNETS
LIAISON, NAVIGATION ET RECHERCHE
CHAPITRE 8
8.4.
Signets
Les signets permettent de cr&eacute;er des liens incr&eacute;mentiels au sein d'une rubrique. Vous pouvez cr&eacute;er un lien
vers un signet &agrave; partir de la rubrique elle-m&ecirc;me, &agrave; partir de toute autre rubrique du projet ou &agrave; partir
d'une entr&eacute;e d'index, d'une entr&eacute;e de la table des mati&egrave;res ou d'un mappage d'image. L'ic&ocirc;ne de signet
s'affiche en regard des objets associ&eacute;s &agrave; un signet. Pour afficher les signets d'une rubrique &agrave; partir
du gestionnaire de projets, cliquez sur le signe plus en regard de la rubrique.
Cr&eacute;ation d'un signet
1)
2)
Cliquez &agrave; gauche de l'emplacement du signet.
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Cliquez sur l'ic&ocirc;ne Ins&eacute;rer un signet .
–
S&eacute;lectionnez Ins&eacute;rer &gt; Liens &gt; Signet.
3)
Saisissez un nom compos&eacute; de chiffres et de lettres, sans espaces.
Apr&egrave;s avoir enregistr&eacute; la rubrique, les ic&ocirc;nes des signets apparaissent en retrait sous les rubriques
affich&eacute;es dans le conteneur Gestionnaire de projets et en regard des rubriques dans le conteneur
Liste des rubriques.
Cr&eacute;ation d'un lien vers un signet
1)
2)
3)
4)
Ouvrez la destination du lien. Pour cr&eacute;er un lien au sein d'une rubrique, cr&eacute;ez un signet dans
la rubrique.
Dans l'&eacute;diteur de conception, s&eacute;lectionnez l'emplacement du lien, puis cliquez sur le bouton Ins&eacute;rer
un hyperlien .
Sous S&eacute;lectionner une destination (fichier ou URL), s&eacute;lectionnez le signet vers lequel le lien doit
renvoyer.
Cliquez sur l'ic&ocirc;ne Afficher afin de tester le lien.
REMARQUE : Les signets sont group&eacute;s avec leurs rubriques.
Modification du nom d'un signet
1)
2)
3)
4)
Ouvrez une rubrique contenant un signet. S&eacute;lectionnez le signet, cliquez avec le bouton droit
de la souris dessus et s&eacute;lectionnez Propri&eacute;t&eacute;s du signet [nom du signet].
Modifiez le nom et cliquez sur OK.
Annulez l'assignation de l'ID de mappage du signet renomm&eacute; et r&eacute;attribuez-le.
Si le signet est utilis&eacute; dans une aide contextuelle, modifiez l'ID de mappage.
275
LIEN VERS DES IMAGES ET DES OBJETS MULTIM&Eacute;DIA
LIAISON, NAVIGATION ET RECHERCHE
CHAPITRE 8
Acc&egrave;s &agrave; un signet
1)
2)
3)
4)
Ouvrez une rubrique dans l'&eacute;diteur de conception.
S&eacute;lectionnez Ins&eacute;rer &gt; Liens &gt; Aller &agrave; un signet.
S&eacute;lectionnez un signet auquel acc&eacute;der.
Cliquez sur Aller &agrave;.
Suppression d'un signet
1)
2)
Supprimez tous les liens renvoyant vers le signet.
Dans la rubrique, s&eacute;lectionnez l'ic&ocirc;ne de signet. Sur la barre d'outils, cliquez sur le bouton
Supprimer.
LIENS CONNEXES :
Modification d'un ID de mappage
8.5.
Lien vers des images et des objets multim&eacute;dia
Ajout de liens &agrave; des clips multim&eacute;dia
Vous pouvez ins&eacute;rer dans votre projet des liens vers des fichiers image, vid&eacute;o, audio et autres fichiers
multim&eacute;dia.
1) Dans l'&eacute;diteur de conception, placez le curseur sur l'emplacement souhait&eacute; ou s&eacute;lectionnez du texte
ou une image pour cr&eacute;er une zone cliquable.
2) Cliquez sur le bouton Ins&eacute;rer un hyperlien .
3) Dans la zone Lien vers, cliquez sur le triangle et s&eacute;lectionnez l'option Multim&eacute;dia.
4) S&eacute;lectionnez le fichier &agrave; lier. Cliquez sur Ouvrir.
Ajout de liens &agrave; partir d'images et d'objets multim&eacute;dia
Les rubriques peuvent contenir des objets multim&eacute;dia en tant que liens, clips audio ou vid&eacute;o, rubriques
HTML locales ou externes, signets, sites Web ou FTP, courriels ou groupes de discussion.
1) Dans l'&eacute;diteur de conception, s&eacute;lectionnez l'objet multim&eacute;dia ou l'image &agrave; lier.
2) Cliquez sur le bouton Ins&eacute;rer un hyperlien .
–
Pour lier un &eacute;l&eacute;ment &agrave; partir d'un objet multim&eacute;dia, cliquez sur le triangle dans la zone Lien
vers, puis s&eacute;lectionnez l'option Multim&eacute;dia.
–
Pour lier un &eacute;l&eacute;ment &agrave; partir d'une image, s&eacute;lectionnez la destination dans la zone Lien vers.
Une image ne peut contenir qu'un seul lien.
ASTUCE : Pour lier un &eacute;l&eacute;ment de la rubrique &agrave; partir d'un objet audio ou vid&eacute;o, cliquez dessus avec
le bouton droit de la souris et s&eacute;lectionnez le bouton Ins&eacute;rer un hyperlien.
276
LIENS EXTERNES
LIAISON, NAVIGATION ET RECHERCHE
CHAPITRE 8
8.6.
Liens externes
Lien vers des rubriques externes (projets Microsoft HTML Help)
1)
2)
3)
Dans l'&eacute;diteur de conception, s&eacute;lectionnez l'emplacement du lien.
Cliquez sur le bouton Ins&eacute;rer un hyperlien .
Dans la zone Lien vers, cliquez sur le triangle et s&eacute;lectionnez Rubrique distante.
Lien vers des fichiers externes
1)
2)
3)
4)
5)
6)
Choisissez l'emplacement du lien dans l'&eacute;diteur de conception.
Saisissez du texte.
Mettez ce texte en surbrillance et cliquez sur le bouton Ins&eacute;rer un hyperlien
Cliquez sur le triangle en regard de Lien vers et s&eacute;lectionnez Fichier.
Recherchez un fichier, ouvrez-le et copiez-le dans le dossier de votre projet.
G&eacute;n&eacute;rez le fichier pour tester les liens vers des rubriques externes.
.
Projets WebHelp
Le fichier externe doit &ecirc;tre distribu&eacute; dans le dossier WebHelp.
Projets Microsoft HTML Help
Le fichier externe doit &ecirc;tre distribu&eacute; avec le fichier CHM.
REMARQUE : Le fichier CHM externe doit &ecirc;tre stock&eacute; dans le m&ecirc;me dossier que le fichier CHM du projet.
Lien vers des rubriques WinHelp (projets Microsoft HTML Help)
L'ajout de contr&ocirc;les de rubrique WinHelp permet de lier des rubriques HTML &agrave; des rubriques stock&eacute;es
dans un fichier WinHelp.
1) Dans l'&eacute;diteur de conception, placez le curseur &agrave; l'endroit de la rubrique o&ugrave; vous souhaitez ajouter
le contr&ocirc;le.
2) S&eacute;lectionnez Ins&eacute;rer &gt; HTML &gt; Javascript &gt; Rubrique Winhelp.
3) D&eacute;finissez les options des boutons.
4) Cliquez sur Suivant. S&eacute;lectionnez le fichier et la rubrique WinHelp.
5) Cliquez sur Suivant. D&eacute;finissez les options de police pour le libell&eacute; du bouton.
6) Cliquez sur Terminer.
7) Pour tester le projet, vous devez le g&eacute;n&eacute;rer.
277
AFFICHAGE DES LIENS
LIAISON, NAVIGATION ET RECHERCHE
CHAPITRE 8
Lien vers des adresses &eacute;lectroniques, sites FTP, groupes de discussion et adresses Web
1)
2)
3)
Dans l'&eacute;diteur de conception, placez le curseur sur l'emplacement souhait&eacute; ou s&eacute;lectionnez du texte
ou une image pour cr&eacute;er une zone cliquable.
Cliquez sur le bouton Ins&eacute;rer un hyperlien .
Dans la zone Lien vers, cliquez sur le triangle et s&eacute;lectionnez l'une des options suivantes :
–
Courriel pour lier vers un courriel.
–
S&eacute;lectionnez FTP ou Actualit&eacute;s Usenet pour lier vers des sites FTP ou des groupes de discussion.
–
Adresse Web pour lier vers des sites intranet ou Web.
8.7.
Affichage des liens
Utilisez l'affichage des liens pour afficher les liens du projet et les parcourir.
Navigation dans le conteneur Affichage des liens
L'ic&ocirc;ne situ&eacute;e dans le centre du conteneur Affichage des liens repr&eacute;sente la rubrique en cours. Les lignes
situ&eacute;es de chaque c&ocirc;t&eacute; de l'ic&ocirc;ne repr&eacute;sentent les liens entrants et sortants. Chaque ligne est &agrave; code
de couleurs, qui indique le type de lien.
1) S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Affichage des liens. La fen&ecirc;tre d'affichage des liens
s'affiche comme un document dans l'&eacute;diteur de documents.
2) S&eacute;lectionnez le conteneur (volet de travail) duquel vous souhaitez faire glisser les rubriques.
Effectuez l'une des op&eacute;rations suivantes :
–
Pour afficher les rubriques dans le gestionnaire de projets, s&eacute;lectionnez Projet &gt; Ouvrir &gt;
Conteneurs &gt; Gestionnaire de projets.
–
Pour afficher les rubriques dans le module de composition de table des mati&egrave;res, s&eacute;lectionnez
Projet &gt; Ouvrir &gt; Conteneurs &gt; Table des mati&egrave;res.
–
Pour afficher les rubriques dans le concepteur d'index, s&eacute;lectionnez Projet &gt; Ouvrir &gt;
Conteneurs &gt; Index.
3)
4)
S&eacute;lectionnez une rubrique dans la zone Rubriques pour, puis faites-la glisser vers le centre de la fen&ecirc;tre
d'affichage des liens. Cliquez sur les boutons Suivant et Pr&eacute;c&eacute;dent pour afficher les liens associ&eacute;s.
Pour afficher les liens d'une autre rubrique, faites glisser une rubrique et d&eacute;posez-la au-dessus
de celle au centre du groupe pour afficher tous les liens qui lui sont associ&eacute;s.
Modification de l'apparence des liens dans le conteneur Affichage des liens
Modification de la taille des ic&ocirc;nes
1)
2)
S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Affichage des liens.
Cliquez sur le bouton Utiliser une petite ic&ocirc;ne .
REMARQUE : L'info-bulle indique l'action que vous pouvez r&eacute;aliser en cliquant sur les ic&ocirc;nes.
278
GESTION DES LIENS ET R&Eacute;PARATION
LIAISON, NAVIGATION ET RECHERCHE
CHAPITRE 8
D&eacute;finition des options de d&eacute;filement de la fen&ecirc;tre d'affichage des liens
1)
2)
S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Affichage des liens.
Effectuez l'une des op&eacute;rations suivantes :
–
Pour faire d&eacute;filer une rubrique, ainsi que ses rubriques associ&eacute;es, cliquez sur le bouton
Conserver la rubrique &eacute;lastique .
–
Pour faire d&eacute;filer uniquement des hyperliens, cliquez sur le bouton Conserver la rubrique
centr&eacute;e .
–
Pour des projets volumineux, cliquez sur le bouton Afficher les liens limit&eacute;s .
D&eacute;finition des options dans le conteneur Affichage des liens
Cliquez sur les ic&ocirc;nes pour afficher les diff&eacute;rents types de liens.
•
La rubrique en cours appara&icirc;t au centre avec une bordure bleue.
•
Les liens entrants s'affichent &agrave; gauche.
•
Les liens sortants s'affichent &agrave; droite.
D&eacute;finissez l'utilisation de la fen&ecirc;tre d'affichage des liens.
Taille de l'ic&ocirc;ne
D&eacute;finissez la taille des ic&ocirc;nes d'affichage des rubriques. Vous avez le choix entre petites et grandes
ic&ocirc;nes.
Placement de la rubrique centrale
Place le centre avec des liens entrants et sortants.
D&eacute;placer la rubrique centrale &agrave; l'aide de l'option Afficher
Place la rubrique &agrave; faire d&eacute;filer avec les liens dans la fen&ecirc;tre.
Conserver la rubrique centrale centr&eacute;e
Conserve la rubrique centrale immobile tandis que les liens se d&eacute;placent avec la barre
de d&eacute;filement.
8.8.
Gestion des liens et r&eacute;paration
Mise &agrave; jour et suppression de liens
Ouvrez la rubrique contenant le lien. Effectuez l'une des op&eacute;rations suivantes :
•
Pour mettre &agrave; jour le lien, cliquez dessus avec le bouton droit de la souris, s&eacute;lectionnez Propri&eacute;t&eacute;s
de Hyperlien, puis effectuez les modifications n&eacute;cessaires.
•
Pour supprimer un lien, cliquez dessus avec le bouton droit de la souris, puis s&eacute;lectionnez
Supprimer un hyperlien.
•
Pour supprimer le lien et le texte, s&eacute;lectionnez le texte et appuyez sur Suppr.
279
CHAPITRE 8
GESTION DES LIENS ET R&Eacute;PARATION
LIAISON, NAVIGATION ET RECHERCHE
Gestion des liens rompus
Pour identifier des liens rompus, acc&eacute;dez au dossier Liens rompus du gestionnaire de projets. Ce dossier
contient le nom des rubriques manquantes ou supprim&eacute;es r&eacute;f&eacute;renc&eacute;es dans un projet.
1) S&eacute;lectionnez ces options dans le menu Outils pour identifier et r&eacute;parer les liens rompus :
Afficher les liens d'une rubrique
Affiche une rubrique dans la vue Lien.
Affichage de r&eacute;f&eacute;rences de rubrique
Identifie les r&eacute;f&eacute;rences d'une rubrique. Utilisez cette option pour d&eacute;terminer les rubriques
r&eacute;f&eacute;renc&eacute;es dans une table des mati&egrave;res ou un index et si d'autres rubriques leur sont associ&eacute;es.
Activer BugHunter
Outil pour les rubriques contextuelles dans les syst&egrave;mes d'aide Microsoft HTML Help. Utilisez cette
option pour diagnostiquer les probl&egrave;mes susceptibles de survenir lorsque vous liez des syst&egrave;mes
HTML Help &agrave; des applications Windows.
R&eacute;soudre les liens rompus
Identifie les rubriques manquantes ou supprim&eacute;es qui ont provoqu&eacute; la rupture des liens. Utilisez
cette option pour d&eacute;terminer l'origine des ruptures de lien et restaurer les liens des rubriques.
Modifier les r&eacute;f&eacute;rences des rubriques
Permet de consulter les r&eacute;f&eacute;rences des rubriques d'un projet. Utilisez cette option pour d&eacute;terminer
l'origine des r&eacute;f&eacute;rences et les modifier.
Modifier les r&eacute;f&eacute;rences de rubriques externes
Identifie les rubriques externes (telles que des liens distants ou des URL) r&eacute;f&eacute;renc&eacute;es dans un projet.
Utilisez cette option pour les modifier ou les supprimer d'un projet.
R&eacute;paration de liens rompus
1)
S&eacute;lectionnez Projet &gt; Navigation &gt; R&eacute;f&eacute;rences de rubriques &gt; R&eacute;f&eacute;rences de rubriques externes.
–
Pour r&eacute;parer un lien, commencez par en s&eacute;lectionner un. Cliquez ensuite sur Modifier, puis
modifiez ou supprimez l'hyperlien.
–
Pour r&eacute;parer un &eacute;l&eacute;ment de table des mati&egrave;res, un mot-cl&eacute; d'index ou un mappage d'image,
commencez par s&eacute;lectionner l'&eacute;l&eacute;ment. Cliquez ensuite sur Modifier, puis s&eacute;lectionnez une
destination valide pour r&eacute;parer le lien rompu.
–
Pour supprimer une entr&eacute;e de la table des mati&egrave;res, s&eacute;lectionnez-la, puis cliquez sur Supprimer.
Le livre ou la page est alors supprim&eacute; de la table des mati&egrave;res.
REMARQUE : Dans un environnement multi-auteur, si vous utilisez le contr&ocirc;le de version, certains fichiers
peuvent comporter des liens vers des rubriques d&eacute;plac&eacute;es, renomm&eacute;es ou supprim&eacute;es par un autre auteur.
Si vous ne disposez pas des versions les plus r&eacute;centes des fichiers, ils apparaissent en tant que liens rompus.
280
CHAPITRE 8
GESTION DES LIENS ET R&Eacute;PARATION
LIAISON, NAVIGATION ET RECHERCHE
Identification et mise &agrave; jour des r&eacute;f&eacute;rences de rubrique
Identification des r&eacute;f&eacute;rences aux rubriques
1)
Dans le conteneur Liste des rubriques ou Gestionnaire de projets, s&eacute;lectionnez une rubrique.
–
Pour afficher les r&eacute;f&eacute;rences d'une rubrique, cliquez dessus avec le bouton droit de la souris
et s&eacute;lectionnez Afficher &gt; R&eacute;f&eacute;rences de rubrique.
–
Pour afficher les r&eacute;f&eacute;rences de toutes les rubriques du projet, s&eacute;lectionnez Outils &gt; Modifier
les r&eacute;f&eacute;rences des rubriques. Dans la partie droite de la bo&icirc;te de dialogue, s&eacute;lectionnez une
rubrique. La partie gauche affiche toutes les r&eacute;f&eacute;rences des rubriques.
Mise &agrave; jour des r&eacute;f&eacute;rences de rubriques
1)
S&eacute;lectionnez Projet &gt; Navigation &gt; R&eacute;f&eacute;rences de rubriques.
–
Pour r&eacute;parer des liens rompus, s&eacute;lectionnez les liens &agrave; r&eacute;parer dans la zone R&eacute;f&eacute;rences
&agrave; la rubrique s&eacute;lectionn&eacute;e. Cliquez sur Modifier ou supprimez le lien.
LIENS CONNEXES :
Modification d'un mappage d'image
Identification et mise &agrave; jour des r&eacute;f&eacute;rences de rubriques externes
1)
2)
S&eacute;lectionnez Projet &gt; Navigation &gt; R&eacute;f&eacute;rences de rubriques externes.
Effectuez l'une des op&eacute;rations suivantes :
–
Pour identifier des r&eacute;f&eacute;rences externes, s&eacute;lectionnez la rubrique.
–
Pour r&eacute;parer des liens rompus, s&eacute;lectionnez un lien dans la zone R&eacute;f&eacute;rences &agrave; la rubrique
s&eacute;lectionn&eacute;e. Cliquez sur Modifier et apportez les modifications n&eacute;cessaires.
–
Pour r&eacute;soudre ou supprimer des entr&eacute;es et &eacute;l&eacute;ments de table des mati&egrave;res, s&eacute;lectionnez
l'&eacute;l&eacute;ment dans la zone R&eacute;f&eacute;rences &agrave; la rubrique s&eacute;lectionn&eacute;e. Cliquez sur Modifier et s&eacute;lectionnez
une destination ou cliquez sur Supprimer.
REMARQUE : Vous ne pouvez pas modifier les mots-cl&eacute;s d'index dans cette bo&icirc;te de dialogue.
LIENS CONNEXES :
R&eacute;paration de liens rompus
281
CONTR&Ocirc;LES LIEN
LIAISON, NAVIGATION ET RECHERCHE
CHAPITRE 8
Affichage et test des hyperliens
Affichage des hyperliens et identification des s&eacute;quences de navigation
Dans l'&eacute;diteur de conception, cliquez avec le bouton droit de la souris &agrave; l'int&eacute;rieur de la rubrique
et s&eacute;lectionnez Afficher les liens d'une rubrique. Vous pouvez &eacute;galement suivre la proc&eacute;dure ci-dessous.
1) S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Affichage des liens. Le conteneur Affichage des liens
s'affiche.
2) Faites glisser des rubriques depuis le conteneur Gestionnaire de projets vers le conteneur Affichage
des liens.
3) Cliquez dans le conteneur Gestionnaire de projets.
4) D&eacute;veloppez le dossier Fichiers HTML (Rubriques) ou un dossier personnalis&eacute;, puis s&eacute;lectionnez
une rubrique &agrave; afficher.
5) Faites glisser la rubrique vers le conteneur Affichage des liens et d&eacute;posez-la au-dessus de l'ic&ocirc;ne
centrale .
6) Rel&acirc;chez le bouton de la souris pour afficher les liens.
Test des liens dans une rubrique
1)
2)
3)
S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Liste des rubriques. Le conteneur Liste des rubriques
s'affiche.
Cliquez avec le bouton droit de la souris sur la rubrique et s&eacute;lectionnez Afficher.
Cliquez sur les liens pour les tester.
LIENS CONNEXES :
S&eacute;quences de navigation
8.9.
Contr&ocirc;les Lien
A propos des contr&ocirc;les Lien
Les contr&ocirc;les Lien sont, pour la navigation, des alternatives aux tables des mati&egrave;res et index. Un contr&ocirc;le
Lien fonctionne comme un lien et peut s'afficher sous forme de texte, d'un bouton ou d'une image.
REMARQUE : Lorsque vous mettez &agrave; jour une rubrique, v&eacute;rifiez que ses contr&ocirc;les Lien sont aussi mis &agrave; jour.
La suppression d'une rubrique ou la modification de son titre, de son contenu ou de son nom de fichier
peuvent affecter les contr&ocirc;les Lien.
Les contr&ocirc;les Lien fonctionnent de la fa&ccedil;on suivante :
•
Ils dirigent les utilisateurs vers les rubriques et les informations associ&eacute;es. Ils permettent aux
utilisateurs de gagner du temps lors des recherches.
•
Ils servent &agrave; organiser les informations en fonction des diff&eacute;rents types d'utilisateurs.
•
Ils facilitent la gestion du contenu des rubriques. Gr&acirc;ce aux contr&ocirc;les Lien vous pouvez, en effet,
conserver dans une seule rubrique les informations n&eacute;cessaires &agrave; plusieurs rubriques et permettre
d'y acc&eacute;der depuis divers emplacements.
•
Leur pr&eacute;sentation sous forme d'objets au lieu de longues lignes de liens permet de g&eacute;rer la mise
en page des rubriques.
282
CHAPITRE 8
CONTR&Ocirc;LES LIEN
LIAISON, NAVIGATION ET RECHERCHE
Types de contr&ocirc;les Lien
Rubriques connexes
Affiche une liste de rubriques sp&eacute;cifi&eacute;es. Vous pouvez modifier la liste des rubriques connexes,
rubrique par rubrique, selon les besoins des utilisateurs. Les contr&ocirc;les des rubriques connexes
exigent plus de gestion que les autres contr&ocirc;les de liens. Pour ajouter ou supprimer des rubriques,
veillez &agrave; ajouter ou supprimer ces rubriques dans chaque contr&ocirc;le Rubriques connexes.
Voir aussi
Affiche une liste de rubriques que vous groupez dans une cat&eacute;gorie logique. La liste des rubriques
assign&eacute;es aux m&ecirc;mes mots-cl&eacute;s Voir aussi s'affiche lorsque les utilisateurs cliquent sur Voir aussi.
Les contr&ocirc;les Voir aussi sont plus faciles &agrave; g&eacute;rer que les autres contr&ocirc;les, car le groupe de rubriques
est d&eacute;fini dans un emplacement et non dans chaque rubrique. Pensez &agrave; mettre &agrave; jour le contr&ocirc;le
Voir aussi lorsque vous ajoutez ou supprimez des rubriques. Toutes les rubriques contenant
ce contr&ocirc;le sont automatiquement mises &agrave; jour.
Liens de mot-cl&eacute;
Ces contr&ocirc;les permettent de naviguer dans les rubriques par le biais de mots-cl&eacute;s d'index. Les index
groupent les rubriques connexes en fonction des mots-cl&eacute;s qui leur sont assign&eacute;s. Lorsqu'un utilisateur
clique sur un mot-cl&eacute; d'index, une liste de rubriques associ&eacute;es s'affiche. Si vous ajoutez ou supprimez
un mot-cl&eacute; de l'index ou des propri&eacute;t&eacute;s d'une rubrique, le contr&ocirc;le se met &agrave; jour dans toutes les
rubriques auxquelles il est associ&eacute;. Les contr&ocirc;les Lien de mot-cl&eacute; s'utilisent avec les mots-cl&eacute;s
de niveau principal ou les mots-cl&eacute;s d'index parent.
Propri&eacute;t&eacute;s de lien de mot-cl&eacute;
Cette zone permet d'assigner aux contr&ocirc;les Lien de mot-cl&eacute; des mots-cl&eacute;s d'index et des mots-cl&eacute;s
de rubrique appartenant au fichier d'index.
Mots-cl&eacute;s dans le projet
Affiche tous les mots-cl&eacute;s disponibles pour le contr&ocirc;le.
Mots-cl&eacute;s dans le contr&ocirc;le
Affiche les mots-cl&eacute;s attribu&eacute;s au contr&ocirc;le.
Ajouter
S&eacute;lectionnez le mot-cl&eacute; dans la zone Mots-cl&eacute;s dans l'index. S&eacute;lectionnez Ajouter.
Supprimer
S&eacute;lectionnez le mot-cl&eacute; dans la zone Mots-cl&eacute;s dans le contr&ocirc;le. S&eacute;lectionnez Supprimer.
283
CHAPITRE 8
CONTR&Ocirc;LES LIEN
LIAISON, NAVIGATION ET RECHERCHE
Pour les projets Microsoft HTML Help :
D&eacute;finir des mots-cl&eacute;s distants : permet d'utiliser des mots-cl&eacute;s appartenant &agrave; d'autres fichiers CHM.
REMARQUE : Semblable au contr&ocirc;le Rubriques connexes, le contr&ocirc;le Voir aussi dispose d'une fonctionnalit&eacute;
suppl&eacute;mentaire qui lui permet de quitter sa liste, c'est-&agrave;-dire la rubrique dans laquelle il est plac&eacute;.
Par ailleurs, il peut &ecirc;tre mis &agrave; jour automatiquement dans chaque rubrique contenant le contr&ocirc;le.
Cela signifie que le contr&ocirc;le peut &ecirc;tre copi&eacute;/coll&eacute; dans les rubriques associ&eacute;es.
Ajout de contr&ocirc;les Rubriques connexes
ASTUCE : Les modifications apport&eacute;es aux titres ou aux noms de fichier n'affectent pas les contr&ocirc;les
Rubriques connexes.
1) Dans l'&eacute;diteur de conception, placez le curseur &agrave; l'endroit de la rubrique o&ugrave; vous souhaitez ajouter
le contr&ocirc;le.
2) Cliquez sur Ins&eacute;rer &gt; Rubriques connexes.
3) Choisissez d'afficher les rubriques connexes sous la forme d'un bouton (un libell&eacute; ou une image)
ou de texte.
4) Dans Rubriques du projet, s&eacute;lectionnez une rubrique, puis cliquez sur Ajouter. Continuez pour
ajouter toutes les rubriques que vous souhaitez faire appara&icirc;tre en tant que rubriques connexes.
REMARQUE : La zone URL indique l'emplacement du fichier de rubrique li&eacute; et la zone Titre indique
le titre de la page de rubrique.
5) (Facultatif) Cliquez sur Modifier pour mettre &agrave; jour le nom de la rubrique dans Rubriques connexes.
6) Choisissez les options &agrave; afficher dans une bo&icirc;te de dialogue Rubriques trouv&eacute;es ou dans un menu
contextuel.
7) S&eacute;lectionnez une option pour afficher la rubrique s&eacute;lectionn&eacute;e dans un cadre ou une nouvelle
fen&ecirc;tre.
8) S&eacute;lectionnez les options d'affichage et de police.
9) Cliquez sur Terminer, puis sur le bouton Afficher pour tester la rubrique.
REMARQUE : (Microsoft HTML Help) si la rubrique contient un contr&ocirc;le Rubriques connexes, un bogue
connu emp&ecirc;che souvent les liens de rubriques connexes de fonctionner correctement. Utilisez plut&ocirc;t
des contr&ocirc;les Voir aussi ou Lien de mot-cl&eacute;, voire des liens HTML standard.
Assistant Rubriques connexes
Utilisez l'assistant Rubriques connexes pour modifier la fa&ccedil;on dont un contr&ocirc;le de lien de mot-cl&eacute;
ou de rubrique connexe s'affiche : sous la forme d'un bouton avec du texte ou une image, en tant que
texte brut ou en tant que contr&ocirc;le masqu&eacute; fonctionnant avec des scripts.
Bouton
D&eacute;finit la fa&ccedil;on dont un contr&ocirc;le s'affiche dans une rubrique.
284
CHAPITRE 8
CONTR&Ocirc;LES LIEN
LIAISON, NAVIGATION ET RECHERCHE
Libell&eacute;
Affiche le contr&ocirc;le sous la forme d'un bouton rectangulaire gris avec du texte en noir. Le texte dans
la zone de texte &agrave; droite correspond &agrave; celui qui s'affichera sur le bouton. Vous pouvez le modifier.
Image
Affiche le contr&ocirc;le sous la forme d'une image. Le nom de fichier de l'image appara&icirc;t dans la zone
au-dessous de cette option. (Vous ne pouvez pas ajouter de libell&eacute; de texte &agrave; une image, ni modifier
le libell&eacute; dans RoboHelp.) Pour s&eacute;lectionner une image, cliquez sur le bouton Parcourir , puis
s&eacute;lectionnez une image dans la bo&icirc;te de dialogue. Enregistrez les images en tant que fichier d'ic&ocirc;ne
(ICO) et Windows bitmap (BMP).
Texte
Affiche un contr&ocirc;le sous la forme d'un lien textuel (par exemple : Plus d'informations).
Masqu&eacute; (pour les scripts)
Masque le contr&ocirc;le. Cette option sert aux rubriques devant contenir un script. Le contr&ocirc;le n'est pas
visible dans cette rubrique. Configurez le script avec l'aide d'un d&eacute;veloppeur.
(Projets HTML Help uniquement) Si aucune rubrique n'est associ&eacute;e &agrave; l'un des mots-cl&eacute;s, d&eacute;sactiver
le bouton
Si vous cr&eacute;ez un contr&ocirc;le Lien de mot-cl&eacute;, puis supprimez tous les mots-cl&eacute;s qui lui sont attribu&eacute;s,
le contr&ocirc;le est d&eacute;sactiv&eacute; lorsque l'utilisateur ouvre la rubrique.
Choisir une rubrique dans
D&eacute;finit la mani&egrave;re dont la liste des rubriques s'affiche lorsqu'un utilisateur clique sur le contr&ocirc;le
de lien.
Bo&icirc;te de dialogue Rubriques trouv&eacute;es
Affiche la liste des rubriques dans une bo&icirc;te de dialogue intitul&eacute;e Rubriques trouv&eacute;es. Pour afficher
une rubrique, les utilisateurs doivent la s&eacute;lectionner, puis cliquer sur Afficher.
Menu local
Affiche la liste des rubriques dans un menu contextuel. Les utilisateurs s&eacute;lectionnent une rubrique
pour l'ouvrir.
Cadre
Sp&eacute;cifie le cadre dans lequel afficher la rubrique lorsque l'utilisateur clique sur le mot-cl&eacute;. Les jeux
de cadres personnalis&eacute;s sont r&eacute;pertori&eacute;s dans cette liste.
Pour les projets HTML Help avec des contr&ocirc;les Voir aussi ou Lien de mot-cl&eacute; :
Si aucune rubrique n'est associ&eacute;e &agrave; l'un des mots-cl&eacute;s sp&eacute;cifi&eacute;s, d&eacute;sactiver le bouton
D&eacute;sactive le contr&ocirc;le si aucune rubrique n'est associ&eacute;e aux mots-cl&eacute;s du contr&ocirc;le. Par exemple,
si vous cr&eacute;ez un contr&ocirc;le Lien de mot-cl&eacute;, puis supprimez tous les mots-cl&eacute;s qui lui sont assign&eacute;s,
alors le contr&ocirc;le est d&eacute;sactiv&eacute; lorsque les utilisateurs ouvrent la rubrique.
285
CHAPITRE 8
CONTR&Ocirc;LES LIEN
LIAISON, NAVIGATION ET RECHERCHE
Cr&eacute;ation, assignation et ajout de mots-cl&eacute;s et contr&ocirc;les Voir aussi
Cr&eacute;ation et assignation de mots-cl&eacute;s Voir aussi
1)
2)
3)
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Cliquez deux fois sur le dossier Voir aussi dans le gestionnaire de projets. Le conteneur Voir
aussi s'affiche.
–
Saisissez le mot-cl&eacute; Voir aussi dans la zone de texte. Cliquez sur le signe plus (+).
–
Cliquez sur l'ic&ocirc;ne d'ajout de mots-cl&eacute;s Voir auss i . Saisissez le nouveau mot-cl&eacute; et appuyez
sur Entr&eacute;e.
Le mot-cl&eacute; appara&icirc;t en gras, car aucune rubrique ne lui a &eacute;t&eacute; associ&eacute;e.
Pour assigner des rubriques au mot-cl&eacute; Voir aussi, cliquez sur le conteneur Liste des rubriques
et proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Pour assigner plusieurs rubriques au mot-cl&eacute;, s&eacute;lectionnez les rubriques de votre choix
et faites-les glisser vers le conteneur inf&eacute;rieur.
–
Pour assigner une seule rubrique au mot-cl&eacute;, cliquez sur le conteneur Liste des rubriques,
s&eacute;lectionnez une rubrique, cliquez sur le bouton Propri&eacute;t&eacute;s , puis sur l'onglet Voir aussi.
Saisissez le nom du mot-cl&eacute; &agrave; assigner et cliquez sur Ajouter.
Ajoutez un contr&ocirc;le Voir aussi au nouveau mot-cl&eacute;.
Conteneur Voir aussi
Nouveau mot-cl&eacute; Voir aussi
Cr&eacute;ation d'un mot-cl&eacute; Voir aussi.
Ajouter un mot-cl&eacute;
Ajout du mot-cl&eacute; Voir aussi saisi dans la zone.
Rubrique Mot-cl&eacute;
Attribution d'une rubrique Mot-cl&eacute;.
Rechercher une rubrique
Rechercher des rubriques en fonction de crit&egrave;res de recherche.
D&eacute;finition des mots-cl&eacute;s Voir aussi dans l'assistant Voir aussi
L'assistant Voir aussi s'affiche lorsque vous tentez d'ins&eacute;rer un contr&ocirc;le Voir aussi dans une rubrique
(Insert &gt; See Also).
Mots-cl&eacute;s Voir aussi du projet
Affiche la liste de tous les mots-cl&eacute;s Voir aussi disponibles.
Ajouter
S&eacute;lectionnez le nom &agrave; ajouter dans la liste Mots-cl&eacute;s Voir aussi du projet.
286
CONTR&Ocirc;LES LIEN
LIAISON, NAVIGATION ET RECHERCHE
CHAPITRE 8
Supprimer
S&eacute;lectionnez le nom &agrave; supprimer dans la liste Mots-cl&eacute;s Voir aussi dans le contr&ocirc;le.
Mots-cl&eacute;s Voir aussi dans le contr&ocirc;le
Affiche les mots-cl&eacute;s Voir aussi attribu&eacute;s au contr&ocirc;le.
Pour les projets Microsoft HTML Help :
D&eacute;finir des mots-cl&eacute;s Voir aussi distants
Utilise les mots-cl&eacute;s Voir aussi d'autres fichiers CHM.
D&eacute;finition de mots-cl&eacute;s dans un fichier CHM distant
REMARQUE : Projets HTML Help uniquement.
Le fichier CHM est copi&eacute; dans le dossier du projet. Les mots-cl&eacute;s ne sont r&eacute;f&eacute;renc&eacute;s que depuis le fichier
CHM.
Nom du fichier CHM
Saisissez le fichier CHM distant &agrave; utiliser comme r&eacute;f&eacute;rence.
1)
Cliquez sur le bouton Parcourir
pour rechercher les fichiers CHM distants.
Mot-cl&eacute;
Saisissez le mot-cl&eacute; &agrave; utiliser comme r&eacute;f&eacute;rence. Indiquez le nom exact, tel qu'il appara&icirc;t dans
le fichier CHM.
Ajouter
Ajoute un mot-cl&eacute; &agrave; la liste Mots-cl&eacute;s distants dans le contr&ocirc;le.
Supprimer
Supprime un mot-cl&eacute; de la liste Mots-cl&eacute;s distants dans le contr&ocirc;le.
Mots-cl&eacute;s distants dans le contr&ocirc;le
Affichez les mots-cl&eacute;s ins&eacute;r&eacute;s.
D&eacute;finition des mots-cl&eacute;s Voir aussi dans un fichier CHM distant
REMARQUE : Projets HTML Help uniquement.
Dans votre projet, vous pouvez utiliser des mots-cl&eacute;s Voir aussi appartenant &agrave; d'autres fichiers CHM.
Le fichier CHM est copi&eacute; dans le dossier du projet. Les mots-cl&eacute;s Voir aussi ne le sont pas.
Nom du fichier CHM
Fichier CHM distant.
287
CHAPITRE 8
CONTR&Ocirc;LES LIEN
LIAISON, NAVIGATION ET RECHERCHE
Bouton Parcourir
Cliquez pour acc&eacute;der au fichier CHM distant.
Mot-cl&eacute; Voir aussi
Nom exact du mot-cl&eacute; Voir aussi, tel qu'il appara&icirc;t dans le fichier CHM.
Ajouter
Ajoute le mot-cl&eacute; Voir aussi dans le champ Mots-cl&eacute;s Voir aussi distants dans le contr&ocirc;le.
Supprimer
Supprime le mot-cl&eacute; Voir aussi du champ Mots-cl&eacute;s Voir aussi distants dans le contr&ocirc;le.
Mots-cl&eacute;s Voir aussi distants dans le contr&ocirc;le
Affiche les mots-cl&eacute;s Voir aussi &agrave; ins&eacute;rer dans le contr&ocirc;le.
Ajout de contr&ocirc;les Voir aussi
1)
2)
3)
4)
5)
6)
7)
8)
9)
Cr&eacute;ez des mots-cl&eacute;s Voir aussi.
Dans l'&eacute;diteur de conception, placez le curseur &agrave; l'endroit de la rubrique o&ugrave; vous souhaitez ajouter
le contr&ocirc;le.
Dans la barre d'outils, cliquez sur l'ic&ocirc;ne Ins&eacute;rer une commande de navigation .
S&eacute;lectionnez Voir aussi.
D&eacute;finissez les options de lien.
Dans la zone Mots-cl&eacute;s Voir aussi du projet, s&eacute;lectionnez un mot-cl&eacute; Voir aussi.
Cliquez sur Ajouter. R&eacute;p&eacute;tez cette proc&eacute;dure pour ajouter d'autres mots-cl&eacute;s. Cliquez sur Suivant.
S&eacute;lectionnez les options d'affichage et de police.
Cliquez sur Terminer. Pour tester le contr&ocirc;le, g&eacute;n&eacute;rez le projet.
Modification, r&eacute;utilisation et suppression de contr&ocirc;les Lien
1)
Dans l'&eacute;diteur de conception, ouvrez une rubrique contenant le contr&ocirc;le Lien.
–
Pour modifier un contr&ocirc;le, cliquez deux fois dessus et modifiez ses propri&eacute;t&eacute;s.
–
Pour r&eacute;utiliser un contr&ocirc;le, cliquez dessus avec le bouton droit de la souris, puis s&eacute;lectionnez
Copier. Effectuez un clic droit dans la rubrique de destination et s&eacute;lectionnez Coller.
–
Pour supprimer un contr&ocirc;le, s&eacute;lectionnez-le et cliquez sur Supprimer .
288
FEN&Ecirc;TRES CONTEXTUELLES PUREMENT TEXTUELLES
LIAISON, NAVIGATION ET RECHERCHE
CHAPITRE 8
8.10. Fen&ecirc;tres contextuelles purement textuelles
Utilisation de fen&ecirc;tres contextuelles purement textuelles
Les fen&ecirc;tres contextuelles purement textuelles sont des fen&ecirc;tres contenant des paragraphes courts, tels
que des d&eacute;finitions, qui s'affichent lorsque l'utilisateur clique sur un lien de texte. Vous pouvez ins&eacute;rer ces
fen&ecirc;tres partout dans une rubrique, &agrave; l'exception des en-t&ecirc;tes et des pieds de page. Si les paragraphes
sont plus longs ou si vous devez ins&eacute;rer des graphiques, utilisez des fen&ecirc;tres contextuelles standard.
LIENS CONNEXES :
Lien vers des fen&ecirc;tres contextuelles
Cr&eacute;ation de fen&ecirc;tres contextuelles purement textuelles
1)
2)
3)
Dans l'&eacute;diteur de conception, s&eacute;lectionnez du texte.
Dans le menu Ins&eacute;rer, s&eacute;lectionnez Fen&ecirc;tre contextuelle purement textuelle.
Saisissez le texte contextuel directement dans la fen&ecirc;tre.
Modification de fen&ecirc;tres contextuelles purement textuelles
1)
Cliquez avec le bouton droit de la souris sur la fen&ecirc;tre contextuelle purement textuelle,
puis s&eacute;lectionnez Propri&eacute;t&eacute;s du texte contextuel.
–
Changez le texte en tapant vos modifications dans la zone Texte contextuel.
–
Modifiez la couleur d'arri&egrave;re-plan et les marges en cliquant dans la zone appropri&eacute;e.
Vos s&eacute;lections s'appliquent aux futures fen&ecirc;tres contextuelles purement textuelles.
2)
Pour effectuer un test, cliquez sur le bouton Afficher
purement textuelle.
et s&eacute;lectionnez la fen&ecirc;tre contextuelle
Suppression des fen&ecirc;tres contextuelles purement textuelles
1)
Cliquez avec le bouton droit de la souris sur la fen&ecirc;tre contextuelle, puis cliquez sur Supprimer
la fen&ecirc;tre contextuelle.
Test des fen&ecirc;tres contextuelles purement textuelles
Test avant g&eacute;n&eacute;ration
1)
2)
3)
Dans l'&eacute;diteur de conception, ouvrez la rubrique contenant la fen&ecirc;tre contextuelle purement
textuelle.
Cliquez sur le bouton Afficher .
Cliquez sur la fen&ecirc;tre contextuelle purement textuelle.
289
CHAPITRE 8
S&Eacute;QUENCES DE NAVIGATION
LIAISON, NAVIGATION ET RECHERCHE
Test apr&egrave;s g&eacute;n&eacute;ration
1)
2)
3)
Cliquez sur l'ic&ocirc;ne Afficher la mise en page principale . A l'invite, cliquez sur Oui pour g&eacute;n&eacute;rer
la mise en page.
Acc&eacute;dez &agrave; la rubrique contenant la fen&ecirc;tre contextuelle purement textuelle.
Cliquez sur la fen&ecirc;tre contextuelle purement textuelle.
8.11. S&eacute;quences de navigation
Cr&eacute;ation ou modification de s&eacute;quences de navigation
Les s&eacute;quences de navigation vous permettent de fournir un guide de lecture pour parcourir une s&eacute;rie
de rubriques. Lorsque vous utilisez des s&eacute;quences de navigation, pensez &agrave; ce qui suit :
•
Vous ne pouvez pas inclure dans des s&eacute;quences de navigation des fichiers HTML ni des rubriques
externes issus d'autres syst&egrave;mes d'aide.
•
Une m&ecirc;me rubrique peut appartenir &agrave; plusieurs s&eacute;quences de navigation.
•
L'affichage des s&eacute;quences de navigation est diff&eacute;rent d'un type d'aide &agrave; l'autre. Dans les mises
en page WebHelp, vous pouvez activer ou d&eacute;sactiver les s&eacute;quences de navigation au niveau d'un
projet. Dans les mises en page WebHelp et Adobe AIR, vous pouvez s&eacute;lectionner les s&eacute;quences
de navigation que vous souhaitez afficher. Si la mise en page d&eacute;finit des cat&eacute;gories de contenu, vous
pouvez s&eacute;lectionner des s&eacute;quences de navigation pour chaque cat&eacute;gorie de contenu. Pour plus
d'informations sur la mani&egrave;re d'activer ou de d&eacute;sactiver les s&eacute;quences de navigation, et de les
s&eacute;lectionner pour des cat&eacute;gories de contenu, voir Configuration de la mise en page Adobe AIR
et G&eacute;n&eacute;ration d'une sortie WebHelp.
Cr&eacute;ation automatique de s&eacute;quences de navigation
La cr&eacute;ation automatique d'une s&eacute;quence de navigation &eacute;crase les s&eacute;quences de navigation existantes.
1) Cr&eacute;ez la table des mati&egrave;res.
2) S&eacute;lectionnez Projet &gt; S&eacute;quences de navigation.
3) Cliquez sur Cr&eacute;er automatiquement &agrave; l'aide de la table des mati&egrave;res.
4) Saisissez le nombre de niveaux dans la hi&eacute;rarchie de la table des mati&egrave;res que vous souhaitez inclure
&agrave; la s&eacute;quence de navigation, puis cliquez sur OK.
5) Cliquez sur OK. Si la bo&icirc;te de dialogue d'activation de s&eacute;quences de navigation s'ouvre, cliquez
sur Oui.
290
CHAPITRE 8
S&Eacute;QUENCES DE NAVIGATION
LIAISON, NAVIGATION ET RECHERCHE
Cr&eacute;ation manuelle de s&eacute;quences de navigation
1)
2)
3)
4)
S&eacute;lectionnez Projet &gt; S&eacute;quences de navigation.
Cliquez sur Nouveau, puis sp&eacute;cifiez le nom de la s&eacute;quence de navigation.
Dans Rubriques disponibles, s&eacute;lectionnez le dossier contenant les rubriques que vous ajoutez.
Ajoutez les rubriques &agrave; la s&eacute;quence de navigation.
–
Pour d&eacute;placer une rubrique, s&eacute;lectionnez-la et cliquez sur Ajouter ou cliquez sur le bouton
Ajouter une s&eacute;quence de navigation .
–
Pour d&eacute;placer un groupe de rubriques, s&eacute;lectionnez le dossier contenant les rubriques, puis
cliquez sur le bouton Ajouter toutes les s&eacute;quences de navigation .
5)
Cliquez sur OK. Si la bo&icirc;te de dialogue d'activation de s&eacute;quences de navigation s'ouvre, cliquez sur Oui.
Suppression d'une rubrique d'une s&eacute;quence de navigation
•
Dans la liste S&eacute;quence de navigation, s&eacute;lectionnez la rubrique et cliquez sur Supprimer.
Suppression d'une s&eacute;quence de navigation ou modification de son nom
Dans la liste S&eacute;quence de navigation, s&eacute;lectionnez la s&eacute;quence de navigation.
•
Pour la supprimer, cliquez sur Supprimer.
•
Pour la modifier, cliquez sur Renommer et saisissez le nouveau nom.
Affichage et test des s&eacute;quences de navigation
Identification des rubriques associ&eacute;es aux s&eacute;quences de navigation
1)
2)
S&eacute;lectionnez Projet &gt; Editeur de s&eacute;quence de navigation.
Sous S&eacute;quences de navigation, cliquez sur le signe plus en regard de chacune des s&eacute;quences
de navigation pour afficher les rubriques.
Test des s&eacute;quences de navigation
Les rubriques appartenant &agrave; plusieurs s&eacute;quences s'affichent dans la s&eacute;quence de navigation r&eacute;pertori&eacute;e
en premier dans Affichage des liens.
1) S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Affichage des liens. Le conteneur Affichage des liens
s'affiche.
2) Cliquez sur l'onglet du gestionnaire de projets.
3) Dans le gestionnaire de projets, ouvrez le dossier Fichiers HTML et s&eacute;lectionnez une rubrique.
4) Faites glisser la rubrique dans le conteneur Affichage des liens.
Lorsqu'une ligne jaune s'affiche autour de l'ic&ocirc;ne Affichage des liens , rel&acirc;chez le bouton
de la souris afin d'afficher les liens entrants et sortants de la rubrique.
Si la rubrique appartient &agrave; une s&eacute;quence de navigation, les boutons Pr&eacute;c&eacute;dent et Suivant
s'affichent au-dessus et en dessous de la rubrique.
5) Cliquez sur les boutons Pr&eacute;c&eacute;dent et Suivant pour tester la s&eacute;quence de navigation.
291
RECHERCHE DE SORTIE ROBOHELP
LIAISON, NAVIGATION ET RECHERCHE
CHAPITRE 8
Affichage des s&eacute;quences pour une rubrique
1)
2)
3)
S&eacute;lectionnez une rubrique.
Cliquez sur le bouton Propri&eacute;t&eacute;s
Cliquez sur l'onglet Avanc&eacute;.
.
Test des s&eacute;quences de navigation dans un navigateur ou une vue
1)
2)
3)
V&eacute;rifiez que les s&eacute;quences de navigation sont activ&eacute;es.
Cliquez sur le bouton G&eacute;n&eacute;rer .
Cliquez sur Afficher les r&eacute;sultats, puis cliquez dans la s&eacute;quence de navigation.
Identification des s&eacute;quences de navigation auxquelles une rubrique est assign&eacute;e
1)
2)
3)
Ouvrez une rubrique dans l'&eacute;diteur de conception.
Cliquez sur le bouton Propri&eacute;t&eacute;s .
Cliquez sur l'onglet Avanc&eacute;.
8.12. Recherche de sortie RoboHelp
RoboHelp offre une grande vari&eacute;t&eacute; d'options gr&acirc;ce auxquelles vous pouvez ajouter des m&eacute;tadonn&eacute;es
de recherche, optimiser le contenu d'un projet pour la recherche et configurer l'exp&eacute;rience de recherche
des utilisateurs finaux.
Principes de base de la recherche RoboHelp
RoboHelp prend en charge les fonctionnalit&eacute;s suivantes pour la recherche dans la sortie :
Recherche multilingue
La recherche RoboHelp prend en charge plusieurs langues dans les projets, les rubriques et les
paragraphes. Par exemple, supposons que les utilisateurs recherchent un mot allemand dans une
rubrique r&eacute;dig&eacute;e en anglais et comportant un paragraphe imbriqu&eacute; en allemand. Si RoboHelp
trouve le mot allemand, il affiche la rubrique en anglais et met en surbrillance le mot en allemand.
292
CHAPITRE 8
RECHERCHE DE SORTIE ROBOHELP
LIAISON, NAVIGATION ET RECHERCHE
Recherche en chinois, japonais et cor&eacute;en (CJC)
Les sorties WebHelp et FlashHelp dans RoboHelp prennent en charge la recherche de mots-cl&eacute;s,
ce qui signifie qu'une requ&ecirc;te d'utilisateur est d&eacute;compos&eacute;e en mots et que chacun d'entre eux est
recherch&eacute; dans le contenu du projet. D&eacute;composer une requ&ecirc;te de recherche en mots n'est pas
facile pour le chinois, le japonais et le cor&eacute;en, car ces langues ne marquent pas clairement les limites
des mots.
La fonctionnalit&eacute; de recherche avec WebHelp, FlashHelp, AIRHelp et la sortie AIRHelp bas&eacute;e sur
un navigateur reconna&icirc;t le contenu CJC dans les requ&ecirc;tes de recherche afin que les r&eacute;sultats
obtenus soient plus utiles.
REMARQUE : RoboHelp recherche chaque s&eacute;quence contigu&euml; de caract&egrave;res CJC comme un tout et affiche
uniquement les rubriques qui correspondent &agrave; l'int&eacute;gralit&eacute; de la requ&ecirc;te de recherche dans la m&ecirc;me
s&eacute;quence.
Pour rechercher plusieurs mots CJC, s&eacute;parez les mots en proc&eacute;dant de l'une des mani&egrave;res suivantes :
•
•
Utilisez les op&eacute;rateurs logiques AND ou OR
RoboHelp recherche chaque mot CJC, puis pr&eacute;sente les r&eacute;sultats en fonction de l'op&eacute;rateur utilis&eacute;.
Utilisez les espaces
Si vous utilisez des espaces pour s&eacute;parer les mots, RoboHelp effectue une recherche d'expression.
REMARQUE :
La prise en charge de la recherche CJC n'a aucune incidence sur l'indexation du contenu
dans RoboHelp Server.
Recherche de sous-cha&icirc;nes
(WebHelp/Pro, FlashHelp/Pro) Si vous activez cette fonctionnalit&eacute;, la recherche du terme
&laquo; journal &raquo; renvoie les rubriques comportant les mots &laquo; journaliser &raquo; et &laquo; journalisation &raquo;.
La recherche de sous-cha&icirc;ne dure plus longtemps que la recherche de cha&icirc;ne enti&egrave;re.
REMARQUE : Dans les projets fusionn&eacute;s, la recherche de sous-cha&icirc;ne fonctionne lorsqu'il est activ&eacute;e &agrave; la
fois dans le projet ma&icirc;tre et dans les projets enfants.
Recherche d'expression
Pour rechercher une expression, les utilisateurs doivent la saisir entre guillemets dans la zone
de recherche. Si l'expression recherch&eacute;e est &laquo; nuance de couleur &raquo;, RoboHelp renvoie toutes
les rubriques contenant l'expression &laquo; nuance de couleur &raquo;.
293
CHAPITRE 8
RECHERCHE DE SORTIE ROBOHELP
LIAISON, NAVIGATION ET RECHERCHE
Recherche de tous les termes
(WebHelp et WebHelp Pro et l'aide AIR) Par d&eacute;faut, RoboHelp ex&eacute;cute une recherche OU lorsqu'un
utilisateur saisit plusieurs mots sans les entourer de guillemets. Cela signifie que RoboHelp trouve
toutes les rubriques qui contiennent l'un des mots sp&eacute;cifi&eacute;s dans la zone de recherche. Si vous
s&eacute;lectionnez l'option Autoriser la recherche de tous les termes dans la sortie pour les param&egrave;tres
SSL, RoboHelp effectue la recherche de tous les termes lorsqu'un utilisateur saisit plusieurs mots
sans les entourer de guillemets. RoboHelp trouve seulement les rubriques qui contiennent tous
les mots sp&eacute;cifi&eacute;s dans la zone de recherche. La recherche de tous les termes peut &ecirc;tre utilis&eacute;e
en combinaison avec la fonction de recherche de phrases.
Dans les param&egrave;tres SSL, vous pouvez &eacute;galement indiquer si vous souhaitez ou non que la recherche
de tous les mots soit activ&eacute;e par d&eacute;faut. En outre, lorsque la recherche de tous les mots est prise
en charge dans la sortie, les utilisateurs finaux ont la possibilit&eacute; d'activer ou de d&eacute;sactiver l'option.
REMARQUE : Dans les projets fusionn&eacute;s, les projets enfants h&eacute;ritent de la d&eacute;finition du projet parent.
Dans le cadre de projets avec DUCC (cat&eacute;gories de contenu), le param&egrave;tre s'applique &agrave; toutes les cat&eacute;gories
de contenu.
Op&eacute;rateurs bool&eacute;ens dans la recherche
(WebHelp) Les utilisateurs peuvent restreindre la port&eacute;e de la recherche en combinant des termes
&agrave; rechercher &agrave; l'aide des op&eacute;rateurs bool&eacute;ens AND, OR et NOT.
classement des r&eacute;sultats de recherche ;
RoboHelp classe les r&eacute;sultats de la recherche en fonction de leur pertinence. Par exemple, si un mot
appara&icirc;t dans le titre d'une rubrique, son classement sera sup&eacute;rieur &agrave; un mot se trouvant dans
la liste des mots-cl&eacute;s de la rubrique. Une rubrique dans laquelle le mot appara&icirc;t en en-t&ecirc;te 1 aura
un classement sup&eacute;rieur &agrave; un mot apparaissant en en-t&ecirc;te 2 et sera donc affich&eacute;e en premier dans
les r&eacute;sultats de la recherche.
Ajout de m&eacute;tadonn&eacute;es de recherche
Les m&eacute;tadonn&eacute;es de recherche comprennent les synonymes, mots-cl&eacute;s de rubrique et mots exclus.
Pour ajouter ou modifier des m&eacute;tadonn&eacute;es de recherche, effectuez les op&eacute;rations suivantes :
1) S&eacute;lectionnez Edition &gt; M&eacute;tadonn&eacute;es de recherche.
2) Proc&eacute;dez comme suit :
Synonymes
S&eacute;lectionnez cette option pour d&eacute;finir les synonymes et varier les termes &agrave; rechercher. Par exemple,
vous pouvez d&eacute;finir &laquo; curseur &raquo;, &laquo; pointeur &raquo; et &laquo; souris &raquo; comme termes synonymes. Si le terme
recherch&eacute; est &laquo; souris &raquo;, RoboHelp renvoie toutes les rubriques contenant les mots &laquo; curseur &raquo;
et &laquo; pointeur &raquo;, ces termes &eacute;tant mis en surbrillance. Pour plus d'informations, voir Modification
des param&egrave;tres du projet.
294
CHAPITRE 8
RECHERCHE DE SORTIE ROBOHELP
LIAISON, NAVIGATION ET RECHERCHE
Mots-cl&eacute;s de rubrique
S&eacute;lectionnez cette option pour associer des mots ou expressions &agrave; la rubrique en cours.
G&eacute;n&eacute;ralement, vous choisissez des mots ou expressions pertinentes pour la rubrique en question
mais qui n'apparaissent pas dans son contenu. Par exemple, vous pouvez choisir d'associer le mot-cl&eacute;
&laquo; mise en forme &raquo; &agrave; une rubrique portant sur les polices, les styles et les tailles en points. Si l'utilisateur
final saisit ce mot-cl&eacute; comme terme &agrave; rechercher, RoboHelp affiche cette rubrique bien qu'elle
ne contienne pas le mot &laquo; mise en forme &raquo;. Lors du classement des r&eacute;sultats de la recherche,
RoboHelp donne plus de poids aux mots-cl&eacute;s qu'aux termes de recherche trouv&eacute;s dans le corps
d'une rubrique. Pour plus d'informations, voir Modification des param&egrave;tres du projet.
REMARQUE : La recherche par mot-cl&eacute; n'est pas disponible dans Microsoft HTML Help (CHM).
Mots exclus
S&eacute;lectionnez cette option pour ajouter des mots courants (mineurs), tels que &laquo; un &raquo; ou &laquo; le &raquo; dans
le fichier de liste d'exclusion ProjectName.stp. RoboHelp ignore ces mots pour afficher des r&eacute;sultats
de recherche optimaux et pertinents. Pour plus d'informations, voir Modification des param&egrave;tres
du projet.
Optimisation du contenu pour la recherche
RoboHelp prend en charge plusieurs m&eacute;thodes d'optimisation du contenu pour la recherche :
Permettre la recherche des fichiers Office et PDF
(WebHelp/Pro, FlashHelp/Pro) Les utilisateurs peuvent rechercher des fichiers bagage (fichiers PDF,
Word et Excel) dans la sortie publi&eacute;e. Pour que ces fichiers bagage puissent appara&icirc;tre dans
les r&eacute;sultats de recherche, ils doivent &ecirc;tre r&eacute;f&eacute;renc&eacute;s dans une rubrique via un hyperlien.
REMARQUE : Pour activer ce type de recherche, vous devez avoir install&eacute; iFilter pour Microsoft et PDF
sur votre ordinateur.
Exclure des rubriques non r&eacute;f&eacute;renc&eacute;es de la recherche
L'option Exclure les rubriques non r&eacute;f&eacute;renc&eacute;es de la sortie, dans les propri&eacute;t&eacute;s de mise en page,
garantit que les r&eacute;sultats de la recherche affich&eacute;s proviennent uniquement des rubriques
r&eacute;f&eacute;renc&eacute;es dans les composants de projet suivants :
•
•
•
•
•
•
•
•
Table des mati&egrave;res
Index
S&eacute;quences de navigation
Rubrique par d&eacute;faut
ID de mappage CSH
Mots-cl&eacute;s Voir aussi
Mots-cl&eacute;s Rubriques connexes
Liens hypertexte
295
RECHERCHE DE SORTIE ROBOHELP
LIAISON, NAVIGATION ET RECHERCHE
CHAPITRE 8
Exclure les types de fichiers bagage de la recherche
(Multi-&eacute;cran HTML5, WebHelp, FlashHelp et AIR Help) L'option Exclure les types de fichiers bagage
de la recherche vous permet d'exclure les fichiers bagage des types sp&eacute;cifi&eacute;s de la recherche.
Par exemple, vous pouvez exclure de la recherche tous les fichiers Excel de vos projets.
REMARQUE : Dans les projets fusionn&eacute;s, configurez ce param&egrave;tre de recherche pour chaque projet.
Exclure les fichiers bagage non r&eacute;f&eacute;renc&eacute;s de la recherche
L'option Exclure les fichiers bagage non r&eacute;f&eacute;renc&eacute;s de la recherche garantit que les r&eacute;sultats
de la recherche affichent des fichiers bagage seulement s'ils sont r&eacute;f&eacute;renc&eacute;s dans des rubriques
par le biais d'hyperliens et que l'index et la table des mati&egrave;res soient s&eacute;lectionn&eacute;s dans les propri&eacute;t&eacute;s
de mise en page. Si l'option Exclure les rubriques non r&eacute;f&eacute;renc&eacute;es de la sortie est s&eacute;lectionn&eacute;e,
RoboHelp tient compte uniquement des rubriques r&eacute;f&eacute;renc&eacute;es ; dans le cas contraire, toutes
les rubriques du projet sont prises en compte.
Voir le tableau ci-dessous pour rechercher les mises en page qui prennent en charge les options Exclure
les rubriques non r&eacute;f&eacute;renc&eacute;es de la sortie et Exclure les fichiers bagage non r&eacute;f&eacute;renc&eacute;s de la recherche :
SSL
Multi-&eacute;cran HTML5
Option Exclure les rubriques
non r&eacute;f&eacute;renc&eacute;es de la sortie
Option Exclure les fichiers bagage
non r&eacute;f&eacute;renc&eacute;s de la recherche
Oui
Oui
Adobe AIR
Type de sortie :
application Adobe AIR
Oui
Oui
Adobe AIR
Type de sortie : aide
accessible par navigateur
Oui
Oui
WebHelp
Oui
Oui
WebHelp Pro
Oui
Oui
FlashHelp
Oui
Oui
FlashHelp Pro
Oui
Oui
Microsoft HTML Help
Oui
Non
Documentation
imprim&eacute;e
Non
Non
XML Output
Oui
Non
Oracle Help
Oui
Non
JavaHelp
Oui
Non
eBook
296
CHAPITRE 8
RECHERCHE DE SORTIE ROBOHELP
LIAISON, NAVIGATION ET RECHERCHE
Configuration de l'exp&eacute;rience de recherche
Vous pouvez configurer l'exp&eacute;rience de recherche des utilisateurs finaux &agrave; l'aide des m&eacute;thodes suivantes :
Afficher le nombre total de r&eacute;sultats de recherche
(WebHelp et AIRHelp) Cette option permet de pr&eacute;ciser si le nombre total de r&eacute;sultats pour une
cha&icirc;ne de recherche saisie par les utilisateurs doit s'afficher dans la sortie. Par d&eacute;faut, cette option
de recherche est activ&eacute;e dans les projets RoboHelp mis &agrave; niveau et nouveaux.
REMARQUE : Dans les projets fusionn&eacute;s, les projets enfants h&eacute;ritent de la d&eacute;finition du projet parent.
Afficher le contexte dans les r&eacute;sultats de la recherche
Par d&eacute;faut, la liste des r&eacute;sultats de recherche affiche les 60 premiers caract&egrave;res de chaque rubrique
afin d'en donner le contexte. Vous pouvez d&eacute;sactiver l'affichage du contexte dans la bo&icirc;te
de dialogue SSL.
REMARQUE : Seuls WebHelp/Pro et FlashHelp/Pro prennent en charge l'affichage du contexte dans les
r&eacute;sultats de recherche dans l'aide. Dans Flash Help/Pro, le contexte appara&icirc;t sous forme d'info-bulles.
Liste personnalisable des r&eacute;sultats de la recherche
(WebHelp/Pro) Par d&eacute;faut, dix r&eacute;sultats de la recherche apparaissent &agrave; la fois. Dans ces deux
versions, le volet de recherche contient une option permettant d'afficher le nombre maximal
de r&eacute;sultats de recherche dans une liste.
Masquer la colonne de rang dans les r&eacute;sultats de la recherche
Pour une sortie WebHelp ou WebHelp Pro, vous pouvez masquer la colonne de rang dans les r&eacute;sultats
de la recherche afin d'allouer plus d'espace pour l'affichage des r&eacute;sultats de la recherche. L'option
Masquer la colonne de rang dans les r&eacute;sultats de la recherche est disponible dans l'onglet Recherche
des propri&eacute;t&eacute;s de mise en page WebHelp. Voir G&eacute;n&eacute;ration d'une sortie WebHelp et G&eacute;n&eacute;ration
d'une sortie WebHelp Pro ou FlashHelp Pro.
297
CHAPITRE 8
RECHERCHE DE SORTIE ROBOHELP
LIAISON, NAVIGATION ET RECHERCHE
Recherche &agrave; saisie semi-automatique
La fonction de recherche dans la sortie Responsive HTML5 affiche maintenant des r&eacute;sultats de recherche
pr&eacute;dictive en fonction des caract&egrave;res saisis. Les r&eacute;sultats de la recherche sont intelligemment class&eacute;s
en fonction de l'historique de recherche et de la fr&eacute;quence d'occurrence du terme dans le document
pour vous assurer que vos r&eacute;sultats de recherche sont aussi pertinents que possible. Les cinq r&eacute;sultats
de recherche les plus pertinents sont affich&eacute;s dans le champ de recherche.
Lorsque vous saisissez les premi&egrave;res lettres d'une rubrique, d'un sujet ou de mots-cl&eacute;s dans la zone
de recherche, un puissant algorithme s'ex&eacute;cute en arri&egrave;re-plan pour d&eacute;tecter les fautes d'orthographe,
l'occurrence et les mots-cl&eacute;s potentiels, et les comparer aux recherches ant&eacute;rieures afin de sugg&eacute;rer
la meilleure alternative au texte partiel saisi dans le champ de recherche.
La recherche effectue une pr&eacute;vision intelligente et tente d'am&eacute;liorer votre recherche de plusieurs mani&egrave;res :
•
Prise en charge des synonymes et des mots exclus : Le moteur de recherche ne se limite pas au mot
exclu, mais ajoute plut&ocirc;t le mot suivant le plus courant &agrave; la suggestion. Il inclut &eacute;galement des synonymes
de vos termes de recherche pour trouver des r&eacute;sultats correspondants.
•
Position du curseur : Les suggestions peuvent changer si le curseur est d&eacute;plac&eacute; avant ou apr&egrave;s
le mot.
•
Orthographe : Le moteur de recherche recommande les mots qui sont les plus similaires &agrave; chaque
mot mal orthographi&eacute;. Il permet jusqu'&agrave; deux fautes d'orthographe.
•
V&eacute;rification de l'historique de recherche : Les recherches ant&eacute;rieures sont stock&eacute;es dans des cookies
et les recherches qui correspondent au texte pr&eacute;sent dans la zone de recherche s'affichent.
•
Effacement de l'historique des recherches : Vous pouvez utiliser le bouton X en regard
de l'expression de recherche pour effacer l'historique des recherches.
Navigation dans les r&eacute;sultats de recherche &agrave; l'aide des raccourcis clavier
•
Utilisez les touches fl&eacute;ch&eacute;es pour s&eacute;lectionner les suggestions suivantes ou pr&eacute;c&eacute;dentes.
•
Utilisez la touche fl&eacute;ch&eacute;e vers la droite pour afficher la suggestion suivante.
•
Appuyez sur la touche Entr&eacute;e pour s&eacute;lectionner le terme de recherche souhait&eacute; et afficher
les r&eacute;sultats. Cette s&eacute;lection enregistre le terme de recherche dans l'historique.
•
Appuyez sur la touche Echap pour masquer les suggestions.
298
CHAPITRE 8
RECHERCHE DE CONTENU EXTERNE
LIAISON, NAVIGATION ET RECHERCHE
8.13. Recherche de contenu externe
La recherche de contenu externe permet aux auteurs d'afficher du contenu d'URL sp&eacute;cifi&eacute;es, en fonction
de termes que les utilisateurs sont susceptibles de rechercher. Vous pouvez cr&eacute;er une liste d'URL li&eacute;es
&agrave; un projet et, pour chaque URL, fournir un ensemble de termes de recherche, un titre et une description.
Lorsque la requ&ecirc;te de recherche d'un utilisateur contient certains de ces termes de recherche, RoboHelp
renvoie le titre et la description de l'URL correspondante dans les r&eacute;sultats de la recherche. Lorsque
l'utilisateur clique dessus, le contenu s'affiche dans le volet de rubrique. L'URL renvoy&eacute;e dans les r&eacute;sultats
de la recherche a le m&ecirc;me rang que le mot-cl&eacute; sp&eacute;cifi&eacute; dans les rubriques.
Configuration et gestion de la recherche de contenu externe
1)
2)
S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Recherche de contenu externe.
Utilisez les options suivantes pour configurer et g&eacute;rer la recherche de contenu externe :
Ajouter
Cliquez sur Ajouter et indiquez les termes &agrave; rechercher (s&eacute;par&eacute;s par une virgule, un espace
ou un point-virgule) et l'URL du contenu externe. Il est conseill&eacute; d'ajouter un titre et une description.
S&eacute;lectionnez les balises de construction conditionnelles que vous souhaitez appliquer. Cliquez
sur OK pour enregistrer l'entr&eacute;e du fichier SearchOptions.xml dans le dossier du projet.
Modifier
S&eacute;lectionnez l'entr&eacute;e que vous souhaitez modifier, puis cliquez sur le bouton Modifier. Modifiez
les d&eacute;tails et cliquez sur OK.
Importer
Cliquez sur Importer et s&eacute;lectionnez le fichier SearchOptions.xml d'un projet pour importer
les param&egrave;tres de recherche de contenu externe de ce projet dans le projet actif.
Exporter
Cliquez sur Exporter et s&eacute;lectionnez un dossier pour exporter le fichier SearchOptions.xml.
L'exportation du fichier SearchOptions.xml d'un projet vers un autre est utile lorsque deux projets
doivent autoriser la recherche de contenu externe similaire.
Recherche
Indiquez une cha&icirc;ne &agrave; rechercher pour une entr&eacute;e sp&eacute;cifique. Cette option est utile lorsqu'un projet
poss&egrave;de de nombreuses entr&eacute;es d&eacute;finies pour la recherche de contenu externe.
299
CHAPITRE 8
RECHERCHE DE CONTENU EXTERNE
LIAISON, NAVIGATION ET RECHERCHE
Activation de la recherche de contenu externe
Vous pouvez activer la recherche de contenu externe dans les fichiers SSL suivants :
•
Multi-&eacute;cran HTML5
•
WebHelp
•
FlashHelp
•
Adobe AIR
•
WebHelp Pro
•
FlashHelp Pro
1)
2)
Dans le conteneur Mises en page source unique, cliquez avec le bouton droit de la souris sur la mise
en page dans laquelle vous souhaitez g&eacute;n&eacute;rer la sortie et s&eacute;lectionnez Propri&eacute;t&eacute;s.
Selon la mise en page, effectuez l'une des op&eacute;rations suivantes :
–
(Multi-&eacute;cran HTML5) Cliquez sur un profil d'&eacute;cran. Dans l'onglet Recherche, s&eacute;lectionnez
Activer la recherche de contenu externe.
–
(Adobe AIR) Cliquez sur Rechercher et s&eacute;lectionnez Activer la recherche de contenu externe.
–
(WebHelp) Cliquez sur Rechercher et s&eacute;lectionnez Activer la recherche de contenu externe.
–
(WebHelp Pro) S&eacute;lectionnez Activer la recherche de contenu externe.
–
(FlashHelp et FlashHelp Pro) Cliquez sur Suivant et s&eacute;lectionnez Activer la recherche de contenu
externe.
300
IMAGES
MULTIM&Eacute;DIA ET EFFETS SP&Eacute;CIAUX
CHAPITRE 9
9.
Multim&eacute;dia et effets sp&eacute;ciaux
9.1.
Images
Principes de base sur les images
Formats de fichiers image
Les fichiers GIF (Graphic Interchange Format)
Format couleur 8 bits permettant d'afficher 256 couleurs ; id&eacute;al pour les images dont la plage de
couleurs est limit&eacute;e. Les images GIF prennent en charge l'attribut de transparence. Elles sont
particuli&egrave;rement indiqu&eacute;es pour les photos en niveaux de gris, les dessins anim&eacute;s, les petites ic&ocirc;nes,
les boutons, les barres les lignes et les puces. Vous pouvez les entrelacer et les animer.
JPEG (Joint Photographic Expert Group)
Ce format sert principalement &agrave; afficher des photos et autres images en teintes continues dans des
documents HTML. Il est recommand&eacute; pour les images dont la profondeur de couleur est sup&eacute;rieure
ou &eacute;gale &agrave; 256 couleurs. Les fichiers JPEG pr&eacute;sentent une extension .jpeg ou .jpg.
BMP (Windows Bitmap)
Format d'image bitmap standard con&ccedil;u pour Windows et utilis&eacute; dans les applications WinHelp. Les
images bitmap prennent en charge les couleurs jusqu'&agrave; 24 bits. Lorsque vous importez des projets
WinHelp en HTML, les bitmaps sont convertis au format GIF ou JPG. Vous pouvez utiliser des
formats de bitmap et d'ic&ocirc;nes (fichiers ICO) lorsque vous ajoutez des contr&ocirc;les de liens ou des
contr&ocirc;les HTML Help (boutons personnalis&eacute;s).
MRB (Multi-Resolution Bitmap)
Format d'image d'aide Windows contenant une image enregistr&eacute;e pour diff&eacute;rentes r&eacute;solutions
d'&eacute;cran dans un seul fichier. Le programme importe ces fichiers depuis des projets WinHelp et les
convertit en images GIF.
WMF (Windows Metafile)
Format graphique vectoriel con&ccedil;u pour les syst&egrave;mes Windows. Les fichiers WMF sont couramment
utilis&eacute;s comme images clipart dans les applications de traitement de texte. Le programme importe
ces fichiers depuis des projets WinHelp et les convertit en images GIF.
PNG (Portable Network Graphics)
Un format d'image bitmap comme GIF. Les versions les plus r&eacute;centes de Netscape Navigator et
Microsoft Internet Explorer prennent le format PNG en charge.
301
CHAPITRE 9
IMAGES
MULTIM&Eacute;DIA ET EFFETS SP&Eacute;CIAUX
Conseils :
•
•
•
Cr&eacute;ez un effet de filigrane sur votre papier en affichant les couleurs et images d'arri&egrave;re-plan via la
bo&icirc;te de dialogue Bordures et trame.
Lorsque vous s&eacute;lectionnez une image, le bouton de l'enrouleur de c&acirc;bles s'affiche . Il permet de
lier un &eacute;l&eacute;ment de rubrique (tel qu'une image, un tableau ou du texte) &agrave; un autre &eacute;l&eacute;ment et
d'attribuer un effet HTML dynamique &agrave; la connexion.
Lorsque vous importez un fichier Microsoft Word ou HTML, toutes les images sont import&eacute;es avec
le fichier (les images doivent se trouver dans des cadres ancr&eacute;s.)
REMARQUE : Si vous cr&eacute;ez un syst&egrave;me d'aide WebHelp Pro ou WebHelp, utilisez des fichiers GIF ou JPG.
Localisation d'images
Utilisez le localisateur de graphiques pour rechercher des fichiers image sur les disques durs et les
dossiers, afficher des vignettes et copier des fichiers.
1) Dans le conteneur Bo&icirc;te &agrave; outils, cliquez deux fois sur le bouton Localisateur de graphiques .
2) S&eacute;lectionnez le format de fichier graphique &agrave; rechercher.
3) Saisissez le chemin de recherche ou acc&eacute;dez au nouvel emplacement.
4) Cliquez sur Rechercher.
Copie d'une image
1)
2)
3)
4)
Dans le conteneur Bo&icirc;te &agrave; outils, cliquez deux fois sur le bouton Localisateur de graphiques
Dans la liste Fichiers image, s&eacute;lectionnez une image.
Acc&eacute;dez &agrave; l'emplacement de destination souhait&eacute;.
Cliquez sur Copier le fichier.
.
Affichage d'une image
Pour afficher une image, associez l'extension de nom de fichier &agrave; une application :
1) S&eacute;lectionnez le dossier Images dans la vue Projet.
2) Cliquez avec le bouton droit de la souris sur l'image.
3) Cliquez sur Afficher.
4) S&eacute;lectionnez Fichier &gt; Options.
5) Cliquez sur l'onglet Associations.
6) Cliquez sur Ajouter en regard d'Associations de fichier. Saisissez une extension de nom de fichier.
7) Cliquez sur S&eacute;lectionner. Localisez l'application &agrave; utiliser pour modifier et afficher le type de fichier.
Ajout d'une image dans une rubrique
Vous pouvez ins&eacute;rer des fichiers pr&eacute;sentant les extensions suivantes : .gif, .jpeg, .jpg ou .bmp.
302
CHAPITRE 9
IMAGES
MULTIM&Eacute;DIA ET EFFETS SP&Eacute;CIAUX
REMARQUE : Pour l'aide bas&eacute;e sur le Web, utilisez des fichiers GIF ou JPEG.
1)
2)
3)
Dans l'&eacute;diteur de conception, s&eacute;lectionnez l'emplacement de l'image.
Dans la barre d'outils, cliquez sur le bouton Ins&eacute;rer une image .
Effectuez l'une des op&eacute;rations suivantes :
–
Cliquez sur le bouton Parcourir pour rechercher un fichier.
–
Si le fichier image se trouve dans le projet, s&eacute;lectionnez un dossier dans le menu contextuel
Images dans les dossiers du projet. S&eacute;lectionnez Tous les dossiers pour afficher l'ensemble des
images du projet.
4)
Cliquez sur OK.
Conseils :
•
•
•
Si l'image est utilis&eacute;e dans le projet, faites-la glisser du dossier Gestionnaire de projets\Images vers
la rubrique.
Pour ajouter des images pr&eacute;d&eacute;finies, cliquez sur l'onglet Galerie de la bo&icirc;te de dialogue Image et
s&eacute;lectionnez une cat&eacute;gorie, puis l'image. Pour l'ajouter au projet, cliquez sur OK.
Vous pouvez coller des captures d'&eacute;cran dans l'&eacute;diteur de conception sans avoir recours &agrave; un outil
d'&eacute;dition d'images tiers. Les images sont enregistr&eacute;es sous la forme de fichiers GIF ou JPEG. Appuyez
sur Alt + Imp &eacute;cr pour effectuer une capture de l'&eacute;cran en cours.
Ajout d'une image RoboScreenCapture dans une rubrique
Cr&eacute;ez et ajoutez des images simultan&eacute;ment.
1) Dans l'&eacute;diteur de conception, positionnez le curseur &agrave; l'emplacement souhait&eacute; d'une rubrique.
2) Cliquez sur le bouton Ins&eacute;rer capture d'&eacute;cran de la barre d'outils Objets. La bo&icirc;te de dialogue
Ins&eacute;rer capture d'&eacute;cran s'affiche.
3) Saisissez un nom de fichier pour la nouvelle image.
4) S&eacute;lectionnez un format de fichier.
5) Cliquez sur OK. L'application RoboScreenCapture s'ouvre et la fen&ecirc;tre RoboHelp est r&eacute;duite.
6) S&eacute;lectionnez Capturer &gt; Fen&ecirc;tre active ou un autre objet &agrave; capturer. La nouvelle image s'affiche
dans la zone vide.
7) Cliquez sur Enregistrer .
8) Fermez RoboScreenCapture. La bo&icirc;te de dialogue Image de RoboHelp pour HTML s'affiche.
9) (Facultatif) Redimensionnez l'image ou ajoutez-y des bordures.
10) Cliquez sur OK.
Suppression d'une image d'une rubrique
•
•
Pour supprimer une image d'une rubrique, s&eacute;lectionnez l'image dans l'&eacute;diteur de conception.
Cliquez sur le bouton Supprimer. L'image reste plac&eacute;e dans le dossier Images.
Pour supprimer une image d'un projet, supprimez le fichier de toutes les rubriques. L'image est
supprim&eacute;e du dossier Images.
303
CHAPITRE 9
IMAGES
MULTIM&Eacute;DIA ET EFFETS SP&Eacute;CIAUX
Modification d'une image dans RoboHelp
1)
2)
3)
Dans l'&eacute;diteur de conception, s&eacute;lectionnez l'image &agrave; modifier.
Cliquez avec le bouton droit de la souris sur l'image, puis s&eacute;lectionnez Propri&eacute;t&eacute;s d'image.
D&eacute;finissez les options suivantes :
Habillage du texte
S&eacute;lectionnez l'alignement de l'image par rapport au texte qui l'entoure.
REMARQUE : Si un habillage de texte est appliqu&eacute; &agrave; l'image, celle-ci ne peut pas &ecirc;tre align&eacute;e. Si la valeur
Aucun a &eacute;t&eacute; d&eacute;finie pour l'habillage de texte, l'image ou la ligne sur laquelle elle est plac&eacute;e peut &ecirc;tre
align&eacute;e.
Info-bulle
Saisissez le texte &agrave; afficher lorsque l'utilisateur passe le curseur au-dessus de l'image. En r&egrave;gle
g&eacute;n&eacute;rale, le texte de l'info-bulle est le titre de l'image.
Texte de substitution
Saisissez le texte &agrave; afficher lorsque l'image ne peut pas &ecirc;tre affich&eacute;e (les utilisateurs ont peut-&ecirc;tre
d&eacute;sactiv&eacute; les images dans leurs navigateurs). En r&egrave;gle g&eacute;n&eacute;rale, le texte de substitution doit contenir
une description pr&eacute;cise de l'image.
Taille
Cliquez sur ce bouton pour d&eacute;finir les dimensions de l'image en pixels. Dans la bo&icirc;te de dialogue
Taille, s&eacute;lectionnez l'option Conserver le format d'image pour conserver le rapport hauteur/largeur.
Marges
Cliquez pour sp&eacute;cifier l'espace &agrave; ajouter entre l'image et le texte. Vous pouvez sp&eacute;cifier la m&ecirc;me
largeur de marge de tous les c&ocirc;t&eacute;s ou des largeurs diff&eacute;rentes pour les marges gauche, droite,
sup&eacute;rieure et inf&eacute;rieure.
Bordures
Cliquez pour ajouter une bordure &agrave; l'image et sp&eacute;cifier un style.
Modification d'une image avec RoboScreenCapture
1)
2)
Dans l'&eacute;diteur de conception, s&eacute;lectionnez l'image &agrave; modifier.
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez Modifier &gt; Afficher &gt; Image.
–
Cliquez avec le bouton droit de la souris et s&eacute;lectionnez l'option Modifier avec
RoboScreenCapture.
3)
4)
Modifiez l'image.
Cliquez sur Enregistrer.
REMARQUE : Pour plus d'informations, voir l'aide de RoboScreenCapture.
304
CHAPITRE 9
IMAGES
MULTIM&Eacute;DIA ET EFFETS SP&Eacute;CIAUX
Vignettes
Prise en charge des vignettes
Vous pouvez d&eacute;sormais ajouter des images sous forme de vignettes dans un document, qui peuvent &ecirc;tre
agrandies lorsque l'utilisateur clique dessus. Les utilisateurs auront une plus grande souplesse en
d&eacute;finissant une taille de vignette standard qui assurera une apparence coh&eacute;rente des vignettes tout au
long de la sortie publi&eacute;e. Cela vous permet &eacute;galement de mieux organiser le contenu g&eacute;n&eacute;r&eacute; dans le
document en fonction des images.
REMARQUE : Cette fonction est disponible uniquement pour la sortie Responsive HTML5.
1) S&eacute;lectionnez l'image dans le document.
2) S&eacute;lectionnez Projet &gt; (Ouvrir) Conteneurs &gt; Style et formatage.
3) Dans la liste d&eacute;roulante du conteneur Styles et formatage, s&eacute;lectionnez Styles d'image.
Les styles d'image existants sont r&eacute;pertori&eacute;s.
4) Double-cliquez sur le style d'image pour appliquer les param&egrave;tres &agrave; l'image s&eacute;lectionn&eacute;e &agrave; l'&eacute;tape 1.
REMARQUE : Vous pouvez &eacute;galement cr&eacute;er un nouveau style d'image, ou modifier un style existant &agrave;
l'aide de l'option de menu qui pr&eacute;c&egrave;de la liste d&eacute;roulante contenant diff&eacute;rents styles d'image. Les
propri&eacute;t&eacute;s de hauteur et de largeur dans un style d'image contr&ocirc;lent la taille maximale d'une image
lorsqu'elle est ouverte en plein &eacute;cran. Si aucune valeur n'est sp&eacute;cifi&eacute;e pour les propri&eacute;t&eacute;s de
hauteur et de largeur, l'image est affich&eacute;e dans sa taille d'origine en plein &eacute;cran. Vous pouvez cr&eacute;er
un style d'image et d&eacute;finir les propri&eacute;t&eacute;s de hauteur et de largeur pour donner une apparence
coh&eacute;rente aux images en plein &eacute;cran.
5) Dans l'onglet Sortie sous la section G&eacute;n&eacute;rer, cliquez sur Responsive HTML5.
La bo&icirc;te de dialogue Param&egrave;tres Responsive HTML5 s'ouvre.
6) Dans l'onglet G&eacute;n&eacute;ral, sous la section Gestion de vignettes, sp&eacute;cifiez le nom des styles et les
dimensions de vignette. S'il existe plus d'un style que vous souhaitez utiliser pour les vignettes,
utilisez des virgules pour les s&eacute;parer.
REMARQUE : Si la taille d'origine d'une image est de 75x75 pixels et que vous sp&eacute;cifiez la taille des
vignettes sur 100x100 pixels, la vignette est cr&eacute;&eacute;e avec une dimension de 75x75 pixels. Toutefois, si
la taille de l'image est de 150x150 pixels, la vignette est cr&eacute;&eacute;e avec une dimension de 100x100
pixels. Lorsqu'un utilisateur clique sur la vignette, l'image est affich&eacute;e dans sa taille d'origine de
150x150 pixels.
7) Sp&eacute;cifiez l'emplacement de sortie dans les champs Dossier de sortie et Page de lancement.
305
CHAPITRE 9
8)
IMAGES
MULTIM&Eacute;DIA ET EFFETS SP&Eacute;CIAUX
Cliquez sur Enregistrer et g&eacute;n&eacute;rer pour g&eacute;n&eacute;rer la sortie.
Mappages d'image
Cr&eacute;ation d'une carte-image
1)
2)
3)
4)
5)
6)
Dans l'&eacute;diteur de conception, ouvrez une rubrique contenant une image.
Cliquez avec le bouton droit de la souris sur l'image. S&eacute;lectionnez Ins&eacute;rer un mappage de l'image.
S&eacute;lectionnez Rectangle, Cercle ou Polygone.
Le curseur se transforme en curseur &agrave; r&eacute;ticule .
Tracez une zone cliquable &agrave; l'int&eacute;rieur de l'image.
Dans Lien vers, cliquez sur le menu contextuel en triangle . S&eacute;lectionnez un fichier sous
S&eacute;lectionner une destination (fichier ou URL) ou une autre destination.
Dans Texte de l'info-bulle, saisissez le texte &agrave; afficher lorsque l'utilisateur passe la souris sur le
mappage d'image.
306
D&Eacute;MONSTRATIONS ADOBE CAPTIVATE
MULTIM&Eacute;DIA ET EFFETS SP&Eacute;CIAUX
CHAPITRE 9
7)
8)
Cliquez sur OK.
ASTUCE : Le gestionnaire de projets enregistre le mappage d'image avec les images dans le dossier
Images. Un signe plus (+) &agrave; gauche de l'ic&ocirc;ne du bouton Image indique la pr&eacute;sence d'un mappage
d'image : . Cliquez sur le signe plus pour afficher la liste de toutes les zones cliquables dans le
mappage d'image. Les liens de zone cliquable sont indiqu&eacute;s par l'ic&ocirc;ne Zone cliquable .
Pour tester l'op&eacute;ration, cliquez sur le bouton Afficher sur la barre d'outils. Cliquez sur la zone
cliquable.
Modification d'un mappage d'image
1)
2)
3)
4)
5)
Dans l'&eacute;diteur de conception, ouvrez la rubrique contenant le mappage d'image.
Cliquez deux fois sur la zone cliquable.
Dans Lien vers, cliquez sur le menu contextuel en triangle . S&eacute;lectionnez un fichier sous
S&eacute;lectionner une destination (fichier ou URL) ou une autre destination.
Cliquez sur OK. Si une invite s'affiche, s&eacute;lectionnez OK pour copier le fichier dans le projet.
Pour effectuer un test, cliquez sur le bouton Afficher dans la barre d'outils. Cliquez sur la zone
cliquable.
LIENS CONNEXES :
Lien vers des fen&ecirc;tres contextuelles
Conformit&eacute; W3C
9.2.
D&eacute;monstrations Adobe Captivate
Suivez les proc&eacute;dures ci-apr&egrave;s pour int&eacute;grer le contenu cr&eacute;&eacute; &agrave; l'aide d'Adobe Captivate et mettre &agrave; jour
la source dans RoboHelp. Vous pouvez lancer Adobe Captivate depuis RoboHelp et cr&eacute;er des rubriques
de d&eacute;monstration. Vous pouvez &eacute;galement ins&eacute;rer une sortie SWF et HTML5 de d&eacute;monstrations Adobe
Captivate dans les rubriques existantes. Les d&eacute;monstrations sont un mode d'enregistrement dans Adobe
Captivate. Pour plus d'informations, voir l'aide d'Adobe Captivate.
Lorsqu'une d&eacute;monstration Adobe Captivate est ajout&eacute;e dans le projet, vous pouvez ouvrir la source dans
RoboHelp et la modifier.
Cr&eacute;ation d'une d&eacute;monstration Adobe Captivate
Cr&eacute;ez une d&eacute;monstration Adobe Captivate &agrave; partir de RoboHelp.
1) S&eacute;lectionnez Projet &gt; Nouveau &gt; Rubrique &gt; Rubrique Adobe Captivate.
2) Sp&eacute;cifiez le nom du projet Adobe Captivate qui sera cr&eacute;&eacute;.
3) Dans la zone Titre de la rubrique D&eacute;monstration, saisissez le nom de la rubrique.
4) Dans le champ Nom du fichier, indiquez un nom de fichier en ajoutant l'extension .htm.
5) Cliquez sur OK.
6) Cr&eacute;ez la d&eacute;monstration.
REMARQUE : Vous ne pouvez pas acc&eacute;der &agrave; RoboHelp lorsqu'Adobe Captivate est ouvert.
307
CHAPITRE 9
7)
8)
9)
D&Eacute;MONSTRATIONS ADOBE CAPTIVATE
MULTIM&Eacute;DIA ET EFFETS SP&Eacute;CIAUX
Enregistrez la d&eacute;monstration et fermez Captivate.
Pour tester la d&eacute;monstration, s&eacute;lectionnez ou ouvrez la rubrique h&ocirc;te et cliquez sur Afficher .
Ouvrez la rubrique et ajoutez les informations suppl&eacute;mentaires telles que les en-t&ecirc;tes, les pieds de
page, la couleur d'arri&egrave;re-plan ou le texte du titre.
REMARQUE : Vous pouvez s&eacute;lectionner la d&eacute;monstration Adobe Captivate ins&eacute;r&eacute;e dans la rubrique et
la couper/coller dans une autre rubrique si n&eacute;cessaire.
Insertion d'une d&eacute;monstration Adobe Captivate
Vous pouvez ajouter un lien vers une rubrique de d&eacute;monstration dans les autres rubriques du projet, les
livres et les pages de la table des mati&egrave;res et les mots cl&eacute;s d'index. Lorsque l'utilisateur clique sur le lien,
la d&eacute;monstration commence.
1) Dans RoboHelp, ouvrez la rubrique dans laquelle vous voulez ins&eacute;rer la d&eacute;monstration.
2) Placez le curseur &agrave; l'emplacement d'insertion de la d&eacute;monstration.
3) Dans le menu Ins&eacute;rer, s&eacute;lectionnez D&eacute;monstration Adobe Captivate. La bo&icirc;te de dialogue
D&eacute;monstration Adobe Captivate s'affiche :
–
Si le fichier de d&eacute;monstration SWF existe d&eacute;j&agrave; dans le projet, s&eacute;lectionnez-le dans la liste
Contenu multim&eacute;dia dans des dossiers du projet.
–
Si le fichier ne se trouve pas dans le dossier du projet, cliquez sur le bouton Parcourir ,
acc&eacute;dez au fichier SWF, puis cliquez sur Ouvrir. A l'invite, cliquez sur Oui pour copier le fichier
dans le dossier du projet.
–
Si la sortie Adobe Captivate HTML5 de la d&eacute;monstration est disponible, recherchez et
s&eacute;lectionnez le fichier .htm.
REMARQUE : RoboHelp ajoute le fichier .htm sous la forme d'un fichier de bagage et utilise
l'extension .cpz. Si vous n'avez pas sp&eacute;cifi&eacute; le fichier SWF avec le fichier de sortie HTML5,
RoboHelp ajoute un espace SWF pour son utilisation dans l'&eacute;diteur de conception. Cela
signifie que vous ne pouvez pas modifier la d&eacute;monstration &agrave; partir de RoboHelp. La sortie
HTML5 de la d&eacute;monstration est utilis&eacute;e uniquement dans la sortie de projet g&eacute;n&eacute;r&eacute;e &agrave; l'aide
de la mise en page sur &eacute;crans multiples HTML5.
4)
5)
Cliquez sur OK. Un objet de la rubrique indique l'emplacement du fichier.
Pour tester la d&eacute;monstration, cliquez sur Afficher .
Importation d'une d&eacute;monstration Adobe Captivate
Vous pouvez importer une d&eacute;monstration Adobe Captivate dans le projet RoboHelp sous la forme d'une
nouvelle rubrique.
1) S&eacute;lectionnez Projet &gt; Importer &gt; Document &gt; D&eacute;monstration Adobe Captivate.
2) Indiquez un titre pour la nouvelle rubrique que vous voulez cr&eacute;er pour la d&eacute;monstration.
3) Indiquez le chemin de la sortie HTML5 de la d&eacute;monstration.
4) Indiquez le chemin de la sortie SWF pour la d&eacute;monstration.
308
MULTIM&Eacute;DIA
MULTIM&Eacute;DIA ET EFFETS SP&Eacute;CIAUX
CHAPITRE 9
Remarques :
•
Si vous avez sp&eacute;cifi&eacute; un chemin de sortie HTML5 sans indiquer de chemin de sortie SWF
correspondant, RoboHelp ajoute un espace r&eacute;serv&eacute; au SWF pour utilisation dans l'&eacute;diteur de
conception. Ce fichier SWF est non modifiable.
•
Si un fichier FLV est imbriqu&eacute; dans le fichier SWF en cours d'importation, RoboHelp ne peut
importer ce fichier FLV. Ajoutez le fichier FLV en tant que fichier bagage. Voir Ajout de fichiers et de
dossiers au dossier Fichiers bagage.
Modification d'une d&eacute;monstration Adobe Captivate
1)
2)
3)
4)
Ouvrez la rubrique contenant la d&eacute;monstration Adobe Captivate ou d&eacute;veloppez le dossier
Multim&eacute;dia dans le gestionnaire de projets.
Cliquez avec le bouton droit de la souris sur la d&eacute;monstration. S&eacute;lectionnez l'option Modifier.
REMARQUE : Si vous avez ins&eacute;r&eacute; un fichier de sortie HTML5 et ignor&eacute; l'insertion du fichier SWF
correspondant, RoboHelp ajoute un espace SWF pour utilisation dans l'&eacute;diteur de conception.
Ce fichier SWF est non modifiable.
Effectuez vos modifications.
Fermez Adobe Captivate.
REMARQUE : Lorsque vous affichez un aper&ccedil;u de d&eacute;monstration Adobe Captivate dans RoboHelp, un
message peut vous inviter &agrave; mettre &agrave; jour le fichier dans le projet. Ce message appara&icirc;t uniquement si
vous avez enregistr&eacute; la d&eacute;monstration Adobe Captivate hors de RoboHelp vers l'emplacement Adobe
Captivate par d&eacute;faut. soit C:\Documents and Settings\[nom utilisateur]\Mes documents\Mes projets
Adobe Captivate\. Mettez &agrave; jour le fichier pour appliquer les modifications effectu&eacute;es en dehors de
RoboHelp.
9.3.
Multim&eacute;dia
Ajout d'&eacute;l&eacute;ments multim&eacute;dia
1)
2)
3)
4)
S&eacute;lectionnez un emplacement de la rubrique pour y ins&eacute;rer les &eacute;l&eacute;ments multim&eacute;dia.
S&eacute;lectionnez Ins&eacute;rer &gt; M&eacute;dia &gt; Multim&eacute;dia.
S&eacute;lectionnez l'option Hors ligne (dossier local) pour ins&eacute;rer le fichier multim&eacute;dia &agrave; partir d'un
dossier local ou l'option En ligne (URL) pour incorporer une vid&eacute;o en ligne en utilisant son URL.
Si vous s&eacute;lectionnez l'option multim&eacute;dia Hors ligne (dossier local), effectuez l'une des op&eacute;rations
suivantes :
–
Pour ajouter un nouveau fichier, cliquez sur le bouton Parcourir et acc&eacute;dez au fichier.
Cliquez deux fois dessus. Cliquez sur Oui.
–
Pour ajouter un fichier existant, s&eacute;lectionnez-le dans la liste Contenu multim&eacute;dia dans des
dossiers du projet.
309
CHAPITRE 9
5)
6)
MULTIM&Eacute;DIA
MULTIM&Eacute;DIA ET EFFETS SP&Eacute;CIAUX
Si vous s&eacute;lectionnez l'option multim&eacute;dia En ligne (URL), saisissez l'URL source (dans le code
incorpor&eacute;) de la vid&eacute;o en ligne, comme cela est expliqu&eacute; dans la remarque ci-dessous. Pour
incorporer des vid&eacute;os Youtube, Vimeo ou Dailymotion, vous pouvez fournir l'URL http &agrave; la place de
l'URL source.
REMARQUE : L'URL source de la vid&eacute;o peut &ecirc;tre copi&eacute;e &agrave; partir du code incorpor&eacute; de la vid&eacute;o en ligne.
Consid&eacute;rez le code incorpor&eacute; suivant comme exemple : &lt;iframe width=&quot;560&quot; height=&quot;315&quot;
src=&quot;https://www.youtube.com/embed/PAxxJKa3PDo&quot; frameborder=&quot;0&quot; allowfullscreen&gt;&lt;/iframe&gt;. Ici, l'URL source requise pour incorporer la vid&eacute;o est :
https://www.youtube.com/embed/PAxxJKa3PDo. Cette URL source est diff&eacute;rente
de l'URL http de la vid&eacute;o.
D&eacute;finissez les options suivantes :
Habillage du texte
D&eacute;finit l'alignement de l'objet multim&eacute;dia par rapport au texte qui l'entoure.
Info-bulle
Remplace le fichier multim&eacute;dia par un libell&eacute; si l'utilisateur d&eacute;sactive les fonctions multim&eacute;dia de
son navigateur.
7)
Vous pouvez d&eacute;finir les param&egrave;tres d'aspect. Les param&egrave;tres que vous sp&eacute;cifiez affectent la mani&egrave;re
dont la vid&eacute;o incorpor&eacute;e appara&icirc;t dans la sortie Web publi&eacute;e.
Taille
Indique la taille de la vid&eacute;o incorpor&eacute;e.
Si vous ajoutez une vid&eacute;o Quicktime, vous devez ajouter 16 pixels &agrave; la taille de la vid&eacute;o. Cela signifie
que si votre vid&eacute;o est de 320 x 240, vous devez d&eacute;finir la taille (dans le menu d&eacute;roulant Aspect d&eacute;crit
ci-dessus), comme 336 x 256.
Marge
Indique, en pouces, les marges gauche, droite, sup&eacute;rieure et inf&eacute;rieure.
Bordures
Permet de d&eacute;finir une bordure autour de l'objet vid&eacute;o.
Param&egrave;tres du lecteur
Sp&eacute;cifie les param&egrave;tres vid&eacute;o associ&eacute;s aux commandes du lecteur, &agrave; la lecture et au son dans la
sortie publi&eacute;e. Les options suivantes sont disponibles :
Auto :
Afficher les commandes du lecteur au survol. Cette option est disponible uniquement si vous
incorporez une vid&eacute;o en ligne.
Toujours :
Toujours afficher les commandes du lecteur.
310
CHAPITRE 9
MULTIM&Eacute;DIA
MULTIM&Eacute;DIA ET EFFETS SP&Eacute;CIAUX
Jamais :
Ne jamais afficher les commandes du lecteur.
Afficher les annotations le cas &eacute;ch&eacute;ant :
Afficher les annotations &eacute;ventuellement disponibles dans les &eacute;l&eacute;ments multim&eacute;dias incorpor&eacute;s.
Cette option est disponible uniquement si vous incorporez une vid&eacute;o en ligne.
Plein &eacute;cran:
Afficher l'&eacute;l&eacute;ment multim&eacute;dia en plein &eacute;cran.
Lecture auto :
lire automatiquement l'&eacute;l&eacute;ment multim&eacute;dia lorsque vous ouvrez la rubrique qui le contient.
Boucle:
lire en boucle l'&eacute;l&eacute;ment multim&eacute;dia &laquo; n &raquo; fois jusqu'&agrave; ce que l'utilisateur l'arr&ecirc;te manuellement.
Choisissez l'option de boucle infinie ou sp&eacute;cifiez une valeur pour &laquo; n &raquo; pour d&eacute;finir un nombre fini
de boucles. Il convient de noter que l'option de boucle termin&eacute;e est uniquement disponible pour le
type d'&eacute;l&eacute;ment multim&eacute;dia window media video(wmv), tandis que l'option de boucle infinie est
disponible pour tous les types de m&eacute;dia sauf window media video (wmv).
Muet:
D&eacute;marrez la vid&eacute;o en mode silence, qui peut ensuite &ecirc;tre modifi&eacute; manuellement.
Volume initial :
Sp&eacute;cifiez le volume initial de la vid&eacute;o, qui peut ensuite &ecirc;tre modifi&eacute; manuellement. Cette option est
disponible uniquement pour les fichiers vid&eacute;o HTML5.
8)
9)
Cliquez sur OK.
Cr&eacute;ez un lien vers le fichier multim&eacute;dia &agrave; proximit&eacute; de l'objet avec une note invitant les utilisateurs
&agrave; cliquer sur le lien s'ils ne parviennent pas &agrave; acc&eacute;der au fichier multim&eacute;dia.
10) Pour tester l'op&eacute;ration ou afficher un aper&ccedil;u, cliquez sur le bouton Afficher l'&eacute;l&eacute;ment dans Projet &gt;
Affichage.
IMPORTANT : Les param&egrave;tres du lecteur que vous sp&eacute;cifiez d&eacute;pendent du type de vid&eacute;o de sortie (par
exemple .mov ou.qt) pour les vid&eacute;os en ligne. Pour les vid&eacute;os en ligne, les param&egrave;tres d&eacute;pendent de ceux
offerts par l'&eacute;diteur (tels que youtube.com ou vimeo.com.)
REMARQUE : Certains formats de fichier ne fonctionnent pas correctement dans les fichiers d'aide
Microsoft HTML Help compil&eacute;s.
311
MULTIM&Eacute;DIA
MULTIM&Eacute;DIA ET EFFETS SP&Eacute;CIAUX
CHAPITRE 9
La liste suivante r&eacute;pertorie les types de fichier multim&eacute;dia autoris&eacute;s :
•
Fichiers vid&eacute;o : *.avi, *.asf, *.asx, *.mpg, *.mpeg, *.mpg4, *.mpe, *.mov, *.qt, *.ra, *.rm, *.rpm,
*.wmv, *.wvx
•
Fichiers vid&eacute;o HTML5 : * .mp4, * .ogg, * .ogv, * .webm.
Les formats .ogg, .ogv et .webm sont pris en charge uniquement pour les SSL Multi-&eacute;cran HTML5.
Ces formats ne sont pas pris en charge dans Internet Explorer. Reportez-vous au tableau ci-dessous
pour plus d'informations sur la configuration de navigateur requise pour la lecture de vid&eacute;os dans
la sortie Multi-&eacute;cran HTML5 :
Internet Explorer
Firefox
Chrome
Safari
Ogg
Non pris en charge
3.5+
5.0+
Non pris en charge
MPEG4
9.0+
Non pris en charge
5.0+
3.0+
WebM
Non pris en charge
4.0+
6.0+
Non pris en charge
Where:
Ogg repr&eacute;sente les fichiers Ogg ainsi que le codec vid&eacute;o Theora et le codec audio Vorbis.
MPEG4 repr&eacute;sente les fichiers MPEG 4 avec le codec vid&eacute;o H.264 et le codec audio AAC.
WebM repr&eacute;sente les fichiers WebM avec le codec vid&eacute;o VP8 et le codec audio Vorbis.
ASTUCE : Pour une compatibilit&eacute; plus large avec diff&eacute;rents navigateurs sur plusieurs p&eacute;riph&eacute;riques,
utilisez des fichiers vid&eacute;o MP4. Les vid&eacute;os MP4 sont &eacute;galement prises en charge dans la sortie EPUB3
eBook.
Remarques :
–
(Firefox uniquement) Par d&eacute;faut, les vid&eacute;os MP4 dans la sortie Multi-&eacute;cran HTML5 sont
affich&eacute;es au format 400 x 300 pixels. Vous pouvez sp&eacute;cifier une taille de vid&eacute;o diff&eacute;rente si
n&eacute;cessaire.
–
(Windows 7 et Internet Explorer 9) Pour afficher les vid&eacute;os MP4 dans la sortie Multi-&eacute;cran
HTML5, assurez-vous que le Lecteur Windows Media est install&eacute;.
•
•
•
•
•
•
•
•
Fichiers vid&eacute;o MPEG : *.mpg, *.mpeg, *.mpg4, *.mpe
REMARQUE : Les fichiers MPEG 4 avec le codec vid&eacute;o H. 264 et le codec audio AAC et sont pris en
charge au format natif par la plupart des navigateurs.
Fichiers Windows Media : *.avi, *.asf, *.asx, *.wma, *.wmv, *.wax, *.wvx
Fichiers QuickTime : * .qt, * .mov
Fichiers Real : *.ra, *.rm, *.rpm
Fichiers audio : *.asf, *.asx, *.mp3, *.mp4, *.wav, *.au, *.mid, *.rmi, *.ra, *.rm, *.wma, *.wax
Fichiers Flash : *.swf
Fichiers vid&eacute;o Flash : *.flv, *.f4v
Fichiers Adobe Captivate : *.swf
Si le fichier multim&eacute;dia est utilis&eacute; par d'autres rubriques, ajoutez-le en le faisant glisser &agrave; partir du dossier
Multim&eacute;dia.
312
HTML DYNAMIQUE ET EFFETS SP&Eacute;CIAUX
MULTIM&Eacute;DIA ET EFFETS SP&Eacute;CIAUX
CHAPITRE 9
REMARQUE : Le contenu multim&eacute;dia peut avoir des d&eacute;pendances, par exemple les lecteurs Flash ou
vid&eacute;o/audio dont vous avez besoin pour les afficher ou les &eacute;couter.
Modification d'&eacute;l&eacute;ments multim&eacute;dia
1)
2)
3)
4)
Cliquez deux fois sur l'objet multim&eacute;dia. La bo&icirc;te de dialogue Multim&eacute;dia s'affiche.
Effectuez vos modifications.
Cliquez sur OK.
Pour effectuer un test, cliquez sur le bouton Afficher dans la barre d'outils.
Suppression d'&eacute;l&eacute;ments multim&eacute;dia des rubriques
1)
2)
Cliquez sur l'objet multim&eacute;dia pour le s&eacute;lectionner.
Cliquez sur le bouton Supprimer .
ASTUCE : Cliquez sur Annuler
9.4.
pour restaurer un &eacute;l&eacute;ment multim&eacute;dia supprim&eacute;.
HTML dynamique et effets sp&eacute;ciaux
Le format DHTML (Dynamic HTML) ou HTML dynamique, associe des fonctionnalit&eacute;s multim&eacute;dia au
langage de script et permet la cr&eacute;ation d'effets visuels et 3D. Les effets ins&eacute;r&eacute;s donnent du mouvement
ou agissent en fonction de l'entr&eacute;e utilisateur, comme un clic de souris. Lorsque vous utilisez le format
DHTML, tenez compte des remarques suivantes :
•
Les effets de survol de souris incluent les effets d'ombre port&eacute;e, de changement de police, de
scintillement et les effets Rock'n Roll.
•
Les effets de chargement de page, de clic de page ou d'activation de d&eacute;clencheurs incluent les effets
de flou, d'&eacute;lastique, de fondu en entr&eacute;e ou en sortie, de retournement horizontal ou vertical,
d'envol ou d'atterrissage, de gris, de masquage ou d'affichage, de spirale ainsi que les effets Rock'n
Roll.
•
Vous pouvez associer certains effets.
•
Pour obtenir un r&eacute;sultat optimal, utilisez le format DHTML avec Internet Explorer 5.0 ou une version
plus r&eacute;cente.
•
Les effets dynamiques dans les styles ne sont pas pris en charge dans les sorties conformes aux
directives W3C. Si vous validez le code de conformit&eacute; W3C, le rapport peut indiquer des erreurs.
REMARQUE : Les fichiers HTML prennent en charge les effets DHTML dans les navigateurs IE et non IE,
mais XHTML ne prend pas en charge toutes les occurrences des effets DHTML.
LIENS CONNEXES :
Application de balises de construction conditionnelles au contenu
313
CHAPITRE 9
HTML DYNAMIQUE ET EFFETS SP&Eacute;CIAUX
MULTIM&Eacute;DIA ET EFFETS SP&Eacute;CIAUX
Principes de base du format DHTML
Ajout d'effets DHTML &agrave; une rubrique
1)
Ouvrez une rubrique dans l'&eacute;diteur de conception et s&eacute;lectionnez un &eacute;l&eacute;ment. Proc&eacute;dez de l'une
des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez du texte.
–
Pour appliquer l'effet &agrave; un paragraphe entier, cliquez &agrave; l'int&eacute;rieur de ce paragraphe.
–
Pour les zones positionn&eacute;es, s&eacute;lectionnez la zone de texte. Des carr&eacute;s gris s'affichent autour.
2)
3)
4)
5)
S&eacute;lectionnez Ins&eacute;rer &gt; DHTML &gt; Effets &gt; Effets.
Dans la liste Quand, s&eacute;lectionnez l'&eacute;v&eacute;nement qui d&eacute;clenche l'effet.
Dans la liste Quoi, s&eacute;lectionnez l'effet &agrave; appliquer.
Dans la liste Param&egrave;tres d&eacute;finissez les propri&eacute;t&eacute;s de l'effet.
L'effet DHTML est indiqu&eacute; par un motif hachur&eacute; gris clair .
ASTUCE : Pour appliquer l'effet &agrave; la rubrique correcte, utilisez la liste de balises de l'onglet Conception.
Application d'effets DHTML &agrave; plusieurs paragraphes
1)
2)
3)
4)
5)
6)
7)
8)
9)
Dans la rubrique, cliquez sur l'emplacement souhait&eacute; pour la zone de texte.
S&eacute;lectionnez Ins&eacute;rer &gt; HTML &gt; Zone de texte.
Cliquez avec le bouton droit de la souris sur la zone de texte et s&eacute;lectionnez Propri&eacute;t&eacute;s de Zone de
texte. D&eacute;finissez les propri&eacute;t&eacute;s.
Saisissez le texte dans la zone.
Cliquez sur la zone pour la s&eacute;lectionner.
S&eacute;lectionnez Ins&eacute;rer &gt; DHTML &gt; Effets &gt; Effets.
Dans la liste Quand, s&eacute;lectionnez l'&eacute;v&eacute;nement qui d&eacute;clenche l'effet.
Dans la liste Quoi, s&eacute;lectionnez l'effet &agrave; appliquer.
Dans la liste Param&egrave;tres d&eacute;finissez les propri&eacute;t&eacute;s de l'effet.
Mise &agrave; jour des effets DHTML dans une rubrique
Mettez les effets DHTML &agrave; jour en enregistrant &agrave; nouveau les rubriques dans l'une ou l'autre de ces
situations :
•
Vous ajoutez un style ou en modifiez un pour qu'il contienne un effet HTML dynamique. Dans ce
cas, enregistrez une nouvelle fois les rubriques d&eacute;pendant de la feuille de style, de fa&ccedil;on qu'elles
incluent du code pour la cr&eacute;ation de l'effet.
•
Vous ouvrez un projet dans une version ant&eacute;rieure &agrave; la version 8.0 de RoboHelp.
Vous pouvez r&eacute;enregistrer les rubriques &agrave; l'invite ou les mettre &agrave; jour ult&eacute;rieurement en cliquant sur
l'onglet Conception et en s&eacute;lectionnant Outils &gt; Scripts &gt; Mettre &agrave; jour DHTML.
314
HTML DYNAMIQUE ET EFFETS SP&Eacute;CIAUX
MULTIM&Eacute;DIA ET EFFETS SP&Eacute;CIAUX
CHAPITRE 9
Modification ou suppression d'effets DHTML
1)
2)
Ouvrez la rubrique dans l'&eacute;diteur de conception.
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez la rubrique contenant l'effet &agrave; modifier. S&eacute;lectionnez Ins&eacute;rer &gt; DHTML &gt; Effets &gt;
Effets.
–
S&eacute;lectionnez l'&eacute;l&eacute;ment &agrave; supprimer, puis choisissez Ins&eacute;rer &gt; DHTML &gt; Effets &gt; Supprimer les
effets.
ASTUCE : La sortie EPUB ne prend pas en charge les effets DHTML. Pour exclure les effets DHTML &agrave; partir
de la sortie EPUB, vous pouvez utiliser des balises de construction conditionnelles.
LIENS CONNEXES :
G&eacute;n&eacute;ration d'une sortie EPUB et Kindle Book
G&eacute;n&eacute;ration d'une sortie EPUB et Kindle Book
Zones cliquables dynamiques
A propos des zones cliquables DHTML
Les zones cliquables DHTML affichent des informations lorsque l'utilisateur clique dessus.
Expansion de zone cliquable
Lorsque l'utilisateur clique sur la zone cliquable, les informations suppl&eacute;mentaires s'affichent en
regard.
Zone cliquable d&eacute;roulante
Lorsque l'utilisateur clique sur la zone cliquable, les informations suppl&eacute;mentaires s'affichent en
dessous.
Ajout de zones cliquables DHTML
1)
2)
3)
Ouvrez la rubrique dans l'onglet Conception. S&eacute;lectionnez le texte que vous souhaitez utiliser en
tant que zone cliquable.
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Pour cr&eacute;er une zone cliquable &agrave; d&eacute;velopper, s&eacute;lectionnez Ins&eacute;rer &gt; DHTML &gt; Expansion de
texte. Dans l'&eacute;diteur de texte, saisissez le texte &agrave; afficher dans la zone cliquable. Cliquez en
dehors de la fen&ecirc;tre pour fermer l'&eacute;diteur.
–
Pour cr&eacute;er une zone cliquable d&eacute;roulante, s&eacute;lectionnez Ins&eacute;rer &gt; DHTML &gt; Texte d&eacute;roulant.
Saisissez le texte ou les images dans la liste d&eacute;roulante. Cliquez en dehors de l'&eacute;diteur de texte
d&eacute;roulant.
Cliquez sur le bouton Afficher
pour effectuer un test.
ASTUCE : Formatez les zones cliquables DHTML diff&eacute;remment du texte qui les entoure pour qu'elles soient
visibles par le lecteur.
315
CHAPITRE 9
HTML DYNAMIQUE ET EFFETS SP&Eacute;CIAUX
MULTIM&Eacute;DIA ET EFFETS SP&Eacute;CIAUX
Suppression de zones cliquables
REMARQUE : Le contenu de la zone cliquable est &eacute;galement supprim&eacute;.
1)
Cliquez avec le bouton droit de la souris sur une zone cliquable. S&eacute;lectionnez l'option de
suppression du texte &agrave; d&eacute;velopper ou du texte d&eacute;roulant.
Modification du formatage des zones cliquables DHTML
Vous pouvez modifier le formatage dans une rubrique ou dans toutes les rubriques &agrave; l'aide d'une feuille
de style. Si vous disposez de plusieurs feuilles de style, modifiez chaque feuille de style associ&eacute;e aux
rubriques contenant des zones cliquables.
1) S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Style et formatage.
2) Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Pour modifier le formatage dans une seule rubrique, sous Disponible dans, s&eacute;lectionnez le
nom de la rubrique &agrave; modifier.
–
Pour modifier le formatage de toutes les rubriques associ&eacute;es &agrave; une feuille de style, sous
Disponible dans, s&eacute;lectionnez la feuille de style externe.
3)
4)
5)
6)
Sous Styles, s&eacute;lectionnez le style de la zone cliquable &agrave; modifier.
Cliquez sur Modifier.
Cliquez sur Format et s&eacute;lectionnez les attributs &agrave; modifier.
Cliquez sur OK. Cliquez sur Fermer.
D&eacute;clencheurs et cibles
A propos des d&eacute;clencheurs et des cibles
Les d&eacute;clencheurs d&eacute;signent du texte ou des images auxquels un effet DHTML sp&eacute;cial a &eacute;t&eacute; appliqu&eacute;.
Lorsque l'utilisateur clique sur un d&eacute;clencheur, une cible s'affiche. Pour ouvrir les effets DHTML &agrave; l'aide
de d&eacute;clencheurs, commencez par appliquer un d&eacute;clencheur &agrave; du texte ou &agrave; une image, puis associez le
d&eacute;clencheur &agrave; une cible et appliquez-lui un effet DHTML. Lorsque vous utilisez des d&eacute;clencheurs et des
cibles, tenez compte des remarques suivantes :
•
Les d&eacute;clencheurs et les cibles doivent se trouver dans la m&ecirc;me rubrique.
•
Pour signaler qu'un &eacute;l&eacute;ment est cliquable, modifiez la couleur de la police et soulignez le texte ou
ajoutez du texte &agrave; une image.
Exemple de d&eacute;clencheurs et de cibles images
316
CHAPITRE 9
HTML DYNAMIQUE ET EFFETS SP&Eacute;CIAUX
MULTIM&Eacute;DIA ET EFFETS SP&Eacute;CIAUX
Affectation d'un d&eacute;clencheur &agrave; du texte ou &agrave; une image
1)
2)
3)
S&eacute;lectionnez l'&eacute;l&eacute;ment texte ou image auquel vous souhaitez affecter le d&eacute;clencheur.
S&eacute;lectionnez Ins&eacute;rer &gt; DHTML &gt; D&eacute;clencheur &gt; D&eacute;clencheur. Une ic&ocirc;ne repr&eacute;sentant un enrouleur
de c&acirc;bles s'affiche. Des hachures couvrent le texte.
Associez le d&eacute;clencheur &agrave; une image ou &agrave; du texte.
Association de d&eacute;clencheurs &agrave; du texte
1)
2)
3)
4)
5)
6)
7)
S&eacute;lectionnez le texte que vous souhaitez utiliser en tant que cible.
S&eacute;lectionnez Ins&eacute;rer &gt; DHTML &gt; Effets &gt; Effets.
Sous Quand, s&eacute;lectionnez Activation du 1er d&eacute;clencheur.
Sous Quoi, s&eacute;lectionnez l'effet &agrave; associer &agrave; la premi&egrave;re activation du d&eacute;clencheur, puis d&eacute;finissez ses
propri&eacute;t&eacute;s.
S&eacute;lectionnez Activation du 2&egrave;me d&eacute;clencheur et d&eacute;finissez ses propri&eacute;t&eacute;s.
Cliquez sur OK. Une ic&ocirc;ne repr&eacute;sentant une prise &eacute;lectrique s'affiche &agrave; c&ocirc;t&eacute; du texte, signalant
qu'il s'agit d'une cible.
Cliquez sur le d&eacute;clencheur et faites glisser la souris pour relier le d&eacute;clencheur au texte cible. Pour connecter
le d&eacute;clencheur &agrave; plusieurs textes cibles, maintenez la touche Maj enfonc&eacute;e et cliquez sur le d&eacute;clencheur.
Maintenez toujours la touche Maj enfonc&eacute;e et faites glisser la souris sur le texte cible suivant.
Association de d&eacute;clencheurs &agrave; des images
1)
2)
3)
4)
5)
Cliquez sur l'image du d&eacute;clencheur pour afficher l'ic&ocirc;ne repr&eacute;sentant un enrouleur de c&acirc;bles vert .
Cliquez sur cette ic&ocirc;ne et faites glisser la souris pour relier l'image &agrave; l'image cible. Une ligne verte
signale l'association entre le d&eacute;clencheur et la cible.
S&eacute;lectionnez un effet DHTML dans le menu.
Pour associer une autre cible, maintenez la touche Maj enfonc&eacute;e et cliquez de nouveau sur le d&eacute;clencheur.
Maintenez toujours la touche Maj enfonc&eacute;e et faites glisser la souris sur l'image cible suivante.
Dans le menu, s&eacute;lectionnez l'effet DHTML &agrave; appliquer &agrave; l'image cible.
Suppression de d&eacute;clencheurs
1)
Cliquez sur l'&eacute;l&eacute;ment de rubrique assign&eacute; &agrave; un d&eacute;clencheur et s&eacute;lectionnez l'option Supprimer un
d&eacute;clencheur DHTML.
317
TEXTE D&Eacute;FILANT
MULTIM&Eacute;DIA ET EFFETS SP&Eacute;CIAUX
CHAPITRE 9
9.5.
Texte d&eacute;filant
Ajout de texte d&eacute;filant
Un texte d&eacute;filant correspond &agrave; un message qui se d&eacute;place &agrave; l'int&eacute;rieur d'une rubrique.
•
Pour ins&eacute;rer un texte d&eacute;filant dans du contenu de rubrique existant, s&eacute;lectionnez le contenu de
rubrique et d&eacute;finissez les propri&eacute;t&eacute;s du texte d&eacute;filant.
•
Pour d&eacute;finir d'abord les propri&eacute;t&eacute;s du texte d&eacute;filant, placez le curseur sur l'emplacement de
destination du texte dans la rubrique. S&eacute;lectionnez Ins&eacute;rer &gt; HTML &gt; Texte d&eacute;filant, puis d&eacute;finissez
les propri&eacute;t&eacute;s du texte d&eacute;filant et saisissez le texte.
REMARQUE : Le format XHTML ne prend pas le texte d&eacute;filant en charge.
D&eacute;finition et modification des propri&eacute;t&eacute;s de texte d&eacute;filant
1)
2)
S&eacute;lectionnez Ins&eacute;rer &gt; HTML &gt; Zone de texte &gt; Texte d&eacute;filant.
Cliquez avec le bouton droit de la souris sur le texte d&eacute;filant et s&eacute;lectionnez l'option Propri&eacute;t&eacute;s de
Texte d&eacute;filant. D&eacute;finissez ou modifiez les propri&eacute;t&eacute;s.
–
Dans Montant, s&eacute;lectionnez la vitesse &agrave; laquelle le texte d&eacute;filant se d&eacute;place. Plus le nombre
est &eacute;lev&eacute;, plus la vitesse est rapide.
–
Dans D&eacute;lai, s&eacute;lectionnez la dur&eacute;e de l'affichage, exprim&eacute;e en millisecondes.
–
Dans Comportement, indiquez la fa&ccedil;on dont le texte d&eacute;filant se d&eacute;place.
D&eacute;filement
Le texte d&eacute;filant se d&eacute;place continuellement dans la fen&ecirc;tre.
Glissement
Le texte d&eacute;filant glisse sur l'&eacute;cran.
Alterner
Le texte d&eacute;filant passe de l'emplacement de d&eacute;part au c&ocirc;t&eacute; oppos&eacute; de la fen&ecirc;tre.
–
3)
Dans R&eacute;p&eacute;tition, indiquez le nombre de r&eacute;p&eacute;titions du texte d&eacute;filant. Avec l'option En continu,
le texte d&eacute;filant se r&eacute;p&egrave;te aussi longtemps que la rubrique est ouverte.
Cliquez sur le bouton Afficher
pour effectuer un test.
Suppression de texte d&eacute;filant
1)
2)
3)
Placez le curseur sur la limite du texte d&eacute;filant.
Cliquez sur le bouton gauche de la souris.
Cliquez sur Supprimer .
318
COMMENTAIRES HTML DANS LES RUBRIQUES
MULTIM&Eacute;DIA ET EFFETS SP&Eacute;CIAUX
CHAPITRE 9
9.6.
Commentaires HTML dans les rubriques
Insertion d'un commentaire HTML
1)
2)
3)
Ouvrez une rubrique dans l'&eacute;diteur de conception.
Dans l'onglet Conception, ins&eacute;rez le curseur, puis s&eacute;lectionnez Ins&eacute;rer &gt; HTML &gt; Zone de texte &gt;
Commentaires.
Dans l'&eacute;diteur de commentaires, indiquez votre commentaire en respectant le format suivant :
&lt;!—un commentaire —&gt;
4)
Cliquez sur OK.
Affichage d'un commentaire HTML
1)
2)
3)
Ouvrez une rubrique dans l'onglet Conception ou HTML.
S&eacute;lectionnez Modifier &gt; Afficher/masquer &gt; Commentaires.
Les commentaires apparaissent sous la forme de notes vertes dans l'onglet Conception et sous la
forme de texte vert dans l'onglet HTML.
(Onglet Conception) Survolez la l&eacute;gende &agrave; l'aide du curseur. Le commentaire appara&icirc;t dans une
fen&ecirc;tre contextuelle.
9.7.
IFrames
Utilisez les balises IFrames (cadres en ligne) pour ins&eacute;rer des fichiers PDF ou HTML dans une
rubrique HTML. Pour afficher un fichier PDF ou un lien URL accessible dans une page HTML, vous pouvez
ins&eacute;rer une balise IFrame et afficher les fichiers requis dans la page HTML s&eacute;lectionn&eacute;e.
Insertion d'un iFrame
1)
2)
3)
4)
5)
S&eacute;lectionnez Ins&eacute;rer &gt; HTML &gt; Zone de texte &gt; IFrame.
Cliquez deux fois sur l'iFrame.
Indiquez un nom. Cliquez sur le bouton Parcourir pour s&eacute;lectionner une URL, un fichier HTML ou
un fichier PDF &agrave; lier.
(Facultatif) Cliquez sur l'onglet Bordure afin de d&eacute;finir les options de bordure.
Cliquez sur OK.
REMARQUE : Vous pouvez afficher le fichier ins&eacute;r&eacute; dans l'aper&ccedil;u et dans l'aide g&eacute;n&eacute;r&eacute;e.
319
CHAPITRE 9
IFRAMES
MULTIM&Eacute;DIA ET EFFETS SP&Eacute;CIAUX
Modification d'un iFrame
•
•
Cliquez deux fois sur l'IFrame afin d'en modifier le nom, l'&eacute;l&eacute;ment li&eacute; ou la bordure.
Faites glisser les poign&eacute;es du cadre pour le redimensionner.
320
CHAPITRE 10
EL&Eacute;MENTS DE TEXTE CONDITIONNEL DE BASE
TEXTE CONDITIONNEL
10. Texte conditionnel
10.1. El&eacute;ments de texte conditionnel de base
Le texte conditionnel vous permet de g&eacute;n&eacute;rer des sous-ensembles de contenu dans le cadre d'un projet
&agrave; l'intention de divers objectifs ou publics. Vous pouvez cr&eacute;er des balises de construction conditionnelles
afin d'exclure le contenu du r&eacute;sultat, puis attribuer ces balises aux rubriques ou aux &eacute;l&eacute;ments des
rubriques.
Personnaliser le r&eacute;sultat sur papier
La documentation en ligne comprend souvent des &eacute;l&eacute;ments inutiles dans les manuels imprim&eacute;s, par
exemple les descriptions de fonctions en ligne. Vous pouvez marquer ces &eacute;l&eacute;ments en tant que texte
conditionnel et les exclure du r&eacute;sultat. Si le manuel est un sous-&eacute;l&eacute;ment de la documentation en ligne,
vous pouvez appliquer une balise de construction conditionnelle aux rubriques et au contenu des
rubriques &agrave; inclure. Appliquez ensuite une autre balise aux autres &eacute;l&eacute;ments. Lorsque vous g&eacute;n&eacute;rez le
projet, vous pouvez exclure la balise en ligne uniquement.
D&eacute;finir du contenu personnalis&eacute; pour des publics sp&eacute;cifiques
Parfois, les rubriques se rapportent &agrave; des produits, niveaux d'exp&eacute;rience ou types d'utilisateurs
sp&eacute;cifiques. et &agrave; leur appliquer du texte conditionnel afin de r&eacute;duire la quantit&eacute; d'informations fournie &agrave;
chaque groupe. Vous pouvez &eacute;galement supprimer les commentaires expliquant les l&eacute;g&egrave;res diff&eacute;rences
entre les produits.
Fournir diff&eacute;rentes versions d'une application
Pour les versions de d&eacute;monstration, les versions d'essai et les partagiciels de l'application, vous pouvez
omettre certaines rubriques dans chaque version.
Conception et test de texte conditionnel
1)
2)
D&eacute;terminez les types de sortie n&eacute;cessaires, par exemple les manuels imprim&eacute;s ou les didacticiels en
ligne ; tenez compte des exigences actuelles et futures. D&eacute;terminez si des versions diff&eacute;rentes sont
requises pour chaque niveau de comp&eacute;tence.
Indiquez les balises de construction conditionnelles &agrave; appliquer &agrave; chaque type de sortie. Tous les
composants sans balise sont inclus dans la sortie. D&eacute;cidez d'appliquer ou non plusieurs balises &agrave; des
rubriques pour obtenir diff&eacute;rents types de r&eacute;sultats. Par exemple, si vous souhaitez livrer un manuel
&agrave; des testeurs b&ecirc;ta, balisez les rubriques sp&eacute;cifiques au contenu b&ecirc;ta &agrave; l'aide d'une balise de type
B&ecirc;ta. Balisez les autres rubriques avec une balise de type Imprim&eacute;. Ainsi, vous pourrez inclure les
rubriques relatives &agrave; la version b&ecirc;ta et les exclure par la suite.
321
CHAPITRE 10
3)
4)
5)
6)
7)
8)
9)
EL&Eacute;MENTS DE TEXTE CONDITIONNEL DE BASE
TEXTE CONDITIONNEL
Utilisez le rapport sur les propri&eacute;t&eacute;s des rubriques ou les balises de construction conditionnelles
pour passer en revue les balises appliqu&eacute;es &agrave; chaque rubrique.
Choisissez d'appliquer une balise de construction conditionnelle &agrave; la rubrique enti&egrave;re ou &agrave; une ou
plusieurs zones de cette rubrique. Par exemple si vous cr&eacute;ez un manuel imprim&eacute;, excluez le texte
qui mentionne un glossaire en ligne.
D&eacute;cidez des noms et des couleurs des balises, en particulier si le projet est volumineux et s'il
n&eacute;cessite plusieurs types de r&eacute;sultats. D&eacute;finissez des noms de balise d&eacute;crivant le r&eacute;sultat tels que
Imprimer ou En ligne. Les couleurs des balises permettent de diff&eacute;rencier les zones de texte
conditionnel au sein d'une rubrique.
Lorsque vous mettez un projet &agrave; jour, choisissez de supprimer ou non les contenus devenus
obsol&egrave;tes en raison de la mise en page source unique et de la sortie conditionnelle. Par exemple,
un projet contient du texte (de type &laquo; destin&eacute; aux utilisateurs exp&eacute;riment&eacute;s &raquo;) ou des images
expliquant quel contenu s'applique &agrave; quels utilisateurs. Vous pouvez supprimer ces &eacute;l&eacute;ments ou
utiliser du texte conditionnel pour les masquer dans le r&eacute;sultat.
D&eacute;terminez les tables des mati&egrave;res ou pages de table des mati&egrave;res &agrave; inclure dans le r&eacute;sultat lorsque
vous appliquez chaque balise.
D&eacute;terminez les index &agrave; inclure dans le r&eacute;sultat. Vous pouvez cr&eacute;er plusieurs index dans un projet et
les inclure dans le r&eacute;sultat ad&eacute;quat.
Testez les balises conditionnelles en g&eacute;n&eacute;rant le r&eacute;sultat et en le passant en revue. Excluez les
associations de balises appliqu&eacute;es aux rubriques, aux tables des mati&egrave;res ou aux index. Vous pouvez
&eacute;galement visualiser les rubriques sans g&eacute;n&eacute;rer le projet afin de tester les zones conditionnelles.
LIENS CONNEXES :
Aper&ccedil;u des zones de texte conditionnel
Flux de production de l'impl&eacute;mentation du texte conditionnel
1)
2)
3)
4)
5)
Cr&eacute;ez une balise de construction conditionnelle.
Appliquez la balise &agrave; une combinaison de rubriques, de contenu de rubriques, de tables des
mati&egrave;res et d'index.
D&eacute;finissez les balises &agrave; exclure et &agrave; inclure dans la sortie.
D&eacute;finissez l'expression de construction conditionnelle pour inclure ou exclure des rubriques
balis&eacute;es.
L'expression utilise les op&eacute;rateurs de logique bool&eacute;enne (OR, AND, NOT) pour former des phrases
excluant le contenu marqu&eacute; d'une balise.
G&eacute;n&eacute;rez la sortie.
322
BALISES DE CONSTRUCTION CONDITIONNELLES
TEXTE CONDITIONNEL
CHAPITRE 10
Gestion des liens vers les rubriques exclues
Si vous excluez du contenu d'une sortie, les rubriques peuvent comporter des liens bris&eacute;s faisant
r&eacute;f&eacute;rence au contenu exclu. RoboHelp g&egrave;re la plupart de ces liens comme indiqu&eacute; dans le tableau suivant.
Type de lien
R&eacute;sultat
S&eacute;quence de navigation
Une rubrique exclue n'appara&icirc;t pas dans la s&eacute;quence de navigation.
Mappages d'image
Si une image avec un mappage est exclue du r&eacute;sultat, le mappage de
l'image est supprim&eacute;.
Index
Un mot-cl&eacute; d'index li&eacute; &agrave; une rubrique exclue ne s'affiche pas dans le
volet Index.
Contr&ocirc;le Lien
Un contr&ocirc;le Lien (tel qu'une rubrique connexe ou un lien de mot-cl&eacute;)
qui r&eacute;f&eacute;rence une rubrique exclue n'affiche pas la rubrique.
Table des mati&egrave;res
Un livre ou une page de table des mati&egrave;res li&eacute;s &agrave; une rubrique exclue ne
s'affiche pas dans le volet de table des mati&egrave;res.
10.2. Balises de construction conditionnelles
Cr&eacute;ation d'une balise de construction conditionnelle
1)
2)
3)
Dans le ruban Projet, cliquez sur Balise .
Dans la bo&icirc;te de dialogue Nouvelle balise de construction conditionnelle, saisissez le nom de la
balise.
Attribuez une couleur &agrave; la balise en cliquant sur le bouton Couleur de la balise de construction .
Dans le nuancier qui s'affiche, cliquez sur une couleur pour la s&eacute;lectionner ou cliquez sur Couleur
personnalis&eacute;e pour d&eacute;finir une nouvelle couleur. Si vous n'attribuez pas de couleur &agrave; l'ic&ocirc;ne,
RoboHelp lui en attribue une par d&eacute;faut.
RoboHelp utilise cette couleur lorsque vous appliquez cette balise au contenu. Pour plus de d&eacute;tails,
reportez-vous &agrave; la section Application de balises de construction conditionnelles au contenu.
REMARQUE : Deux balises par d&eacute;faut sont fournies dans tous les nouveaux projets : En ligne et Imprimer.
Vous pouvez modifier leur couleur, les renommer ou les appliquer &agrave; des rubriques ou au contenu de
rubriques.
Application de balises de construction conditionnelles au contenu
Un contenu auquel une balise de construction conditionnelle est appliqu&eacute;e est mis en &eacute;vidence par des
hachures de la m&ecirc;me couleur que celle sp&eacute;cifi&eacute;e pour la balise. Si un projet est g&eacute;n&eacute;r&eacute; &agrave; l'aide d'une
expression de balise de construction conditionnelle, la rubrique n'affiche pas le contenu auquel la balise
s'applique. La couleur des hachures permet de diff&eacute;rencier les zones balis&eacute;es. Pour les dossiers, aucune
hachure n'appara&icirc;t. Vous pouvez n&eacute;anmoins hachurer les rubriques d'un dossier.
323
CHAPITRE 10
BALISES DE CONSTRUCTION CONDITIONNELLES
TEXTE CONDITIONNEL
Remarques
•
•
•
Supprimez les r&eacute;f&eacute;rences de texte aux rubriques exclues, comme des liens. Les zones cliquables
faisant r&eacute;f&eacute;rence &agrave; des rubriques exclues ne sont pas actives.
Vous pouvez appliquer une balise de construction conditionnelle aux rubriques du conteneur
Gestionnaire de projets.
Pour afficher ou masquer le texte conditionnel, acc&eacute;dez au ruban Edition et &agrave; la liste d&eacute;roulante
Afficher/Masquer et s&eacute;lectionnez Zones conditionnelles.
V&eacute;rification des balises appliqu&eacute;es aux rubriques
La zone Utilis&eacute; de la bo&icirc;te de dialogue Propri&eacute;t&eacute;s des balises de construction conditionnelles r&eacute;pertorie
les rubriques utilisant une balise. La colonne Niveau indique comment une balise est appliqu&eacute;e :
&lt;Rubrique&gt;
Appliqu&eacute;e &agrave; une rubrique.
&lt;Contenu&gt;
Appliqu&eacute;e au contenu d'une rubrique.
&lt;Les deux&gt;
Appliqu&eacute;e &agrave; la rubrique et &agrave; son contenu.
La colonne Fichier indique le fichier contenant les informations balis&eacute;es.
1) Cliquez avec le bouton droit de la souris sur une balise de construction conditionnelle dans le
conteneur Balise de construction conditionnelle, puis cliquez sur Propri&eacute;t&eacute;s.
Application de balises de construction conditionnelles &agrave; une rubrique
1)
2)
3)
Dans la liste d&eacute;roulante des conteneurs (rubans Projet, Edition ou R&eacute;vision), s&eacute;lectionnez Liste des
rubriques.
S&eacute;lectionnez la rubrique.
Dans le ruban Edition, cliquez sur la liste d&eacute;roulante Appliquer et s&eacute;lectionnez une balise.
Application de balises de construction conditionnelles &agrave; plusieurs rubriques
1)
2)
3)
4)
Dans la liste d&eacute;roulante des conteneurs (rubans Projet, Edition ou R&eacute;vision), s&eacute;lectionnez Liste des
rubriques.
S&eacute;lectionnez plusieurs rubriques.
Dans la barre d'outils Projet, cliquez sur l'ic&ocirc;ne Propri&eacute;t&eacute;s , puis sur Avanc&eacute;.
Dans le conteneur Balises de construction conditionnelles, sous Balises de rubrique, s&eacute;lectionnez
une balise. Cliquez sur OK.
324
CHAPITRE 10
BALISES DE CONSTRUCTION CONDITIONNELLES
TEXTE CONDITIONNEL
Application de balises de construction conditionnelles au contenu d'une rubrique
1)
2)
3)
Ouvrez une rubrique dans l'&eacute;diteur de conception.
S&eacute;lectionnez le contenu de la rubrique.
Dans le ruban Edition, cliquez sur la liste d&eacute;roulante Appliquer et s&eacute;lectionnez une balise.
Lorsque vous appliquez une balise de construction conditionnelle au contenu d'une rubrique, le contenu
est surlign&eacute; avec la couleur de la balise que vous avez d&eacute;finie lorsque vous Cr&eacute;ation d'une balise de
construction conditionnelle.
Application de plusieurs balises de construction conditionnelles au contenu d'une rubrique
1)
2)
3)
4)
Ouvrez une rubrique dans l'&eacute;diteur de conception.
S&eacute;lectionnez le contenu de la rubrique.
Dans le ruban Edition, cliquez sur la liste d&eacute;roulante Appliquer et s&eacute;lectionnez Nouvelle/Plusieurs.
S&eacute;lectionnez les balises ou cliquez sur V&eacute;rifier tout. Cliquez sur OK.
Lorsque vous appliquez plusieurs balises de construction conditionnelles au contenu d'une rubrique, le
contenu surlign&eacute; avec les couleurs de la balise est d&eacute;fini lorsque vous Cr&eacute;ation d'une balise de
construction conditionnelle.
Si vous appliquez plusieurs balises au m&ecirc;me contenu, la couleur de surlignage finale est alors une
combinaison de chaque couleur de balise appliqu&eacute;e.
Application de balises de construction conditionnelles &agrave; un dossier, un index ou une table des mati&egrave;res
1)
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Pour appliquer des balises &agrave; un dossier, s&eacute;lectionnez un dossier dans le conteneur
Gestionnaire de projets.
–
Pour appliquer des balises &agrave; un index, cliquez sur le dossier Index dans le conteneur
Gestionnaire de projets. S&eacute;lectionnez un mot-cl&eacute; ou un mot-cl&eacute; secondaire.
–
Pour appliquer des balises &agrave; une table des mati&egrave;res, cliquez sur le dossier Table des mati&egrave;res
dans le conteneur Gestionnaire de projets. S&eacute;lectionnez un livre ou une page. Si vous
appliquez des balises &agrave; toute la table des mati&egrave;res, celle-ci n'est pas disponible dans la sortie.
Si vous les appliquez uniquement aux pages de la table des mati&egrave;res, celle-ci est disponible.
Les pages balis&eacute;es ne le sont pas.
2)
3)
Dans le ruban Edition, cliquez sur la liste d&eacute;roulante Appliquer et s&eacute;lectionnez Nouvelle/Plusieurs.
S&eacute;lectionnez les balises ou cliquez sur V&eacute;rifier tout. Cliquez sur OK.
325
CHAPITRE 10
BALISES DE CONSTRUCTION CONDITIONNELLES
TEXTE CONDITIONNEL
Application de balises de construction conditionnelles aux espaces r&eacute;serv&eacute;s
1)
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez un espace r&eacute;serv&eacute; plac&eacute; dans la page principale, puis choisissez Modifier &gt;
Balises &gt; Appliquer.
–
Cliquez avec le bouton droit de la souris sur un espace r&eacute;serv&eacute; plac&eacute; dans la page principale,
puis choisissez la commande Appliquer une balise de construction conditionnelle &gt; [nouvelle
balise].
REMARQUE : Vous pouvez &eacute;galement appliquer des balises de construction conditionnelles sur les
occurrences d'extrait de code, mais pas sur les extraits de code.
Aper&ccedil;u des zones de texte conditionnel
Pour v&eacute;rifier le format d'une rubrique avec une zone de texte conditionnel, affichez son aper&ccedil;u &agrave; l'aide
d'une expression de balise de construction conditionnelle que vous avez d&eacute;j&agrave; d&eacute;finie. Vous pouvez
&eacute;galement d&eacute;finir une expression de ce type tout en affichant l'aper&ccedil;u de la rubrique.
1) Ouvrez une rubrique dans l'&eacute;diteur de conception.
2) S&eacute;lectionnez Modifier &gt; Afficher &gt; Afficher l'&eacute;l&eacute;ment.
3) Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Pour afficher l'aper&ccedil;u d'une expression existante, s&eacute;lectionnez-la dans le menu Expression de
balise de construction conditionnelle.
–
Pour d&eacute;finir et afficher l'aper&ccedil;u d'une nouvelle expression, cliquez sur l'option D&eacute;finir, puis
s&eacute;lectionnez les balises &agrave; exclure de la sortie. Cliquez sur OK.
ASTUCE : Pour supprimer l'expression de balise de construction conditionnelle depuis l'aper&ccedil;u,
s&eacute;lectionnez Aucun dans le menu Expression de balise de construction conditionnelle.
Affichage et masquage du texte conditionnel
Les &eacute;l&eacute;ments auxquels sont appliqu&eacute;es des balises de construction conditionnelles s'affichent dans
l'&eacute;diteur de conception avec le texte surlign&eacute; de la m&ecirc;me couleur que celle sp&eacute;cifi&eacute;e pour la balise.
Le texte conditionnel est toujours visible dans l'&eacute;diteur de conception, mais vous pouvez masquer le texte
surlign&eacute;.
1) Dans la section Afficher de l'onglet Modifier, cliquez sur la liste d&eacute;roulante Afficher/Masquer.
L'&eacute;l&eacute;ment de liste Zones conditionnelles est une option de permutation.
2) Pour masquer le texte conditionnel, d&eacute;s&eacute;lectionnez l'option.
REMARQUE : L'ic&ocirc;ne vers la gauche est d&eacute;s&eacute;lectionn&eacute;e.
Pour afficher le texte conditionnel, s&eacute;lectionnez l'option.
REMARQUE : L'ic&ocirc;ne vers la gauche est s&eacute;lectionn&eacute;e.
326
CHAPITRE 10
EXPRESSIONS DE BALISES DE CONSTRUCTION CONDITIONNELLES
TEXTE CONDITIONNEL
Suppression de balises de construction conditionnelles
1)
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Pour supprimer des balises de construction conditionnelles d'une rubrique, s&eacute;lectionnez une
ou plusieurs rubriques dans le dossier Fichiers HTML du conteneur Gestionnaire de projets.
–
Pour supprimer des balises de construction conditionnelles du contenu d'une rubrique,
ouvrez une rubrique dans l'&eacute;diteur de conception. S&eacute;lectionnez le contenu de la rubrique.
–
Pour supprimer des balises de construction conditionnelles d'une table des mati&egrave;res, cliquez
dans le conteneur Table des mati&egrave;res. S&eacute;lectionnez un(e) ou plusieurs livres ou pages.
–
Pour supprimer des balises de construction conditionnelles d'un index, cliquez dans le
conteneur Index. S&eacute;lectionnez un mot-cl&eacute; ou un mot-cl&eacute; secondaire.
2)
3)
4)
Cliquez sur Modifier &gt; Balises &gt; Appliquer &gt; Nouveau/Plusieurs.
D&eacute;s&eacute;lectionnez les balises ou cliquez sur Effacer tout. Cliquez ensuite sur OK.
Pour supprimer des balises de construction conditionnelles d'un projet, cliquez sur Projet.
D&eacute;veloppez le dossier Balises de construction conditionnelles, cliquez sur une balise, puis
s&eacute;lectionnez Supprimer. Cliquez ensuite sur OK.
ASTUCE : Avant de supprimer une balise de construction conditionnelle d'un projet, ex&eacute;cutez un
rapport sur le projet pour d&eacute;terminer les rubriques qui seront affect&eacute;es.
Modification du nom des balises de construction conditionnelles
1)
2)
3)
Cliquez avec le bouton droit de la souris sur une balise dans le conteneur Balises de construction
conditionnelles.
S&eacute;lectionnez Renommer, puis saisissez un nouveau nom dans la zone.
Appuyez sur Entr&eacute;e. Les rubriques qui utilisent cette balise sont mises &agrave; jour avec le nouveau nom.
ASTUCE : V&eacute;rifiez que l'expression de construction conditionnelle est bien mise &agrave; jour avec le nouveau nom
de balise de construction avant de r&eacute;g&eacute;n&eacute;rer le projet.
10.3. Expressions de balises de construction conditionnelles
D&eacute;finition d'expressions de balises de construction conditionnelles
Une expression d&eacute;signe un ensemble d'instructions. Des expressions sp&eacute;cifient les rubriques &agrave; inclure ou
&agrave; exclure de la sortie. Vous pouvez d&eacute;finir une expression &eacute;l&eacute;mentaire qui exclut des balises, ou une
expression plus complexe avec des op&eacute;rateurs bool&eacute;ens de type AND, OR et NOT.
Les utilisateurs finals ne peuvent pas acc&eacute;der aux rubriques ou aux tables des mati&egrave;res exclues du
r&eacute;sultat. Les mots-cl&eacute;s d'index et les entr&eacute;es de table des mati&egrave;res n'apparaissent pas. RoboHelp
supprime les liens vers la rubrique, ainsi que la rubrique des contr&ocirc;les de liens. l'application supprime les
liens vers les favoris &agrave; l'int&eacute;rieur des zones marqu&eacute;es comme exclues. Les balises appliqu&eacute;es au contenu
d'une rubrique n'ont pas d'incidence sur la table des mati&egrave;res, l'index ou les contr&ocirc;les Lien.
327
CHAPITRE 10
EXPRESSIONS DE BALISES DE CONSTRUCTION CONDITIONNELLES
TEXTE CONDITIONNEL
Assurez-vous que vous disposez d'une mise en page source unique dans laquelle stocker l'expression.
Si n&eacute;cessaire, cr&eacute;ez une mise en page ou modifiez une mise en page par d&eacute;faut.
ASTUCE : Vous pouvez contourner les balises de construction et g&eacute;n&eacute;rer un r&eacute;sultat comprenant toutes les
rubriques du projet, que les balises de construction aient &eacute;t&eacute; appliqu&eacute;es ou non. S&eacute;lectionnez Aucun dans
la liste Expression de construction conditionnelle de l'assistant Options lors de la g&eacute;n&eacute;ration du projet.
Cr&eacute;ez une balise de construction conditionnelle et appliquez-la aux rubriques ou au contenu des
rubriques.
1) Dans le ruban Projet, cliquez sur la liste d&eacute;roulante Balise et s&eacute;lectionnez Expression nomm&eacute;e.
La bo&icirc;te de dialogue D&eacute;finir une expression de balise de construction conditionnelle s'affiche :
D&eacute;finissez les expressions de construction conditionnelle.
A
S&eacute;lectionnez une expression parmi la liste des expressions disponibles.
B
Renommez l'expression s&eacute;lectionn&eacute;e.
C
Cr&eacute;ez une nouvelle expression.
328
CHAPITRE 10
EXPRESSIONS DE BALISES DE CONSTRUCTION CONDITIONNELLES
TEXTE CONDITIONNEL
D
Supprimez l'expression s&eacute;lectionn&eacute;e.
E
Dans la liste des balises de construction conditionnelles actuelles, s&eacute;lectionnez les balises &agrave; inclure
et exclure de l'expression.
F
Utilisez les op&eacute;rateurs bool&eacute;ens AND, OR et NOT pour cr&eacute;er des expressions. Consultez Expressions
de balises de construction conditionnelles avanc&eacute;es.
G
Liste des balises de construction conditionnelles disponibles
H
Liste des balises &agrave; exclure
I
Op&eacute;rateurs bool&eacute;ens utilis&eacute;s pour cr&eacute;er une expression &agrave; l'aide de l'option avanc&eacute;e
J
Effacez l'expression g&eacute;n&eacute;r&eacute;e &agrave; l'aide de l'option avanc&eacute;e.
2)
3)
4)
5)
Lorsque vous ouvrez la bo&icirc;te de dialogue pour la premi&egrave;re fois, aucune expression de construction
n'est s&eacute;lectionn&eacute;e.
Pour cr&eacute;er une nouvelle expression, g&eacute;n&eacute;rez l'expression &agrave; l'aide des options de base ou avanc&eacute;es
et cliquez sur Enregistrer.
Pour modifier une expression disponible, s&eacute;lectionnez l'expression dans la liste d&eacute;roulante
Expression et cliquez sur Mettre &agrave; jour.
Cliquez sur Enregistrer.
Si vous cr&eacute;ez une nouvelle expression, vous &ecirc;tes invit&eacute; &agrave; saisir un nom.
329
EXPRESSIONS DE BALISES DE CONSTRUCTION CONDITIONNELLES
TEXTE CONDITIONNEL
CHAPITRE 10
Expressions de balises de construction conditionnelles avanc&eacute;es
Les directives pr&eacute;sent&eacute;es dans cette section permettent de d&eacute;finir des expressions de balises de
construction conditionnelles &agrave; l'aide d'op&eacute;rateurs bool&eacute;ens, en vue d'une sortie sp&eacute;cifique. Vous pouvez
&eacute;galement cr&eacute;er automatiquement des expressions &eacute;l&eacute;mentaires.
R&eacute;sultat souhait&eacute;
Action
Toutes les rubriques auxquelles une balise est
appliqu&eacute;e
Utiliser le nom de la balise. Par exemple : Tag1
Toutes les rubriques auxquelles plusieurs balises
sont appliqu&eacute;es
Placer l'op&eacute;rateur AND entre les noms des
balises. Par exemple : Tag2 AND Tag3
Toutes les rubriques auxquelles des combinaisons
de balises sont appliqu&eacute;es
Placer l'op&eacute;rateur OR entre les noms des balises.
Par exemple : Tag3 OR Tag4
Toutes les rubriques, except&eacute; celles auxquelles
une balise est appliqu&eacute;e
Placer l'op&eacute;rateur NOT avant le nom de la balise.
Par exemple : NOT Tag2
Toutes les rubriques, except&eacute; celles auxquelles
plusieurs balises sont appliqu&eacute;es
Placer les op&eacute;rateurs NOT et AND entre les noms
des balises. Par exemple : NOT Tag1 AND NOT
Tag2 AND NOT Tag4
REMARQUE : Les rubriques et le texte des rubriques auxquels vous n'avez appliqu&eacute; aucune balise de
construction conditionnelle sont compris dans la sortie.
330
CHAPITRE 11
&Agrave; PROPOS DE L'AIDE CONTEXTUELLE
AIDE CONTEXTUELLE
11. Aide contextuelle
11.1. &Agrave; propos de l'aide contextuelle
Une rubrique d'aide contextuelle fournit des informations sur l'interface utilisateur d'une application en
rapport avec la t&acirc;che effectu&eacute;e par un utilisateur. Par exemple, les rubriques d'aide contextuelle
fournissent des d&eacute;tails sur les champs et les contr&ocirc;les des bo&icirc;tes de dialogue, des descriptions des
fen&ecirc;tres ou objets d'&eacute;cran et des explications sur les messages. Pour acc&eacute;der &agrave; une rubrique d'aide
contextuelle, l'utilisateur peut appuyer sur la touche F1, cliquer sur un bouton d'aide, la s&eacute;lectionner
dans un menu ou cliquer sur une ic&ocirc;ne repr&eacute;sentant un point d'interrogation.
Le processus de cr&eacute;ation et de mise en œuvre d'une aide contextuelle implique g&eacute;n&eacute;ralement l'auteur du
contenu et le d&eacute;veloppeur de l'application. Pour sp&eacute;cifier des rubriques contextuelles, l'auteur cr&eacute;e des
ID de mappage et des fichiers de mappage. Lorsqu'un utilisateur acc&egrave;de &agrave; l'aide contextuelle, un num&eacute;ro
de mappage et un nom de fichier d'aide sont envoy&eacute;s vers le moteur d'aide. Ce moteur fait correspondre
le num&eacute;ro de mappage &agrave; un ID de rubrique et &agrave; un nom de fichier HTM afin que la rubrique appropri&eacute;e
s'affiche.
La derni&egrave;re &eacute;tape du processus consiste &agrave; tester l'aide contextuelle. RoboHelp HTML offre plusieurs outils
que vous pouvez utiliser pour tester l'aide contextuelle dans l'application.
Rubrique applicable &agrave; la fen&ecirc;tre
D&eacute;crit les fen&ecirc;tres, les bo&icirc;tes de dialogue et les messages d'une application. Chaque rubrique de ce
type est au format HTM et est stock&eacute;e dans un fichier pourvu de l'extension .htm. Ce fichier peut
contenir divers formats de texte, des liens, des images ainsi que d'autres fonctionnalit&eacute;s. Ces
rubriques sont plus d&eacute;taill&eacute;es que les rubriques d'aide sur les champs. En effet, elles d&eacute;crivent les
composants de l'interface utilisateur. Pour acc&eacute;der &agrave; ces rubriques, les utilisateurs peuvent appuyer
sur la touche F1, cliquer sur les boutons d'aide ou s&eacute;lectionner les commandes d'aide dans les
menus.
Si l'aide de l'application ne contient pas de fen&ecirc;tre personnalis&eacute;e, les rubriques contextuelles
s'affichent dans l'afficheur HTML Help.
Rubrique d'aide sur les champs (Qu'est-ce que c'est ?)
(Projets WinHelp et Microsoft HTML Help) D&eacute;crit bri&egrave;vement un champ. Pour acc&eacute;der &agrave; cette
rubrique, les utilisateurs doivent cliquer sur une ic&ocirc;ne repr&eacute;sentant un point d'interrogation, puis
sur un champ d'une bo&icirc;te de dialogue. Dans RoboHelp, les rubriques de ce type sont appel&eacute;es des
rubriques Qu'est-ce que c'est ?.
REMARQUE : WebHelp, WebHelp Pro, FlashHelp, FlashHelp Pro et AIR Help ne prennent pas en charge
Qu'est-ce que c'est ? La prise en charge des fen&ecirc;tres WebHelp est uniquement disponible avec l'API
de l'aide contextuelle.
331
R&Ocirc;LES DES AUTEURS ET DES D&Eacute;VELOPPEURS LORS DE LA CR&Eacute;ATION DE L'AIDE CONTEXTUELLE
AIDE CONTEXTUELLE
CHAPITRE 11
Syst&egrave;me d'aide mixte
Aide hors ligne non prise en charge par une connexion Internet. Pour utiliser RH_ShowHelp,
associez le syst&egrave;me d'aide hors ligne &agrave; la fonction RH_AssociateOfflineHelp. Cette &eacute;tape
indique &agrave; la fonction comment s'ex&eacute;cuter si aucune connexion Internet n'est disponible. Les appels
individuels vers RH_ShowHelp doivent sp&eacute;cifier le syst&egrave;me d'aide hors ligne. Les deux
RH_ShowHelp et RH_AssociateOfflineHelp sont contenus dans les fichiers de support.
Utilisez le syst&egrave;me d'aide mixte comme syst&egrave;me d'aide de sauvegarde en cas d'&eacute;chec de connexion
Internet.
REMARQUE : RH_ShowHelp est une fonction de programmation utilis&eacute;e par les d&eacute;veloppeurs pour
afficher une rubrique d'aide &agrave; l'aide des r&egrave;gles disponibles dans l'interface API CSH de RoboHelp.
11.2. R&ocirc;les des auteurs et des d&eacute;veloppeurs lors de la cr&eacute;ation de
l'aide contextuelle
Auteur
D&eacute;veloppeur
Ecrit les rubriques d'aide qui d&eacute;crivent
l'utilisation des composants de l'application,
comme les fen&ecirc;tres, les bo&icirc;tes de dialogue, les
champs et les contr&ocirc;les.
Con&ccedil;oit les composants (fen&ecirc;tres, bo&icirc;tes de
dialogue, champs, commandes) de l'application.
Importe les fichiers de mappage et attribue les ID
de mappage aux diff&eacute;rentes rubriques d'aide
contextuelle. Signale au d&eacute;veloppeur toute
attribution probl&eacute;matique ou toute modification
d'attribution.
ou
Cr&eacute;e les fichiers de mappage et assigne les ID de
mappage aux diff&eacute;rentes rubriques d'aide
contextuelle. Exporte les fichiers de mappage
finalis&eacute;s vers l'environnement de d&eacute;veloppement
et signale au d&eacute;veloppeur toute modification.
G&eacute;n&egrave;re les fichiers de mappage contenant les ID
de mappage et les transf&egrave;re &agrave; l'auteur.
ou
Re&ccedil;oit les fichiers de mappage cr&eacute;&eacute;s par l'auteur
et contenant les ID de mappage.
G&eacute;n&egrave;re le projet devant contenir les rubriques
d'aide contextuelle dans la sortie.
R&eacute;dige le code permettant d'appeler les
rubriques d'aide appropri&eacute;es depuis l'application
(en fonction des ID inclus dans les fichiers de
mappage).
Teste les rubriques d'aide contextuelle dans
l'application. Corrige les erreurs dans le syst&egrave;me
d'aide.
Signale &agrave; l'auteur toute modification de
l'application (ou des fichiers de mappage) pour
que le projet d'aide soit mis &agrave; jour et r&eacute;g&eacute;n&eacute;r&eacute;.
Corrige les erreurs dans le code de l'application.
332
FICHIERS DE MAPPAGE ET ID DE MAPPAGE
AIDE CONTEXTUELLE
CHAPITRE 11
&Agrave; la page d'accueil de cr&eacute;ation du site Web de Peter Grainge, vous trouverez des informations sur les
quatre m&eacute;thodes d'appel de WebHelp :
•
Utilisation des URL
•
Utilisation des ID de mappage
•
Utilisation des ID de mappage dans l'aide WebHelp fusionn&eacute;e
•
Utilisation des ID de rubrique
11.3. Fichiers de mappage et ID de mappage
LIENS CONNEXES :
R&ocirc;les des auteurs et des d&eacute;veloppeurs lors de la cr&eacute;ation de l'aide contextuelle
Informations &agrave; l'attention des d&eacute;veloppeurs
A propos des num&eacute;ros, fichiers et ID de mappage
Num&eacute;ro de mappage
Valeur num&eacute;rique associ&eacute;e &agrave; un ID de rubrique. Les num&eacute;ros de mappage et les ID de rubrique sont
enregistr&eacute;s dans les fichiers de mappage. l'utilisation des num&eacute;ros de mappage dans les
applications permet de sp&eacute;cifier la rubrique &agrave; afficher lors d'un appel d'aide contextuelle. Les
d&eacute;veloppeurs d'applications peuvent choisir d'utiliser des num&eacute;ros de mappage, des ID de
rubriques ou les deux en fonction du langage de programmation qu'ils utilisent.
Fichier de mappage
Fichier texte contenant des ID de rubrique et des num&eacute;ros de mappage. Associez les ID de mappage
et les fichiers de mappage &agrave; des rubriques. En tant qu'auteur, si vous recevez un fichier de mappage
du d&eacute;veloppeur, attribuez un ID de mappage &agrave; partir de ce fichier. Si vous cr&eacute;ez manuellement un
fichier de mappage, g&eacute;n&eacute;rez automatiquement ou cr&eacute;ez manuellement l'ID de mappage. Un projet
peut contenir plusieurs fichiers de mappage. Les fichiers de mappage utilisent les extensions .h, .hh
et .hm. BSSCDefault.h est le fichier de mappage par d&eacute;faut.
ID de mappage
Cha&icirc;ne qui associe un ID de rubrique &agrave; un num&eacute;ro de mappage. Exemple :
#define ID_SetupScreen 101
•
•
•
ID_SetupScreen correspond &agrave; l'ID de rubrique.
101 correspond au num&eacute;ro de mappage.
ID_SetupScreen 101 correspond &agrave; l'ID de mappage.
Une ic&ocirc;ne indique l'&eacute;tat d'un ID de mappage :
•
Les ic&ocirc;nes bleues
indiquent les ID de mappage associ&eacute;s &agrave; des rubriques.
333
CHAPITRE 11
•
•
FICHIERS DE MAPPAGE ET ID DE MAPPAGE
AIDE CONTEXTUELLE
Les ic&ocirc;nes jaunes indiquent les ID de mappage non associ&eacute;s &agrave; des rubriques.
Les ic&ocirc;nes verrouill&eacute;es (bleues ou jaunes) indiquent que l'ID de mappage se trouve dans un fichier
de mappage verrouill&eacute;. Cet ID ne peut pas &ecirc;tre attribu&eacute; et son affectation ne peut pas &ecirc;tre annul&eacute;e.
Cr&eacute;ez des ID de mappage, g&eacute;n&eacute;rez automatiquement des ID de mappage ou importez les fichiers de
mappage afin d'utiliser les ID de mappage. Un ID de mappage unique doit &ecirc;tre attribu&eacute; &agrave; chaque ID
de rubrique. Attribuez un ID de mappage &agrave; une rubrique d'aide pour afficher la rubrique de l'aide
contextuelle.
Table de mappage
M&eacute;canisme qui mappe des champs et des contr&ocirc;les des bo&icirc;tes de dialogue avec des num&eacute;ros de
mappage. La table de mappage est programm&eacute;e dans l'application pour fournir une aide
contextuelle.
Gestion des fichiers de mappage
Cr&eacute;ation d'un fichier de mappage
Les fichiers de mappage sont des fichiers texte contenant une liste d'ID de mappage. Les noms de fichiers
de mappage sont associ&eacute;s &agrave; l'extension .h. Lors de la cr&eacute;ation de noms de fichier, remplacez les espaces
par des tirets de soulignement. Les caract&egrave;res suivants ne sont pas valides : &lt; &gt; | # &quot;, $, &amp;, [ ]
Le fichier de mappage peut &ecirc;tre cr&eacute;&eacute; par les auteurs ou les d&eacute;veloppeurs. Si le d&eacute;veloppeur cr&eacute;e le fichier
de mappage, l'auteur l'importe.
REMARQUE : RoboHelp prend &eacute;galement en charge le mappage contextuel dynamique des bo&icirc;tes de
dialogue et des rubriques. Gr&acirc;ce &agrave; cette approche, les r&eacute;dacteurs techniques n'ont plus &agrave; assurer le suivi
manuel des ID de mappage. Voir Modification dynamique de rubriques d'aide contextuelle.
ASTUCE : Le verrouillage d'un fichier de mappage permet de limiter son acc&egrave;s en lecture seule.
1) Ouvrez le conteneur de configuration de sortie.
2) D&eacute;veloppez le dossier Aide contextuelle.
3) Cliquez avec le bouton droit de la souris sur le dossier Fichiers de mappage.
4) S&eacute;lectionnez Nouveau fichier de mappage.
5) Saisissez un nom.
6) Cliquez sur OK. Le fichier est ajout&eacute; au dossier Fichiers de mappage.
REMARQUE : Les fichiers obsol&egrave;tes peuvent contenir des num&eacute;ros de mappage utilis&eacute;s pour les
fichiers mis &agrave; jour.
Importation d'un fichier de mappage
1)
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Cliquez sur Projet &gt; Importer &gt; Fichier de mappage.
–
Cliquez sur le dossier de l'aide contextuelle dans le conteneur Configuration de sortie.
2)
3)
Acc&eacute;dez au fichier de mappage. Assurez-vous qu'il est d&eacute;verrouill&eacute;.
Cliquez deux fois sur le fichier de mappage pour l'ajouter au dossier Fichiers de mappage du projet.
334
CHAPITRE 11
FICHIERS DE MAPPAGE ET ID DE MAPPAGE
AIDE CONTEXTUELLE
Exportation d'un fichier de mappage
1)
2)
3)
4)
5)
Cliquez sur le dossier de l'aide contextuelle dans le conteneur Configuration de sortie.
Cliquez avec le bouton droit de la souris sur le dossier Fichiers de mappage.
S&eacute;lectionnez Exporter les fichiers de mappage.
S&eacute;lectionnez les langages de programmation dans lesquels enregistrer les fichiers de mappage.
Choisissez l'emplacement du fichier de mappage. Cliquez sur OK.
ASTUCE : Lorsque vous exportez un fichier de mappage, le fichier original reste dans le projet.
Verrouillage ou d&eacute;verrouillage d'un fichier de mappage
Les fichiers de mappage verrouill&eacute;s deviennent des fichiers en lecture seule. l'ajout, la suppression et la
modification des ID de mappage contenus dans des fichiers de mappage verrouill&eacute;s est impossible. Il est
&eacute;galement d&eacute;conseill&eacute; de modifier le fichier si l'option Supprimer les ID de mappage inutilis&eacute;s est activ&eacute;e.
Le cas &eacute;ch&eacute;ant, vous risquez de perdre les modifications apport&eacute;es aux fichiers. Les fichiers de mappage
import&eacute;s sont verrouill&eacute;s par d&eacute;faut.
1) S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Configuration de sortie.
2) D&eacute;veloppez le dossier Fichiers de mappage (ou l'un des dossiers personnalis&eacute;s contenus dans le
dossier Fichiers de mappage).
3) Cliquez avec le bouton droit de la souris sur le fichier de mappage.
4) S&eacute;lectionnez Propri&eacute;t&eacute;s.
5) S&eacute;lectionnez l'option Verrouill&eacute;. Pour d&eacute;verrouiller le fichier, d&eacute;s&eacute;lectionnez l'option Verrouill&eacute;.
6) Cliquez sur Fermer.
Suppression d'un fichier de mappage obsol&egrave;te
Les fichiers de mappage obsol&egrave;tes contiennent parfois des num&eacute;ros de mappage utilis&eacute;s pour les fichiers
mis &agrave; jour. Ces num&eacute;ros de mappage peuvent appeler de mani&egrave;re dynamique une rubrique incorrecte.
Supprimez les fichiers de mappage non utilis&eacute;s pour &eacute;viter ce probl&egrave;me.
1) Ouvrez le conteneur de configuration de sortie.
2) D&eacute;veloppez le dossier Aide contextuelle.
3) D&eacute;veloppez le dossier Fichiers de mappage.
4) S&eacute;lectionnez le fichier de mappage.
5) Cliquez sur Supprimer.
Suppression d'un ID de mappage inutilis&eacute;
Cette option n&eacute;cessite le d&eacute;verrouillage les fichiers de mappage. Pour supprimer les ID de mappage
inutilis&eacute;s :
•
Cliquez sur le dossier de l'aide contextuelle dans le conteneur Configuration de sortie.
•
Cliquez avec le bouton droit de la souris sur le dossier Fichiers de mappage.
•
S&eacute;lectionnez Modifier.
•
Effectuez les op&eacute;rations suivantes :
335
CHAPITRE 11
FICHIERS DE MAPPAGE ET ID DE MAPPAGE
AIDE CONTEXTUELLE
Fichiers de mappage
S&eacute;lectionnez les fichiers de mappage dont vous souhaitez supprimer des ID de mappage inutilis&eacute;s.
S&eacute;lectionner tout
Permet de supprimer les ID de mappage inutilis&eacute;s de tous les fichiers de mappage.
Effacer tout
Permet de d&eacute;s&eacute;lectionner tous les fichiers de mappage et de conserver les ID de mappage inutilis&eacute;s.
Gestion des ID de mappage
Cr&eacute;ation d'un ID de mappage
1)
2)
3)
4)
5)
6)
7)
8)
Ouvrez le conteneur de configuration de sortie.
D&eacute;veloppez le dossier Aide contextuelle.
D&eacute;veloppez le dossier Fichiers de mappage.
Cliquez deux fois sur Tous les ID de mappage.
Dans Fichier de mappage, cliquez sur la fl&egrave;che vers le bas, puis s&eacute;lectionnez le fichier de mappage
dans lequel vous souhaitez stocker l'ID de mappage.
Cliquez sur le bouton Cr&eacute;er/Modifier un ID de mappage .
Dans ID de rubrique, saisissez le terme ou l'expression permettant d'identifier la rubrique.
Dans Num&eacute;ro de mappage, saisissez un num&eacute;ro.
REMARQUE : Vous pouvez cr&eacute;er des ID de mappage ind&eacute;pendants pour chaque rubrique ou les
g&eacute;n&eacute;rer automatiquement &agrave; l'aide du bouton Mapper automatiquement. Voir G&eacute;n&eacute;ration
automatique d'un ID de mappage.
Modification d'un ID de mappage
Cette bo&icirc;te de dialogue permet d'attribuer des ID de mappage aux rubriques, d'annuler l'affectation des
ID de mappage, de cr&eacute;er des ID et des fichiers de mappage et de mapper automatiquement les ID. Vous
pouvez trier les rubriques par colonne.
1) Ouvrez le conteneur de configuration de sortie.
2) D&eacute;veloppez le dossier Aide contextuelle.
3) Cliquez avec le bouton droit de la souris sur le dossier Fichiers de mappage.
4) Cliquez sur Modifier les ID de mappage.
5) S&eacute;lectionnez l'une des options suivantes :
Fichier de mappage
R&eacute;pertorie les fichiers de mappage disponibles (y compris les fichiers de mappage import&eacute;s).
&lt;Tous les fichiers de mappage&gt;
Affiche tous les ID de mappage.
336
CHAPITRE 11
FICHIERS DE MAPPAGE ET ID DE MAPPAGE
AIDE CONTEXTUELLE
&lt;Fichier de mappage du projet&gt;
Permet d'afficher les ID de mappage dans le fichier de mappage par d&eacute;faut BSSCDdefault.h. Les ID
de mappage des fichiers de mappage d&eacute;s&eacute;lectionn&eacute;s se trouvent dans le fichier BSSCDefault.h.
Ic&ocirc;ne Fichier de mappage
Permet d'ouvrir la bo&icirc;te de dialogue Nouveau fichier de mappage et de cr&eacute;er un fichier de mappage
personnalis&eacute;. Les num&eacute;ros de mappage des fichiers de mappage personnalis&eacute;s sont g&eacute;n&eacute;r&eacute;s
automatiquement.
N&ordm; mappage
Affiche le num&eacute;ro de mappage de l'ID de rubrique. Les num&eacute;ros de mappage sont stock&eacute;s dans les
fichiers de mappage (.h, .hh, .hm).
Rubrique
Affiche la rubrique attribu&eacute;e &agrave; l'ID de mappage.
Masquer les ID utilis&eacute;s
Affiche les ID de mappage non attribu&eacute;s.
Ic&ocirc;ne Nouveau
Cr&eacute;e un ID de mappage. l'ID est ajout&eacute; au fichier de mappage s&eacute;lectionn&eacute; dans Fichier de mappage.
Ic&ocirc;ne Modifier
Permet de modifier l'ID de mappage s&eacute;lectionn&eacute;.
Supprimer
Permet de supprimer l'ID de mappage s&eacute;lectionn&eacute;. Avant de supprimer l'ID, cliquez sur Annuler
l'assignation pour &eacute;viter la cr&eacute;ation d'un lien rompu vers la rubrique.
Options
Permet de personnaliser le mappage automatique de la rubrique.
Assigner
Permet d'attribuer la rubrique s&eacute;lectionn&eacute;e &agrave; l'ID de rubrique s&eacute;lectionn&eacute;. Ce bouton est disponible
lorsqu'une rubrique est s&eacute;lectionn&eacute;e sur la droite et qu'un ID de mappage est s&eacute;lectionn&eacute; sur la
gauche.
Annuler l'assignation
Permet de dissocier l'ID de mappage de la rubrique situ&eacute;e sur la droite.
337
CHAPITRE 11
FICHIERS DE MAPPAGE ET ID DE MAPPAGE
AIDE CONTEXTUELLE
Mapper automatiquement
Permet d'attribuer un ID de mappage dans le fichier de mappage personnalis&eacute; ou par d&eacute;faut
(BSSCDefault.h). S&eacute;lectionnez un fichier de mappage et une rubrique. Cliquez sur Mapper
automatiquement. Ce bouton est accessible uniquement si vous s&eacute;lectionnez &lt;Fichier de mappage
du projet&gt; ou un fichier de mappage personnalis&eacute;. Si vous mappez automatiquement un ID de
mappage sans avoir s&eacute;lectionn&eacute; de fichier de mappage, l'ID de mappage est stock&eacute; dans le fichier
de mappage par d&eacute;faut (BSSCDefault.h).
•
•
Le programme attribue un titre de rubrique ou un nom de fichier en tant qu'ID de rubrique et
attribue un num&eacute;ro d'ID. Le bouton Options permet de personnaliser le mappage automatique.
Vous ne pouvez pas attribuer plusieurs rubriques &agrave; un ID de mappage. En revanche, vous pouvez
attribuer plusieurs ID de mappage &agrave; une rubrique.
Rubrique
R&eacute;pertorie les rubriques du projet. Pour filtrer la liste, cliquez sur le triangle
les dossiers, Dossier du niveau sup&eacute;rieur ou un dossier personnalis&eacute;.
. S&eacute;lectionnez Tous
Ic&ocirc;ne Propri&eacute;t&eacute;s
Permet d'afficher tous les ID de rubrique attribu&eacute;s &agrave; la rubrique.
Ic&ocirc;ne Aper&ccedil;u
Permet d'afficher la rubrique.
REMARQUE : Si vous attribuez un ID de mappage &agrave; un signet, un message d'erreur trompeur s'affiche et
indique que le fichier n'existe pas. Vous pouvez ignorer ce message, car la rubrique existe.
R&eacute;attribution d'un ID de mappage
Mettez &agrave; jour l'ID de mappage si la rubrique d'aide ne s'ouvre pas, si une rubrique incorrecte s'ouvre ou
si le d&eacute;veloppeur a modifi&eacute; l'application qui affecte les ID de mappage.
1) Sous ID de mappage, s&eacute;lectionnez un fichier de mappage dans la bo&icirc;te de dialogue Modifier les ID
de mappage.
2) Cliquez sur Cr&eacute;er/Modifier un ID de mappage.
3) Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
R&eacute;attribuez l'ID de mappage. Sous ID de mappage, s&eacute;lectionnez l'ID de mappage. Cliquez sur
Annuler l'assignation. S&eacute;lectionnez une autre rubrique, puis cliquez sur Assigner.
–
Modifiez l'ID de rubrique ou le num&eacute;ro de mappage. Cliquez deux fois sur l'ID de mappage et
modifiez la valeur souhait&eacute;e.
338
CHAPITRE 11
FICHIERS DE MAPPAGE ET ID DE MAPPAGE
AIDE CONTEXTUELLE
G&eacute;n&eacute;ration automatique d'un ID de mappage
La g&eacute;n&eacute;ration des ID de mappage peut s'effectuer &agrave; l'aide d'un fichier de mappage personnalis&eacute; ou du
fichier de mappage par d&eacute;faut (BSSCDefault.h). Avant de g&eacute;n&eacute;rer les fichiers de mappage, v&eacute;rifiez aupr&egrave;s
du d&eacute;veloppeur les conventions d'attribution de nom.
1) Cliquez sur le dossier de l'aide contextuelle dans le conteneur Configuration de sortie.
2) D&eacute;veloppez le dossier Fichiers de mappage.
3) Cliquez deux fois sur Tous les ID de mappage.
4) Dans Fichier de mappage, cliquez sur le bouton repr&eacute;sentant un triangle.
5) S&eacute;lectionnez un fichier de mappage.
6) D&eacute;finissez les options d'attribution de nom et de num&eacute;ro aux ID de mappage. Par d&eacute;faut,
l'application assigne un titre de rubrique ou un nom de fichier en tant qu'ID de rubrique et assigne
un num&eacute;ro d'ID.
7) Dans le champ Rubrique, s&eacute;lectionnez la rubrique.
8) Cliquez sur Mapper automatiquement pour cr&eacute;er un ID de mappage.
9) Si n&eacute;cessaire, cliquez deux fois sur le fichier de mappage pour le modifier.
10) Transmettez une copie du fichier de mappage au d&eacute;veloppeur.
G&eacute;n&eacute;ration d'un ID de mappage
Les ID sont stock&eacute;s dans le fichier de mappage s&eacute;lectionn&eacute; dans la bo&icirc;te de dialogue Modifier les ID de
mappage.
1) Cliquez sur Options dans la bo&icirc;te de dialogue Modifier les ID de mappage.
Utiliser le pr&eacute;fixe suivant dans les ID de mappage
S&eacute;lectionnez cette option pour saisir une valeur au d&eacute;but de chaque ID de mappage.
Mettre en majuscules
S&eacute;lectionnez cette option pour des ID de mappage g&eacute;n&eacute;r&eacute;s automatiquement en majuscules.
Commencer la num&eacute;rotation par
S&eacute;lectionnez cette option pour saisir un num&eacute;ro de d&eacute;part pour les num&eacute;ros de mappage.
Remarques :
•
•
•
•
La d&eacute;finition de ces options n'affecte pas les ID de mappage existants.
Par d&eacute;faut, l'application assigne un titre de rubrique ou un nom de fichier en tant qu'ID de rubrique,
ainsi qu'un num&eacute;ro d'ID.
Le bouton G&eacute;n&eacute;rer automatiquement les ID de mappage est accessible uniquement si vous
s&eacute;lectionnez &lt;Fichier de mappage du projet&gt; ou un fichier de mappage personnalis&eacute;. Si vous
mappez automatiquement un ID de mappage sans avoir s&eacute;lectionn&eacute; de fichier de mappage, l'ID de
mappage est stock&eacute; dans le fichier de mappage par d&eacute;faut (BSSCDefault.h).
Vous ne pouvez pas assigner plusieurs rubriques &agrave; un ID de mappage. En revanche, vous pouvez
assigner plusieurs ID de mappage &agrave; une rubrique.
339
CHAPITRE 11
FICHIERS DE MAPPAGE ET ID DE MAPPAGE
AIDE CONTEXTUELLE
Attribution d'un ID de mappage &agrave; une rubrique
REMARQUE : RoboHelp prend &eacute;galement en charge le mappage contextuel dynamique des bo&icirc;tes de
dialogue et des rubriques. Gr&acirc;ce &agrave; cette approche, les r&eacute;dacteurs techniques n'ont plus &agrave; assurer le suivi
manuel des ID de mappage. Voir Modification dynamique de rubriques d'aide contextuelle.
1) Ouvrez le conteneur de configuration de sortie.
2) D&eacute;veloppez le dossier Aide contextuelle.
3) D&eacute;veloppez le dossier Fichiers de mappage.
4) Cliquez deux fois sur Tous les ID de mappage.
5) Dans Fichier de mappage, cliquez sur la fl&egrave;che vers le bas, puis s&eacute;lectionnez le fichier de mappage
contenant l'ID de mappage.
6) S&eacute;lectionnez l'ID de mappage &agrave; attribuer.
7) S&eacute;lectionnez la rubrique.
8) Cliquez sur Assigner.
9) Cliquez sur Fermer.
10) G&eacute;n&eacute;rez le projet.
11) Testez les rubriques applicables aux fen&ecirc;tres avec l'application.
Annulation de l'attribution d'un ID de mappage
1)
2)
3)
4)
5)
6)
7)
8)
9)
10)
Ouvrez une rubrique.
Cliquez sur le bouton Propri&eacute;t&eacute;s .
Cliquez sur l'onglet Avanc&eacute;.
Cliquez sur ID de mappage assign&eacute;s.
S&eacute;lectionnez l'ID de mappage dont vous souhaitez annuler l'attribution.
Cliquez sur Modifier les ID de mappage.
Cliquez sur Annuler l'assignation.
Cliquez sur Fermer.
G&eacute;n&eacute;rez le projet.
Testez les rubriques applicables aux fen&ecirc;tres avec l'application.
REMARQUE : Si vous attribuez des ID de mappage aux signets, puis supprimez les signets des rubriques,
annulez manuellement l'attribution des ID de mappage aux signets.
340
CHAPITRE 11
MODIFICATION DYNAMIQUE DE RUBRIQUES D'AIDE CONTEXTUELLE
AIDE CONTEXTUELLE
11.4. Modification dynamique de rubriques d'aide contextuelle
RoboHelp prend en charge la modification dynamique de la rubrique contextuelle associ&eacute;e &agrave; une bo&icirc;te
de dialogue d'application. Si aucune rubrique n'est associ&eacute;e &agrave; la bo&icirc;te de dialogue, vous pouvez soit
mapper dynamiquement une rubrique existante avec la bo&icirc;te de dialogue, soit cr&eacute;er une nouvelle
rubrique, puis la mapper avec la bo&icirc;te de dialogue.
REMARQUE : Pour utiliser cette fonctionnalit&eacute;, vous devez ouvrir l'application depuis RoboHelp. En outre,
l'application doit impl&eacute;menter l'aide contextuelle via l'API d'aide contextuelle de RoboHelp 9.
Actuellement, seules les API C++ sous Windows sont prises en charge.
Sc&eacute;narios d'utilisation
Le mappage de bo&icirc;tes de dialogue avec des rubriques d'aide requiert une collaboration &eacute;troite entre les
d&eacute;veloppeurs et les r&eacute;dacteurs techniques. Normalement, les d&eacute;veloppeurs d&eacute;finissent des ID de
mappage pour des bo&icirc;tes de dialogue dans le code et les communiquent aux r&eacute;dacteurs techniques.
Les r&eacute;dacteurs techniques associent ensuite manuellement les ID de mappage &agrave; des rubriques d'aide.
Avec le mappage contextuel dynamique de bo&icirc;tes de dialogue et de rubriques, les r&eacute;dacteurs techniques
n'ont plus &agrave; assurer le suivi manuel des ID de mappage. Au lieu de cela, ils peuvent ouvrir l'application et
associer dynamiquement la rubrique d'aide correspondante &agrave; une bo&icirc;te de dialogue.
Cette fonctionnalit&eacute; facilite &eacute;galement consid&eacute;rablement le test et le d&eacute;pannage de l'int&eacute;gration de
l'aide. Les r&eacute;dacteurs techniques peuvent ais&eacute;ment tester si les bo&icirc;tes de dialogue sont mapp&eacute;es avec les
rubriques d'aide appropri&eacute;es. Lors de la d&eacute;tection d'une incoh&eacute;rence, ils peuvent rapidement y rem&eacute;dier
et associer la bo&icirc;te de dialogue &agrave; la rubrique d'aide ad&eacute;quate.
Mappage d'une bo&icirc;te de dialogue d'application avec une rubrique
1)
2)
3)
4)
5)
6)
Ouvrez le projet d'aide de l'application dans RoboHelp.
Cliquez sur Outils &gt; CSH &gt; Ouvrir l'aide CSH.
Recherchez et s&eacute;lectionnez le fichier ex&eacute;cutable (.exe) pour l'application. Cliquez sur Ouvrir.
Une fois l'application d&eacute;marr&eacute;e, acc&eacute;dez &agrave; une bo&icirc;te de dialogue de l'application avec le mappage
d'aide contextuelle. Appuyez sur F1 ou cliquez sur le bouton Aide.
Dans la bo&icirc;te de dialogue Options CSH de RoboHelp, s&eacute;lectionnez un fichier de mappage &agrave; partir du
menu d&eacute;roulant Fichier de mappage du projet.
REMARQUE : La bo&icirc;te de dialogue Options CSH s'affiche uniquement si vous avez lanc&eacute; l'application
depuis RoboHelp, via Outils &gt; CSH &gt; Ouvrir l'aide CSH.
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Si vous souhaitez mapper une rubrique existante dans le projet RoboHelp avec la bo&icirc;te de
dialogue, s&eacute;lectionnez Mapper &agrave; la rubrique s&eacute;lectionn&eacute;e et s&eacute;lectionnez une rubrique pour
le mappage dans le volet de droite.
–
Si vous souhaitez cr&eacute;er une nouvelle rubrique et la mapper avec la bo&icirc;te de dialogue,
s&eacute;lectionnez Mapper &agrave; une nouvelle rubrique.
341
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
CHAPITRE 11
–
–
7)
Si vous souhaitez modifier le contenu de la rubrique actuellement mapp&eacute;e avec la bo&icirc;te de
dialogue, s&eacute;lectionnez Modifier une rubrique mapp&eacute;e.
Si vous voulez supprimer le mappage actuel entre la bo&icirc;te de dialogue et une rubrique d'aide,
s&eacute;lectionnez Supprimer le mappage.
Cliquez sur OK.
11.5. Informations &agrave; l'attention des d&eacute;veloppeurs
L'API partage les param&egrave;tres avec HTML Help et WinHelp. Vous pouvez cr&eacute;er des bo&icirc;tes de dialogue
personnalis&eacute;es.
REMARQUE : L'expression &laquo; bo&icirc;tes de dialogue personnalis&eacute;es &raquo; fait r&eacute;f&eacute;rence &agrave; la fonctionnalit&eacute; dont
disposent les projets qui utilisent ces API pour cr&eacute;er leurs propres bo&icirc;tes de dialogue en fonction de leurs
besoins.
Appelez vos projets d'aide avec la fonction RH_ShowHelp. Le code source de cette fonction est contenu
dans les fichiers de support que vous importez dans le projet de d&eacute;veloppement. Les langages pris en
charge sont Visual Basic, C/C++, JavaScript et Java. Les fichiers sont situ&eacute;s dans C:\Program
Files\Adobe\Adobe RoboHelp [version]\CSH API. Les fichiers sont les suivants :
•
CSH API\RoboHelp_CSH.vb (Visual Basic)
•
CSH API\RoboHelp_CSH.cpp (C/C++, d&eacute;pendant du .h)
•
CSH API\RoboHelp_CSH.h (C/C++, d&eacute;pendant du .cpp)
•
CSH API\RoboHelp_CSH.js (pages Web - HTML/JavaScript)
•
CSH API\RoboHelp_CSH.java (applications Java)
La fonction RH_ShowHelp contient les quatre param&egrave;tres indiqu&eacute;s dans le tableau suivant.
Param&egrave;tre
Description
hParent
Ce param&egrave;tre ferme la bo&icirc;te de dialogue Aide &agrave; la fermeture de la fen&ecirc;tre
d'appel.
a_pszHelpFile
Source d'aide (d&eacute;pend du type de sortie)
Pour WebHelp/Flashhelp : &laquo; chemin d'acc&egrave;s &agrave; la page de d&eacute;marrage du
projet &raquo;
Pour Webhelp Pro : &laquo; http://&lt;NomServeur&gt;/roboapi.asp &raquo;
Pour HTML Help : &laquo; chemin d'acc&egrave;s au fichier .CHM &raquo; Pour sp&eacute;cifier une
bo&icirc;te de dialogue, indiquez &laquo; &gt;Nomfen&ecirc;tre &raquo; &agrave; la fin du param&egrave;tre.
342
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
CHAPITRE 11
Param&egrave;tre
Description
uCommand
Constantes :
HH_DISPLAY_INDEX : affiche le volet d'index et la rubrique par d&eacute;faut.
HH_DISPLAY_SEARCH : affiche le volet de recherche et la rubrique par
d&eacute;faut.
HH_DISPLAY_TOC : affiche le volet de table des mati&egrave;res et la rubrique par
d&eacute;faut.
HH_HELP_CONTEXT : ouvre les rubriques associ&eacute;es &agrave; l'ID de mappage dans
le param&egrave;tre dwData.
dwData
Pour obtenir l'ID de mappage, exportez le fichier de mappage correspondant
au langage de programmation. Utilisez HH_HELP_CONTEXT dans le
param&egrave;tre uCommand.
Aide de programme des applications Visual Basic
Ces informations s'adressent aux d&eacute;veloppeurs souhaitant lier des rubriques d'aide contextuelle &agrave; des
applications Visual Basic.
1) Ouvrez le projet dans Visual Basic.
2) Si les fichiers de mappage ont &eacute;t&eacute; cr&eacute;&eacute;s dans RoboHelp, demandez au cr&eacute;ateur du syst&egrave;me d'aide
de les exporter vers Visual Basic.
3) Ajoutez le fichier RoboHelp_CSH.vb au projet. La fonction RH_ShowHelp est d&eacute;finie dans
RoboHelp_CSH.vb.
4) Ajoutez une r&eacute;f&eacute;rence aux contr&ocirc;les Microsoft Internet.
5) Pour ouvrir le syst&egrave;me d'aide, appelez RH_ShowHelp avec le param&egrave;tre uCommand d&eacute;fini sur
HH_DISPLAY_INDEX, HH_DISPLAY_SEARCH ou HH_DISPLAY_TOC et dwData d&eacute;fini sur &laquo; 0 &raquo;.
6) D&eacute;finissez la valeur du param&egrave;tre source de l'aide (conform&eacute;ment au type de sortie) dans une
variable de type cha&icirc;ne appel&eacute;e StrPathAndWindow comme suit :
REMARQUE : Dans les exemples suivants, l'API partage les m&ecirc;mes param&egrave;tres, quel que soit le type
de sortie. Seul l'emplacement du fichier d'aide est diff&eacute;rent.
WebHelp/FlashHelp
Stocke le chemin d'acc&egrave;s complet &agrave; la page de d&eacute;marrage et &agrave; un nom de bo&icirc;te de dialogue dans
une variable de type cha&icirc;ne appel&eacute;e StrPathAndWindow. Exemple de cette cha&icirc;ne : C:\Program
Files\MyApplication\WebHelp\MaPageD&eacute;marrage.htm&gt;Mafen&ecirc;tre.
343
CHAPITRE 11
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
WebHelp Pro
Stocke le chemin d'acc&egrave;s complet au serveur et &agrave; un nom de fen&ecirc;tre dans une variable de type
cha&icirc;ne appel&eacute;e StrPathAndWindow. Renseignez-vous aupr&egrave;s de l'administrateur Web pour
d&eacute;terminer si le nom du projet est requis. (Le nom de projet est requis si l'option de fusion
automatique est d&eacute;sactiv&eacute;e dans le gestionnaire de configuration de RoboHelp Server.)
Exemple de cette cha&icirc;ne :
http://&lt;servername&gt;/robohelp/rest/search?project=&lt;project-name&gt;&amp;quesn
=&lt;search-query&gt;
HTML Help
Stocke le chemin d'acc&egrave;s complet au fichier CHM et &agrave; un nom de bo&icirc;te de dialogue dans une
variable de type cha&icirc;ne appel&eacute;e StrPathAndWindow. Voici un exemple de cette cha&icirc;ne : C:\Program
Files\MonApplication\MonAide.chm&gt;MaFen&ecirc;tre.
ASTUCE : Ne codez pas en dur la variable de type cha&icirc;ne StrPathAndWindow.
7)
Pour appeler une rubrique d'aide, appelez la fonction RH_ShowHelp avec le param&egrave;tre
a_pszHelpFile d&eacute;fini sur StrPathAndWindow, le param&egrave;tre uCommand d&eacute;fini sur
HH_HELP_CONTEXT et le param&egrave;tre dwData d&eacute;fini sur l'ID de mappage de la rubrique.
Syntaxe de la fonction RH_ShowHelp
Syntaxe de la fonction RH_ShowHelp
RH_ShowHelp(hParent As Long, a_pszHelpFile As String, uCommand As Long,
dwData as Long) As Boolean
Exemple :
Pour ouvrir la rubrique portant le num&eacute;ro de mappage 1 :
Public cshObject as new RoboHelp_CSH .RH_ShowHelp Me.HWND,
StrPathAndWindow, cshObject.HH_HELP_CONTEXT, 1;
Remarques :
•
•
Pour les projets WebHelp Pro, la nouvelle API de l'aide contextuelle est uniquement prise en charge
par RoboHelp Server.
Cr&eacute;ez un seul objet RoboHelp_CSH global pour tous vos appels d'aide contextuelle.
Syst&egrave;me d'aide mixte pour les applications Visual Basic
Si vous utilisez un syst&egrave;me d'aide mixte, associez l'aide hors ligne avant de d&eacute;finir les appels de la
fonction.
Syntaxe
Public Function RH_AssociateOfflineHelp(pszPrimaryHelpSource As String,
pszBackupHelpSource As String) As Boolean
344
CHAPITRE 11
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
Exemple
strOnline = &quot;http:// www.mycompany.com/roboapi.asp?project=myproject&quot;
strOffline = &quot;C:\Program Files\My App\WebHelp\StartPage.htm&quot;
Public cshObject as new RoboHelp_CSH ' Should be global
object cshObject. RH_AssociateOfflineHelp strOnline, strOffline
Aide de programme des applications Visual C++
Ces informations s'adressent aux d&eacute;veloppeurs souhaitant lier des rubriques d'aide contextuelle &agrave; des
applications C++.
1) Ouvrez le projet dans l'EDI C++.
2) Ajoutez les modules RoboHelp_CSH.cpp et RoboHelp_CSH.h au projet.
3) Liez les biblioth&egrave;ques wininet.lib et Htmlhelp.lib &agrave; l'application. Recherchez la biblioth&egrave;que
Htmlhelp.lib dans le sous-dossier CSH API du dossier d'installation.
4) Si vous utilisez Microsoft Visual C++ avec des MFC, d&eacute;sactivez les en-t&ecirc;tes pr&eacute;compil&eacute;s dans le
fichier RoboHelp_CSH.cpp.
Interdiction &agrave; RoboHelp_CSH.cpp d'utiliser des en-t&ecirc;tes pr&eacute;compil&eacute;s
Visual Studio 6
1)
2)
3)
4)
5)
S&eacute;lectionnez Projet &gt; Param&egrave;tres.
S&eacute;lectionnez RoboHelp_csh.cpp.
Dans l'onglet C/C, d&eacute;finissez la cat&eacute;gorie sur En-t&ecirc;tes pr&eacute;compil&eacute;s.
S&eacute;lectionnez Sans utiliser les en-t&ecirc;tes pr&eacute;compil&eacute;s.
Cliquez sur OK.
Visual Studio .NET
1)
2)
3)
Cliquez avec le bouton droit de la souris sur RoboHelp_Csh.Cpp, puis s&eacute;lectionnez Propri&eacute;t&eacute;s.
Dans le dossier C/C, s&eacute;lectionnez En-t&ecirc;tes pr&eacute;compil&eacute;s.
S&eacute;lectionnez Sans utiliser les en-t&ecirc;tes pr&eacute;compil&eacute;s.
345
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
CHAPITRE 11
Appels de la fonction &agrave; partir des applications Visual C++
REMARQUE : Connexion de rubriques contextuelles multi-&eacute;cran HTML5, Responsive HTML5, WebHelp,
WebHelp Pro, FlashHelp, FlashHelp Pro ou d'aide HTML &agrave; des applications Visual C++.
REMARQUE : Vous pouvez &eacute;galement appeler l'aide contextuelle dans d'autres langages. Visual C++ est ici
fourni comme un exemple.
Syntaxe de la fonction RH_ShowHelp
int RH_ShowHelp(HWND hParent, const char * a_pszHelpFile, unsigned int
uCommand, DWORD dwData)
Param&egrave;tre
Type de donn&eacute;es
Description
hParent
HWND
Traitement de l'appel de la bo&icirc;te de dialogue d'aide
HTML uniquement : Fermez la bo&icirc;te de dialogue
d'aide avec la fen&ecirc;tre d'appel.
a_pszHelpFile
const char *
Source d'aide. Pour WebHelp/FlashHelp : &laquo; chemin
d'acc&egrave;s &agrave; la page de d&eacute;marrage du projet &raquo;.
Pour WebHelp Pro :
&laquo; http://[nom_serveur]/roboapi.asp &raquo;
* Pour HTML Help : &laquo; chemin d'acc&egrave;s au fichier
.CHM &raquo;
Pour sp&eacute;cifier une bo&icirc;te de dialogue, indiquez
&laquo; &gt;Nomfen&ecirc;tre &raquo; &agrave; la fin de ce param&egrave;tre.
uCommand
unsigned int
Constantes :
HH_DISPLAY_INDEX : affiche le volet d'index et
la rubrique par d&eacute;faut.
HH_DISPLAY_SEARCH : affiche le volet de
recherche et la rubrique par d&eacute;faut.
HH_DISPLAY_TOC : affiche le volet de table des
mati&egrave;res et la rubrique par d&eacute;faut.
HH_HELP_CONTEXT : ouvre les rubriques
associ&eacute;es &agrave; l'ID de mappage dans le param&egrave;tre
dwData.
dwData
DWORD
Pour obtenir l'ID de mappage, exportez le fichier de
mappage correspondant au langage de
programmation. Utilisez HH_HELP_CONTEXT dans
le param&egrave;tre uCommand.
346
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
CHAPITRE 11
Syntaxe RH_OpenHelpTopic
Appelez la fonction &laquo; RH_OpenHelpTopic &raquo; pour ouvrir une rubrique d'aide dans WebHelp ou FlashHelp.
int RH_OpenHelpTopic(const TCHAR * a_pszHelpMainPage,
const TCHAR * a_pszTopicRelPath);
Param&egrave;tre
Type de donn&eacute;es
Description
a_pszHelpMainPage
const char *
Source d'aide. Pour WebHelp/FlashHelp : &laquo; chemin
d'acc&egrave;s &agrave; la page de d&eacute;marrage du projet &raquo;. Pour
pr&eacute;ciser une fen&ecirc;tre, ajoutez &laquo; &gt;NomFen&ecirc;tre &raquo; &agrave; la
fin du chemin d'acc&egrave;s &agrave; la page de d&eacute;marrage du
projet.
a_pszTopicRelPath
const char *
Chemin d'acc&egrave;s relatif &agrave; la rubrique correspondant
&agrave; la page principale.
ASTUCE : Pour afficher la rubrique par d&eacute;faut, d&eacute;finissez un appel d'aide d&eacute;finissant le param&egrave;tre uCom-
mand sur HH_DISPLAY_INDEX, HH_DISPLAY_SEARCH ou HH_DISPLAY_TOC, et le param&egrave;tre
dwData sur &laquo; 0 &raquo;. Dans les syst&egrave;mes WebHelp Pro, les param&egrave;tres de fen&ecirc;tre par d&eacute;faut des boutons de
navigation par d&eacute;faut remplacent la constante HH_DISPLAY.
Appel d'une fonction d'aide contextuelle pour AIR Help
REMARQUE : L'API AIR Help est fournie pour de nombreux langages, y compris JAVA, VC.NET, CS.NET, VB,
VB.NET. L'exemple ci-dessous montre comment invoquer l'API AIR Help &agrave; l'aide de Visual C++.
Appelez la fonction RH_AIR_ShowHelp pour afficher l'application AIR Help.
int RH_AIR_ShowHelp(const TCHAR * a_pszViewerPath,
const TCHAR * a_pszHelpId,
const TCHAR * a_pszWindowName,
unsigned long ulMapNum,
const TCHAR * a_pszMapId,
const TCHAR * a_pszTopicURL);
Param&egrave;tre
Type de donn&eacute;es
Description
a_pszViewerPath
const char *
Chemin d'acc&egrave;s au r&eacute;pertoire d'installation de l'application
AIR Help.
a_ pszHelpId
const char *
(Facultatif) ID du contenu d'aide &agrave; afficher dans l'afficheur.
Cet ID est sp&eacute;cifi&eacute; dans le fichier .helpcfg.
a_pszWindowName
const char *
(Facultatif) Nom de la fen&ecirc;tre de sortie personnalis&eacute;e.
ulMapNum
non sign&eacute; long
Num&eacute;ro de mappage sensible au contexte
347
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
CHAPITRE 11
a_pszMapId
const char *
(Facultatif) ID de mappage sensible au contexte. Si cette option
est pr&eacute;cis&eacute;e, elle est prioritaire et ulMapNum est ignor&eacute;.
a_pszTopicURL
const char *
(Facultatif) URL de la rubrique &agrave; afficher. Si ce param&egrave;tre
est pr&eacute;cis&eacute;, il est prioritaire sur ulMapNum et a_pszMapId.
La valeur de retour est 0 pour un r&eacute;sultat r&eacute;ussi et diff&eacute;rent de z&eacute;ro en cas d'erreur.
RH_GetAIRAppPath
Appelez la fonction RH_GetAIRAppPath pour obtenir l'application AIR Help.
TCHAR * RH_GetAIRAppPath(const TCHAR * a_pszAppId,
const TCHAR * a_pszPublisherId);
Param&egrave;tre
Type de donn&eacute;es
Description
a_pszAppId
const char *
ID de l'application d'aide, pr&eacute;cis&eacute; dans RoboHelp
pendant la g&eacute;n&eacute;ration du fichier AIR.
a_pszPublisherId
const char *
ID correspondant au certificat num&eacute;rique utilis&eacute;
pour signer l'application AIR.
Chemin d'acc&egrave;s de la valeur de retour de l'application AIR. L'utilisateur peut appeler la fonction free()
pour lib&eacute;rer de la m&eacute;moire.
REMARQUE : Le type de donn&eacute;es peut &eacute;galement &ecirc;tre const wchar * pour les applications Unicode.
Appel d'une fonction d'aide contextuelle Responsive HTML5, WebHelp, FlashHelp ou FlashHelp Pro
Dans l'exemple suivant, le chemin d'acc&egrave;s complet &agrave; la page de d&eacute;marrage de WebHelp/FlashHelp ainsi
que le nom de la bo&icirc;te de dialogue sont stock&eacute;s dans la variable de type cha&icirc;ne appel&eacute;e StrPathAndWindow. Voici un exemple de cette cha&icirc;ne : C:\Program Files\\MonApplication\WebHelp\MaPageD&eacute;marrage.htm&gt;MaFen&ecirc;tre. Ne codez pas cette cha&icirc;ne en dur.
REMARQUE : Exportez les fichiers de mappage vers l'emplacement.
Exemple :
Pour ouvrir la rubrique portant le num&eacute;ro de mappage 1 :
RH_ShowHelp(GetSafeHwnd(), strPathAndWindow, HH_HELP_CONTEXT, (DWORD)1);
REMARQUE : Si vous utilisez un syst&egrave;me d'aide mixte, associez l'aide hors ligne avant de d&eacute;finir les appels.
REMARQUE : Si vous utilisez l'aide multi-&eacute;cran ou Responsive HTML5, vous pouvez &eacute;galement utiliser les
fonctions RH_ShowMultiscreenHelpWithMapId et RH_ShowMultiscreenHelpWithMapNo pour
appeler les rubriques d'aide HTML5 en utilisant l'ID de mappage et le num&eacute;ro de mappage,
respectivement. Le code source et la documentation de ces fonctions sont contenus dans le fichier de
support RoboHelp_CSH.cpp situ&eacute; &agrave; l'emplacement C:\Program Files\Adobe\Adobe RoboHelp
[version]\CSH API\. Vous devez importer ce fichier de support dans votre projet de d&eacute;veloppement C/C++
pour pouvoir utiliser ces fonctions.
348
CHAPITRE 11
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
Appel d'une fonction d'aide contextuelle pour WebHelp Pro
1)
Appelez la fonction.
Dans l'exemple suivant, le chemin d'acc&egrave;s complet au serveur ainsi que le nom de la bo&icirc;te de
dialogue sont stock&eacute;s dans la variable de type cha&icirc;ne appel&eacute;e StrPathAndWindow. Si l'option de
fusion automatique est d&eacute;sactiv&eacute;e, le nom de projet est requis. La valeur de cette cha&icirc;ne est
http://&lt;servername&gt;/robohelp/rest/search?project=&lt;project-name&gt;&amp;quesn
=&lt;search-query&gt; pour obtenir l'URL d'un mot-cl&eacute; donn&eacute;.
Pour obtenir les informations contextuelles, les URL sont
http://servername&gt;/robohelp/rest/robowindow?wtype=ctx
&amp;context=&lt;id&gt;[&amp;area=&lt;area_of_publishing&gt;&amp;type=project_type&gt;]
ou
http://servername&gt;/robohelp/rest/robowindow?wtype=prj&amp;window=&lt;windown
ame&gt;[&amp;area=&lt;area_of_publishing&gt;&amp;type=&lt;project_type&gt;]
REMARQUE : Exportez les fichiers de mappage vers l'emplacement.
Exemple :
Pour ouvrir la rubrique portant le num&eacute;ro de mappage 1 :
RH_ShowHelp(GetSafeHwnd(), strPathAndWindow, HH_HELP_CONTEXT, (DWORD)1);
2)
Ex&eacute;cutez l'application et testez l'appel d'aide.
REMARQUE : Si vous utilisez un syst&egrave;me d'aide mixte, associez l'aide hors ligne avant de d&eacute;finir les appels.
Appel d'une fonction d'aide contextuelle pour HTML Help
1)
Appelez la fonction.
Dans l'exemple suivant, le fichier CHM ainsi que le nom de la bo&icirc;te de dialogue sont stock&eacute;s dans la
variable de type cha&icirc;ne appel&eacute;e StrPathAndWindow. La valeur de cette cha&icirc;ne indique le chemin
vers le fichier CHM, par exemple C:\Program Files\MyApplication\MyHelp.chm&gt;MyWindow.
Exemple :
Pour ouvrir la rubrique portant le num&eacute;ro de mappage 1 :
RH_ShowHelp(GetSafeHwnd(), strPathAndWindow, HH_HELP_CONTEXT, (DWORD)1);
2)
Ex&eacute;cutez l'application et testez l'appel d'aide.
Remarques :
•
•
Si vous utilisez un syst&egrave;me d'aide mixte, associez l'aide hors ligne avant de d&eacute;finir les appels.
Dans les projets WebHelp Pro, l'API d'aide est uniquement prise en charge par RoboHelp Server ou
RoboEngine 3.0 ou version ult&eacute;rieure.
349
CHAPITRE 11
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
Remplacement du gestionnaire d'aide MFC par d&eacute;faut
cette rubrique s'adresse aux d&eacute;veloppeurs Visual C++ souhaitant cr&eacute;er des applications bas&eacute;es sur les
classes MFC.
•
Conform&eacute;ment aux instructions du fichier d'en-t&ecirc;te RoboHelp_CSH.h, liez les biblioth&egrave;ques
wininet.lib et Htmlhelp.lib &agrave; l'application. La biblioth&egrave;que Htmlhelp.lib r&eacute;side g&eacute;n&eacute;ralement dans le
dossier d'installation CSH API de RoboHelp.
•
Ajoutez le fichier RoboHelp_CSH.cpp au projet.
•
Pour utiliser l'API RoboHelp au lieu du gestionnaire d'aide MFC par d&eacute;faut, remplacez la fonction
WinHelp dans la classe mainframe. Par d&eacute;faut, cette classe est appel&eacute;e CMainFrame dans Visual
Studio. Pour cr&eacute;er le remplacement de fonction, vous pouvez utiliser l'assistant de classe de Visual
Studio.
•
Apr&egrave;s avoir remplac&eacute; la fonction et ajout&eacute; RoboHelp_CSH.h, remplacez le contenu de la fonction
par ce code. (D&eacute;finissez correctement le chemin d'acc&egrave;s &agrave; votre fichier d'aide. L'exemple illustre une
aide RoboHelp Server.)
REMARQUE : Modifiez le chemin d'acc&egrave;s &agrave; l'aide serveur en fonction de votre projet. Dans cet
exemple, le chemin d'acc&egrave;s s'applique &agrave; l'aide RoboHelp Server. consultez le reste de la
documentation sur l'API pour conna&icirc;tre les valeurs de param&egrave;tres correspondant &agrave; chaque
commande ainsi que la proc&eacute;dure de sp&eacute;cification de fen&ecirc;tres secondaires pour les appels d'aide
contextuelle.
CWaitCursor wait;
if (IsFrameWnd()) {
// CFrameWnd windows should be allowed to exit help mode first
CFrameWnd* pFrameWnd = (CFrameWnd*)this;
pFrameWnd-&gt;ExitHelpMode();
}
// cancel any tracking modes
SendMessage(WM_CANCELMODE);
SendMessageToDescendants(WM_CANCELMODE, 0, 0, TRUE, TRUE);
// must use top level parent (for the case where m_hWnd is in DLL)
CWnd* pWnd = GetTopLevelParent();
pWnd-&gt;SendMessage(WM_CANCELMODE);
pWnd-&gt;SendMessageToDescendants(WM_CANCELMODE, 0, 0, TRUE, TRUE);
// attempt to cancel capture
HWND hWndCapture = ::GetCapture();
if (hWndCapture != NULL)
::SendMessage(hWndCapture, WM_CANCELMODE, 0, 0);
// Set the path to server-based help
CString csOnlineHelpPath = _T(&quot;http://myserver/RoboAPI.asp&quot;);
// Translate the nCmd from WinHelp commands to RoboHelp commands
unsigned int nRHCmd;
switch (nCmd) {
case HELP_CONTEXT: nRHCmd = HH_HELP_CONTEXT; break;
case HELP_CONTENTS: nRHCmd = HH_DISPLAY_TOC; break;
case HELP_CONTEXTMENU: nRHCmd = HH_TP_HELP_CONTEXTMENU; break;
case HELP_WM_HELP: nRHCmd = HH_TP_HELP_WM_HELP; break;
case HELP_FINDER: nRHCmd = HH_HELP_FINDER; break;
350
CHAPITRE 11
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
default: nRHCmd = nCmd; break;
}
// finally, run the RoboHelp Help engine
if (!RH_ShowHelp(pWnd-&gt;m_hWnd, csOnlineHelpPath, nCmd, dwData))
AfxMessageBox(AFX_IDP_FAILED_TO_LAUNCH_HELP);
D&eacute;veloppeurs en Visual C++ dans Visual Studio .NET
•
•
•
•
Conform&eacute;ment aux instructions du fichier d'en-t&ecirc;te RoboHelp_CSH.h, liez les biblioth&egrave;ques
wininet.lib et htmlhelp.lib &agrave; l'application.
Ajoutez le fichier RoboHelp_CSH.cpp au projet.
Pour utiliser l'API RoboHelp au lieu du gestionnaire d'aide MFC par d&eacute;faut, remplacez la fonction
HtmlHelp dans la classe mainframe. Par d&eacute;faut, cette classe est appel&eacute;e CMainFrame dans Visual
Studio. Pour cr&eacute;er le remplacement de fonction, vous pouvez utiliser l'assistant de classe de Visual
Studio.
Apr&egrave;s avoir remplac&eacute; la fonction et inclus RoboHelp_CSH.h, remplacez le contenu de la fonction par
le code suivant. (D&eacute;finissez le chemin vers votre fichier d'aide en cons&eacute;quence. L'exemple illustre
une aide bas&eacute;e serveur.)
CWaitCursor wait;
// Get the path to the Help system
CWinApp* pApp = AfxGetApp();
ASSERT_VALID(pApp);
// Set the path to server-based help
CString csOnlineHelpPath = _T(&quot;http://RoboHelp
Server:port/robohelp/server&quot;);
PrepareForHelp();
// must use top level parent (for the case where m_hWnd is in DLL)
CWnd* pWnd = GetTopLevelParent();
// finally, run the RoboHelp Help engine
if (!RH_ShowHelp(pWnd-&gt;m_hWnd, csOnlineHelpPath, nCmd, dwData))
AfxMessageBox(AFX_IDP_FAILED_TO_LAUNCH_HELP);
REMARQUE : Dans les projets WebHelp Pro, la nouvelle API d'aide est uniquement prise en charge par
RoboHelp Server ou RoboEngine 3.0 ou version ult&eacute;rieure.
Syst&egrave;me d'aide mixte pour les applications C++
Syntaxe
void RH_AssociateOfflineHelp(const char * a_pszPrimaryHelpSource, const
char * a_pszBackupHelpSource)
Exemple
m_sOnline = &quot;http://www.mycompany.com/roboapi.asp?project=myproject&quot;;
m_sOffline = &quot;C:\Program Files\My App\WebHelp\StartPage.htm&quot;;
RH_AssociateOfflineHelp(m_sOnline, m_sOffline);
REMARQUE : Pour sp&eacute;cifier des noms de fen&ecirc;tre diff&eacute;rents pour l'aide en ligne et l'aide hors ligne, vous
pouvez mapper des fen&ecirc;tres sur RH_AssociateOfflineHelp. Suivez cet exemple pour Visual Basic :
351
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
CHAPITRE 11
strOnline =
&quot;http://www.mycompany.com/roboapi.asp?project=myproject&gt;RemoteWindow1&quot;
strOffline = &quot;C:\Program Files\My App\MyHelp.chm&gt;LocalWindow1&quot;
Public cshObject as new RoboHelp_CSH ' Should be global object
cshObject. RH_AssociateOfflineHelp strOnline, strOffline
strOnline =
&quot;http://www.mycompany.com/roboapi.asp?project=myproject&gt;RemoteWindow2&quot;
strOffline = &quot;C:\Program Files\My App\MyHelp.chm&gt;LocalWindow2&quot;
cshObject. RH_AssociateOfflineHelp strOnline, strOffline
REMARQUE : Dans les projets WebHelp Pro, l'API d'aide est uniquement prise en charge par RoboHelp
Server ou RoboEngine 3.0 ou version ult&eacute;rieure.
Aide &agrave; la programmation pour les applications Java
Ces informations s'adressent aux d&eacute;veloppeurs souhaitant lier des rubriques d'aide contextuelle &agrave; des
applications Java.
1) Ouvrez le projet dans l'EDI (Environnement de d&eacute;veloppement int&eacute;gr&eacute;) Java.
2) Ajoutez RoboHelp_csh.java au projet.
3) Appelez la fonction d&eacute;finie dans RoboHelp_csh.java en sp&eacute;cifiant les param&egrave;tres n&eacute;cessaires.
REMARQUE : L'API Java ne prend pas en charge les syst&egrave;mes d'aide mixtes (locaux et en ligne).
Appels de fonction &agrave; partir des applications Java
Dans les exemples suivants, l'API partage les m&ecirc;mes param&egrave;tres, quel que soit le type de sortie. Seul
l'emplacement du fichier d'aide est diff&eacute;rent.
public static boolean RH_ShowHelp(int hParent, String a_pszHelpFile, int
uCommand, int
dwData)
Param&egrave;tre
Type de donn&eacute;es
Description
hParent
int
R&eacute;serv&eacute; aux futures versions. Utiliser 0.
a_pszHelpFile
Cha&icirc;ne
Source d'aide. Pour WebHelp/FlashHelp :
&laquo; &lt;chemin d'acc&egrave;s &agrave; la page de d&eacute;marrage du
projet&gt; &raquo;. Pour WebHelp Pro :
&laquo; http://[nom_serveur]/roboapi.asp &raquo;
*Facultatif : sp&eacute;cifiez des bo&icirc;tes de dialogue en
indiquant &laquo; &gt;NomFen&ecirc;tre &raquo; &agrave; la fin de ce
param&egrave;tre.
352
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
CHAPITRE 11
Param&egrave;tre
Type de donn&eacute;es
Description
uCommand
int
Constantes :
HH_DISPLAY_INDEX : affiche le volet d'index et
la rubrique par d&eacute;faut.
HH_DISPLAY_SEARCH : affiche le volet de
recherche et la rubrique par d&eacute;faut.
HH_DISPLAY_TOC : affiche le volet de table des
mati&egrave;res et la rubrique par d&eacute;faut.
HH_HELP_CONTEXT : ouvre les rubriques
associ&eacute;es &agrave; l'ID de mappage dans le param&egrave;tre
dwData.
dwData
int
ID de mappage de rubrique (d&eacute;fini &agrave; l'aide de
l'option Modifier les ID de mappage de RoboHelp).
Pour obtenir l'ID de mappage, exportez le fichier de
mappage correspondant &agrave; votre langage (utilisez
HH_HELP_CONTEXT dans le param&egrave;tre
uCommand).
ASTUCE : Pour ouvrir le syst&egrave;me d'aide (afficher la rubrique par d&eacute;faut), d&eacute;finissez un appel d'aide d&eacute;finis-
sant le param&egrave;tre uCommand sur HH_DISPLAY_INDEX, HH_DISPLAY_SEARCH ou HH_DISPLAY_TOC, et le param&egrave;tre dwData sur &laquo; 0 &raquo;. Dans les syst&egrave;mes WebHelp Pro, les param&egrave;tres de
fen&ecirc;tre par d&eacute;faut des boutons de navigation par d&eacute;faut remplacent la constante HH_DISPLAY (toutefois, le syst&egrave;me d'aide s'ouvre toujours sur la rubrique par d&eacute;faut).
Appel d'une fonction d'aide contextuelle Responsive HTML5, WebHelp, FlashHelp ou FlashHelp Pro
1)
Appelez la fonction.
RoboHelp_CSH.RH_ShowHelp(0, StrPathAndWindow,
RoboHelp_csh.HH_HELP_CONTEXT, 1);
2)
O&ugrave; le chemin d'acc&egrave;s complet &agrave; la page de d&eacute;marrage de WebHelp/FlashHelp ainsi qu'un nom de
fen&ecirc;tre (facultatif) sont stock&eacute;s dans StrPathAndWindow. (Ne jamais coder en dur cette cha&icirc;ne.)
REMARQUE : L'expression &laquo; Ne jamais coder en dur cette cha&icirc;ne &raquo; indique que cette cha&icirc;ne doit &ecirc;tre
conserv&eacute;e en tant que variable que l'utilisateur utilise comme entr&eacute;e afin que le code soit
r&eacute;utilisable pour l'ouverture des diff&eacute;rents fichiers d'aide.
Ex&eacute;cutez l'application et testez l'appel d'aide.
REMARQUE : Si vous utilisez l'aide multi-&eacute;cran ou Responsive HTML5, vous pouvez &eacute;galement utiliser les
fonctions RH_ShowMultiscreenHelpWithMapId et RH_ShowMultiscreenHelpWithMapNo pour
appeler les rubriques d'aide HTML5 en utilisant l'ID de mappage et le num&eacute;ro de mappage,
respectivement. Le code source et la documentation de ces fonctions sont contenus dans le fichier de
support RoboHelp_CSH.java situ&eacute; &agrave; l'emplacement C:\Program Files\Adobe\Adobe RoboHelp
[version]\CSH API\. Vous devez importer ce fichier de support dans votre projet de d&eacute;veloppement Java
pour pouvoir utiliser ces fonctions.
353
CHAPITRE 11
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
Appel d'une fonction d'aide contextuelle pour WebHelp Pro
1)
Appelez la fonction.
RoboHelp_CSH.RH_ShowHelp(0, StrPathAndWindow,
RoboHelp_csh.HH_HELP_CONTEXT, 1);
O&ugrave; le chemin d'acc&egrave;s complet au serveur RoboHelp ainsi qu'un nom de bo&icirc;te de dialogue (facultatif)
sont stock&eacute;s dans StrPathAndWindow. (Le nom de projet est requis si l'option de fusion automatique
est d&eacute;sactiv&eacute;e dans le gestionnaire de configuration de RoboEngine.) Exemples pour cette valeur :
&laquo; http://RoboHelp Server:port/robohelp/server &raquo; ou &laquo; http://RoboHelp
Server:port/robohelp/server?project=MyProject&gt;MyWindow &raquo;.
Pour ouvrir la rubrique portant le num&eacute;ro de mappage 1 :
RoboHelp_CSH.RH_ShowHelp(0, StrPathAndWindow,
RoboHelp_csh.HH_HELP_CONTEXT, 1);
2)
Ex&eacute;cutez l'application et testez l'appel d'aide.
Aide &agrave; la programmation pour les pages Web
Ces informations s'adressent aux d&eacute;veloppeurs souhaitant lier des rubriques d'aide contextuelle &agrave; des
pages Web.
1) Mettez-vous d'accord avec l'auteur sur les points ci-dessous :
–
La personne charg&eacute;e de fournir les num&eacute;ros de mappage ;
–
La n&eacute;cessit&eacute; de cr&eacute;er un syst&egrave;me d'aide contextuelle pour le projet.
–
L'emplacement de stockage du syst&egrave;me d'aide (ordinateur local ou serveur).
2)
3)
4)
Ouvrez les pages Web.
Liez les pages &agrave; RoboHelp_csh.js.
Lorsque vous appelez le syst&egrave;me &agrave; partir du site Web, appelez la fonction d&eacute;finie dans le fichier
RoboHelp_csh.js.
Aide &agrave; la programmation pour les pages Web (WebHelp/Pro)
ASTUCE : Utilisez les fichiers de support d'aide contextuelle. Ces fichiers permettent aux d&eacute;veloppeurs
d'appeler des fonctionnalit&eacute;s int&eacute;gr&eacute;es.
L'exemple ci-dessous illustre une m&eacute;thode possible de d&eacute;claration de fonction JavaScript affichant une
nouvelle bo&icirc;te de dialogue. La fonction ShowHelp affiche la rubrique sp&eacute;cifi&eacute;e dans une fen&ecirc;tre personnalis&eacute;e dont les attributs sont d&eacute;finis par la variable strHelpOptions.
var strHelpOptions = &quot;location=no&quot;;
strHelpOptions += &quot;,toolbar=no&quot;;
strHelpOptions += &quot;,menubar=yes&quot;;
strHelpOptions += &quot;,status=yes&quot;;
strHelpOptions += &quot;,scrollbars=yes&quot;;
strHelpOptions += &quot;,resizable=yes&quot;;
strHelpOptions += &quot;,top=0&quot;;
strHelpOptions += &quot;,left=0&quot;;
strHelpOptions += &quot;,width=400&quot;;
354
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
CHAPITRE 11
strHelpOptions += &quot;,height=400&quot;;
function ShowHelp(strUrl)
{
window.open(strUrl, &quot;Help&quot;, strHelpOptions);
}
Pour utiliser ShowHelp, ins&eacute;rez le script ci-dessus entre les balises &lt;/HEAD&gt; et &lt;BODY&gt; du fichier HTML.
Ins&eacute;rez une balise d'ancrage similaire &agrave; celle indiqu&eacute;e ci-dessous afin de permettre aux utilisateurs
d'acc&eacute;der &agrave; une fen&ecirc;tre d'aide :
Help!
Cette balise cr&eacute;e un hyperlien affichant le texte Help! Si un utilisateur final clique sur cet hyperlien, le
fichier widget.htm s'ouvre dans une seconde fen&ecirc;tre de navigateur.
Appels de fonctions &agrave; partir de pages Web
REMARQUE : Ces informations s'adressent aux d&eacute;veloppeurs souhaitant lier des rubriques d'aide
contextuelle Multi-&eacute;cran/Responsive HTML5, WebHelp, WebHelp Pro, FlashHelp ou FlashHelp Pro &agrave; des
pages Web.
Dans les exemples suivants, l'API partage les m&ecirc;mes param&egrave;tres, quel que soit le type de sortie. Seul
l'emplacement du fichier d'aide est diff&eacute;rent.
REMARQUE : Si vous utilisez l'aide multi-&eacute;cran ou Responsive HTML5, vous pouvez &eacute;galement utiliser les
fonctions RH_ShowMultiscreenHelpWithMapId et RH_ShowMultiscreenHelpWithMapNo pour appeler
les rubriques d'aide HTML5 en utilisant l'ID de mappage et le num&eacute;ro de mappage, respectivement. Le
code source et la documentation de ces fonctions sont contenus dans le fichier de support
RoboHelp_CSH.js situ&eacute; &agrave; l'emplacement C:\Program Files\Adobe\Adobe RoboHelp [version]\CSH API\.
Vous devez importer ce fichier de support dans votre projet de d&eacute;veloppement HTML/JavaScript pour
pouvoir utiliser ces fonctions.
Syntaxe de la fonction RH_ShowHelp
function RH_ShowHelp(hParent, a_pszHelpFile, uCommand, dwData)
Param&egrave;tre
Type de donn&eacute;es
Description
hParent
var
R&eacute;serv&eacute; aux futures versions de l'API. Utiliser 0.
a_pszHelpFile
var
Source d'aide. Pour Webhelp : &laquo; &lt;Chemin d'acc&egrave;s &agrave;
la page de d&eacute;marrage du projet&gt; &raquo; (peut &ecirc;tre local
ou sur un serveur). Pour WebHelp Pro :
&laquo; http://[nom du serveur]/roboapi.asp &raquo;
*Facultatif : pour sp&eacute;cifier une fen&ecirc;tre, indiquez
&laquo; &gt;NomFen&ecirc;tre &raquo; &agrave; la fin de ce param&egrave;tre.
355
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
CHAPITRE 11
Param&egrave;tre
Type de donn&eacute;es
Description
uCommand
var
Constantes :
HH_DISPLAY_INDEX : affiche le volet d'index et
la rubrique par d&eacute;faut.
HH_DISPLAY_SEARCH : affiche le volet de
recherche et la rubrique par d&eacute;faut.
HH_DISPLAY_TOC: affiche le volet de table des
mati&egrave;res et la rubrique par d&eacute;faut.
HH_HELP_CONTEXT : ouvre les rubriques
associ&eacute;es &agrave; l'ID de mappage dans le param&egrave;tre
dwData.
dwData
var
ID de mappage de la rubrique affich&eacute;e. Pour
obtenir l'ID de mappage, l'auteur peut exporter le
fichier de mappage correspondant &agrave; un langage de
programmation en indiquant HH_HELP_CONTEXT
dans le param&egrave;tre uCommand.
Syntaxe RH_OpenHelpTopic
Appelez la fonction &laquo; RH_OpenHelpTopic &raquo; pour ouvrir une rubrique WebHelp/FlashHelp.
function RH_OpenHelpTopic(a_pszHelpMainPage, a_pszRelTopicUrl)
Param&egrave;tre
Type de donn&eacute;es
Description
a_pszHelpMainPage
var
Source d'aide. Pour WebHelp/FlashHelp : &laquo; chemin
d'acc&egrave;s &agrave; la page de d&eacute;marrage du projet &raquo;. Pour
pr&eacute;ciser une fen&ecirc;tre, ajoutez &laquo; &gt;NomFen&ecirc;tre &raquo; &agrave; la
fin du chemin d'acc&egrave;s &agrave; la page de d&eacute;marrage du
projet.
a_pszRelTopicUrl
var
Chemin d'acc&egrave;s relatif &agrave; la rubrique correspondant
&agrave; la page principale.
ASTUCE : Pour ouvrir l'int&eacute;gralit&eacute; du syst&egrave;me d'aide (afficher la rubrique par d&eacute;faut), d&eacute;finissez un appel
d'aide d&eacute;finissant le param&egrave;tre uCommand sur HH_DISPLAY_INDEX, HH_DISPLAY_SEARCH ou
HH_DISPLAY_TOC, et le param&egrave;tre dwData sur &laquo; 0 &raquo;. Dans les syst&egrave;mes WebHelp Pro, les param&egrave;tres
de fen&ecirc;tre par d&eacute;faut des boutons de navigation par d&eacute;faut remplacent la constante HH_DISPLAY.
356
CHAPITRE 11
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
Appel d'une fonction contextuelle pour WebHelp Pro
1)
Appelez l'API suivante pour obtenir les informations contextuelles du serveur.
Dans l'exemple suivant, le chemin d'acc&egrave;s complet au serveur RoboHelp ainsi que le nom de la bo&icirc;te de dialogue (facultatif) sont stock&eacute;s dans une variable de type cha&icirc;ne appel&eacute;e StrPathAndWindow. Le nom de
projet est requis si l'option de fusion automatique est d&eacute;sactiv&eacute;e dans le gestionnaire de configuration de
RoboEngine. Exemples pour la valeur de cette cha&icirc;ne : &laquo; http://RoboHelp Server:port/robohelp/server &raquo; ou
&laquo; http://RoboHelp Server:port/robohelp/server?project=MyProject&gt;MyWindow &raquo;.
REMARQUE : Demandez &agrave; votre r&eacute;dacteur technique de vous indiquer les fen&ecirc;tres &agrave; appeler. Si le
r&eacute;dacteur cr&eacute;e &eacute;galement les fichiers de mappage, demandez-lui d'exporter ces fichiers &agrave;
l'emplacement appropri&eacute;.
Exemple :
Pour ouvrir la rubrique portant le num&eacute;ro de mappage 1 :
&lt;p&gt;Cliquez pour obtenir de l'aide (num&eacute;ro de mappage 1)&lt;/p&gt;
2)
Ex&eacute;cutez l'application et testez l'appel d'aide.
REMARQUE : Pour les projets WebHelp Pro, la nouvelle API de l'aide contextuelle est uniquement prise en
charge par RoboEngine 3.0 ou une version sup&eacute;rieure.
Appel d'une fonction contextuelle pour WebHelp ou FlashHelp
1)
2)
Appelez l'API suivante pour obtenir les informations contextuelles du serveur.
http://servername&gt;/robohelp/rest/robowindow?wtype=ctx&amp;context=&lt;MAP
ID&gt;
Exemple :
Pour ouvrir la rubrique mapp&eacute;e en num&eacute;ro 1, remplacez &lt;ID MAPPAGE&gt; par 1.
Ex&eacute;cutez l'application et testez l'appel d'aide.
Programmation d'un syst&egrave;me d'aide pour .NET
Principes de base de .NET
Cette combinaison prend en charge toutes les versions de RoboHelp Server avec .NET :
•
Cr&eacute;e des services Web, des WebForms et des WinForms.
•
Elle offre une prise en charge compl&egrave;te de l'architecture .NET.
•
Elle fonctionne comme service Web .NET ind&eacute;pendant.
•
Elle fournit les API permettant la prise en charge du d&eacute;veloppement de syst&egrave;mes d'aide en Visual C
.NET, C# .NET, Visual Basic .NET et ASP.NET.
•
Elle garantit la prise en charge de la configuration .NET requise par l'aide contextuelle existante.
RoboHelp Server avec .NET permet la cr&eacute;ation d'applications de bureau ou destin&eacute;es aux r&eacute;seaux intranet
ou Internet et la prise en charge du d&eacute;veloppement de ces types d'applications.
357
CHAPITRE 11
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
Cr&eacute;ez un syst&egrave;me d'aide serveur dans un environnement .NET et g&eacute;n&eacute;rez des analyses en temps r&eacute;el de
l'activit&eacute; des utilisateurs au sein du syst&egrave;me d'aide. Utilisez Visual C .NET, ASP .NET, Visual Basic .NET ou
C# .NET pour int&eacute;grer les syst&egrave;mes d'aide.
Fichiers de support d'aide contextuelle pour .NET
Les fichiers de support de programmation d'aide contextuelle permettent d'importer des cha&icirc;nes de code
et d'entrer des variables plut&ocirc;t que d'avoir &agrave; r&eacute;diger l'int&eacute;gralit&eacute; du code. l'API d'aide contextuelle pour
.NET prend en charge les langages Visual C++ .NET, ASP .NET, Visual Basic .NET et C# .NET.
l'API partage les param&egrave;tres avec HTML Help et WinHelp. Les fen&ecirc;tres personnalis&eacute;es sont prises en
charge. l'aide contextuelle fonctionne sans modification.
Importez le fichier de la langue ad&eacute;quate stock&eacute; dans le dossier correspondant &agrave; l'emplacement suivant :
C:\Program Files\Adobe\Adobe RoboHelp [version]\CSH API
C# .NET
C# .NET est un langage orient&eacute; objet offrant aux d&eacute;veloppeurs C et C++ une transition vers le nouvel
environnement .NET tout en assurant l'int&eacute;gration aux applications existantes. Les composants peuvent
&ecirc;tre convertis au format XML et appel&eacute;s &agrave; l'aide de tous les langages et sur tous les syst&egrave;mes
d'exploitation.
ASP .NET
ASP .NET fait partie de l'architecture .NET pour la cr&eacute;ation d'applications Web et de services Web XML.
Les pages ASP .NET utilisent un mod&egrave;le de programmation compil&eacute; et bas&eacute; sur des &eacute;v&eacute;nements
permettant de g&eacute;n&eacute;rer des balises au format HTML, WML ou XML. Ce mod&egrave;le permet &eacute;galement la
s&eacute;paration de la logique d'application et de l'interface utilisateur. Vous pouvez utiliser n'importe quel
langage .NET, comme Visual Basic .NET ou C# .NET, pour cr&eacute;er des pages ASP .NET et des fichiers de
services Web AS P.NET XML contenant une logique c&ocirc;t&eacute; serveur.
Appel de l'aide
Veillez &agrave; ce que l'aide en ligne soit sp&eacute;cifi&eacute;e dans les appels &agrave; RH_Showhelp. Lorsqu'un appel vers le
syst&egrave;me distant est effectu&eacute;, la version de l'aide en ligne s'affiche. Si la connexion Internet ne peut pas
&ecirc;tre &eacute;tablie, l'aide hors ligne s'affiche.
358
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
CHAPITRE 11
Appel d'aide contextuelle pour WebHelp ou FlashHelp depuis C# .NET
1)
2)
Ajoutez le fichier RoboHelp_CSH.cs au projet.
Appelez la fonction RH_ShowLocalHelp (hParent, strtHelpURL, strWndName,
nCommand, nData).
Param&egrave;tre
Type de donn&eacute;es
Description
hParent
Objet
Poign&eacute;e de la fen&ecirc;tre parent.
strHelpURL
Cha&icirc;ne
Source d'aide pour WebHelp ; indique le chemin d'acc&egrave;s &agrave;
la page de d&eacute;marrage du projet.
strWndName
string
Nom de la fen&ecirc;tre &agrave; ouvrir.
nCommand
Int
Constantes de classe.
OptionConstants.CSH_DISPLAY_CONTEXT
Ouvre la rubrique associ&eacute;e &agrave; l'ID de mappage dans le
param&egrave;tre nData.
OptionConstants.CSH_DISPLAY_TOC
Affiche le volet de table des mati&egrave;res et la rubrique
par d&eacute;faut.
OptionConstants.CSH_DISPLAY_INDEX
Affiche le volet d'index et la rubrique par d&eacute;faut.
OptionConstants.CSH_DISPLAY_SEARCH
Affiche le volet de recherche et la rubrique par d&eacute;faut.
nData
Int
Affiche l'ID de mappage de la rubrique. Pour obtenir l'ID de
mappage, vous pouvez exporter le fichier de mappage
correspondant &agrave; un langage de programmation en utilisant
OptionConstants.CSH_DISPLAY_CONTEXT dans nCommand.
Appel d'aide contextuelle pour WebHelp Pro ou FlashHelp Pro depuis C# .NET
1)
2)
Ouvrez VisualStudio.
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez Fichier &gt; Nouveau &gt; Projet.
–
Ouvrez un projet C# .NET.
3)
4)
Ajoutez un bouton intitul&eacute; Aide.
Acc&eacute;dez aux fichiers de prise en charge de l'aide contextuelle dans C:\Program Files\[dossier
d'installation de RoboHelp]\CSH API\CS.NET.
Copiez le fichier RoboHelp_CSH.cs.
5)
359
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
CHAPITRE 11
6)
7)
8)
9)
10)
11)
Collez les fichiers dans le projet C#.NET.
Cliquez avec le bouton droit de la souris sur le dossier R&eacute;f&eacute;rence. S&eacute;lectionnez Ajouter la r&eacute;f&eacute;rence.
Dans l'onglet .Net, s&eacute;lectionnez System.Web.Services.Dll.
Cliquez sur OK.
Cliquez avec le bouton droit de la souris sur le dossier R&eacute;f&eacute;rence. S&eacute;lectionnez Ajouter la r&eacute;f&eacute;rence.
S&eacute;lectionnez
c:\windows\system32\msxml2.dll
12)
13)
14)
15)
16)
Cliquez sur OK.
Cliquez deux fois sur le bouton Aide.
Copiez l'exemple de code d'aide contextuelle C# .NET et collez-le dans le code.
Ajoutez using RoboHelpAPI dans la partie sup&eacute;rieure du document.
Pour tester, compiler et ex&eacute;cuter le projet, s&eacute;lectionnez le bouton Aide.
Appel d'aide contextuelle pour WebHelp ou FlashHelp depuis ASP .NET
1)
2)
Ajoutez le fichier RoboHelp_CSH.cs au projet.
Appelez la fonction RH_ShowLocalHelp (hParent, strtHelpURL, strWndName,
nCommand, nData).
Param&egrave;tre
Type de donn&eacute;es
Description
hParent
Objet
Poign&eacute;e de la fen&ecirc;tre parent.
strHelpURL
Cha&icirc;ne
Source d'aide pour WebHelp ; indique le chemin d'acc&egrave;s &agrave;
la page de d&eacute;marrage du projet.
strWndName
String
Nom de la fen&ecirc;tre &agrave; ouvrir.
nCommand
Int
Constantes de classe.
OptionConstants.CSH_DISPLAY_CONTEXT
Ouvre la rubrique associ&eacute;e &agrave; l'ID de mappage dans le
param&egrave;tre nData.
OptionConstants.CSH_DISPLAY_TOC
Affiche le volet de table des mati&egrave;res et la rubrique
par d&eacute;faut.
OptionConstants.CSH_DISPLAY_INDEX
Affiche le volet d'index et la rubrique par d&eacute;faut.
OptionConstants.CSH_DISPLAY_SEARCH
Affiche le volet de recherche et la rubrique par d&eacute;faut.
360
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
CHAPITRE 11
Param&egrave;tre
nData
Type de donn&eacute;es
Int
Description
Affiche l'ID de mappage de la rubrique. Pour obtenir l'ID de
mappage, vous pouvez exporter le fichier de mappage
correspondant &agrave; un langage de programmation en utilisant
OptionConstants.CSH_DISPLAY_CONTEXT dans nCommand.
Appel d'aide contextuelle pour WebHelp Pro ou FlashHelp Pro depuis ASP .NET
1)
2)
Ouvrez VisualStudio .NET.
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez Fichier &gt; Nouveau &gt; Projet.
–
Ouvrez un projet ASP.NET.
3)
Acc&eacute;dez aux fichiers de prise en charge de l'aide contextuelle dans C:\Program Files\[dossier
d'installation de RoboHelp]\CSH API\ASP.NET.
Copiez le fichier RoboHelp_CSH.cs.
Collez les fichiers de support dans le projet ASP.NET.
Cliquez avec le bouton droit de la souris sur le dossier R&eacute;f&eacute;rence. S&eacute;lectionnez Ajouter la r&eacute;f&eacute;rence.
Dans l'onglet .Net, s&eacute;lectionnez System.Web.Services.Dll.
Cliquez sur OK.
Ajoutez un bouton dans l'application.
Cliquez deux fois sur le bouton.
Copiez l'exemple de code d'aide contextuelle ASP.NET. Collez-le dans le code.
Dans le code, ajoutez using RoboHelpAPI.
Pour tester l'aide, compilez et ex&eacute;cutez le projet. S&eacute;lectionnez le bouton Aide.
4)
5)
6)
7)
8)
9)
10)
11)
12)
13)
Appel d'aide contextuelle pour WebHelp ou FlashHelp depuis Visual Basic .NET
1)
2)
Ajoutez le fichier RoboHelp_CSH.vb au projet.
Appelez la fonction RH_ShowLocalHelp (hParent, strtHelpURL, strWndName,
nCommand, nData).
Param&egrave;tre
Type de donn&eacute;es
Description
hParent
Objet
Poign&eacute;e de la fen&ecirc;tre parent.
strHelpURL
Cha&icirc;ne
Source d'aide pour WebHelp ; indique le chemin d'acc&egrave;s &agrave;
la page de d&eacute;marrage du projet.
strWndName
string
Nom de la fen&ecirc;tre &agrave; ouvrir.
361
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
CHAPITRE 11
Param&egrave;tre
nCommand
Type de donn&eacute;es
Int
Description
Constantes de classe.
CSH_DISPLAY_CONTEXT
Ouvre la rubrique associ&eacute;e &agrave; l'ID de mappage dans le
param&egrave;tre nData.
CSH_DISPLAY_TOC
Affiche le volet de table des mati&egrave;res et la rubrique
par d&eacute;faut.
CSH_DISPLAY_INDEX
Affiche le volet d'index et la rubrique par d&eacute;faut.
CSH_DISPLAY_SEARCH
Affiche le volet de recherche et la rubrique par
d&eacute;faut.
nData
Int
Affiche l'ID de mappage de la rubrique. Pour obtenir l'ID
de mappage, vous pouvez exporter le fichier de mappage
correspondant &agrave; un langage de programmation en
utilisant CSH_DISPLAY_CONTEXT dans nCommand.
Appel d'aide contextuelle pour WebHelp Pro ou FlashHelp Pro depuis Visual Basic . NET
1)
2)
Ouvrez VisualStudio.NET.
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
S&eacute;lectionnez Fichier &gt; Nouveau &gt; Projet.
–
Ouvrez un projet Visual Basic .NET.
3)
4)
5)
6)
7)
8)
9)
Copiez le fichier RoboHelp_CSH.vb.
Collez les fichiers de support dans le projet ASP.NET.
Cliquez avec le bouton droit de la souris sur le dossier R&eacute;f&eacute;rence. S&eacute;lectionnez Ajouter la r&eacute;f&eacute;rence.
Dans l'onglet .Net, s&eacute;lectionnez System.Web.Services.Dll.
Cliquez sur OK.
Cliquez avec le bouton droit de la souris sur le dossier R&eacute;f&eacute;rence. S&eacute;lectionnez Ajouter la r&eacute;f&eacute;rence.
S&eacute;lectionnez :
msxml2.dll
10) Cliquez sur OK.
11) Ajoutez un bouton dans l'application.
12) Cliquez deux fois sur le bouton.
362
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
CHAPITRE 11
13) Copiez l'exemple de code d'aide contextuelle Visual Basic .NET et collez-le dans le code.
14) Pour tester l'aide, compilez et ex&eacute;cutez le projet. S&eacute;lectionnez le bouton Aide.
Recherche de RoboHelp Server avec les exemples .NET
1)
S&eacute;lectionnez l'exemple correspondant au langage d'application.
Nom
Langue
Exemple RoboHelp Server CSH.NET VC
Visual C++ .NET
Exemple RoboHelp CSH.NET VB
Visual Basic .NET
Exemple RoboHelp CSH.NET C#
C# .NET
Sp&eacute;cification d'une URL (WebHelp Pro)
1)
Dans les exemples de codes, recherchez la cha&icirc;ne portant le nom suivant :
m_strServer
2)
Attribuez l'adresse du serveur sur m_strServer :
http://server.com/robohelp/rest
3)
Indiquez un nom de projet.
m_strProject = P1
4)
Indiquez le nom de la fen&ecirc;tre dans la variable m_strParamValue.
REMARQUE : STRPRIMARY indique le syst&egrave;me d'aide principal et STRBACKUP indique le syst&egrave;me d'aide
local. Pour les langages Visual Basic .NET, Visual C++ .NET et C# .NET, l'application r&eacute;side sur le client,
permettant l'utilisation d'un syst&egrave;me d'aide en ligne et d'un syst&egrave;me d'aide hors ligne. Pour ASP .NET,
toutes les informations r&eacute;sident sur un serveur Web. Sp&eacute;cifiez un syst&egrave;me d'aide en ligne WebHelp Pro
en tant que syst&egrave;me d'aide principal et un syst&egrave;me d'aide en ligne WebHelp en tant que sauvegarde.
Services Web fournis par RoboHelp Server avec .NET
RoboHelp Server fournit les deux services suivants faisant appel aux services Web REST.
Robowindow
N&eacute;cessite la recherche des propri&eacute;t&eacute;s de fen&ecirc;tre et de l'URL d'aide contextuelle &agrave; partir du serveur.
Reportez-vous &agrave; la rubrique D&eacute;tails du code du service Web de recherche.
Recherche
Ex&eacute;cute les recherches de phrase et renvoie les r&eacute;sultats. Reportez-vous &agrave; la rubrique D&eacute;tails du
code du service Web de recherche.
363
CHAPITRE 11
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
Etapes sans utiliser les fichiers de support
WebHelp Pro
WebHelp Pro est un type de sortie non compil&eacute;, bas&eacute; sur RoboHelp Server qui prend en charge les
fonctionnalit&eacute;s standard des syst&egrave;mes d'aide (table des mati&egrave;res, index et recherche). La sortie peut
s'afficher sans navigateur. De plus, WebHelp Pro propose des rapports de commentaires des utilisateurs
finals sur l'utilisation du syst&egrave;me ainsi que des autres fonctionnalit&eacute;s propres &agrave; RoboHelp Server. Les
projets WebHelp Pro requi&egrave;rent RoboHelp Server pour l'aide contextuelle.
Affichage de contenu
l'affichage de contenu s'effectue &agrave; l'aide du fichier ASP inclus. l'hyperlien par d&eacute;faut est http://&lt;RoboHelp
Server&gt;/Roboapi.Asp. Vous pouvez transmettre un param&egrave;tre vers le fichier ASP :
•
project=Nom_Projet
•
context=Num&eacute;roMappage
•
url=URL
Exemple :
•
Cette URL affiche le contenu par d&eacute;faut du serveur : http://&lt;RoboHelp Server&gt;/Roboapi.Asp
•
Cette URL affiche le projet nom_projet (fusionn&eacute; avec tout autre projet) : http://&lt;RoboHelp
Server&gt;/robohelp/rest/search?project=&lt;nom-projet&gt;&amp;quesn=&lt;requ&ecirc;te-recherche&gt;
•
Cette URL affiche le contenu pour le num&eacute;ro de mappage 101 : http://&lt;RoboHelp Server&gt;/
/robohelp/rest/robowindow?wtype=ctx&amp;context=&lt;id&gt;&amp;project=&lt;nom projet&gt;
Contr&ocirc;le de fen&ecirc;tre avanc&eacute;
Lorsque vous affichez un syst&egrave;me d'aide contextuelle WebHelp Pro depuis un navigateur, utilisez l'API
d'aide contextuelle et les fichiers de support.
WebHelp
Aide contextuelle pour les applications Visual Basic
Utilisez ces informations pour connecter des rubriques contextuelles WebHelp ou WebHelp Pro &agrave; des
applications Visual Basic.
Cet exemple de code utilise la fonction Showhelp qui ouvre une rubrique locale ou distante quel que
soit le type de navigateur.
La fonction ShowHelp poss&egrave;de deux param&egrave;tres : strTopic, qui prend pour valeur une URL ou un nom
de fichier local, et bIsLocal, qui prend une valeur bool&eacute;enne. Elle indique si le premier param&egrave;tre est
un nom de fichier local (TRUE) ou une URL distante (FALSE). Si le fichier est local, ShowHelp demande
au navigateur de le rechercher dans le sous-dossier d'aide du dossier de l'application.
Public Function ShowHelp(strTopic As String, _
bIsLocal As Boolean) As Boolean
Dim strDir As String
If bIsLocal Then
' Get registry entry pointing to Help
364
CHAPITRE 11
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
strDir = App.Path + &quot;\Help\&quot;
End If
' Launch topic
Dim hinst As Long
hinst = ShellExecute(Me.hwnd, vbNullString, _
strTopic, vbNullString, _
strDir, SW_SHOWNORMAL)
' Handle less than 32 indicates failure
ShowHelp = hinst &gt; 32
End Function
Pour appeler ShellExecute, d&eacute;clarez la fonction. Par exemple :
Private Declare Function ShellExecute Lib _
&quot;shell32.dll&quot; Alias &quot;ShellExecuteA&quot; _
(ByVal hwnd As Long, _
ByVal lpOperation As String, _
ByVal lpFile As String, _
ByVal lpParameters As String, _
ByVal lpDirectory As String, _
ByVal nShowCmd As Long) As Long
La fonction ShowHelp n&eacute;cessite un nom de fichier ou une URL explicite. Il est n&eacute;anmoins recommand&eacute;
pour l'aide contextuelle d'utiliser des ID de contexte au lieu de noms de rubrique explicites pour coder
l'application. Utilisez l'exemple de fonction suivant, ShowHelpContext, qui mappe les ID de contexte
entiers sur les cha&icirc;nes de nom de rubrique et appelle ensuite ShowHelp pour ouvrir la rubrique.
Public Function ShowHelpContext(nContextId As Integer) As Boolean
Dim strTopic As String
Dim bIsLocal As Boolean
bIsLocal = True
Select Case nContextId
Case HH_GADGET_DIALOG
strTopic = &quot;gadget.htm&quot;
Case HH_WHATSIT_DIALOG
strTopic = &quot;whatsit.htm&quot;
Case HH_WIDGET_DIALOG
strTopic = &quot;widget.htm&quot;
Case HH_TECH_SUPPORT:
strTopic = &quot;http://www.mycompany.com&quot;
bIsLocal = False
Case Else
strTopic = &quot;unknown-context.htm&quot;
End Select
ShowHelpContext = ShowHelp(strTopic, bIsLocal)
End Function
..............................................................................................................................................
365
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
CHAPITRE 11
L'utilisation de la fonction ShowHelpContext facilite la gestion de l'aide contextuelle. En effet, si un
nom de rubrique change, seule une fonction doit &ecirc;tre modifi&eacute;e. D&eacute;clarez les ID de contexte (par exemple,
HH_GADGET_DIALOG) en tant que constantes pouvant &ecirc;tre partag&eacute;es entre les modules du programme
utilisant l'aide contextuelle WebHelp ou WebHelp Pro.
Const
Const
Const
Const
HH_GADGET_DIALOG As Integer = 1
HH_WHATSIT_DIALOG As Integer = 2
HH_WIDGET_DIALOG As Integer = 3
HH_TECH_SUPPORT As Integer = 4
Connexion de rubriques contextuelles WebHelp et WebHelp Pro &agrave; des applications Visual C++
REMARQUE : Ces informations s'adressent aux d&eacute;veloppeurs souhaitant lier des rubriques d'aide
contextuelle WebHelp et WebHelp Pro &agrave; des applications Visual C++.
L'exemple de code fourni utilise la fonction ShowHelp qui ouvre une rubrique locale ou distante quel
que soit le type de navigateur.
La fonction ShowHelp poss&egrave;de deux param&egrave;tres : szTopic, qui prend pour valeur une URL ou un nom
de fichier local, et bIsLocal, qui prend une valeur bool&eacute;enne. Elle indique si le premier param&egrave;tre est
un nom de fichier local (TRUE) ou une URL distante (FALSE). Si le fichier est local, ShowHelp demande
au navigateur de le rechercher dans le sous-dossier d'aide du dossier de l'application.
BOOL ShowHelp(LPCTSTR szTopic, BOOL bIsLocal)
{
TCHAR szDir[MAX_PATH] = &quot;&quot;;
if (bIsLocal)
{
// Get directory of application
DWORD dw = GetModuleFileName(AfxGetInstanceHandle(), szDir, MAX_PATH);
TCHAR* pchEnd = _tcsrchr(szDir, '\\') + 1;
ASSERT_POINTER(pchEnd, TCHAR);
*pchEnd = '\0';
// Append subfolder name
_tcscat(szDir, _T(&quot;Help&quot;));
}
// Open topic
HINSTANCE hinst = ShellExecute(NULL, //no parent hwnd
NULL, // open
szTopic, // topic file or URL
NULL, // no parameters
szDir, // folder containing file
SW_SHOWNORMAL); // yes, show it
// handle less than 32 indicates failure
return hinst &gt; (HINSTANCE)32;
}
.......................................................................................................................................
366
CHAPITRE 11
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
La fonction ShowHelp n&eacute;cessite un nom de fichier ou une URL explicite. Il est n&eacute;anmoins recommand&eacute;
pour l'aide contextuelle d'utiliser des ID de contexte au lieu de noms de rubrique explicites pour coder
l'application. Utilisez l'exemple de fonction suivant, ShowHelpContext, qui mappe les ID de contexte
entiers sur les cha&icirc;nes de nom de rubrique et appelle ensuite ShowHelp pour ouvrir la rubrique.
BOOL ShowHelpContext(int nContextId)
{
CString strTopic;
BOOL bIsLocal = TRUE;
switch (nContextId)
{
case HH_GADGET_DIALOG:
strTopic = _T(&quot;gadget.htm&quot;);
break;
case HH_WHATSIT_DIALOG:
strTopic = _T(&quot;whatsit.htm&quot;);
break;
case HH_WIDGET_DIALOG:
strTopic = _T(&quot;widget.htm&quot;);
break;
case HH_TECH_SUPPORT:
strTopic = _T(&quot;http://www.mycompany.com&quot;);
bIsLocal = FALSE;
break;
default:
strTopic = _T(&quot;unknown-context.htm&quot;);
break;
}
return ShowHelp(strTopic, bIsLocal); }
...........................................................................................................................................
L'utilisation de la fonction ShowHelpContext facilite la gestion de l'aide contextuelle. En effet, si un
nom de rubrique change, seule une fonction doit &ecirc;tre modifi&eacute;e. Les ID de contexte (par exemple,
HH_GADGET_DIALOG) doivent &ecirc;tre d&eacute;clar&eacute;s dans un fichier d'en-t&ecirc;te pouvant &ecirc;tre partag&eacute; entre les
modules du programme utilisant l'aide contextuelle WebHelp ou WebHelp Pro. Il peut s'agir du fichier
dans lequel sont d&eacute;finis les prototypes des fonctions ShowHelp et ShowHelpContext.
367
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
CHAPITRE 11
Programmation de HTML Help dans les applications
REMARQUE : Projets Microsoft HTML Help uniquement.
Aide sur les fen&ecirc;tres pour les applications Windows
•
Pour appeler une rubrique &agrave; l'aide d'un num&eacute;ro de mappage, appelez l'API HTML Help &agrave; l'aide de la
syntaxe suivante :
HWND HtmlHelp(Window(), “c:\path\helpfile.chm”, HH_HELP_CONTEXT,
Number);
•
Pour appeler une rubrique &agrave; l'aide d'un nom de fichier, appelez l'API HTML Help &agrave; l'aide de la
syntaxe suivante :
HWND HtmlHelp (Dialog(), “c:\path\helpfile.chm”, HH_DISPLAY_TOPIC,
&quot;topicfile.htm&quot;);
Qu'est-ce que c'est ? Aide pour les applications Windows
La m&eacute;thode de programmation d'aide Qu'est-ce que c'est ? d&eacute;pend du mode de cr&eacute;ation de l'aide
contextuelle.
•
Si l'aide a &eacute;t&eacute; cr&eacute;&eacute;e dans RoboHelp sous forme de fichiers de rubrique textuelle, consultez le kit de
d&eacute;veloppement logiciel pour plus d'informations.
•
Si l'aide a &eacute;t&eacute; cr&eacute;&eacute;e dans le module de composition d'aide Qu'est-ce que c'est ?, voir Cr&eacute;ation
d'aides Qu'est-ce que c'est ? Aide.
REMARQUE : Pour plus d'informations, voir la r&eacute;f&eacute;rence de l'API d'aide HTML &agrave; l'adresse suivante :
http://msdn.microsoft.com/en-us/library/ms670068(VS.85).aspx.
Aide sur les fen&ecirc;tres pour les applications non-Windows
•
•
•
WebHelp permet d'afficher les rubriques d'aide contextuelle pour les applications C++ et Visual
Basic, les applications Java et les pages Web. Pour plus d'informations, voir WebHelp.
JavaHelp permet d'afficher les rubriques d'aide contextuelle pour les applications Java. Pour plus
d'informations, voir A propos de la cr&eacute;ation d'un syst&egrave;me d'aide contextuelle JavaHelp.
Oracle Help permet d'afficher des rubriques d'aide contextuelle pour les applications Java ou les
applications r&eacute;dig&eacute;es dans d'autres langages de programmation. Pour plus d'informations, voir
Cr&eacute;ation d'aide contextuelle Oracle Help.
REMARQUE : Si vous devez utiliser la sortie HTML Help en tant que sauvegarde d'un syst&egrave;me WebHelp,
WebHelp Pro, FlashHelp ou FlashHelp Pro r&eacute;sidant sur un serveur, utilisez le syst&egrave;me d'aide mixte (local
et en ligne) d'Adobe.
Appel de fonction d'aide contextuelle HTML Help
Exemple de code :
HtmlHelp(hWnd,
&quot;CSHHelp.chm&quot;,
HH_HELP_CONTEXT,
dwMapNumber);
/*Window handle of program or dialog*/
/*Name of the CHM file*/
/*Map number from map file*/
368
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
CHAPITRE 11
HtmlHelp(hWnd
Poign&eacute;e de fen&ecirc;tre du programme ou de la bo&icirc;te de dialogue. Une poign&eacute;e de fen&ecirc;tre identifie une
fen&ecirc;tre de mani&egrave;re &agrave; permettre au moteur HTML Help de d&eacute;terminer l'application &agrave; l'origine de
l'op&eacute;ration.
CSHHelp.chm
Fichier d'aide HTML compil&eacute;. Ce fichier inclut des rubriques d'aide contextuelle. Transmettez-le au
d&eacute;veloppeur pour l'inclure &agrave; l'application.
HH_HELP_CONTEXT
Commande envoy&eacute;e au moteur HTML Help pour l'affichage des rubriques d'aide sur les fen&ecirc;tres.
(une commande du type HH_TP_HELP_WM_HELP est utilis&eacute;e pour Aide.)
Dwmapnumber
Num&eacute;ro de mappage du fichier de mappage
D&eacute;pannage : aide sur les fen&ecirc;tres
REMARQUE : Projets Microsoft HTML Help uniquement.
Probl&egrave;me
Une rubrique d'aide incorrecte s'ouvre.
Message d'erreur
Command: HH_HELP_CONTEXT
Traitement de C:\Dossier Projet\ProjetAide.chm
Map Number: 2750
Fichier : Nom_Dossier\Nom_Rubrique.htm
Origine
ID de mappage incorrect.
R&eacute;solution
Mettez &agrave; jour l'ID de mappage.
G&eacute;n&eacute;rez le projet et r&eacute;p&eacute;tez le test.
OU :
Origine
Fichier de mappage incorrect ou obsol&egrave;te.
R&eacute;solution
V&eacute;rifiez que chacun utiliser le fichier de mappage ad&eacute;quat.
Si le fichier de mappage utilise est correct, annulez l'assignation de l'ID
de mappage pour la rubrique.
Supprimez l'ancien fichier de mappage et importez le nouveau.
Assignez les nouveaux ID de mappage.
G&eacute;n&eacute;rez le projet et r&eacute;p&eacute;tez le test.
369
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
CHAPITRE 11
Probl&egrave;me
La rubrique ne s'affiche pas.
Message d'erreur
1. Pas de message
2. Commande : HH_HELP_CONTEXT
R&eacute;sultat : HH_HELP_CONTEXT appel&eacute; sans section [Map]
3. Commande : HH_HELP_CONTEXT
Traitement de C:\Nom Dossier\Nom_Projet.chm
R&eacute;sultat : 180010 introuvable dans C:\Nom Dossier\Nom_Projet.chm
Origine
Aucun ID de mappage assign&eacute;.
R&eacute;solution
Si le fichier de mappage n'existe pas, un message indique que la
commande &laquo; HH_HELP_CONTEXT &raquo; a &eacute;t&eacute; appel&eacute;e sans section [Map].
Dans le cas des fichiers de mappage fournis par le d&eacute;veloppeur,
importez le fichier de mappage. Assignez les ID de mappage.
Si un message indique que 180010 est introuvable dans C:\Nom
Dossier\Nom_Projet.chm, mettez &agrave; jour l'ID de mappage.
G&eacute;n&eacute;rez le projet et r&eacute;p&eacute;tez le test.
Probl&egrave;me
La rubrique ne s'affiche pas ou la rubrique affich&eacute;e est incorrecte.
Message d'erreur
1. Commande : HH_HELP_CONTEXT
Traitement de C:\Dossier Projet\Nom_Projet.chm
Num&eacute;ro de mappage : 1
Fichier : Nom_Dossier\Nom_Rubrique.htm
2. Commande : HH_HELP_CONTEXT
Traitement de C:\Dossier Projet\Nom_Projet.chm
R&eacute;sultat : 180010 introuvable dans C:\Dossier Projet\Nom_Projet.chm
Origine
Le num&eacute;ro de mappage utilis&eacute; dans l'appel est incorrect.
R&eacute;solution
Imprimez le rapport sur les ID de mappage et transmettez-le au
d&eacute;veloppeur.
Utilisez ce fichier pour corriger les num&eacute;ros de mappage assign&eacute;s.
Probl&egrave;me
La rubrique s'affiche dans une bo&icirc;te de dialogue incorrecte.
Message d'erreur
HTML Auteur s'ouvre et affiche un message indiquant que la fen&ecirc;tre
appel&eacute;e 'fen&ecirc;tre' indiqu&eacute;e pour HH_GET_WIN_TYPE n'a pas &eacute;t&eacute; sp&eacute;cifi&eacute;e.
Origine
Le nom de bo&icirc;te de dialogue utilis&eacute; dans l'appel est incorrect ou
l'auteur n'a pas indiqu&eacute; au d&eacute;veloppeur qu'une fen&ecirc;tre personnalis&eacute;e a
&eacute;t&eacute; cr&eacute;&eacute;e pour les rubriques.
R&eacute;solution
Indiquez au d&eacute;veloppeur qu'il existe des bo&icirc;tes de dialogue
personnalis&eacute;es.
G&eacute;n&eacute;rez le projet et r&eacute;p&eacute;tez le test une fois l'application mise &agrave; jour.
370
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
CHAPITRE 11
Probl&egrave;me
La rubrique ne s'affiche pas.
Message d'erreur
1. Aucun message affich&eacute;
2. Commande : HH_HELP_CONTEXT
R&eacute;sultat : HH_HELP_CONTEXT appel&eacute; sans section [Map]
Origine
Fichier de mappage ou num&eacute;ro de mappage manquant.
R&eacute;solution
Dans le cas d'un fichier de mappage fourni par le d&eacute;veloppeur,
restaurez ou mettez &agrave; jour le fichier de mappage.
G&eacute;n&eacute;rez le projet et r&eacute;p&eacute;tez le test.
A propos de la cr&eacute;ation d'un syst&egrave;me d'aide contextuelle JavaHelp
ASTUCE : Utilisez l'API d'aide contextuelle et les fichiers de support pour appeler une fonctionnalit&eacute;
int&eacute;gr&eacute;e, plut&ocirc;t que de cr&eacute;er des fonctions d'affichage des rubriques.
Pour cr&eacute;er un syst&egrave;me d'aide contextuelle JavaHelp, il vous faut un code personnalis&eacute; mis au point par
votre d&eacute;veloppeur.
Pour aider ce dernier &agrave; &eacute;laborer ce code, fournissez-lui une copie imprim&eacute;e du fichier JHM.
Exemple :
public class ContextHelp
{
private HelpSet hs;
private HelpBroker hb;
public boolean ShowHelp(String strTopic, String strHelpSet){
if (hb == null) {
ClassLoader loader = getClass().getClassLoader();
URL url;
try {
url = HelpSet.findHelpSet(loader, strHelpSet);
hs = new HelpSet(loader, url);
}
catch (Exception e) {
return false;
}
hb = hs.createHelpBroker();
}
hb.setCurrentID(strTopic);
hb.setDisplayed(true);
return true;
}
}
371
CHAPITRE 11
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
Test d'un syst&egrave;me d'aide contextuelle JavaHelp
Les auteurs et les d&eacute;veloppeurs participent au test d'un syst&egrave;me d'aide contextuelle JavaHelp.
Compression du projet
Compilez le projet et cr&eacute;ez un fichier .JAR. Transmettez le fichier JAR au d&eacute;veloppeur.
Test des rubriques contextuelles
Testez les rubriques dans l'application pour v&eacute;rifier qu'elles apparaissent dans les fen&ecirc;tres et bo&icirc;tes
de dialogue appropri&eacute;es.
R&eacute;solution des erreurs
Collaborez avec votre d&eacute;veloppeur pour r&eacute;soudre toute erreur.
Cr&eacute;ation d'aide contextuelle Oracle Help
REMARQUE : Cette rubrique s'adresse aux d&eacute;veloppeurs souhaitant lier des rubriques d'aide contextuelle
Oracle Help &agrave; des applications.
ASTUCE : Utilisez l'API d'aide contextuelle et les fichiers de support pour appeler une fonctionnalit&eacute;
int&eacute;gr&eacute;e, plut&ocirc;t que de cr&eacute;er des fonctions d'affichage des rubriques.
Oracle Help prend en charge l'aide contextuelle. Vous devrez toutefois faire appel &agrave; un d&eacute;veloppeur pour
qu'il r&eacute;dige et modifie le code afin qu'elle puisse fonctionner.
Vous trouverez ci-apr&egrave;s un exemple d'application Java utilisant l'aide contextuelle. Pour ex&eacute;cuter
l'exemple :
1) V&eacute;rifiez que les composants Oracle Help pour Java et que le SDK Sun Java 2 ou une version
sup&eacute;rieure, sont install&eacute;s.
2) Copiez le code ci-dessous et collez-le dans un fichier nomm&eacute; CSHDemo.java.
3) Compilez le fichier (par exemple, javac CSHDemo.java).
4) Ex&eacute;cutez l'applet Java (par exemple, java .cSHDemo &lt;fichier Oracle Help Helpset&gt;). Le param&egrave;tre de
fichier Helpset Oracle Help est le chemin d'acc&egrave;s complet au fichier Helpset. Par exemple, si vous
cr&eacute;ez un fichier Oracle Help Helpset nomm&eacute; sample.hs que vous enregistrez dans C:\mesFichiers,
la commande permettant d'ex&eacute;cuter cette application avec votre fichier Helpset aura la syntaxe
suivante :
java CSHDemo C:\myFiles\Sample.hs
Exemple d'application Java contextuelle
/**********************************************************************
***********
* Exemple d'application d'aide contextuelle Oracle Help
*
* Cette application a pour objectif de pr&eacute;senter plusieurs m&eacute;thodes d'appel
* d'aide contextuelle avec Oracle Help.
*
*USAGE: CSHSample &lt;chemin d'acc&egrave;s complet au fichier Helpset&gt;
*
372
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
CHAPITRE 11
************************************************************************
*********/
import oracle.help.Help;
import oracle.help.CSHManager;
import oracle.help.library.Book;
import oracle.help.library.helpset.HelpSet;
import oracle.help.navigator.Navigator;
import java.awt.*;
import java.awt.event.*;
import java.net.URL;
public class CSHSample extends Frame implements ActionListener
{
private Help helpObj;
private Book bookObj;
private CSHManager contextManager;
private MenuItem exitMenu;
private MenuItem contentsMenu;
private MenuItem searchMenu;
private MenuItem indexMenu;
// Constants set to TopicIDs from map file for Helpset passed in
// via command line.
public static final String LABEL = &quot;what_is_a_label_htm&quot;;
public static final String FIELD = &quot;what_is_a_text_field_htm&quot;;
public static void main(String[] args)
{
if (args.length != 1) {
System.err.println(&quot;Usage: CSHSample &lt;chemin d'acc&egrave;s complet au
fichier Helpset&gt;&quot;);
System.exit(1);
}
Book bookObj = null;
String filename = args[0];
// Expects filename format to be:
&quot;file:/[&lt;lecteur&gt;:/]dir/&lt;fichier_helpset&gt;&quot;
// e.g., &quot;file:/c:/myPath/myHelp.hs&quot;
if (filename.charAt(0) == '/')
filename = &quot;file:&quot; + filename;
else
filename = &quot;file:/&quot; + filename;
try {
bookObj = (Book) new HelpSet(new URL(filename));
}
catch (Exception e) {
System.err.println(&quot;CSHSample Error: &quot; + e.getMessage());
373
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
CHAPITRE 11
System.exit(1);
}
CSHSample sampApp = new CSHSample(bookObj);
sampApp.setVisible(true);
}
// Class Constructor
public CSHSample(Book bookObj)
{
super(&quot;CSH Sample Application&quot;);
setResizable(false);
setSize(300, 200);
// Create Help Objects
try {
helpObj = new Help(false, false);
contextManager = new CSHManager(helpObj);
contextManager.addBook(bookObj, true);
}
catch (Exception e) {
System.err.println(&quot;CSHSample:: Failed While Creating Help object&quot;);
e.printStackTrace();
System.exit(1);
}
/********************************************************************
* Add UI Components
*******************************************************************/
MenuBar menubar = new MenuBar();
Menu filemenu = new Menu(&quot;File&quot;);
exitMenu = new MenuItem(&quot;Exit&quot;);
filemenu.add(exitMenu);
exitMenu.addActionListener(this);
menubar.add(filemenu);
Menu helpmenu = new Menu(&quot;Help&quot;);
contentsMenu = new MenuItem(&quot;Help Contents&quot;);
contentsMenu.addActionListener(this);
helpmenu.add(contentsMenu);
indexMenu = new MenuItem(&quot;Topic Index&quot;);
indexMenu.addActionListener(this);
helpmenu.add(indexMenu);
searchMenu = new MenuItem(&quot;Full Text Search&quot;);
searchMenu.addActionListener(this);
helpmenu.add(searchMenu);
menubar.add(helpmenu);
374
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
CHAPITRE 11
setMenuBar(menubar);
Panel mainPanel = new Panel();
add(mainPanel, BorderLayout.CENTER);
// Add label
Label label = new Label(&quot;Country:&quot;, Label.LEFT);
mainPanel.add(label);
// Set context help for component. TopicID = LABEL
// Pass the component with the associated TopicID to the CSHManager
Object
contextManager.addComponent(label, LABEL, true, true);
// Add TextField
TextField field = new TextField(15);
mainPanel.add(field);
// Set context help for component. TopicID = FIELD
// Pass the component with the associated TopicID to the CSHManager
Object
contextManager.addComponent(field, FIELD, true, true);
/********************************************************************
* End: Add UI Components
*******************************************************************/
addWindowListener(
new WindowAdapter()
{
public void windowClosing(WindowEvent e)
{
setVisible(false);
System.exit(0);
}
}
);
}
public void actionPerformed(ActionEvent e)
{
Object source = e.getSource();
if (source == exitMenu) {
375
INFORMATIONS &Agrave; L'ATTENTION DES D&Eacute;VELOPPEURS
AIDE CONTEXTUELLE
CHAPITRE 11
setVisible(false);
System.exit(0);
}
else if (source == contentsMenu) {
// Show Help; Display Contents tab
Navigator[] navs = contextManager.getAllNavigators();
if (navs != null)
contextManager.showNavigatorWindow(navs[0]);
}
else if (source == indexMenu) {
// Show Help; Display Index tab
Navigator[] navs = contextManager.getAllNavigators();
if (navs != null)
contextManager.showNavigatorWindow(navs[1]);
}
else if (source == searchMenu){
// Show Help; Display Search tab
Navigator[] navs = contextManager.getAllNavigators();
if (navs != null)
contextManager.showNavigatorWindow(navs[2]);
}
}
}
REMARQUE : Oracle Help utilise les ID de rubrique (dans un fichier de mappage) pour effectuer des appels
d'aide contextuelle. Pour modifier l'ID de rubrique, modifiez la balise META de la rubrique.
376
CHAPITRE 11
QU'EST-CE QUE C'EST ? AIDE
AIDE CONTEXTUELLE
11.6. Qu'est-ce que c'est ? Aide
A propos de l'outil de composition d'aide
L'outil de composition d'aide Qu'est-ce que c'est ? est install&eacute; avec RoboHelp. Il prend en charge le format
WinHelp r&eacute;dig&eacute; dans RoboHelp pour Word et Microsoft HTML Help.
Cet outil scanne les applications et g&eacute;n&egrave;re les projets. Il lit les fichiers du programme et cr&eacute;e des rubriques
d'aide contextuelle pour tous les champs et commandes situ&eacute;s &agrave; l'int&eacute;rieur de bo&icirc;tes de dialogue.
Il permet &eacute;galement d'ajouter des suggestions de texte &agrave; chaque rubrique d'aide, acc&eacute;l&eacute;rant ainsi le
processus de cr&eacute;ation.
Fichiers pris en charge pour Microsoft HTML Help :
•
Fichiers de programme (.EXE)
•
Biblioth&egrave;que de liens dynamiques (.DLL)
•
Contr&ocirc;les ActiveX (.OCX)
Vous pouvez ajouter des rubriques d'aide contextuelle &agrave; n'importe quel projet RoboHelp. Le r&eacute;sultat est
un fichier texte uniquement (Context.txt) qui contient le texte utilis&eacute; dans chaque rubrique d'aide
contextuelle que vous cr&eacute;ez.
Aide Qu'est-ce que c'est ? et Microsoft HTML Help
La cr&eacute;ation d'un projet d'aide Qu'est-ce que c'est ? pour Microsoft HTML Help implique les &eacute;tapes
suivantes :
•
Cr&eacute;ation d'un fichier Context.txt, qui contient les rubriques contextuelles.
•
Ajout du fichier Context.txt au projet.
•
Stockage du fichier Context.txt dans une base de donn&eacute;es qui est mise &agrave; jour lorsque vous modifiez
les rubriques.
•
Enregistrement des fichiers Dialog.cid et Context.h (contenant les ID de rubrique) dans le dossier du
projet. Utilisation de ces fichiers par le d&eacute;veloppeur.
•
Stockage du fichier Context.txt dans le dossier des fichiers d'aide Qu'est-ce que c'est ?, &agrave; l'int&eacute;rieur
du dossier Aide contextuelle. Cliquez deux fois sur le fichier Context.txt pour ouvrir le module de
composition d'aide Qu'est-ce que c'est ? afin de le modifier.
REMARQUE : Si vous supprimez l'un de ces fichiers du gestionnaire de projets, vous supprimerez alors le
projet d'aide Qu'est-ce que c'est ? du projet HTML Help.
377
CHAPITRE 11
QU'EST-CE QUE C'EST ? AIDE
AIDE CONTEXTUELLE
Fonctionnement de l'aide Qu'est-ce que c'est ? pour les aides contextuelles
•
•
•
Ouvrez le projet HTML Help, puis s&eacute;lectionnez le fichier pour l'ouvrir dans le module de composition
d'aide Module de composition d'aide
Lors de la compilation du projet HTML Help, les rubriques contextuelles sont compil&eacute;es dans le
projet sous forme d'&eacute;l&eacute;ment du fichier CHM.
Reportez-vous au syst&egrave;me d'aide en ligne du module de composition d'aide Qu'est-ce que c'est ?
Cr&eacute;ation d'aides Qu'est-ce que c'est ? Aide
1)
2)
3)
Ouvrez le projet RoboHelp.
S&eacute;lectionnez Fichier &gt; Nouveau &gt; Projet d'aide Qu'est-ce que c'est ?.
S&eacute;lectionnez une application. Il s'agit du nom du fichier ex&eacute;cutable (.exe), de la biblioth&egrave;que de
liens dynamiques (.dll) ou du contr&ocirc;le ActiveX (.ocx).
4) Cliquez sur Parcourir. Sous Fichiers de type, s&eacute;lectionnez un format de fichier.
5) Acc&eacute;dez au dossier dans lequel l'application est stock&eacute;e. Cliquez deux fois sur le fichier d'application
pour le s&eacute;lectionner.
6) Cliquez sur Suivant. Le nom et l'emplacement du fichier de projet apparaissent.
Tous les projets de composition d'aide Qu'est-ce que c'est ? sont intitul&eacute;s Context.txt et sont
enregistr&eacute;s dans le m&ecirc;me dossier que votre projet HTML Help.
7) Cliquez sur Suivant. Les noms de tous les fichiers contenant les bo&icirc;tes de dialogue de l'application
apparaissent. Ces fichiers sont plac&eacute;s dans le m&ecirc;me dossier que l'application (ou sont appel&eacute;s par
l'application). Les fichiers r&eacute;pertori&eacute;s sont compris dans le projet d'aide Projet d'aide. Vous pouvez
supprimer les fichiers superflus. Si vous n'&ecirc;tes pas s&ucirc;r de savoir quels fichiers utiliser, demandez de
l'aide au d&eacute;veloppeur de votre application.
8) Cliquez sur Suivant. Qu'est-ce que c'est ? Qu'est-ce que c'est ? peut g&eacute;n&eacute;rer des rubriques d'aide
pour les boutons par d&eacute;faut tels que OK ou Annuler.
9) Pour inclure ces rubriques, s&eacute;lectionnez l'option permettant de cr&eacute;er du texte d'aide par d&eacute;faut
pour ce projet.
10) Cliquez sur Terminer.
Les fichiers de l'application sont analys&eacute;s et une base de donn&eacute;es des informations contenues est
g&eacute;n&eacute;r&eacute;e. Apr&egrave;s quelques instants, le nouveau projet s'ouvre dans le mode de composition d'aide
Qu'est-ce que c'est ? et un rapport r&eacute;capitulatif s'affiche. Vous pouvez afficher ce rapport, le copier
dans le Presse-papiers Windows et l'imprimer.
11) Lorsque vous avez termin&eacute;, cliquez sur OK.
Tous les composants des bo&icirc;tes de dialogue et des fen&ecirc;tres sont identifi&eacute;s dans le volet Bo&icirc;tes de
dialogue. Vous pouvez alors commencer &agrave; cr&eacute;er les rubriques d'aide Qu'est-ce que c'est ?.
12) Pour retourner dans RoboHelp et travailler sur les rubriques HTML Help, enregistrez le projet d'aide
Qu'est-ce que c'est ? et fermez le programme.
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
378
CHAPITRE 11
QU'EST-CE QUE C'EST ? AIDE
AIDE CONTEXTUELLE
Conseils
•
•
Pour travailler sur les rubriques d'aide Qu'est-ce que c'est ?, ouvrez le projet d'aide dans RoboHelp,
puis l'aide Aide.
Avant de commencer un projet d'aide Qu'est-ce que c'est ?, consultez votre d&eacute;veloppeur pour
identifier les d&eacute;tails risquant d'affecter les fichiers de l'application et la cr&eacute;ation des rubriques.
Importation de projets d'aide Projets d'aide
Vous pouvez importer des projets d'aide Qu'est-ce que c'est ? existants con&ccedil;us pour des applications
C/C++ dans vos projets Microsoft HTML Help. Vous ne pouvez utiliser qu'un seul projet d'aide Qu'est-ce
que c'est ? avec un projet HTML Help.
1) Ouvrez le projet RoboHelp.
2) S&eacute;lectionnez Fichier &gt; Importer &gt; Projet d'aide Qu'est-ce que c'est ?.
3) Acc&eacute;dez au dossier contenant le fichier (.CHJ) du projet d'aide Qu'est-ce que c'est ?. Cliquez deux
fois dessus pour l'importer.
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
Remarques
•
•
•
Tous les projets de composition d'aide Qu'est-ce que c'est ? sont enregistr&eacute;s dans le dossier du
projet.
Pour mettre &agrave; jour vos rubriques d'aide Qu'est-ce que c'est ?, modifiez le fichier Context.txt.
Ce fichier se trouve dans le dossier Fichiers de rubrique textuelle du gestionnaire de projets (dans le
dossier Aide contextuelle). Vous ne pouvez pas renommer ce fichier.
Pour ouvrir votre projet dans le module de composition d'aide Qu'est-ce que c'est ?, cliquez deux
fois sur le fichier Context.txt.
Ouverture de projets d'aide Qu'est-ce que c'est ?
1)
2)
3)
Ouvrez le projet dans RoboHelp.
S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Configuration de sortie.
S&eacute;lectionnez Modifier &gt; Projet d'aide Qu'est-ce que c'est ?. Le projet s'ouvre dans le module de
composition d'aide Module de composition d'aide.
REMARQUE : Seuls les syst&egrave;mes d'aide Microsoft HTML Help con&ccedil;us pour les applications C ou C++ sont pris
en charge par le module de composition d'aide Module de composition d'aide
Suppression de l'aide Qu'est-ce que c'est ? d'un projet
1)
2)
Ouvrez le projet HTML Help.
S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Configuration de sortie. Le conteneur de configuration
de sortie s'affiche.
379
CHAPITRE 11
3)
4)
5)
6)
QU'EST-CE QUE C'EST ? AIDE
AIDE CONTEXTUELLE
D&eacute;veloppez le dossier Aide contextuelle.
Ouvrez le dossier des rubriques textuelles.
S&eacute;lectionnez le fichier Context.Txt (fichier d'aide Qu'est-ce que c'est ?).
Cliquez sur Supprimer .
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
REMARQUE : Il est possible de restaurer un fichier d'aide Qu'est-ce que c'est ?. Le fichier d'aide de projet
Qu'est-ce que c'est ? (.CHJ) reste dans le dossier du projet et vous pouvez l'importer dans votre projet
pour cr&eacute;er un fichier CONTEXT.TXT. Reportez-vous &agrave; la rubrique Importation de projets d'aide Qu'est-ce
que c'est ?.
Fichier du projet d'aide Qu'est-ce que c'est ? avec BugHunter
REMARQUE : BugHunter est destin&eacute; &agrave; une utilisation avec les projets Microsoft HTML Help uniquement.
1)
Avant d'effectuer le test, assurez-vous que les exigences suivantes sont v&eacute;rifi&eacute;es :
–
L'application utilis&eacute;e avec les rubriques d'aide est disponible sur le syst&egrave;me de cr&eacute;ation.
–
Qu'est-ce que c'est ? Qu'est-ce que c'est ? existent dans le projet HTML Help (fichier CHM).
–
L'application est programm&eacute;e pour utiliser HTML Help.
–
Une copie du fichier de mappage est disponible pour effectuer le test.
2)
G&eacute;n&eacute;rez le projet HTML Help afin que toutes les rubriques d'aide Qu'est-ce que c'est ? soient
incluses dans le fichier CHM. Copiez le fichier dans le m&ecirc;me dossier que l'application.
S&eacute;lectionnez Outils &gt; Outils &gt; Activer BugHunter.
D&eacute;marrez l'application et ouvrez une bo&icirc;te de dialogue &agrave; tester.
Cliquez sur l'ic&ocirc;ne repr&eacute;sentant un point d'interrogation , puis sur un champ ou un contr&ocirc;le.
3)
4)
5)
Tester l'API de l'aide HTML
Testez les num&eacute;ros de mappage et les rubriques applicables aux fen&ecirc;tres avec des ID de mappage dans
les projets Microsoft HTML Help. Pour ex&eacute;cuter le test, vous devez avoir acc&egrave;s &agrave; l'application. Pour
recompiler le fichier CHM apr&egrave;s avoir utilis&eacute; cet outil, fermez le programme, puis ouvrez de nouveau le
projet.
S&eacute;lectionner un fichier d'aide HTML compil&eacute;
Sp&eacute;cifie le fichier d'aide HTML (CHM) &agrave; utiliser.
Commande
Teste un num&eacute;ro de mappage ou une rubrique. Pour utiliser la commande HH_DISPLAY_TOPIC, vous
devez sp&eacute;cifier le chemin relatif et le nom de fichier dans le champ Fichier HTML.
Bo&icirc;te de dialogue (facultatif)
Identifie la fen&ecirc;tre personnalis&eacute;e affichant le contenu de la rubrique. N'utilisez cette option que si
une fen&ecirc;tre personnalis&eacute;e affiche les rubriques d'aide sur les fen&ecirc;tres.
380
QU'EST-CE QUE C'EST ? AIDE
AIDE CONTEXTUELLE
CHAPITRE 11
Fichier HTML
Fichier HTML &agrave; tester avec HH_Display_Topic.
Num&eacute;ro de mappage
Num&eacute;ro de mappage &agrave; tester pour HH_Help_Context.
D&eacute;pannage : aide Aide
REMARQUE : Projets Microsoft HTML Help uniquement.
Avant de tester l'aide Qu'est-ce que c'est ? &agrave; l'aide de BugHunter, cliquez avec le bouton droit de la souris
dans le volet BugHunter, puis s&eacute;lectionnez Options &gt; Options d'affichage. D&eacute;sactivez Uniquement les
messages d'aide applicables aux fen&ecirc;tres.
Probl&egrave;me
La rubrique ne s'affiche pas.
Message d'erreur
Pas de message
Origine
l'auteur n'a pas cr&eacute;&eacute; de rubrique textuelle (pour un champ ou un
contr&ocirc;le d'une bo&icirc;te de dialogue).
R&eacute;solution
Cr&eacute;ez une rubrique textuelle pour le champ ou contr&ocirc;le de la bo&icirc;te de
dialogue.
Pour les fichiers de mappage fournis par les d&eacute;veloppeurs, importez
d'abord le fichier, puis cr&eacute;ez des rubriques textuelles.
Compilez le projet. Effectuez de nouveau le test &agrave; l'aide du fichier CHM
mis &agrave; jour.
Probl&egrave;me
La rubrique d'aide Qu'est-ce que c'est ? affich&eacute;e dans le champ ou
contr&ocirc;le est incorrecte.
Message d'erreur
Commande : HH_TP_HELP_WM_HELP?HH_TP_HELP_CONTEXT_MENU
Traitement : Nom_projet.chm
ID du contr&ocirc;le : 1174
ID d'aide : 1003
Fichier : Nom_Dossier/NomFichier.TXT
Origine
Le d&eacute;veloppeur n'a pas correctement trait&eacute; un message requ&eacute;rant une
aide Qu'est-ce que c'est ?.
R&eacute;solution
Transmettez le rapport sur les ID de mappage au d&eacute;veloppeur.
Les rubriques textuelles sont indiqu&eacute;es par un ID de mappage de
fen&ecirc;tre contextuelle purement textuelle.
Compilez le projet. Effectuez de nouveau le test &agrave; l'aide du fichier CHM
mis &agrave; jour.
381
CHAPITRE 11
QU'EST-CE QUE C'EST ? AIDE
AIDE CONTEXTUELLE
Probl&egrave;me
Aucune rubrique ne s'affiche ou la rubrique affich&eacute;e est incorrecte.
Message d'erreur
Pas de message
ou
Commande : HH_TP_HELP_WM_HELP?HH_TP_HELP_CONTEXT_MENU
Traitement : Nom_projet.chm
ID du contr&ocirc;le : 1174
ID d'aide : 1003
Fichier : Nom_Dossier/NomFichier.TXT
Origine
l'ID de rubrique correspondant &agrave; un num&eacute;ro de mappage du fichier de
mappage est introuvable.
ou
Un ID de rubrique est associ&eacute; &agrave; une rubrique incorrecte.
R&eacute;solution
Si le probl&egrave;me est d&ucirc; &agrave; un ID de rubrique manquant, corrigez le fichier
de mappage.
Si le d&eacute;veloppeur fournit le fichier de mappage, mettez celui-ci &agrave; jour.
S'il s'agit d'un fichier de mappage g&eacute;n&eacute;r&eacute; automatiquement : ouvrez la
bo&icirc;te de dialogue Rubriques contextuelles contenant du texte
uniquement. S&eacute;lectionnez le num&eacute;ro de mappage. S&eacute;lectionnez l'ID de
rubrique. Cliquez sur Ajouter/Mettre &agrave; jour.
Si le probl&egrave;me est d&ucirc; &agrave; un ID de rubrique associ&eacute; &agrave; une rubrique
incorrecte, supprimez la rubrique textuelle. Cr&eacute;ez-en une pour l'ID de
rubrique.
Compilez le projet. Effectuez de nouveau le test &agrave; l'aide du fichier CHM
mis &agrave; jour.
382
MAINTENANCE DES RUBRIQUES TEXTUELLES (PROJETS MICROSOFT HTML HELP)
AIDE CONTEXTUELLE
CHAPITRE 11
11.7. Maintenance des rubriques textuelles (projets Microsoft
HTML Help)
Lorsque des modifications sont apport&eacute;es &agrave; l'application, vous devez mettre &agrave; jour vos rubriques
textuelles pour refl&eacute;ter ces changements. (Si vous utilisez la Composition d'aide Qu'est-ce que c'est ?,
la plupart de ces probl&egrave;mes de maintenance vous concerne.)
Les modifications de l'application affectent les &eacute;l&eacute;ments suivants :
•
Les fichiers de mappage de votre projet.
•
Le contenu des rubriques textuelles expliquant les fonctionnalit&eacute;s de l'application.
•
Les fichiers de rubrique textuelle (.TXT) cr&eacute;&eacute;s pour l'aide Aide.
Type de modification
Action
Fonctionnalit&eacute;s obsol&egrave;tes (bo&icirc;tes de dialogue,
messages et fen&ecirc;tres supprim&eacute;s de
l'application)
Supprimez les rubriques textuelles des fichiers
purement textuels (.txt).
Fonctionnalit&eacute;s mises &agrave; jour et am&eacute;lior&eacute;es
(une bo&icirc;te de dialogue a &eacute;t&eacute; modifi&eacute;e pour
inclure de nouvelles commandes, certains
champs ont &eacute;t&eacute; supprim&eacute;s)
Modifiez le contenu des rubriques textuelles
pour qu'elles d&eacute;crivent plus pr&eacute;cis&eacute;ment les
fonctionnalit&eacute;s ou supprimez-les si les champs
ne font plus partie de bo&icirc;tes de dialogue.
Nouvelles fonctionnalit&eacute;s (ajout de nouvelles
bo&icirc;tes de dialogue par exemple)
Cr&eacute;ez de nouvelles rubriques textuelles.
Nouveaux fichiers de mappage (pour de
nouvelles fonctionnalit&eacute;s)
Importez les fichiers de mappage dans le
projet avant de cr&eacute;er les rubriques textuelles.
Fichiers de mappage mis &agrave; jour (pour des
fonctionnalit&eacute;s nouvelles ou existantes)
Mettez &agrave; jour les fichiers de mappage existants
en supprimant les fichiers obsol&egrave;tes et en
important ceux mis &agrave; jour.
Remarques
•
•
Lorsque vous cr&eacute;ez des rubriques d'aide textuelle et des rubriques d'aide sur les fen&ecirc;tres, &eacute;vitez
d'utiliser le m&ecirc;me fichier de mappage pour les deux.
A chaque mise &agrave; jour de votre aide contextuelle, testez toutes les rubriques qui ont &eacute;t&eacute; supprim&eacute;es
ou ajout&eacute;es.
383
CHAPITRE 11
UTILISATION DE RUBRIQUES CONTEXTUELLES PUREMENT TEXTUELLES
AIDE CONTEXTUELLE
11.8. Utilisation de rubriques contextuelles purement textuelles
Cr&eacute;ation de rubriques textuelles
Lorsque vous cr&eacute;ez des fichiers de rubrique textuelle pour Microsoft HTML Help, vous cr&eacute;ez des rubriques
et du texte dans la m&ecirc;me bo&icirc;te de dialogue. Si vous utilisez les fichiers de mappage de votre d&eacute;veloppeur,
importez-les avant de commencer.
1) S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Configuration de sortie. Le conteneur de configuration
de sortie s'affiche.
2) D&eacute;veloppez le dossier Aide contextuelle.
3) Cliquez avec le bouton droit de la souris sur le dossier Fichiers d'aide Qu'est-ce que c'est ?.
S&eacute;lectionnez l'option Cr&eacute;er/Importer un fichier d'aide Qu'est-ce que c'est ?.
4) Dans Nom du fichier, saisissez le nom du fichier de rubrique. Si vous importez un fichier de
mappage, utilisez son nom (Pizza.h et Pizza.txt).
5) Cliquez sur Ouvrir.
6) S&eacute;lectionnez un ID de rubrique pour la premi&egrave;re rubrique &agrave; cr&eacute;er :
–
Lorsque vous cr&eacute;ez automatiquement un fichier de mappage : dans ID de la rubrique, saisissez
un ID de rubrique.
–
Lorsque vous importez un fichier de mappage : s&eacute;lectionnez l'ID de rubrique dans la liste.
7)
1)
Exemple d'entr&eacute;es d'ID de rubrique
Dans Texte de la rubrique, saisissez le contenu de la rubrique. Ce texte appara&icirc;t dans une fen&ecirc;tre
contextuelle lorsque l'utilisateur demande de l'aide sur un champ ou une commande :
Exemple de texte de rubrique
Cliquez sur Ajouter/Mettre &agrave; jour.
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
384
CHAPITRE 11
UTILISATION DE RUBRIQUES CONTEXTUELLES PUREMENT TEXTUELLES
AIDE CONTEXTUELLE
Conseils
•
•
l'ajout de rubriques ou de code n'est pas n&eacute;cessaire pour les boutons OK, Annuler, Enregistrer,
Ouvrir et autres boutons associ&eacute;s aux bo&icirc;tes de dialogue Windows.
Les projets HTML Help peuvent contenir plusieurs fichiers .txt.
Modification de rubriques textuelles
1)
2)
3)
4)
5)
6)
S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Configuration de sortie. Le conteneur de configuration
de sortie s'affiche.
D&eacute;veloppez les dossiers Aide contextuelle et Fichiers d'aide Qu'est-ce que c'est ?.
Cliquez deux fois sur le fichier de rubrique (.TXT).
S&eacute;lectionnez une rubrique dans la liste des ID de rubrique.
Modifiez le texte dans le champ Texte de la rubrique.
Cliquez sur Ajouter/Mettre &agrave; jour.
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
ASTUCE : Cette bo&icirc;te de dialogue permet &eacute;galement de modifier les num&eacute;ros de mappage.
Test de rubriques textuelles
Le test des rubriques textuelles requiert un acc&egrave;s &agrave; l'application.
•
Si vous avez g&eacute;n&eacute;r&eacute; les fichiers de mappage automatiquement, donnez ces fichiers au d&eacute;veloppeur.
•
Lorsque le test est termin&eacute;, compilez l'aide. Fournissez le fichier CHM &agrave; votre d&eacute;veloppeur.
•
Installez la version la plus r&eacute;cente de l'application, qui doit inclure la derni&egrave;re version du fichier
CHM.
•
Si vous installez la version la plus r&eacute;cente de l'application &agrave; partir d'un CD-ROM ou d'un
emplacement r&eacute;seau, remplacez le fichier CHM existant par le nouveau lors de la compilation.
Copiez le fichier CHM dans le dossier contenant le fichier d'application EXE.
•
Imprimez le rapport sur les ID de mappage qui peut servir de liste de v&eacute;rification pour le test des
bo&icirc;tes de dialogue. Imprimez les fichiers de rubrique textuelle qui associent les ID de rubriques aux
rubriques.
Conseils
•
•
Utilisez BugHunter pour tester les appels de l'application.
Utilisez les ID de mappage en double pour r&eacute;soudre les probl&egrave;mes de r&eacute;p&eacute;tition de num&eacute;ros de
mappage.
385
CHAPITRE 11
UTILISATION DE RUBRIQUES CONTEXTUELLES PUREMENT TEXTUELLES
AIDE CONTEXTUELLE
Suppression de rubriques textuelles
Vous pouvez supprimer les rubriques textuelles de vos projets Microsoft HTML Help lorsque des
modifications apport&eacute;es aux champs et commandes de bo&icirc;tes de dialogue affectent l'aide contextuelle.
1) S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Configuration de sortie. Le conteneur de configuration
de sortie s'affiche.
2) D&eacute;veloppez les dossiers Aide contextuelle et Fichiers d'aide Qu'est-ce que c'est ?.
3) Cliquez deux fois sur le fichier de rubrique (.txt).
4) S&eacute;lectionnez la rubrique &agrave; supprimer.
5) Cliquez sur Supprimer.
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
Conseils
•
•
Si votre d&eacute;veloppeur vous fournit des fichiers de mappage mis &agrave; jour, remplacez-les avant de
supprimer la rubrique.
Les ID de rubrique et les num&eacute;ros de mappage des rubriques textuelles supprim&eacute;es sont conserv&eacute;s
dans le fichier de mappage. Vous pouvez supprimer les ID de mappage inutilis&eacute;s si vous ne vous en
servez plus.
Suppression de fichiers de rubrique textuelle
Supprimez les fichiers de rubrique textuelle (.txt) des projets Microsoft HTML Help lorsque vous n'en avez
plus besoin.
1) S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Configuration de sortie. Le conteneur de configuration
de sortie s'affiche.
2) D&eacute;veloppez les dossiers Aide contextuelle et Fichiers d'aide Qu'est-ce que c'est ?.
3) S&eacute;lectionnez un fichier de rubrique (.txt).
4) Cliquez sur Supprimer.
5) D&eacute;veloppez le dossier Fichiers de mappage.
6) S&eacute;lectionnez le fichier de mappage (.h) associ&eacute; au fichier .txt supprim&eacute;.
7) Cliquez sur Supprimer. Le fichier de rubrique et son fichier de mappage sont supprim&eacute;s.
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
386
TEST D'UN SYST&Egrave;ME D'AIDE CONTEXTUELLE
AIDE CONTEXTUELLE
CHAPITRE 11
11.9. Test d'un syst&egrave;me d'aide contextuelle
Test &agrave; l'aide de l'outil d'aide contextuelle
l'outil de test de l'aide contextuelle simule des appels d'aide &agrave; partir d'une application.
1) Dans le conteneur Bo&icirc;te &agrave; outils, cliquez deux fois sur Test CSH.
2) Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Pour tester une aide de serveur, s&eacute;lectionnez l'option En ligne.
–
Pour tester l'aide locale, s&eacute;lectionnez l'option Hors ligne.
3)
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Pour une aide de serveur, saisissez l'emplacement du serveur ainsi que le nom du projet en
utilisant la syntaxe suivante pour FlashHelp Pro :
http://RoboHelp
Server/robohelp/server?project=MyProject&amp;area=area-name&amp;type=flashhe
lp
Pour WebHelp Pro, utilisez la syntaxe suivante :
http://RoboHelp
Server/robohelp/server?project=MyProject&amp;area=area-name&amp;ver=1
–
4)
5)
6)
7)
Pour une aide locale, cliquez sur le bouton Parcourir, puis s&eacute;lectionnez un fichier d'aide.
(Facultatif) Saisissez un nom de fen&ecirc;tre.
Cliquez sur l'ic&ocirc;ne de fichier de mappage , puis s&eacute;lectionnez un fichier de mappage.
Cliquez sur le triangle et s&eacute;lectionnez un num&eacute;ro de mappage.
Cliquez sur Afficher l'aide.
Si l'aide fonctionne correctement, la rubrique associ&eacute;e au num&eacute;ro de mappage sp&eacute;cifi&eacute; s'affiche.
Test &agrave; l'aide de BugHunter pour HTML Help
REMARQUE : Projets Microsoft HTML Help uniquement.
BugHunter est un outil de d&eacute;pannage destin&eacute; &agrave; tester les rubriques d'aide contextuelle et &agrave; diagnostiquer
les probl&egrave;mes. Au cours des tests, BugHunter capture et affiche des appels effectu&eacute;s par l'application.
REMARQUE : Avant de commencer &agrave; utiliser BugHunter, vous devez lancer une premi&egrave;re fois HTML Help
Workshop. Pour lancer HTML Help Workshop, cliquez deux fois sur le fichier hhw.exe dans le dossier
d'installation HTML Help Workshop.
Utilisez BugHunter pour les t&acirc;ches suivantes :
•
Tester les boutons d'aide, l'aide accessible par la touche F1 ou encore l'aide Qu'est-ce que c'est ?
•
D&eacute;terminer l'origine des erreurs.
•
Copier des donn&eacute;es dans le Presse-papier ou les annoter et les enregistrer dans un fichier texte.
•
D&eacute;terminer la raison pour laquelle une rubrique incorrecte s'affiche.
387
CHAPITRE 11
•
•
TEST D'UN SYST&Egrave;ME D'AIDE CONTEXTUELLE
AIDE CONTEXTUELLE
D&eacute;terminer si un num&eacute;ro de mappage particulier est utilis&eacute;.
D&eacute;terminer si un ID de mappage est assign&eacute; &agrave; une rubrique d'aide particuli&egrave;re applicable aux
fen&ecirc;tres.
D&eacute;marrage et fermeture de BugHunter
1)
2)
S&eacute;lectionnez Projet &gt; Ouvrir &gt; Conteneurs &gt; Outils.
Proc&eacute;dez de l'une des fa&ccedil;ons suivantes :
–
Pour lancer la capture des donn&eacute;es, choisissez Outils &gt; Activer BugHunter.
La bo&icirc;te de dialogue de sortie affiche les donn&eacute;es de captures tant que le programme est actif.
Lorsque vous activez l'aide dans une bo&icirc;te de dialogue de l'application, des messages &eacute;mis par
BugHunter s'affichent dans la fen&ecirc;tre de sortie. Cliquez avec le bouton droit de la souris sur le
volet pour copier, annoter ou enregistrer les donn&eacute;es.
–
Cliquez sur volet avec le bouton droit de la souris et s&eacute;lectionnez Effacer tout pour supprimer
son contenu. Les donn&eacute;es restent dans le volet jusqu'&agrave; ce que vous les effaciez.
–
Pour arr&ecirc;ter la capture des donn&eacute;es, choisissez Outils &gt; Activer BugHunter.
Interpr&eacute;tation des donn&eacute;es BugHunter
Les donn&eacute;es BugHunter sont similaires &agrave; l'exemple suivant :
C:\APPLICATION FOLDER\HELP_FILE.CHM, Custom Folder\Help_Topic_Name.htm,
HH_HELP_CONTEXT, 10253, Topic launched
Les lignes de donn&eacute;es sont similaires &agrave; ce qui suit :
Project: C:\APP FOLDER\HELP_FILE.CHM
File: Custom Folder\Help _Topic_Name.htm
Command: HH_HELP_CONTEXT
Map Number: 10253
Result: Topic launched
Interpr&eacute;tez les donn&eacute;es comme suit :
Projet
Emplacement de l'application. Nom de fichier de l'aide HTML contenant la rubrique d'aide appel&eacute;e.
Fichier
Dossier et sous-dossiers contenant la rubrique .htm.
Contr&ocirc;le (Command)
Nom de commande envoy&eacute; &agrave; HTML Help.
10253
Num&eacute;ro de mappage (Map number)
388
CHAPITRE 11
TERMINOLOGIE DES SYST&Egrave;MES D'AIDE CONTEXTUELLE
AIDE CONTEXTUELLE
R&eacute;sultat (Result)
Synth&egrave;se de l'activit&eacute;. &laquo; La rubrique lanc&eacute;e &raquo; indique que l'ID de mappage de rubrique correspond
au code de l'application.
Personnalisation du volet BugHunter
1)
Cliquez avec le bouton droit de la souris dans le volet BugHunter, puis s&eacute;lectionnez Options.
Affichage des num&eacute;ros de mappage au format hexad&eacute;cimal
1)
2)
S&eacute;lectionnez Fichier &gt; Options. Cliquez sur l'onglet Bughunter.
Dans Options d'affichage, s&eacute;lectionnez Num&eacute;ros de mappage au format hexad&eacute;cimal.
Test dans l'application
Pour tester l'aide contextuelle de l'application, suivez ces instructions :
•
Si vous avez g&eacute;n&eacute;r&eacute; automatiquement les ID de mappage dans RoboHelp, exportez les fichiers de
mappage afin de les transmettre au d&eacute;veloppeur. Mettez &agrave; jour l'application afin d'utiliser les ID de
mappage si ce n'est d&eacute;j&agrave; fait.
•
G&eacute;n&eacute;rez le projet. Transmettez les fichiers de sortie au d&eacute;veloppeur.
•
Si vous avez d&eacute;fini une fen&ecirc;tre personnalis&eacute;e pour l'affichage de rubriques d'aide sur les fen&ecirc;tres,
informez le d&eacute;veloppeur. Pour afficher ce type de rubrique, l'application doit &ecirc;tre modifi&eacute;e au
niveau du code.
•
Installez la version la plus r&eacute;cente de l'application ou acc&eacute;dez &agrave; l'application Web. Si vous installez
la version la plus r&eacute;cente &agrave; partir d'une unit&eacute; de r&eacute;seau ou d'un CD, vous pouvez remplacer le fichier
de sortie par le nouvel exemplaire g&eacute;n&eacute;r&eacute;. Placez les fichiers de sortie dans le m&ecirc;me dossier que le
fichier EXE de l'application.
•
Imprimez le rapport sur les ID de mappage en double. Ce rapport vous permettra de v&eacute;rifier les
bo&icirc;tes de dialogue.
•
Dans l'application, cliquez sur Aide ou appuyez sur la touche F1 pour v&eacute;rifier que les rubriques
d'aide affich&eacute;es correspondent aux bo&icirc;tes de dialogue.
•
Mettez &agrave; jour les ID de mappage incorrects et v&eacute;rifiez les points ci-dessous.
•
Assurez-vous que l'ID de mappage appropri&eacute; est attribu&eacute;.
•
V&eacute;rifiez qu'une fen&ecirc;tre est attribu&eacute;e &agrave; la rubrique.
•
G&eacute;n&eacute;rez le projet pour tester &agrave; nouveau les rubriques modifi&eacute;es.
11.10. Terminologie des syst&egrave;mes d'aide contextuelle
Fichier .ALI
Fichier de projet cr&eacute;&eacute; automatiquement dans le dossier du projet lors de l'ajout, de la mise &agrave; jour
ou de la suppression d'ID de mappage. Il contient l'ID de rubrique et la rubrique associ&eacute;e (par
exemple, ID_ABCForm=ABC.htm).
389
CHAPITRE 11
TERMINOLOGIE DES SYST&Egrave;MES D'AIDE CONTEXTUELLE
AIDE CONTEXTUELLE
Fichier .CHM
Fichier cr&eacute;&eacute; lorsqu'un auteur compile un projet Microsoft HTML Help. Tous les fichiers du projet, y
compris les rubriques d'aide contextuelle et les fichiers de mappage, sont compress&eacute;s et enregistr&eacute;s
dans ce fichier.
Fichier d'en-t&ecirc;te
Terme utilis&eacute; par les d&eacute;veloppeurs et d&eacute;signant l'affichage des fichiers de mappage. Les
d&eacute;veloppeurs cr&eacute;ent les fichiers d'en-t&ecirc;te, qui sont des fichiers texte contenant la liste des ID de
rubrique et les num&eacute;ros de mappage correspondants. Les extensions prises en charge sont .h, .hh
et .hm. Lorsqu'un d&eacute;veloppeur fournit les fichiers d'en-t&ecirc;te &agrave; l'auteur, ce dernier doit importer les
fichiers dans le projet.
HHCTRL.OCX
(Projets Microsoft HTML Help) Contr&ocirc;le Microsoft ActiveX contenant les interfaces de
programmation d'applications HtmlHelp(). Les d&eacute;veloppeurs doivent s'assurer que HHCTRL.OCX est
appel&eacute; lorsque les utilisateurs demandent l'aide.
HH_HELP_CONTEXT
(Projets Microsoft HTML Help) Cette commande de l'API HTML Help permet d'effectuer des appels
vers l'application &agrave; l'aide du num&eacute;ro de mappage.
API HTML Help
(Projets Microsoft HTML Help) Interface de programmation d'applications de Microsoft HTML Help
qui permet d'afficher une fen&ecirc;tre d'aide &agrave; partir d'une application. Les d&eacute;veloppeurs utilisent ses
commandes pour sp&eacute;cifier le type, le style et l'emplacement des fen&ecirc;tres d'aide.
Traducteur HTML Help
(Projets Microsoft HTML Help) M&eacute;canisme de Microsoft HTML Help qui recherche des rubriques
d'aide contextuelle lorsque des utilisateurs demandent de l'aide &agrave; partir des applications.
Afficheur HTML Help
(Projets Microsoft HTML Help) Fen&ecirc;tre par d&eacute;faut qui permet d'afficher les syst&egrave;mes d'aide
Microsoft HTML Help compil&eacute;s (fichiers CHM). Les auteurs peuvent concevoir une fen&ecirc;tre distincte
personnalis&eacute;e pour afficher les rubriques d'aide contextuelles.
Pr&eacute;fixe
Caract&egrave;res ajout&eacute;s au d&eacute;but des ID de rubrique. Par exemple, dans l'ID de rubrique
IDD_Monidderubrique, &laquo; IDD_ &raquo; correspond au pr&eacute;fixe. Les outils de d&eacute;veloppement g&eacute;n&eacute;rant des
fichiers de mappage utilisent un pr&eacute;fixe par d&eacute;faut. Lorsque vous g&eacute;n&eacute;rez des fichiers de mappage
dans RoboHelp, vous pouvez sp&eacute;cifier un pr&eacute;fixe. Les pr&eacute;fixes ne sont pas obligatoires. Toutefois, ils
facilitent l'organisation des ID de rubrique.
RH ShowHelp
Fonction d'API RoboHelp utilis&eacute;e pour appeler des rubriques d'aide contextuelle. Vous pouvez
appeler cette fonction pour WebHelp Pro, WebHelp et HTML Help.
390
CHAPITRE 11
CR&Eacute;ATION D'UNE AIDE POUR LES APPLICATIONS IOS ET ANDROID
AIDE CONTEXTUELLE
Fichiers de support
(Projets WebHelp et WebHelp Pro) Adobe fournit des fichiers de support permettant aux
d&eacute;veloppeurs d'importer du code et de saisir des variables. Chaque langage pris en charge est
associ&eacute; &agrave; un fichier de support regroupant les fonctions permettant d'appeler les projets WebHelp
Pro ou WebHelp et d'afficher les diff&eacute;rentes rubriques d'aide contextuelle.
11.11. Cr&eacute;ation d'une aide pour les applications iOS et Android
RoboHelp fournit une API que vous pouvez exploiter pour int&eacute;grer la sortie Responsive ou multi-&eacute;cran
HTML5 avec les applications iOS et Android. L'API est livr&eacute;e avec les &eacute;l&eacute;ments suivants :
•
Le code source Objective C (iOS) et Java (Android) des fonctions d'API que vous pouvez inclure dans
votre application avec ou sans personnalisation
•
Exemples d'applications illustrant l'utilisation de l'API expos&eacute;e
IOS version 5 et versions ult&eacute;rieures sont pris en charge Android 2.2 (Froyo) et les versions sup&eacute;rieures
sont pris en charge.
Fonctionnalit&eacute;s fournies
Vous pouvez exploiter les fonctionnalit&eacute;s suivantes &agrave; l'aide de l'API d'aide mobile :
•
Int&eacute;gration de l'aide dans l'application
•
Ouverture de l'aide dans le navigateur int&eacute;gr&eacute; ou le navigateur par d&eacute;faut du syst&egrave;me d'exploitation
mobile
•
Mise en œuvre de l'aide contextuelle &agrave; partir des &eacute;crans d'applications mobiles
•
H&eacute;bergement de l'aide sur un serveur et lien vers celui-ci depuis l'application mobile
REMARQUE : Lors de la liaison &agrave; l'aide h&eacute;berg&eacute;e sur un serveur externe, assurez-vous que l'impl&eacute;men-
tation est conforme aux directives de l'App Store d'Apple.
Etapes g&eacute;n&eacute;rales pour mettre en œuvre l'aide mobile
1)
2)
3)
4)
5)
6)
Pr&eacute;parer le projet RoboHelp pour publication.
Pr&eacute;parer l'aide contextuelle et cr&eacute;er les mappages pertinents.
G&eacute;n&eacute;rer une sortie multi-&eacute;cran ou Responsive HTML5.
Regrouper la sortie multi-&eacute;cran ou Responsive HTML5 avec l'application.
Inclure les fichiers source de l'API d'aide mobile avec l'application.
Appeler les fonctions de l'API pour mettre en œuvre les appels d'aide requis dans l'application.
391
CHAPITRE 11
CR&Eacute;ATION D'UNE AIDE POUR LES APPLICATIONS IOS ET ANDROID
AIDE CONTEXTUELLE
Fonctions d'API disponibles
iOS
•
•
•
•
•
•
•
•
•
•
•
-(id) initForHelpPath: (NSString*)path;
-(void) setHelpPath: (NSString*)path;
-(void) setShowHelpInEmbeddedBrowser: (BOOL)bInEmbedded;
-(void) showFullScreenHelp:
(UIViewController*)presentingViewController;
-(void) showFullScreenHelp:
(UIViewController*)presentingViewController
ForMapNo:(NSInteger)ctxId;
-(void) showFullScreenHelp:
(UIViewController)presentingViewController ForMapId:(NSString)ctxId;
-(void) cleanUpResources;
-(void) setTitle: (NSString*)title;
-(void) setBackButtonText: (NSString*)text;
-(void) setSupportsIPhoneOrientation:
(UIInterfaceOrientation)orientation supports:(BOOL)supports;
-(void) setSupportsIPadOrientation:
(UIInterfaceOrientation)orientation supports:(BOOL)supports;
ASTUCE : Pour comprendre comment utiliser ces fonctions d'API, reportez-vous aux commentaires
figurant dans le code.
Android
L'exemple de code suivant illustre les m&eacute;thodes Java disponibles :
•
RoboHelpAPI(String url, View v)
•
void setHelpPath(String url)
•
void setShowHelpInEmbeddedBrowser(boolean bEmbedded)
•
void showFullScreenHelp()
•
void showFullScreenHelpForMapNo(int mapNo)
•
void showFullScreenHelpForMapId(String mapId)
•
void setTitle(String title)
•
void setBackButtonText(String text)
•
void setSupportsOrientation(boolean supports)
ASTUCE : Pour comprendre comment utiliser ces fonctions d'API, reportez-vous aux commentaires figurant
dans le code.
392
CHAPITRE 11
CR&Eacute;ATION D'UNE AIDE POUR LES APPLICATIONS IOS ET ANDROID
AIDE CONTEXTUELLE
Exemple d'application
RoboHelp est fourni avec des exemples d'applications pr&eacute;sentant les capacit&eacute;s de l'API d'aide mobile.
393
CHAPITRE 11
CR&Eacute;ATION D'UNE AIDE POUR LES APPLICATIONS IOS ET ANDROID
AIDE CONTEXTUELLE
Exemple d'application iOS pr&eacute;sentant les fonctionnalit&eacute;s de l'API d'aide mobile
394
CHAPITRE 11
CR&Eacute;ATION D'UNE AIDE POUR LES APPLICATIONS IOS ET ANDROID
AIDE CONTEXTUELLE
Exemple d'application Android pr&eacute;sentant les fonctionnalit&eacute;s de l'API d'aide mobile
395
CHAPITRE 11
AIDE CONTEXTUELLE POUR LE CONTENU DYNAMIQUE FILTR&Eacute;
AIDE CONTEXTUELLE
11.12. Aide contextuelle pour le contenu dynamique filtr&eacute;
Lorsque vous utilisez des filtres de contenu dynamique pour cr&eacute;er la sortie de l'aide, vous pouvez cr&eacute;er
une aide contextuelle qui affichera directement &agrave; l'utilisateur le contenu filtr&eacute;. Par exemple, si votre
contenu est sp&eacute;cifique &agrave; une r&eacute;gion, vous pouvez filtrer l'affichage de l'aide contextuelle pour cette
r&eacute;gion. Pour plus d'informations sur la cr&eacute;ation et l'utilisation de filtre de contenu dynamique, voir
G&eacute;n&eacute;ration d'une sortie de contenu dynamique.
REMARQUE : Les filtres de contenu dynamique sont pris en charge pour les sorties Responsive HTML5 et
d'applications mobiles.
Pour cr&eacute;er un lien d'aide contextuelle vers un filtre, cr&eacute;ez un lien avec la syntaxe suivante :
&lt;help topic url&gt;?filter=&lt;tag1&gt;:&lt;value1&gt;,&lt;tag2&gt;:&lt;value2&gt;...
Par exemple, pour cr&eacute;er un lien direct vers le filtre suivant :
Filtre dynamique
Cr&eacute;ez le lien suivant :
&lt;help topic url&gt;?filter=Region:US,Audience:Print
396
CHAPITRE 11
R&Eacute;F&Eacute;RENCES
AIDE CONTEXTUELLE
11.13. R&eacute;f&eacute;rences
Onglet BugHunter de la bo&icirc;te de dialogue Options (HTML Help)
Options d'affichage
Les messages d'aide applicables aux fen&ecirc;tres capturent uniquement les messages relatifs aux fen&ecirc;tres.
ASTUCE : D&eacute;sactivez cette option pour tester l'aide Qu'est-ce que c'est ?.
Num&eacute;ros de mappage au format hexad&eacute;cimal
Affiche les num&eacute;ros de mappage en notation hexad&eacute;cimale plut&ocirc;t qu'au format d&eacute;cimal.
Chaque message sur une seule ligne
Affiche la sortie sur une seule ligne. Un affichage sous plusieurs lignes permet d'ordonner les
donn&eacute;es selon le type d'informations.
Exemple de message sur une seule ligne
C:\APPLICATION FOLDER\HELP_FILE.CHM, Custom Folder\Help_Topic_Name.htm,
HH_HELP_CONTEXT, 10253, Topic launched
Exemple de message sur plusieurs lignes
Project: C:\APPLICATION FOLDER\HELP_FILE.CHM
File: Custom Folder\Help_Topic_Name.htm
Command: HH_HELP_CONTEXT
Map Number: 10253
Result: Topic launched
Options de couleur
D&eacute;finissez la couleur d'affichage des messages d'erreur, des invites, des annotations ainsi que la couleur
d'arri&egrave;re-plan des fen&ecirc;tres dans votre projet d'aide.
397
CHAPITRE 12
EL&Eacute;MENTS DE BASE SOURCE UNIQUE ET PLUS
G&Eacute;N&Eacute;RATION DE SORTIE
12. G&eacute;n&eacute;ration de sortie
12.1. El&eacute;ments de base source unique et plus
A propos des mises en page source unique
Les mises en page source unique servent de mod&egrave;les pour diff&eacute;rentes versions de sortie de projet.
RoboHelp fournit des mises en page source unique pour chaque type de sortie.
En g&eacute;n&eacute;ral, lors de la g&eacute;n&eacute;ration d'une version diff&eacute;rente du projet (comme un didacticiel en ligne), on
utilise des param&egrave;tres distincts pour la sortie. Vous pouvez enregistrer ces param&egrave;tres dans des mises en
page source unique. Apr&egrave;s avoir cr&eacute;&eacute; la mise en page et d&eacute;fini les param&egrave;tres de sortie, vous pouvez
g&eacute;n&eacute;rer, afficher ou publier la sortie &agrave; n'importe quel moment, individuellement ou par lots.
Les mises en page enregistrent les param&egrave;tres et pr&eacute;f&eacute;rences de chaque version du projet, pour en
garantir la coh&eacute;rence. Les balises et les expressions de construction conditionnelles permettent de cr&eacute;er
une sortie distincte pour les diff&eacute;rentes versions d'un projet.
LIENS CONNEXES :
Utilisation de types de mises en page
Types de mise en page dans RoboHelp
RoboHelp prend en charge les types de mise en page suivants :
•
Mise en page Responsive HTML5
•
Mise en page eBook
•
Mise en page de WebHelp
•
Mises en page WebHelp Pro et FlashHelp Pro
•
Mise en page de Microsoft HTML Help
•
Mise en page JavaHelp
•
Mise en page d'Oracle Help
•
Mise en page XML
•
Mise en page d'Adobe AIR
398
CHAPITRE 12
EL&Eacute;MENTS DE BASE SOURCE UNIQUE ET PLUS
G&Eacute;N&Eacute;RATION DE SORTIE
Sp&eacute;cification de la mise en page principale
La mise en page principale correspond &agrave; celle que vous d&eacute;finissez par d&eacute;faut pour votre environnement
de travail. Elle vous permet de g&eacute;n&eacute;rer une sortie sans avoir besoin d'indiquer des options
suppl&eacute;mentaires. La mise en page principale contient des param&egrave;tres relatifs au type de sortie auquel elle
est associ&eacute;e. Elle contr&ocirc;le les fen&ecirc;tres de projet, les propri&eacute;t&eacute;s de la table des mati&egrave;res et d'autres entit&eacute;s
du projet.
1) Dans le conteneur Mises en page de source unique, cliquez avec le bouton droit de la souris sur une
mise en page.
2) S&eacute;lectionnez l'option D&eacute;finir en tant que mise en page principale.
La mise en page principale est alors libell&eacute;e dans le conteneur Mises en page source unique.
REMARQUE : Si vous cr&eacute;ez des fen&ecirc;tres, le type associ&eacute; repose sur la mise en page par d&eacute;faut. Pour plus
d'informations, voir cet article.
Cr&eacute;ation et modification de mises en page de source unique
Cr&eacute;ation ou duplication de mises en page source unique
Une mise en page dupliqu&eacute;e conserve les param&egrave;tres de la mise en page d'origine.
1) Dans le conteneur Mises en page source unique, proc&eacute;dez comme suit :
–
Pour cr&eacute;er une mise en page, cliquez sur le bouton Cr&eacute;er une mise en page .
–
Pour dupliquer une mise en page, cliquez sur le bouton Dupliquer la mise en page
2)
3)
4)
5)
.
Dans la bo&icirc;te de dialogue Nom de la mise en page, indiquez un nom.
En cas de cr&eacute;ation de mise en page, s&eacute;lectionnez un type de sortie dans le menu contextuel en
REMARQUE : Vous ne pouvez pas modifier le type de sortie d'une mise en page apr&egrave;s sa duplication.
Cliquez sur OK.
En cas de cr&eacute;ation de mise en page, d&eacute;finissez les options correspondantes dans la bo&icirc;te de dialogue
Propri&eacute;t&eacute;s qui s'affiche. Cliquez sur Enregistrer.
Modification de mises en page source unique
1)
2)
3)
Dans le conteneur Mises en page source unique, cliquez sur la mise en page avec le bouton droit de
la souris.
S&eacute;lectionnez Propri&eacute;t&eacute;s.
D&eacute;finissez les options. Cliquez sur Enregistrer.
REMARQUE : Vous ne pouvez pas modifier le type de sortie d'une mise en page ; vous devez en cr&eacute;er une.
399
CHAPITRE 12
EL&Eacute;MENTS DE BASE SOURCE UNIQUE ET PLUS
G&Eacute;N&Eacute;RATION DE SORTIE
Modification du nom d'une mise en page source unique
1)
2)
3)
Dans le conteneur Mises en page de source unique, cliquez sur la mise en page avec le bouton droit
de la souris.
S&eacute;lectionnez Renommer.
Indiquez un nom.
LIENS CONNEXES :
Utilisation de types de mises en page
G&eacute;n&eacute;ration, affichage et publication d'une sortie
Suppression d'une mise en page source unique
La suppression d'une mise en page n'affecte pas les autres &eacute;l&eacute;ments d'un projet.
1) Dans le conteneur Mises en page source unique, cliquez sur la mise en page source unique avec le
bouton droit de la souris. Il ne doit pas s'agir de la mise en page principale.
2) S&eacute;lectionnez Supprimer.
A propos de l'exclusion des rubriques non r&eacute;f&eacute;renc&eacute;es de la sortie
Un projet destin&eacute; &agrave; une source unique peut inclure des rubriques qui ne se rapportent pas &agrave; tous les types
de sortie g&eacute;n&eacute;r&eacute;s &agrave; partir du projet. Par exemple, un projet comportant plusieurs tables des mati&egrave;res
inclut des rubriques qui ne se rapportent pas &agrave; la sortie que vous g&eacute;n&eacute;rez en fonction d'une seule table
des mati&egrave;res. Dans ce cas, l'exclusion des rubriques non r&eacute;f&eacute;renc&eacute;es de la sortie garantit que les
utilisateurs trouveront uniquement les rubriques pertinentes dans la navigation et la recherche.
RoboHelp prend en compte une rubrique non r&eacute;f&eacute;renc&eacute;e si la rubrique n'est pas r&eacute;f&eacute;renc&eacute;e par les
composants de projet suivants :
•
Table des mati&egrave;res
•
Index
•
S&eacute;quences de navigation
•
Rubrique par d&eacute;faut
•
ID de mappage CSH
•
Mots-cl&eacute;s Voir aussi
•
Mots-cl&eacute;s Rubriques connexes
L'option Exclure les rubriques non r&eacute;f&eacute;renc&eacute;es de la sortie est disponible dans les pr&eacute;sentations Adobe
AIR, WebHelp, WebHelp Pro, FlashHelp, FlashHelp Pro, Microsoft HTML Help, XML Output, Oracle Help
et JavaHelp.
LIENS CONNEXES :
Principes de base de la g&eacute;n&eacute;ration de la sortie
400
CHAPITRE 12
EL&Eacute;MENTS DE BASE SOURCE UNIQUE ET PLUS
G&Eacute;N&Eacute;RATION DE SORTIE
G&eacute;n&eacute;ration d'une sortie de contenu dynamique
La fonction de contenu dynamique de RoboHelp vous permet de cr&eacute;er une sortie que vous utilisateurs
peuvent facilement filtrer en fonction des param&egrave;tres que vous d&eacute;finissez &agrave; l'aide des balises de
construction conditionnelles. Par exemple, vous pouvez cr&eacute;er un filtre qui permet aux utilisateurs de
filtrer la sortie par r&eacute;gion (Etats-Unis, Royaume-Uni ou Canada) et selon les utilisateurs concern&eacute;s
(utilisateur final, en ligne, papier). Le contenu dynamique permet &eacute;galement aux r&eacute;dacteurs de cr&eacute;er
facilement du contenu source unique avec l'aide des balises de construction conditionnelles.
Gr&acirc;ce &agrave; cette fonctionnalit&eacute;, un r&eacute;dacteur cr&eacute;e des balises de construction conditionnelles en fonction
des crit&egrave;res de filtre que vous souhaitez appliquer &agrave; vos utilisateurs. Par exemple, vous pouvez cr&eacute;er des
balises de construction conditionnelles &laquo; Etats-Unis, Royaume-Uni et Canada &raquo; pour la r&eacute;gion et
l'utilisateur final, En ligne et Imprimer.
Lorsque vous g&eacute;n&eacute;rez la sortie &agrave; l'aide du filtre, l'onglet Filtre s'affiche pour les utilisateurs pour filtrer les
contenus en fonction des crit&egrave;res (balise/expression) s&eacute;lectionn&eacute;s dans le filtre du SSL de sortie.
Un utilisateur peut ensuite utiliser la fonctionnalit&eacute; de recherche pour rechercher du contenu dans les
r&eacute;sultats filtr&eacute;s.
REMARQUE : Les filtres de contenu dynamique peuvent &ecirc;tre appliqu&eacute;s &agrave; des sorties Responsive HTML5 et
mobiles.
Contenu de balises
Pour cr&eacute;er un filtre de contenu dynamique dans votre sortie, vous devez appliquer des balises de
construction conditionnelles aux parties de votre projet &agrave; filtrer.
Dans un projet RoboHelp, vous pouvez appliquer des balises de construction conditionnelles aux
&eacute;l&eacute;ments suivants :
•
Rubriques
REMARQUE : Si vous appliquez une balise &agrave; une rubrique, tous les contenus de la rubrique, les tables
des mati&egrave;res et les entr&eacute;es d'index pointant vers cette rubrique h&eacute;ritent de sa balise dans la sortie.
•
Contenu de rubriques (texte et images)
Nous vous recommandons d'appliquer des balises de construction conditionnelles &agrave; partir d'un
paragraphe, au minimum. Bien que la fonctionnalit&eacute; de filtre fonctionne &agrave; tous les niveaux de
granularit&eacute;, les balises appliqu&eacute;es &agrave; du texte en-dessous du niveau paragraphe peuvent donner lieu
&agrave; des phrases incompl&egrave;tes.
•
El&eacute;ments de table des mati&egrave;res
•
El&eacute;ments d'index
REMARQUE : Vous pouvez appliquer des balises de construction conditionnelles &agrave; un glossaire.
Vous pouvez appliquer plusieurs balises de construction conditionnelles &agrave; la m&ecirc;me section de votre
contenu. Par exemple, vous pouvez appliquer les balises Etats-Unis et Canada &agrave; une rubrique destin&eacute;e &agrave;
vos clients d'Am&eacute;rique du Nord. Vous pouvez ensuite baliser une autre rubrique destin&eacute;e &agrave; vos clients
britanniques. Dans la sortie, un utilisateur a ensuite la possibilit&eacute; de filtrer du contenu en fonction de la
r&eacute;gion. Vous pouvez &eacute;galement utiliser une expression telle que &Eacute;tats-Unis AND Canada pour cr&eacute;er des
crit&egrave;res de filtre intitul&eacute;s Am&eacute;rique du Nord.
401
CHAPITRE 12
EL&Eacute;MENTS DE BASE SOURCE UNIQUE ET PLUS
G&Eacute;N&Eacute;RATION DE SORTIE
RoboHelp ne restreint pas l'application de balises de construction conditionnelles. Vous pouvez ainsi
appliquer des balises de toutes sortes de combinaisons au contenu. C'est pourquoi, lorsque vous
appliquez des balises, il vous faut vous rappeler que la sortie s'affiche en fonction du m&eacute;canisme de
filtrage de la sortie.
Prenez l'exemple de deux balises &Eacute;tats-Unis et Canada o&ugrave; vous appliquez la balise &Eacute;tats-Unis &agrave; une table
et la balise Canada au contenu du tableau. Si vous marquez la balise &Eacute;tats-Unis pour affichage et que vous
masquez la balise Canada dans la sortie, le contenu s'affiche. Ceci est d&ucirc; au fait que la propri&eacute;t&eacute;
d'affichage du contenu a remplac&eacute; la propri&eacute;t&eacute; de masquage de la table. Toutefois, si vous marquez une
rubrique pour affichage et que vous masquez un paragraphe dans cette rubrique, le paragraphe ne
s'affiche pas.
Pour consulter un exemple de fonctionnement du filtrage, voir Utilisation d'un filtre de contenu
dynamique dans la sortie.
Contenu sans balise
Lorsque vous utilisez des filtres dynamiques dans un projet RoboHelp, vous n'&ecirc;tes pas oblig&eacute; de baliser
l'ensemble du contenu. Les contenus sans balise sont inconditionnels. Les contenus sans balise
s'affichent pour l'utilisateur, qu'il y ait un filtre ou non.
Cr&eacute;ation d'un filtre de contenu dynamique
Vous pouvez cr&eacute;er une filtre dynamique pour chaque mise en page.
1) Dans l'onglet Sortie, cliquez sur une mise en page.
2) Dans la bo&icirc;te de dialogue Param&egrave;tres de mise en page, cochez Utiliser le filtre de contenu
dynamique dans la sortie, puis cliquez sur Personnaliser.
La bo&icirc;te de dialogue Filtre de contenu dynamique s'affiche.
3) Lorsque vous cr&eacute;ez un filtre, vous pouvez d&eacute;finir des groupes qui contiennent des crit&egrave;res de filtre
(balises et expressions).
Par exemple, vous pouvez cr&eacute;er un groupe R&eacute;gion qui comprend les balises de construction
conditionnelles &Eacute;tats-Unis, Canada et Royaume-Uni.
Vous pouvez &eacute;galement utiliser des expressions en tant que crit&egrave;re de filtrage. Par exemple, vous
pouvez cr&eacute;er un filtre &Eacute;tats-Unis ET Canada et fournir &agrave; vos utilisateurs une option de crit&egrave;re
Am&eacute;rique du Nord dans la sortie.
REMARQUE : Vous pouvez ajouter des balises et des expressions &agrave; votre filtre sans les inclure dans un
groupe. Vous pouvez ainsi cr&eacute;er un filtre sans les inclure dans un groupe. Vous pouvez &eacute;galement
cr&eacute;er un filtre contenant un ou plusieurs groupes, balises ou expressions qui ne sont pas inclus dans
les groupes.
IMPORTANT : Vous ne pouvez pas cr&eacute;er de groupes imbriqu&eacute;s. Un groupe ne peut donc pas contenir
un autre groupe.
4) Pour ajouter une balise ou une expression &agrave; un groupe, cliquez sur Ajouter un crit&egrave;re et s&eacute;lectionnez
les balises et expressions &agrave; partir de la bo&icirc;te de dialogue Balises et expressions.
REMARQUE : Vous pouvez ajouter une instance de balise ou d'expression dans un filtre dynamique.
Si vous ajoutez une balise ou expression au filtre, vous notez que la balise ou l'expression ne
s'affiche pas dans la bo&icirc;te de dialogue Balises et expressions.
402
CHAPITRE 12
EL&Eacute;MENTS DE BASE SOURCE UNIQUE ET PLUS
G&Eacute;N&Eacute;RATION DE SORTIE
Lorsque vous ajoutez une balise ou expression &agrave; un filtre, le nom de la balise ou de l'expression
affich&eacute; dans le filtre correspond au nom donn&eacute; lors de sa cr&eacute;ation. Vous pouvez toutefois modifier
le nom d'affichage dans le filtre pour des raisons d'affichage de la sortie. Le nom d'affichage que
vous sp&eacute;cifiez dans le filtre ne modifie pas le nom de la balise ou de l'expression du projet.
REMARQUE : Vous pouvez &eacute;galement inclure des caract&egrave;res sp&eacute;ciaux dans le nom d'affichage de la
balise ou de l'expression, &agrave; l'exception des caract&egrave;res suivants : deux-points (:), point-virgule (;),
virgule (,), pourcentage (%), esperluette (&amp;), signe di&egrave;se (#) et signe &eacute;gal (=).
5) Vous pouvez choisir de filtrer du contenu par d&eacute;faut. Lorsque la sortie s'affiche, le contenu est filtr&eacute;
en fonction des crit&egrave;res pr&eacute;d&eacute;finis. Pour d&eacute;finir la balise ou l'expression par d&eacute;faut dans le filtre,
cliquez avec le bouton droit de la souris sur la balise ou l'expression et choisissez S&eacute;lectionner par
d&eacute;faut.
6) Pour modifier le nom d'affichage de la balise ou de l'expression dans le filtre, cliquez avec le bouton
droit de la souris sur la balise ou l'expression et choisissez Renommer.
REMARQUE : Lorsque vous renommez une balise, le message d'&eacute;tat qui s'affiche en bas de la bo&icirc;te de
dialogue Modifier le filtre affiche le nom de la balise, sans le nom d'affichage.
REMARQUE : Les noms de groupe dans un filtre doivent &ecirc;tre uniques. Les noms d'affichage de balises
ou d'expressions au sein d'un groupe doivent &ecirc;tre uniques. La recherche de noms d'affichage
uniques n'est pas sensible &agrave; la casse. Par exemple, vous ne pouvez pas cr&eacute;er deux noms d'affichage
Utilisateur-Final et UTILISATEUR-FINAL au sein du m&ecirc;me groupe.
7) Pour permettre &agrave; vos utilisateurs de s&eacute;lectionner plusieurs crit&egrave;res de filtre du m&ecirc;me groupe dans
la sortie, cochez Autoriser la s&eacute;lection multiple dans la sortie.
8) Utilisez les fl&egrave;ches de navigation pour d&eacute;placer les groupes, balises et expressions dans un filtre.
Par exemple, pour d&eacute;placer une balise &agrave; l'ext&eacute;rieur d'un groupe, cliquez sur la fl&egrave;che gauche. Cette
op&eacute;ration d&eacute;place la balise au m&ecirc;me niveau que le groupe qui la contient et au-dessus du groupe.
Utilisez la fl&egrave;che droite pour d&eacute;placer une balise situ&eacute;e &agrave; l'ext&eacute;rieur des groupes dans le groupe
suivant. Vous pouvez &eacute;galement d&eacute;placer les balises dans le groupe, vers le haut ou vers le bas.
REMARQUE : Vous pouvez &eacute;galement d&eacute;placer les &eacute;l&eacute;ments par glisser-d&eacute;poser.
9) Cliquez sur Enregistrer.
10) Dans la bo&icirc;te de dialogue Param&egrave;tres de mise en page, cliquez sur Enregistrer et G&eacute;n&eacute;rer.
Utilisation d'un filtre de contenu dynamique dans la sortie
Cette section contient un exemple pour d&eacute;crire comment utiliser le filtre de contenu dynamique dans la
sortie et qu'attendre de l'application de balises au contenu et de l'utilisation des balises dans le filtre.
Une fois que vous avez assign&eacute; un filtre de contenu dynamique &agrave; une mise en page, vous pouvez g&eacute;n&eacute;rer
la sortie pour la mise en page.
La sortie contient d&eacute;sormais une ic&ocirc;ne de filtre. Cliquez sur l'ic&ocirc;ne de filtre pour afficher le filtre de
contenu dynamique assign&eacute; &agrave; la mise en page actuelle.
IMPORTANT : Si une balise n'est assign&eacute;e &agrave; aucun contenu dans la sortie, la balise ne s'affiche pas dans le
filtre. Si toutes les balises au sein d'un groupe ne s'affichent pas dans le filtre, alors le groupe ne s'affiche
pas. Si une balise n'est pas utilis&eacute;e dans le filtre (en tant que balise ou au sein d'une expression), cette
balise est alors supprim&eacute;e du contenu auquel elle est appliqu&eacute;e dans le projet.
403
CHAPITRE 12
EL&Eacute;MENTS DE BASE SOURCE UNIQUE ET PLUS
G&Eacute;N&Eacute;RATION DE SORTIE
Par d&eacute;faut, tous les groupes et crit&egrave;res du filtre sont d&eacute;s&eacute;lectionn&eacute;s. Tout le contenu s'affiche
(inconditionnellement) car aucun crit&egrave;re de filtre n'est actuellement appliqu&eacute;. Si vous d&eacute;finissez toutefois
un groupe par d&eacute;faut lors de la cr&eacute;ation du filtre, le groupe par d&eacute;faut s'affiche comme s&eacute;lectionn&eacute;.
Pour filtrer les contenus, recherchez et annulez la recherche des groupes ou crit&egrave;res dans le filtre.
Les sections suivantes d&eacute;veloppent deux sc&eacute;narios pour d&eacute;crire le fonctionnement du m&eacute;canisme de
filtrage du contenu dynamique.
S&eacute;lectionnez un crit&egrave;re (balise ou expression) dans un groupe.
Dans le filtre Sales Builder, si vous cochez &Eacute;tats-Unis dans le groupe R&eacute;gion :
•
Tout le contenu marqu&eacute; par la balise &Eacute;tats-Unis s'affiche.
•
Tout le contenu marqu&eacute; par la combinaison de la balise &Eacute;tats-Unis et de toute autre balise s'affiche.
Le contenu marqu&eacute; par la balise &Eacute;tats-Unis et Royaume-Uni s'affiche. En revanche, une rubrique
marqu&eacute;e par la balise Royaume-Uni est masqu&eacute;e. Le contenu marqu&eacute; par les balises Royaume-Uni
et Canada est &eacute;galement masqu&eacute;.
•
Tout le contenu marqu&eacute; par les balises du groupe Utilisateurs concern&eacute;s ne s'affiche pas, sauf si le
contenu est combin&eacute; &agrave; la balise &Eacute;tats-Unis.
Le contenu marqu&eacute; par la balise &Eacute;tats-Unis et PDF s'affiche. En revanche, le contenu marqu&eacute; par la
balise PDF est masqu&eacute;. Le contenu marqu&eacute; par les balises Royaume-Uni et Imprimer est &eacute;galement
masqu&eacute;.
•
Tout le contenu sans balise s'affiche.
S&eacute;lectionnez un crit&egrave;re dans un groupe et un autre crit&egrave;re dans un deuxi&egrave;me groupe.
Dans le filtre Sales Builder, si vous cochez &Eacute;tats-Unis dans le groupe R&eacute;gion et Imprimer dans le groupe
Utilisateurs concern&eacute;s :
404
CHAPITRE 12
EL&Eacute;MENTS DE BASE SOURCE UNIQUE ET PLUS
G&Eacute;N&Eacute;RATION DE SORTIE
Test du filtre de contenu dynamique
Une foi le filtre de contenu dynamique cr&eacute;&eacute; et assign&eacute; &agrave; la sortie, vous pouvez utiliser l'option Afficher la
sortie balis&eacute;e pour tester vos filtres. Cette option g&eacute;n&egrave;re la sortie avec les balises affich&eacute;es dans le
contenu, aux emplacements appliqu&eacute;s. Vous pouvez ensuite s&eacute;lectionner les crit&egrave;res de filtre et tester le
fonctionnement de votre filtre.
Exemple de sortie avec la balise Utilisateur final affich&eacute;e
Pour g&eacute;n&eacute;rer la sortie balis&eacute;e :
1) Pour ouvrir le conteneur Sorties (SSL), s&eacute;lectionnez Sorties (SSL) dans la liste d&eacute;roulante des
conteneurs.
La liste d&eacute;roulante des conteneurs est disponible dans les rubans Projet, Edition et R&eacute;vision.
2) Dans le conteneur Sorties (SSL), cliquez avec le bouton droit de la souris sur la sortie
Responsive / Mobile et s&eacute;lectionnez Afficher la sortie balis&eacute;e.
La sortie balis&eacute;e est g&eacute;n&eacute;r&eacute;e.
405
CHAPITRE 12
EL&Eacute;MENTS DE BASE SOURCE UNIQUE ET PLUS
G&Eacute;N&Eacute;RATION DE SORTIE
G&eacute;n&eacute;rer un contenu dynamique centr&eacute; sur l'utilisateur (DUCC)
G&eacute;n&eacute;rez une sortie Adobe&reg; AIR&reg; et WebHelp sous la forme de syst&egrave;mes d'aide int&eacute;gr&eacute;s avec diff&eacute;rentes
cat&eacute;gories de contenu. Les utilisateurs s&eacute;lectionnent la cat&eacute;gorie de contenu qui les int&eacute;resse et
naviguent et effectuent des recherches dans cette cat&eacute;gorie de contenu. Chaque cat&eacute;gorie de contenu
dispose d'une table des mati&egrave;res, d'un index et d'un glossaire qui lui sont propres. La cr&eacute;ation de contenu
dynamique centr&eacute; sur l'utilisateur est utile si les utilisateurs finaux doivent basculer rapidement entre le
contenu propre &agrave; diff&eacute;rents r&ocirc;les, produits et variantes. Par exemple, les requ&ecirc;tes que traite un agent de
centre d'appel se rapportent parfois &agrave; diff&eacute;rents domaines de l'administration d'un syst&egrave;me (par
exemple, l'administration des utilisateurs, l'administration des sites et l'administration du contenu). La
capacit&eacute; &agrave; inspecter et afficher le contenu de l'administration syst&egrave;me sous la forme d'un ensemble de
cat&eacute;gories de contenu modulaires, accessibles &agrave; partir de la m&ecirc;me interface, permet de gagner du temps
lorsque vous g&eacute;rez des requ&ecirc;tes en temps r&eacute;el.
Pour plus d'informations sur la fa&ccedil;on de cr&eacute;er des cat&eacute;gories de contenu, voir Configuration de la mise en
page Adobe AIR et G&eacute;n&eacute;ration d'une sortie WebHelp.
A. D&eacute;finition de cat&eacute;gories de contenu dans SSL B.S&eacute;lection de cat&eacute;gories de contenu dans la sortie
406
CHAPITRE 12
EL&Eacute;MENTS DE BASE SOURCE UNIQUE ET PLUS
G&Eacute;N&Eacute;RATION DE SORTIE
G&eacute;n&eacute;rer native (ASPX) ou sortie HTML pour Microsoft SharePoint
Microsoft SharePoint est une plate-forme tr&egrave;s r&eacute;pandue sur le Web pour les petites et grandes
organisations. Elle est con&ccedil;ue comme un remplacement centralis&eacute; pour plusieurs applications Web et
prend en charge diff&eacute;rentes combinaisons d'exigences de site Web de l'entreprise. Elle est g&eacute;n&eacute;ralement
associ&eacute;e &agrave; une gestion de contenu Web et des syst&egrave;mes de gestion de document.
LIENS CONNEXES :
R&eacute;vision de fichiers PDF
Gestion des commentaires et des modifications
Publication de (ASPX) sortie native Multi-&eacute;cran pour Microsoft SharePoint
A l'aide de l'affichage SSL multi-&eacute;cran HTML5, vous pouvez publier une sortie (ASPX) native directement
dans une biblioth&egrave;que de documents SharePoint 2010 ou version ult&eacute;rieure ou dans un dossier
SharePoint 2007. Lorsque vous affichez la sortie publi&eacute;e dans un navigateur, les rubriques apparaissent
dans le chrome de SharePoint en tant que page HTML continue unique.
Pour obtenir des instructions pas-&agrave;-pas, voir G&eacute;n&eacute;ration d'une sortie Multi-&eacute;cran HTML5.
Remarques :
•
(Uniquement pour Internet Explorer) Si votre contenu comporte une balise iFrame contenant un
document PDF, les lecteurs ne pourront peut-&ecirc;tre pas faire d&eacute;filer l'&eacute;cran jusqu'au bas de la page.
Pour &eacute;viter ce probl&egrave;me, assurez-vous que la propri&eacute;t&eacute; Gestion des fichiers par les navigateurs
dans SharePoint est d&eacute;finie sur Permissif.
•
Si vous ne parvenez pas &agrave; republier le contenu dans SharePoint avec l'autorisation de membre de
site, assurez-vous que vous disposez de l'autorisation SharePoint Ajouter et personnaliser des pages.
•
Assurez-vous que les noms des rubriques/images que vous publiez dans SharePoint ne contiennent
pas de doubles points (..). Sinon, l'op&eacute;ration de publication &eacute;choue avec une erreur Requ&ecirc;te
incorrecte.
Publication d'une sortie HTML pour Microsoft SharePoint
WebHelp, FlashHelp et aide accessible par navigateur (Adobe AIR SSL)
Publication d'une sortie HTML sur un site SharePoint &agrave; l'aide d'un chemin d'acc&egrave;s UNC (Universal Naming
Convention). Voir G&eacute;n&eacute;ration d'une sortie WebHelp et Configuration d'un serveur pour l'h&eacute;bergement
d'une aide accessible par navigateur.
407
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
12.2. Utilisation de types de mises en page
Mise en page Responsive HTML5
La plupart des navigateurs Web prennent en charge les optimisations natives pour l'affichage de contenu
sur des p&eacute;riph&eacute;riques &eacute;quip&eacute;s d'un &eacute;cran de petite taille, tels que les smartphones et les tablettes.
Toutefois, ces optimisations g&eacute;n&eacute;riques sont souvent insuffisantes pour la large gamme de p&eacute;riph&eacute;riques
qui se multiplient aujourd'hui.
Les fichiers SSL Responsive HTML5 apportent une exp&eacute;rience de lecture optimis&eacute;e pour des types de
p&eacute;riph&eacute;riques sp&eacute;cifiques. Vous pouvez ajouter et configurer diff&eacute;rents profils d'&eacute;cran pour divers
ensembles de p&eacute;riph&eacute;riques et g&eacute;n&eacute;rer une sortie HTML5 pour ces profils. Lorsque les utilisateurs
consultent la page de renvoi concernant la sortie HTML5 sur leurs p&eacute;riph&eacute;riques, ils sont
automatiquement redirig&eacute;s vers le contenu optimis&eacute; pour leur p&eacute;riph&eacute;rique.
Sortie HTML5 optimis&eacute;e pour diff&eacute;rents p&eacute;riph&eacute;riques
Les mises en forme d'&eacute;cran vous permettent d'am&eacute;liorer l'exp&eacute;rience de lecture en choisissant et en
personnalisant la fa&ccedil;on dont le contenu et les &eacute;l&eacute;ments de sortie, tels que les liens de navigation, doivent
s'afficher sur un p&eacute;riph&eacute;rique.
Lorsque vous cr&eacute;ez un projet, RoboHelp ajoute des mises en forme Responsive HTML5 au projet. Les
fichiers SSL Responsive HTML5 par d&eacute;faut contiennent les profils d'&eacute;cran pour les p&eacute;riph&eacute;riques les plus
r&eacute;pandus, tels que l'iPad, l'iPhone, le Kindle Fire et la tablette Samsung Galaxy Tab. Ces profils d'&eacute;cran
sont mapp&eacute;s avec des mises en page d'&eacute;cran pr&eacute;d&eacute;finies.
LIENS CONNEXES :
G&eacute;n&eacute;ration d'une sortie Multi-&eacute;cran HTML5
Profils d'&eacute;cran
Mises en page d'&eacute;cran
R&egrave;gles et attributs de supports dans les styles
Demandes de supports
408
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Mise en page personnalisable de HTML5 Indigo
Pr&eacute;sentez un contenu visuellement enrichi &agrave; votre public &agrave; l'aide des nouvelles mises en forme HTML5
Indigo. La mise en page Indigo est g&eacute;n&eacute;r&eacute;e selon les derni&egrave;res tendances en mati&egrave;re de conception Web
et combine un aspect &eacute;poustouflant avec une fonctionnalit&eacute; in&eacute;gal&eacute;e. Il s'agit d'une mise en page
conforme &agrave; la norme 508, con&ccedil;ue pour cr&eacute;er du contenu pour les utilisateurs ayant des besoins
sp&eacute;cifiques et offrir &eacute;galement une exp&eacute;rience sup&eacute;rieure et intuitive de recherche et de navigation.
Acc&eacute;dez &agrave; des fonctions comme l'affichage ou le masquage des widgets de glossaires et de tables des
mati&egrave;res, et le marquage de rubriques comme favoris pour en faciliter l'acc&egrave;s. Le menu vertical &agrave; afficher
ou masquer, sur la barre lat&eacute;rale de droite, offre une interface conviviale et une navigation avanc&eacute;e pour
l'index, le glossaire et le filtre.
IMPORTANT : &Agrave; partir de la mise &agrave; jour 2 de RoboHelp (2017 release), la mise en page r&eacute;active Ocean
HTML5 n'est plus disponible. Vous pouvez toujours t&eacute;l&eacute;charger et utiliser la mise en page Ocean &agrave; partir
de la page Profils et mises en page d’&eacute;cran dans RoboHelp.
Les mises en page d'&eacute;cran par d&eacute;faut sont disponibles dans le dossier Galerie de votre installation
RoboHelp. Pour acc&eacute;der &agrave; ces mises en page :
1) Dans le conteneur Configuration de sortie, cliquez avec le bouton droit de la souris sur Mises en
page d'&eacute;cran, puis s&eacute;lectionnez Nouvelle mise en page r&eacute;active.
2) S&eacute;lectionnez la mise en page de votre choix depuis la liste disponible dans la galerie.
3) (Facultatif) Vous pouvez sp&eacute;cifier un nouveau nom pour la mise en page.
409
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
CHAPITRE 12
Navigateurs pris en charge
Les plateformes cibles principales pour la sortie g&eacute;n&eacute;r&eacute;e &agrave; l'aide du fichier SSL Responsive HTML5 sont
Android et Apple iOS.
La sortie HTML5 est prise en charge dans les navigateurs suivants :
Plate-forme
Navigateur pris en charge
SE Android
Navigateur bas&eacute; sur Webkit install&eacute; par d&eacute;faut (Chrome Lite)
iOS
Apple Safari
Windows Desktop OS
Firefox 4+, Chrome 9+, Internet Explorer 9
Mac OS
Apple Safari
REMARQUE : En plus de serveurs HTTP, vous pouvez publier la sortie HTML5 sur des serveurs HTTPS.
Comportement en ligne/hors ligne
La sortie HTML5 peut &ecirc;tre accessible &agrave; la fois en ligne et hors ligne. Les utilisateurs finaux peuvent
acc&eacute;der &agrave; la sortie en la copiant dans le m&eacute;moire locale du p&eacute;riph&eacute;rique, et l'afficher hors ligne dans un
navigateur.
Configuration des composants requis pour Responsive HTML5
Avant de commencer la configuration du fichier SSL Responsive HTML5, vous devez proc&eacute;der comme
suit :
Profil d'&eacute;cran par d&eacute;faut
D&eacute;finissez un profil d'&eacute;cran par d&eacute;faut dans le fichier SSL HTML5. Le profil d'&eacute;cran par d&eacute;faut est
utilis&eacute; si les dimensions d'un p&eacute;riph&eacute;rique et la combinaison d'agent de navigateur ne
correspondent &agrave; aucun profil d'&eacute;cran.
Image de p&eacute;riph&eacute;rique et fen&ecirc;tre de contenu
S&eacute;lectionnez une image de p&eacute;riph&eacute;rique dans Propri&eacute;t&eacute;s du profil d'&eacute;cran. Une image de
p&eacute;riph&eacute;rique vous aide &agrave; visualiser l'aspect et la convivialit&eacute; de la sortie lors de la pr&eacute;visualisation
contenu dans un profil d'&eacute;cran s&eacute;lectionn&eacute;. Par exemple, si vous pr&eacute;voyez que des utilisateurs
afficheront la sortie HTML5 d'un projet sur un iPhone, l'ajout d'une image repr&eacute;sentant celui-ci
rendra l'exp&eacute;rience de pr&eacute;visualisation de la sortie plus r&eacute;aliste.
R&eacute;solution d'&eacute;cran
Sp&eacute;cifiez une plage de r&eacute;solution d'&eacute;cran dans les propri&eacute;t&eacute;s du profil d'&eacute;cran pour cr&eacute;er un profil
d'&eacute;cran pour les p&eacute;riph&eacute;riques ayant des r&eacute;solutions d'&eacute;cran similaires. La r&eacute;solution d'&eacute;cran est
diff&eacute;rente de la taille de l'&eacute;cran ; deux p&eacute;riph&eacute;riques peuvent avoir une taille d'&eacute;cran similaire, mais
une diff&eacute;rence significative au niveau de la r&eacute;solution d'&eacute;cran.
410
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Agent de navigateur (agent d'utilisateur)
Vous pouvez cr&eacute;er des profils d'&eacute;cran diff&eacute;rents pour les p&eacute;riph&eacute;riques ayant la m&ecirc;me gamme de
r&eacute;solution d'&eacute;cran mais des navigateurs diff&eacute;rents pour obtenir des aspects sp&eacute;cifiques &agrave; un
navigateur particulier.
Lorsque vous sp&eacute;cifiez un navigateur dans les propri&eacute;t&eacute;s de profil d'&eacute;cran, RoboHelp ajoute l'ID de
l'agent de navigateur &agrave; la sortie g&eacute;n&eacute;r&eacute;e pour ce profil d'&eacute;cran. Lorsque les utilisateurs consultent
la page de renvoi pour la sortie HTML5 sur leur p&eacute;riph&eacute;rique, le navigateur v&eacute;rifie l'ID de l'agent de
navigateur ainsi que d'autres param&egrave;tres d'&eacute;cran, et charge le contenu optimis&eacute; pour le navigateur
et le p&eacute;riph&eacute;rique en question.
La liste pr&eacute;d&eacute;finie des navigateurs prend en compte les p&eacute;riph&eacute;riques les plus r&eacute;pandus aujourd'hui.
Si vous souhaitez ajouter un navigateur dans la liste, sp&eacute;cifiez une cha&icirc;ne unique depuis sa cha&icirc;ne
d'agent d'utilisateur. Voir une liste des cha&icirc;nes d’agent d’utilisateur.
Flux de g&eacute;n&eacute;ration de la sortie HTML5
Utilisez les flux de travaux suivants pour g&eacute;n&eacute;rer la sortie HTML5 :
Nouveau projet avec des profils d'&eacute;cran par d&eacute;faut
Configurez les propri&eacute;t&eacute;s g&eacute;n&eacute;rales du fichier SSL Responsive HTML5 et d&eacute;finissez les propri&eacute;t&eacute;s de
recherche et d'optimisation, puis g&eacute;n&eacute;rez la sortie.
Nouveau projet avec des profils d'&eacute;cran personnalis&eacute;s
Dans ce cas, votre projet doit inclure les profils d'&eacute;cran personnalis&eacute;s avant de commencer la
configuration des fichiers SSL Responsive HTML5. Consultez la section correspondante pour plus
d'informations sur les modalit&eacute;s d'ajout d'un profil d'&eacute;cran &agrave; un projet. D&egrave;s que les profils d'&eacute;cran
personnalis&eacute;s sont disponibles dans le projet, ajoutez le profil d'&eacute;cran aux fichiers SSL Responsive
HTML5, configurez d'autres propri&eacute;t&eacute;s et g&eacute;n&eacute;rez la sortie.
Projet mis &agrave; niveau
Lorsque vous proc&eacute;dez &agrave; la mise &agrave; niveau d'un projet, RoboHelp ajoute les profils d'&eacute;cran mais
n'ajoute pas de nouvelle mise en page SSL ou d'&eacute;cran. Une fois la mise &agrave; niveau d'un projet
termin&eacute;e, ajoutez des mises en page d'&eacute;cran &agrave; partir de Gallery. Ajoutez un fichier SSL de type
Responsive HTML5, configurez les fichiers SSL correspondants et g&eacute;n&eacute;rez la sortie.
Utilisez ce flux de travaux pour une publication mettant en valeur les projets WebHelp existants. Les
sorties Responsive HTML5 sont compatibles avec HTML5 ; vous pouvez cr&eacute;er des mises en forme
sans bordure et utiliser des vid&eacute;os (MP4) haute qualit&eacute;.
Recommandations relatives &agrave; la cr&eacute;ation de la sortie HTML5
•
•
Evitez d'utiliser des jeux de cadres.
Utilisez des vid&eacute;os MP4. Voir Ajout d'&eacute;l&eacute;ments multim&eacute;dia.
411
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Mise en page multi-&eacute;cran
La plupart des navigateurs Web prennent en charge les optimisations natives pour l'affichage de contenu
sur des p&eacute;riph&eacute;riques &eacute;quip&eacute;s d'un &eacute;cran de petite taille, tels que les smartphones et les tablettes.
Toutefois, ces optimisations g&eacute;n&eacute;riques sont souvent insuffisantes pour la large gamme de p&eacute;riph&eacute;riques
qui se multiplient aujourd'hui.
Les fichiers SSL Responsive HTML5 apportent une exp&eacute;rience de lecture optimis&eacute;e pour des types de
p&eacute;riph&eacute;riques sp&eacute;cifiques. Vous pouvez ajouter et configurer diff&eacute;rents profils d'&eacute;cran pour divers
ensembles de p&eacute;riph&eacute;riques et g&eacute;n&eacute;rer une sortie HTML5 pour ces profils. Lorsque les utilisateurs
consultent la page de renvoi concernant la sortie HTML5 sur leurs p&eacute;riph&eacute;riques, ils sont
automatiquement redirig&eacute;s vers le contenu optimis&eacute; pour leur p&eacute;riph&eacute;rique.
Sortie HTML5 optimis&eacute;e pour diff&eacute;rents p&eacute;riph&eacute;riques
Les mises en forme d'&eacute;cran vous permettent d'am&eacute;liorer l'exp&eacute;rience de lecture en choisissant et en
personnalisant la fa&ccedil;on dont le contenu et les &eacute;l&eacute;ments de sortie, tels que les liens de navigation, doivent
s'afficher sur un p&eacute;riph&eacute;rique.
Lorsque vous cr&eacute;ez un projet, RoboHelp ajoute des mises en page Multi-&eacute;cran HTML5 au projet. Les
fichiers SSL Multi-&eacute;cran HTML5 par d&eacute;faut contiennent les profils d'&eacute;cran pour les p&eacute;riph&eacute;riques les plus
r&eacute;pandus, tels que l'iPad, l'iPhone, le Kindle Fire et la tablette Samsung Galaxy Tab. Ces profils d'&eacute;cran
sont mapp&eacute;s avec des mises en page d'&eacute;cran pr&eacute;d&eacute;finies.
LIENS CONNEXES :
G&eacute;n&eacute;ration d'une sortie Multi-&eacute;cran HTML5
Profils d'&eacute;cran
Mises en page d'&eacute;cran
R&egrave;gles et attributs de supports dans les styles
Demandes de supports
412
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
CHAPITRE 12
Navigateurs pris en charge
Les plates-formes cibles principales pour la sortie g&eacute;n&eacute;r&eacute;e &agrave; l'aide de Multiscreen HTML5 SSL sont
Android OS et Apple iOS.
La sortie HTML5 est prise en charge dans les navigateurs suivants :
Plate-forme
Navigateur pris en charge
SE Android
Navigateur bas&eacute; sur Webkit install&eacute; par d&eacute;faut (Chrome Lite)
iOS
Apple Safari
Windows Desktop OS
Firefox 4+, Chrome 9+, Internet Explorer 9
Mac OS
Apple Safari
REMARQUE : En plus de serveurs HTTP, vous pouvez publier la sortie HTML5 sur des serveurs HTTPS.
Comportement en ligne/hors ligne
La sortie HTML5 peut &ecirc;tre accessible &agrave; la fois en ligne et hors ligne. Les utilisateurs finaux peuvent
acc&eacute;der &agrave; la sortie en la copiant dans le m&eacute;moire locale du p&eacute;riph&eacute;rique, et l'afficher hors ligne dans un
navigateur.
Configuration des composants requis pour le multi-&eacute;cran HTML5
Avant de commencer la configuration du fichier SSL multi-&eacute;cran HTML5, vous devez proc&eacute;der comme
suit :
Profil d'&eacute;cran par d&eacute;faut
D&eacute;finissez un profil d'&eacute;cran par d&eacute;faut dans le fichier SSL HTML5. Le profil d'&eacute;cran par d&eacute;faut est
utilis&eacute; si les dimensions d'un p&eacute;riph&eacute;rique et la combinaison d'agent de navigateur ne
correspondent &agrave; aucun profil d'&eacute;cran.
Image de p&eacute;riph&eacute;rique et fen&ecirc;tre de contenu
S&eacute;lectionnez une image de p&eacute;riph&eacute;rique dans Propri&eacute;t&eacute;s du profil d'&eacute;cran. Une image de
p&eacute;riph&eacute;rique vous aide &agrave; visualiser l'aspect et la convivialit&eacute; de la sortie lors de la pr&eacute;visualisation
contenu dans un profil d'&eacute;cran s&eacute;lectionn&eacute;. Par exemple, si vous pr&eacute;voyez que des utilisateurs
afficheront la sortie HTML5 d'un projet sur un iPhone, l'ajout d'une image repr&eacute;sentant celui-ci
rendra l'exp&eacute;rience de pr&eacute;visualisation de la sortie plus r&eacute;aliste.
R&eacute;solution d'&eacute;cran
Sp&eacute;cifiez une plage de r&eacute;solution d'&eacute;cran dans les propri&eacute;t&eacute;s du profil d'&eacute;cran pour cr&eacute;er un profil
d'&eacute;cran pour les p&eacute;riph&eacute;riques ayant des r&eacute;solutions d'&eacute;cran similaires. La r&eacute;solution d'&eacute;cran est
diff&eacute;rente de la taille de l'&eacute;cran ; deux p&eacute;riph&eacute;riques peuvent avoir une taille d'&eacute;cran similaire, mais
une diff&eacute;rence significative au niveau de la r&eacute;solution d'&eacute;cran.
413
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Agent de navigateur (agent d'utilisateur)
Vous pouvez cr&eacute;er des profils d'&eacute;cran diff&eacute;rents pour les p&eacute;riph&eacute;riques ayant la m&ecirc;me gamme de
r&eacute;solution d'&eacute;cran mais des navigateurs diff&eacute;rents pour obtenir des aspects sp&eacute;cifiques &agrave; un
navigateur particulier.
Lorsque vous sp&eacute;cifiez un navigateur dans les propri&eacute;t&eacute;s de profil d'&eacute;cran, RoboHelp ajoute l'ID de
l'agent de navigateur &agrave; la sortie g&eacute;n&eacute;r&eacute;e pour ce profil d'&eacute;cran. Lorsque les utilisateurs consultent
la page de renvoi pour la sortie HTML5 sur leur p&eacute;riph&eacute;rique, le navigateur v&eacute;rifie l'ID de l'agent de
navigateur ainsi que d'autres param&egrave;tres d'&eacute;cran, et charge le contenu optimis&eacute; pour le navigateur
et le p&eacute;riph&eacute;rique en question.
La liste pr&eacute;d&eacute;finie des navigateurs prend en compte les p&eacute;riph&eacute;riques les plus r&eacute;pandus aujourd'hui.
Si vous souhaitez ajouter un navigateur dans la liste, sp&eacute;cifiez une cha&icirc;ne unique depuis sa cha&icirc;ne
d'agent d'utilisateur. Voir une liste des cha&icirc;nes d’agent d’utilisateur.
Flux de g&eacute;n&eacute;ration de la sortie HTML5
Utilisez les flux de travaux suivants pour g&eacute;n&eacute;rer la sortie HTML5 :
Nouveau projet avec des profils d'&eacute;cran par d&eacute;faut
Configurez les propri&eacute;t&eacute;s g&eacute;n&eacute;rales du Multiscreen HTML5 SSL et d&eacute;finissez les propri&eacute;t&eacute;s de
recherche et d'optimisation et g&eacute;n&eacute;rez une sortie.
Nouveau projet avec des profils d'&eacute;cran personnalis&eacute;s
Dans ce cas, votre projet doit inclure les profils d'&eacute;cran personnalis&eacute;s avant de commencer la
configuration des fichiers SSL Multi-&eacute;cran HTML5. Consultez la section correspondante pour plus
d'informations sur les modalit&eacute;s d'ajout d'un profil d'&eacute;cran &agrave; un projet. D&egrave;s que les profils d'&eacute;cran
personnalis&eacute;s sont disponibles dans le projet, ajoutez le profil d'&eacute;cran aux fichiers SSL Multi-&eacute;cran
HTML5, configurez d'autres propri&eacute;t&eacute;s et g&eacute;n&eacute;rez une sortie.
Projet mis &agrave; niveau
Lorsque vous proc&eacute;dez &agrave; la mise &agrave; niveau d'un projet, RoboHelp ajoute les profils d'&eacute;cran mais
n'ajoute pas de nouvelle mise en page SSL ou d'&eacute;cran. Une fois la mise &agrave; niveau d'un projet
termin&eacute;e, ajoutez des mises en page d'&eacute;cran &agrave; partir de Gallery. Ajoutez un nouveau SSL du type
Multi-&eacute;cran HTML5, configurez les fichiers SSL Multi-&eacute;cran HTML5 suivant les besoins et g&eacute;n&eacute;rez
une sortie.
Utilisez ce flux de travaux pour une publication mettant en valeur les projets WebHelp existants. Les
sorties Multi-&eacute;cran HTML5 sont compatibles avec HTML5 ; vous pouvez cr&eacute;er des mises en forme
sans bordure et utiliser des vid&eacute;os (MP4) haute qualit&eacute;.
Recommandations relatives &agrave; la cr&eacute;ation de la sortie HTML5
•
•
Evitez d'utiliser des jeux de cadres.
Utilisez des vid&eacute;os MP4. Voir Ajout d'&eacute;l&eacute;ments multim&eacute;dia.
414
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
CHAPITRE 12
Mise en page eBook
La mise en page eBook vous permet de g&eacute;n&eacute;rer une sortie dans les formats EPUB 3 et Kindle Book (MOBI
LINK).
RoboHelp cr&eacute;e un fichier unique qui comprend le contenu XHTML. Le fichier export&eacute; comprend l'image
miniature que vous sp&eacute;cifiez pour la page de couverture du document. Cette miniature est utilis&eacute;e pour
d&eacute;crire le livre dans l'affichage de la biblioth&egrave;que de lecteurs d'eBook.
LIENS CONNEXES :
G&eacute;n&eacute;ration d'une sortie EPUB et Kindle Book
Mise en page de WebHelp
A propos de WebHelp
WebHelp est un type de sortie non compil&eacute; garantissant que les utilisateurs peuvent afficher l'aide
d'applications Web ou bureautiques avec tout type de navigateur ou de plateforme. Ce programme prend
en charge les fonctions d'aide standard, tout en fournissant des fonctionnalit&eacute;s de personnalisation.
Vous pouvez cr&eacute;er du contenu via un autre &eacute;diteur HTML (comme Adobe Dreamweaver) tout en tirant
parti des fonctions d'aide &agrave; la navigation et &agrave; l'organisation de WebHelp.
Certains navigateurs plus anciens ne prennent pas DHTML en charge et ne peuvent donc pas afficher le
volet de navigation. Dans ce cas, WebHelp affiche ce dernier dans un autre format.
Diff&eacute;rences existant entre WebHelp et Microsoft HTML Help
WebHelp
Microsoft HTML Help
Pris en charge par un navigateur Web
Moteur Microsoft HTML Help requis pour la prise
en charge de ce format
Ensemble de fichiers de sortie non compil&eacute;s
Fichier compress&eacute; et compil&eacute; (fichier CHM)
S'ex&eacute;cute sur n'importe quelle plate-forme
Plates-formes Windows 32 bits requises
Convient parfaitement pour la distribution bas&eacute;e
serveur
Solutions de rechange requises pour une
distribution bas&eacute;e serveur
Limitations li&eacute;es &agrave; Mac OS concernant WebHelp
•
•
•
Les noms de fichiers Mac OS ne doivent pas d&eacute;passer 32 caract&egrave;res de long.
La sortie est affich&eacute;e sous forme de listes HTML au lieu de DHTML.
Les fichiers image au format BMP n'apparaissent pas correctement.
415
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Ajout ou suppression de la mise en surbrillance des r&eacute;sultats de recherche dans WebHelp
Dans un syst&egrave;me WebHelp, les r&eacute;sultats de recherche sont par d&eacute;faut mis en surbrillance dans les
rubriques affich&eacute;es. Vous pouvez d&eacute;finir la couleur de mise en surbrillance en fonction de vos
pr&eacute;f&eacute;rences.
REMARQUE : Les projets WebHelp, WebHelp Pro, FlashHelp et FlashHelp Pro utilisent la m&ecirc;me proc&eacute;dure
pour activer la mise en surbrillance des r&eacute;sultats de recherche.
1) Cliquez deux fois sur la mise en page WebHelp.
2) Cliquez sur Navigation.
3) Activez ou d&eacute;sactivez l'option Activer la mise en surbrillance des r&eacute;sultats de recherche.
4) Lorsque la mise en surbrillance des r&eacute;sultats de la recherche est activ&eacute;e, cliquez sur le s&eacute;lecteur de
couleur et s&eacute;lectionnez la couleur de mise en surbrillance de votre choix dans le menu d&eacute;roulant.
Sortie WebHelp conforme &agrave; la section 508
Les sorties conformes &agrave; la section 508 permettent aux utilisateurs malvoyants, malentendants ou &agrave;
mobilit&eacute; r&eacute;duite d'acc&eacute;der plus facilement &agrave; l'aide.
Les utilitaires de synth&egrave;se vocale lisent le contenu de la fen&ecirc;tre active, les options disponibles ou le texte
en cours de saisie. Ces utilitaires et les programmes de consultation d'&eacute;cran effectuent la synth&egrave;se vocale
du texte apparaissant &agrave; l'&eacute;cran ou le convertissent en contenu Braille dynamique et actualisable. Cette
technologie peut &eacute;galement fournir des raccourcis clavier, des l&eacute;gendes pour la parole et l'audio et des
avertissements visuels, comme des barres d'outils clignotantes.
Lorsque vous cr&eacute;ez une version de WebHelp conforme &agrave; la section 508, prenez en compte les &eacute;l&eacute;ments
ci-dessous.
•
Les syst&egrave;mes WebHelp g&eacute;n&eacute;r&eacute;s avec l'option Section 508 s'affichent dans tous les navigateurs pris
en charge, Cependant, il est pr&eacute;f&eacute;rable d'afficher la sortie via Internet Explorer, afin de garantir une
parfaite conformit&eacute;.
•
Pour les projets ma&icirc;tres g&eacute;n&eacute;r&eacute;s &agrave; l'aide de l'option HTML pur ou d'une version de WebHelp
conforme &agrave; la section 508, les sous-projets sont uniquement disponibles &agrave; partir de la table des
mati&egrave;res si vous fusionnez des syst&egrave;mes WebHelp. Vous ne pouvez pas y acc&eacute;der &agrave; partir de l'index
ou de la fonction de recherche de texte int&eacute;gral. Les sous-projets s'affichent en tant que livres dans
la table des mati&egrave;res. Lorsque les utilisateurs cliquent sur le livre de la table des mati&egrave;res du
sous-projet, celui-ci s'ouvre dans une nouvelle fen&ecirc;tre de navigateur.
Fonctions WebHelp conformes prenant en charge la section 508
•
•
•
Une option de conformit&eacute; avec la section 508 fournissant un autre type de texte pour les images,
les &eacute;l&eacute;ments dynamiques, les cadres, les formulaires, etc. Les utilisateurs malvoyants ayant recours
&agrave; des logiciels d'aide &agrave; l'accessibilit&eacute; peuvent entendre leur emplacement au sein de la sortie, ainsi
que le nom des &eacute;l&eacute;ments qu'ils s&eacute;lectionnent.
Un texte alternatif est fourni pour les images des livres de table des mati&egrave;res, les pages, les ic&ocirc;nes
+ ou -, les onglets ou volets d'index, de recherche ou de la table des mati&egrave;res, des boutons de
navigation et des boutons des contr&ocirc;les DTC.
Le texte &agrave; d&eacute;velopper et d&eacute;roulant, les d&eacute;clencheurs, les cibles et les menus contextuels constituent
d'autres &eacute;l&eacute;ments avec du texte alternatif.
416
CHAPITRE 12
•
•
•
•
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Des cadres de navigation lisibles pour les logiciels d'aide &agrave; l'accessibilit&eacute;.
La possibilit&eacute; de g&eacute;n&eacute;rer des tableaux HTML permettant &agrave; ces logiciels d'identifier des en-t&ecirc;tes de
ligne et de colonne.
Des formulaires en ligne lisibles pour ces logiciels.
Une sortie utilisable pour plusieurs modes de fonctionnement et de r&eacute;cup&eacute;ration d'informations.
Par exemple, les utilisateurs &agrave; mobilit&eacute; r&eacute;duite peuvent utiliser le clavier et la souris. Toutes les
fonctions reposent sur une combinaison d'aptitudes visuelles, auditives ou de mobilit&eacute;.
Instructions &agrave; suivre pour garantir la conformit&eacute; des syst&egrave;mes d'aide &agrave; la section 508
•
•
•
•
•
•
•
La sortie WebHelp est conforme en termes de jeux de cadres et de navigation, mais vous devez vous
assurer que les autres &eacute;l&eacute;ments que vous ajoutez &agrave; vos rubriques le sont &eacute;galement.
Si le syst&egrave;me d'aide contient des boutons de formulaire ou des &eacute;l&eacute;ments multim&eacute;dia, tels qu'images
et composants audio, fournissez des &eacute;quivalents visuels, comme astuces contextuelles, de fa&ccedil;on &agrave;
permettre leur lecture &agrave; l'&eacute;cran par les logiciels d'aide &agrave; l'accessibilit&eacute;.
G&eacute;n&eacute;rez des informations accessibles de plusieurs mani&egrave;res, afin que tous les utilisateurs puissent
les consulter, quel que soit leur handicap. Proposez une autre m&eacute;thode d'affichage des &eacute;l&eacute;ments en
couleur.
l'utilisation de feuilles de style externes basiques permet de garantir la lisibilit&eacute; des documents en
cas de non-disponibilit&eacute; d'une feuille de style.
Si une page Web utilise des applets, ins&eacute;rez un lien vers un emplacement permettant aux
utilisateurs de t&eacute;l&eacute;charger le logiciel appropri&eacute;.
D&eacute;crivez les touches de raccourci clavier et autres m&eacute;thodes d'acc&egrave;s.
N'utilisez aucun contr&ocirc;le HTML Help.
G&eacute;n&eacute;ration, affichage et publication de la sortie de WebHelp
•
•
•
•
Pour g&eacute;n&eacute;rer une sortie WebHelp, lisez d'abord la section G&eacute;n&eacute;ration d'une sortie WebHelp pour
savoir comment d&eacute;finir les diff&eacute;rents param&egrave;tres de g&eacute;n&eacute;ration de sortie WebHelp.
Pour en savoir plus sur la g&eacute;n&eacute;ration de la sortie WebHelp, voir Principes de base de la g&eacute;n&eacute;ration
de la sortie.
Pour savoir comment afficher la sortie WebHelp, lisez Affichage d'une sortie WebHelp, FlashHelp,
WebHelp Pro et FlashHelp Pro.
Pour en savoir plus sur les diff&eacute;rents formats de livraison pour la sortie WebHelp, lisez Publication
d'une sortie.
LIENS CONNEXES :
G&eacute;n&eacute;ration, affichage et publication d'une sortie
Mise en page de Microsoft HTML Help
Cr&eacute;ation d'habillages personnalis&eacute;s dans les projets WebHelp et WebHelp Pro
Fusion de projets d'aide
417
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Mises en page WebHelp Pro et FlashHelp Pro
A propos de WebHelp Pro et de FlashHelp Pro
Les mises en page WebHelp Pro et FlashHelp Pro fournissent une sortie bas&eacute;e serveur pour le Web et les
applications. Pour pouvoir publier cette sortie sur un serveur, vous devez installer RoboHelp Server.
WebHelp Pro est un type de sortie non compil&eacute; qui prend en charge les fonctions d'aide standard.
Cr&eacute;ez des projets WebHelp Pro ou FlashHelp Pro dans RoboHelp en composant le contenu, en ajoutant
des fonctions et en personnalisant leur apparence. Lorsque vous &ecirc;tes pr&ecirc;t &agrave; afficher et tester le r&eacute;sultat,
g&eacute;n&eacute;rez le projet. RoboHelp cr&eacute;e des fichiers de sortie dans un dossier unique qui se trouve dans le
dossier du projet.
Vitesse d'affichage plus &eacute;lev&eacute;e
Les onglets Table des mati&egrave;res, Index et Recherche s'affichent plus rapidement.
Consignation des informations sur la syntaxe dans une base de donn&eacute;es
Acc&eacute;dez &agrave; la base de donn&eacute;es pour am&eacute;liorer les applications.
Fusion du projet &agrave; l'ex&eacute;cution
Fusionnez plusieurs projets lors de l'ex&eacute;cution ou de l'acc&egrave;s au syst&egrave;me d'aide depuis un serveur.
Propri&eacute;t&eacute;s de la fen&ecirc;tre
l'acc&egrave;s au serveur prend en compte les options Barre d'outils, Menu, Barre d'emplacement et Barre
d'&eacute;tat. Pour d&eacute;finir ces propri&eacute;t&eacute;s d'outil, cliquez deux fois sur une fen&ecirc;tre dans le dossier Fen&ecirc;tres
du conteneur Configuration de sortie.
Conversion de l'aide de l'ordinateur au format WebHelp Pro
1)
2)
3)
4)
5)
Contactez l'administrateur du serveur ou le service informatique pour v&eacute;rifier que le serveur
RoboHelp Server est bien install&eacute; et pour conna&icirc;tre son nom.
Recherchez le chemin ou l'emplacement de RoboHelp Server et indiquez-le dans le projet.
Ouvrez le projet dans RoboHelp. D&eacute;finissez WebHelp Pro en tant que format de sortie.
Connectez-vous au serveur en publiant les fichiers du projet.
Pour acc&eacute;der au serveur, saisissez son nom de domaine dans la barre d'adresse de votre navigateur.
Demandez &agrave; l'administrateur du serveur de vous fournir l'URL.
LIENS CONNEXES :
Sp&eacute;cification de la mise en page principale
Affichage de la sortie
Publication d'une sortie
418
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Mise en page de Microsoft HTML Help
A propos de Microsoft HTML Help
Le langage HTML utilise des balises pour marquer certains &eacute;l&eacute;ments (texte et graphiques, par exemple)
dans un document auquel sont associ&eacute;es des instructions d'affichage. HTML Help inclut des documents
HTML (fichiers HTM) pour les rubriques, ainsi que les fichiers source du projet. RoboHelp permet
d'ajouter diff&eacute;rentes fonctions (liens, table des mati&egrave;res, index, effets sp&eacute;ciaux et boutons pour les
rubriques associ&eacute;es, entre autres).
Vous distribuez un fichier compress&eacute; (CHM), que les utilisateurs visualiseront dans l'afficheur HTML Help.
Les composants principaux de HTML Help sont les suivants :
Contr&ocirc;le ActiveX HTML Help
Prend en charge des fonctions de navigation du type table des mati&egrave;res, index et contr&ocirc;les Lien de
mot-cl&eacute; et de rubrique connexe. Il prend &eacute;galement en charge les contr&ocirc;les HTML Help : liens de
rubrique WinHelp, &eacute;crans de d&eacute;marrage et contr&ocirc;les de fermeture de fen&ecirc;tre.
Moteur de mise en page
Microsoft Internet Explorer 6 et versions ult&eacute;rieures fournit les composants n&eacute;cessaires &agrave; la prise
en charge de HTML Help.
Afficheur HTML Help
Affiche la version compil&eacute;e de HTML Help (fichier CHM). Il utilise des composants du navigateur
Internet Explorer pour afficher le contenu du syst&egrave;me d'aide dans son interface propri&eacute;taire.
HTML compress&eacute;
Ensemble des fichiers du projet, compress&eacute;s dans un fichier CHM unique, qui occupe moins
d'espace disque et se charge plus rapidement. Vous pouvez fournir ce fichier compil&eacute; avec
l'application ou le distribuer aux utilisateurs en tant que document en ligne autonome.
G&eacute;n&eacute;ration de Microsoft HTML Help
Le compilateur d'aide RoboHelp permet de convertir tous les fichiers source en format publiable qui peut
alors &ecirc;tre test&eacute; ou distribu&eacute;.
Vous pouvez g&eacute;n&eacute;rer la sortie dans n'importe quelle phase du projet.
Messages du compilateur
Le compilateur affiche les messages, statistiques et erreurs de compilation pendant la g&eacute;n&eacute;ration. S'il
rencontre des probl&egrave;mes li&eacute;s aux fichiers source, des messages d'erreur s'affichent :
Remarques
Conditions d'erreur qui ne devraient pas poser de probl&egrave;me s&eacute;rieux dans la sortie. Les num&eacute;ros de
remarque vont de 1000 &agrave; 2999.
419
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
CHAPITRE 12
Avertissements
Conditions &agrave; l'origine de sorties d&eacute;fectueuses. Par exemple, si le compilateur ne parvient pas &agrave;
localiser une image, il affiche un avertissement et poursuit la g&eacute;n&eacute;ration. Les num&eacute;ros
d'avertissement vont de 3000 &agrave; 4999.
Erreurs
Conditions &agrave; l'origine de l'interruption du compilateur. Aucune sortie ne pourra &ecirc;tre g&eacute;n&eacute;r&eacute;e tant
que vous n'aurez pas corrig&eacute; cette erreur. Les num&eacute;ros d'erreur vont de 5000 &agrave; 6999.
Erreurs internes
Erreurs provoqu&eacute;es par le programme HTML Help Workshop. Les num&eacute;ros d'erreur interne
commencent &agrave; 7000.
Liaison de livres et de pages de table des mati&egrave;res vers des fen&ecirc;tres personnalis&eacute;es (Microsoft HTML
Help)
1)
2)
Cliquez avec le bouton droit de la souris sur une rubrique du conteneur Table des mati&egrave;res,
s&eacute;lectionnez Nouveau &gt; Livre ou Page et cliquez sur Avanc&eacute;.
Indiquez les options d'affichage du livre ou de la page de table des mati&egrave;res :
Fen&ecirc;tre
Fen&ecirc;tre personnalis&eacute;e dans laquelle s'affiche la rubrique.
Cadre
Cadre dans lequel s'affiche la rubrique. Les jeux de cadres personnalis&eacute;s sont r&eacute;pertori&eacute;s dans cette
liste.
Commentaire
Les commentaires sur la table des mati&egrave;res ne sont pas visibles pour les utilisateurs.
Image
Permet de personnaliser les ic&ocirc;nes de page ou de livre de table des mati&egrave;res. Cliquez sur le menu
contextuel et appuyez sur la fl&egrave;che vers le bas pour faire d&eacute;filer la liste des ic&ocirc;nes disponibles.
S&eacute;lectionnez une ic&ocirc;ne pour chaque &eacute;tat du livre (ouvert et ferm&eacute;).
REMARQUE : G&eacute;n&eacute;rez la table et ouvrez l'onglet Table des mati&egrave;res dans l'afficheur HTML Help pour voir les
ic&ocirc;nes personnalis&eacute;es.
Marquer comme nouveau
Affiche une &eacute;toile rouge sur l'ic&ocirc;ne du livre ou de la page de table des mati&egrave;res pour indiquer &agrave;
l'utilisateur final qu'il s'agit de nouveaux &eacute;l&eacute;ments. Les ic&ocirc;nes standard ressemblent &agrave; ce qui suit :
–
–
Nouveau livre
Nouvelle page
420
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Utiliser des types d'information
Option disponible uniquement lorsque l'option Livre avec lien est s&eacute;lectionn&eacute;e dans l'onglet
G&eacute;n&eacute;ralit&eacute;s. Elle permet de lier &agrave; un livre ou &agrave; une page de table des mati&egrave;res des types
d'informations.
Types d'informations
Pour ajouter des rubriques &agrave; un type d'information, cliquez sur Ajouter. Pour modifier un type
d'information, cliquez sur Modifier et pour en supprimer un, cliquez sur Supprimer.
Types
Affiche les types d'informations des livres ou des pages.
3)
Cliquez sur OK.
Extraction de fichiers CHM
Vous pouvez extraire des fichiers source d'un fichier d'aide compil&eacute; Microsoft HTML Help (CHM).
1) Dans le conteneur Bo&icirc;te &agrave; outils, cliquez deux fois sur HTML Help Studio.
2) S&eacute;lectionnez Fichier &gt; Ouvrir, puis choisissez un fichier CHM. Cliquez sur Ouvrir.
3) Effectuez l'une des op&eacute;rations suivantes :
–
Pour extraire un fichier ou un dossier individuel, s&eacute;lectionnez-le et cliquez sur le bouton
Extraire .
–
Ce bouton permet &eacute;galement d'extraire l'ensemble des fichiers. S&eacute;lectionnez tous les fichiers.
4)
Indiquez un r&eacute;pertoire de destination pour l'option Extraire dans.
Modification du nom de fichiers CHM
Le nom du fichier CHM est bas&eacute; sur le nom de fichier du projet (.xpj).
1) Dans le conteneur Mises en page source unique, cliquez sur HTML Help avec le bouton droit de la
souris. S&eacute;lectionnez Propri&eacute;t&eacute;s.
2) Dans le champ Dossier de sortie et nom du fichier, indiquez le nom du fichier, en ajoutant
l'extension .chm.
3) Cliquez sur Enregistrer.
Le fichier CHM est renomm&eacute; &agrave; la g&eacute;n&eacute;ration suivante de l'aide.
Recherche de fichiers d'aide HTML et de composants
1)
2)
Dans le conteneur Bo&icirc;te &agrave; outils, cliquez deux fois sur Rechercher des fichiers d'aide HTML ou
Rechercher des composants d'aide HTML.
Cliquez sur Rechercher.
ASTUCE : Pour r&eacute;organiser ou redimensionner les colonnes, faites glisser leurs en-t&ecirc;tes ou leurs barres de
s&eacute;paration.
421
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Remplacement de fichiers CHM
1)
2)
3)
4)
5)
Dans le conteneur Bo&icirc;te &agrave; outils, cliquez deux fois sur Enregistrement de HTML Help.
La colonne Nom r&eacute;pertorie les fichiers CHM actuellement enregistr&eacute;s sur le syst&egrave;me de cr&eacute;ation.
S&eacute;lectionnez le fichier CHM &agrave; remplacer.
Cliquez sur le bouton Modifier.
Cliquez sur le bouton Parcourir pour acc&eacute;der au fichier CHM de remplacement.
S&eacute;lectionnez le fichier et cliquez sur Ouvrir. Cliquez sur OK.
REMARQUE : Le remplacement d'un fichier CHM n'affecte pas le mode d'affichage du projet d'aide sur les
&eacute;crans des utilisateurs.
Enregistrement ou annulation de l'enregistrement d'un fichier CHM
Il arrive parfois que les fichiers d'aide Microsoft HTML Help compil&eacute;s (CHM) soient enregistr&eacute;s lorsqu'ils
sont utilis&eacute;s avec des applications. l'enregistrement des fichiers CHM s'effectue sur le syst&egrave;me de
cr&eacute;ation. Cette op&eacute;ration n'affecte pas le mode d'affichage du projet d'aide distribu&eacute; sur les &eacute;crans des
utilisateurs.
1) Dans le conteneur Bo&icirc;te &agrave; outils, cliquez deux fois sur Enregistrement de HTML Help.
–
Pour enregistrer un fichier CHM, cliquez sur Enregistrer. Acc&eacute;dez au fichier CHM, puis
s&eacute;lectionnez Ouvrir. Cliquez sur OK.
–
Pour annuler l'enregistrement d'un fichier CHM, s&eacute;lectionnez-le et cliquez sur Annuler
l'enregistrement. Cliquez sur OK.
Mise en page JavaHelp
A propos de JavaHelp
JavaHelp est un type de sortie compress&eacute;e exploitant des applications &eacute;crites en langage de
programmation Java. Les applications JavaHelp et Java s'ex&eacute;cutent sur plusieurs plates-formes.
RoboHelp fournit une prise en charge du format JavaHelp et cr&eacute;e automatiquement l'ensemble des
fonctionnalit&eacute;s d'aide bas&eacute;es sur Java et sur HTML, du type contenu HTML et liens hypertexte. Vous avez
&eacute;galement la possibilit&eacute; d'exploiter des projets WinHelp et HTML existants pour cr&eacute;er des syst&egrave;mes
JavaHelp. Une fonction de compression des fichiers est disponible pour la distribution du syst&egrave;me
JavaHelp.
JavaHelp est un fichier compress&eacute; (fichier JAR) ou un ensemble de fichiers permettant d'ex&eacute;cuter un
syst&egrave;me d'aide pour une application Java. RoboHelp copie l'ensemble des fichiers &agrave; distribuer dans le
dossier JavaHelp ou dans un fichier JAR, si vous d&eacute;cidez de compiler l'aide.
Configuration requise pour la cr&eacute;ation
•
•
SDK Sun Java 2 ou version ult&eacute;rieure
JavaHelp 1.1.3 ou version ult&eacute;rieure
422
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Configuration utilisateur requise
•
•
Environnement JRE 1.2.1 ou version ult&eacute;rieure
JavaHelp 1.1.3 ou version ult&eacute;rieure
G&eacute;n&eacute;ration d'une sortie JavaHelp
La g&eacute;n&eacute;ration de JavaHelp permet d'enregistrer les fichiers source dans le sous-dossier JavaHelp du projet
(par d&eacute;faut).
Lorsque vous g&eacute;n&eacute;rez des fichiers JavaHelp, RoboHelp peut convertir les contr&ocirc;les Rubriques connexes
en contr&ocirc;les sp&eacute;cifiques &agrave; JavaHelp.
1) Placez le fichier Bsscjhrc.jar dans le dossier des extensions d'application ou dans le chemin de classe
transmis &agrave; la machine virtuelle Java (Java.exe).
2) Ajoutez des contr&ocirc;les Rubriques connexes aux rubriques.
3) G&eacute;n&eacute;rez la sortie.
REMARQUE : Si un point d'interrogation appara&icirc;t &agrave; la place d'un contr&ocirc;le Rubriques connexes, cela signifie
que le fichier Bsscjhrc.jar ne se trouve pas &agrave; l'emplacement appropri&eacute;.
LIENS CONNEXES :
Principes de base de la g&eacute;n&eacute;ration de la sortie
Fusion de projets JavaHelp
D&egrave;s lors, tous les &eacute;l&eacute;ments du fichier HelpSet externe sont fusionn&eacute;s dans le projet existant.
REMARQUE : Il est possible d'ajouter des vues de navigation externes (Table des mati&egrave;res, Index,
Recherche) en tant qu'affichages distants, mais l'ajout de la r&eacute;f&eacute;rence &agrave; un fichier HS externe annexe
toutes les vues, ainsi que d'autres fichiers de projet, au projet existant.
Limitations de JavaHelp
Mise en majuscules
Prend en charge la mise en majuscules et en petites capitales.
Couleurs personnalis&eacute;es
Certaines couleurs personnalis&eacute;es apparaissent de mani&egrave;re impr&eacute;cise dans l'afficheur JavaHelp.
D&eacute;finitions de zones cliquables &agrave; d&eacute;velopper dans le glossaire
Elles apparaissent en ligne.
Polices
Elles sont automatiquement d&eacute;finies sur les polices JavaHelp par d&eacute;faut. La taille de la police n'est
pas prise en compte.
Formulaires
Seuls les formulaires simples apparaissent correctement dans l'afficheur JavaHelp.
423
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Jeux de cadres
Non pris en charge.
Fichiers HTML g&eacute;n&eacute;r&eacute;s par Word 2000 ou une version ult&eacute;rieure
Non pris en charge.
Contr&ocirc;les HTML Help
Prennent en charge les &eacute;l&eacute;ments suivants : Rubriques WinHelp, Raccourci, Table des mati&egrave;res,
Index, Ecran d'introduction, Fermer la fen&ecirc;tre et Version HHCTRL.
Images
Elles n'apparaissent pas de fa&ccedil;on coh&eacute;rente dans les documents JavaHelp compress&eacute;s. Les images
d'arri&egrave;re-plan et les mappages d'images ne sont pas pris en charge.
Liens
Prend en charge les liens vers les adresses e-mail, les sites FTP et les fichiers externes.
Listes
Seules les listes simples &agrave; puces ou num&eacute;rot&eacute;es s'affichent correctement dans l'afficheur JavaHelp.
Multim&eacute;dia
Prend en charge les fichiers audio (WAV ou MIDI) et vid&eacute;o (AVI).
Alignement des paragraphes
Prend en charge les balises, du type P align=&quot;center&quot;.
Texte brut
Prend en charge les fichiers non-HTML.
Liens contextuels
La fen&ecirc;tre de remarque contextuelle ne comprend aucune bordure inf&eacute;rieure lorsque l'ensemble
de la remarque est incluse dans le cadre de contenu. Cette limitation ne s'applique pas aux fen&ecirc;tres
de remarque contextuelles purement textuelles.
Effets sp&eacute;ciaux
Prennent en charge les contr&ocirc;les ActiveX, DHTML, JavaScript, les &eacute;crans d'introduction et les scripts
Visual Basic.
Feuilles de style
La prise en charge des feuilles de style en cascade partielles est effectu&eacute;e via JavaHelp 1.1 (Les
feuilles de style externes sont correctement prises en compte.) Avec Sun Java 2 JDK ou plus, vous
pouvez utiliser des feuilles de style en cascade de niveau 1 ou Swing 1.1.1.
424
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Attributs de tableau
Les attributs suivants ne sont pas pris en charge :
•
•
•
•
•
Les valeurs d&eacute;finies dans la balise initiale (TABLE) d'un tableau remplacent les sp&eacute;cifications de
largeur des cellules.
L'attribut de largeur du tableau (TABLE WIDTH) fonctionne lorsqu'il est sp&eacute;cifi&eacute; en pixels, mais pas
en pourcentage.
Utilis&eacute; &agrave; l'int&eacute;rieur de la balise TABLE, l'attribut de la couleur d'arri&egrave;re-plan (BGCOLOR) ne
fonctionne pas.
Utilis&eacute;e &agrave; l'int&eacute;rieur de la balise TABLE, la balise de saut de ligne (BR) provoque l'extension de la
cellule du tableau, en fonction du nombre de balises BR utilis&eacute;es.
REMARQUE : Cette fonctionnalit&eacute; est prise en charge par JavaHelp 1.1.3 et plus.
L'alignement d'un tableau ne peut &ecirc;tre d&eacute;fini pr&eacute;cis&eacute;ment.
Effets et animations de texte
Non pris en charge.
Mise en page d'Oracle Help
A propos d'Oracle Help
Oracle Help est un type de sortie qui fonctionne avec des applications &eacute;crites en Java ou dans tout autre
langage de programmation.
Oracle Help est un fichier compress&eacute; (fichier .jar) ou un ensemble de fichiers permettant d'ex&eacute;cuter un
syst&egrave;me d'aide pour une application. Lorsque vous g&eacute;n&eacute;rez Oracle Help, les fichiers &agrave; distribuer sont cr&eacute;&eacute;s
dans un dossier de sortie unique.
Configuration requise pour la cr&eacute;ation
•
•
•
Composants Oracle Help version 3.2.2 ou 4.1.2 ou ult&eacute;rieure
REMARQUE : La version 3.2.2 est g&eacute;n&eacute;r&eacute;e via le kit de ressources d'interface graphique Java interne &agrave;
Oracle, appel&eacute; EWT. Quant &agrave; la version 4.1.2, elle repose sur les classes JFC (Java Foundation
Classes). Les fonctionnalit&eacute;s, API et formats de fichier pris en charge sont identiques dans les deux
versions. Pour g&eacute;n&eacute;rer des applications via JFC ou pour g&eacute;n&eacute;rer des navigateurs personnalis&eacute;s pour
le projet d'aide, utilisez plut&ocirc;t la version 4.1.2 ou versions ult&eacute;rieures. Si les d&eacute;veloppeurs utilisent
des produits Oracle, choisissez plut&ocirc;t la version 3.2.2.
Sun Java 2 SDK ou version ult&eacute;rieure
Environnement JRE version 1.2.1 ou ult&eacute;rieure
Oracle Help comprend des composants sp&eacute;cifiques, ainsi que l'afficheur Oracle Help et la documentation
portant sur les API, destin&eacute;e aux d&eacute;veloppeurs.
425
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Configuration utilisateur requise
•
•
•
Composants Oracle Help (version 3.2.2 ou 4.1.2 ou plus)
Le projet Oracle Help (fichier JAR compil&eacute; ou dossier contenant des fichiers source individuels)
Sun Java SDK (version 2 ou ult&eacute;rieure) ou environnement JRE (version 1.2.1 ou ult&eacute;rieure)
REMARQUE : Lors de la compilation de l'aide d'Oracle, assurez-vous d'utiliser le type de codage UTF-8
(-Dfile.encoding=UTF8) lors de l'appel de la commande de compilateur java. Cela garantit que l'aide est
correctement g&eacute;n&eacute;r&eacute;e et peut &ecirc;tre affich&eacute;e sur tous les syst&egrave;mes.
D&eacute;finition des ID de rubrique pour Oracle Help
Oracle Help utilise des ID de rubrique (dans un fichier de mappage) pour effectuer des appels d'aide
contextuelle. Pour modifier l'ID de rubrique, modifiez la balise meta de la rubrique.
1) Ouvrez la rubrique dans l'&eacute;diteur HTML.
Remarques :
•
•
•
Si deux rubriques ont le m&ecirc;me titre, la plus r&eacute;cente d'entre elles se verra attribuer un autre ID lors
de la g&eacute;n&eacute;ration. (Par exemple, &laquo; TopicID &raquo; deviendra &laquo; TopicID1 &raquo;.)
Si deux rubriques ont la m&ecirc;me balise m&eacute;ta d'ID de rubrique, un avertissement s'affiche dans le
conteneur Affichage de la sortie lors de la g&eacute;n&eacute;ration.
Si une rubrique ne poss&egrave;de aucun titre ou si la balise meta ne sp&eacute;cifie aucun ID de rubrique,
RoboHelp cr&eacute;e un ID de rubrique bas&eacute; sur le nom du fichier.
D&eacute;finition de la fen&ecirc;tre de rubrique Oracle Help
Sp&eacute;cifiez une fen&ecirc;tre dans laquelle s'affichent les rubriques en modifiant la balise meta de la rubrique
dans l'&eacute;diteur de conception. Si vous n'indiquez aucune fen&ecirc;tre, le programme utilise la fen&ecirc;tre par d&eacute;faut.
1) Ouvrez la rubrique dans l'&eacute;diteur HTML.
2) Modifiez la balise meta.
meta name = &quot;window-type&quot; content = [&quot;nom de fen&ecirc;tre&quot;]
Affichages distants Oracle Help
Oracle Help utilise diff&eacute;rents affichages pour d&eacute;finir le contenu du volet de gauche du navigateur : index
de mots cl&eacute;s, table des mati&egrave;res et recherche de texte int&eacute;gral.
Vous pouvez &eacute;galement ajouter des affichages distants aux projets Oracle Help. Un affichage distant
correspond &agrave; une table des mati&egrave;res externe, &agrave; un index ou &agrave; une base de donn&eacute;es de recherche de texte
int&eacute;gral. Utilisez-le en cas de fusion de petits projets dans un m&ecirc;me projet ma&icirc;tre. Vous avez la possibilit&eacute;
de sp&eacute;cifier si un affichage distant reste dans son propre onglet ou fusionne avec l'affichage existant. Par
d&eacute;faut, Oracle Help fusionne tous les affichages ayant le moteur, le libell&eacute; et le type en commun.
Oracle Help fait une distinction claire entre les libell&eacute;s et les titres :
Libell&eacute;s
Ils sont assign&eacute;s aux onglets.
426
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Titres
Ils sont attribu&eacute;s &agrave; des livres ou &agrave; des nœuds de premier niveau dans la table des mati&egrave;res.
Fusion de projets Oracle Help
1)
Ajoutez une r&eacute;f&eacute;rence &agrave; un fichier HelpSet externe (.hs) lorsque vous g&eacute;n&eacute;rez Oracle Help.
l'ajout de la r&eacute;f&eacute;rence &agrave; un fichier HS externe annexe toutes les vues, ainsi que d'autres fichiers de projet,
au projet existant.
Index Oracle Help
Un seul niveau de retrait est pris en charge. Les utilisateurs peuvent rechercher des mots-cl&eacute;s dans la liste.
D&egrave;s qu'un mot-cl&eacute; est s&eacute;lectionn&eacute;, les rubriques correspondantes s'affichent dans le volet inf&eacute;rieur.
Lorsque vous cliquez deux fois sur une rubrique dans le volet inf&eacute;rieur, son contenu s'affiche dans la
fen&ecirc;tre de rubrique sur la droite.
Vous pouvez importer des index externes et les fusionner &agrave; l'aide des affichages distants d'Oracle Help.
Vous pouvez &eacute;galement cr&eacute;er des onglets distincts pour chaque index ou les fusionner.
Exemple d'index Oracle Help
427
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Recherche de texte int&eacute;gral Oracle Help
Oracle Help affiche les r&eacute;sultats de la recherche en fonction de leur pertinence et non de leur ordre
alphab&eacute;tique. Vous pouvez importer des bases de donn&eacute;es de recherche de texte int&eacute;gral &agrave; partir
d'autres projets &agrave; l'aide des affichages distants d'Oracle Help.
Exemple de recherche de texte int&eacute;gral Oracle Help
Limitations d'Oracle Help
Elles ne s'appliquent pas toutes &agrave; l'ensemble des projets Oracle Help.
Mise en majuscules
Prend en charge la mise en majuscules et en petites capitales.
D&eacute;finitions de zones cliquables &agrave; d&eacute;velopper dans le glossaire
Elles apparaissent en ligne.
Polices
Le nombre de polices prises en charge est limit&eacute;.
428
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Volet Glossaire
Il n'est pas pris en charge lorsque vous utilisez le concepteur de glossaires.
Contr&ocirc;les HTML Help
Prennent en charge les &eacute;l&eacute;ments suivants : Rubriques WinHelp, Raccourci, Table des mati&egrave;res,
Index, Ecran d'introduction, Fermer la fen&ecirc;tre et Version HHCTRL.
Liens
Prend en charge les liens vers les adresses e-mail, les sites FTP et les fichiers externes.
Listes
Seules les listes simples &agrave; puces ou num&eacute;rot&eacute;es s'affichent correctement dans l'afficheur Oracle
Help.
Multim&eacute;dia
Prend en charge les fichiers audio (WAV ou MIDI) et vid&eacute;o (AVI).
Texte brut
Prend en charge les fichiers non-HTML.
Effets sp&eacute;ciaux
Prennent en charge les contr&ocirc;les ActiveX, DHTML, JavaScript, les &eacute;crans d'introduction et les scripts
Visual Basic. Comme DHTML n'est pas pris en charge, il est remplac&eacute; par du texte brut dans les
projets Oracle Help g&eacute;n&eacute;r&eacute;s.
Effets et animations de texte
Non pris en charge.
Mise en page XML
RoboHelp utilise des gestionnaires pour convertir le format XML au format HTML et pour importer des
fichiers XML dans des rubriques. Les gestionnaires peuvent &eacute;galement exporter des rubriques ou des
projets entiers au format XML. Vous pouvez cr&eacute;er ou personnaliser des gestionnaires XML &agrave; l'aide de
l'&eacute;diteur HDF.
Les fichiers de gestionnaire pr&eacute;d&eacute;finis suivants sont disponibles :
Importer les fichiers DocBook en tant que rubriques
Importe les fichiers DocBook s&eacute;lectionn&eacute;s sous la forme de rubriques.
Importer XHTML (*.XML)
Importe les fichiers XHTML s&eacute;lectionn&eacute;s sous la forme de rubriques HTML.
429
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Importer XML (CSS/XSL)
Si une feuille de style (fichier CSS or XSL) est associ&eacute;e au fichier XML s&eacute;lectionn&eacute;, ce gestionnaire
importe le fichier XML en tant que rubrique HTML, y compris sa mise en forme. Si, dans le fichier
XML s&eacute;lectionn&eacute;, il manque une feuille de style associ&eacute;e, ce gestionnaire convertit le fichier XML en
fichier HTML, sans la mise en forme. Cette option d'importation comprend &eacute;galement des
sous-options avanc&eacute;es. Vous pouvez importer le fichier XML en tant que flux de texte ou flux
arborescent ou choisir un fichier CSS ou XSL personnalis&eacute;.
REMARQUE : Si tous les fichiers HDF (et par cons&eacute;quent les gestionnaires) ont &eacute;t&eacute; supprim&eacute;s, la
fonctionnalit&eacute; d'importation et d'exportation XML n'est pas accessible. Utilisez le programme de
supervision des gestionnaires XML pour importer un fichier HDF contenant un gestionnaire ou r&eacute;installez
RoboHelp afin de pouvoir utiliser cette fonctionnalit&eacute;.
LIENS CONNEXES :
G&eacute;n&eacute;ration d'une sortie XML
Importation de fichiers XML
Mise en page d'Adobe AIR
Utilisez la mise en page d'Adobe AIR pour g&eacute;n&eacute;rer l'aide en tant qu'application Adobe AIR, aide accessible
par navigateur (avec le th&egrave;me et l'habillage d'une application Adobe AIR) ou fichier de donn&eacute;es mis en
package, qui peut &ecirc;tre visualis&eacute; dans un afficheur d'aide AIR.
Adobe AIR est un moteur d'ex&eacute;cution multiplate-forme qui facilite la cr&eacute;ation et le d&eacute;ploiement
d'applications permettant de connecter l'ordinateur &agrave; Internet.
REMARQUE : Sous Linux, le moteur d'ex&eacute;cution d'AIR n'est pas pris en charge apr&egrave;s la version 2.6. AIR Help
continuera &agrave; &ecirc;tre ex&eacute;cut&eacute; sous Linux avec la version 2.6.
Pour obtenir une liste des avantages de la g&eacute;n&eacute;ration d'une sortie dans la mise en page Adobe AIR, voir
A propos des types de sortie.
Pour plus d'informations sur les applications Help qui utilisent Adobe AIR, voir
www.adobe.com/go/learn_rh_article_airhelp_fr.
Configuration de la mise en page Adobe AIR
Vous configurez la mise en page Adobe AIR &agrave; partir de l'option Adobe AIR du conteneur Mises en page
source unique. Dans la bo&icirc;te de dialogue Adobe AIR, vous pouvez s&eacute;lectionner le type de sortie,
configurer les param&egrave;tres du programme d'installation et d&eacute;finir la pr&eacute;sentation du contenu de l'aide.
1) S&eacute;lectionnez Adobe AIR dans le conteneur Mises en page source unique et effectuez l'une des
op&eacute;rations suivantes :
–
Cliquez avec le bouton droit de la souris et s&eacute;lectionnez Propri&eacute;t&eacute;s dans le menu contextuel.
–
S&eacute;lectionnez Modifier &gt; Propri&eacute;t&eacute;s.
LIENS CONNEXES :
Fusion de projets d'aide
Distribution de la sortie Adobe AIR
430
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
H&eacute;bergement des mises &agrave; jour de l'aide AIR
Cr&eacute;ation d'habillages personnalis&eacute;s pour les projets Adobe AIR
R&eacute;vision et collaboration dans l'aide AIR
S&eacute;lection de la sortie d'aide
Vous pouvez s&eacute;lectionner l'une des quatre options de sortie pour Adobe AIR :
1) Dans l'onglet G&eacute;n&eacute;ralit&eacute;s de la bo&icirc;te de dialogue Adobe AIR, s&eacute;lectionnez le type de sortie :
Application Adobe AIR
G&eacute;n&egrave;re la sortie Adobe AIR sous forme d'aide int&eacute;gr&eacute;e. Le syst&egrave;me d'aide est cr&eacute;&eacute; en tant que
programme d'installation d'application AIR unique. Vous pouvez installer l'application AIR sur le
syst&egrave;me local ou la distribuer &agrave; vos utilisateurs. Les utilisateurs peuvent mettre &agrave; jour le syst&egrave;me
d'aide Adobe AIR install&eacute; sur leur ordinateur chaque fois qu'une mise &agrave; jour est disponible sur le
Web. Pour plus d'informations &agrave; propos des mises &agrave; jour automatiques, reportez-vous &agrave; la section
Mise &agrave; jour automatique dans l’article d’aide d’Adobe AIR de Peter Grainge.
REMARQUE : L'installation de l'application Adobe AIR exige l'installation pr&eacute;alable de JRE 1.6 ou
version ult&eacute;rieure sur votre syst&egrave;me.
Aide accessible par navigateur
G&eacute;n&egrave;re une aide accessible par navigateur, sous la forme d'une application Adobe Flex que vous
pouvez utiliser en tant qu'aide en ligne ou aide int&eacute;gr&eacute;e. Vous pouvez charger cette sortie vers le
serveur avec des configurations sp&eacute;cifiques. Les utilisateurs peuvent afficher cette aide dans un
navigateur &agrave; condition que le module externe Adobe Flash version 9.0 ou ult&eacute;rieure soit install&eacute;.
REMARQUE : L'aide accessible par navigateur ne g&egrave;re pas certaines fonctionnalit&eacute;s de l'application
Adobe AIR telles que commentaires, favoris, ressources, RSS et mise &agrave; jour automatique.
Application AIR et aide accessible par navigateur
G&eacute;n&egrave;re le syst&egrave;me d'aide simultan&eacute;ment sous deux formats : application Adobe AIR et aide
accessible par navigateur. Vous pouvez afficher l'application AIR apr&egrave;s l'avoir install&eacute;e sur votre
ordinateur. Pour consulter l'aide accessible par navigateur, vous devez la charger sur un serveur. Les
deux syst&egrave;mes d'aide sont ind&eacute;pendants l'un de l'autre.
Contenu de l'aide seulement
G&eacute;n&egrave;re le syst&egrave;me d'aide sous la forme d'un fichier de donn&eacute;es (RHA) que vous pouvez afficher
dans un afficheur d'aide. Recourez &agrave; l'assistant Afficheur d'aide de RoboHelp pour cr&eacute;er un afficheur
d'aide. Pour afficher plusieurs fichiers dans une seule vue, vous pouvez consigner l'emplacement de
tous ces fichiers dans un fichier HelpConfig.
REMARQUE : Pour conna&icirc;tre la syntaxe du fichier HelpConfig, voir Cr&eacute;ation et localisation d'un fichier de
configuration du contenu de l'aide.
Pour une description pas &agrave; pas de la proc&eacute;dure de fusion de la sortie de plusieurs projets en un seul
fichier .air, voir www.adobe.com/go/learn_rh_merge_rha_fr.
431
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Configuration des param&egrave;tres de l'aide
1)
Dans l'onglet G&eacute;n&eacute;ralit&eacute;s de la bo&icirc;te de dialogue Adobe AIR, d&eacute;finissez les options suivantes.
Emplacement de la sortie du fichier AIR
Cliquez sur Parcourir pour s&eacute;lectionner un dossier pour le programme d'installation de l'application
d'aide (fichier AIR) et indiquez un nom. Par d&eacute;faut, RoboHelp nomme le programme d'installation
de l'application d'aide en ajoutant .air au nom du projet.
Emplacement de la sortie de la page de d&eacute;marrage (aide accessible par navigateur uniquement)
Indiquez la premi&egrave;re page &agrave; afficher dans l'aide accessible par navigateur.
Titre d'aide
Indiquez un titre pour votre application Help. Ce titre appara&icirc;t dans la barre de titre d'Help et dans
Program Files.
Version
Indiquez un num&eacute;ro de version pour l'application Help g&eacute;n&eacute;r&eacute;e. En r&egrave;gle g&eacute;n&eacute;rale, vous attribuez le
num&eacute;ro de version 1.0 &agrave; la version initiale de votre application d'aide et incr&eacute;mentez ce num&eacute;ro
pour les versions suivantes. Les num&eacute;ros de versions incr&eacute;mentiels permettent aux utilisateurs
d'identifier le contenu de l'aide mis &agrave; jour dans leurs installations locales.
ID d'aide
Sp&eacute;cifiez un identificateur unique pour l'application d'aide. L'ID d'aide peut &ecirc;tre alphanum&eacute;rique et
inclure des points et des tirets.
REMARQUE : Lorsque vous livrez une aide mise &agrave; jour, modifiez uniquement le num&eacute;ro de version. La
version de l'aide AIR utilise une combinaison constitu&eacute;e de l'ID et de la version de l'aide, afin d'identifier
si une version plus r&eacute;cente de l'aide est disponible.
Configuration du programme d'installation de l'application d'aide
REMARQUE : Si vous le souhaitez, vous pouvez d&eacute;s&eacute;lectionner la case Param&egrave;tres du programme
d'installation pourcr&eacute;er une application Adobe AIR non sign&eacute;e afin que l'application puisse &ecirc;tre sign&eacute;e
ult&eacute;rieurement. L'extension .airi est ajout&eacute;e au nom de fichier AIR et les champs situ&eacute;s sous le groupe
Param&egrave;tres du programme d'installation sont d&eacute;sactiv&eacute;s, indiquant que vous avez choisi de pr&eacute;parer un
package d'aide AIRI qui sera sign&eacute; ult&eacute;rieurement. Voir Signature d'une application d'aide AIR
interm&eacute;diaire au moyen de l'outil AIR Developer (ADT).
432
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Pour signer votre application d'aide d'Adobe AIR avec un certificat num&eacute;rique, cochez la case Param&egrave;tres
du programme d'installation et configurez les param&egrave;tres du programme d'installation de l'application
d'aide.
1) Dans l'onglet G&eacute;n&eacute;ralit&eacute;s de la bo&icirc;te de dialogue Adobe AIR, d&eacute;finissez les options suivantes sous le
groupe Param&egrave;tres du programme d'installation :
Certificat num&eacute;rique
Une signature num&eacute;rique garantit que le syst&egrave;me d'aide (ou ses mises &agrave; jour) n'a pas &eacute;t&eacute; modifi&eacute; ou
corrompu depuis sa cr&eacute;ation. Toutes les applications Adobe AIR exigent une signature num&eacute;rique
et ne peuvent &ecirc;tre install&eacute;es en l'absence d'une telle signature. Si votre organisation a achet&eacute; un
certificat aupr&egrave;s d'une autorit&eacute; de certification, cliquez sur Parcourir pour le s&eacute;lectionner. Dans le
cas contraire, cliquez sur Cr&eacute;er pour cr&eacute;er un certificat sign&eacute; automatiquement (et r&eacute;utilisable). Voir
Cr&eacute;ation d'un certificat num&eacute;rique sign&eacute; automatiquement.
Mot de passe
Saisissez le mot de passe associ&eacute; au certificat num&eacute;rique.
Inclure un horodatage
S&eacute;lectionnez cette option pour inclure un horodatage sur le certificat num&eacute;rique. L'horodatage
pr&eacute;cise la dur&eacute;e de validit&eacute; du certificat.
Dossier des menus du programme
Indiquez le nom du dossier des menus du programme. Sous Windows, par exemple, la cha&icirc;ne
sp&eacute;cifi&eacute;e est incluse dans le chemin D&eacute;marrer &gt; Programmes &gt; [nom du dossier des menus
du programme] &gt; [titre du syst&egrave;me d'aide].
Cr&eacute;ation de cat&eacute;gories de contenu
Cr&eacute;ez des cat&eacute;gories de contenu pour publier la sortie sous forme de package de syst&egrave;mes d'aide centr&eacute;s
sur l'utilisateur (un package de syst&egrave;mes d'aide pour des r&ocirc;les d'utilisateur, g&eacute;ographies, produits ou
plateformes diff&eacute;rents, par exemple).
Les utilisateurs finaux affichent la sortie comme un ensemble int&eacute;gr&eacute; de syst&egrave;mes d'aide et peuvent
s&eacute;lectionner le syst&egrave;me d'aide auquel ils souhaitent acc&eacute;der dans une liste d&eacute;roulante. Chaque syst&egrave;me
d'aide dispose d'une table des mati&egrave;res, d'un index, de s&eacute;quences de navigation et d'une fonctionnalit&eacute;
de recherche propres.
1) Dans l'onglet Cat&eacute;gories de contenu de la bo&icirc;te de dialogue Adobe AIR, proc&eacute;dez comme suit :
–
Pour renommer une cat&eacute;gorie de contenu, s&eacute;lectionnez la cat&eacute;gorie correspondante. Cliquez
sur le bouton Renommer et sp&eacute;cifiez un autre nom.
–
Pour supprimer une cat&eacute;gorie de contenu, s&eacute;lectionnez la cat&eacute;gorie correspondante et cliquez
sur le bouton Supprimer. Cliquez sur Oui pour confirmer.
–
Pour modifier l'ordre des cat&eacute;gories de contenu dans la liste d&eacute;roulante permettant la
s&eacute;lection par l'utilisateur, utilisez les touches fl&eacute;ch&eacute;es vers le haut et vers le bas.
–
Pour sp&eacute;cifier une cat&eacute;gorie de contenu en tant que cat&eacute;gorie par d&eacute;faut, cliquez sur D&eacute;finir
par d&eacute;faut.
433
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Configuration du contenu
Vous pouvez configurer la pr&eacute;sentation du contenu dans l'application d'aide. Si vous avez cr&eacute;&eacute; des
cat&eacute;gories de contenu, configurez la pr&eacute;sentation du contenu pour chaque cat&eacute;gorie.
1) Dans l'onglet Contenu de la bo&icirc;te de dialogue Adobe AIR, d&eacute;finissez les &eacute;l&eacute;ments suivants pour
chaque cat&eacute;gorie de contenu :
Titre du contenu
Indiquez un titre pour la cat&eacute;gorie de contenu. Le titre appara&icirc;t dans une liste d&eacute;roulante et permet
&agrave; l'utilisateur d'acc&eacute;der &agrave; une cat&eacute;gorie de contenu.
REMARQUE : Si vous n'avez cr&eacute;&eacute; aucune cat&eacute;gorie de contenu, ignorez ce champ. RoboHelp utilise le titre
sp&eacute;cifi&eacute; dans les param&egrave;tres d'aide de l'onglet G&eacute;n&eacute;ralit&eacute;s.
Table des mati&egrave;res
S&eacute;lectionnez la table des mati&egrave;res &agrave; afficher dans l'aide g&eacute;n&eacute;r&eacute;e. Voir Tables des mati&egrave;res.
Index
S&eacute;lectionnez l'index &agrave; afficher dans l'aide g&eacute;n&eacute;r&eacute;e. Voir Index.
Glossaire
S&eacute;lectionnez le glossaire &agrave; afficher dans l'aide g&eacute;n&eacute;r&eacute;e. Voir Glossaires.
Jeu de variables
S&eacute;lectionnez un jeu de variables pour remplacer le jeu par d&eacute;faut dans l'aide g&eacute;n&eacute;r&eacute;e. Voir Variables
d&eacute;finies par l'utilisateur.
Rubrique par d&eacute;faut
Il s'agit de la rubrique qui appara&icirc;t lorsque l'aide s'ouvre. Par d&eacute;faut, la premi&egrave;re rubrique de la
table des mati&egrave;res correspond &agrave; la rubrique par d&eacute;faut.
Langue
Sp&eacute;cifiez la langue de sortie pour la mise en forme si elle est diff&eacute;rente de celle du projet. RoboHelp
utilise ce param&egrave;tre de langue pour les cha&icirc;nes de l'interface utilisateur et les &eacute;l&eacute;ments de
l'interface utilisateur li&eacute;s &agrave; la langue dans l'aper&ccedil;u et dans la sortie g&eacute;n&eacute;r&eacute;e.
Codage
Sp&eacute;cifiez le format de codage des caract&egrave;res si le serveur Web sur lequel vous effectuez la
publication pr&eacute;sente un codage diff&eacute;rent du format UTF-8.
Fichiers de mappage
Sp&eacute;cifiez les fichiers de mappage contenant des ID de rubrique associ&eacute;s aux ID de mappage pour
fournir l'aide contextuelle.
434
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
S&eacute;quences de navigation
S&eacute;lectionnez les s&eacute;quences de navigation pour cette cat&eacute;gorie de contenu.
Expression de construction conditionnelle
Sp&eacute;cifiez une expression de construction conditionnelle &agrave; appliquer &agrave; la sortie. Voir Expressions de
balises de construction conditionnelles.
Appliquer &agrave; toutes les rubriques
Pr&eacute;cisez si vous souhaitez appliquer une page principale ou une feuille CSS &agrave; l'ensemble des
rubriques. Si vous ne s&eacute;lectionnez pas cette option, les pages principales associ&eacute;es aux rubriques
individuelles sont appliqu&eacute;es. Si aucune page principale n'est appliqu&eacute;e aux rubriques, elles sont
g&eacute;n&eacute;r&eacute;es telles quelles. Voir Application d'une page principale ou d'une feuille CSS lors de la
g&eacute;n&eacute;ration.
Exclure les rubriques non r&eacute;f&eacute;renc&eacute;es de la sortie
Cochez cette case si vous souhaitez exclure toute rubrique qui existe dans le projet, mais ne
correspond pas &agrave; la rubrique par d&eacute;faut dans la mise en page ou n'est r&eacute;f&eacute;renc&eacute;e ni &agrave; partir de la
table des mati&egrave;res, l'index ou la s&eacute;quence de navigation s&eacute;lectionn&eacute;s, ni &agrave; partir d'une rubrique
r&eacute;f&eacute;renc&eacute;e quelconque.
REMARQUE : RoboHelp affiche les rubriques non r&eacute;f&eacute;renc&eacute;es exclues de la sortie dans le conteneur
Affichage de la sortie.
Exclure les fichiers bagage non r&eacute;f&eacute;renc&eacute;s de la recherche
Cochez cette case si vous souhaitez exclure toute rubrique qui existe dans le projet, mais n'est
r&eacute;f&eacute;renc&eacute;e ni &agrave; partir de la table des mati&egrave;res s&eacute;lectionn&eacute;e, ni &agrave; partir d'une rubrique r&eacute;f&eacute;renc&eacute;e
quelconque (si l'option Exclure les rubriques non r&eacute;f&eacute;renc&eacute;es de la sortie est activ&eacute;e). Si l'option
Exclure les rubriques non r&eacute;f&eacute;renc&eacute;es de la sortie est d&eacute;sactiv&eacute;e, RoboHelp exclut les fichiers
bagage qui ne sont r&eacute;f&eacute;renc&eacute;s &agrave; partir d'aucune rubrique du projet.
D&eacute;finitions des options de valorisation de la marque et de la fen&ecirc;tre de l'afficheur de l'aide
Les param&egrave;tres d'apparence d&eacute;finissent l'aspect de la fen&ecirc;tre de l'afficheur de l'aide.
1) Dans la bo&icirc;te de dialogue Adobe AIR, s&eacute;lectionnez le groupe Mod&egrave;le et d&eacute;finissez les options
suivantes :
Mod&egrave;le
S&eacute;lectionnez un mod&egrave;le dans le menu contextuel.
Habillage
S&eacute;lectionnez un habillage dans le menu contextuel. Une autre solution consiste &agrave; cliquer sur Galerie
pour s&eacute;lectionner un habillage parmi les habillages disponibles pour le mod&egrave;le s&eacute;lectionn&eacute;. Vous
pouvez afficher l'aper&ccedil;u d'un habillage avant de le choisir.
435
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
CHAPITRE 12
Copyright
Sp&eacute;cifiez l'entit&eacute; d&eacute;tentrice du copyright de l'application d'aide. Cette entit&eacute; correspond
g&eacute;n&eacute;ralement au nom de la soci&eacute;t&eacute; qui publie le contenu de l'aide. La mention copyright appara&icirc;t
dans la bo&icirc;te de dialogue A propos (Aide &gt; A propos).
Description
Sp&eacute;cifiez une description de l'aide. La description appara&icirc;t dans la bo&icirc;te de dialogue A propos
(Aide &gt; A propos).
Ic&ocirc;ne favorite
(Aide accessible par navigateur) Sp&eacute;cifiez une ic&ocirc;ne &agrave; associer au syst&egrave;me d'aide. L'ic&ocirc;ne s'affiche
dans l'onglet de navigateur.
Largeur et hauteur
D&eacute;finissez la largeur et la hauteur de la fen&ecirc;tre d'aide.
D&eacute;finir des options de valorisation de la marque
Cliquez sur cette option pour d&eacute;finir une ic&ocirc;ne pour votre syst&egrave;me Help dans diff&eacute;rentes tailles et
sp&eacute;cifiez d'autres options de valorisation de la marque.
Les tailles suivantes sont utilis&eacute;es par le syst&egrave;me d'exploitation afin d'afficher l'ic&ocirc;ne du syst&egrave;me
Help dans des emplacements pr&eacute;d&eacute;finis, tels que la barre de titre, la barre des t&acirc;ches, et la bo&icirc;te de
dialogue A propos :
–
–
–
–
128x128
48x48
32x32
16x16
Si vous ne sp&eacute;cifiez pas votre propre ic&ocirc;ne, les valeurs par d&eacute;faut de votre syst&egrave;me d'exploitation
sont utilis&eacute;s. Pour obtenir les meilleurs r&eacute;sultats, fournissez une image dans chacune des tailles
sp&eacute;cifi&eacute;es. Assurez-vous, en outre, que l'apparence des ic&ocirc;nes est appropri&eacute;e en modes de couleur
16 et 32 bits. Les fichiers d'ic&ocirc;ne doivent &ecirc;tre au format PNG.
Vous pouvez &eacute;galement afficher le logo de votre entreprise dans le coin sup&eacute;rieur droit de
l'application Help et les informations de copyright ou autres informations commerciales dans la
barre d'&eacute;tat. La taille de l'image pour le logo est 32x32.
Mod&egrave;le de l'application d'aide
Choisissez le mod&egrave;le &agrave; utiliser pour votre application d'aide. Vous pouvez s&eacute;lectionner l'un des trois
mod&egrave;les suivants :
REMARQUE : Les mod&egrave;les ne sont pas applicables si vous avez s&eacute;lectionn&eacute; le type de sortie Contenu d'aide
uniquement.
436
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
CHAPITRE 12
Aide classique
Le mod&egrave;le Aide classique divise la page en trois volets : volet sup&eacute;rieur, volet gauche et volet de contenu.
Accord&eacute;on multi-onglets
Le mod&egrave;le Accord&eacute;on multi-onglets divise la page en trois volets : volet sup&eacute;rieur, volet gauche et
volet de contenu.
Mono-volet
Le mod&egrave;le Mono-volet divise la page en deux volets : volet sup&eacute;rieur et volet de contenu.
Tous les mod&egrave;les offrent des options de navigation et d'apparence diff&eacute;rentes. Ils partagent &eacute;galement
quelques fonctionnalit&eacute;s. table des mati&egrave;res, index, glossaire, recherche, impression et volet de contenu.
Le tableau ci-dessous pr&eacute;sente les diff&eacute;rences entre les trois types de mod&egrave;les :
Fonctionnalit&eacute;s
Aide classique
Accord&eacute;on
multi-onglets
Mono-volet
Comment...
Voir S&eacute;quences de
navigation.
Oui
Non
Non
Recherche
Oui
Oui
Oui
R&eacute;sultats de recherche
avec affichage du
contexte
Non
Oui
Oui
Affichage/Masquage
du volet gauche
Oui
Oui
Non
Affichage de la barre
d'&eacute;tat
Oui
Oui
Oui
REMARQUE :
Appuyez sur F11 pour afficher ou masquer les volets gauche et sup&eacute;rieur.
Vous pouvez choisir le mod&egrave;le &agrave; utiliser dans le syst&egrave;me d'aide et le pr&eacute;visualiser avant de g&eacute;n&eacute;rer l'aide.
REMARQUE : Vous pouvez personnaliser un mod&egrave;le. Par d&eacute;faut, toutes les options disponibles dans le
mod&egrave;le pour l'affichage du contenu et la navigation sont s&eacute;lectionn&eacute;es.
Configuration de la pr&eacute;sentation du contenu
Vous pouvez configurer le comportement de l'application d'aide lors de son utilisation par un utilisateur.
1) Dans la bo&icirc;te de dialogue Adobe AIR, s&eacute;lectionnez le groupe Affichage et d&eacute;finissez les options
suivantes :
437
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Activer la mise &agrave; jour automatique
Autorise l'application AIR &agrave; synchroniser le fichier AIR install&eacute; sur un ordinateur avec le contenu
actualis&eacute; h&eacute;berg&eacute; sur le lecteur r&eacute;seau ou un emplacement de serveur HTTP. Proc&eacute;dez de l'une des
fa&ccedil;ons suivantes :
Mise &agrave; jour du contenu &agrave; l'int&eacute;rieur de votre r&eacute;seau
S&eacute;lectionnez Fichier dans le menu Type et cliquez sur Parcourir pour s&eacute;lectionner le dossier et le
fichier contenant les mises &agrave; jour de contenu.
Mise &agrave; jour du contenu &agrave; l'ext&eacute;rieur de votre r&eacute;seau
S&eacute;lectionnez HTTP dans le menu Type et saisissez l'URL du fichier XML qui contient les mises &agrave; jour
apport&eacute;es au contenu de l'aide.
La fonctionnalit&eacute; de mise &agrave; jour automatique permet aux utilisateurs de mettre &agrave; jour l'application
d'aide chaque fois qu'une nouvelle mise &agrave; jour est disponible. Vous pouvez envoyer la mise &agrave; jour
automatique sous la forme d'un fichier XML ou l'h&eacute;berger sur un serveur Web. Voir H&eacute;bergement
des mises &agrave; jour de l'aide AIR.
Ajouter
Cliquez pour sp&eacute;cifier les emplacements Mac OS et Linux afin de mettre &agrave; jour l'aide install&eacute;e si vous
h&eacute;bergez le fichier XML sur un disque local ou sur un disque du r&eacute;seau.
Ajouter des ressources
Cliquez sur le bouton Ajouter pour ajouter des liens externes qui s'affichent dans le groupe Favoris
de l'application d'aide.
Vous pouvez ajouter des ressources telles que pages de support technique, articles de base de
connaissances, flux RSS et sites Web li&eacute;s.
Afficher le contenu en ligne
Indiquez le chemin d'acc&egrave;s complet de l'emplacement o&ugrave; l'afficheur d'aide AIR choisit l'aide bas&eacute;e
sur navigateur publi&eacute;e. Par exemple, http://www.example.com/[dossier_d_aide_du_navigateur].
Cette option ne s'applique que si vous avez s&eacute;lectionn&eacute; le type de sortie en tant qu'Application
Adobe AIR ou Application AIR et Help accessible par navigateur.
REMARQUE : Si vous s&eacute;lectionnez cette option, assurez-vous que vous publiez Help accessible par
navigateur &agrave; l'emplacement d&eacute;sign&eacute; par l'URL du serveur. Dans le cas contraire, l'application AIR affiche
le contenu hors ligne.
Configurer la recherche
Dans la bo&icirc;te de dialogue Adobe AIR, s&eacute;lectionnez le groupe Rechercher, et d&eacute;finissez les options suivantes :
438
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Activer la mise en surbrillance des r&eacute;sultats de recherche
Cette option permet de mettre les r&eacute;sultats de la recherche en surbrillance. Le terme recherch&eacute; est
mis en surbrillance dans les rubriques qui r&eacute;pondent aux crit&egrave;res de recherche. Cliquez dans le
menu contextuel Texte pour d&eacute;finir la couleur de mise en surbrillance.
Afficher le contexte dans les r&eacute;sultats de la recherche
Cette option permet d'afficher les quelques premi&egrave;res lignes de la rubrique dans les r&eacute;sultats de la
recherche.
Activer la recherche de sous-cha&icirc;ne
S&eacute;lectionnez pour que les r&eacute;sultats de la recherche comprennent non seulement la cha&icirc;ne de
recherche exacte mais &eacute;galement le texte dans lequel la cha&icirc;ne est int&eacute;gr&eacute;e. La recherche de &laquo; log &raquo;
renvoie les rubriques qui contiennent les mots &laquo; catalogue &raquo; et &laquo; logarithme &raquo;, par exemple. Une
recherche de sous-cha&icirc;ne demande plus de temps qu'une recherche de cha&icirc;ne enti&egrave;re.
Activer la recherche de contenu externe
S&eacute;lectionnez cette option pour afficher le contenu d'URL identifi&eacute;es &agrave; l'ext&eacute;rieur du syst&egrave;me d'aide.
Pour plus d'informations sur la mani&egrave;re de sp&eacute;cifier les URL et de les associer aux termes de
recherche, voir Recherche de contenu externe.
Masquer la colonne de rang dans les r&eacute;sultats de la recherche
S&eacute;lectionnez cette option pour ne pas afficher la colonne Rang dans les r&eacute;sultats de la recherche.
Afficher le nombre total de r&eacute;sultats de la recherche
S&eacute;lectionnez cette option pour afficher le nombre de r&eacute;sultats de recherche pour une cha&icirc;ne
sp&eacute;cifique de recherche.
Autoriser la recherche AND dans la sortie
S&eacute;lectionnez cette option pour afficher uniquement les rubriques qui contiennent tous les mots qui
sont sp&eacute;cifi&eacute;s sans utiliser de guillemets dans la zone de recherche. Par d&eacute;faut, RoboHelp ex&eacute;cute
la recherche OR lorsqu'un utilisateur tape plusieurs mots sans les placer entre guillemets. Cela
signifie que RoboHelp trouve toutes les rubriques qui contiennent l'un des mots sp&eacute;cifi&eacute;s dans la
zone de recherche.
REMARQUE : La recherche de tous les termes peut &ecirc;tre utilis&eacute;e en combinaison avec la fonction de
recherche de phrases.
S&eacute;lectionnez l'option Activer recherche AND par d&eacute;faut si n&eacute;cessaire. Si vous autorisez la recherche
AND &agrave; la d&eacute;sactiver par d&eacute;faut, les utilisateurs finaux ont la possibilit&eacute; de l'activer dans la sortie.
REMARQUE : Dans les projets fusionn&eacute;s, les projets enfants h&eacute;ritent de la
d&eacute;finition du projet parent. Dans le cadre de projets avec DUCC (cat&eacute;gories
de contenu), le param&egrave;tre s'applique &agrave; toutes les cat&eacute;gories de contenu.
Exclure les types de fichiers bagage de la recherche
S&eacute;lectionnez les types de fichiers bagage &agrave; exclure de la recherche.
439
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
CHAPITRE 12
Configuration de la collaboration
Les param&egrave;tres de collaboration sont disponibles pour l'application Adobe AIR uniquement.
1) Dans la bo&icirc;te de dialogue Adobe AIR, s&eacute;lectionnez le groupe Collaboration et d&eacute;finissez les options
suivantes :
Activer l'&eacute;valuation de rubrique
Permet aux utilisateurs d'&eacute;valuer chaque rubrique sur une &eacute;chelle de 0 &agrave; 5 &eacute;toiles.
Activer les commentaires
S&eacute;lectionnez cette option pour activer la fonction de commentaires.
Activer la mod&eacute;ration de commentaires
S&eacute;lectionnez cette option pour autoriser l'acceptation ou le rejet des commentaires par les
utilisateurs autoris&eacute;s (mod&eacute;rateurs).
REMARQUE : Lorsque vous distribuez la sortie, assurez-vous de partager le mot de passe du mod&eacute;rateur.
Voir Distribution de la sortie Adobe AIR.
D&eacute;finir un emplacement pour les commentaires et les &eacute;valuations de rubriques
Selon si vous souhaitez un syst&egrave;me bas&eacute; sur la confiance ou une authentification de l'utilisateur,
s&eacute;lectionnez l'une des options suivantes :
–
–
S&eacute;lectionnez Dossier r&eacute;seau. Cliquez sur Parcourir pour choisir le dossier r&eacute;seau partag&eacute; dans
lequel seront stock&eacute;s les commentaires. Cliquez sur Ajouter pour ajouter des emplacements
sur des syst&egrave;mes Mac et Linux si n&eacute;cessaire. Voir Format des URL formats pour Windows, Mac
et Linux.
Sp&eacute;cifiez le mot de passe que les mod&eacute;rateurs doivent fournir pour acc&eacute;der au tableau de bord
de mod&eacute;ration.
S&eacute;lectionnez En attente ou Accept&eacute; pour sp&eacute;cifier la gestion souhait&eacute;e des commentaires non
mod&eacute;r&eacute;s. Si vous s&eacute;lectionnez En attente, les commentaires non mod&eacute;r&eacute;s ne sont pas affich&eacute;s
&agrave; l'intention des utilisateurs.
Le stockage des commentaires dans un dossier r&eacute;seau partag&eacute; est adapt&eacute; pour les
environnements de travail bas&eacute;s sur la confiance, o&ugrave; les r&eacute;visions partag&eacute;es par des
intervenants internes font partie du processus de d&eacute;veloppement de contenu.
S&eacute;lectionnez RoboHelp Server et sp&eacute;cifiez l'URL du serveur.
Le stockage des commentaires sur RoboHelp Server permet d'authentifier les utilisateurs avant
de les autoriser &agrave; afficher ou envoyer des commentaires.
440
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
CHAPITRE 12
Chemin du fichier de configuration
Sp&eacute;cifiez le chemin et le nom du fichier qui stocke la configuration pour la synchronisation et la mise
&agrave; jour automatique des commentaires. Lorsque l'application AIR est distribu&eacute;e, les utilisateurs
peuvent copier le fichier de configuration par d&eacute;faut &agrave; partir du dossier !SSL du projet vers
l'emplacement sp&eacute;cifi&eacute; dans le chemin du fichier de configuration et modifier les param&egrave;tres par
d&eacute;faut, conform&eacute;ment &agrave; leurs pr&eacute;f&eacute;rences. Par exemple, ils peuvent d&eacute;sactiver l'ajout de
commentaires ou modifier leur emplacement de stockage.
Vous pouvez saisir le chemin aux formats suivants :
–
–
–
un chemin relatif (par rapport au dossier d'installation) ;
un emplacement absolu, tel qu'un lecteur r&eacute;seau partag&eacute; ou un emplacement de fichier sur
le disque de l'utilisateur ;
une URL Web pointant vers l'emplacement de publication du fichier XML.
Configuration d'un serveur pour l'h&eacute;bergement d'une aide accessible par navigateur
Vous pouvez t&eacute;l&eacute;charger directement sur un serveur l'aide accessible par navigateur g&eacute;n&eacute;r&eacute;e. Consultez
votre administrateur syst&egrave;me pour plus d'informations sur le serveur &agrave; utiliser.
REMARQUE : La configuration du serveur ne s'applique pas si votre type de sortie est Application
Adobe AIR.
1) S&eacute;lectionnez Serveur dans la bo&icirc;te de dialogue Adobe AIR.
2) Cliquez sur Nouveau. Sp&eacute;cifiez les options suivantes dans la bo&icirc;te de dialogue Nouvelle destination :
Nom descriptif
Nom du serveur sur lequel le syst&egrave;me d'aide sera publi&eacute;. Si vous publiez un syst&egrave;me d'aide en vue
d'une r&eacute;vision interne, vous pouvez saisir le nom &laquo; Serveur de r&eacute;vision interne &raquo;, par exemple.
Protocoles de connexion
S&eacute;lectionnez le protocole de connexion au serveur ou &agrave; la plate-forme de partage. S&eacute;lectionnez FTP,
HTTP, Syst&egrave;me de fichiers ou SharePoint.
Les d&eacute;tails de connexion au serveur FTP sont les suivants :
Nom d'h&ocirc;te
Saisissez le nom d'h&ocirc;te du serveur FTP.
Port
Indiquez le num&eacute;ro de port. En r&egrave;gle g&eacute;n&eacute;rale, les connexions FTP utilisent le port par d&eacute;faut, 21.
ID utilisateur et mot de passe
Si votre serveur FTP exige l'authentification des utilisateurs, saisissez l'ID utilisateur et le mot de
passe que l'administrateur syst&egrave;me vous a attribu&eacute;s.
441
CHAPITRE 12
UTILISATION DE TYPES DE MISES EN PAGE
G&Eacute;N&Eacute;RATION DE SORTIE
Utilisateur anonyme
S&eacute;lectionnez Utilisateur anon
Mode d'emploi | Adobe RoboHelp 2019 Manuel utilisateur

Manuels associés

Adobe

ROBOHTML 10

Adobe

RoboHelp 2017

Adobe

RoboHelp HTML 10

Adobe

RoboHelp HTML 11

Adobe

ROBOHELP 10

Adobe

ROBOHTML 9

Adobe

ROBOHTML 8

Adobe

FRAMEMAKER 10

Adobe

Technical Communication Suite 5

Adobe

Framemaker 12

Adobe

Technical Communication Suite 4

Adobe

RoboHelp 7
