Manuel du propriétaire | Adobe ROBOHTML 9 Manuel utilisateur

Ajouter à Mes manuels
420 Des pages
Utilisation de
ADOBE&reg; ROBOHELP&reg; HTML 9
&copy; 2011 Adobe Systems Incorporated and its licensors. All rights reserved.
Copyright
Utilisation d'Adobe&reg; RoboHelp&reg; HTML 9 pour Windows&reg;
This user guide is protected under copyright law, furnished for informational use only, is subject to change without notice, and should not be construed as a
commitment by Adobe Systems Incorporated. Adobe Systems Incorporated assumes no responsibility or liability for any errors or inaccuracies that may appear
in the informational content contained in this guide.
This user guide is licensed for use under the terms of the Creative Commons Attribution Non-Commercial 3.0 License. This License allows users to copy,
distribute, and transmit the user guide for noncommercial purposes only so long as (1) proper attribution to Adobe is given as the owner of the user guide; and
(2) any reuse or distribution of the user guide contains a notice that use of the user guide is governed by these terms. The best way to provide notice is to include
the following link. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc/3.0/us/
Adobe, the Adobe logo, Adobe AIR, Adobe Captivate, Acrobat, AIR, Dreamweaver, FlashHelp, FrameMaker, Reader, RoboHelp are either registered trademarks
or trademarks of Adobe Systems Incorporated in the United States and/or other countries.
Microsoft, Windows, Windows Vista, and ActiveX are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other
countries. Apple and Mac OS are trademarks of Apple Inc., registered in the United States and other countries. Java and Sun Microsystems are trademarks or
registered trademarks of Sun Microsystems, Inc. in the Unites States and/or other countries. Linux is the registered trademark of Linus Torvalds in the United
States and other countries. UNIX is a registered trademark of The Open Group in the United States and other countries. Arial is a trademark of The Monotype
Corporation registered in the U.S. Patent and Trademark Office and certain other jurisdictions. All other trademarks are the property of their respective owners.
Updated Information/Additional Third Party Code Information available at http://www.adobe.com/go/thirdparty.
Portions include software under the following terms:
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).
MPEG Layer-3 audio compression technology licensed by Fraunhofer IIS and THOMSON multimedia (http://www.iis.fhg.de/amm).
Portions utilize code licensed from Nellymoser (www.nellymoser.com)
Adobe Flash Player 10 video compression and decompression is powered by On2 TrueMotion video technology. &copy; 1992-2005 On2 Technologies, Inc. All Rights
Reserved. http://www.on2.com.
This product includes software developed by the OpenSymphony Group (http://www.opensymphony.com/).
Certain trademarks are owned by The Proximity Division of Franklin Electronic Publishers, Inc., and are used by permission. Merriam-Webster is a trademark
of Merriam-Webster, Inc.
This product contains either BESAFE and/or TIPEM software by RSA Data Security, Inc.
Sorenson Spark™ video compression and decompression technology licensed from Sorenson Media, Inc.
Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA.
Notice to U.S. Government End Users. The Software and Documentation are “Commercial Items,” as that term is defined at 48 C.F.R. &sect;2.101, consisting of
“Commercial Computer Software” and “Commercial Computer Software Documentation,” as such terms are used in 48 C.F.R. &sect;12.212 or 48 C.F.R. &sect;227.7202,
as applicable. Consistent with 48 C.F.R. &sect;12.212 or 48 C.F.R. &sect;&sect;227.7202-1 through 227.7202-4, as applicable, the Commercial Computer Software and
Commercial Computer Software Documentation are being licensed to U.S. Government end users (a) only as Commercial Items and (b) with only those rights
as are granted to all other end users pursuant to the terms and conditions herein. Unpublished-rights reserved under the copyright laws of the United States.
Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA 95110-2704, USA. For U.S. Government End Users, Adobe agrees to comply with all applicable
equal opportunity laws including, if appropriate, the provisions of Executive Order 11246, as amended, Section 402 of the Vietnam Era Veterans Readjustment
Assistance Act of 1974 (38 USC 4212), and Section 503 of the Rehabilitation Act of 1973, as amended, and the regulations at 41 CFR Parts 60-1 through 60-60,
60-250, and 60-741. The affirmative action clause and regulations contained in the preceding sentence shall be incorporated by reference.
Derni&egrave;re mise &agrave; jour le 16/3/2011
iii
Sommaire
Chapitre 1 : Prise en main
Ressources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Activation et enregistrement
Aide et assistance
.......................................................................................... 1
..................................................................................................... 2
Services, t&eacute;l&eacute;chargements et extras
Introduction &agrave; RoboHelp
.................................................................................... 3
.............................................................................................. 4
Nouveaut&eacute;s de RoboHelp 9
............................................................................................ 4
Nouveaut&eacute;s de RoboHelp 9
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Chapitre 2 : D&eacute;couverte de l’espace de travail
Pr&eacute;sentation de l’espace de travail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Utilisation des conteneurs
Environnements
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Menus et barres d'outils
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Cr&eacute;ation et suppression de raccourcis clavier
Configuration des param&egrave;tres g&eacute;n&eacute;raux
Chapitre 3 : Projets
El&eacute;ments de base du projet
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Cr&eacute;ation et ouverture des projets
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Gestion des projets
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Gestion des fichiers
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Gestion des dossiers
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Cr&eacute;ation de contenu multilingue
Importation de fichiers PDF
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Importation et liaison de documents Word et FrameMaker
Importation et liaison de documents Microsoft Word
Importation de documents FrameMaker
Importation de projets WinHelp
R&eacute;f&eacute;rences
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Importation de projets Microsoft HTML Help
Rapports
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Chapitre 4 : Utilisation des rubriques
Cr&eacute;ation, enregistrement et ouverture des rubriques
Cr&eacute;ation de code XHTML
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Importation et copie de rubriques
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Affichage des rubriques et des &eacute;l&eacute;ments de conception
Pages type
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Importation d’un fichier de mappage DITA
Importation de fichiers XML
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Gestion des rubriques
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Gestion des ressources
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Derni&egrave;re mise &agrave; jour le 16/3/2011
iv
UTILISATION DE ROBOHELP HTML 9
Sommaire
V&eacute;rification d’orthographe et fonction rechercher/remplacer
Conformit&eacute; W3C
R&eacute;f&eacute;rences
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Chapitre 5 : Modification et formatage
Editeurs RoboHelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Formatage de caract&egrave;res et polices
Mise en forme des paragraphes
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Bordures, arri&egrave;re-plans, couleur et sons
Tableaux
Listes
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
En-t&ecirc;tes de page, pieds de page et sauts de page
Zones de texte
Variables d&eacute;finies par l’utilisateur
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Source unique pour les extraits de code
R&eacute;f&eacute;rence
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
Chapitre 6 : Styles et feuilles de style
Types de styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Gestion des feuilles de style
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Cr&eacute;ation de styles pour des feuilles de style
Styles de tableau
Styles de liste
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
Application des styles
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Modification de styles dans les fichiers CSS
Suppression de styles de feuilles de style
Utilisation des couleurs et des images
Styles en ligne
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
Chapitre 7 : Tables des mati&egrave;res, index et glossaires
Tables des mati&egrave;res . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Index
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
Tables des mati&egrave;res et index Microsoft HTML Help
Glossaires
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
Zones cliquables de glossaire
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
Chapitre 8 : Liens et navigation
El&eacute;ments de navigation de base . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
Cr&eacute;ation de liens de texte
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Lien vers des fen&ecirc;tres contextuelles
Signets
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Lien vers des images et des objets multim&eacute;dia
Liens externes
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Affichage des liens
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
Gestion des liens et r&eacute;paration
Contr&ocirc;les Lien
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
Fen&ecirc;tres contextuelles purement textuelles
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Principes de base de la recherche RoboHelp
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
Derni&egrave;re mise &agrave; jour le 16/3/2011
v
UTILISATION DE ROBOHELP HTML 9
Sommaire
Recherche de contenu externe
S&eacute;quences de navigation
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
Chapitre 9 : Multim&eacute;dia et effets sp&eacute;ciaux
Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
D&eacute;monstrations Adobe Captivate
Multim&eacute;dia
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
HTML dynamique et effets sp&eacute;ciaux
Texte d&eacute;filant
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Commentaires HTML dans les rubriques
IFrames
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
Chapitre 10 : Texte conditionnel
El&eacute;ments de texte conditionnel de base
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
Balises de construction conditionnelles
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
Expressions de balises de construction conditionnelles
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
Chapitre 11 : Aide contextuelle
A propos de l’aide contextuelle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
R&ocirc;les des auteurs et des d&eacute;veloppeurs lors de la cr&eacute;ation de l’aide contextuelle
Fichiers de mappage et ID de mappage
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Modification dynamique de rubriques d'aide contextuelle
Informations &agrave; l’attention des d&eacute;veloppeurs
Aide Qu’est-ce que c’est ?
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
Maintenance des rubriques textuelles (projets Microsoft HTML Help)
Utilisation de rubriques contextuelles purement textuelles
Test d’un syst&egrave;me d’aide contextuelle
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
Terminologie des syst&egrave;mes d’aide contextuelle
R&eacute;f&eacute;rences
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
Chapitre 12 : G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
El&eacute;ments de base source unique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
Utilisation de types de mises en page
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
G&eacute;n&eacute;ration, affichage et publication d’une sortie
Distribution de la sortie du projet
Documents imprim&eacute;s
Habillages
Fen&ecirc;tres
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
Chapitre 13 : R&eacute;vision et collaboration
R&eacute;vision dans l’&eacute;diteur de conception . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
R&eacute;vision d’un fichier PDF
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383
Gestion des commentaires et des modifications
R&eacute;vision et collaboration dans l’aide AIR
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
Chapitre 14 : Fonctionnalit&eacute;s de programme avanc&eacute;es
Contr&ocirc;les ActiveX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
Applets
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394
Derni&egrave;re mise &agrave; jour le 16/3/2011
vi
UTILISATION DE ROBOHELP HTML 9
Sommaire
Formulaires
Cadres
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
Contr&ocirc;les HTML Help
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
Types d'informations (pour HTML Help)
Scripts
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407
A propos de la prise en charge de ExtendScript Toolkit
Images Twisties
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
Chapitre 15 : Touches de raccourci par d&eacute;faut
Derni&egrave;re mise &agrave; jour le 16/3/2011
1
Chapitre 1 : Prise en main
Ressources
Avant de commencer &agrave; vous servir de votre logiciel, prenez le temps de lire la pr&eacute;sentation relative &agrave; l’activation et aux
nombreuses ressources &agrave; votre disposition. Vous avez acc&egrave;s &agrave; des vid&eacute;os d’explication, des modules externes, des
mod&egrave;les, des communaut&eacute;s d’utilisateurs, des s&eacute;minaires, des didacticiels, des flux RSS, etc.
Activation et enregistrement
Pour consulter l’int&eacute;gralit&eacute; des recommandations et de la configuration syst&egrave;me requise relatives au logiciel Adobe&reg;
RoboHelp&reg; 9, reportez-vous au fichier Lisez-Moi du disque d’installation.
Installation du logiciel
1 Assurez-vous qu’aucune application Adobe n’est ouverte sur l’ordinateur.
2 Introduisez le disque d'installation dans le lecteur, puis suivez les instructions qui s'affichent &agrave; l'&eacute;cran.
Remarque : pour plus d’informations, reportez-vous au fichier Lisez-Moi du disque d’installation.
Aide &agrave; l’installation
Pour obtenir de l’aide pendant l’installation, consultez le Centre d'assistance &agrave; l'installation &agrave; l’adresse
www.adobe.com/fr/support/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 le site Web d’Adobe &agrave; l’adresse http://www.adobe.com/go/activation_fr.
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.
Remarque : n’effectuez qu’un seul enregistrement pour RoboHelp 9.
❖ 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.
Si vous reportez l’enregistrement, vous pourrez effectuer cette proc&eacute;dure ult&eacute;rieurement en s&eacute;lectionnant Aide &gt;
Enregistrement.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
2
UTILISATION DE ROBOHELP HTML 9
Prise en main
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 Aide &gt; Programme d'am&eacute;lioration des produits Adobe, puis cliquez sur
Oui, participer.
• Pour mettre fin &agrave; votre participation, choisissez la commande 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 site Web d’Adobe.
Lisez-moi
Un fichier Lisez-moi relatif &agrave; votre logiciel est disponible en ligne et sur le disque d’installation. Ouvrez le fichier pour
consulter des informations importantes sur les rubriques de type :
• Configuration requise
• Installation (dont la suppression du logiciel)
• Activation et enregistrement
• D&eacute;pannage
• Support client
Aide et assistance
Aide communautaire
L'aide communautaire 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. Les
utilisateurs y fournissent des commentaires et des &eacute;valuations qui peuvent vous orienter vers les r&eacute;ponses souhait&eacute;es.
La fonction de recherche dans l’aide communautaire vous permet de retrouver les meilleures ressources du Web
consacr&eacute;es aux produits et aux technologies Adobe. Sont notamment disponibles :
• 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.
• L’aide compl&egrave;te en ligne, r&eacute;guli&egrave;rement mise &agrave; jour, est plus approfondie que celle qui accompagne votre produit.
Si vous &ecirc;tes connect&eacute; &agrave; Internet lorsque vous acc&eacute;dez &agrave; l’aide, vous &ecirc;tes automatiquement redirig&eacute; vers l’aide
actualis&eacute;e disponible sur le Web et non vers la version fournie avec votre produit.
• 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 Developper Connection, etc.
Utilisez le champ de recherche de l'aide dans l'interface utilisateur de votre produit pour acc&eacute;der &agrave; l'aide
communautaire. Vous pouvez effectuer une recherche sur le contenu du site Web Adobe.com, ainsi que sur les sites
Web pertinents comportant des informations utiles sur votre produit. Les mod&eacute;rateurs identifient en permanence le
contenu Web le plus pertinent pour votre produit. Vous pouvez ajouter des commentaires &agrave; l'aide en ligne et lire les
commentaires effectu&eacute;s par d'autres utilisateurs.
Derni&egrave;re mise &agrave; jour le 16/3/2011
3
UTILISATION DE ROBOHELP HTML 9
Prise en main
Remarque : pour limiter la recherche au sein de la documentation produit, d&eacute;veloppez les options de recherche et
s&eacute;lectionnez Local. Filtrez les r&eacute;sultats en s&eacute;lectionnant la documentation dans la liste d&eacute;roulante. Vous pouvez utiliser
la combinaison de touches Ctrl+F pour effectuer une recherche dans le contenu affich&eacute; dans le volet de droite.
Ressources suppl&eacute;mentaires
L’aide en ligne fournit &eacute;galement un lien vers l’aide au format PDF, celle-ci &eacute;tant compl&egrave;te et actualis&eacute;e en permanence.
Consultez le site Web d’assistance technique d’Adobe, &agrave; l’adresse www.adobe.com/fr/support/robohelp, pour en
savoir plus sur les options d’assistance technique gratuites et payantes.
T&eacute;l&eacute;chargez la documentation des versions ant&eacute;rieures de RoboHelp &agrave; la page
www.adobe.com/go/learn_rh_previous_docs_fr.
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 et autres &eacute;l&eacute;ments qui vous aideront dans votre travail.
Adobe Exchange
Visitez le site Adobe Exchange &agrave; l’adresse www.adobe.com/go/exchange_fr pour t&eacute;l&eacute;charger des exemples, ainsi que
des plug-ins 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.
T&eacute;l&eacute;chargements Adobe
Rendez-vous &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
Le site Adobe Labs &agrave; l’adresse www.adobe.com/go/labs_fr vous permet de d&eacute;couvrir et d’&eacute;valuer les nouveaux produits
et technologies d&eacute;velopp&eacute;s par 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;.
Derni&egrave;re mise &agrave; jour le 16/3/2011
4
UTILISATION DE ROBOHELP HTML 9
Prise en main
Adobe TV
Le canal Adobe TV disponible &agrave; l’adresse http://tv.adobe.com/fr propose des vid&eacute;os permettant de parfaire ses
connaissances ou de trouver une source d’inspiration. Le canal Technical Communications pr&eacute;sente des vid&eacute;os
pertinentes pour les communicateurs techniques.
Introduction &agrave; RoboHelp
Le logiciel Adobe RoboHelp 9 est con&ccedil;u pour le d&eacute;veloppement de syst&egrave;mes d’aide, de contenu d’apprentissage en
ligne, de strat&eacute;gies et proc&eacute;dures et de bases de connaissances. Ses fonctionnalit&eacute;s d’&eacute;dition et de mise en page avanc&eacute;es
vous permettent de cr&eacute;er du contenu d’apparence professionnelle. Vous pouvez publier ce contenu sur plusieurs
canaux, dont Adobe AIR pour une exp&eacute;rience utilisateur int&eacute;gr&eacute;e en ligne et hors ligne. Gr&acirc;ce &agrave; la prise en charge du
format ePub, vous pouvez d&eacute;sormais transf&eacute;rer votre contenu r&eacute;dig&eacute; dans RoboHelp, FrameMaker ou Microsoft&reg;
Word sur les p&eacute;riph&eacute;riques mobiles, les livres &eacute;lectroniques et les tablettes graphiques.
Toujours plus innovant, Adobe RoboHelp 9 est le leader mondial des outils de cr&eacute;ation d’aide en ligne. Gr&acirc;ce &agrave; de
nouvelles fonctionnalit&eacute;s, les sp&eacute;cialistes en communication technique ainsi que leur assistance partagent une
exp&eacute;rience plus productive.
Nouveaut&eacute;s de RoboHelp 9
Am&eacute;liorations de la cr&eacute;ation
Ressources partag&eacute;es et li&eacute;es Gagnez du temps et am&eacute;liorez la productivit&eacute; en r&eacute;utilisant des &eacute;l&eacute;ments pour
l’ensemble des auteurs et des projets. Le Gestionnaire de ressources am&eacute;lior&eacute; de RoboHelp 9 vous permet d’ajouter des
ressources partag&eacute;es en mode copie ou en mode li&eacute;. RoboHelp prend en charge la mise &agrave; jour automatique des
ressources li&eacute;es si les ressources sont modifi&eacute;es dans l’emplacement partag&eacute;. L’utilisation de ressources li&eacute;es vous
permet de conserver la coh&eacute;rence ainsi que la conformit&eacute; avec les normes d’organisation et les normes industrielles.
Voir &laquo; Gestion des ressources &raquo; &agrave; la page 134.
Derni&egrave;re mise &agrave; jour le 16/3/2011
5
UTILISATION DE ROBOHELP HTML 9
Prise en main
Les &eacute;tats des ressources li&eacute;es aident &agrave; identifier la n&eacute;cessit&eacute; d’une mise &agrave; jour.
Conteneurs am&eacute;lior&eacute;s Variables d&eacute;finies par l’utilisateur et Extraits de code Les conteneurs Variables d&eacute;finies par
l’utilisateur et Extraits de code comprennent de nombreuses am&eacute;liorations du point de vue de la convivialit&eacute; dans
RoboHelp 9. Les deux conteneurs permettent d&eacute;sormais d’effectuer des recherches. A pr&eacute;sent, vous pouvez organiser
des extraits de code dans des cat&eacute;gories et d&eacute;velopper et r&eacute;duire chaque cat&eacute;gorie. La prise en charge du tri et l’aper&ccedil;u
am&eacute;lior&eacute; vous aident &agrave; ins&eacute;rer, modifier et g&eacute;rer plus ais&eacute;ment les variables d&eacute;finies par l’utilisateur et les extraits de
code. Des fonctions telles que l’organisation des extraits de code en cat&eacute;gories et leur conversion en texte vous offrent
flexibilit&eacute; et rapidit&eacute;.
Derni&egrave;re mise &agrave; jour le 16/3/2011
6
UTILISATION DE ROBOHELP HTML 9
Prise en main
B
A
A. Conteneurs Variables d&eacute;finies par l’utilisateur et Extraits de code prenant en charge la fonction de recherche B. Extraits de code organis&eacute;s en
cat&eacute;gories
Collage de contenu HTML enrichi. Copiez et collez des tableaux &agrave; partir de Microsoft Word, Microsoft&reg; Excel et des
navigateurs. RoboHelp colle le contenu HTML enrichi en conservant intacts la mise en forme du texte, les tableaux,
les listes, les hyperliens et les images.
Cr&eacute;ation automatis&eacute;e de l’API CSH Dans RoboHelp, ouvrez l’application pour laquelle vous souhaitez fournir une aide
contextuelle et mappez les bo&icirc;tes de dialogue avec des rubriques nouvelles ou existantes. La d&eacute;pendance &agrave; l’&eacute;gard des
d&eacute;veloppeurs est minime, car RoboHelp extrait automatiquement les ID d’aide contextuelle. La mise &agrave; jour et le
remappage des rubriques sont &eacute;galement facilit&eacute;s par l’int&eacute;gration harmonieuse de RoboHelp et de l’application. Voir
&laquo; Modification dynamique de rubriques d'aide contextuelle &raquo; &agrave; la page 255.
Remarque : l’application doit mettre en œuvre l’aide contextuelle &agrave; l’aide de l’API CSH RoboHelp 9. Actuellement, seules
les API C++ sous Windows sont prises en charge.
Inclusion de contenu externe dans la recherche Indiquez des URL pour le contenu disponible &agrave; l’ext&eacute;rieur du syst&egrave;me
d’aide (par exemple, dans les blogs) et mappez-les sur 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. Voir &laquo; Recherche de contenu externe &raquo; &agrave; la page 224.
Derni&egrave;re mise &agrave; jour le 16/3/2011
7
UTILISATION DE ROBOHELP HTML 9
Prise en main
A
B
C
Impl&eacute;mentation de la recherche de contenu externe
Aper&ccedil;u de la sortie Web dans plusieurs navigateurs Affichez l’aper&ccedil;u d’une rubrique ou la sortie WebHelp,
WebHelp Pro, FlashHelp et FlashHelp Pro d’un projet avec diff&eacute;rents navigateurs. La prise en charge de navigateurs
multiples pour afficher l’aper&ccedil;u des rubriques et de la sortie d’un projet vous permet de garantir que le contenu
s’affiche correctement dans les navigateurs courants. Voir &laquo; Aper&ccedil;u des rubriques &raquo; &agrave; la page 123 et &laquo; Affichage de la
sortie &raquo; &agrave; la page 338.
Prise en charge des p&eacute;riph&eacute;riques, produits et navigateurs les plus r&eacute;cents Restez &agrave; jour avec la prise en charge des
plateformes, navigateurs et p&eacute;riph&eacute;riques (livres &eacute;lectroniques, p&eacute;riph&eacute;riques mobiles, tablettes tactiles et autres) les
plus r&eacute;cents. D&eacute;sormais, vous pouvez importer ou lier du contenu &agrave; partir de Microsoft Word 2010 (.docx et .doc) et
y publier la sortie. Les utilisateurs finaux peuvent afficher le contenu g&eacute;n&eacute;r&eacute; dans RoboHelp dans les derni&egrave;res versions
d’Internet Explorer, de Mozilla Firefox et de Google Chrome.
Int&eacute;gration &agrave; FrameMaker 10, Adobe Captivate 5 et Acrobat 10 RoboHelp 9 prend en charge la version la plus r&eacute;cente
des produits Adobe tels que FrameMaker 10, Adobe Captivate 5 et Acrobat 10. Profitez des derni&egrave;res am&eacute;liorations de
ces produits, telles que la prise en charge de la d&eacute;finition d’une couleur d’arri&egrave;re-plan du texte &agrave; la fois au niveau du
caract&egrave;re et du paragraphe dans FrameMaker.
Rapports RoboHelp Server pour l’optimisation du contenu RoboHelp Server fournit une multitude de rapports
permettant de comprendre la mani&egrave;re dont les utilisateurs exploitent le contenu. Tirez parti de ces analyses
d’utilisation pour optimiser le contenu en fonction des besoins des utilisateurs. Maintenant que vous pouvez inclure
du contenu externe dans la recherche, vous pouvez m&ecirc;me mapper du contenu d&eacute;j&agrave; disponible &agrave; l’ext&eacute;rieur du syst&egrave;me
d’aide et aider les utilisateurs &agrave; trouver les informations dont ils ont besoin.
Pour plus d’informations, voir Reports dans l’aide RoboHelp Server.
Am&eacute;liorations d’importation et de liaison
Am&eacute;liorations g&eacute;n&eacute;rales d’importation et de liaison Dans RoboHelp 9, les am&eacute;liorations suivantes s’appliquent &agrave;
l’importation et &agrave; la liaison des documents Microsoft Word et FrameMaker :
• Enregistrement du chemin relatif du document li&eacute; RoboHelp 9 enregistre le chemin relatif des documents li&eacute;s, au
lieu de leur chemin absolu. Par cons&eacute;quent, les liens fonctionnent m&ecirc;me lorsque le projet RoboHelp et les documents
Microsoft Word ou FrameMaker li&eacute;s sont d&eacute;plac&eacute;s.
Derni&egrave;re mise &agrave; jour le 16/3/2011
8
UTILISATION DE ROBOHELP HTML 9
Prise en main
Remarque : les versions ant&eacute;rieures de projets RoboHelp qui contiennent des chemins absolus de documents li&eacute;s s’ouvrent
normalement dans RoboHelp 9. Lors de l’enregistrement de ces projets, RoboHelp 9 enregistre le chemin relatif.
• Modification des styles source de caract&egrave;re et de paragraphe Lors de l’importation ou de la liaison d’un document,
vous pouvez modifier les styles de caract&egrave;re et de paragraphe d&eacute;finis dans le document. Dans le cas de documents li&eacute;s,
les propri&eacute;t&eacute;s de style modifi&eacute;es dans Microsoft Word ou FrameMaker et modifi&eacute;es dans RoboHelp peuvent
maintenant coexister. En d’autres termes, vous pouvez modifier les propri&eacute;t&eacute;s de style que vous souhaitez remplacer
dans RoboHelp et permettre la modification d’autres propri&eacute;t&eacute;s de style dans Microsoft Word ou FrameMaker.
RoboHelp 9 conserve deux feuilles de styles pour g&eacute;rer les styles d’un document li&eacute;. Un fichier [rubrique].css stocke
les styles d&eacute;finis dans le document source. Le fichier CSS global, nomm&eacute; par d&eacute;faut RHStyleMapping.css, stocke les
d&eacute;tails des modifications et les styles RoboHelp mapp&eacute;s.
RoboHelp stocke chaque style modifi&eacute; avec le nom de style WD_[nom_style_original] (dans le cas de Microsoft Word)
ou FM_[nom_style_original] (dans le cas de FrameMaker) dans RHStyleMapping.css.
Remarque : RoboHelp masque les fichiers [rubrique].css dans l’espace de travail pour garantir que les styles source sont
conserv&eacute;s dans ce fichier.
• Modification des feuilles de style dans la bo&icirc;te de dialogue Param&egrave;tres du projet Lorsque vous sp&eacute;cifiez les
param&egrave;tres d’importation dans la bo&icirc;te de dialogue Param&egrave;tres du projet, vous pouvez &agrave; pr&eacute;sent modifier le fichier CSS
que vous souhaitez utiliser pour le mappage des styles. 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.
• Importation et exportation de param&egrave;tres &agrave; partir d’un fichier ISF Vous pouvez d&eacute;sormais importer les param&egrave;tres
&agrave; partir d’un fichier ISF enregistr&eacute; ou les exporter lors de l’importation de documents Microsoft Word et FrameMaker.
Les modifications apport&eacute;es &agrave; ces param&egrave;tres apr&egrave;s l’importation du fichier ISF ne sont pas enregistr&eacute;es ; les
param&egrave;tres modifi&eacute;s sont uniquement utilis&eacute;s dans le processus d’importation en cours.
Am&eacute;liorations des fonctions d’importation et de liaison FrameMaker Dans RoboHelp 9, les fonctions d’importation
et de liaison de documents FrameMaker offrent les am&eacute;liorations suppl&eacute;mentaires suivantes :
• Prise en charge de l’importation et de la liaison de cartes DITA et de rubriques DITA D&eacute;sormais, vous pouvez
importer ou lier des cartes DITA (fichiers .ditamap, .dita et .xml) et des rubriques DITA (fichiers .dita et .xml). Pour
RoboHelp, une carte DITA est semblable &agrave; un livre FrameMaker et une rubrique DITA est semblable &agrave; un fichier .fm
FrameMaker. RoboHelp 9 prend &eacute;galement en charge Ditaval, ce qui signifie que vous pouvez maintenant cr&eacute;er une
sortie en fonction des conditions sp&eacute;cifi&eacute;es dans le fichier Ditaval. Voir &laquo; Application de conditions &agrave; partir d’un
fichier Ditaval &raquo; &agrave; la page 87.
• Am&eacute;liorations de l’importation de listes dans le cadre des fonctions d’importation et de liaison FrameMaker Dans
RoboHelp 9, les symboles de liste utilis&eacute;s dans des listes non tri&eacute;es sont convertis sans aucune distorsion. Si vous
s&eacute;lectionnez Convertir la num&eacute;rotation automatique en texte, RoboHelp conserve le style de mise en retrait de la liste
du document FrameMaker source.
• Importation de tableaux am&eacute;lior&eacute;e dans le cadre des fonctions d’importation et de liaison FrameMaker Les
am&eacute;liorations incluent l’importation des titres de tableau en tant que l&eacute;gendes, le mappage du style de l&eacute;gende,
l’importation des balises &lt;th&gt; des en-t&ecirc;tes de tableau lorsque le style de tableau est mapp&eacute; avec [source], et la possibilit&eacute;
de configurer la hauteur et la largeur de tableau, la hauteur de ligne et la largeur de colonne.
Remarque : l’&eacute;diteur CSS RoboHelp ne prend pas en charge la modification des l&eacute;gendes. Toutefois, si vous cr&eacute;ez un style
de l&eacute;gende &agrave; l’aide d’un autre &eacute;diteur, vous pouvez dupliquer la l&eacute;gende avec l’&eacute;diteur CSS RoboHelp pour cr&eacute;er des
l&eacute;gendes suppl&eacute;mentaires.
• Meilleure conversion des &eacute;quations math&eacute;matiques, des cadres de texte et des courbes &agrave; main lev&eacute;e dans les
fonctions d’importation et de liaison FrameMaker RoboHelp 9 utilise Acrobat Distiller pour convertir les &eacute;quations
math&eacute;matiques, les cadres de texte et les courbes &agrave; main lev&eacute;e FrameMaker en images. S&eacute;lectionnez l’option Utiliser le
Derni&egrave;re mise &agrave; jour le 16/3/2011
9
UTILISATION DE ROBOHELP HTML 9
Prise en main
fichier PDF pour g&eacute;n&eacute;rer des images, disponible dans la bo&icirc;te de dialogue Param&egrave;tres de conversion, pour utiliser cette
am&eacute;lioration. Voir &laquo; Param&egrave;tres de conversion d'image &raquo; &agrave; la page 97.
Fonctionnalit&eacute;s de r&eacute;vision et de collaboration
RoboHelp 9 permet de collaborer de plusieurs mani&egrave;res diff&eacute;rentes avec d’autres auteurs, PME et utilisateurs finaux.
R&eacute;vision dans l'&eacute;diteur de conception RoboHelp 9 permet d’activer le suivi des modifications dans l’&eacute;diteur de
conception et d’ins&eacute;rer des commentaires et des modifications directement dans le projet. Tirez parti de cette
fonctionnalit&eacute; pour impl&eacute;menter les r&eacute;visions des autres utilisateurs. Plusieurs r&eacute;viseurs peuvent travailler de mani&egrave;re
s&eacute;quentielle et proposer leurs commentaires sur le projet. A l’issue de la r&eacute;vision, vous pouvez afficher et g&eacute;rer les
commentaires &agrave; partir du Panneau de r&eacute;vision. Pour obtenir des instructions d&eacute;taill&eacute;es, voir &laquo; R&eacute;vision dans l’&eacute;diteur
de conception &raquo; &agrave; la page 382 et &laquo; Gestion des commentaires et des modifications &raquo; &agrave; la page 385.
R&eacute;vision de fichiers PDF Cr&eacute;ez un fichier PDF &agrave; partir d’un projet RoboHelp entier ou de parties du projet, y compris
les rubriques, les pages type et les extraits de code, puis envoyez ce fichier pour r&eacute;vision (les r&eacute;viseurs ont uniquement
besoin du logiciel gratuit Adobe Reader pour ajouter des commentaires au fichier PDF). A l’issue de la r&eacute;vision,
importez les commentaires dans le projet, puis affichez et g&eacute;rez les commentaires &agrave; partir du Panneau de r&eacute;vision. Pour
obtenir des instructions d&eacute;taill&eacute;es, voir &laquo; R&eacute;vision d’un fichier PDF &raquo; &agrave; la page 383 et &laquo; Gestion des commentaires et
des modifications &raquo; &agrave; la page 385.
Evaluation de rubriques et ajout de commentaires dans l’aide AIR Recueillez les commentaires des utilisateurs finaux
en activant l’&eacute;valuation de rubriques et l’ajout de commentaires dans l’aide AIR (type de sortie Application
Adobe AIR). Vous pouvez mettre en œuvre une configuration bas&eacute;e sur la confiance sur un serveur interne, ou une
configuration s&eacute;curis&eacute;e sur un serveur ex&eacute;cutant RoboHelp Server pour les utilisateurs &agrave; l’ext&eacute;rieur du r&eacute;seau
d’entreprise. Dans les deux situations, RoboHelp prend en charge la mod&eacute;ration des commentaires. Voir &laquo; R&eacute;vision et
collaboration dans l’aide AIR &raquo; &agrave; la page 388
Fonctionnalit&eacute;s de publication
Publication pour plusieurs p&eacute;riph&eacute;riques avec sortie ePub RoboHelp 9 permet de g&eacute;n&eacute;rer la sortie d’un projet pour
des p&eacute;riph&eacute;riques mobiles, des lecteurs de livres &eacute;lectroniques, des tablettes graphiques et d’autres p&eacute;riph&eacute;riques
prenant en charge le format ePub. La sortie inclut la mise en conformit&eacute; des m&eacute;tadonn&eacute;es par rapport aux normes
ePub. Voir &laquo; G&eacute;n&eacute;ration d’une sortie dans le format ePub &raquo; &agrave; la page 335.
Derni&egrave;re mise &agrave; jour le 16/3/2011
10
UTILISATION DE ROBOHELP HTML 9
Prise en main
B
C
A
Acc&egrave;s au script ePub Generator &agrave; partir A. du menu Fichier B. du menu Outils C. de Script Explorer
Publication dans SharePoint RoboHelp 9 prend en charge la publication d’une sortie WebHelp, FlashHelp et d’aide
accessible par navigateur (Adobe AIR SSL) sur un site SharePoint utilisant un chemin d’acc&egrave;s UNC (Universal Naming
Convention). Voir &laquo; D&eacute;finition des options de g&eacute;n&eacute;ration de WebHelp &raquo; &agrave; la page 321, &laquo; D&eacute;finition des options de
g&eacute;n&eacute;ration de FlashHelp &raquo; &agrave; la page 325 et &laquo; Configuration d’un serveur pour l’h&eacute;bergement d’une aide accessible par
navigateur &raquo; &agrave; la page 319.
D&eacute;finition des param&egrave;tres SharePoint dans les propri&eacute;t&eacute;s de mise en page
Contenu dynamique centr&eacute; sur l’utilisateur Publiez des projets 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 peuvent se
rapporter &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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
11
UTILISATION DE ROBOHELP HTML 9
Prise en main
Pour plus d’informations sur la fa&ccedil;on de cr&eacute;er des cat&eacute;gories de contenu, voir &laquo; Configuration de la mise en page
Adobe AIR &raquo; &agrave; la page 312 et &laquo; D&eacute;finition des options de g&eacute;n&eacute;ration de WebHelp &raquo; &agrave; la page 321.
A
B
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
Aide AIR fusionn&eacute;e La possibilit&eacute; de fusionner la sortie de plusieurs projets est d&eacute;sormais &eacute;tendue aux sorties g&eacute;n&eacute;r&eacute;es
&agrave; l’aide d’Adobe AIR SSL. Les deux types de sortie Adobe AIR (application Adobe AIR et aide accessible par le biais
d’un navigateur), prennent en charge la fusion. Voir &laquo; Fusion de projets d’aide &raquo; &agrave; la page 43.
Exp&eacute;rience de recherche am&eacute;lior&eacute;e RoboHelp 9 garantit une exp&eacute;rience utilisateur am&eacute;lior&eacute;e en excluant les
rubriques non r&eacute;f&eacute;renc&eacute;es de la sortie et les fichiers bagage non r&eacute;f&eacute;renc&eacute;s de la recherche. Pour obtenir une d&eacute;finition
des rubriques non r&eacute;f&eacute;renc&eacute;es et d’un fichier bagage non r&eacute;f&eacute;renc&eacute;, voir &laquo; Principes de base de la recherche RoboHelp &raquo;
&agrave; la page 223. Pour consulter la proc&eacute;dure permettant d’exclure les rubriques et les fichiers bagage non r&eacute;f&eacute;renc&eacute;s, voir
la rubrique correspondante dans &laquo; G&eacute;n&eacute;ration de la sortie &raquo; &agrave; la page 321.
Reportez-vous au 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
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
Adobe AIR
Oui
Oui
Oui
Oui
Oui
Oui
Type de sortie : application Adobe
AIR
Adobe AIR
Type de sortie : aide accessible par
navigateur
WebHelp
Derni&egrave;re mise &agrave; jour le 16/3/2011
12
UTILISATION DE ROBOHELP HTML 9
Prise en main
SSL
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
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
Personnalisation de la sortie Modifiez les couleurs, les styles, les ic&ocirc;nes et les polices pour qu’ils correspondent &agrave; la
marque de l’entreprise et &agrave; d’autres sp&eacute;cifications, &agrave; l’aide du tout nouvel &eacute;diteur d’habillage d’aide Adobe AIR. Voir
&laquo; Cr&eacute;ation d’habillages personnalis&eacute;s pour les projets Adobe AIR &raquo; &agrave; la page 370.
Prise en charge du codage de caract&egrave;res dans SSL Elle vous permet de d&eacute;finir le codage de caract&egrave;res &agrave; un niveau SSL
lorsque le serveur Web sur lequel vous effectuez la publication a un codage de caract&egrave;res diff&eacute;rent du format UTF-8.
Pour plus d’informations sur la fa&ccedil;on de d&eacute;finir le codage de caract&egrave;res pour un protocole SSL, voir la rubrique
correspondante dans &laquo; G&eacute;n&eacute;ration de la sortie &raquo; &agrave; la page 321.
Remarque : le codage de caract&egrave;res dans SSL n’est pas pris en charge pour la documentation imprim&eacute;e et les mises en page
Microsoft HTML Help.
D&eacute;finition d’une langue pour SSL Remplacez le param&egrave;tre de langue du projet en d&eacute;finissant une langue pour la mise
en page de source unique appropri&eacute;e. RoboHelp utilise le param&egrave;tre de langue SSL 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. Pour plus
d’informations sur la fa&ccedil;on de d&eacute;finir une langue pour un protocole SSL, voir la rubrique correspondante dans
&laquo; G&eacute;n&eacute;ration de la sortie &raquo; &agrave; la page 321.
Remarque : le param&egrave;tre de langue dans SSL n’est pas pris en charge pour la documentation imprim&eacute;e et les mises en
page XML.
Prise en charge de la s&eacute;lection des s&eacute;quences de navigation Dans les mises en page WebHelp et Adobe AIR, vous
pouvez d&eacute;sormais 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. En
outre, dans les mises en page WebHelp, vous pouvez activer ou d&eacute;sactiver les s&eacute;quences de navigation au niveau d’un
projet. 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 &laquo; Configuration de la mise en page Adobe AIR &raquo; &agrave; la page 312 et
&laquo; D&eacute;finition des options de g&eacute;n&eacute;ration de WebHelp &raquo; &agrave; la page 321.
Sortie de documentation imprim&eacute;e am&eacute;lior&eacute;e Tirez parti des options am&eacute;lior&eacute;es de mappage des styles pour g&eacute;n&eacute;rer
une sortie PDF et une documentation imprim&eacute;e de meilleure qualit&eacute;. Outre le mappage des styles de caract&egrave;re et de
paragraphe, vous pouvez d&eacute;sormais mapper des styles de liste et de tableau multi-niveaux aux styles correspondants
dans Microsoft Word.
Important : par d&eacute;faut, les styles de liste et de tableau dans Microsoft Word n’ont pas de nom. Cr&eacute;ez de nouveaux styles
dans Microsoft Word et nommez-les de fa&ccedil;on &agrave; ce que les noms de style soient disponibles dans la liste d&eacute;roulante, dans
les propri&eacute;t&eacute;s de mise en page de la documentation imprim&eacute;e.
Derni&egrave;re mise &agrave; jour le 16/3/2011
13
UTILISATION DE ROBOHELP HTML 9
Prise en main
Les styles sans nom apparaissent dans la liste d&eacute;roulante des styles Microsoft Word (Tous) comme Non attribu&eacute;
Dans le document Microsoft Word g&eacute;n&eacute;r&eacute;, les styles mapp&eacute;s conservent les propri&eacute;t&eacute;s des styles Microsoft Word. Par
exemple, si vous ajoutez une ligne &agrave; un tableau avec des lignes ombr&eacute;es altern&eacute;es, la ligne ajout&eacute;e est dot&eacute;e de l’ombrage
pr&eacute;vu. Voir &laquo; Mappage de styles &raquo; &agrave; la page 363.
La nouvelle option Ins&eacute;rer &gt; Saut de page vous permet d’ajouter des sauts de page dans les rubriques. RoboHelp
respecte les sauts de page pour ajouter de nouvelles pages dans la documentation imprim&eacute;e obtenue.
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 &laquo; D&eacute;finition des options de g&eacute;n&eacute;ration de
WebHelp &raquo; &agrave; la page 321 et &laquo; D&eacute;finition des options de g&eacute;n&eacute;ration de WebHelp Pro ou FlashHelp Pro &raquo; &agrave; la page 328.
Fonctionnalit&eacute;s de personnalisation par les utilisateurs
Dans RoboHelp 9, les organisations qui d&eacute;ploient une sortie Application Adobe AIR (aide AIR) peuvent configurer
des fonctions telles que la mise &agrave; jour automatique, les commentaires et les param&egrave;tres de mod&eacute;ration par le biais du
fichier de configuration et des fichiers settings.xml.
Personnalisation dans le fichier de configuration Dans RoboHelp 9, un auteur peut sp&eacute;cifier le chemin du fichier de
configuration au moment de la g&eacute;n&eacute;ration de l’aide AIR (param&egrave;tres g&eacute;n&eacute;raux dans les propri&eacute;t&eacute;s d’Adobe AIR SSL).
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 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
14
UTILISATION DE ROBOHELP HTML 9
Prise en main
Les utilisateurs peuvent modifier les param&egrave;tres suivants sp&eacute;cifi&eacute;s par l’auteur dans le fichier
[nom_fichier_configuration].xml :
• Ajout du logo et du nom de l’entreprise Personnalisez l’aide en sp&eacute;cifiant le logo et le nom de l’entreprise dans le
fichier de configuration.
• Activation ou d&eacute;sactivation de la mise &agrave; jour automatique Sp&eacute;cifiez les pr&eacute;f&eacute;rences de mise &agrave; jour automatique et
remplacez le param&egrave;tre de mise &agrave; jour automatique sp&eacute;cifi&eacute; par l’auteur.
• Modification de l’emplacement du fichier XML de mise &agrave; jour automatique Sp&eacute;cifiez un emplacement pour
stocker le fichier XML de mise &agrave; jour automatique.
• Modification de l’emplacement de stockage des commentaires Sp&eacute;cifiez un emplacement central de votre choix
pour le stockage et la synchronisation des commentaires.
• Modification de l’&eacute;tat des nouveaux commentaires Sp&eacute;cifiez si les nouveaux commentaires doivent &ecirc;tre accept&eacute;s
sans mod&eacute;ration..
• Activation ou d&eacute;sactivation de l’&eacute;valuation de rubrique Autorisez ou non les utilisateurs &agrave; &eacute;valuer les rubriques.
Pour plus d’informations, voir &laquo; Configuration de la mise en page Adobe AIR &raquo; &agrave; la page 312 et &laquo; Distribution de la
sortie Adobe AIR &raquo; &agrave; la page 353.
Personnalisation dans settings.xml Les utilisateurs peuvent remplacer le param&egrave;tre de mod&eacute;ration d&eacute;fini dans le
protocole SSL en configurant le param&egrave;tre moderation state dans le fichier settings.xml.
Pour plus d’informations, voir &laquo; Distribution de la sortie Adobe AIR &raquo; &agrave; la page 353 et &laquo; Mod&eacute;ration des
commentaires &raquo; &agrave; la page 390.
Fonctionnalit&eacute;s de convivialit&eacute; et productivit&eacute;
Exemples d’applications contenant des pr&eacute;sentations configur&eacute;es pour une publication multicouche RoboHelp 9 est
fourni avec deux &eacute;chantillons de projet, Salesbuilder-Help et EmployeeCare. Le projet Salesbuilder-Help est con&ccedil;u
pour vous aider &agrave; comprendre les nouvelles fonctions offertes par RoboHelp 9. Le projet EmployeeCare est con&ccedil;u pour
illustrer la cr&eacute;ation d’une base de connaissances &agrave; l’aide de RoboHelp 9. Les mises en forme sont configur&eacute;es de sorte
que vous puissiez les g&eacute;n&eacute;rer apr&egrave;s avoir lu les rubriques du dossier A propos. Les deux projets comprennent la
rubrique A propos d’Adobe RoboHelp 9, exposant les nouvelles fonctionnalit&eacute;s de RoboHelp 9. Si une fonction en
particulier est utilis&eacute;e dans l’exemple de projet que vous avez ouvert, l’ ic&ocirc;ne s’affiche sous le nom de ladite fonction.
Am&eacute;liorations de l’espace de travail RoboHelp 9 propose toute une s&eacute;rie d’am&eacute;liorations de l’espace de travail qui
vous conf&egrave;rent flexibilit&eacute; et rapidit&eacute;. Voici quelques-uns des principaux changements :
• Conteneurs simples &agrave; organiser 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.
• Boutons inclus dans le volet Document &agrave; onglets permettant d’ouvrir et fermer des rubriques Utilisez les boutons
fixes inclus dans le volet Document &agrave; onglets pour ouvrir et fermer rapidement des rubriques.
• Liste d&eacute;roulante des rubriques Lorsque plusieurs rubriques sont ouvertes, acc&eacute;dez rapidement &agrave; une rubrique
ouverte &agrave; partir de la liste d&eacute;roulante des rubriques.
Derni&egrave;re mise &agrave; jour le 16/3/2011
15
UTILISATION DE ROBOHELP HTML 9
Prise en main
Les noms des rubriques ouvertes apparaissent dans la liste d&eacute;roulante
• Mode de rubrique simple D&eacute;sactivez l’option Autoriser la modification de plusieurs rubriques dans Outils &gt;
Options &gt; G&eacute;n&eacute;ral pour ouvrir et modifier une rubrique &agrave; la fois.
Bo&icirc;te de dialogue Outils &gt; Options non encombr&eacute;e Les onglets de la bo&icirc;te de dialogue Options s’affichent d&eacute;sormais
sous forme d’arborescence dans le volet gauche de la bo&icirc;te de dialogue.
Bouton Enregistrer et g&eacute;n&eacute;rer pour chaque mise en page La bo&icirc;te de dialogue des propri&eacute;t&eacute;s de chaque protocole SSL
inclut &agrave; pr&eacute;sent un bouton Enregistrer et g&eacute;n&eacute;rer, qui vous permet d’enregistrer les modifications des propri&eacute;t&eacute;s et de
g&eacute;n&eacute;rer une sortie, en un seul clic.
Suppression de messages lors de l’ex&eacute;cution de scripts dans des flux de travaux TCS FrameMaker Server utilise les
API de cr&eacute;ation de scripts RoboHelp et tout message ou toute alerte dans RoboHelp bloque le serveur. Par cons&eacute;quent,
RoboHelp 9 n’affiche aucune bo&icirc;te de dialogue inutile lors de l’ex&eacute;cution d’un script, en particulier dans les flux de
travaux TCS.
Nouveaut&eacute;s de RoboHelp 9
Am&eacute;liorations apport&eacute;es &agrave; l’interface utilisateur
RoboHelp Server 9 propose une interface utilisateur nouvelle et plus esth&eacute;tique.
Prise en charge am&eacute;lior&eacute;e de la plate-forme
• Prise en charge de Microsoft Access 2010
• Prise en charge d’Apache Tomcat 7.x. Tomcat 7.x en phase b&ecirc;ta.
Am&eacute;liorations techniques
• Les journaux de RoboHelp Server sont d&eacute;sormais cr&eacute;&eacute;s dans un seul et m&ecirc;me fichier journal
(robohelpserver.log), dans le dossier &lt;Tomcat Home&gt;/logs. Tous les avertissements et les exceptions li&eacute;s &agrave;
RoboHelp Server sont consign&eacute;s dans le fichier.
Ce nouveau fichier journal est g&eacute;n&eacute;r&eacute; &agrave; l’aide de la structure de journalisation Apache log4j.
Si vous souhaitez affiner la taille, la sauvegarde limite ou le format des journaux, modifiez la valeur des propri&eacute;t&eacute;s
correspondantes dans le fichier &lt;RoboHelp Server Home&gt;/Web-INF/classes/log4j.properties.
• Vous pouvez d&eacute;sormais h&eacute;berger RoboHelp Server via le protocole HTTP s&eacute;curis&eacute; (HTTPS) pour garantir des
communications s&eacute;curis&eacute;es entre le serveur et les clients.
• Les auteurs peuvent publier leurs projets RoboHelp HTML &agrave; l’aide du protocole HTTPS
• Les utilisateurs finaux peuvent afficher les projets sur le serveur via le protocole HTTPS
• RoboHelp Server Web Administrator et ses rapports peuvent &ecirc;tre &eacute;galement consult&eacute;s via le protocole HTTPS
Derni&egrave;re mise &agrave; jour le 16/3/2011
16
UTILISATION DE ROBOHELP HTML 9
Prise en main
Param&egrave;tres de mod&eacute;ration des commentaires de l’aide Adobe AIR
Vous pouvez d&eacute;sormais indiquer, &agrave; l’aide de l’Administrateur Web, les param&egrave;tres de mod&eacute;ration suivants des
commentaires pour les r&eacute;sultats de l’aide Adobe&reg; AIR&reg; :
• Autoriser les publications anonymes
• Marquer les commentaires comme en attente
Am&eacute;liorations li&eacute;es &agrave; la recherche
RoboHelp Server 9 est dot&eacute; de nombreuses am&eacute;liorations li&eacute;es &agrave; la recherche :
Liste d’exclusion des projets pour l’indexation c&ocirc;t&eacute; serveur Contrairement &agrave; RoboHelp 8, la liste d’exclusion sp&eacute;cifi&eacute;e
dans un projet RoboHelp HTML est maintenant utilis&eacute;e pour l’indexation c&ocirc;t&eacute; serveur.
Liste de synonymes des projets pour l’indexation c&ocirc;t&eacute; serveur Contrairement &agrave; RoboHelp 8, la liste de synonymes
sp&eacute;cifi&eacute;e dans un projet RoboHelp HTML est maintenant utilis&eacute;e pour l’indexation c&ocirc;t&eacute; serveur.
Mise en surbrillance des synonymes Les synonymes d’un mot-cl&eacute; faisant l’objet d’une recherche sont mis en
surbrillance dans la liste de r&eacute;sultats. Cette am&eacute;lioration n’est disponible que pour les sorties WebHelp Pro publi&eacute;es &agrave;
l’aide de RoboHelp HTML 9.
Contexte dynamique dans les r&eacute;sultats de la recherche pour l’indexation c&ocirc;t&eacute; serveur RoboHelp Server affiche &agrave;
pr&eacute;sent le contexte dynamique avec les r&eacute;sultats de la recherche. Apache Lucene, la biblioth&egrave;que de moteur de
recherche de texte actionnant la recherche dans RoboHelp Server, affiche les termes pertinents autour d’un mot-cl&eacute; en
guise de contexte dans la liste de r&eacute;sultats de la recherche. Cette fonctionnalit&eacute; n’est disponible que pour les projets
WebHelp Pro et FlashHelp Pro publi&eacute;s dans RoboHelp Server avec l’indexation c&ocirc;t&eacute; serveur activ&eacute;e.
• Pour les mots-cl&eacute;s des rubriques, les mots situ&eacute;s &agrave; proximit&eacute; imm&eacute;diate s’affichent comme du contexte.
• Le contexte statique de la rubrique s’affiche pour les mots-cl&eacute;s sp&eacute;cifi&eacute;s par l’utilisateur. Les premiers mots de la
rubrique constituent le contexte statique.
• Pour les ressources externes des mots-cl&eacute;s, la description de l’URL de la ressource externe s’affiche en tant que
contexte dynamique.
Remarque : Pour les projets WebHelp Pro, le contexte dynamique s’affiche sous une rubrique dans la liste des r&eacute;sultats
de la recherche, avec le texte pertinent apparaissant en gras et en surbrillance. Pour les projets FlashHelp Pro, le
contexte dynamique s’affiche sous forme d’info-bulle lorsque l’utilisateur passe le pointeur de la souris sur une
rubrique dans la liste de r&eacute;sultats.
Am&eacute;liorations li&eacute;es &agrave; la cr&eacute;ation de rapports
RoboHelp Server 9 apporte plusieurs am&eacute;liorations permettant d’optimiser la valeur de votre contenu d’aide :
• Fonctionnalit&eacute;s de filtrage des rapports par zone
• Nouveaux noms intuitifs des noms de rapports
• Am&eacute;liorations apport&eacute;es &agrave; la repr&eacute;sentation graphique des rapports
• Fonctionnalit&eacute; d’exportation des donn&eacute;es des rapports au format CSV
• Possibilit&eacute; de personnaliser les rapports par l’affichage/le masquage des colonnes. Possibilit&eacute; d’enregistrer la
disposition des colonnes sur plusieurs sessions.
• Possibilit&eacute; de peaufiner les donn&eacute;es num&eacute;riques des rapports.
Derni&egrave;re mise &agrave; jour le 16/3/2011
17
UTILISATION DE ROBOHELP HTML 9
Prise en main
Am&eacute;liorations apport&eacute;es au Gestionnaire de configuration
Il est d&eacute;sormais possible d’effectuer les t&acirc;ches suivantes &agrave; l’aide du Gestionnaire de configuration de RoboHelp Server :
• Migrer les donn&eacute;es contextuelles depuis RoboHelp Server 8 vers RoboHelp Server 9
• D&eacute;ployer un contexte dans le contexte racine
• Supprimer des contextes
• Configurer un compte d’administrateur pour RoboHelp Server &agrave; l’aide de l’authentification LDAP ou de
l’authentification d’une base de donn&eacute;es
• Configurer les param&egrave;tres LDAP
• Configurer les param&egrave;tres l’indexation de la recherche
Les d&eacute;tails
• L’Administrateur Web fournit d&eacute;sormais des fonctionnalit&eacute;s de modification et de suppression des utilisateurs.
Seuls les administrateurs RoboHelp Server sont autoris&eacute;s &agrave; modifier ou supprimer les utilisateurs.
Remarque : Ces fonctionnalit&eacute;s sont particuli&egrave;rement utiles pour la d&eacute;finition d’un nouveau mot de passe en cas de
perte ou d’oubli.
• Nouveau lien de d&eacute;connexion dans l’Administrateur Web
Derni&egrave;re mise &agrave; jour le 16/3/2011
18
Chapitre 2 : D&eacute;couverte de l’espace de
travail
Pr&eacute;sentation de l’espace de travail
Vous pouvez cr&eacute;er et manipuler vos projets &agrave; l’aide de divers &eacute;l&eacute;ments, tels que les conteneurs, volets, barres et 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 barres d’outils et menus personnalisables. Des menus &agrave; d&eacute;velopper effectuent le suivi des commandes que
vous utilisez le plus fr&eacute;quemment et les affichent sur une version abr&eacute;g&eacute;e de chaque menu. Vous pouvez &eacute;galement
personnaliser les raccourcis clavier et ajouter de nouvelles barres d’outils.
D
E
A
F
B
C
Espace de travail RoboHelp
A. Barre de menus B. Barres d’outils C. Conteneurs club D. Volet Document &agrave; onglets E. Editeur de conception F. S&eacute;lecteur d’espace de
travail
• La barre de menus occupe la partie sup&eacute;rieure et contient un s&eacute;lecteur permettant de basculer vers un autre espace
de travail, ainsi que des commandes permettant d’afficher diff&eacute;rents menus.
• Diff&eacute;rentes barres d’outils s’affichent sous la barre de menus. S&eacute;lectionnez Afficher &gt; Barres d’outils pour afficher
ou masquer les barres d’outils dont vous avez besoin.
Derni&egrave;re mise &agrave; jour le 16/3/2011
19
UTILISATION DE ROBOHELP HTML 9
D&eacute;couverte de l’espace de travail
• La fen&ecirc;tre de rubrique ou le volet Document &agrave; onglets affiche la ou les rubrique(s) en cours de modification.
S&eacute;lectionnez Outils &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.
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.
• Diff&eacute;rents conteneurs, tels que Gestionnaire de projets, Configuration du projet, Gestionnaire de ressources et
Mises en page source uniques, 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 Afficher &gt; Conteneurs pour afficher ou masquer les conteneurs souhait&eacute;s.
Utilisation des conteneurs
Les conteneurs sont des volets de flux de production 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 uniques.
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
❖ S&eacute;lectionnez Afficher &gt; Conteneurs &gt; [nom du conteneur].
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.
1 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.
2 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
20
UTILISATION DE ROBOHELP HTML 9
D&eacute;couverte de l’espace de travail
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.
Ressources Permet d’acc&eacute;der &agrave; des forums, des centres de d&eacute;veloppeur, des articles de bases de connaissances et
d’autres types de contenu en ligne.
Nouveaut&eacute;s sur les produits Acc&eacute;dez aux informations sur les produits Adobe.
Afficher l’aide en ligne Acc&eacute;dez &agrave; l’aide en ligne compl&egrave;te.
Pr&eacute;sentation rapide de RoboHelp Acc&eacute;dez &agrave; un ensemble de vid&eacute;os pour b&eacute;n&eacute;ficier d’une pr&eacute;sentation rapide des
fonctionnalit&eacute;s RoboHelp.
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.
Si le projet comporte de nombreuses rubriques, r&eacute;duisez d’abord le dossier Fichiers de projet pour afficher les autres
dossiers.
Voir aussi
&laquo; Dossiers du gestionnaire de projets &raquo; &agrave; la page 53
Conteneur Configuration du projet
Le conteneur Configuration du projet se compose des dossiers ci-dessous.
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.
Dossier Pages type Les pages type 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.
Recherche de contenu externe Mappez des URL et des termes de recherche pour permettre aux utilisateurs de trouver
du contenu associ&eacute; &agrave; l’ext&eacute;rieur du syst&egrave;me d’aide.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
21
UTILISATION DE ROBOHELP HTML 9
D&eacute;couverte de l’espace de travail
• 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.
Voir aussi
&laquo; Fen&ecirc;tres &raquo; &agrave; la page 375
&laquo; Pages type &raquo; &agrave; la page 125
&laquo; Habillages &raquo; &agrave; la page 368
&laquo; Recherche de contenu externe &raquo; &agrave; la page 224
&laquo; A propos de l’aide contextuelle &raquo; &agrave; la page 248
&laquo; Fichiers de mappage et ID de mappage &raquo; &agrave; la page 249
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.
Voir aussi
&laquo; Source unique pour les extraits de code &raquo; &agrave; la page 166
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 Format &gt; Styles pour afficher le conteneur Styles et formatage. Pour ce faire, vous devez ouvrir
une rubrique.
Voir aussi
&laquo; Cr&eacute;ation d’un style via le conteneur Styles et formatage &raquo; &agrave; la page 171
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
22
UTILISATION DE ROBOHELP HTML 9
D&eacute;couverte de l’espace de travail
Voir aussi
&laquo; Variables d&eacute;finies par l’utilisateur &raquo; &agrave; la page 163
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 type. 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 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 fichier .flv, .swf et .avi.
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.
Voir aussi
&laquo; Gestion des ressources &raquo; &agrave; la page 134
Conteneur RoboHelp Server
Le conteneur RoboHelp Server vous permet de vous connecter &agrave; RoboHelp Server. Vous pouvez configurer le serveur
en s&eacute;lectionnant WebHelp Pro ou FlashHelp Pro comme mise en page principale.
Vous pouvez entrer le serveur Servername:port/context-name/server et vous y connecter pour publier vos
projets.
Remarque : par d&eacute;faut, RoboHelp utilise le protocole http. Pour sp&eacute;cifier qu’il convient d’utiliser le protocole https,
saisissez https://Servername:port/context-name/server.
Derni&egrave;re mise &agrave; jour le 16/3/2011
23
UTILISATION DE ROBOHELP HTML 9
D&eacute;couverte de l’espace de travail
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.
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
utilisateur]\Mes Documents\My RoboHelp Projects.
Remarque : Vous pouvez &eacute;changer un fichier RHS avec d'autres auteurs.
Chargement d’un environnement
1 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.
2 Acc&eacute;dez &agrave; un fichier RHS et s&eacute;lectionnez-le.
3 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
❖ 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
❖ 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;
9.00 &gt; Common et supprimez la cha&icirc;ne affect&eacute;e &agrave; la variable.
Menus et barres d'outils
Personnalisation des menus
1 Cliquez avec le bouton droit de la souris sur une barre d’outils et s&eacute;lectionnez l’option Personnaliser.
2 Cliquez sur l’onglet Commandes.
3 Choisissez Nouveau menu dans la liste Cat&eacute;gories.
Derni&egrave;re mise &agrave; jour le 16/3/2011
24
UTILISATION DE ROBOHELP HTML 9
D&eacute;couverte de l’espace de travail
4 Dans la section Commandes, cliquez sur Nouveau menu et faites glisser l'option dans la barre de menus, jusqu'&agrave;
l'emplacement o&ugrave; vous souhaitez qu'elle apparaisse.
5 Cliquez avec le bouton droit de la souris sur l'option Nouveau menu dans la barre d'outils et cliquez dans le champ Nom.
6 Saisissez le nom de menu souhait&eacute; et appuyez sur Entr&eacute;e.
7 Choisissez diff&eacute;rentes cat&eacute;gories et faites glisser les commandes souhait&eacute;es vers le menu.
8 Cliquez sur Fermer.
9 Red&eacute;marrez RoboHelp HTML pour conserver les modifications.
Personnalisation des barres d’outils
1 S&eacute;lectionnez Afficher &gt; Barres d’outils &gt; Personnaliser.
Remarque : vous pouvez &eacute;galement cliquer avec le bouton droit de la souris sur une barre d’outils et s&eacute;lectionner
l’option Personnaliser.
2 Effectuez l’une des op&eacute;rations suivantes :
• Pour cr&eacute;er une barre d’outils, cliquez sur l’onglet du m&ecirc;me nom. Cliquez sur Nouveau, saisissez un nom, puis
cliquez sur OK.
• Pour ajouter un &eacute;l&eacute;ment &agrave; une barre d’outils, cliquez sur l’onglet Commandes. S&eacute;lectionnez une cat&eacute;gorie et
faites glisser une commande vers la barre d’outils.
• Pour modifier un nouvel &eacute;l&eacute;ment de la barre d’outils, cliquez avec le bouton droit de la souris sur son ic&ocirc;ne dans
la barre d’outils, puis s&eacute;lectionnez les options de votre choix, par exemple Supprimer et Nom. L’option
Commencer le groupe ins&egrave;re une barre de s&eacute;paration &agrave; la gauche de l’&eacute;l&eacute;ment.
Vous pouvez utiliser une esperluette (&amp;) dans le nom pour ajouter des raccourcis clavier. Par exemple, un et
commercial pr&eacute;c&egrave;de la lettre &laquo; o &raquo; du mot &laquo; Format &raquo; dans le menu Format. Pour acc&eacute;der au menu Format &agrave;
l’aide d’un raccourci clavier, appuyez sur Alt + O.
• Pour modifier une image de bouton, cliquez dessus avec le bouton droit et s&eacute;lectionnez Modifier une image de
bouton. Modifiez l’image &agrave; l’aide des outils d’&eacute;dition de boutons. V&eacute;rifiez l’aper&ccedil;u et cliquez sur OK.
• Pour modifier les menus et les &eacute;l&eacute;ments de la barre d'outils, cliquez sur l'onglet Options. D&eacute;finissez les options
suivantes au besoin :
Toujours afficher les menus complets S&eacute;lectionnez cette option pour afficher tous les menus disponibles. Voir
&laquo; Activation et d&eacute;sactivation de menus intelligents &raquo; &agrave; la page 25
Afficher les menus entiers apr&egrave;s un court d&eacute;lai S&eacute;lectionnez cette option pour afficher quelques menus au
moment du lancement de l’application et d’autres menus un peu plus tard.
R&eacute;tablir les donn&eacute;es d’utilisation des menus et des barres d’outils Cliquez sur ce bouton pour supprimer tous
les enregistrements de commandes nouvelles ou modifi&eacute;es et restaurer les param&egrave;tres par d&eacute;faut.
Grandes ic&ocirc;nes S&eacute;lectionnez cette option pour afficher les menus sous forme de grandes ic&ocirc;nes.
Afficher les Info-bulles Affiche les info-bulles sur les barres d’outils.
Afficher les touches de raccourci dans les Info-bulles Affiche les touches de raccourci dans les info-bulles.
Animations de menu Permet de s&eacute;lectionner un type d’animation pour le menu contextuel.
Derni&egrave;re mise &agrave; jour le 16/3/2011
25
UTILISATION DE ROBOHELP HTML 9
D&eacute;couverte de l’espace de travail
Voir aussi
&laquo; Cr&eacute;ation de raccourcis clavier &raquo; &agrave; la page 25
&laquo; Personnalisation des menus &raquo; &agrave; la page 23
Activation et d&eacute;sactivation de menus intelligents
Les menus intelligents affichent uniquement les commandes les plus souvent utilis&eacute;es. Pour acc&eacute;der aux commandes
masqu&eacute;es, cliquez sur la fl&egrave;che vers le bas &agrave; la fin du menu de commandes.
1 Cliquez avec le bouton droit de la souris sur une barre d’outils.
2 S&eacute;lectionnez Personnaliser.
3 Cliquez sur l’onglet Options.
4 Sous Menus et barres d’outils personnalis&eacute;s, s&eacute;lectionnez ou d&eacute;s&eacute;lectionnez l’option Toujours afficher les menus
complets.
Cr&eacute;ation et suppression de raccourcis clavier
Cr&eacute;ation de raccourcis clavier
1 S&eacute;lectionnez Afficher &gt; Barres d’outils &gt; Personnaliser.
2 Cliquez sur l’onglet Clavier.
3 S&eacute;lectionnez une cat&eacute;gorie de commande.
4 S&eacute;lectionnez la commande &agrave; affecter au raccourci clavier.
5 Saisissez le raccourci clavier dans le champ Appuyez sur une nouvelle touche de raccourci.
6 Cliquez sur Assigner.
Suppression ou r&eacute;initialisation de touches de raccourci
1 S&eacute;lectionnez Afficher &gt; Barres d’outils &gt; Personnaliser.
2 Cliquez sur l’onglet Clavier.
3 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.
Configuration des param&egrave;tres g&eacute;n&eacute;raux
❖ S&eacute;lectionnez Outils &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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
26
UTILISATION DE ROBOHELP HTML 9
D&eacute;couverte de l’espace de travail
D&eacute;finition de la langue par d&eacute;faut et d’autres pr&eacute;f&eacute;rences
Langue par d&eacute;faut Permet de changer la langue par d&eacute;faut de tous les projets cr&eacute;&eacute;s &agrave; l’aide de l’application RoboHelp.
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 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.
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.
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 Outils &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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
27
Chapitre 3 : Projets
El&eacute;ments de base du projet
Flux de production de base
1. 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.
2. 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.
3. 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).
4. 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.
5. Personnalisation de la sortie
Vous pouvez appliquer des mises en page (qui d&eacute;terminent le comportement et l’apparence) ainsi que le 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.
6. Cr&eacute;ation, test et distribution de l’aide
Cr&eacute;ez 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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
28
UTILISATION DE ROBOHELP HTML 9
Projets
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 uniques 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.
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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
29
UTILISATION DE ROBOHELP HTML 9
Projets
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.
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
• Mots-cl&eacute;s Voir aussi
• Habillages (ajout ou suppression uniquement)
• Mises en page source uniques (lors de l'ajout ou la suppression de mises en page source uniques 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 uniques seulement)
• Fen&ecirc;tres
Derni&egrave;re mise &agrave; jour le 16/3/2011
30
UTILISATION DE ROBOHELP HTML 9
Projets
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.
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.
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).
Derni&egrave;re mise &agrave; jour le 16/3/2011
31
UTILISATION DE ROBOHELP HTML 9
Projets
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 permet de g&eacute;n&eacute;rer l’aide dans le 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
• 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
• Commentaires riches et mises &agrave; jour automatiques
• 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
• Recherche am&eacute;lior&eacute;e
Exigences de l'afficheur de l'utilisateur final
Syst&egrave;me de
l’utilisateur
WebHelp/Pro
FlashHelp Pro
Microsoft HTML
Help
JavaHelp*
Oracle Help
Aide AIR
Windows XP SP4
Navigateur Web
ou version
ult&eacute;rieure,
Windows XP, Vista
Navigateur Web
avec Flash Player
8.0 ou 9.0
Afficheur int&eacute;gr&eacute;
Afficheur
JavaHelp
Afficheur
Oracle Help
Ex&eacute;cution de l'aide
AIR
Mac OS, Linux&reg;
Navigateur Web
avec Flash Player
8.0 ou 9.0
Non disponible
Afficheur
JavaHelp
Non
disponible
Ex&eacute;cution de l'aide
AIR
Navigateur Web
* Requiert Sun Java 2 JDK et JavaHelp 1.0, ou des versions ult&eacute;rieures de ces programmes avec l'afficheur JavaHelp.
Cr&eacute;ation et ouverture 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 &gt; 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
32
UTILISATION DE ROBOHELP HTML 9
Projets
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 type 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.
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 types &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 :
• 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.
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).
Voir aussi
&laquo; Modification des param&egrave;tres du projet &raquo; &agrave; la page 37
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 &gt; Projet. Cliquez sur l’onglet Importer et s&eacute;lectionnez un nouveau type de
projet.
Derni&egrave;re mise &agrave; jour le 16/3/2011
33
UTILISATION DE ROBOHELP HTML 9
Projets
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 &gt; 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 le bouton 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, reportez-vous &agrave; la
section &laquo; Concepts de base de la conversion &raquo; &agrave; la page 86.
Pour plus d'informations sur les diff&eacute;rentes options de conversion des documents Word, reportez-vous &agrave; la section
&laquo; Conversion de styles Word en styles RoboHelp &raquo; &agrave; la page 71.
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.
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 &gt; 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 Cliquez sur Suivant.
Derni&egrave;re mise &agrave; jour le 16/3/2011
34
UTILISATION DE ROBOHELP HTML 9
Projets
7 Indiquez la saisie requise dans la bo&icirc;te de dialogue Options de traitement de DITA Open Toolkit.
8 Cliquez sur Terminer.
Voir aussi
&laquo; Importation d’un fichier de mappage DITA &raquo; &agrave; la page 99
&laquo; Conversion de styles Word en styles RoboHelp &raquo; &agrave; la page 71
D&eacute;finition de 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. l’ordre par d&eacute;faut est alphanum&eacute;rique. Vous pouvez faire glisser
les dossiers et les rubriques pour personnaliser la s&eacute;quence. RoboHelp utilise un ordre personnalis&eacute; 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.
• Vous pouvez faire glisser des dossiers du conteneur Gestionnaire de projets dans le conteneur Table des mati&egrave;res.
Ces dossiers sont convertis en livres de table des mati&egrave;res et toutes les rubriques se transforment en pages.
• Les &eacute;l&eacute;ments de la table des mati&egrave;res ne changent pas de fa&ccedil;on dynamique &agrave; mesure que vous les changez dans le
Gestionnaire de projets ou dans une rubrique.
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.
• Il est impossible de faire glisser des rubriques dans ou hors d’un document li&eacute;.
Voir aussi
&laquo; Cr&eacute;ation de tables des mati&egrave;res &raquo; &agrave; la page 180
Ouvrir un projet
Ouverture d'un projet et affichage de l'historique
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
35
UTILISATION DE ROBOHELP HTML 9
Projets
Important : Cr&eacute;ez une copie de votre projet avant de le convertir dans un nouveau format.
Ne pas ouvrir le projet. Je veux d’abord en faire une copie. Ferme la bo&icirc;te de dialogue Ouvrir un projet afin que vous
puissiez copier vos fichiers de projet. Vous pouvez par exemple utiliser l’Explorateur Windows pour copier vos fichiers
de projet et les stocker dans le dossier Mes documents.
Convertir les fichiers le cas &eacute;ch&eacute;ant Ouvre le projet et convertit les fichiers au cours de votre travail. Si vous apportez
une modification globale ou une modification affectant plusieurs fichiers, vous &ecirc;tes invit&eacute; &agrave; les convertir. C’est le cas
par exemple d’une feuille de style attach&eacute;e &agrave; plusieurs rubriques de votre projet. Lorsque vous tentez de la modifier,
vous &ecirc;tes invit&eacute; &agrave; convertir toutes les rubriques au nouveau format.
Convertir tous les fichiers Convertit tous les fichiers de votre projet au nouveau format. Ne s&eacute;lectionnez pas cette
option si vous n’avez pas enregistr&eacute; une copie de la version originale.
Voir aussi
&laquo; Ajout d’un projet RoboHelp au contr&ocirc;le de version &raquo; &agrave; la page 42
Ouverture d’un projet lors du d&eacute;marrage de RoboHelp
❖ 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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
36
UTILISATION DE ROBOHELP HTML 9
Projets
Nom du fichier : 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 S&eacute;lectionnez Fichier &gt; Ouvrir. 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.
2 Dans le menu Fichiers de type, s&eacute;lectionnez Projet RoboHelp HTML Help (.xpj).
3 Recherchez le fichier du projet et cliquez deux fois dessus.
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 Outils &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.
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 barres d’outils 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;.
Voir aussi
&laquo; Affichage de la sortie &raquo; &agrave; la page 338
Gestion des projets
Enregistrement de projets
Enregistrez vos projets &agrave; intervalles fr&eacute;quents.
• Pour enregistrer des fichiers individuels, s&eacute;lectionnez Fichier &gt; Enregistrer [&eacute;l&eacute;ment].
• Pour enregistrer tous les fichiers, cliquez sur le bouton Enregistrer tout
Derni&egrave;re mise &agrave; jour le 16/3/2011
.
37
UTILISATION DE ROBOHELP HTML 9
Projets
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.
Modification des param&egrave;tres du projet
1 Choisissez Fichier &gt; Param&egrave;tres du projet.
2 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, reportez-vous &agrave; la section &laquo; Utilisation de la liste d’actions &agrave; faire &raquo; &agrave; la page 50.
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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
38
UTILISATION DE ROBOHELP HTML 9
Projets
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 Toujours ignorer les mots
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.
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 WebHelp, WebHelp Pro, FlashHelp, FlashHelp
Pro, AIR, 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.
❖ 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 mini-tables des mati&egrave;res dans
les param&egrave;tres des pages type. Pour plus d’informations, reportez-vous &agrave; la section &laquo; Pages type &raquo; &agrave; la page 125.
R&eacute;initialiser &agrave; la valeur par d&eacute;faut Efface les nouvelles entr&eacute;es et restaure la liste par d&eacute;faut.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
39
UTILISATION DE ROBOHELP HTML 9
Projets
Nouveau Cliquez sur Nouveau pour ajouter un synonyme du mot.
Supprimer Cliquez sur Supprimer pour supprimer le mot et ses synonymes.
Voir aussi
&laquo; Principes de base de la recherche RoboHelp &raquo; &agrave; la page 223
&laquo; Mise &agrave; niveau de projets localis&eacute;s &raquo; &agrave; la page 63
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 Ouvrez le projet.
2 S&eacute;lectionnez Fichier &gt; Renommer le projet.
3 Dans la zone Nom du projet, saisissez le nouveau nom du projet. (Ne saisissez pas d’extension de nom de fichier.)
4 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.
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) ou un logiciel tiers. Dans tous les cas,
les t&acirc;ches de contr&ocirc;le de version sont effectu&eacute;es dans RoboHelp.
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. Ou bien regardez si le fichier n'est pas en contr&ocirc;le de version.
Derni&egrave;re mise &agrave; jour le 16/3/2011
40
UTILISATION DE ROBOHELP HTML 9
Projets
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 Outils &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 le bouton de la barre d'outils
Contr&ocirc;le de version. Ou bien, dans Fichier &gt; Contr&ocirc;le de version, s&eacute;lectionnez le fichier puis sur une option.
Application du contr&ocirc;le de version
1 Installez un logiciel de contr&ocirc;le de version prenant en charge l’API Microsoft SCC.
2 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.
3 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 Afficher &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.
Conteneur Liste des rubriques S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Liste des rubriques. Il permet d’ouvrir, d’afficher
et de trier les rubriques.
Conteneur Gestionnaire de projets S&eacute;lectionnez Afficher &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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
41
UTILISATION DE ROBOHELP HTML 9
Projets
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 Outils &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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
42
UTILISATION DE ROBOHELP HTML 9
Projets
Ajout d’un projet RoboHelp au contr&ocirc;le de version
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.
Reportez-vous &agrave; l’Aide d'Adobe RoboSource Control pour plus d’informations.
1 Ouvrez le projet dans RoboHelp HTML.
2 S&eacute;lectionnez Fichier &gt; Contr&ocirc;le de version &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.
6 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 Cliquez sur Cr&eacute;er, puis sur Connecter.
8 Connectez-vous &agrave; RoboSource Control.
9 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.
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.
11 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).
Derni&egrave;re mise &agrave; jour le 16/3/2011
43
UTILISATION DE ROBOHELP HTML 9
Projets
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;).
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.
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 :
• 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 &laquo; Cr&eacute;ation d’un projet
ma&icirc;tre &raquo; &agrave; la page 44.
• Publiez les projets enfants. Voir &laquo; Publication de projets enfants &raquo; &agrave; la page 45.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
44
UTILISATION DE ROBOHELP HTML 9
Projets
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 &laquo; Configuration de
la mise en page Adobe AIR &raquo; &agrave; la page 312.
Remarque : les projets 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.
en vue de faciliter l’entretien, 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 ? dans &laquo; Questions fr&eacute;quentes sur la fusion des projets &raquo; &agrave;
la page 47.
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.
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 Pour ins&eacute;rer des projets enfants, placez votre curseur dans la table des mati&egrave;res.
6 Dans le conteneur Table des mati&egrave;res, cliquez sur l'ic&ocirc;ne Nouveau projet fusionn&eacute;.
7 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
45
UTILISATION DE ROBOHELP HTML 9
Projets
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;.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
46
UTILISATION DE ROBOHELP HTML 9
Projets
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 uniques 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.
5 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].
6 Cliquez sur Enregistrer et g&eacute;n&eacute;rer. La mise en page est g&eacute;n&eacute;r&eacute;e.
7 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.
8 Cliquez sur Fermer.
9 Affichez le projet ma&icirc;tre depuis son emplacement publi&eacute; pour afficher l'aide fusionn&eacute;e.
Affichage des projets d'aide fusionn&eacute;s
1 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
&laquo; Distribution de la sortie Adobe AIR &raquo; &agrave; la page 353.
2 Cliquez avec le bouton droit de la souris sur le dossier Mises en page source uniques 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.
2 Le fait de supprimer un projet enfant d’un projet ma&icirc;tre ne le supprime pas d’un emplacement dans lequel il &eacute;tait
publi&eacute;. Utilisez un autre outil pour supprimer les anciens fichiers ou supprimez-les manuellement.
Derni&egrave;re mise &agrave; jour le 16/3/2011
47
UTILISATION DE ROBOHELP HTML 9
Projets
Personnalisation de projets WebHelp/FlashHelp Pro fusionn&eacute;s
RoboHelp Server fusionne automatiquement les projets WebHelp/FlashHelp Pro multiples. 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.
3 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.
4 Dans la zone Nom du projet, saisissez un nom de projet WebHelp/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;.
5 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.
6 G&eacute;n&eacute;rez tous les projets pour mettre &agrave; jour toutes les modifications.
7 Publiez le projet ma&icirc;tre.
8 Affichez le projet fusionn&eacute; &agrave; partir du serveur.
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 ?
Oui, le projet ma&icirc;tre peut inclure un nombre quelconque de cat&eacute;gories de contenu. Toutefois, les projets enfants ne
doivent pas comporter de 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
48
UTILISATION DE ROBOHELP HTML 9
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.
• Terme 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.
• Mots-cl&eacute;s Voir aussi
• 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.
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 ?
Derni&egrave;re mise &agrave; jour le 16/3/2011
49
UTILISATION DE ROBOHELP HTML 9
Projets
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.
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 &laquo; Distribution de la sortie Adobe AIR &raquo; &agrave; la page 353.
Gestion des fichiers
Affichage des rubriques par titre ou par nom de fichier
1 Dans le conteneur Gestionnaire de projets, ouvrez le dossier Fichiers de projet.
Derni&egrave;re mise &agrave; jour le 16/3/2011
50
UTILISATION DE ROBOHELP HTML 9
Projets
2 S&eacute;lectionnez Afficher &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.
Modification d'&eacute;l&eacute;ments sur la liste des actions &agrave; faire
1 S&eacute;lectionnez Fichier &gt; Param&egrave;tres du projet.
2 Cliquez sur l’onglet G&eacute;n&eacute;ralit&eacute;s.
3 Cliquez sur G&eacute;rer.
4 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 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.
2 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.
❖ 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 Outils &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.
Voir aussi
&laquo; Verrouillage d’un projet sur la liste des derniers projets ouverts &raquo; &agrave; la page 36
Derni&egrave;re mise &agrave; jour le 16/3/2011
51
UTILISATION DE ROBOHELP HTML 9
Projets
Ajout de fichiers 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. Le cas &eacute;ch&eacute;ant, ajoutez des fichiers au dossier Fichiers bagage afin que les &eacute;l&eacute;ments externes apparaissent
correctement dans la sortie :
1 S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Gestionnaire de projets.
2 Cliquez avec le bouton droit de la souris sur le dossier Fichiers bagage. S&eacute;lectionnez Nouveau &gt; Fichier bagage.
Remarque : si le dossier Fichiers bagage ne s’affiche pas, cliquez sur le bouton Basculer l’affichage du gestionnaire de
projets
.
3 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 Cliquez sur Oui.
Remarque : Vous pouvez cr&eacute;er un lien vers un fichier bagage en le glissant-d&eacute;posant dans une rubrique tout en
maintenant la touche MAJ enfonc&eacute;e.
Suppression des fichiers du dossier Fichiers bagage
Pour supprimer un fichier du dossier Fichiers bagage :
❖ S&eacute;lectionnez le fichier et cliquez sur Supprimer.
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 S&eacute;lectionnez Outils &gt; Options.
2 Cliquez sur l’onglet Association de fichiers.
3 Pour des programmes associ&eacute;s, cliquez sur Ajouter.
4 Saisissez une extension de nom de fichier.
5 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.
6 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 S&eacute;lectionnez Outils &gt; Options.
2 Cliquez sur l’onglet Association de fichiers.
Derni&egrave;re mise &agrave; jour le 16/3/2011
52
UTILISATION DE ROBOHELP HTML 9
Projets
3 Pour les &eacute;diteurs HTML, cliquez sur Ajouter.
4 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.
5 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.
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.
Voir aussi
&laquo; Rapport sur les liens rompus &raquo; &agrave; la page 111
&laquo; Rapport sur les fichiers inutilis&eacute;s &raquo; &agrave; la page 116
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, ouvrez 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
53
UTILISATION DE ROBOHELP HTML 9
Projets
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.
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 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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
54
UTILISATION DE ROBOHELP HTML 9
Projets
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 Dans la barre d’outils, cliquez sur Supprimer.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
55
UTILISATION DE ROBOHELP HTML 9
Projets
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.
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;posezle 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
56
UTILISATION DE ROBOHELP HTML 9
Projets
Ic&ocirc;ne
Description
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 les 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.
Fichier de la 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.
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.
Voir aussi
&laquo; D&eacute;finition de la mise en page des chapitres &raquo; &agrave; la page 34
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).
Derni&egrave;re mise &agrave; jour le 16/3/2011
57
UTILISATION DE ROBOHELP HTML 9
Projets
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.
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
Fichier &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
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
Italien (Italie)
Oui
Oui
Oui
Oui
N&eacute;erlandais (Pays-Bas)
Oui
Oui
Oui
Oui
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
Derni&egrave;re mise &agrave; jour le 16/3/2011
58
UTILISATION DE ROBOHELP HTML 9
Projets
Langues
V&eacute;rification
orthographique
Dictionnaire
utilisateur
Th&eacute;saurus
Correction
automatique
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
Chinois simplifi&eacute; (Chine)
Non
Non
Non
Non
Tha&iuml; (Tha&iuml;lande)
Non
Non
Non
Non
Vietnamien (Vietnam)
Non
Non
Non
Non
Voir aussi
&laquo; D&eacute;finition d’une langue pour un paragraphe &raquo; &agrave; la page 152
&laquo; Cr&eacute;er une rubrique &raquo; &agrave; la page 119
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).
Derni&egrave;re mise &agrave; jour le 16/3/2011
59
UTILISATION DE ROBOHELP HTML 9
Projets
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.
Comparaison entre plusieurs langues
1 Ouvrez les rubriques cr&eacute;&eacute;es dans diff&eacute;rentes langues.
2 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
horizontal ou Nouveau groupe d’onglets vertical.
appara&icirc;t. Choisissez Nouveau groupe d’onglets
S&eacute;lection d’une langue de traduction diff&eacute;rente pour un fichier de projet
1 S&eacute;lectionnez Fichier &gt; Param&egrave;tres du projet.
2 S&eacute;lectionnez la langue souhait&eacute;e.
3 Cliquez sur Avanc&eacute;, puis utilisez les onglets ci-dessous.
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.
Fichier LNG 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 S&eacute;lectionnez Fichier &gt; Nouveau &gt; Projet.
2 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
60
UTILISATION DE ROBOHELP HTML 9
Projets
3 Saisissez les informations relatives au projet.
4 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.
5 Cliquez sur Terminer.
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.
Voir aussi
&laquo; Cr&eacute;ation et modification de mises en page source uniques &raquo; &agrave; la page 296
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.
Modification du fichier LNG (de langue)
1 Cr&eacute;ez ou ouvrez un projet.
2 S&eacute;lectionnez Fichier &gt; Param&egrave;tres du projet.
3 Cliquez sur l’onglet G&eacute;n&eacute;ralit&eacute;s. Cliquez sur Avanc&eacute;.
4 Cliquez sur l'onglet Fichier LNG.
5 S&eacute;lectionnez le texte d’interface. Cliquez sur le bouton Modifier.
6 Tapez les modifications. Appuyez sur Entr&eacute;e.
Remarque :
• 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).
Derni&egrave;re mise &agrave; jour le 16/3/2011
61
UTILISATION DE ROBOHELP HTML 9
Projets
• 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.
Modification de la langue par d&eacute;faut d’un projet
1 Ouvrez le projet.
2 S&eacute;lectionnez Fichier &gt; Param&egrave;tres du projet.
3 Cliquez sur l’onglet G&eacute;n&eacute;ralit&eacute;s, puis s&eacute;lectionnez la langue souhait&eacute;e.
4 Cliquez sur OK.
5 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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
62
UTILISATION DE ROBOHELP HTML 9
Projets
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.
Pour &eacute;viter ce probl&egrave;me, RoboHelp prend en charge le jeu de caract&egrave;res universels fourni par Unicode.
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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
63
UTILISATION DE ROBOHELP HTML 9
Projets
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
Si vous personnalisez une expression, une liste d'exclusion, une liste de mots &agrave; ignorer ou un fichier LNG avec
RoboHelp 6 ou version ant&eacute;rieure, d&eacute;placez la liste dans RoboHelp 8 ou version ult&eacute;rieure, qui utilise une structure de
fichier et des extensions diff&eacute;rentes.
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].
Personnalisations mineures
1 Ouvrez le Bloc-notes.
2 Ouvrez le fichier &agrave; modifier. Ces fichiers sont stock&eacute;s sous C:\Program Files\Adobe\Adobe RoboHelp
[version]\RoboHTML\!Language!\en_US.
3 Ouvrez le projet. Effectuez les op&eacute;rations suivantes :
• Modification du fichier LNG.
• Modification des listes de mots personnalis&eacute;es.
Personnalisations majeures
1 Ouvrez le Bloc-notes.
2 Ouvrez l’ancien fichier sous C:\Program Files\Adobe\Adobe RoboHelp [version]\RoboHTML\Language.
3 Ouvrez le nouveau fichier dans une fen&ecirc;tre distincte sous \Language.
4 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 &laquo; Modification des param&egrave;tres du projet &raquo; &agrave; la page 37
Derni&egrave;re mise &agrave; jour le 16/3/2011
64
UTILISATION DE ROBOHELP HTML 9
Projets
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.
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 S&eacute;lectionnez Fichier &gt; Nouveau &gt; Projet.
2 Cliquez sur l’onglet Importer. S&eacute;lectionnez Document PDF et cliquez sur OK.
3 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.
4 Saisissez les informations relatives au projet. Cliquez sur Suivant.
5 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.
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).
Derni&egrave;re mise &agrave; jour le 16/3/2011
65
UTILISATION DE ROBOHELP HTML 9
Projets
• 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.
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 Dans le gestionnaire de projets, cliquez avec le bouton droit de la souris sur Fichiers de projet.
2 S&eacute;lectionnez le fichier de destination de l’importation.
3 S&eacute;lectionnez Fichier &gt; Importer &gt; Document PDF.
4 S&eacute;lectionnez un ou plusieurs fichiers PDF. Cliquez sur Ouvrir.
5 Dans la bo&icirc;te de dialogue Options de conversion, s&eacute;lectionnez les options.
6 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.
7 Cliquez sur Terminer.
Importation et liaison de documents Word et
FrameMaker
Vous pouvez importer des documents Microsoft Word et Adobe FrameMaker dans vos projets RoboHelp. Si vous
utilisez Adobe Technical Communication Suite, vous pouvez lier des documents FrameMaker &agrave; vos projets RoboHelp.
Voir aussi
&laquo; Importation et liaison de documents Microsoft Word &raquo; &agrave; la page 65
&laquo; Importation de documents FrameMaker &raquo; &agrave; la page 81
Importation et liaison de documents Microsoft Word
Dans RoboHelp, vous pouvez lier et importer des documents Microsoft Word (des fichiers dot&eacute;s des extensions .docx,
.docm, .doc ou .rtf apr&egrave;s le nom du fichier). Vous pouvez cr&eacute;er des projets en liant ou en important des documents
Word, ou 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
66
UTILISATION DE ROBOHELP HTML 9
Projets
Les param&egrave;tres de liaison vers et d’importation de documents Word sont appliqu&eacute;s au niveau du projet. C’est la raison
pour laquelle vos param&egrave;tres sont coh&eacute;rents pour tous les documents que vous liez &agrave; ou que vous importez dans des
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. Pour plus de d&eacute;tails, reportez-vous &agrave; la section &laquo; Param&egrave;tres de conversion de Word &raquo; &agrave; la page 80.
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.
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.
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;.
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
Utilisez l’option de liaison lorsque
document source pour g&eacute;n&eacute;rer la vous partagez le document
rubrique supprim&eacute;e.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
67
UTILISATION DE ROBOHELP HTML 9
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 avec les styles RoboHelp afin de
pouvoir obtenir la pagination automatique 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 &agrave; des
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. Reportez-vous &agrave; la section &laquo; Pagination et
d&eacute;signation des rubriques dans les fichiers Word convertis &raquo; &agrave; la page 74.
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. Reportez-vous &agrave; la section &laquo; Conversion de styles Word en styles RoboHelp &raquo; &agrave; la page 71.
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 type contenant les informations d’en-t&ecirc;te et
de pied de page requises. l’utilisation de pages type permet &eacute;galement de supprimer les num&eacute;ros de page dans les ent&ecirc;tes et les pieds de page. &laquo; Conversion d'en-t&ecirc;tes et de pieds de page dans des documents Word &raquo; &agrave; la page 71.
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. Reportez-vous &agrave; la section
&laquo; Pagination et d&eacute;signation des rubriques dans les fichiers Word convertis &raquo; &agrave; la page 74.
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. Reportez-vous &agrave; la section &laquo; Importation d'une table des mati&egrave;res,
d'un index et d'un glossaire Word &raquo; &agrave; la page 69.
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 que telle.
Par exemple, si une t&acirc;che courte n’a pas de sens sans une introduction apportant certaines informations conceptuelles,
ne l’affichez pas comme une 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. Reportez-vous &agrave; la section &laquo; Conversion des marqueurs d’aide contextuelle
dans Word en ID de mappage &raquo; &agrave; la page 75.
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 (Fichier &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;
Derni&egrave;re mise &agrave; jour le 16/3/2011
68
UTILISATION DE ROBOHELP HTML 9
Projets
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.
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.
Reportez-vous &agrave; 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 Cr&eacute;ez un projet dans RoboHelp.
2 S&eacute;lectionnez Fichier &gt; Lier &gt; Document Word.
3 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
69
UTILISATION DE ROBOHELP HTML 9
Projets
4 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.
5 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. Reportez-vous &agrave; la section &laquo; Conversion de styles de paragraphe Word en styles RoboHelp &raquo;
&agrave; la page 72.
Remarque : RoboHelp associe les fichiers g&eacute;n&eacute;r&eacute;s de table des mati&egrave;res, d'index et de glossaire au 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.
6 Cliquez sur OK.
John Daigle fournit une introduction &eacute;tape par &eacute;tape sur la liaison avec des documents Microsoft Word sur la page des
didacticiels vid&eacute;o Adobe RoboHelp.
Importation d'un document Word dans un projet RoboHelp
1 Cr&eacute;ez un projet dans RoboHelp.
2 S&eacute;lectionnez Fichier &gt; Importer &gt; Document Word.
3 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.
4 Dans la bo&icirc;te de dialogue Param&egrave;tres de contenu, d&eacute;finissez les options de conversion de la table des mati&egrave;res, de
l'index et du glossaire, puis cliquez sur Suivant.
Pour plus d'informations sur les diff&eacute;rentes options de conversion, reportez-vous &agrave; la section &laquo; Importation d'une
table des mati&egrave;res, d'un index et d'un glossaire Word &raquo; &agrave; la page 69.
5 (Facultatif) pour modifier les param&egrave;tres de conversion, cliquez sur Modifier.
6 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, reportez-vous &agrave; la section &laquo; Conversion
d'en-t&ecirc;tes et de pieds de page dans des documents Word &raquo; &agrave; la page 71
Pour plus d'informations sur la conversion des paragraphes, des caract&egrave;res et d'autres styles, reportez-vous &agrave; la
section &laquo; Conversion de styles Word en styles RoboHelp &raquo; &agrave; la page 71.
7 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).
Derni&egrave;re mise &agrave; jour le 16/3/2011
70
UTILISATION DE ROBOHELP HTML 9
Projets
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.
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 S&eacute;lectionnez Fichier &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 la table des mati&egrave;res.
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
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 Fichier &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 Fichier &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 :
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
71
UTILISATION DE ROBOHELP HTML 9
Projets
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 type dans RoboHelp.
l’utilisation de pages type 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 Fichier &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 dans des documents Word, s&eacute;lectionnez Convertir l’en-t&ecirc;te.
• Pour convertir le pied de page dans des documents Word, s&eacute;lectionnez Convertir le bas 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 Fichier &gt; Importer &gt; Document Word.
• S&eacute;lectionnez Fichier &gt; Lier &gt; Document Word.
• S&eacute;lectionnez Fichier &gt; Param&egrave;tres du projet.
2 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.
• Cliquez sur Ajouter en regard 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
72
UTILISATION DE ROBOHELP HTML 9
Projets
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.
1 Proc&eacute;dez de l’une des fa&ccedil;ons suivantes :
• S&eacute;lectionnez Fichier &gt; Importer &gt; Document Word.
• S&eacute;lectionnez Fichier &gt; Lier &gt; Document Word.
• S&eacute;lectionnez Fichier &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 le style Word dans le groupe Paragraphe.
4 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].
5 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.
• 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 : suivez Style de d&eacute;finition du glossaire avec Style de terme du glossaire pour obtenir une paire compl&egrave;te
de d&eacute;finition et de terme du glossaire.
• S&eacute;lectionnez Pagination pour cr&eacute;er une rubrique d’aide &agrave; chaque occurrence du style de paragraphe Word
s&eacute;lectionn&eacute;.
• S&eacute;lectionnez ou saisissez une balise HTML d&eacute;finie par l’utilisateur pour le style de paragraphe s&eacute;lectionn&eacute;.
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.
1 Proc&eacute;dez de l’une des fa&ccedil;ons suivantes :
• S&eacute;lectionnez Fichier &gt; Importer &gt; Document Word.
• S&eacute;lectionnez Fichier &gt; Lier &gt; Document Word.
• S&eacute;lectionnez Fichier &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 le groupe Caract&egrave;re.
4 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.
5 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
73
UTILISATION DE ROBOHELP HTML 9
Projets
Mappage de liste
Vous pouvez mapper des listes Word avec des listes RoboHelp ou des listes HTML 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 Fichier &gt; Importer &gt; Document Word.
• S&eacute;lectionnez Fichier &gt; Lier &gt; Document Word.
• S&eacute;lectionnez Fichier &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 le groupe Autres param&egrave;tres.
4 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.
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 Fichier &gt; Importer &gt; Document Word.
• S&eacute;lectionnez Fichier &gt; Lier &gt; Document Word.
• S&eacute;lectionnez Fichier &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 un style de paragraphe Word, puis 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.
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.
1 Proc&eacute;dez de l’une des fa&ccedil;ons suivantes :
• S&eacute;lectionnez Fichier &gt; Importer &gt; Document Word.
• S&eacute;lectionnez Fichier &gt; Lier &gt; Document Word.
• S&eacute;lectionnez Fichier &gt; Param&egrave;tres du projet.
2 Dans l’onglet Importer, cliquez sur Modifier sous Document Word.
3 S&eacute;lectionnez le style de tableau Word dans le volet gauche de la bo&icirc;te de dialogue Param&egrave;tres de conversion.
Derni&egrave;re mise &agrave; jour le 16/3/2011
74
UTILISATION DE ROBOHELP HTML 9
Projets
4 S&eacute;lectionnez le style de tableau RoboHelp dans le menu contextuel. Vous pouvez &eacute;galement modifier le style de
tableau en cliquant sur Modifier le style.
Conversion de r&eacute;f&eacute;rences Word en liens hypertexte
RoboHelp peut convertir les r&eacute;f&eacute;rences telles que les notes de pied de page, les notes de fin, les l&eacute;gendes, les signets et
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 Fichier &gt; Importer &gt; Document Word.
• S&eacute;lectionnez Fichier &gt; Lier &gt; Document Word.
• S&eacute;lectionnez Fichier &gt; Param&egrave;tres du projet.
2 Dans l’onglet Importer, cliquez sur Modifier sous Document Word.
3 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 Fichier &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
Outre la d&eacute;finition des param&egrave;tres de pagination et 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. Reportez-vous &agrave; la section &laquo; Conversion d'en-t&ecirc;tes et de pieds de page dans
des documents Word &raquo; &agrave; la page 71.
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. Reportez-vous &agrave; la section &laquo; Importation d'une table des mati&egrave;res,
d'un index et d'un glossaire Word &raquo; &agrave; la page 69.
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. Reportez-vous &agrave; la section &laquo; Mappage de liste &raquo; &agrave; la page 73.
Conversion de r&eacute;f&eacute;rences en liens hypertexte Vous pouvez convertir les r&eacute;f&eacute;rences aux liens hypertexte dans les
rubriques RoboHelp. Reportez-vous &agrave; &laquo; Conversion de r&eacute;f&eacute;rences Word en liens hypertexte &raquo; &agrave; la page 74.
Cr&eacute;ation automatique de styles CSS &agrave; partir du formatage en ligne Reportez-vous &agrave; &laquo; Cr&eacute;ation de styles RoboHelp &agrave;
partir du formatage en ligne &raquo; &agrave; la page 74.
Derni&egrave;re mise &agrave; jour le 16/3/2011
75
UTILISATION DE ROBOHELP HTML 9
Projets
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 Ent&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 Ent&ecirc;te 2, des fichiers HTML distincts sont cr&eacute;&eacute;s pour chaque rubrique En-t&ecirc;te 2.
Remarque : la pagination est bas&eacute;e sur les styles de paragraphes Word et non sur les styles RoboHelp.
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 Ent&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 Fichier &gt; Importer &gt; Document Word.
• S&eacute;lectionnez Fichier &gt; Lier &gt; Document Word.
• S&eacute;lectionnez Fichier &gt; Param&egrave;tres du projet.
2 Cliquez sur Modifier sous Document Word.
3 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 et cliquez sur OK.
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. Reportez-vous &agrave; l’Aide de Microsoft
Word pour plus d’informations concernant l’insertion des marqueurs de note de bas de page personnalis&eacute;e.
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 Fichier &gt; Importer &gt; Document Word.
• S&eacute;lectionnez Fichier &gt; Lier &gt; Document Word.
• S&eacute;lectionnez Fichier &gt; Param&egrave;tres du projet.
2 Cliquez sur Modifier sous Document Word.
3 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
76
UTILISATION DE ROBOHELP HTML 9
Projets
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 Fichier &gt; Importer &gt; Document Word.
• S&eacute;lectionnez Fichier &gt; Lier &gt; Document Word.
• S&eacute;lectionnez Fichier &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.
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;.
Derni&egrave;re mise &agrave; jour le 16/3/2011
77
UTILISATION DE ROBOHELP HTML 9
Projets
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.
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. Recherchez
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
78
UTILISATION DE ROBOHELP HTML 9
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.
❖ 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;.
❖ 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.
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 Outils &gt; Options.
Derni&egrave;re mise &agrave; jour le 16/3/2011
79
UTILISATION DE ROBOHELP HTML 9
Projets
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.
3 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
80
UTILISATION DE ROBOHELP HTML 9
Projets
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.
❖ 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.
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 sont les suivants :
• 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 S&eacute;lectionnez Fichier &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 Exporter.
3 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 S&eacute;lectionnez Fichier &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 Parcourir.
Derni&egrave;re mise &agrave; jour le 16/3/2011
81
UTILISATION DE ROBOHELP HTML 9
Projets
3 S&eacute;lectionnez un fichier des param&egrave;tres d’importation RoboHelp (ISF). Cliquez sur Ouvrir.
Importation de documents FrameMaker
FrameMaker et RoboHelp offrent ensemble des fonctions pour la cr&eacute;ation et la publication de bout en bout. Cette
int&eacute;gration permet d'&eacute;changer du contenu et de publier divers formats de sortie comme des fichiers PDF, une aide en
ligne et une aide bas&eacute;e sur Adobe AIR.
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.
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 maquette 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.
Chapitres et rubriques 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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
82
UTILISATION DE ROBOHELP HTML 9
Projets
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. Reportez-vous &agrave; &laquo; Conversion des
marqueurs d'aide contextuelle de documents FrameMaker &raquo; &agrave; la page 93.
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.
Remarque : Si le d&eacute;calage d’une image dans le fichier FrameMaker est d&eacute;fini sur une valeur n&eacute;gative, l’image peut &ecirc;tre
partiellement masqu&eacute;e dans le code HTML. Modifiez la valeur avant de proc&eacute;der &agrave; l’importation.
4 Pour conserver la qualit&eacute; d'origine des images, ins&eacute;rez-les dans les 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.
5 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. Pour plus de d&eacute;tails, reportez-vous &agrave; l'aide de FrameMaker.
6 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. Reportez-vous &agrave; la section &laquo; Cr&eacute;ation de texte de substitution pour des images &raquo; &agrave; la page 99.
7 Appliquez des param&egrave;tres de texte conditionnel dans les documents FrameMaker. Pour plus de d&eacute;tails, reportez-
vous &agrave; l'aide de FrameMaker.
8 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. Reportez-vous &agrave; la section &laquo; Conversion d'une table des mati&egrave;res FrameMaker &raquo;
&agrave; la page 86.
Derni&egrave;re mise &agrave; jour le 16/3/2011
83
UTILISATION DE ROBOHELP HTML 9
Projets
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. Reportez-vous &agrave; la section Pr&eacute;paration des
documents FrameMaker pour la conversion en 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 &gt; 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.
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 Cr&eacute;ez un projet dans RoboHelp.
2 S&eacute;lectionnez Fichier &gt; Importer &gt; Document FrameMaker.
3 Dans le menu contextuel Fichiers de type, s&eacute;lectionnez Livre FrameMaker (BOOK).
4 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 S&eacute;lectionnez Fichier &gt; Importer &gt; Document FrameMaker.
2 S&eacute;lectionnez le type de document FrameMaker &agrave; importer.
3 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
84
UTILISATION DE ROBOHELP HTML 9
Projets
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. Pour plus de d&eacute;tails, reportez-vous &agrave; la section &laquo; Structure hi&eacute;rarchique d'un livre
FrameMaker 9 &raquo; &agrave; la page 90.
Table des mati&egrave;res
Conversion si elle est s&eacute;lectionn&eacute;e. Reportez-vous &agrave; la section &laquo; Conversion d'une table des mati&egrave;res
FrameMaker &raquo; &agrave; la page 86.
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.
Index et glossaire
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.
Reportez-vous aux sections &laquo; Importation des entr&eacute;es d'index FrameMaker &raquo; &agrave; la page 87 et &laquo; Importation
des d&eacute;finitions de glossaire &raquo; &agrave; la page 87.
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. Voir &laquo; Texte
conditionnel &raquo; &agrave; la page 241.
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. Reportezvous &agrave; la section &laquo; Conversion des formats de r&eacute;f&eacute;rences crois&eacute;es FrameMaker en styles RoboHelp &raquo; &agrave; la
page 90.
Marqueurs d'index et de
glossaire
Conversion en index et glossaire lors de la cr&eacute;ation d'un projet. Reportez-vous aux sections &laquo; Importation des
entr&eacute;es d'index FrameMaker &raquo; &agrave; la page 87 et &laquo; Importation des d&eacute;finitions de glossaire &raquo; &agrave; la page 87.
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. Pour plus de d&eacute;tails, reportez-vous &agrave; la section &laquo; Pagination de l'aide &raquo; &agrave; la page 91.
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. Pour plus de d&eacute;tails, reportez-vous &agrave; la section &laquo; Pagination de l'aide &raquo;
&agrave; la page 91.
Marqueurs personnalis&eacute;s
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
Derni&egrave;re mise &agrave; jour le 16/3/2011
85
UTILISATION DE ROBOHELP HTML 9
Projets
Formats de paragraphes
Conversion. Vous pouvez mapper les formats de paragraphes FrameMaker avec les styles RoboHelp ou
importer la mise en forme source. Reportez-vous &agrave; la section &laquo; Conversion des formats de paragraphes
FrameMaker en styles RoboHelp &raquo; &agrave; la page 93
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. Reportez-vous &agrave; la section &laquo; Conversion des formats de caract&egrave;res
FrameMaker en styles RoboHelp &raquo; &agrave; la page 94.
Formats de tableaux
Conversion. Vous pouvez mapper les formats de tableau FrameMaker &agrave; des styles RoboHelp ou importer le
formatage source. Reportez-vous &agrave; la section &laquo; Conversion des formats de tableaux FrameMaker en styles de
tableau RoboHelp &raquo; &agrave; la page 97.
Propri&eacute;t&eacute;s des notes de bas de Conversion. Le titre et le pied de page d'un tableau ayant un format de paragraphe dans FrameMaker, vous
page et notes de bas de page de devez sp&eacute;cifier des param&egrave;tres de conversion pour ces formats s&eacute;par&eacute;ment.
tableau
Listes
Elles sont converties en fonction des param&egrave;tres que vous d&eacute;finissez. Pour plus de d&eacute;tails, reportez-vous &agrave; la
section &laquo; Sc&eacute;narios de mise en correspondance de listes &raquo; &agrave; la page 95
Mises en page
Pages type
Les pages type de FrameMaker sont ignor&eacute;es. Les maquettes 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 de maquette pour le fil d'Ariane, les tables des mati&egrave;res miniatures, 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. Pour plus de d&eacute;tails, reportezvous &agrave; la section &laquo; Pagination de l'aide &raquo; &agrave; la page 91.
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. Pour plus de d&eacute;tails, reportez-vous &agrave; la section &laquo; Param&egrave;tres de
conversion d'image &raquo; &agrave; la page 97.
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. Pour plus de d&eacute;tails, reportez-vous &agrave; la section &laquo; Param&egrave;tres de conversion d'image &raquo; &agrave;
la page 97.
Cadres ancr&eacute;s
Conversion en images. Pour plus de d&eacute;tails, reportez-vous &agrave; la section &laquo; Param&egrave;tres de conversion d'image &raquo;
&agrave; la page 97.
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. Reportezvous &agrave; la section &laquo; Cr&eacute;ation de texte de substitution pour des images &raquo; &agrave; la page 99.
Derni&egrave;re mise &agrave; jour le 16/3/2011
86
UTILISATION DE ROBOHELP HTML 9
Projets
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. Pour plus de d&eacute;tails, reportez-vous &agrave; l'aide de FrameMaker.
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. Pour plus
de d&eacute;tails, reportez-vous &agrave; la section &laquo; R&eacute;f&eacute;rence au contenu &raquo; &agrave; la page 91.
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 Fichier &gt; Importer &gt; Document FrameMaker.
2 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
FrameMaker, puis parcourez la liste et s&eacute;lectionnez le fichier Table des mati&egrave;res 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 souslivres 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.
• 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
87
UTILISATION DE ROBOHELP HTML 9
Projets
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 peut cr&eacute;er plusieurs calques de
contenu en raison de la structure de dossier d'un tel livre.
• 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 Fichier &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 concernant le 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.
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 Fichier &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 Fichier &gt; Importer &gt; Document FrameMaker, puis s&eacute;lectionnez la carte DITA FrameMaker.
Derni&egrave;re mise &agrave; jour le 16/3/2011
88
UTILISATION DE ROBOHELP HTML 9
Projets
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
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. Prenons l'exemple d'une documentation contenant un Guide de prise en
main, un Guide d'installation, un Guide de l'utilisateur et un Guide de l'administrateur. Ces documents peuvent avoir
des mises en page et des formats diff&eacute;rents en version imprim&eacute;e, mais aucun de ces &eacute;l&eacute;ments n’est applicable pour la
sortie en ligne. Dans un tel cas, vous pouvez d&eacute;finir un mod&egrave;le contenant les d&eacute;finitions de format pour tous les
documents &agrave; convertir.
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 Fichier &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 un mod&egrave;le
FrameMaker avant l'importation.
3 Cliquez sur Parcourir, puis s&eacute;lectionnez le mod&egrave;le FrameMaker &agrave; utiliser pour le projet.
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 Fichier &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 9
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
89
UTILISATION DE ROBOHELP HTML 9
Projets
Lorsque vous effectuez la mise &agrave; niveau d’un projet RoboHelp 7 vers la version 9, vous pouvez conserver les param&egrave;tres
de la version 7 ou les mettre &agrave; niveau pour obtenir des param&egrave;tres au niveau du projet, pris en charge par RoboHelp 9.
Une fois un projet mis &agrave; niveau, vous ne pouvez plus l'ouvrir dans 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
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 Fichier &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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
90
UTILISATION DE ROBOHELP HTML 9
Projets
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.
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.
Remarque : La pagination se base sur les formats de paragraphe FrameMaker.
Structure hi&eacute;rarchique d'un livre FrameMaker 9
FrameMaker 9 permet d'appliquer une structure et un regroupement hi&eacute;rarchiques dans le livre. Vous pouvez
&eacute;galement inclure des livres enfants dans un livre et cr&eacute;er des dossiers et des groupes dans un livre.
Lorsque vous liez ou importez un livre FrameMaker 9, 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 de livre parent. Pour plus de d&eacute;tails, reportez-vous &agrave; l'aide de FrameMaker 9.
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
Par d&eacute;faut, les styles de r&eacute;f&eacute;rences crois&eacute;es du document source sont utilis&eacute;s sans correspondance dans les rubriques
g&eacute;n&eacute;r&eacute;es. Vous devez d&eacute;finir les correspondances de ces formats, car les documents FrameMaker peuvent contenir des
r&eacute;f&eacute;rences &agrave; des pages ou volumes qui ne sont pas utiles pour les formats d'aide.
1 S&eacute;lectionnez Fichier &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 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.
4 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.
5 Cliquez deux fois sur une composante pour l'ajouter &agrave; la d&eacute;finition de la r&eacute;f&eacute;rence crois&eacute;e.
Derni&egrave;re mise &agrave; jour le 16/3/2011
91
UTILISATION DE ROBOHELP HTML 9
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. Pour plus de d&eacute;tails, reportez-vous &agrave; l'aide de FrameMaker.
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 S&eacute;lectionnez Fichier &gt; Param&egrave;tres du projet.
2 Dans l'onglet Importer, cliquez sur Exporter.
3 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 S&eacute;lectionnez Fichier &gt; Param&egrave;tres du projet.
2 Dans l'onglet Importer, cliquez sur Parcourir.
3 S&eacute;lectionnez un fichier ISF et cliquez sur Ouvrir.
Pagination de l'aide
Lorsque vous liez ou importez un document FrameMaker, vous devez d&eacute;finir la mani&egrave;re dont le contenu de ce
document sera pr&eacute;sent&eacute; en rubriques dans RoboHelp. Si par exemple le fichier FrameMaker contient dix rubriques et
si chacune d'elles contient des sous-rubriques, des t&acirc;ches et des tableaux, vous pouvez choisir de faire appara&icirc;tre
chacune de ces rubriques sous la forme de fichiers HTML distincts. Si chaque en-t&ecirc;te de ces rubriques est au format
En-t&ecirc;te 1, vous pouvez d&eacute;finir chaque rubrique En-t&ecirc;te 1 &agrave; cr&eacute;er en tant que rubrique HTML distincte. 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 Ent&ecirc;te 2.
Bien qu'il soit possible de d&eacute;finir la pagination pour chaque format de paragraphe FrameMaker, veillez &agrave; appliquer les
recommandations suivantes.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
92
UTILISATION DE ROBOHELP HTML 9
Projets
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. Pour plus de d&eacute;tails, reportez-vous &agrave; la section &laquo; Optimisation pour la sortie en
ligne avant conversion &raquo; &agrave; la page 81.
Mod&egrave;le 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. RoboHelp cr&eacute;e alors les rubriques
introduction.htm et explication.htm. Vous obtenez ainsi des fichiers HTML dont le nom indique le titre de la rubrique.
Vous avez &eacute;galement la possibilit&eacute; de d&eacute;finir d'autres conventions. Si les noms de fichiers sont num&eacute;rot&eacute;s de mani&egrave;re
s&eacute;quentielle, par exemple aide001.html et aide002.html, vous pouvez d&eacute;finir un syst&egrave;me pour de telles conventions.
1 S&eacute;lectionnez Fichier &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
FrameMaker.
3 Dans l'onglet Autres param&egrave;tres, s&eacute;lectionnez l'une des options suivantes.
Mod&egrave;le de nom de rubrique Les rubriques sont nomm&eacute;es en fonction du mod&egrave;le s&eacute;lectionn&eacute;. Vous pouvez
s&eacute;lectionner l'une des options suivantes ou cr&eacute;er un syst&egrave;me personnalis&eacute; &agrave; l'aide des composantes de nom des
rubriques propos&eacute;es par RoboHelp. Vous pouvez &eacute;galement ajouter du texte statique standard, par exemple
Rubrique d'aide, suivi par un num&eacute;ro s&eacute;quentiel.
Composante
Syst&egrave;me de nom de la rubrique convertie
default
Le nom de fichier de la rubrique HTML se compose du texte du paragraphe.
&lt;$filename_no_ext&gt;-&lt;$paratext&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 nom de la rubrique, s&eacute;par&eacute;s par un trait
d'union. Par exemple, le document FrameMaker Chapitre.fm avec le texte de paragraphe
1-Introduction sera converti en rubrique HTML et prendra le nom Chapitre-1Introduction.htm.
&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 Chapitre.fm sera converti en
rubrique HTML et prendra le nom Chapitre-1.htm.
&lt;$texte_para_sans_num&eacute;ro&gt;
Le nom de fichier de la rubrique HTML g&eacute;n&eacute;r&eacute;e se compose du texte du paragraphe du
format sur lequel la pagination est d&eacute;finie, sans le num&eacute;ro de paragraphe. Par exemple,
le paragraphe de l'intitul&eacute; 1 &laquo; 1. Introduction &raquo; est converti en rubrique HTML qui prend le
nom &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, le paragraphe Introduction de l'intitul&eacute;
1 sera converti en rubrique HTML qui prendra le nom Introduction.htm.
Marqueur de nom de rubrique Les rubriques sont nomm&eacute;es en fonction du marqueur appliqu&eacute; au document
FrameMaker. Il est recommand&eacute; de d&eacute;finir le nom de rubrique comme marqueur, pour que les noms de rubrique
d&eacute;signent leur contenu. Si vous s&eacute;lectionnez cette option, les param&egrave;tres de pagination appliqu&eacute;s dans le volet Styles
de paragraphe sont ignor&eacute;s. Utilisez cette option pour contr&ocirc;ler de mani&egrave;re pr&eacute;cise la cr&eacute;ation de rubriques d'aide
distinctes &agrave; partir des documents FrameMaker.
Prenons l'exemple du marqueur de nom de rubrique Aideenligne d&eacute;fini dans FrameMaker. Vous pouvez appliquer
ce marqueur &agrave; tous les paragraphes commen&ccedil;ant une nouvelle rubrique d'aide. Pour b&eacute;n&eacute;ficier d'une flexibilit&eacute;
maximale dans la d&eacute;finition de titres de rubriques et de noms de fichier de rubrique, vous pouvez saisir ces noms
en les s&eacute;parant par le symbole |.
Derni&egrave;re mise &agrave; jour le 16/3/2011
93
UTILISATION DE ROBOHELP HTML 9
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 S&eacute;lectionnez Fichier &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, 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 Fichier &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.
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 Fichier &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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
94
UTILISATION DE ROBOHELP HTML 9
Projets
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. Pour plus de d&eacute;tails, reportez-vous &agrave; la
section &laquo; Styles et feuilles de style &raquo; &agrave; la page 169.
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 S&eacute;lectionnez cette option pour cr&eacute;er une rubrique d'aide &agrave; chaque occurrence pour le format de
paragraphe s&eacute;lectionn&eacute;.
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.
Voir aussi
&laquo; Balises HTML personnalis&eacute;es &raquo; &agrave; la page 95
&laquo; Mise en correspondance des styles de num&eacute;rotation automatique &raquo; &agrave; la page 95
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 Fichier &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 caract&egrave;re FrameMaker dans le volet gauche de la bo&icirc;te de dialogue Param&egrave;tres de
conversion.
4 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 Fichier &gt; Param&egrave;tres du projet.
Derni&egrave;re mise &agrave; jour le 16/3/2011
95
UTILISATION DE ROBOHELP HTML 9
Projets
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 Fichier &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.
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 le champ de 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
96
UTILISATION DE ROBOHELP HTML 9
Projets
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;.
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 le champ de 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;.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
97
UTILISATION DE ROBOHELP HTML 9
Projets
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.
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. Pour plus de d&eacute;tails, reportez-vous &agrave; la
section &laquo; Sc&eacute;narios de mise en correspondance de listes &raquo; &agrave; la page 95.
1 S&eacute;lectionnez Fichier &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.
4 S&eacute;lectionnez le style de tableau RoboHelp dans le menu contextuel et cliquez sur OK. Vous pouvez &eacute;galement
modifier le style de tableau en cliquant sur Modifier le style.
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 des formats PDF pour g&eacute;n&eacute;rer des images 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
98
UTILISATION DE ROBOHELP HTML 9
Projets
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.
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.
• 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 pour les captures d'&eacute;cran et les autres images. Les fichiers BMP sont de bonne
qualit&eacute; pour une taille de fichier augment&eacute;e.
• 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
99
UTILISATION DE ROBOHELP HTML 9
Projets
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.
❖ 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.
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. Reportez-vous &agrave; l'aide de FrameMaker pour en savoir plus sur le
texte de substitution pour les graphiques et les images.
Importation d’un fichier de mappage DITA
Vous pouvez importer des fichiers de mappage DITA ou des rubriques 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 :
• Cliquez sur Fichier &gt; Importer &gt; Mappage 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
100
UTILISATION DE ROBOHELP HTML 9
Projets
2 S&eacute;lectionnez un fichier de mappage DITA. Cliquez sur Ouvrir.
3 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.
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 (hdr) 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 le kit DITA Open
Toolkit traite toutes les informations.
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 Cliquez sur Fichier &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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
101
UTILISATION DE ROBOHELP HTML 9
Projets
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.
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 :
Derni&egrave;re mise &agrave; jour le 16/3/2011
102
UTILISATION DE ROBOHELP HTML 9
Projets
DocBook Ce type de gestionnaire inclut : Importer DocBook en tant que rubriques, Exporter le projet vers DocBook,
Exporter des rubriques vers DocBook.
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).
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.
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.
2 Dans le menu Fichiers de type, s&eacute;lectionnez Projet HTML Help (*HHP).
3 Acc&eacute;dez au fichier HHP et ouvrez-le.
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.
Voir aussi
&laquo; Cr&eacute;ation d’un projet &raquo; &agrave; la page 31
&laquo; Editeurs HTML tiers &raquo; &agrave; la page 146
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
103
UTILISATION DE ROBOHELP HTML 9
Projets
Vous ne pouvez pas sortir 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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
104
UTILISATION DE ROBOHELP HTML 9
Projets
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.
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 minuscules. 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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
105
UTILISATION DE ROBOHELP HTML 9
Projets
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.
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).
• Convertit la navigation WinHelp en navigation HTML. Les sauts WinHelp sont convertis en hyperliens HTML. Les
menus contextuels de WinHelp se convertissent en menus dynamiques. Les s&eacute;quences de navigation sont
&eacute;galement converties. Les sauts de rubriques interm&eacute;diaires sont maintenus.
Derni&egrave;re mise &agrave; jour le 16/3/2011
106
UTILISATION DE ROBOHELP HTML 9
Projets
• 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.
• 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
107
UTILISATION DE ROBOHELP HTML 9
Projets
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, reportez-vous &agrave; la section
&laquo; Utilisation des couleurs et des images &raquo; &agrave; la page 178.
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 Dans le conteneur D&eacute;marrage, cliquez sur Plus sous Importer.
2 S&eacute;lectionnez WinHelp (*.hlp) et cliquez sur OK.
3 Dans l’assistant Help-to-HTML, d&eacute;finissez les options du projet HTML.
4 Cliquez sur Naviguer, acc&eacute;dez au fichier HLP et ouvrez-le.
5 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.
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
Ne saisissez aucune information dans Nom de la page de d&eacute;but.
6 Cliquez sur Suivant. D&eacute;finissez les options de style.
Derni&egrave;re mise &agrave; jour le 16/3/2011
108
UTILISATION DE ROBOHELP HTML 9
Projets
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.
7 Cliquez sur Suivant. D&eacute;finissez les options pour HTML Help.
R&eacute;sultat souhait&eacute;
Action
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.
8 Cliquez sur Terminer.
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
109
UTILISATION DE ROBOHELP HTML 9
Projets
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.
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 ? l’aide contextuelle n’est pas convertie. Les rubriques d’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’estce 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
Qu'est-ce que c'est ? Module de composition d'aide 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.
Conseils pour la cr&eacute;ation de projets HTML avec des fichiers HLP
• Les fichiers d’aide pour Windows 3.x et 95 et versions sup&eacute;rieures sont pris en charge.
• 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 S&eacute;lectionnez Fichier &gt; Nouveau &gt; Projet.
2 Cliquez sur l’onglet Importer.
Derni&egrave;re mise &agrave; jour le 16/3/2011
110
UTILISATION DE ROBOHELP HTML 9
Projets
3 S&eacute;lectionnez WinHelp Project. Cliquez sur OK.
4 Cliquez sur le bouton Parcourir et s&eacute;lectionnez le fichier HPJ &agrave; importer. Cliquez sur Suivant.
5 Sp&eacute;cifiez le dossier de sortie et le nom de fichier.
6 Sous Choisir les documents source, s&eacute;lectionnez les documents Word &agrave; importer.
7 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.
• 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
111
UTILISATION DE ROBOHELP HTML 9
Projets
Rapports
Exportation de rapports de projet
1 Cliquez sur Outils &gt; Rapports. S&eacute;lectionnez le type de rapport.
2 Personnalisez le rapport.
3 Cliquez sur Enregistrer sous.
4 Acc&eacute;dez &agrave; l’emplacement dans lequel enregistrer le fichier.
5 Saisissez le nom du fichier.
6 Dans la liste Type, s&eacute;lectionnez RTF ou TXT.
7 Cliquez sur Enregistrer.
Impression des rapports
1 S&eacute;lectionnez Outils &gt; Rapports.
2 S&eacute;lectionnez le type de rapport.
3 Personnalisez les options du rapport.
4 Cliquez sur Imprimer.
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 &gt; Rapports.
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.
4 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.
5 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 se trouvent dans Outils &gt; Rapports.
Rapport sur les liens rompus
Ce rapport (disponible dans Outils &gt; Rapports &gt; Liens rompus) trouve les fichiers contenant des liens rompus. Il est
impossible de personnaliser ce rapport.
Derni&egrave;re mise &agrave; jour le 16/3/2011
112
UTILISATION DE ROBOHELP HTML 9
Projets
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; Rapports. S&eacute;lectionnez Balises de construction conditionnelles. 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 S&eacute;lectionnez Outils &gt; Rapports &gt; Voir aussi. Le rapport Voir aussi s’affiche.
2 Personnalisez ces options le cas &eacute;ch&eacute;ant :
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 S&eacute;lectionnez Outils &gt; Rapports &gt; Index.
2 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
113
UTILISATION DE ROBOHELP HTML 9
Projets
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.
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.
❖ S&eacute;lectionnez Outils &gt; Rapports &gt; ID de mappage en double.
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; Rapports &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 S&eacute;lectionnez Outils &gt; Rapports &gt; Glossaire.
2 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
❖ S&eacute;lectionnez Outils &gt; Rapports &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.
Rapport sur les ID de mappage
Utilisez ce rapport (Outils &gt; Rapports &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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
114
UTILISATION DE ROBOHELP HTML 9
Projets
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.
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; Rapports &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; Rapports &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; Rapports &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; Rapports &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.
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.
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; Rapports &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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
115
UTILISATION DE ROBOHELP HTML 9
Projets
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; Rapports &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.
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; Rapports &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; Rapports &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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
116
UTILISATION DE ROBOHELP HTML 9
Projets
Rapport sur les fichiers inutilis&eacute;s
Utilisez ce rapport (Outils &gt; Rapports &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.
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; Rapports &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; Rapports &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; Rapports &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; Rapports &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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
117
UTILISATION DE ROBOHELP HTML 9
Projets
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).
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).
Derni&egrave;re mise &agrave; jour le 16/3/2011
118
UTILISATION DE ROBOHELP HTML 9
Projets
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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
119
Chapitre 4 : Utilisation des rubriques
Cr&eacute;ation, enregistrement et ouverture des rubriques
Cr&eacute;er une rubrique
1 Dans le conteneur Gestionnaire de projets, ouvrez le dossier Fichiers XHTML.
2 Pour stocker la rubrique dans un dossier sp&eacute;cifique, s&eacute;lectionnez le dossier requis.
3 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 cliquez avec le bouton droit de la souris sur la Liste des rubriques et
s&eacute;lectionnez Nouvelle rubrique avec &gt; [&eacute;diteur].
4 Indiquez un titre de rubrique et un nom de fichier.
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. Evitez 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.)
5 (Facultatif) S&eacute;lectionnez une page type.
6 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, reportezvous &agrave; la section &laquo; Cr&eacute;ation de contenu multilingue &raquo; &agrave; la page 56
7 Ajoutez des mots-cl&eacute;s pour permettre la recherche dans 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, reportez-vous &agrave; la
section &laquo; Mots-cl&eacute;s de rubrique &raquo; &agrave; la page 186.
8 S&eacute;lectionnez l’option Exclure de la recherche uniquement si vous ne souhaitez pas afficher cette rubrique dans les
r&eacute;sultats de recherche.
Remarque : Exclure de la recherche n'est pas disponible pour la recherche dans Microsoft HTML Help (CHM).
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).
Voir aussi
&laquo; Ajout de tirets de soulignement aux noms de fichier &raquo; &agrave; la page 130
Derni&egrave;re mise &agrave; jour le 16/3/2011
120
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
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 Outils &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 Afficher &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. Evitez 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.
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.
❖ 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
121
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
Voir aussi
&laquo; Editeur de conception RoboHelp &raquo; &agrave; la page 145
&laquo; Editeurs HTML tiers &raquo; &agrave; la page 146
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.
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.
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 type 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
Derni&egrave;re mise &agrave; jour le 16/3/2011
122
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
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 S&eacute;lectionnez Outils &gt; Options &gt; G&eacute;n&eacute;ralit&eacute;s.
2 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).
Voir aussi
&laquo; Editeurs RoboHelp &raquo; &agrave; la page 145
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. Vous pouvez s&eacute;lectionner Fichier &gt; Conformit&eacute; &agrave; W3C &gt; Valider et RoboHelp valide 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.
Voir aussi
&laquo; Conformit&eacute; W3C &raquo; &agrave; la page 143
Importation et copie de rubriques
Importation de rubriques
1 S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Gestionnaire de projets. Le gestionnaire de projets s’affiche.
2 Ouvrez le dossier Fichiers HTML (Rubriques).
3 Pour enregistrer le fichier dans un sous-dossier, s&eacute;lectionnez le dossier.
4 Choisissez la commande Fichier &gt; Importer &gt; Fichier HTML/XHTML.
5 Acc&eacute;dez au fichier HTML/XHTML.
6 S&eacute;lectionnez le fichier. Appuyez sur la touche Ctrl pour s&eacute;lectionner plusieurs fichiers.
7 Cliquez sur Ouvrir.
Derni&egrave;re mise &agrave; jour le 16/3/2011
123
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
8 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 Afficher &gt; Conteneurs &gt; Gestionnaire de projets. Le gestionnaire de projets s’affiche.
• S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Liste des rubriques. Le conteneur Liste des rubriques s’affiche.
2 S&eacute;lectionnez une rubrique.
3 Cliquez avec le bouton droit de la souris et s&eacute;lectionnez Dupliquer la rubrique.
4 Dans la zone Titre de la rubrique, saisissez le titre.
5 Si la rubrique est associ&eacute;e &agrave; une page type, elle appara&icirc;t dans le menu contextuel Page type. Si Aucun est indiqu&eacute;, la
rubrique utilise la feuille de style par d&eacute;faut.
6 Cliquez sur l’ic&ocirc;ne Afficher
pour afficher la page type. Vous pouvez aussi rechercher une nouvelle page type.
7 Cliquez sur l’onglet Pr&eacute;sentation pour modifier la feuille de style.
8 Cliquez sur OK.
La nouvelle rubrique est attach&eacute;e au projet. Elle s’affiche dans le volet Gestionnaire de projets.
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 (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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
124
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
3 Cliquez sur Afficher avec et s&eacute;lectionnez le navigateur dans la liste des navigateurs install&eacute;s sur votre ordinateur.
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.
• (Navigateur) Si la rubrique dont vous affichez un aper&ccedil;u comprend un lien vers une autre rubrique, il suffit de
cliquer sur ce lien pour ouvrir la rubrique, mais les extraits de code, les variables d&eacute;finies par l’utilisateur, les espaces
r&eacute;serv&eacute;s et les Iframes ne sont pas corrig&eacute;s et les balises de construction conditionnelle ne sont pas appliqu&eacute;es.
D&eacute;finition d’une expression de construction conditionnelle
1 Dans la fen&ecirc;tre d’aper&ccedil;u, cliquez sur D&eacute;finir.
2 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 Cliquez sur OK pour revenir &agrave; la fen&ecirc;tre d’aper&ccedil;u.
5 Pour supprimer la condition de l’aper&ccedil;u, s&eacute;lectionnez Aucun dans le menu.
Affichage des &eacute;l&eacute;ments de conception
❖ S&eacute;lectionnez &gt; Afficher &gt; [&eacute;l&eacute;ment de conception].
Derni&egrave;re mise &agrave; jour le 16/3/2011
125
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
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
Pages type
Remarque : les pages type 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 type, vous pouvez s&eacute;parer la mise en
page et le style du contenu. Une page type comporte les informations de mise en page et est associ&eacute;e &agrave; un fichier CSS.
Une page type 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 mini-table des mati&egrave;res. Les pages type
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 type ou associer une rubrique existante &agrave; une page type. Lorsque vous cr&eacute;ez une rubrique &agrave; l’aide
d’une page type, le contenu du corps est plac&eacute; dans la rubrique en r&eacute;sultant. Si vous appliquez une page type &agrave; une
rubrique existante, le contenu du corps est ignor&eacute;.
Les informations de mise en page d&eacute;finies dans les pages type ne sont pas visibles dans l’onglet Conception. Toutefois,
vous pouvez y afficher la feuille CSS de la page type. 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 type.
Tous les espaces r&eacute;serv&eacute;s d&eacute;finis dans la page type 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 type, cette rubrique comprend le
contenu de la page type. Les informations de copyright en sont un bon exemple. Lorsque vous appliquez une page type
&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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
126
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
Remarque : Lorsque vous appliquez une page type &agrave; une rubrique, l’en-t&ecirc;te et le pied de page de la rubrique sont
remplac&eacute;s par ceux des pages type.
Espace r&eacute;serv&eacute; de la mini table des mati&egrave;res Il affiche la mini-table des mati&egrave;res 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 mini
table des mati&egrave;res en d&eacute;terminant la mise en page de la page type. 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 mini table des mati&egrave;res 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 type
1 Proc&eacute;dez de l’une des fa&ccedil;ons suivantes :
• S&eacute;lectionnez Fichier &gt; Nouveau &gt; Page type.
• Dans le conteneur Configuration du projet, s&eacute;lectionnez l’option Page type et cliquez dessus avec le bouton droit
de la souris.
2 S&eacute;lectionnez Nouvelle page type.
3 Indiquez un nom pour cette page dans l’onglet G&eacute;n&eacute;ralit&eacute;s.
Remarque : l’extension de fichier des pages type est .htt.
4 Cliquez sur l’onglet Pr&eacute;sentation.
5 S&eacute;lectionnez une feuille de style &agrave; appliquer &agrave; la page type.
6 (Facultatif) S&eacute;lectionnez les options relatives au son en arri&egrave;re-plan.
7 Cliquez sur OK.
Une nouvelle page type affiche par d&eacute;faut l’espace r&eacute;serv&eacute; du corps. Vous pouvez ins&eacute;rer des mini-tables des mati&egrave;res
en cliquant sur l'ic&ocirc;ne Mini-table des mati&egrave;res
, ainsi que des espaces r&eacute;serv&eacute;s aux chemins de navigation en
cliquant sur l'ic&ocirc;ne Chemins de navigation
dans 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
minitables des mati&egrave;res ou de chemins de navigation que vous le souhaitez dans la page type, &agrave; l’emplacement de votre
choix.
Cr&eacute;ation d’une page type &agrave; partir d’une rubrique
1 Ouvrez une rubrique.
2 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 type.
• S&eacute;lectionnez Fichier &gt; Ajouter aux pages type.
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 type, 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
127
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
Lorsque les rubriques sont associ&eacute;es &agrave; une page type, 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 type associ&eacute;e &agrave; une rubrique.
Voir aussi
&laquo; En-t&ecirc;tes de page, pieds de page et sauts de page &raquo; &agrave; la page 161
Mise en forme des pages type
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 type
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 type 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 type
1 Proc&eacute;dez de l’une des fa&ccedil;ons suivantes :
• Cliquez avec le bouton droit de la souris sur une page type du conteneur Configuration de projet, puis choisissez
l’option Modifier.
• S&eacute;lectionnez une page type dans le conteneur Configuration de projet et choisissez la commande Modifier &gt;
Modifier [nom de la page type].htt.
• Cliquez deux fois sur une page type du conteneur Configuration de projet.
2 Effectuez les modifications de votre choix.
Modifiez le fichier CSS associ&eacute; &agrave; la page type
1 Cliquez avec le bouton droit de la souris et s&eacute;lectionnez l’option Propri&eacute;t&eacute;s.
2 Cliquez sur l’onglet Pr&eacute;sentation.
3 S&eacute;lectionnez une feuille de style dans la liste des feuilles de style disponibles dans un projet.
4 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 type pour afficher un rapport sur
les rubriques associ&eacute;es &agrave; la page type.
Insertion d’un espace r&eacute;serv&eacute;
Vous pouvez ins&eacute;rer des espaces r&eacute;serv&eacute;s pour les mini-tables des mati&egrave;res, les chemins de navigation et les rubriques
des pages type. Par d&eacute;faut, l’espace r&eacute;serv&eacute; du corps est ins&eacute;r&eacute; dans une nouvelle page type.
1 Placez le curseur en dessous de ou apr&egrave;s l’espace r&eacute;serv&eacute; du corps.
2 Choisissez la commande Ins&eacute;rer &gt; Espace r&eacute;serv&eacute; &gt; Minitables des mati&egrave;res 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.
Voir aussi
&laquo; En-t&ecirc;tes de page, pieds de page et sauts de page &raquo; &agrave; la page 161
Derni&egrave;re mise &agrave; jour le 16/3/2011
128
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
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 type 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;
dans la barre d’outils de
l’&eacute;diteur de conception.
• Cliquez deux fois sur l’espace r&eacute;serv&eacute;.
• S&eacute;lectionnez Format &gt; Espace r&eacute;serv&eacute;.
Remarques :
• Si un espace r&eacute;serv&eacute; de corps est supprim&eacute; de la page type 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 type, 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 type, 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 mini-table des mati&egrave;res et de chemin de navigation sont ins&eacute;r&eacute;s dans la page
type associ&eacute;e, les minitables des mati&egrave;res et 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.
Voir aussi
&laquo; Ajout de chemins de navigation aux rubriques &raquo; &agrave; la page 209
Importation de pages type
Vous pouvez importer des pages type &agrave; partir d’autres projets et les appliquer aux rubriques dans votre projet actuel.
Lorsque vous mettez &agrave; niveau RoboHelp ou une version ant&eacute;rieure, les mod&egrave;les des rubriques se transforment en pages
type 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 type
Vous pouvez appliquer ou modifier la page type &agrave; une ou plusieurs rubriques simultan&eacute;ment. Utilisez cette option
pour modifier la page type d’une ou plusieurs rubriques de votre projet, mais pas toutes. Vous pouvez appliquer la page
type &agrave; toutes les rubriques lorsque vous g&eacute;n&eacute;rez le r&eacute;sultat d’aide.
Application d’une page type &agrave; une rubrique
1 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.
2 Dans la bo&icirc;te de dialogue Propri&eacute;t&eacute;s de rubrique, cliquez sur l’onglet G&eacute;n&eacute;ral.
3 Toutes les pages type d’un projet sont r&eacute;pertori&eacute;es dans le menu Page type. S&eacute;lectionnez une page type, puis cliquez
sur OK. (Facultatif) Vous pouvez &eacute;galement proc&eacute;der comme suit :
• Pour afficher l’aper&ccedil;u d’une page type s&eacute;lectionn&eacute;e, cliquez sur l’ic&ocirc;ne Aper&ccedil;u.
• Pour s&eacute;lectionner une page type qui ne fait pas partie du projet en cours, cliquez sur le bouton Parcourir.
Derni&egrave;re mise &agrave; jour le 16/3/2011
129
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
Application d’une page type &agrave; plusieurs rubriques
1 Dans la liste de rubriques, classez les rubriques selon la page type qui leur est associ&eacute;e.
Remarque : Si la colonne Page type 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 type dans le menu.
2 S&eacute;lectionnez les rubriques associ&eacute;es &agrave; la page type que vous souhaitez remplacer. Si vous appliquez des pages type
pour la premi&egrave;re fois, s&eacute;lectionnez les rubriques qui ne sont pas associ&eacute;es &agrave; une page type. Vous pouvez aussi
s&eacute;lectionner plusieurs ensembles de rubriques auxquelles diff&eacute;rentes pages type sont appliqu&eacute;es.
3 Cliquez avec le bouton droit de la souris et s&eacute;lectionnez l’option Propri&eacute;t&eacute;s.
4 Dans la bo&icirc;te de dialogue Propri&eacute;t&eacute;s de rubrique, cliquez sur l’onglet G&eacute;n&eacute;ral.
5 S&eacute;lectionnez la page type dans le menu Page type, puis cliquez sur le bouton OK.
Application d’une page type ou d’une feuille CSS lors de la g&eacute;n&eacute;ration
Les mises en page source uniques vous permettent de remplacer la page type 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 type 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 type ou des feuilles CSS. Vous pouvez opter pour l’application d’une page type 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.
Pour l’appliquer &agrave; toutes les rubriques, s&eacute;lectionnez l’option Appliquer &agrave; toutes les rubriques et choisissez une page
type ou une feuille CSS. Les menus CSS et Pages type affichent l’ensemble des pages type et des feuilles CSS disponibles
dans le projet.
• Si vous ne choisissez pas l’option Appliquer &agrave; toutes les rubriques, les pages type associ&eacute;es aux rubriques seront
appliqu&eacute;es. Si aucune page type n’est associ&eacute;e aux rubriques individuelles, RoboHelp n’applique aucune page type
lors de la g&eacute;n&eacute;ration du r&eacute;sultat.
• Si vous choisissez d’utiliser une page type, celles qui se rapportent aux rubriques sont ignor&eacute;es. La feuille CSS li&eacute;e &agrave;
la page type 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 type associ&eacute;es aux rubriques prennent effet. La feuille CSS
s&eacute;lectionn&eacute;e porte sur l’ensemble des rubriques, qu’une page type leur soit li&eacute;e ou non.
• Si une page type n’est pas associ&eacute;e &agrave; une feuille CSS, la feuille CSS associ&eacute;e &agrave; chaque rubrique individuelle devient
effective.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
130
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
Si vous cr&eacute;ez des rubriques &agrave; l’aide d’une page type, 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 Afficher &gt; Conteneurs &gt; Gestionnaire de projets.
• S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Liste des rubriques.
2 S&eacute;lectionnez une rubrique.
3 Sur la barre d’outils, cliquez sur l’ic&ocirc;ne Propri&eacute;t&eacute;s
. Cliquez sur l’onglet G&eacute;n&eacute;ralit&eacute;s.
4 Dans la zone Titre de la rubrique, saisissez le titre.
5 Cliquez sur OK. Le titre de la rubrique est mis &agrave; jour.
6 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.
Voir aussi
&laquo; Modification du nom des fichiers de rubrique &raquo; &agrave; la page 120
&laquo; Gestion des fichiers &raquo; &agrave; la page 49
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.
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 Outils &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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
131
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
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 Cliquez sur un onglet et effectuez les modifications de votre choix.
3 Cliquez sur OK.
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.
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 type
Pour modifier la page type &agrave; appliquer &agrave; une rubrique, s&eacute;lectionnez une page type dans le menu Pages type. Par d&eacute;faut,
la derni&egrave;re page type est appliqu&eacute;e &agrave; la rubrique. Vous pouvez afficher la page type en cliquant sur le bouton
Afficher
ou rechercher une autre page type en cliquant sur le bouton Parcourir.
Voir aussi
&laquo; Mise &agrave; jour de la liste des actions &agrave; faire d'une rubrique &raquo; &agrave; la page 50
&laquo; Association d’une feuille de style aux rubriques ou aux pages type &raquo; &agrave; la page 169
&laquo; Application de balises de construction conditionnelles &agrave; plusieurs rubriques &raquo; &agrave; la page 244
&laquo; Identification des s&eacute;quences de navigation auxquelles une rubrique est assign&eacute;e &raquo; &agrave; la page 227
Derni&egrave;re mise &agrave; jour le 16/3/2011
132
UTILISATION DE ROBOHELP HTML 9
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 S&eacute;lectionnez Modifier &gt; Rechercher une rubrique.
3 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.
4 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.
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.
5 Cliquez sur OK.
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 uniques, 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
133
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
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.
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.
Voir aussi
&laquo; G&eacute;n&eacute;ration et personnalisation de rapports &raquo; &agrave; la page 111
Affichez et g&eacute;rez les informations sur les rubriques dans le conteneur Listes
des rubriques
❖ 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 la commande Afficher &gt; Vue D&eacute;tails.
• 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.
Voir aussi
&laquo; Rapports &raquo; &agrave; la page 111
Derni&egrave;re mise &agrave; jour le 16/3/2011
134
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
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; Liste des 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.
Gestion des ressources
A propos du Gestionnaire de ressources
Le Gestionnaire de ressources vous aide &agrave; maintenir les ressources telles que les images, les fichiers multim&eacute;dia, les
feuilles de style, les extraits de code et les fichiers bagage dans un emplacement partag&eacute; sur votre ordinateur ou le
r&eacute;seau. Plusieurs auteurs peuvent les utiliser dans l’ensemble des projets et les g&eacute;rer &agrave; partir du conteneur Gestionnaire
de ressources dans RoboHelp.
RoboHelp fournit des m&eacute;thodes simples pour ajouter des ressources dans l’emplacement partag&eacute; et le projet. Faites
glisser des fichiers et des dossiers entre le Gestionnaire de ressources et l’Explorateur Windows. Faites glisser des
images, des feuilles de style et des rubriques du Gestionnaire de projets au Gestionnaire de ressources. Faites glisser
des pages type entre le conteneur Configuration du projet et le Gestionnaire de ressources. Faites glisser des extraits
de code &agrave; partir du Gestionnaire de ressources vers des rubriques (RoboHelp met &agrave; jour le conteneur Extraits de code).
Lorsque vous faites glisser une ressource depuis un projet (par exemple, un extrait de code depuis le conteneur Extraits
de code) vers un emplacement partag&eacute; dans le Gestionnaire de ressources, vous exportez la ressource et la rendez
accessible &agrave; d’autres auteurs. A l’inverse, lorsque vous faites glisser une ressource depuis le Gestionnaire de ressources
vers un projet, vous importez la ressource (avec ses fichiers associ&eacute;s) dans le projet.
Configuration des param&egrave;tres du Gestionnaire de ressources
1
Proc&eacute;dez de l’une des fa&ccedil;ons suivantes :
• S&eacute;lectionnez Outils &gt; Options. Cliquez sur le Gestionnaire de ressources.
• S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Gestionnaire de ressources. Cliquez sur le bouton Param&egrave;tres du
Gestionnaire de ressources.
2 Dans la bo&icirc;te de dialogue Options, sp&eacute;cifiez des param&egrave;tres au niveau de l'application et au niveau du projet pour
le Gestionnaire de ressources.
Derni&egrave;re mise &agrave; jour le 16/3/2011
135
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
Sp&eacute;cification de param&egrave;tres du Gestionnaire de ressources au niveau de l'application
1 Dans la bo&icirc;te de dialogue Options, indiquez la fa&ccedil;on dont vous souhaitez utiliser les ressources partag&eacute;es dans le
cadre de projets. S&eacute;lectionnez l'une des options suivantes :
En tant que copie Ins&egrave;re une copie d'une ressource partag&eacute;e dans le projet. Le Gestionnaire de ressources ne vous
avertit pas, ni ne met &agrave; jour le projet, si la ressource d'origine est mise &agrave; jour &agrave; l'emplacement partag&eacute;.
En tant que li&eacute;es Ins&egrave;re une copie d'une ressource partag&eacute;e dans le projet et conserve un lien entre la copie (dans
le projet) et l'original (&agrave; l'emplacement partag&eacute;). La conservation d'un lien aide le Gestionnaire de ressources &agrave;
assurer un suivi des mises &agrave; jour de la ressource et vous permet de mettre &agrave; jour la ressource dans le projet ou &agrave;
l'emplacement partag&eacute;.
Remarque : si une feuille de style li&eacute;e inclut des r&eacute;f&eacute;rences &agrave; d’autres ressources, RoboHelp n’effectue pas le suivi des
mises &agrave; jour des ressources r&eacute;f&eacute;renc&eacute;es.
2 Sp&eacute;cifiez la fr&eacute;quence de v&eacute;rification des mises &agrave; jour des ressources li&eacute;es.
Remarque : outre la v&eacute;rification des mises &agrave; jour selon cette fr&eacute;quence d&eacute;finie, RoboHelp v&eacute;rifie l’&eacute;tat des ressources
li&eacute;es lors de l’ouverture d’un projet et lors de la g&eacute;n&eacute;ration de la sortie.
3 Sp&eacute;cifiez la fr&eacute;quence d'actualisation de l'emplacement partag&eacute;.
Sp&eacute;cification de param&egrave;tres du Gestionnaire de ressources au niveau du projet
Vous pouvez sp&eacute;cifier vos pr&eacute;f&eacute;rences pour la mise &agrave; jour des ressources li&eacute;es au niveau d'un projet. Par exemple, pour
un projet A, vous pouvez sp&eacute;cifier que le Gestionnaire de ressources doit mettre &agrave; jour automatiquement toutes les
ressources li&eacute;es si elles sont mises &agrave; jour &agrave; l'emplacement partag&eacute;. D'autre part, pour le projet B, vous pouvez sp&eacute;cifier
que le Gestionnaire de ressources doit vous avertir en cas de mise &agrave; jour d'une ressource li&eacute;e.
Pour sp&eacute;cifier des param&egrave;tres au niveau du projet concernant la mise &agrave; jour de ressources li&eacute;es :
❖ S&eacute;lectionnez l’une des options suivantes :
Notifier Avertit si des ressources li&eacute;es diff&egrave;rent de leurs versions d’origine dans l’emplacement partag&eacute;.
Ne pas notifier N’avertit pas si des ressources li&eacute;es diff&egrave;rent de leurs versions d’origine dans l’emplacement partag&eacute;.
Mettre &agrave; jour automatiquement le projet Met &agrave; jour toutes les ressources li&eacute;es dans le projet en fonction des
modifications dans l’emplacement partag&eacute;.
Gestion des ressources partag&eacute;es dans le conteneur Gestionnaire de
ressources
Ajout d’un emplacement partag&eacute;
Ajoutez le nombre souhait&eacute; d’emplacements ressource sous forme d’&eacute;l&eacute;ments racine dans le conteneur Gestionnaire
de ressources. Vous pouvez cr&eacute;er des dossiers dans chaque emplacement partag&eacute;.
1 S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Gestionnaire de ressources. Proc&eacute;dez de l’une des fa&ccedil;ons suivantes :
• Cliquez sur Ajouter un emplacement partag&eacute;
.
• Cliquez avec le bouton droit de la souris dans la zone vide sous les cat&eacute;gories affich&eacute;es et s&eacute;lectionnez Ajouter
un emplacement partag&eacute;.
2 Recherchez et s&eacute;lectionnez un dossier, de pr&eacute;f&eacute;rence sur un chemin r&eacute;seau ou partag&eacute;. Cliquez sur OK.
3 (Facultatif) Cliquez avec le bouton droit de la souris sur l’emplacement partag&eacute; et s&eacute;lectionnez Nouveau dossier.
Sp&eacute;cifiez un nom pour le dossier.
Derni&egrave;re mise &agrave; jour le 16/3/2011
136
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
Ajout d’une cat&eacute;gorie
Les cat&eacute;gories facilitent la gestion de diff&eacute;rents types de ressources. Vous pouvez ajouter et modifier les cat&eacute;gories et
associer diff&eacute;rents types de fichiers &agrave; chaque cat&eacute;gorie. 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.
1 S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Gestionnaire de ressources. Cliquez sur le bouton Ajouter/modifier des
cat&eacute;gories.
2 Cliquez sur le bouton Ajouter une cat&eacute;gorie
.
3 Saisissez un nom pour la nouvelle cat&eacute;gorie et cliquez sur OK.
4 Cliquez sur le bouton Ajouter un type de fichier
pour ajouter un type de fichier &agrave; la cat&eacute;gorie s&eacute;lectionn&eacute;e.
Remarques :
• Vous pouvez ajouter des types de fichiers &agrave; une cat&eacute;gorie existante.
• Vous pouvez modifier les types de fichiers d’une cat&eacute;gorie existante.
• Vous pouvez cliquer sur R&eacute;tablir la valeur par d&eacute;faut pour r&eacute;tablir l’affichage par d&eacute;faut du Gestionnaire de
ressources. Toutes les cat&eacute;gories et tous les types de fichiers d&eacute;finis par l’utilisateur continuent d’exister dans le
dossier racine.
Affichage ou masquage de contenu dans le conteneur Gestionnaire de ressources
1 S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Gestionnaire de ressources.
2 Cliquez sur le bouton Afficher/Masquer les cat&eacute;gories
.
3 S&eacute;lectionnez ou d&eacute;s&eacute;lectionnez les cat&eacute;gories &agrave; afficher ou &agrave; masquer dans le conteneur Gestionnaire de ressources.
4 S&eacute;lectionnez l’une des options suivantes :
Tout Affiche toutes les ressources des emplacements partag&eacute;s.
Li&eacute; Affiche uniquement les ressources utilis&eacute;es dans le projet ouvert.
Gestion des ressources partag&eacute;es
1 S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Gestionnaire de ressources.
2 Effectuez l’une des op&eacute;rations suivantes :
Modifier Cliquez avec le bouton droit de la souris sur un fichier pour le modifier dans l’&eacute;diteur associ&eacute;.
Explorer Cliquez avec le bouton droit de la souris sur un dossier et s&eacute;lectionnez Explorer pour ouvrir le dossier
dans l’Explorateur Windows. Vous pouvez cliquer avec le bouton droit de la souris sur un fichier et s&eacute;lectionner
Explorer pour ouvrir le dossier parent du fichier dans l’Explorateur Windows.
Copier Copie le fichier ou le dossier s&eacute;lectionn&eacute; dans le Presse-papiers.
Coller Colle le fichier ou le dossier copi&eacute; dans l’emplacement partag&eacute;.
Supprimer Cliquez avec le bouton droit de la souris et s&eacute;lectionnez Supprimer dans le menu qui s’affiche pour
supprimer un fichier ou un dossier.
Renommer Cliquez avec le bouton droit sur un fichier ou un dossier et s&eacute;lectionnez Renommer pour renommer
un fichier ou un dossier.
Copier dans le dossier du projet Copie les fichiers s&eacute;lectionn&eacute;s dans le dossier racine du projet.
Remarque : Pour ce faire, le projet doit &ecirc;tre ouvert.
Derni&egrave;re mise &agrave; jour le 16/3/2011
137
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
Exporter Cliquez avec le bouton droit sur un fichier ou un dossier et s&eacute;lectionnez Exporter parmi les options
propos&eacute;es pour l’exporter vers le dossier s&eacute;lectionn&eacute; dans la bo&icirc;te de dialogue Exporter des fichiers de ressources.
Importer (Dossier) Importe un ou plusieurs fichiers dans le dossier s&eacute;lectionn&eacute;.
Propri&eacute;t&eacute;s Affiche les propri&eacute;t&eacute;s du fichier ou du dossier s&eacute;lectionn&eacute;.
Gestion des ressources li&eacute;es
Les ressources li&eacute;es sont les ressources partag&eacute;es utilis&eacute;es dans un projet. Lorsque vous utilisez une ressource partag&eacute;e
dans un projet, RoboHelp ajoute une copie de cette ressource partag&eacute;e dans le projet. Toutefois, il conserve un lien
avec l’emplacement partag&eacute; afin de suivre les mises &agrave; jour de la copie principale. La suppression de la copie principale
dans l’emplacement partag&eacute; ne supprime pas la copie de la ressource utilis&eacute;e dans le projet.
1 Proc&eacute;dez de l’une des fa&ccedil;ons suivantes :
• S&eacute;lectionnez Edition &gt; Ressources li&eacute;es.
• S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Gestionnaire de ressources. Cliquez sur G&eacute;rer les ressources li&eacute;es.
2 Effectuez l’une des op&eacute;rations suivantes :
Recherche Recherche des ressources li&eacute;es dans le projet sur la base de crit&egrave;res d&eacute;finis.
Une ressource li&eacute;e peut pr&eacute;senter l’un des &eacute;tats suivants :
• Synchronis&eacute; La ressource partag&eacute;e d’origine et la copie utilis&eacute;e dans le projet sont identiques.
• Modifi&eacute; &agrave; l’emplacement partag&eacute; La ressource partag&eacute;e d’origine est modifi&eacute;e et la copie utilis&eacute;e dans le projet
n’est pas synchronis&eacute;e.
• Modifi&eacute; dans le projet La copie utilis&eacute;e dans le projet est modifi&eacute;e.
Remarque : dans le Gestionnaire de projets et le Gestionnaire de ressources, les ressources utilis&eacute;es dans le projet
s’affichent avec des ic&ocirc;nes qui indiquent si les ressources sont synchronis&eacute;es ou d&eacute;synchronis&eacute;es.
A
B
Les ic&ocirc;nes de ressources indiquent un &eacute;tat synchronis&eacute; ou d&eacute;synchronis&eacute;
A. Ressources synchronis&eacute;es B. Ressource d&eacute;synchronis&eacute;e
Derni&egrave;re mise &agrave; jour le 16/3/2011
138
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
• Modifi&eacute;e aux deux emplacements La ressource partag&eacute;e d’origine et la copie dans le projet ont &eacute;t&eacute; toutes les
deux modifi&eacute;es.
• Introuvable &agrave; l’emplacement partag&eacute; La ressource d’origine est introuvable dans l’emplacement partag&eacute;.
• Introuvable dans le projet Une r&eacute;f&eacute;rence &agrave; la ressource existe dans le projet, mais la ressource est supprim&eacute;e du
dossier du projet. Ce sc&eacute;nario se produit uniquement dans le cas d’une suppression manuelle de la ressource.
Synchroniser Vous permet de mettre &agrave; jour la ressource dans le projet ou dans l’emplacement partag&eacute;.
Supprimer les liens Supprime les liens de la ressource s&eacute;lectionn&eacute;e avec l’emplacement partag&eacute;. Les ressources
restent dans le projet comme ressources copi&eacute;es ; toute mise &agrave; jour de la copie principale dans l’emplacement
partag&eacute; doit &ecirc;tre suivie manuellement.
Remplacer le lien Remplace le lien actif par un lien vers une autre ressource partag&eacute;e dot&eacute;e de la m&ecirc;me extension
de fichier.
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.
D&eacute;finition des options de v&eacute;rification orthographique
❖ Choisissez la commande Outils &gt; Options orthographiques 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
139
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
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. (Choisissez la commande Outils &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.
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
❖ 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 :
• Choisissez la commande Outils &gt; V&eacute;rifier l’orthographe.
• Choisissez la commande Outils &gt; V&eacute;rifier l’orthographe de toutes les rubriques. (Facultatif) Cliquez sur le
bouton Ignorer la rubrique.
• Choisissez la commande Outils &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.
3 S&eacute;lectionnez les options de votre choix.
4 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
140
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
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.
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.
Voir aussi
&laquo; Cr&eacute;ation de contenu multilingue &raquo; &agrave; la page 56
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 Choisissez la commande Outils &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;.
Derni&egrave;re mise &agrave; jour le 16/3/2011
141
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
Utilisation du th&eacute;saurus
1 Ouvrez une rubrique dans l’&eacute;diteur de conception.
2 S&eacute;lectionnez un mot.
3 Choisissez la commande Outils &gt; Dictionnaire des synonymes.
4 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.
Replace With (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
Recherche et remplacement de texte dans une rubrique
1 Ouvrez une rubrique.
2 S&eacute;lectionnez soit Modifier &gt; Rechercher, soit Modifier &gt; Remplacer.
3 Saisissez du texte dans la zone Rechercher.
4 (Facultatif) D&eacute;finissez les options. Utilisez des expressions pour &eacute;largir ou restreindre les r&eacute;sultats de recherche.
5 Cliquez sur le bouton Rechercher ou Rechercher suivant.
6 Cliquez sur le bouton Remplacer ou Remplacer tout, ou ignorez la s&eacute;lection et cliquez sur le bouton Rechercher
suivant.
Expressions Windows
? v?tre permet de trouver votre et vitre
* m*e permet de rechercher musique et madame
[ ] [mg]are permet de rechercher mare et gare
[-] [g-q]lace permet de rechercher glace et place
@ bal@ade permet de rechercher balade et ballade
Expression UNIX
? ventes? permet de rechercher vente et ventes
* bal*ade permet de rechercher balade, ballade et baade ; m.*e permet de rechercher musique et madame
[ ] [mg]are permet de rechercher mare et gare
[-] [g-q]lace permet de rechercher glace et place
+ bal+ade permet de rechercher balade et ballade
Derni&egrave;re mise &agrave; jour le 16/3/2011
142
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
Options de recherche
❖ S&eacute;lectionnez Modifier &gt; Rechercher.
Rechercher Saisissez un mot ou une expression &agrave; rechercher (cha&icirc;ne de recherche).
Rechercher suivant Recherche l’occurrence suivante.
Fermer Termine la recherche.
Autoriser les expressions r&eacute;guli&egrave;res Reconna&icirc;t les expressions de style Microsoft Word ou UNIX.
Respecter la casse Limite la recherche aux cha&icirc;nes correspondant exactement &agrave; la casse de la cha&icirc;ne de recherche
saisie.
Sens Permet d’indiquer le sens de la recherche.
Eloigner Permet de lancer la recherche vers le haut du document.
Avant Permet de lancer la recherche vers le bas du document.
Options de recherche et de remplacement
❖ S&eacute;lectionnez Modifier &gt; Remplacer.
Rechercher Recherche ce mot ou cette expression.
Replace With (Remplacer par) Utilise ce mot ou cette expression en remplacement.
Rechercher suivant Permet de rechercher la premi&egrave;re occurrence dans le texte.
Remplacer Remplace le texte s&eacute;lectionn&eacute;.
Remplacer tout Remplace toutes les occurrences.
Fermer Termine la recherche.
Autoriser les expressions r&eacute;guli&egrave;res Reconna&icirc;t les expressions de style Microsoft Word ou UNIX.
Respecter la casse Limite la recherche aux cha&icirc;nes correspondant exactement &agrave; la casse de la cha&icirc;ne de recherche
saisie.
Sens Permet d’indiquer le sens de la recherche.
Eloigner Permet de lancer la recherche vers le haut du document.
Avant Permet de lancer la recherche vers le bas du document.
Recherche et remplacement de texte dans des fichiers
Utilisez l’outil de recherche et de remplacement multifichiers pour rechercher et remplacer les mots d’un projet.
1 S&eacute;lectionnez la commande Edition &gt; Rechercher et remplacer dans les fichiers.
2 D&eacute;finissez les options requises et cliquez sur Rechercher.
Find Recherche le mot ou l’expression.
Replace Utilise le mot ou l’expression en remplacement.
Named Indique le type de fichier(s) &agrave; rechercher.
Where Indique l’emplacement de la recherche.
Case Sensitive Limite la recherche aux cha&icirc;nes correspondant exactement &agrave; la casse de la cha&icirc;ne de recherche
saisie.
Whole Word Exclut les cha&icirc;nes qui contiennent la cha&icirc;ne de recherche saisie.
Derni&egrave;re mise &agrave; jour le 16/3/2011
143
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
Ignore HTML Tags Exclut les balises HTML lors de la recherche dans les fichiers HTML.
Make Backups Sauvegarde les fichiers d’origine avant le remplacement de texte.
Overwrite Backups Permet d’&eacute;craser les sauvegardes existantes quand Make Backups est s&eacute;lectionn&eacute;.
Include Subfolders Autorise la recherche dans les sous-dossiers du dossier sp&eacute;cifi&eacute;.
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 Proc&eacute;dez de l’une des fa&ccedil;ons suivantes :
• 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.
• S&eacute;lectionnez une rubrique dans la vue Gestionnaire de projets, puis s&eacute;lectionnez Fichier &gt; Conformit&eacute; W3C &gt;
Valider. RoboHelp valide la rubrique s&eacute;lectionn&eacute;e et affiche les avertissements ou messages d’erreur dans le
conteneur Vue de sortie ou Liste des erreurs.
Projet (Project) Proc&eacute;dez de l’une des fa&ccedil;ons suivantes :
• 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.
• S&eacute;lectionnez Fichier &gt; Conformit&eacute; W3C &gt; Valider tout.
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.
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.
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).
Derni&egrave;re mise &agrave; jour le 16/3/2011
144
UTILISATION DE ROBOHELP HTML 9
Utilisation des rubriques
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.
Vous pouvez automatiquement enregistrer les noms de fichier avec un tiret 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.
Voir aussi
&laquo; Ajout de tirets de soulignement aux noms de fichier &raquo; &agrave; la page 130
Derni&egrave;re mise &agrave; jour le 16/3/2011
145
Chapitre 5 : Modification et formatage
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 type.
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 Dans le gestionnaire de projets, s&eacute;lectionnez un fichier de rubrique. La rubrique s’ouvre dans l’Editeur de
conception.
2 Cliquez sur l’onglet HTML situ&eacute; pour afficher le code HTML de la rubrique.
Annulation d’une modification
❖ 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
❖ 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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
146
UTILISATION DE ROBOHELP HTML 9
Modification et formatage
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.
Voir aussi
&laquo; Modification des couleurs &raquo; &agrave; la page 154
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 Outils &gt; Options &gt; Associations.
1 S&eacute;lectionnez Outils &gt; Options.
2 Cliquez sur l’onglet Associations. Cliquez sur Ajouter dans la zone Editeurs HTML.
Derni&egrave;re mise &agrave; jour le 16/3/2011
147
UTILISATION DE ROBOHELP HTML 9
Modification et formatage
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 S&eacute;lectionnez Outils &gt; Options.
2 Cliquez sur l’onglet Associations.
3 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.
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 Outils &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 Outils &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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
148
UTILISATION DE ROBOHELP HTML 9
Modification et formatage
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.
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 Outils &gt; Options. Cliquez sur l’onglet Associations. S&eacute;lectionnez Utiliser l’&eacute;diteur par d&eacute;faut.
Formatage de caract&egrave;res et polices
Si vous formatez des caract&egrave;res en utilisant la barre d'outils ou l'option Format &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
❖ 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.
• S&eacute;lectionnez Format &gt; Police.
Application d’une couleur au texte
1 S&eacute;lectionnez du texte.
2 Dans la barre d'outils, cliquez sur la fl&egrave;che sur le bouton Modifier la couleur de la police
.
3 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.
Voir aussi
&laquo; Cr&eacute;ation de styles pour des feuilles de style &raquo; &agrave; la page 171
Derni&egrave;re mise &agrave; jour le 16/3/2011
149
UTILISATION DE ROBOHELP HTML 9
Modification et formatage
D&eacute;finition des options de police avanc&eacute;es
1 S&eacute;lectionnez Format &gt; Police.
2 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 S&eacute;lectionnez Format &gt; Police.
2 Cliquez sur l’onglet Espacement.
3 S&eacute;lectionnez Normal, D&eacute;velopper ou Compresser. D&eacute;finissez les options ci-dessous.
Par (Pour D&eacute;velopper ou Compresser) Indiquez la valeur d’intervalle entre les caract&egrave;res.
Position Emplacement du texte.
4 Cliquez sur OK.
Modification des tailles de police
1 S&eacute;lectionnez le texte.
2 Sur la barre d’outils, s&eacute;lectionnez une taille de police.
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 Format &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 Ouvrez une rubrique dans l’onglet Conception. S&eacute;lectionnez le texte &agrave; formater.
2 S&eacute;lectionnez une police.
Derni&egrave;re mise &agrave; jour le 16/3/2011
150
UTILISATION DE ROBOHELP HTML 9
Modification et formatage
Modification de jeux de polices
1 S&eacute;lectionnez Format &gt; Jeux de polices.
2 S&eacute;lectionnez une police.
3 Cliquez sur Modifier.
4 Ajoutez des polices de la liste Caract&egrave;res disponibles ou supprimez-les de la liste S&eacute;lections de jeu de polices.
5 Cliquez sur OK.
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 Format &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 Ouvrez une rubrique dans l’&eacute;diteur de conception. S&eacute;lectionnez l’emplacement du caract&egrave;re.
2 S&eacute;lectionnez Ins&eacute;rer &gt; HTML &gt; Symbole.
3 Cliquez deux fois sur le symbole.
Insertion d’un espace ins&eacute;cable
❖ 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.
Mise en forme des paragraphes
Si vous formatez un paragraphe en utilisant la barre d'outils ou l'option Format &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 Ouvrez une rubrique dans l’onglet Conception. S&eacute;lectionnez le paragraphe &agrave; aligner.
2 Sur la barre d’outils, cliquez sur un bouton d’alignement.
Retrait de paragraphes
1 Cliquez sur le paragraphe.
2 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
Derni&egrave;re mise &agrave; jour le 16/3/2011
.
151
UTILISATION DE ROBOHELP HTML 9
Modification et formatage
• S&eacute;lectionnez Format &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 S&eacute;lectionnez Afficher &gt; Afficher &gt; R&egrave;gle.
2 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.
3 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
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 Afficher &gt; Afficher &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 Format &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.
Voir aussi
&laquo; Cr&eacute;ation de styles pour des feuilles de style &raquo; &agrave; la page 171
Derni&egrave;re mise &agrave; jour le 16/3/2011
152
UTILISATION DE ROBOHELP HTML 9
Modification et formatage
Modification de l’unit&eacute; de mesure de la r&egrave;gle
1 S&eacute;lectionnez Afficher &gt; Afficher &gt; R&egrave;gle.
2 Cliquez avec le bouton droit de la souris sur la r&egrave;gle.
3 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.
❖ 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.
Voir aussi
&laquo; Prise en charge de plusieurs langues &raquo; &agrave; la page 57
Application d’un habillage de texte
1 Dans l’&eacute;diteur de conception, cliquez deux fois sur un objet.
2 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.
3 (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 S&eacute;lectionnez Format &gt; Paragraphe.
2 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
153
UTILISATION DE ROBOHELP HTML 9
Modification et formatage
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; Saut de ligne. Vous pouvez &eacute;galement appuyer sur Maj + Entr&eacute;e.
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 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.
2 S&eacute;lectionnez Format &gt; Bordures et trame.
3 Cliquez sur l’onglet Bordures et trame.
4 Sp&eacute;cifiez les options de bordure et de trame. Cliquez sur OK.
5 Cliquez sur le bouton Enregistrer tout
.
Voir aussi
&laquo; Ajout ou modification des bordures ou des arri&egrave;re-plans dans les feuilles de style &raquo; &agrave; la page 178
Ajout de bordures &agrave; des images
1 Dans l’&eacute;diteur de conception, cliquez deux fois sur l’image.
2 Cliquez sur l’onglet Image. Cliquez sur Bordures.
3 D&eacute;finissez les options des bordures.
4 Cliquez sur OK.
Voir aussi
&laquo; Ajout ou modification des bordures ou des arri&egrave;re-plans dans les feuilles de style &raquo; &agrave; la page 178
Suppression de bordures ou d’arri&egrave;re-plans
1 Ouvrez une rubrique.
2 S&eacute;lectionnez l’&eacute;l&eacute;ment comportant la bordure ou la trame.
3 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 correspondant &agrave; aucune
bordure.
• Sur la barre d’outils, cliquez sur le bouton Couleur de remplissage
et choisissez Aucun.
Derni&egrave;re mise &agrave; jour le 16/3/2011
154
UTILISATION DE ROBOHELP HTML 9
Modification et formatage
• S&eacute;lectionnez Format &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.
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 Choisissez la commande Ins&eacute;rer &gt; HTML &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 S&eacute;lectionnez Format &gt; Couleurs.
2 Cliquez sur Nouveau. Attribuez un nom &agrave; la couleur.
3 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 S&eacute;lectionnez Format &gt; Couleurs.
Derni&egrave;re mise &agrave; jour le 16/3/2011
155
UTILISATION DE ROBOHELP HTML 9
Modification et formatage
2 S&eacute;lectionnez la couleur &agrave; supprimer.
3 Cliquez sur Supprimer.
Ajout de son aux rubriques
1 S&eacute;lectionnez une ou plusieurs rubriques dans le conteneur Liste des rubriques.
2 Cliquez sur le bouton Propri&eacute;t&eacute;s.
3 Cliquez sur l’onglet Pr&eacute;sentation.
4 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.
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.
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 mini tables des mati&egrave;res 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
156
UTILISATION DE ROBOHELP HTML 9
Modification et formatage
Processus de cr&eacute;ation d’un tableau
1 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.
Reportez-vous &agrave; la section &laquo; Insertion de tableaux &raquo; &agrave; la page 156.
2 Choisissez un style global &agrave; appliquer au tableau. Vous pouvez &eacute;galement cr&eacute;er vos propres styles de tableau via
l’option Format &gt; Styles.
Remarque : si vous ne s&eacute;lectionnez aucun style, un style par d&eacute;faut sera appliqu&eacute; au tableau.
Reportez-vous &agrave; la section &laquo; Styles de tableau &raquo; &agrave; la page 172.
3 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.
Reportez-vous &agrave; la section &laquo; Modification de tableaux &raquo; &agrave; la page 157.
Insertion de tableaux
Vous pouvez ins&eacute;rer un tableau partout dans une rubrique ou dans une page type, 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 Cliquez &agrave; l’endroit o&ugrave; vous souhaitez ins&eacute;rer le tableau.
2 Choisissez Afficher &gt; Barres d’outils &gt; Tableaux et bordures.
3 Sur la barre d’outils, cliquez sur le bouton Ins&eacute;rer un tableau
.
4 Sur la grille de tableau, faites glisser la souris pour d&eacute;terminer le nombre de colonnes et de lignes &agrave; ajouter.
5 Cliquez pour ins&eacute;rer le tableau.
Insertion d’un tableau personnalis&eacute;
1 Cliquez &agrave; l’endroit o&ugrave; vous souhaitez ins&eacute;rer le tableau.
2 S&eacute;lectionnez Tableau &gt; Ins&eacute;rer &gt; Tableau.
3 Sp&eacute;cifiez le nombre de lignes et de colonnes.
4 S&eacute;lectionnez un mod&egrave;le de tableau ou choisissez un style personnalis&eacute; dans Styles CSS.
5 Cliquez sur OK.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
157
UTILISATION DE ROBOHELP HTML 9
Modification et formatage
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.
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 de modification de tableau, reportez-vous &agrave; la section relative &agrave; la manipulation de tableau
de la vid&eacute;o concernant les m&eacute;thodes de cr&eacute;ation et de gestion ais&eacute;es de tableaux et de styles de tableau.
Insertion de lignes et de colonnes dans un tableau
• Cliquez dans un tableau. S&eacute;lectionnez Tableau &gt; Ins&eacute;rer &gt; Ligne ou Colonne.
• Pour ins&eacute;rer plusieurs lignes ou colonnes, s&eacute;lectionnez plusieurs cellules du tableau. S&eacute;lectionnez Tableau &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.
Modification des propri&eacute;t&eacute;s de tableau
1 Cliquez dans un tableau.
2 S&eacute;lectionnez Tableau &gt; Propri&eacute;t&eacute;s du tableau.
3 D&eacute;finissez les options.
D&eacute;finition des propri&eacute;t&eacute;s d’ajustement automatique d’un tableau
1 Cliquez dans un tableau.
2 S&eacute;lectionnez Tableau &gt; Ajustement automatique.
3 S&eacute;lectionnez une commande :
Ajuster automatiquement au contenu D&eacute;finit la largeur de la colonne en fonction de la largeur du contenu de la
colonne.
Ajuster automatiquement &agrave; la fen&ecirc;tre D&eacute;finit la largeur de la colonne, de sorte que la largeur du tableau soit &eacute;gale
&agrave; la largeur de la fen&ecirc;tre.
Largeur de colonne fixe R&egrave;gle la largeur de la colonne sur une taille fixe.
Derni&egrave;re mise &agrave; jour le 16/3/2011
158
UTILISATION DE ROBOHELP HTML 9
Modification et formatage
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 Tableau &gt;
Propri&eacute;t&eacute;s du tableau &gt; 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 S&eacute;lectionnez Format &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.
Fusion ou division de cellules de tableau
1 S&eacute;lectionnez les cellules &agrave; fusionner ou &agrave; diviser.
2 S&eacute;lectionnez Tableau &gt; Fusionner les cellules ou Tableau &gt; Diviser les cellules.
Vous pouvez diviser une cellule en plusieurs lignes et colonnes pour cr&eacute;er un tableau.
Voir aussi
&laquo; Styles de tableau &raquo; &agrave; la page 172
Listes
Application d’un retrait aux listes
❖ 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
159
UTILISATION DE ROBOHELP HTML 9
Modification et formatage
• (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 Ouvrez la rubrique dans l’&eacute;diteur de conception.
2 S&eacute;lectionnez du texte.
3 Dans le menu Format, s&eacute;lectionnez Listes &gt; Puces et num&eacute;ros.
4 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 Ouvrez la rubrique contenant le style de puce &agrave; personnaliser.
2 Dans le menu Format, s&eacute;lectionnez Styles.
3 Dans Liste, s&eacute;lectionnez Tous les styles.
4 Sous Disponible dans, choisissez une feuille de style externe ou imbriqu&eacute;e.
5 Dans la liste Styles, s&eacute;lectionnez un style et cliquez sur le bouton Cr&eacute;er un nouveau style
.
6 Sous Type de style, s&eacute;lectionnez Style de paragraphe.
7 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.
8 Sous Style pour le paragraphe suivant, s&eacute;lectionnez l’option (Pas de modification).
9 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
❖ S&eacute;lectionnez la liste &agrave; puces et choisissez Format &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 Format &gt; Styles.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
160
UTILISATION DE ROBOHELP HTML 9
Modification et formatage
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 S&eacute;lectionnez les &eacute;l&eacute;ments de la liste num&eacute;rot&eacute;e ou de la liste &agrave; puces.
2 Dans le menu Format, s&eacute;lectionnez Liste &gt; Puces et num&eacute;ros.
3 Cliquez sur l'option pour ne pas ins&eacute;rer de puces.
Vous pouvez &eacute;galement utiliser les boutons Cr&eacute;er une liste &agrave; puces, Cr&eacute;er une liste num&eacute;rot&eacute;e et Cr&eacute;er une liste multiniveau dans la barre d'outils pour supprimer le 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 Dans le menu Format, s&eacute;lectionnez Liste &gt; Puces et num&eacute;ros.
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.
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 S&eacute;lectionnez Format &gt; Liste &gt; Puces et num&eacute;ros.
3 S&eacute;lectionnez l’onglet Num&eacute;ros.
Derni&egrave;re mise &agrave; jour le 16/3/2011
161
UTILISATION DE ROBOHELP HTML 9
Modification et formatage
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.
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 type.
Si vous modifiez ou supprimez un en-t&ecirc;te ou un pied de page, les rubriques et les pages type seront &eacute;dit&eacute;es comme suit :
Dans une rubrique Les modifications sont appliqu&eacute;es &agrave; la rubrique.
Dans une page type 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 type Vous pouvez d&eacute;cider d’appliquer les modifications &agrave; la rubrique en cours
ou &agrave; la page type 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 Ouvrez la rubrique ou la page type.
2 S&eacute;lectionnez Afficher &gt; En-t&ecirc;te ou pied de page.
3 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.
4 (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.
5 Cliquez hors de l’en-t&ecirc;te ou du pied de page.
6 Cliquez sur le bouton Enregistrer tout.
Suppression d’en-t&ecirc;tes et de pieds de page
1 Ouvrez la rubrique ou la page type contenant l’en-t&ecirc;te ou le pied de page &agrave; modifier.
2 Cliquez sur le bouton En-t&ecirc;te ou Pied de page.
3 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.
4 Cliquez sur le bouton Enregistrer tout.
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; Saut de page. Vous pouvez &eacute;galement appuyer sur Ctrl + Entr&eacute;e.
Derni&egrave;re mise &agrave; jour le 16/3/2011
162
UTILISATION DE ROBOHELP HTML 9
Modification et formatage
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 Cliquez &agrave; l’endroit o&ugrave; vous souhaitez ins&eacute;rer la zone de texte.
2 S&eacute;lectionnez Ins&eacute;rer &gt; HTML &gt; Zone de texte.
3 (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.
4 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 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 S&eacute;lectionnez Afficher &gt; Barres d’outils &gt; Positionnement.
3 Dans le menu Z, s&eacute;lectionnez 1.
4 R&eacute;p&eacute;tez la proc&eacute;dure pour les autres zones de texte.
Derni&egrave;re mise &agrave; jour le 16/3/2011
163
UTILISATION DE ROBOHELP HTML 9
Modification et formatage
Zones de texte superpos&eacute;es
Modification des propri&eacute;t&eacute;s de zone de texte
1 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.
2 Modifiez les propri&eacute;t&eacute;s.
Suppression de zones de texte d’une rubrique
1 S&eacute;lectionnez la zone de texte.
2 Sur la barre d’outils, cliquez sur le bouton Supprimer.
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 Afficher &gt; Conteneurs) r&eacute;pertorie l’ensemble des variables d&eacute;finies
par l’utilisateur dans un projet.
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.
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 Afficher &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 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
164
UTILISATION DE ROBOHELP HTML 9
Modification et formatage
3 Cliquez sur OK. La variable est ins&eacute;r&eacute;e.
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.
Modification d’une variable d&eacute;finie par l’utilisateur
1 Dans le conteneur Variables d&eacute;finies par l’utilisateur, s&eacute;lectionnez une variable dans le jeu de variables par d&eacute;faut.
2 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.
3 (Facultatif) S&eacute;lectionnez un autre jeu de variables.
4 Modifiez la valeur.
5 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
165
UTILISATION DE ROBOHELP HTML 9
Modification et formatage
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; Variable d&eacute;finie par l’utilisateur.
3 S&eacute;lectionnez une variable, puis cliquez sur OK.
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.
Affichage des propri&eacute;t&eacute;s d’une variable d&eacute;finie par l’utilisateur
1 Dans le conteneur Variables d&eacute;finies par l’utilisateur, s&eacute;lectionnez le jeu de variables par d&eacute;faut.
2 S&eacute;lectionnez une variable.
3 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).
5 Cliquez sur OK.
Suppression d’une variable d&eacute;finie par l’utilisateur
1 Dans le conteneur Variables d&eacute;finies par l’utilisateur, s&eacute;lectionnez le jeu de variables par d&eacute;faut.
2 Cliquez avec le bouton droit de la souris sur une variable d&eacute;finie par l’utilisateur, puis s&eacute;lectionnez Supprimer.
3 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.
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 uniques, elle est supprim&eacute;e
de la liste des variables figurant dans la bo&icirc;te de dialogue Mises en page source uniques.
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
Lorsque vous modifiez le nom d’une variable d&eacute;finie par l’utilisateur, toutes ses occurrences au sein des jeux de
variables, rubriques, mod&egrave;les, tables des mati&egrave;res, index et SSL du projet sont &eacute;galement mises &agrave; jour.
Derni&egrave;re mise &agrave; jour le 16/3/2011
166
UTILISATION DE ROBOHELP HTML 9
Modification et formatage
Remarque : vous ne pouvez pas changer le nom des variables sauvegard&eacute;es.
1 S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Variables d&eacute;finies par l’utilisateur. Le conteneur Variables d&eacute;finies par
l’utilisateur s’affiche.
2 Cliquez avec le bouton droit de la souris sur une variable et s&eacute;lectionnez Renommer.
3 Dans le champ Nom de la variable, saisissez un nom.
4 Dans le champ Valeur de la variable, modifiez la valeur.
5 Cliquez sur OK.
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.
Remarque : Vous pouvez glisser-d&eacute;poser un extrait de code dans l’&eacute;diteur de conception pour modifier son contenu.
Voir aussi
&laquo; Gestion des ressources &raquo; &agrave; la page 134
Cr&eacute;ation et gestion des extraits de code
• Pour cr&eacute;er int&eacute;gralement un extrait de code, s&eacute;lectionnez Fichier &gt; Nouveau &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 sur l’extrait de code dans le conteneur
Extraits de code. Vous pouvez &eacute;galement afficher les rubriques qui partagent cet extrait de code.
Derni&egrave;re mise &agrave; jour le 16/3/2011
167
UTILISATION DE ROBOHELP HTML 9
Modification et formatage
• Pour copier un extrait de code, cliquez avec le bouton droit sur l’extrait de code dans le conteneur Extraits de code
et s&eacute;lectionnez Copier dans le menu contextuel.
• Pour importer un extrait de code, s&eacute;lectionnez Fichier &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
dans la barre
d’outils et acc&eacute;dez au dossier de destination.
• 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.
Insertion d’un extrait de code dans une rubrique
1 Ouvrez une rubrique.
2 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; Extrait de code. S&eacute;lectionnez un extrait de code dans la liste et cliquez sur OK.
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 Ouvrez une rubrique.
2 S&eacute;lectionnez du texte &agrave; d&eacute;velopper.
3 S&eacute;lectionnez DHTML &gt; Cr&eacute;er une zone cliquable d&eacute;roulante et un texte.
4 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
168
UTILISATION DE ROBOHELP HTML 9
Modification et formatage
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.
Suppression d’un extrait de code
1 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;.
2 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 ne s’affiche avant la
suppression.
Remarque : utilisez le rapport Extraits de code pour localiser les variables &agrave; supprimer.
Supprimer uniquement l’extrait de code Supprimez 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 Supprimez l’extrait de code et
remplacez les r&eacute;f&eacute;rences dans le projet par le contenu.
R&eacute;f&eacute;rence
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;.
Derni&egrave;re mise &agrave; jour le 16/3/2011
169
Chapitre 6 : Styles et feuilles de style
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 type 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.
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.
Voir aussi
&laquo; Pages type &raquo; &agrave; la page 125
Gestion des feuilles de style
Association d’une feuille de style aux rubriques ou aux pages type
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 Cliquez sur l’ic&ocirc;ne Propri&eacute;t&eacute;s de l’&eacute;l&eacute;ment
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
style ou cliquez sur le bouton Nouveau pour cr&eacute;er une feuille de style.
Derni&egrave;re mise &agrave; jour le 16/3/2011
pour explorer une feuille de
170
UTILISATION DE ROBOHELP HTML 9
Styles et feuilles 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.
Voir aussi
&laquo; Application d’une page type ou d’une feuille CSS lors de la g&eacute;n&eacute;ration &raquo; &agrave; la page 129
Suppression de l’association d’une feuille de style aux rubriques ou aux pages
type
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 Cliquez sur l’ic&ocirc;ne Propri&eacute;t&eacute;s de l’&eacute;l&eacute;ment
dans la barre d’outils. Cliquez sur l’onglet Pr&eacute;sentation.
3 S&eacute;lectionnez Aucun dans la liste des feuilles de style ou cliquez sur le bouton Parcourir
pour s&eacute;lectionner une
autre feuille de style &agrave; appliquer.
4 Cliquez sur OK.
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 Cliquez sur le bouton Feuille de style
. Pour afficher la barre d’outils, le cas &eacute;ch&eacute;ant, s&eacute;lectionnez Afficher &gt;
Barres d’outils &gt; Formatage.
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 Choisissez la commande Fichier &gt; Nouveau &gt; Rubrique. Cliquez sur l’onglet Pr&eacute;sentation.
2 Cliquez sur Nouveau.
3 Indiquez un nom de fichier en ajoutant l’extension .css.
4 Cr&eacute;ez ou modifiez des styles pr&eacute;d&eacute;finis dans la bo&icirc;te de dialogue Styles.
5 Cliquez sur OK.
Derni&egrave;re mise &agrave; jour le 16/3/2011
171
UTILISATION DE ROBOHELP HTML 9
Styles et feuilles de style
Exportation d’une feuille de style
1 S&eacute;lectionnez l’&eacute;diteur de conception.
2 S&eacute;lectionnez Format &gt; Exporter les styles.
3 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.
4 Cliquez sur Enregistrer.
Remarque : vous pouvez uniquement exporter des styles en ligne sp&eacute;cifiques aux rubriques.
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 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.
2 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.
3 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.
4 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.
5 (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. Pour cela, s&eacute;lectionnez Outils &gt; Mettre &agrave; jour les effets DHTML dans les rubriques.
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.
Cr&eacute;ation d’un style via le conteneur Styles et formatage
1 Pour ouvrir ce conteneur, ouvrez une rubrique et s&eacute;lectionnez Format &gt; Styles.
2 Dans la barre d’outils Styles et formatage, cliquez sur le bouton Cr&eacute;er un style
(liste, par exemple).
3 Indiquez un nom de style et cliquez sur OK.
Derni&egrave;re mise &agrave; jour le 16/3/2011
et s&eacute;lectionnez un type de style
172
UTILISATION DE ROBOHELP HTML 9
Styles et feuilles de style
4 S&eacute;lectionnez les options relatives aux polices et &agrave; la mise en forme et cliquez sur OK.
Voir aussi
&laquo; Conteneur Styles et formatage &raquo; &agrave; la page 21
Cr&eacute;ation d’un style via l’&eacute;diteur de conception
1 Dans l’&eacute;diteur de conception, s&eacute;lectionnez du texte dans une rubrique.
2 Appliquez-lui un format (gras par exemple).
3 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.
4 Cliquez sur Cr&eacute;er.
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 solutions de rechange concernant la personnalisation des tableaux, reportez-vous &agrave; 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. Vous les trouverez dans le r&eacute;pertoire suivant : C:\Documents and Settings\[nom
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
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.
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 utilisateur]\Application Data\Adobe\RoboHTML\[version]\Templates\Tables. Ces
styles seront disponibles pour l’ensemble des projets.
Pour appliquer un style &agrave; un tableau, cliquez sur l’ic&ocirc;ne Appliquer le style de tableau global
Tableaux et bordures.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
dans la barre d’outils
173
UTILISATION DE ROBOHELP HTML 9
Styles et feuilles de style
2 Pour appliquer un style &agrave; un tableau, cliquez sur l’ic&ocirc;ne Appliquer le style de tableau global
dans 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 ais&eacute;s pour cr&eacute;er et g&eacute;rer des tableaux et des styles de
tableau.
Cr&eacute;ation de styles de tableau
1 S&eacute;lectionnez Format &gt; Styles.
2 Cliquez sur Cr&eacute;er un style et s&eacute;lectionnez Style de tableau.
3 Saisissez un nom pour le nouveau style de tableau et cliquez sur OK.
4 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.
5 S&eacute;lectionnez la police, la taille et la couleur.
6 S&eacute;lectionnez la bordure et sa couleur.
7 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
Tableaux et bordures.
dans la barre d’outils
• 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 sousclasses &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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
174
UTILISATION DE ROBOHELP HTML 9
Styles et feuilles de style
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 Format &gt; Appliquer une balise de construction conditionnelle &gt; Nouvelle/Plusieurs.
3 S&eacute;lectionnez des balises. Cliquez sur OK.
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.
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),
reportez-vous &agrave; 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, consultez M&eacute;thodes de cr&eacute;ation ais&eacute;es de listes et
num&eacute;rotation automatique, sur la page des didacticiels vid&eacute;o Adobe RoboHelp.
Cr&eacute;ation de listes HTML
1 Cliquez avec le bouton droit de la souris sur l’option Style de liste dans la bo&icirc;te de dialogue Styles.
2 Cliquez sur Nouveau.
3 Nommez la nouvelle liste.
4 S&eacute;lectionnez une police, une taille de police ou une couleur pour le nouveau style de liste.
5 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.
6 (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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
175
UTILISATION DE ROBOHELP HTML 9
Styles et feuilles de style
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;.
3 (Pour les listes multi-niveaux uniquement) S&eacute;lectionnez le style de paragraphe &agrave; appliquer au niveau de liste actuel.
4 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.
5 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;).
6 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 Cliquez sur le bouton Liste num&eacute;rot&eacute;e
.
3 (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.
4 Indiquez un pr&eacute;fixe pour le nouveau style de num&eacute;rotation automatique dans le champ Format.
5 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
176
UTILISATION DE ROBOHELP HTML 9
Styles et feuilles de style
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.
4 S&eacute;lectionnez la police de la s&eacute;quence dans le menu contextuel Police de la s&eacute;quence et cliquez sur Ajouter.
5 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 Dans la bo&icirc;te de dialogue Styles, cliquez sur Nouveau.
2 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 Dans la bo&icirc;te de dialogue Styles, cliquez sur Nouveau.
2 S&eacute;lectionnez la s&eacute;quence. Cliquez sur le signe plus (+).
3 Cliquez sur Oui pour confirmer. Cliquez ensuite sur OK.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
177
UTILISATION DE ROBOHELP HTML 9
Styles et feuilles de style
• 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.
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.
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.
Modification d’un style via la bo&icirc;te de dialogue Styles
1 Dans le conteneur Gestionnaire de projets, cliquez avec le bouton droit de la souris sur le fichier CSS. Cliquez sur
le bouton Modifier.
2 D&eacute;sactivez l’option Masquer les styles h&eacute;rit&eacute;s.
3 Sous Disponible dans, choisissez une feuille de style.
4 Dans Styles, s&eacute;lectionnez un style.
5 Cliquez sur Format et s&eacute;lectionnez les attributs ad&eacute;quats.
6 (Facultatif) S&eacute;lectionnez des options de mise en forme dans la section Formatage.
7 Cliquez sur OK.
Modification d’un style via le conteneur Styles et formatage
1 S&eacute;lectionnez un style dans le conteneur Styles et formatage.
2 Cliquez sur Modifier l’&eacute;l&eacute;ment s&eacute;lectionn&eacute;.
3 Dans la bo&icirc;te de dialogue Styles, s&eacute;lectionnez les options de mise en forme.
4 Cliquez sur OK.
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.
Suppression de styles de feuilles de style
1 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.
2 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.
3 Sous le menu Disponible dans, choisissez une feuille de style. Pour un style int&eacute;gr&eacute;, s&eacute;lectionnez un nom de
rubrique.
4 Dans le menu Styles, s&eacute;lectionnez le style &agrave; supprimer.
Derni&egrave;re mise &agrave; jour le 16/3/2011
178
UTILISATION DE ROBOHELP HTML 9
Styles et feuilles de style
Pour supprimer un formatage personnalis&eacute; d’un style par d&eacute;faut, s&eacute;lectionnez le style.
5 Cliquez sur Supprimer.
6 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.
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;) Lien hypertexte (visit&eacute;) Lien hypertexte (actif) Lien hypertexte s&eacute;lectionn&eacute;.
6 S&eacute;lectionnez Format &gt; Police.
7 Sous Couleur de la police, s&eacute;lectionnez une couleur. Cliquez sur OK.
Voir aussi
&laquo; Cr&eacute;ation de styles pour des feuilles de style &raquo; &agrave; la page 171
&laquo; Habillages &raquo; &agrave; la page 368
Ajout ou modification des bordures ou des arri&egrave;re-plans dans les feuilles de
style
1 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.
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 l’option Autre de la bo&icirc;te de dialogue Styles, s&eacute;lectionnez Arri&egrave;re-plan + Texte (Corps).
Derni&egrave;re mise &agrave; jour le 16/3/2011
179
UTILISATION DE ROBOHELP HTML 9
Styles et feuilles de style
5 S&eacute;lectionnez Format, puis Bordures et trame.
6 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;.
Voir aussi
&laquo; Ajout ou modification de bordures et d’arri&egrave;re-plans de rubriques &raquo; &agrave; la page 153
Styles en ligne
Application ou modification des styles en ligne
1 Dans l’&eacute;diteur de conception, s&eacute;lectionnez le bloc de texte &agrave; formater.
2 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 menu Format, 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.
Suppression de styles en ligne du texte
1 Dans l’&eacute;diteur de conception, s&eacute;lectionnez le bloc de texte avec le style en ligne.
2 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
180
Chapitre 7 : Tables des mati&egrave;res, index et
glossaires
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 de chapitre d&eacute;finie dans le conteneur
Gestionnaire de projets. Lorsque la table est cr&eacute;&eacute;e de mani&egrave;re automatique, les livres et pages sont tri&eacute;s par ordre
alphab&eacute;tique.
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.
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;coch&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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
181
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
Voir aussi
&laquo; R&eacute;organisation des livres et des pages d’une table des mati&egrave;res &raquo; &agrave; la page 182
&laquo; D&eacute;finition de la mise en page des chapitres &raquo; &agrave; la page 34
Impression des tables des mati&egrave;res
1 Cliquez sur le conteneur Table des mati&egrave;res.
2 Sur la barre d’outils, cliquez sur Imprimer.
3 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 Ouvrez le conteneur Table des mati&egrave;res en double-cliquant sur la table des mati&egrave;res requise dans le Gestionnaire
de projets.
2 Sur la barre d’outils, cliquez sur le bouton Nouveau livre de table des mati&egrave;res
.
3 Dans la bo&icirc;te de dialogue Titre du livre, saisissez le nom &agrave; afficher dans la table des mati&egrave;res.
4 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
.
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 type. 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 Dans le conteneur Table des mati&egrave;res, cliquez avec le bouton droit de la souris sur une page.
2
S&eacute;lectionnez Cr&eacute;er un livre &agrave; partir de la page.
Derni&egrave;re mise &agrave; jour le 16/3/2011
182
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
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 Ouvrez le conteneur Table des mati&egrave;res et le conteneur Liste des rubriques.
2 S&eacute;lectionnez une ou plusieurs rubriques dans le conteneur Liste des rubriques.
3 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 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.
2 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.
3 (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;.
4 Dans la liste Rubriques existantes, s&eacute;lectionnez une rubrique pour la nouvelle page.
5 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;.
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.
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.
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 Dans le conteneur Table des mati&egrave;res, s&eacute;lectionnez un livre ou une page.
2 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
183
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
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.
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.
❖ 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.
Ce rapport peut servir de structure de projet.
Rapport sur les propri&eacute;t&eacute;s de la rubrique
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
Derni&egrave;re mise &agrave; jour le 16/3/2011
184
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
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.
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 Outils &gt; R&eacute;soudre les 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
indique des r&eacute;f&eacute;rences dont les liens vers la table des mati&egrave;res ont &eacute;t&eacute; rompus.
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.
Voir aussi
&laquo; R&eacute;paration de liens rompus &raquo; &agrave; la page 216
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 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.
2 Faites glisser des livres et des pages d’un conteneur Table des mati&egrave;res &agrave; un autre.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
185
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
• 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 Saisissez un nom.
3 (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
s&eacute;lectionnez-le.
pour rechercher le fichier HHC dans le dossier du projet, puis
4 Cliquez sur OK.
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 : pour cr&eacute;er automatiquement une table des mati&egrave;res, cliquez sur le bouton Cr&eacute;er automatiquement la 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.
Voir aussi
&laquo; Fusion de projets d’aide &raquo; &agrave; la page 43
Cr&eacute;ation de s&eacute;quences de navigation &agrave; partir des tables 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 Outils &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.
3 Dans la zone de texte, sp&eacute;cifiez le nombre de niveaux que vous voulez inclure dans la s&eacute;quence pour chaque livre.
4 Dans le menu contextuel, s&eacute;lectionnez la table des mati&egrave;res pour la s&eacute;quence de navigation.
5 Cliquez sur OK.
Derni&egrave;re mise &agrave; jour le 16/3/2011
186
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
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.
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 motscl&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 motscl&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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
187
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
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.
• 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 Fichier &gt; Param&egrave;tres du projet.
2 Cliquez sur l’onglet G&eacute;n&eacute;ralit&eacute;s.
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
Derni&egrave;re mise &agrave; jour le 16/3/2011
.
188
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
Impression d’index
1 Cliquez sur le conteneur Index.
2 Dans le menu contextuel, s&eacute;lectionnez les &eacute;l&eacute;ments &agrave; imprimer.
3 Sur la barre d’outils, cliquez sur Imprimer.
4 Cliquez sur Propri&eacute;t&eacute;s, puis sur Configuration de la page pour sp&eacute;cifier les options d’impression.
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.
Voir aussi
&laquo; Cr&eacute;ation automatique d’index &raquo; &agrave; la page 193
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.
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 motscl&eacute;s secondaires en les s&eacute;parant par \, puis cliquez sur Ajouter un mot-cl&eacute;.
3 S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Liste des rubriques. Le conteneur Liste des rubriques s’affiche.
4 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.
Ajout de mots-cl&eacute;s d’index sur la base d’un titre de rubrique
1 Ouvrez le conteneur Index.
2 S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Liste des rubriques.
3 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.
4 Faites glisser la rubrique dans le volet sup&eacute;rieur du concepteur d’index.
Derni&egrave;re mise &agrave; jour le 16/3/2011
189
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
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 Dans le conteneur Liste des rubriques ou Gestionnaire de projets, s&eacute;lectionnez une rubrique.
2 Cliquez sur le bouton Propri&eacute;t&eacute;s
.
3 Dans la bo&icirc;te de dialogue Propri&eacute;t&eacute;s de rubrique, cliquez sur l’onglet Index.
4 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.
5 Cliquez sur Ajouter.
Ajout de mots-cl&eacute;s d’index par s&eacute;lection de texte de rubrique
1 Cliquez deux fois sur une rubrique pour l’ouvrir dans la vue Conception.
2 S&eacute;lectionnez le texte &agrave; utiliser comme mot-cl&eacute;.
3 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.
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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
190
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
• 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 type.
• 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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
191
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
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.
❖ 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;lectionner 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.
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 Dans le Concepteur d’index, s&eacute;lectionnez un mot-cl&eacute;.
2 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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
192
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
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.
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 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.
2 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
Derni&egrave;re mise &agrave; jour le 16/3/2011
.
193
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
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.
❖ Dans le conteneur Index, s&eacute;lectionnez un mot-cl&eacute;. Sur la barre d’outils, cliquez sur le bouton Supprimer
.
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.
Application de balises de construction conditionnelles &agrave; un index
1 Dans le conteneur Index, s&eacute;lectionnez un mot-cl&eacute;.
2 Cliquez sur Format &gt; Appliquer une balise de construction conditionnelle &gt; Nouvelle/Plusieurs.
3 S&eacute;lectionnez les balises ou cliquez sur V&eacute;rifier tout.
4 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
194
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
3 S&eacute;lectionnez les &eacute;l&eacute;ments dans lesquels effectuer la recherche des mots-cl&eacute;s d’index.
4 Pour sp&eacute;cifier des mots ou des expressions &agrave; ignorer, s&eacute;lectionnez Ignorer toujours ou Expressions. Modifier,
ajouter ou supprimer des entr&eacute;es.
5 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.)
6 Cliquez sur Suivant.
7 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.
8 (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.
3 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
195
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
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;.
Voir aussi
&laquo; Modification des param&egrave;tres du projet &raquo; &agrave; la page 37
D&eacute;finition des mots courants &agrave; ignorer
Vous pouvez cr&eacute;er une liste de mots courants (tels que un) qui seront ignor&eacute;s par l’assistant d’index dynamique. 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.
Voir aussi
&laquo; Modification des param&egrave;tres du projet &raquo; &agrave; la page 37
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.
3 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
196
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
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 S&eacute;lectionnez Outils &gt; Assistant d’index dynamique.
2 Cliquez deux fois sur Suivant.
3 S&eacute;lectionnez un mot-cl&eacute;.
4 Cliquez sur Options. S&eacute;lectionnez Synonymes.
Le mot-cl&eacute; appara&icirc;t dans la zone Mot.
5 (Facultatif) Cliquez sur Antonymes pour conna&icirc;tre les antonymes du mot-cl&eacute;.
6 Sous Cat&eacute;gories, s&eacute;lectionnez le mot le plus appropri&eacute;.
7 Sous Synonymes, s&eacute;lectionnez un mot &agrave; ajouter en tant que mot-cl&eacute;. Cliquez sur Ajouter &agrave; la rubrique.
8 Cliquez sur Fermer.
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.
3 (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.
4 Cliquez sur OK.
Derni&egrave;re mise &agrave; jour le 16/3/2011
197
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
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.
Voir aussi
&laquo; Indexation automatique via l’assistant d’index dynamique &raquo; &agrave; la page 193
&laquo; Cr&eacute;ation d’index binaires (HTML Help) &raquo; &agrave; la page 198
&laquo; Tables des mati&egrave;res et index Microsoft HTML Help &raquo; &agrave; la page 197
&laquo; Fusion de projets d’aide &raquo; &agrave; la page 43
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 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 Cliquez sur l’onglet Avanc&eacute;.
Sous Image, Automatique indique que le livre ou la page utilise l’ic&ocirc;ne standard.
3 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.
4 (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.
5 Cliquez sur OK.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
198
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
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 Afficher &gt; Conteneurs &gt; Mises en page source uniques.
3 D&eacute;veloppez le dossier Mises en page source uniques.
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 V&eacute;rifiez que la mise en page principale est d&eacute;finie en fonction de Microsoft HTML Help.
2 S&eacute;lectionnez Fichier &gt; Param&egrave;tres du projet.
3 Dans l’onglet G&eacute;n&eacute;ralit&eacute;s, s&eacute;lectionnez Index binaire.
4 Cliquez sur OK.
5 Ajoutez des mots-cl&eacute;s de rubrique (marqu&eacute;s d’une ic&ocirc;ne de cl&eacute;
).
6 Fusionnez-les sous-projets le cas &eacute;ch&eacute;ant.
7 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.
Voir aussi
&laquo; Fusion de projets d’aide &raquo; &agrave; la page 43
&laquo; G&eacute;n&eacute;ration, affichage et publication d’une sortie &raquo; &agrave; la page 320
Derni&egrave;re mise &agrave; jour le 16/3/2011
199
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
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 uniques, 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
Lignes &agrave; partir de la racine Permet d’afficher les lignes connectant les livres et les pages &agrave; partir de la racine.
6 Indiquez une police.
7 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
200
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
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 Dans le conteneur Mises en page source uniques, 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 le bouton Modifier.
4 Cliquez sur l’onglet Index. D&eacute;finition des propri&eacute;t&eacute;s :
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; Contr&ocirc;les HTML Help &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.
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; Contr&ocirc;les HTML Help &gt; Index.
Derni&egrave;re mise &agrave; jour le 16/3/2011
201
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
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.
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 Cliquez sur l’onglet Avanc&eacute;.
4 Dans le menu contextuel Fen&ecirc;tre, s&eacute;lectionnez une fen&ecirc;tre personnalis&eacute;e.
5 Dans le menu contextuel Cadre, s&eacute;lectionnez un cadre personnalis&eacute;.
6 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).
Voir aussi
&laquo; Lien vers des fen&ecirc;tres contextuelles &raquo; &agrave; la page 210
&laquo; Indexation automatique via l’assistant d’index dynamique &raquo; &agrave; la page 193
Glossaires
Cr&eacute;ation de termes de glossaire
1 Dans le conteneur Gestionnaire de projets, cliquez deux fois sur un glossaire dans le dossier Glossaire.
2 Dans le conteneur Glossaire, saisissez un terme dans la zone Terme.
3 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.
4 Dans le volet D&eacute;finition de, saisissez une d&eacute;finition.
Derni&egrave;re mise &agrave; jour le 16/3/2011
202
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
Vous ne pouvez pas utiliser de texte format&eacute;, d’onglets ou de retours.
Ajoutez des zones cliquables de glossaire &agrave; d&eacute;velopper pour que les termes et d&eacute;finitions s’affichent dans les
rubriques.
5 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; prenant 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
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 Fichier &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 V&eacute;rifiez que le conteneur Glossaire est activ&eacute;.
2 G&eacute;n&eacute;rez une mise en page.
3 Cliquez sur Afficher le r&eacute;sultat.
4 Cliquez sur Glossaire.
5 S&eacute;lectionnez les termes et affichez leurs d&eacute;finitions.
Impression de glossaire
1 Cliquez sur le conteneur Glossaire.
2 Sur la barre d’outils, cliquez sur Imprimer.
3 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 Cliquez sur Propri&eacute;t&eacute;s, puis sur Configuration de la page pour sp&eacute;cifier les options d’impression.
Derni&egrave;re mise &agrave; jour le 16/3/2011
203
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
5 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.
Voir aussi
&laquo; Zones cliquables de glossaire &raquo; &agrave; la page 204
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.
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 Saisissez un nom dans la zone de texte.
3 (Facultatif) Pour copier un glossaire existant, s&eacute;lectionnez Copier un glossaire existant. Cliquez sur le bouton
Parcourir
pour acc&eacute;der au glossaire.
Cliquez sur le bouton Assistant de cr&eacute;ation de zones cliquables de glossaire
termes de glossaire existants dans les rubriques.
de la barre d’outils pour marquer les
Fusion de glossaires
1
Dans le conteneur Gestionnaire de projets, ouvrez le dossier Glossaire.
2 Cliquez deux fois sur un glossaire.
3 Cliquez sur le bouton Importer un glossaire
4 Cliquez sur le bouton Dossier
.
. S&eacute;lectionnez le glossaire &agrave; fusionner. Cliquez sur Ouvrir.
5 Si n&eacute;cessaire, d&eacute;s&eacute;lectionnez Remplacer des d&eacute;finitions existantes du glossaire.
Derni&egrave;re mise &agrave; jour le 16/3/2011
204
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
S&eacute;lectionnez cette option pour remplacer les d&eacute;finitions existantes du glossaire par les d&eacute;finitions du glossaire
fusionn&eacute;.
6 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.
7 Cliquez sur OK.
Les termes fusionn&eacute;s s’affichent dans le conteneur Glossaire.
Voir aussi
&laquo; Zones cliquables de glossaire &raquo; &agrave; la page 204
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).
Ajout de zones cliquables de glossaire &agrave; d&eacute;velopper
❖ 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
.
205
UTILISATION DE ROBOHELP HTML 9
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 Outils &gt; 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 Cliquez sur Suivant.
S&eacute;lectionnez un terme &agrave; marquer dans un chapitre.
4 Pour assigner la nouvelle d&eacute;finition au terme, cochez la case en regard du terme qui ne correspond pas.
5 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.
6 Cliquez sur Terminer.
Test des zones cliquables de glossaire &agrave; d&eacute;velopper
1 Dans le conteneur Liste des rubriques, cliquez avec le bouton droit de la souris sur la rubrique contenant la zone
cliquable.
2 Cliquez sur Afficher.
3 Cliquez sur le terme de glossaire dans la rubrique.
4 Cliquez &agrave; nouveau sur le terme pour fermer la zone cliquable.
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 S&eacute;lectionnez Outils &gt; Assistant de cr&eacute;ation de zones cliquables de glossaire.
2 S&eacute;lectionnez Confirmer l’ajout de d&eacute;finitions pour chaque rubrique.
3 S&eacute;lectionnez un dossier et un &eacute;tat dans lesquels faire des recherches.
4 Dans le menu S&eacute;lectionner un terme, s&eacute;lectionnez le terme &agrave; supprimer.
5 Cliquez sur Suivant.
Derni&egrave;re mise &agrave; jour le 16/3/2011
206
UTILISATION DE ROBOHELP HTML 9
Tables des mati&egrave;res, index et glossaires
6 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.
7 Cliquez sur Terminer.
Annulation du marquage des zones cliquables dans la vue Conception
1 Ouvrez la rubrique dans l’onglet Conception. S&eacute;lectionnez le terme.
2 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
207
Chapitre 8 : Liens et navigation
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).
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
208
UTILISATION DE ROBOHELP HTML 9
Liens et navigation
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.
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'habillage
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 type 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.
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; MultiCusine &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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
209
UTILISATION DE ROBOHELP HTML 9
Liens et navigation
Ajout de chemins de navigation aux rubriques
1 S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Mises en page source unique.
2 Double-cliquez 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.
Voir aussi
&laquo; Insertion d’un espace r&eacute;serv&eacute; &raquo; &agrave; la page 127
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 Dans l’&eacute;diteur de conception, s&eacute;lectionnez le point d’insertion du lien.
2 Cliquez sur le bouton Ins&eacute;rer un hyperlien
.
3 S&eacute;lectionnez une option dans le menu Lien vers. Dans le champ, sp&eacute;cifiez l’emplacement source.
4 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
210
UTILISATION DE ROBOHELP HTML 9
Liens et navigation
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 Ajoutez du texte d’aide &agrave; l’&eacute;cran devant appara&icirc;tre lorsque vous placez la souris sur le lien.
6 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 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.
2 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;).
3 Recherchez et s&eacute;lectionnez l’&eacute;l&eacute;ment de destination.
4 (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.
5 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.
Voir aussi
&laquo; Mappages d’image &raquo; &agrave; la page 231
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.
5 Sous S&eacute;lectionner une destination (fichier ou URL), s&eacute;lectionnez une rubrique
cadres.
Derni&egrave;re mise &agrave; jour le 16/3/2011
, un signet
ou un jeu de
211
UTILISATION DE ROBOHELP HTML 9
Liens et navigation
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 Cr&eacute;ez un mini-projet HTML Help avec des rubriques contextuelles.
2 G&eacute;n&eacute;rez le projet pour cr&eacute;er un fichier CHM.
3 Liez-le aux rubriques contextuelles dans le second fichier CHM. (Ne fusionnez pas les deux syst&egrave;mes d’aide.)
4 Distribuez les deux fichiers CHM aux utilisateurs.
Voir aussi
&laquo; Fen&ecirc;tres contextuelles purement textuelles &raquo; &agrave; la page 222
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 Cliquez &agrave; gauche de l’emplacement du signet.
2 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; 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 Ouvrez la destination du lien. Pour cr&eacute;er un lien au sein d’une rubrique, cr&eacute;ez un signet dans la rubrique.
2 Dans l’&eacute;diteur de conception, s&eacute;lectionnez l’emplacement du lien, puis cliquez sur le bouton Ins&eacute;rer un hyperlien
.
3 Sous S&eacute;lectionner une destination (fichier ou URL), s&eacute;lectionnez le signet vers lequel le lien doit renvoyer.
4 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 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].
2 Modifiez le nom et cliquez sur OK.
Derni&egrave;re mise &agrave; jour le 16/3/2011
212
UTILISATION DE ROBOHELP HTML 9
Liens et navigation
3 Annulez l’assignation de l’ID de mappage du signet renomm&eacute; et r&eacute;attribuez-le.
4 Si le signet est utilis&eacute; dans une aide contextuelle, modifiez l’ID de mappage.
Acc&egrave;s &agrave; un signet
1 Ouvrez une rubrique dans l’&eacute;diteur de conception.
2 S&eacute;lectionnez Modifier &gt; Acc&eacute;der au signet.
3 S&eacute;lectionnez un signet auquel acc&eacute;der.
4 Cliquez sur Aller &agrave;.
Suppression d’un signet
1 Supprimez tous les liens renvoyant vers le signet.
2 Dans la rubrique, s&eacute;lectionnez l’ic&ocirc;ne de signet. Sur la barre d’outils, cliquez sur le bouton Supprimer.
Voir aussi
&laquo; Modification d’un ID de mappage &raquo; &agrave; la page 252
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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
213
UTILISATION DE ROBOHELP HTML 9
Liens et navigation
Liens externes
Lien vers des rubriques externes (projets Microsoft HTML Help)
1 Dans l’&eacute;diteur de conception, s&eacute;lectionnez l’emplacement du lien.
2 Cliquez sur le bouton Ins&eacute;rer un hyperlien
3 Dans Lien vers, cliquez sur le triangle
.
et s&eacute;lectionnez Rubrique distante.
Lien vers des fichiers externes
1 Choisissez l’emplacement du lien dans l’&eacute;diteur de conception.
2 Saisissez du texte.
3 Mettez ce texte en surbrillance et cliquez sur le bouton Ins&eacute;rer un hyperlien
4 Cliquez sur le triangle
.
en regard de Lien vers et s&eacute;lectionnez Fichier.
5 Recherchez un fichier, ouvrez-le et copiez-le dans le dossier de votre projet.
6 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; Contr&ocirc;les HTML Help &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.
Lien vers des adresses &eacute;lectroniques, sites FTP, groupes de discussion et
adresses Web
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’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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
214
UTILISATION DE ROBOHELP HTML 9
Liens et navigation
• Adresse Web pour lier vers des sites intranet ou Web.
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 Afficher &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 Afficher &gt; Conteneurs &gt; Gestionnaire
de projets.
• Pour afficher les rubriques dans le module de composition de table des mati&egrave;res, s&eacute;lectionnez Afficher &gt;
Conteneurs &gt; Table des mati&egrave;res.
• Pour afficher les rubriques dans le concepteur d’index, s&eacute;lectionnez Afficher &gt; Conteneurs &gt; Index.
3 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.
4 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 S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Affichage des liens.
2 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.
D&eacute;finition des options de d&eacute;filement de la fen&ecirc;tre d’affichage des liens
1 S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Affichage des liens.
2 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
Derni&egrave;re mise &agrave; jour le 16/3/2011
.
.
215
UTILISATION DE ROBOHELP HTML 9
Liens et navigation
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.
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.
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.
❖ 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. BugHunter est disponible avec Adobe RoboHelp.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
216
UTILISATION DE ROBOHELP HTML 9
Liens et navigation
R&eacute;paration de liens rompus
❖ S&eacute;lectionnez Outils &gt; R&eacute;parer les liens rompus &gt; R&eacute;f&eacute;rences &agrave; la rubrique s&eacute;lectionn&eacute;e.
• 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.
Identification et mise &agrave; jour des r&eacute;f&eacute;rences de rubrique
Identification des r&eacute;f&eacute;rences aux rubriques
1 S&eacute;lectionnez Outils &gt; Modifier les r&eacute;f&eacute;rences des rubriques.
2 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 aux rubriques
❖ S&eacute;lectionnez Outils &gt; Modifier les r&eacute;f&eacute;rences des 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.
• Pour r&eacute;parer ou supprimer des entr&eacute;es et &eacute;l&eacute;ments de table des mati&egrave;res, s&eacute;lectionnez un &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.
Voir aussi
&laquo; Modification d’un mappage d’image &raquo; &agrave; la page 231
Identification et mise &agrave; jour des r&eacute;f&eacute;rences de rubriques externes
1 S&eacute;lectionnez Outils &gt; Modifier les r&eacute;f&eacute;rences de rubriques externes.
2 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
217
UTILISATION DE ROBOHELP HTML 9
Liens et navigation
• 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.
Voir aussi
&laquo; R&eacute;paration de liens rompus &raquo; &agrave; la page 216
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 Afficher &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 S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Liste des rubriques. Le conteneur Liste des rubriques s’affiche.
2 Cliquez avec le bouton droit de la souris sur la rubrique et s&eacute;lectionnez Afficher.
3 Cliquez sur les liens pour les tester.
Voir aussi
&laquo; S&eacute;quences de navigation &raquo; &agrave; la page 225
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
218
UTILISATION DE ROBOHELP HTML 9
Liens et navigation
• 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.
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.
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
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
219
UTILISATION DE ROBOHELP HTML 9
Liens et navigation
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.
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
Derni&egrave;re mise &agrave; jour le 16/3/2011
220
UTILISATION DE ROBOHELP HTML 9
Liens et navigation
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.
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 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 aussi
. 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.
2 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
et cliquez sur Ajouter.
, puis sur l’onglet Voir aussi. Saisissez le nom du mot-cl&eacute; &agrave; assigner
3 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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
221
UTILISATION DE ROBOHELP HTML 9
Liens et navigation
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.
❖ 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.
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 Cr&eacute;ez des mots-cl&eacute;s Voir aussi.
2 Dans l’&eacute;diteur de conception, placez le curseur &agrave; l’endroit de la rubrique o&ugrave; vous souhaitez ajouter le contr&ocirc;le.
3 Dans la barre d’outils, cliquez sur l’ic&ocirc;ne Ins&eacute;rer une commande de navigation
.
4 S&eacute;lectionnez Voir aussi.
5 D&eacute;finissez les options de lien.
6 Dans la zone Mots-cl&eacute;s Voir aussi du projet, s&eacute;lectionnez un mot-cl&eacute; Voir aussi.
7 Cliquez sur Ajouter. R&eacute;p&eacute;tez cette proc&eacute;dure pour ajouter d’autres mots-cl&eacute;s. Cliquez sur Suivant.
8 S&eacute;lectionnez les options d’affichage et de police.
9 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
❖ 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
Derni&egrave;re mise &agrave; jour le 16/3/2011
.
222
UTILISATION DE ROBOHELP HTML 9
Liens et navigation
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.
Voir aussi
&laquo; Lien vers des fen&ecirc;tres contextuelles &raquo; &agrave; la page 210
Cr&eacute;ation de fen&ecirc;tres contextuelles purement textuelles
1 Dans l'&eacute;diteur de conception, s&eacute;lectionnez du texte.
2 Dans le menu Ins&eacute;rer, s&eacute;lectionnez Fen&ecirc;tre contextuelle purement textuelle.
3 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
et s&eacute;lectionnez la fen&ecirc;tre contextuelle purement textuelle.
Suppression des fen&ecirc;tres contextuelles purement textuelles
❖ 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 Dans l’&eacute;diteur de conception, ouvrez la rubrique contenant la fen&ecirc;tre contextuelle purement textuelle.
2 Cliquez sur le bouton Afficher
.
3 Cliquez sur la fen&ecirc;tre contextuelle purement textuelle.
Test apr&egrave;s g&eacute;n&eacute;ration
1 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.
2 Acc&eacute;dez &agrave; la rubrique contenant la fen&ecirc;tre contextuelle purement textuelle.
3 Cliquez sur la fen&ecirc;tre contextuelle purement textuelle.
Derni&egrave;re mise &agrave; jour le 16/3/2011
223
UTILISATION DE ROBOHELP HTML 9
Liens et navigation
Principes de base de la recherche RoboHelp
Lorsque vous saisissez un terme &agrave; rechercher dans la zone Rechercher, RoboHelp affiche la liste des rubriques le
contenant. Cette liste indique parfois le contexte, en fonction du type de r&eacute;sultat. Lorsque vous affichez la rubrique,
RoboHelp met en surbrillance le terme recherch&eacute;. La recherche RoboHelp prend en charge les fonctionnalit&eacute;s
suivantes :
Mots-cl&eacute;s Vous pouvez attribuer un mot-cl&eacute; &agrave; une rubrique qui ne contient pas le mot recherch&eacute;. Par exemple, vous
pouvez attribuer le mot-cl&eacute; &laquo; mise en forme &raquo; &agrave; une rubrique portant sur les polices, les styles et les tailles en points. Si
vous saisissez 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.
Remarque : La recherche par mot-cl&eacute; n'est pas disponible dans Microsoft HTML Help (CHM).
Synonymes La d&eacute;finition de synonymes vous permet de 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.
Exclusion de rubriques de la recherche Vous pouvez exclure des rubriques compl&egrave;tes de la recherche en s&eacute;lectionnant
l'option Exclure de la recherche dans les propri&eacute;t&eacute;s de rubrique.
Remarque : Exclure de la recherche n'est pas disponible dans Microsoft HTML Help (CHM).
Exclusion 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
Exclusion des 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.
Recherche multilingue La recherche RoboHelp prend en charge plusieurs langues dans les projets, les rubriques et les
paragraphes. Par exemple, supposons que vous recherchiez 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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
224
UTILISATION DE ROBOHELP HTML 9
Liens et navigation
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, saisissez-la 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;.
Op&eacute;rateurs bool&eacute;ens dans la recherche (WebHelp) Vous pouvez 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.
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.
Contexte de rubrique dans la liste de 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.
Recherche dans les fichiers Office et PDF (WebHelp/Pro, FlashHelp/Pro) Vous pouvez 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.
Classer les r&eacute;sultats de recherche Vous pouvez classer 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. 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.
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 &laquo; D&eacute;finition des options de g&eacute;n&eacute;ration de
WebHelp &raquo; &agrave; la page 321 et &laquo; D&eacute;finition des options de g&eacute;n&eacute;ration de WebHelp Pro ou FlashHelp Pro &raquo; &agrave; la page 328.
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 Dans le conteneur Configuration du projet, cliquez avec le bouton droit de la souris sur Recherche de contenu
externe.
Derni&egrave;re mise &agrave; jour le 16/3/2011
225
UTILISATION DE ROBOHELP HTML 9
Liens et navigation
2 Utilisez les options suivantes pour configurer et g&eacute;rer la recherche de contenu externe :
Modifier Cliquez sur Ajouter et indiquez une adresse URL, un titre, des termes &agrave; rechercher (s&eacute;par&eacute;s par une
virgule, un espace ou un point-virgule), ainsi qu’une description dans la rang&eacute;e modifiable. Cliquez sur Ajouter
pour ajouter une autre ligne. Cliquez sur Enregistrer pour enregistrer les entr&eacute;es du fichier SearchOptions.xml dans
le dossier du projet.
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.
Explorer Cliquez sur Explorer pour localiser le fichier SearchOptions.xml dans l’Explorateur Windows. Vous
pouvez ouvrir le fichier dans un &eacute;diteur de texte et apporter des modifications.
Activation de la recherche de contenu externe
Vous pouvez activer la recherche de contenu externe dans les fichiers SSL suivants :
• WebHelp
• FlashHelp
• Adobe AIR
• WebHelp Pro
• FlashHelp Pro
1 Dans le conteneur Mises en page source uniques, 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.
2 Selon la mise en page, effectuez l’une des op&eacute;rations suivantes :
• (Adobe AIR) Cliquez sur Afficher 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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
226
UTILISATION DE ROBOHELP HTML 9
Liens et 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 &laquo; Configuration de la mise en page Adobe
AIR &raquo; &agrave; la page 312 et &laquo; D&eacute;finition des options de g&eacute;n&eacute;ration de WebHelp &raquo; &agrave; la page 321.
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 Outils &gt; Editeur de s&eacute;quence 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.
Cr&eacute;ation manuelle de s&eacute;quences de navigation
1 S&eacute;lectionnez Outils &gt; Editeur de s&eacute;quence de navigation.
2 Cliquez sur Nouveau, puis sp&eacute;cifiez le nom de la s&eacute;quence de navigation.
3 Dans Rubriques disponibles, s&eacute;lectionnez le dossier contenant les rubriques que vous ajoutez.
4 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 S&eacute;lectionnez Outils &gt; Editeur de s&eacute;quence de navigation.
2 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
227
UTILISATION DE ROBOHELP HTML 9
Liens et navigation
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 Afficher &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
d’afficher les liens entrants et sortants de la rubrique.
, rel&acirc;chez le bouton de la souris afin
Si la rubrique appartient &agrave; une s&eacute;quence de navigation, les boutons Pr&eacute;c&eacute;dent
au-dessus et en dessous de la rubrique.
et Suivant
5 Cliquez sur les boutons Pr&eacute;c&eacute;dent et Suivant pour tester la s&eacute;quence de navigation.
Affichage des s&eacute;quences pour une rubrique
1 S&eacute;lectionnez une rubrique.
2 Cliquez sur le bouton Propri&eacute;t&eacute;s
.
3 Cliquez sur l’onglet Avanc&eacute;.
Test des s&eacute;quences de navigation dans un navigateur ou une vue
1 V&eacute;rifiez que les s&eacute;quences de navigation sont activ&eacute;es.
2 Cliquez sur le bouton G&eacute;n&eacute;rer
.
3 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 Ouvrez une rubrique dans l’&eacute;diteur de conception.
2 Cliquez sur le bouton Propri&eacute;t&eacute;s
.
3 Cliquez sur l’onglet Avanc&eacute;.
Derni&egrave;re mise &agrave; jour le 16/3/2011
s’affichent
228
Chapitre 9 : Multim&eacute;dia et effets sp&eacute;ciaux
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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
229
UTILISATION DE ROBOHELP HTML 9
Multim&eacute;dia et effets sp&eacute;ciaux
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 Dans le conteneur Bo&icirc;te &agrave; outils, cliquez deux fois sur le bouton Localisateur de graphiques
.
2 Dans la liste Fichiers image, s&eacute;lectionnez une image.
3 Acc&eacute;dez &agrave; l’emplacement de destination souhait&eacute;.
4 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 Outils &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.
Remarque : pour l’aide bas&eacute;e sur le Web, utilisez des fichiers GIF ou JPEG.
1 Dans l’&eacute;diteur de conception, s&eacute;lectionnez l’emplacement de l’image.
2 Dans la barre d’outils, cliquez sur le bouton Ins&eacute;rer une image
.
3 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
230
UTILISATION DE ROBOHELP HTML 9
Multim&eacute;dia et effets sp&eacute;ciaux
• 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.
Modification d’une image dans RoboHelp
1 Dans l’&eacute;diteur de conception, s&eacute;lectionnez l’image &agrave; modifier.
2 Proc&eacute;dez de l’une des fa&ccedil;ons suivantes :
• Sur la barre d’outils, cliquez sur le bouton Modifier l’image s&eacute;lectionn&eacute;e
.
• Choisissez la commande Modifier &gt; Modifier l’&eacute;l&eacute;ment.
• Dans le conteneur Gestionnaire de projets, cliquez avec le bouton droit de la souris sur le nom d’une image.
S&eacute;lectionnez Modifier.
3 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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
231
UTILISATION DE ROBOHELP HTML 9
Multim&eacute;dia et effets sp&eacute;ciaux
Bordures Cliquez pour ajouter une bordure &agrave; l’image et sp&eacute;cifier un style.
Modification d’une image avec RoboScreenCapture
1 Dans l’&eacute;diteur de conception, s&eacute;lectionnez l’image &agrave; modifier.
2 Proc&eacute;dez de l’une des fa&ccedil;ons suivantes :
• S&eacute;lectionnez Modifier &gt; Modifier avec RoboScreenCapture.
• Cliquez avec le bouton droit de la souris et s&eacute;lectionnez l’option Modifier avec RoboScreenCapture.
• Cliquez sur le bouton Modifier avec RoboScreenCapture
dans la barre d’outils Objets.
3 Modifiez l’image.
4 Cliquez sur Enregistrer.
Remarque : Pour plus de d&eacute;tails, reportez-vous &agrave; l'aide de RoboScreenCapture.
Mappages d’image
Cr&eacute;ation d’une carte-image
1 Dans l’&eacute;diteur de conception, ouvrez une rubrique contenant une image.
2 Cliquez avec le bouton droit de la souris sur l’image. S&eacute;lectionnez Ins&eacute;rer un mappage de l’image.
3 S&eacute;lectionnez Rectangle, Cercle ou Polygone.
Le curseur se transforme en curseur &agrave; r&eacute;ticule
4 Tracez une zone cliquable &agrave; l’int&eacute;rieur de l’image.
5 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.
6 Dans Texte de l’info-bulle, saisissez le texte &agrave; afficher lorsque l’utilisateur passe la souris sur le mappage d’image.
7 Cliquez sur OK.
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
.
8 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 Dans l’&eacute;diteur de conception, ouvrez la rubrique contenant le mappage d’image.
2 Cliquez deux fois sur la zone cliquable.
3 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.
4 Cliquez sur OK. Si une invite s’affiche, s&eacute;lectionnez OK pour copier le fichier dans le projet.
5 Pour tester l’op&eacute;ration, cliquez sur le bouton Afficher
sur la barre d’outils. Cliquez sur la zone cliquable.
Derni&egrave;re mise &agrave; jour le 16/3/2011
232
UTILISATION DE ROBOHELP HTML 9
Multim&eacute;dia et effets sp&eacute;ciaux
Voir aussi
&laquo; Cr&eacute;ation de liens de texte &raquo; &agrave; la page 209
&laquo; Lien vers des fen&ecirc;tres contextuelles &raquo; &agrave; la page 210
D&eacute;monstrations Adobe Captivate
Suivez ces proc&eacute;dures pour lancer Adobe Captivate afin de cr&eacute;er des d&eacute;monstrations et les ins&eacute;rer dans le projet. Apr&egrave;s
avoir ins&eacute;r&eacute; un fichier SWF Adobe Captivate, vous pouvez mettre &agrave; jour le fichier SWF en ouvrant la source dans
RoboHelp.
Cr&eacute;ation d’une d&eacute;monstration Adobe Captivate
1 Cliquez sur l’onglet du gestionnaire de projets. Placez le curseur sur le dossier.
2 Choisissez la commande Fichier &gt; Nouveau, puis l’option D&eacute;monstration Adobe Captivate.
3 Dans la zone Titre de la rubrique, indiquez un nom pour la rubrique h&ocirc;te.
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.
7 Enregistrez la d&eacute;monstration et fermez Captivate.
8 Pour tester la d&eacute;monstration, s&eacute;lectionnez ou ouvrez la rubrique h&ocirc;te et cliquez sur Afficher
.
9 Ouvrez la rubrique h&ocirc;te 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 ne pouvez pas acc&eacute;der &agrave; RoboHelp lorsqu’Adobe Captivate est ouvert.
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 n’est 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.
4 Cliquez sur OK. Un objet de la rubrique indique l’emplacement du fichier.
5 Pour tester la d&eacute;monstration, cliquez sur Afficher
.
Derni&egrave;re mise &agrave; jour le 16/3/2011
233
UTILISATION DE ROBOHELP HTML 9
Multim&eacute;dia et effets sp&eacute;ciaux
Modification d’une d&eacute;monstration Adobe Captivate
1 Ouvrez la rubrique contenant la d&eacute;monstration Adobe Captivate ou d&eacute;veloppez le dossier Multim&eacute;dia dans le
gestionnaire de projets.
2 Cliquez avec le bouton droit de la souris sur la d&eacute;monstration. S&eacute;lectionnez l’option Modifier.
3 Effectuez vos modifications.
4 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.
Multim&eacute;dia
Ajout d’&eacute;l&eacute;ments multim&eacute;dia
1 S&eacute;lectionnez l’emplacement du contenu audio ou vid&eacute;o. Un objet ou une image indique l’emplacement de l’&eacute;l&eacute;ment
multim&eacute;dia.
2 S&eacute;lectionnez Ins&eacute;rer &gt; Multim&eacute;dia/D&eacute;monstration.
• 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.
3 D&eacute;finissez les options suivantes :
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.
4 Cliquez sur OK.
5 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.
6 Pour tester l’op&eacute;ration, cliquez sur le bouton Afficher
sur la barre d’outils.
Remarque : certains formats de fichier ne fonctionnent pas correctement dans les fichiers d’aide Microsoft HTML Help
compil&eacute;s.
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 MPEG : *.mpg, *.mpeg, *.mpg4, *.mpe
• Fichiers Windows Media : *.avi, *.asf, *.asx, *.wma, *.wmv, *.wax, *.wvx
• Fichiers Quick Time : *.qt, *.mov
• Fichiers Real : *.ra, *.rm, *.rpm
• Fichiers audio : *.asf, *.asx, *.mp3, *.mp4, *.wav, *.au, *.mid, *.rmi, *.ra, *.rm, *.wma, *.wax
• Fichiers Flash : *.swf
Derni&egrave;re mise &agrave; jour le 16/3/2011
234
UTILISATION DE ROBOHELP HTML 9
Multim&eacute;dia et effets sp&eacute;ciaux
• 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.
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 Cliquez deux fois sur l’objet multim&eacute;dia. La bo&icirc;te de dialogue Multim&eacute;dia s’affiche.
2 Effectuez vos modifications.
3 Cliquez sur OK.
4 Pour tester l’op&eacute;ration, cliquez sur le bouton Afficher
sur la barre d’outils.
Suppression d’&eacute;l&eacute;ments multim&eacute;dia des rubriques
1 Cliquez sur l’objet multim&eacute;dia pour le s&eacute;lectionner.
2 Cliquez sur le bouton Supprimer.
Cliquez sur Annuler
.
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.
Voir aussi
&laquo; Conformit&eacute; W3C &raquo; &agrave; la page 143
Derni&egrave;re mise &agrave; jour le 16/3/2011
235
UTILISATION DE ROBOHELP HTML 9
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 S&eacute;lectionnez DHTML &gt; Ins&eacute;rer/Modifier des effets HTML dynamiques.
3 Dans la liste Quand, s&eacute;lectionnez l’&eacute;v&eacute;nement qui d&eacute;clenche l’effet.
4 Dans la liste Quoi, s&eacute;lectionnez l’effet &agrave; appliquer.
5 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
.
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 Dans la rubrique, cliquez sur l’emplacement souhait&eacute; pour la zone de texte.
2 S&eacute;lectionnez Ins&eacute;rer &gt; HTML &gt; Zone de texte.
3 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.
4 Saisissez le texte dans la zone.
5 Cliquez sur la zone pour la s&eacute;lectionner.
6 S&eacute;lectionnez DHTML &gt; Ins&eacute;rer/Modifier des effets HTML dynamiques.
7 Dans la liste Quand, s&eacute;lectionnez l’&eacute;v&eacute;nement qui d&eacute;clenche l’effet.
8 Dans la liste Quoi, s&eacute;lectionnez l’effet &agrave; appliquer.
9 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; Mettre &agrave; jour les effets DHTML dans les rubriques.
Modification ou suppression d’effets DHTML
1 Ouvrez la rubrique dans l’&eacute;diteur de conception.
Derni&egrave;re mise &agrave; jour le 16/3/2011
236
UTILISATION DE ROBOHELP HTML 9
Multim&eacute;dia et effets sp&eacute;ciaux
2 Proc&eacute;dez de l’une des fa&ccedil;ons suivantes :
• S&eacute;lectionnez la rubrique contenant l’effet &agrave; modifier. S&eacute;lectionnez DHTML &gt; Ins&eacute;rer/Modifier des effets HTML
dynamiques.
• S&eacute;lectionnez l’&eacute;l&eacute;ment dont vous souhaitez supprimer l’effet et, dans le menu DHTML, s&eacute;lectionnez Supprimer
les effets HTML dynamiques.
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 CBTs.
Voir aussi
&laquo; Application de balises de construction conditionnelles au contenu &raquo; &agrave; la page 243
&laquo; G&eacute;n&eacute;ration d’une sortie dans le format ePub &raquo; &agrave; la page 335
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 Ouvrez la rubrique dans l’onglet Conception. S&eacute;lectionnez le texte que vous souhaitez utiliser en tant que zone
cliquable.
2 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 DHTML &gt; Cr&eacute;er une zone cliquable &agrave; d&eacute;velopper et
un 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 DHTML &gt; Cr&eacute;er une zone cliquable d&eacute;roulante et un
texte. Saisissez le texte ou les images dans la liste d&eacute;roulante. Cliquez en dehors de l’&eacute;diteur de texte d&eacute;roulant.
3 Cliquez sur le bouton Afficher
pour tester le r&eacute;sultat.
Formatez les zones cliquables DHTML diff&eacute;remment du texte qui les entoure pour qu’elles soient visibles par le
lecteur.
Suppression de zones cliquables
Remarque : le contenu de la zone cliquable est &eacute;galement supprim&eacute;.
❖ 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
237
UTILISATION DE ROBOHELP HTML 9
Multim&eacute;dia et effets sp&eacute;ciaux
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 Format &gt; Styles.
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 Sous Styles, s&eacute;lectionnez le style de la zone cliquable &agrave; modifier.
4 Cliquez sur Modifier.
5 Cliquez sur Format et s&eacute;lectionnez les attributs &agrave; modifier.
6 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.
El&eacute;ment sur lequel les utilisateurs cliquent (d&eacute;clencheur).
Exemple de d&eacute;clencheurs et de cibles images
Affectation d’un d&eacute;clencheur &agrave; du texte ou &agrave; une image
1 S&eacute;lectionnez l’&eacute;l&eacute;ment texte ou image auquel vous souhaitez affecter le d&eacute;clencheur.
2 S&eacute;lectionnez DHTML &gt; Utiliser comme d&eacute;clencheur. Une ic&ocirc;ne repr&eacute;sentant un enrouleur de c&acirc;bles
s’affiche.
Des hachures couvrent le texte.
3 Associez le d&eacute;clencheur &agrave; une image ou &agrave; du texte.
Association de d&eacute;clencheurs &agrave; du texte
1 S&eacute;lectionnez le texte que vous souhaitez utiliser en tant que cible.
2 S&eacute;lectionnez DHTML &gt; Ins&eacute;rer/Modifier des effets HTML dynamiques.
3 Sous Quand, s&eacute;lectionnez Activation du 1er d&eacute;clencheur.
4 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.
5 S&eacute;lectionnez Activation du 2&egrave;me d&eacute;clencheur et d&eacute;finissez ses propri&eacute;t&eacute;s.
Derni&egrave;re mise &agrave; jour le 16/3/2011
238
UTILISATION DE ROBOHELP HTML 9
Multim&eacute;dia et effets sp&eacute;ciaux
6 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.
7 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 Cliquez sur l’image du d&eacute;clencheur pour afficher l’ic&ocirc;ne repr&eacute;sentant un enrouleur de c&acirc;bles vert
.
2 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.
3 S&eacute;lectionnez un effet DHTML dans le menu.
4 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.
5 Dans le menu, s&eacute;lectionnez l’effet DHTML &agrave; appliquer &agrave; l’image cible.
Suppression de d&eacute;clencheurs
❖ 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.
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 S&eacute;lectionnez Ins&eacute;rer &gt; HTML &gt; Texte d&eacute;filant.
2 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
239
UTILISATION DE ROBOHELP HTML 9
Multim&eacute;dia et effets sp&eacute;ciaux
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.
• 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.
3 Cliquez sur le bouton Afficher
pour tester le r&eacute;sultat.
Suppression de texte d&eacute;filant
1 Placez le curseur sur la limite du texte d&eacute;filant.
2 Cliquez sur le bouton gauche de la souris.
3 Cliquez sur Supprimer
.
Commentaires HTML dans les rubriques
Insertion d’un commentaire HTML
1 Ouvrez une rubrique dans l’&eacute;diteur de conception.
2 Dans l’onglet Conception, ins&eacute;rez le curseur, puis choisissez la commande Ins&eacute;rer &gt; HTML &gt; Commentaires.
3 Dans l’&eacute;diteur de commentaires, indiquez votre commentaire en respectant le format suivant :
&lt;!--a comment --&gt;
4 Cliquez sur OK.
Affichage d’un commentaire HTML
1 Ouvrez une rubrique dans l’onglet Conception ou HTML.
2 Choisissez la commande Afficher &gt; Afficher &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.
3 (Onglet Conception) Survolez la l&eacute;gende &agrave; l’aide du curseur. Le commentaire appara&icirc;t dans une fen&ecirc;tre
contextuelle.
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 Choisissez la commande Ins&eacute;rer &gt; HTML &gt; IFrame.
2 Cliquez deux fois sur l'iFrame.
Derni&egrave;re mise &agrave; jour le 16/3/2011
240
UTILISATION DE ROBOHELP HTML 9
Multim&eacute;dia et effets sp&eacute;ciaux
3 Indiquez un nom. Cliquez sur le bouton Parcourir
pour s&eacute;lectionner une URL, un fichier HTML ou un
fichier PDF &agrave; lier.
4 (Facultatif) Cliquez sur l’onglet Bordure afin de d&eacute;finir les options de bordure.
5 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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
241
Chapitre 10 : Texte conditionnel
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 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.
2 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.
3 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.
4 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.
5 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
242
UTILISATION DE ROBOHELP HTML 9
Texte conditionnel
6 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.
7 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.
8 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.
9 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.
Voir aussi
&laquo; Aper&ccedil;u des zones de texte conditionnel &raquo; &agrave; la page 245
Flux de production de l’impl&eacute;mentation du texte conditionnel
1 Cr&eacute;ez une balise de construction conditionnelle.
2 Appliquez la balise &agrave; une combinaison de rubriques, de contenu de rubriques, de tables des mati&egrave;res et d’index.
3 D&eacute;finissez les balises &agrave; exclure et &agrave; inclure dans la sortie.
4 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.
5 G&eacute;n&eacute;rez le r&eacute;sultat.
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 (Result)
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
243
UTILISATION DE ROBOHELP HTML 9
Texte conditionnel
Balises de construction conditionnelles
Cr&eacute;ation d’une balise de construction conditionnelle
1 Ouvrez une rubrique dans l’&eacute;diteur de conception.
2 Choisissez la commande Format &gt; Appliquer une balise de construction conditionnelle &gt; Nouvelle/Plusieurs.
3 Cliquez sur Nouveau. Attribuez un nom &agrave; la balise.
4 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.
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.
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 du texte conditionnel, choisissez la commande Afficher &gt; Afficher &gt; 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.
❖ 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 S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Liste des rubriques. S&eacute;lectionnez la rubrique.
2 Cliquez sur Format &gt; Appliquer une balise de construction conditionnelle, puis s&eacute;lectionnez une balise.
Derni&egrave;re mise &agrave; jour le 16/3/2011
244
UTILISATION DE ROBOHELP HTML 9
Texte conditionnel
Application de balises de construction conditionnelles &agrave; plusieurs rubriques
1 S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Liste des rubriques.
2 S&eacute;lectionnez plusieurs rubriques.
3 Dans la barre d’outils Projet, cliquez sur l’ic&ocirc;ne Propri&eacute;t&eacute;s
, puis sur Avanc&eacute;.
4 Dans le conteneur Balises de construction conditionnelles, sous Balises de rubrique, s&eacute;lectionnez une balise.
Cliquez sur OK.
Application de balises de construction conditionnelles au contenu d’une rubrique
1 Ouvrez une rubrique dans l’&eacute;diteur de conception.
2 S&eacute;lectionnez le contenu de la rubrique.
3 Cliquez sur Format &gt; Appliquer une balise de construction conditionnelle.
4 S&eacute;lectionnez une balise, puis cliquez sur OK.
Application de plusieurs balises de construction conditionnelles au contenu d’une rubrique
1 Ouvrez une rubrique dans l’&eacute;diteur de conception.
2 S&eacute;lectionnez le contenu de la rubrique.
3 Cliquez sur Format &gt; Appliquer une balise de construction conditionnelle &gt; Nouvelle/Plusieurs.
4 S&eacute;lectionnez les balises ou cliquez sur V&eacute;rifier tout. Cliquez sur OK.
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 Cliquez sur Format &gt; Appliquer une balise de construction conditionnelle &gt; Nouvelle/Plusieurs.
3 S&eacute;lectionnez les balises ou cliquez sur V&eacute;rifier tout. Cliquez sur OK.
Application de balises de construction conditionnelles aux espaces r&eacute;serv&eacute;s
❖ 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 type, puis choisissez la commande Format &gt; Appliquer une
balise de construction conditionnelle &gt; [nouvelle balise].
• Cliquez avec le bouton droit de la souris sur un espace r&eacute;serv&eacute; plac&eacute; dans la page type, 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
245
UTILISATION DE ROBOHELP HTML 9
Texte conditionnel
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 Choisissez la commande 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.
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 des hachures 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 les hachures.
❖ Dans Afficher &gt; Afficher &gt; Zones conditionnelles, proc&eacute;dez de l’une des fa&ccedil;ons suivantes :
• Pour masquer le texte conditionnel, d&eacute;s&eacute;lectionnez l’option.
• Pour afficher le texte conditionnel, s&eacute;lectionnez l’option.
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 Cliquez sur Format &gt; Appliquer une balise de construction conditionnelle &gt; Nouvelle/Plusieurs.
3 D&eacute;s&eacute;lectionnez les balises ou cliquez sur Effacer tout. Cliquez ensuite sur OK.
4 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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
246
UTILISATION DE ROBOHELP HTML 9
Texte conditionnel
Modification du nom des balises de construction conditionnelles
1 Cliquez avec le bouton droit de la souris sur une balise dans le conteneur Balises de construction conditionnelles.
2 S&eacute;lectionnez Renommer, puis saisissez un nouveau nom dans la zone.
3 Appuyez sur Entr&eacute;e. Les rubriques qui utilisent cette balise sont mises &agrave; jour avec le nouveau nom.
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.
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 motscl&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.
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.
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.
1 Cr&eacute;ation d’une balise de construction conditionnelle. Appliquez-la au contenu de la rubrique ou aux rubriques
souhait&eacute;(es).
2 Dans le conteneur Mises en page source uniques, cliquez avec le bouton droit de la souris sur une mise en page et
choisissez la commande Propri&eacute;t&eacute;s.
3 Cliquez sur le bouton D&eacute;finir, puis d&eacute;finissez une expression &eacute;l&eacute;mentaire ou avanc&eacute;e.
4 Cliquez sur Enregistrer.
Suppression d’une expression de balise de construction conditionnelle
1 Dans le conteneur Mises en page source uniques, cliquez avec le bouton droit de la souris sur une mise en page et
choisissez la commande Propri&eacute;t&eacute;s.
2 Dans la liste Expression de construction conditionnelle, s&eacute;lectionnez Aucun. Cliquez ensuite sur Enregistrer.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
247
UTILISATION DE ROBOHELP HTML 9
Texte conditionnel
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
248
Chapitre 11 : Aide contextuelle
A 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.
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. 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
249
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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 Con&ccedil;oit les composants (fen&ecirc;tres, bo&icirc;tes de dialogue, champs,
l’application, comme les fen&ecirc;tres, les bo&icirc;tes de dialogue, les champs et commandes) de l’application.
les contr&ocirc;les.
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.
G&eacute;n&egrave;re les fichiers de mappage contenant les ID de mappage et les
transf&egrave;re &agrave; l’auteur.
ou
ou
Re&ccedil;oit les fichiers de mappage cr&eacute;&eacute;s par l’auteur et contenant les ID de
Cr&eacute;e les fichiers de mappage et assigne les ID de mappage aux
mappage.
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 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.
Dans 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
Fichiers de mappage et ID de mappage
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 :
Derni&egrave;re mise &agrave; jour le 16/3/2011
250
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
#define ID_SetupScreen 101
•
ID_SetupScreen correspond &agrave; l’ID de rubrique.
•
101 correspond au num&eacute;ro de mappage.
•
ID_SetupScreen 101 est 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.
• 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.
Reportez-vous &agrave; la section relative &agrave; la &laquo; Modification dynamique de rubriques d'aide contextuelle &raquo; &agrave; la page 255.
Le verrouillage d’un fichier de mappage permet de limiter son acc&egrave;s en lecture seule.
1 Ouvrez le conteneur Configuration du projet.
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 Fichier &gt; Importer &gt; Fichier de mappage.
• Cliquez sur le dossier de l’aide contextuelle dans le conteneur Configuration du projet.
Derni&egrave;re mise &agrave; jour le 16/3/2011
251
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
2 Acc&eacute;dez au fichier de mappage. Assurez-vous qu’il est d&eacute;verrouill&eacute;.
3 Cliquez deux fois sur le fichier de mappage pour l’ajouter au dossier Fichiers de mappage du projet.
Exportation d’un fichier de mappage
1 Dans le conteneur Configuration du projet, d&eacute;veloppez le dossier Aide contextuelle.
2 Cliquez avec le bouton droit de la souris sur le dossier Fichiers de mappage.
3 S&eacute;lectionnez Exporter les fichiers de mappage.
4 S&eacute;lectionnez les langages de programmation dans lesquels enregistrer les fichiers de mappage.
5 Choisissez l’emplacement du fichier de mappage. Cliquez sur OK.
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 Afficher &gt; Conteneurs &gt; Configuration du projet.
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 Configuration du projet.
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 du projet.
• Cliquez avec le bouton droit de la souris sur le dossier Fichiers de mappage.
• S&eacute;lectionnez Modifier.
Derni&egrave;re mise &agrave; jour le 16/3/2011
252
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
• Effectuez les op&eacute;rations suivantes :
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 Ouvrez le conteneur Configuration du projet.
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 dans lequel vous
souhaitez stocker l'ID de mappage.
6 Cliquez sur le bouton Cr&eacute;er/Modifier un ID de mappage
.
7 Dans ID de rubrique, saisissez le terme ou l’expression permettant d’identifier la rubrique.
8 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. Reportez-vous &agrave; la section &laquo; G&eacute;n&eacute;ration
automatique d’un ID de mappage &raquo; &agrave; la page 254
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 Configuration du projet.
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.
&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.
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.
Ic&ocirc;ne Fichier de mappage
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).
Derni&egrave;re mise &agrave; jour le 16/3/2011
253
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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;.
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.
Supprimer
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.
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
. S&eacute;lectionnez Tous les
dossiers, Dossier du niveau sup&eacute;rieur ou un dossier personnalis&eacute;.
• Ic&ocirc;ne Propri&eacute;t&eacute;s
• Ic&ocirc;ne Aper&ccedil;u
Permet d’afficher tous les ID de rubrique attribu&eacute;s &agrave; la rubrique.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
254
UTILISATION DE ROBOHELP HTML 9
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 Dans le conteneur Configuration du projet, d&eacute;veloppez le dossier Aide contextuelle.
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.
❖ 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 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 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.
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.
Reportez-vous &agrave; la section relative &agrave; la &laquo; Modification dynamique de rubriques d'aide contextuelle &raquo; &agrave; la page 255.
1 Ouvrez le conteneur Configuration du projet.
Derni&egrave;re mise &agrave; jour le 16/3/2011
255
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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 Ouvrez une rubrique.
2 Cliquez sur le bouton Propri&eacute;t&eacute;s
.
3 Cliquez sur l’onglet Avanc&eacute;.
4 Cliquez sur ID de mappage assign&eacute;s.
5 S&eacute;lectionnez l’ID de mappage dont vous souhaitez annuler l’attribution.
6 Cliquez sur Modifier les ID de mappage.
7 Cliquez sur Annuler l’assignation.
8 Cliquez sur Fermer.
9 G&eacute;n&eacute;rez le projet.
10 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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
256
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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 Ouvrez le projet d'aide de l'application dans RoboHelp.
2 Cliquez sur Fichier &gt; Aide contextuelle &gt; Ouvrir l'application.
3 Recherchez et s&eacute;lectionnez le fichier ex&eacute;cutable (.exe) pour l'application. Cliquez sur Ouvrir.
4 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.
5 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 Fichier &gt; Aide contextuelle &gt; Ouvrir l'application.
6 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.
• 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.
7 Cliquez sur OK.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
257
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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.
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 la fonction RH_ShowHelp avec le param&egrave;tre uCommand d&eacute;fini sur
HH_DISPLAY_INDEX, HH_DISPLAY_SEARCH ou HH_DISPLAY_TOC et le param&egrave;tre dwData d&eacute;fini sur 0.
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 :
Derni&egrave;re mise &agrave; jour le 16/3/2011
258
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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.
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.)
Voici un exemple de cette cha&icirc;ne : http://&lt;servername&gt;/robohelp/rest/search?project=&lt;projectname&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.
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 :
To open the topic mapped to number 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
Derni&egrave;re mise &agrave; jour le 16/3/2011
259
UTILISATION DE ROBOHELP HTML 9
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 hhctrl.lib &agrave; l’application. Recherchez la biblioth&egrave;que hhctrl.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 S&eacute;lectionnez Projet &gt; Param&egrave;tres.
2 S&eacute;lectionnez RoboHelp_csh.cpp.
3 Dans l’onglet C/C, d&eacute;finissez la cat&eacute;gorie sur En-t&ecirc;tes pr&eacute;compil&eacute;s.
4 S&eacute;lectionnez Sans utiliser les en-t&ecirc;tes pr&eacute;compil&eacute;s.
5 Cliquez sur OK.
Visual Studio .NET
1 Cliquez avec le bouton droit de la souris sur RoboHelp_Csh.Cpp, puis s&eacute;lectionnez Propri&eacute;t&eacute;s.
2 Dans le dossier C/C, s&eacute;lectionnez En-t&ecirc;tes pr&eacute;compil&eacute;s.
3 S&eacute;lectionnez Sans utiliser les en-t&ecirc;tes pr&eacute;compil&eacute;s.
Appels de la fonction &agrave; partir des applications Visual C++
Remarque : liez des rubriques d’aide contextuelle WebHelp, WebHelp Pro, FlashHelp, FlashHelp Pro ou HTML Help
aux 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)
Derni&egrave;re mise &agrave; jour le 16/3/2011
260
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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 de l’aide. Pour WebHelp/FlashHelp : &laquo;chemin d’acc&egrave;s &agrave; la page de
d&eacute;marrage &raquo;. Pour WebHelp Pro : &laquo; http://[NomServeur]/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.
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.
Pour 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 d&eacute;finissant dwData sur 0. 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);
Derni&egrave;re mise &agrave; jour le 16/3/2011
261
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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
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 contextuelle pour 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
262
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
Appel d’une fonction 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;nom_serveur&gt;/robohelp/rest/search?project=&lt;nom_projet&gt;&amp;quesn=&lt;requ&ecirc;te-recherche&gt;
pour obtenir l’URL correspondant &agrave; 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;windowname&gt;[&amp;area=&lt;area_of_p
ublishing&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 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.
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
hhctrl.lib &agrave; l’application. La biblioth&egrave;que hhctrl.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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
263
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
• 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;
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.)
Derni&egrave;re mise &agrave; jour le 16/3/2011
264
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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 :
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
265
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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
string
Source de l’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://[NomServeur]/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.
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 au langage (indiquez HH_HELP_CONTEXT
dans le param&egrave;tre uCommand).
Pour ouvrir le 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 dwData sur 0. 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 ont priorit&eacute; sur 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 contextuelle pour WebHelp, FlashHelp ou FlashHelp 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 &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.
2 Ex&eacute;cutez l’application et testez l’appel d’aide.
Appel d’une fonction contextuelle pour WebHelp Pro
1 Appelez la fonction.
Derni&egrave;re mise &agrave; jour le 16/3/2011
266
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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 Ouvrez les pages Web.
3 Liez les pages &agrave; RoboHelp_csh.js.
4 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)
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;;
strHelpOptions += &quot;,height=400&quot;;
function ShowHelp(strUrl)
{
window.open(strUrl, &quot;Help&quot;, strHelpOptions);
}
Pour utiliser ShowHelp, ins&eacute;rez le script ci-avant 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!
Derni&egrave;re mise &agrave; jour le 16/3/2011
267
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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 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.
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 vers la page de
d&eacute;marrage du projet&gt; &raquo; (peut &ecirc;tre local ou sur un serveur). Pour WebHelp
Pro : &laquo; http://[nom 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.
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.
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 d&eacute;finissant dwData
sur 0. 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
268
UTILISATION DE ROBOHELP HTML 9
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;Click for Help (map number 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 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.
2 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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
269
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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 9\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
Utilisez les exemples de code d’aide contextuelle fournis par Adobe.
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.
Appel d'aide contextuelle pour WebHelp ou FlashHelp depuis C# .NET
1 Ajoutez le fichier RoboHelp_CSH.cs au projet.
2 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
string
Source d’aide pour WebHelp ; indique le chemin d’acc&egrave;s &agrave; la page de d&eacute;marrage
du projet.
Derni&egrave;re mise &agrave; jour le 16/3/2011
270
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
Param&egrave;tre
Type de donn&eacute;es
Description
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 Ouvrez VisualStudio.
2 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 Ajoutez un bouton intitul&eacute; Aide.
4 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 .
5 Copiez le fichier RoboHelp_CSH.cs.
6 Collez les fichiers dans le projet C#.NET.
7 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.
8 Dans l’onglet .Net, s&eacute;lectionnez System.Web.Services.Dll.
9 Cliquez sur OK.
10 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.
11 S&eacute;lectionnez
c:\windows\system32\msxml2.dll
12 Cliquez sur OK.
13 Cliquez deux fois sur le bouton Aide.
14 Copiez l’exemple de code d’aide contextuelle C# .NET et collez-le dans le code.
15 Ajoutez le texte Utilisation de RoboHelpAPI dans la partie sup&eacute;rieure du document.
16 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 Ajoutez le fichier RoboHelp_CSH.cs au projet.
2 Appelez la fonction RH_ShowLocalHelp (hParent, strtHelpURL, strWndName, nCommand, nData).
Derni&egrave;re mise &agrave; jour le 16/3/2011
271
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
Param&egrave;tre
Type de donn&eacute;es
Description
hParent
Objet
Poign&eacute;e de la fen&ecirc;tre parent.
strHelpURL
string
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
utlisant OptionConstants.CSH_DISPLAY_CONTEXT dans nCommand.
Appel d’aide contextuelle pour WebHelp Pro ou FlashHelp Pro depuis ASP .NET
1 Ouvrez VisualStudio .NET.
2 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.
4 Copiez le fichier RoboHelp_CSH.cs.
5 Collez les fichiers de support dans le projet ASP.NET.
6 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.
7 Dans l’onglet .Net, s&eacute;lectionnez System.Web.Services.Dll.
8 Cliquez sur OK.
9 Ajoutez un bouton dans l’application.
10 Cliquez deux fois sur le bouton.
11 Copiez l’exemple de code d’aide contextuelle ASP.NET. Collez-le dans le code.
12 Dans le code, ajoutez le texte utilisation de l'API RoboHelp.
13 Pour tester l’aide, compilez et ex&eacute;cutez le projet. S&eacute;lectionnez le bouton Aide.
Appel d’aide contextuelle pour WebHelp ou FlashHelp depuis Visual Basic .NET
1 Ajoutez le fichier RoboHelp_CSH.vb au projet.
2 Appelez la fonction RH_ShowLocalHelp (hParent, strtHelpURL, strWndName, nCommand, nData).
Derni&egrave;re mise &agrave; jour le 16/3/2011
272
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
Param&egrave;tre
Type de donn&eacute;es
Description
hParent
Objet
Poign&eacute;e de la fen&ecirc;tre parent.
strHelpURL
string
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.
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 Ouvrez VisualStudio.NET.
2 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 Acc&eacute;dez aux fichiers d'aide contextuelle ASP .NET dans C:\Program Files\[dossier d'installation de
RoboHelp]\CSH API\VB.NET.
4 Copiez le fichier RoboHelp_CSH.vb.
5 Collez les fichiers de support dans le projet ASP.NET.
6 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.
7 Dans l’onglet .Net, s&eacute;lectionnez System.Web.Services.Dll.
8 Cliquez sur OK.
9 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.
10 S&eacute;lectionnez :
msxml2.dll
11 Cliquez sur OK.
12 Ajoutez un bouton dans l’application.
13 Cliquez deux fois sur le bouton.
14 Copiez l’exemple de code d’aide contextuelle Visual Basic .NET et collez-le dans le code.
15 Pour tester l’aide, compilez et ex&eacute;cutez le projet. S&eacute;lectionnez le bouton Aide.
Derni&egrave;re mise &agrave; jour le 16/3/2011
273
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
Recherche de RoboHelp Server avec les exemples .NET
1 S&eacute;lectionnez D&eacute;marrer &gt; Programmes &gt; Robohelp Office Pro For .Net Development Kit.
2 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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
274
UTILISATION DE ROBOHELP HTML 9
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
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 comme suit. Exemple :
Derni&egrave;re mise &agrave; jour le 16/3/2011
275
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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. l’exemple de
fonction suivant, ShowHelpContext, 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
..............................................................................................................................................
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 HH_GADGET_DIALOG As Integer = 1
Const HH_WHATSIT_DIALOG As Integer = 2
Const HH_WIDGET_DIALOG As Integer = 3
Const 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 sousdossier d’aide du dossier de l’application.
Derni&egrave;re mise &agrave; jour le 16/3/2011
276
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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;
}
.......................................................................................................................................
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. l’exemple de
fonction suivant, ShowHelpContext, 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);
}
...........................................................................................................................................
Derni&egrave;re mise &agrave; jour le 16/3/2011
277
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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.
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(), &quot;c:\path\helpfile.chm&quot;, 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(), &quot;c:\path\helpfile.chm&quot;, HH_DISPLAY_TOPIC, &quot;topicfile.htm&quot;);
Aide Qu’est-ce que c’est ? 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.
• Et si l'aide a &eacute;t&eacute; cr&eacute;&eacute;e dans Qu'est-ce que c'est ? Qu'est-ce que c'est ?, reportez-vous &agrave; la rubrique &laquo; Cr&eacute;ation d’aides
Qu’est-ce que c’est ? Aide &raquo; &agrave; la page 285.
Remarque : Pour plus d’informations, consultez la r&eacute;f&eacute;rence de l’API HTML &agrave; l’adresse suivante :
http://msdn.microsoft.com/fr-fr/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, reportez-vous &agrave; la section &laquo; WebHelp &raquo; &agrave; la page 274.
• JavaHelp permet d’afficher les rubriques d’aide contextuelle pour les applications Java. Pour plus d'informations,
reportez-vous &agrave; la rubrique &laquo; A propos de la cr&eacute;ation d'un syst&egrave;me d'aide contextuelle JavaHelp &raquo; &agrave; la page 279.
• 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, reportez-vous &agrave; la rubrique
&laquo; Cr&eacute;ation d’aide contextuelle Oracle Help &raquo; &agrave; la page 280.
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,
/*Window handle of program or dialog*/
&quot;CSHHelp.chm&quot;,
/*Name of the CHM file*/
HH_HELP_CONTEXT,
dwMapNumber);
/*Map number from map file*/
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
278
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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.
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 &quot;HH_HELP_CONTEXT&quot;
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
279
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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:\Nom Dossier\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.
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
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
280
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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;
}
}
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.
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 :
Derni&egrave;re mise &agrave; jour le 16/3/2011
281
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
java CSHDemo C:\myFiles\Sample.hs
Exemple d'application Java contextuelle
/*********************************************************************************
* Oracle Help Context-Sensitive Help Sample Application
*
* This application is intended to demonstrate a few methods for invoking
* context-sensitive Help with Oracle Help.
*
* USAGE: CSHSample &lt;full path to helpset file&gt;
*
*********************************************************************************/
import
import
import
import
import
oracle.help.Help;
oracle.help.CSHManager;
oracle.help.library.Book;
oracle.help.library.helpset.HelpSet;
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;full path to helpset file&gt;&quot;);
System.exit(1);
}
Book bookObj = null;
String filename = args[0];
// Expects filename format to be: &quot;file:/[&lt;drive&gt;:/]dir/&lt;helpset_file&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));
Derni&egrave;re mise &agrave; jour le 16/3/2011
282
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
}
catch (Exception e) {
System.err.println(&quot;CSHSample Error: &quot; + e.getMessage());
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);
setMenuBar(menubar);
Panel mainPanel = new Panel();
add(mainPanel, BorderLayout.CENTER);
Derni&egrave;re mise &agrave; jour le 16/3/2011
283
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
// 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) {
setVisible(false);
System.exit(0);
}
Derni&egrave;re mise &agrave; jour le 16/3/2011
284
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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.
Aide Qu’est-ce que c’est ?
A propos du module de composition d’aide Outil de composition d’aide
l’outil Composition&reg; 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.
Module de composition d’aide Aide 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
285
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
• 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.
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
Qu’est-ce que c’est ?.
• 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 Ouvrez le projet RoboHelp.
2 S&eacute;lectionnez Fichier &gt; Nouveau &gt; Projet d’aide Qu’est-ce que c’est ?.
3 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. Le module de composition d’aide 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 ?.
Derni&egrave;re mise &agrave; jour le 16/3/2011
286
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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.
Conseils :
• Pour travailler sur les rubriques d’aide Qu’est-ce que c’est ?, ouvrez le projet d’aide dans RoboHelp, puis l’aide
Qu’est-ce que c’est ?.
• 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 Qu’est-ce que c’est ?
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 fichiers de projet 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 Ouvrez le projet dans RoboHelp.
2 S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Configuration du projet.
3 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
Qu’est-ce que c’est ?.
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 Qu’est-ce que c’est ?.
Suppression de l’aide Qu’est-ce que c’est ? d’un projet
1 Ouvrez le projet HTML Help.
2 S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Configuration du projet. Le conteneur Configuration du projet s’affiche.
3 D&eacute;veloppez le dossier Aide contextuelle.
4 Ouvrez le dossier des rubriques textuelles.
Derni&egrave;re mise &agrave; jour le 16/3/2011
287
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
5 S&eacute;lectionnez le fichier Context.Txt (fichier d’aide Qu’est-ce que c’est ?).
6 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 de projet d’aide 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.
• Les rubriques d’aide 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.
3 S&eacute;lectionnez Outils &gt; Activer BugHunter.
4 D&eacute;marrez l’application et ouvrez une bo&icirc;te de dialogue &agrave; tester.
5 Cliquez sur l’ic&ocirc;ne repr&eacute;sentant un point d’interrogation
, puis sur un champ ou un contr&ocirc;le.
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.
Contr&ocirc;le 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.
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 Qu’est-ce que c’est ?
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
288
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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
Message d'erreur
La rubrique d’aide Qu’est-ce que c’est ? affich&eacute;e dans le champ ou contr&ocirc;le est incorrecte.
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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
289
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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 Qu’est-ce que c’est ?.
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.
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 Afficher &gt; Conteneurs &gt; Configuration du projet. Le conteneur Configuration du projet 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 ?.
Derni&egrave;re mise &agrave; jour le 16/3/2011
290
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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.
Exemple d’entr&eacute;es d’ID de rubrique
7 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.
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 S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Configuration du projet. Le conteneur Configuration du projet 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 une rubrique dans la liste des ID de rubrique.
5 Modifiez le texte dans le champ Texte de la rubrique.
6 Cliquez sur Ajouter/Mettre &agrave; jour.
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
Cette bo&icirc;te de dialogue permet &eacute;galement de modifier les num&eacute;ros de mappage.
Derni&egrave;re mise &agrave; jour le 16/3/2011
291
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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.
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 Afficher &gt; Conteneurs &gt; Configuration du projet. Le conteneur Configuration du projet 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 Afficher &gt; Conteneurs &gt; Configuration du projet. Le conteneur Configuration du projet 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
292
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
Des options suppl&eacute;mentaires peuvent &ecirc;tre disponibles pour les projets de contr&ocirc;le de version.
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 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=flashhelp
Pour WebHelp Pro, utilisez la syntaxe suivante :
http://RoboHelp Server/robohelp/server?project=MyProject&amp;area=area-name&amp;ver=1
• Pour une aide locale, cliquez sur le bouton Parcourir, puis s&eacute;lectionnez un fichier d’aide.
4 (Facultatif) Saisissez un nom de fen&ecirc;tre.
5 Cliquez sur l’ic&ocirc;ne de fichier de mappage
, puis s&eacute;lectionnez un fichier de mappage.
6 Cliquez sur le triangle et s&eacute;lectionnez un num&eacute;ro de mappage.
7 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.
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.
• 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 S&eacute;lectionnez Afficher &gt; Conteneurs &gt; BugHunter.
Derni&egrave;re mise &agrave; jour le 16/3/2011
293
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
2 Proc&eacute;dez de l’une des fa&ccedil;ons suivantes :
• Pour lancer la capture des donn&eacute;es, cliquez avec le bouton droit de la souris dans le volet et s&eacute;lectionnez 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, cliquez avec le bouton droit de la souris dans le volet et d&eacute;s&eacute;lectionnez
D&eacute;sactiver 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 (Project) Emplacement de l’application. Nom de fichier de l’aide HTML contenant la rubrique d’aide appel&eacute;e.
Fichier (File) 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)
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
❖ 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 S&eacute;lectionnez Outils &gt; Options. Cliquez sur l'onglet Bughunter.
2 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
294
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
• 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.
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).
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’ent&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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
295
UTILISATION DE ROBOHELP HTML 9
Aide contextuelle
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.
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.
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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
296
Chapitre 12 : G&eacute;n&eacute;ration de l’aide et de
documents imprim&eacute;s
El&eacute;ments de base source unique
A propos des mises en page source uniques
Les mises en page source uniques servent de mod&egrave;les pour diff&eacute;rentes versions de sortie de projet. RoboHelp fournit
des mises en page source uniques 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 uniques.
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.
Voir aussi
&laquo; Utilisation de types de mises en page &raquo; &agrave; la page 298
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 source uniques, 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 uniques.
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 source uniques
Cr&eacute;ation ou duplication de mises en page source uniques
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 uniques, 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 Dans la bo&icirc;te de dialogue Nom de la mise en page, indiquez un nom.
Derni&egrave;re mise &agrave; jour le 16/3/2011
.
297
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
3 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.
4 Cliquez sur OK.
5 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 uniques
1 Dans le conteneur Mises en page source uniques, cliquez sur la mise en page avec le bouton droit de la souris.
2 S&eacute;lectionnez Propri&eacute;t&eacute;s.
3 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.
Modification du nom d’une mise en page source unique
1 Dans le conteneur Mises en page source uniques, cliquez sur la mise en page avec le bouton droit de la souris.
2 S&eacute;lectionnez Renommer.
3 Indiquez un nom.
Voir aussi
&laquo; Utilisation de types de mises en page &raquo; &agrave; la page 298
&laquo; G&eacute;n&eacute;ration, affichage et publication d’une sortie &raquo; &agrave; la page 320
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 uniques, 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
Derni&egrave;re mise &agrave; jour le 16/3/2011
298
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
• 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.
Voir aussi
&laquo; G&eacute;n&eacute;ration de la sortie &raquo; &agrave; la page 321
Utilisation de types de mises en page
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.
Ce dernier inclut &eacute;galement des fonctions de fusion des projets clients et une API relative &agrave; l’aide contextuelle.
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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
299
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
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.
• 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;.
Derni&egrave;re mise &agrave; jour le 16/3/2011
300
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
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 nondisponibilit&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.
Voir aussi
&laquo; G&eacute;n&eacute;ration, affichage et publication d’une sortie &raquo; &agrave; la page 320
&laquo; Mise en page de Microsoft HTML Help &raquo; &agrave; la page 303
&laquo; Cr&eacute;ation d’habillages personnalis&eacute;s dans les projets WebHelp et WebHelp Pro &raquo; &agrave; la page 371
&laquo; Fusion de projets d’aide &raquo; &agrave; la page 43
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.
L'aide de RoboHelp Server fournit les avantages suivants :
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 du projet.
Derni&egrave;re mise &agrave; jour le 16/3/2011
301
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
A propos de RoboHelp Server
RoboHelp Server permet de cr&eacute;er, de publier et de mesurer des syst&egrave;mes d’aide en ligne. Il stocke des informations sur
la navigation et l’interaction des utilisateurs avec le syst&egrave;me d’aide, puis g&eacute;n&egrave;re des rapports. RoboHelp Server h&eacute;berge
et affiche tout contenu cr&eacute;&eacute; via RoboHelp.
Outil de cr&eacute;ation de contenu
RoboHelp HTML
Projet A
Projet B
Projet C
Base de
donn&eacute;es
RoboHelp Server
Rapports
MS Access
Oracle
MS SQL Server
Conteneur de servlets
Apache Tomcat
Serveur Web
Serveur HTTP IIS / Apache
Utilisateurs
Interaction de RoboHelp Server avec des composants de g&eacute;n&eacute;ration d’aide
Conversion de l’aide de l’ordinateur au format WebHelp Pro
1 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.
2 Recherchez le chemin ou l’emplacement de RoboHelp Server et indiquez-le dans le projet.
3 Ouvrez le projet dans RoboHelp. D&eacute;finissez WebHelp Pro en tant que format de sortie.
4 Connectez-vous au serveur en publiant les fichiers du projet.
5 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.
6 Affichez le r&eacute;sultat. Pour afficher les rapports, cliquez sur l’onglet Rapports d’utilisation dans la fen&ecirc;tre du
programme. Cliquez sur Se connecter maintenant.
Voir aussi
&laquo; Sp&eacute;cification de la mise en page principale &raquo; &agrave; la page 296
&laquo; Affichage de la sortie &raquo; &agrave; la page 338
&laquo; Publication d’une sortie &raquo; &agrave; la page 340
Mise en page FlashHelp
A propos de FlashHelp
FlashHelp permet de contourner les limitations li&eacute;es au format DHTML pour les navigateurs et les plates-formes, ainsi
que les probl&egrave;mes de pare-feu haute s&eacute;curit&eacute;. Pour afficher le syst&egrave;me d’aide, il suffit de disposer d’un navigateur Web
et de Flash Player 8 ou version ult&eacute;rieure. Presque tous les navigateurs incluent Flash Player.
Derni&egrave;re mise &agrave; jour le 16/3/2011
302
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Flash Player est gratuit et peut &ecirc;tre t&eacute;l&eacute;charg&eacute; &agrave; l’adresse www.adobe.com/go/getflashplayer_fr.
FlashHelp prend en charge la mise en page classique du syst&egrave;me d’aide, sur trois volets (barre d’outils sur la partie
sup&eacute;rieure, arborescence de navigation sur la gauche et contenu sur la droite). Il peut &eacute;galement g&eacute;n&eacute;rer des syst&egrave;mes
d’aide orient&eacute;s sur la verticale, qui prendront moins de place &agrave; l’&eacute;cran. Dans ce cas, l’arborescence de navigation est
plac&eacute;e au-dessus du contenu de l’aide.
FlashHelp se compose des couches suivantes :
Couche de pr&eacute;sentation Utilise Adobe Flash, car il est facile &agrave; configurer et ne tient pas compte de la plate-forme
utilis&eacute;e.
Couche de navigation Exploite les structures de donn&eacute;es XML afin de d&eacute;terminer et de contr&ocirc;ler divers &eacute;l&eacute;ments
(table des mati&egrave;res, index, glossaire, recherche de texte int&eacute;gral, etc.).
Couche de contenu Utilise le langage HTML et les technologies associ&eacute;es pour rendre le contenu, de la mani&egrave;re la plus
fid&egrave;le possible.
Un habillage est requis pour la sortie FlashHelp. Utilisez l’habillage RoboHelp par d&eacute;faut, choisissez-en un dans la
galerie ou cr&eacute;ez-en un via le kit de d&eacute;veloppement d’habillages SDK (Skin Development Kit) fourni avec Robohelp.
Voir aussi
&laquo; Habillages &raquo; &agrave; la page 368
Fichiers source du projet pour FlashHelp
Remarque : lorsque vous distribuez les syst&egrave;mes d’aide HTML, incluez le fichier CHM et tous les fichiers CHM
secondaires, les fichiers HLP et les fichiers CNT li&eacute;s.
Fichiers source du projet (g&eacute;n&eacute;r&eacute;s &agrave; la racine du dossier de projet)
Autres fichiers de projet (cr&eacute;&eacute;s lors de la composition et de la g&eacute;n&eacute;ration d’un projet)
Extension de nom de fichier
Description
*.chm
Sortie compress&eacute;e pour l’aide HTML compil&eacute;e, utilis&eacute;e pour l’affichage du syst&egrave;me d’aide
(HTML Help uniquement)
Les fichiers CHM ajout&eacute;s comme sous-projets &agrave; un projet ma&icirc;tre doivent aussi se trouver dans le
m&ecirc;me dossier que le projet ma&icirc;tre.
CONTEXT.txt
Fichier de rubrique textuelle ajout&eacute; &agrave; l’aide contextuelle dans le module de composition Qu’est-ce
que c’est ?
(HTML Help uniquement)
*.fhs
Informations &agrave; propos des habillages FlashHelp
*.hlp
(HTML Help uniquement)
Fichier d’aide compil&eacute; WinHelp si le projet inclut des liens vers des rubriques WinHelp. N’est pas
inclus dans le fichier CHM et doit &ecirc;tre fourni s&eacute;par&eacute;ment. Pour WinHelp 4, distribuez &eacute;galement le
fichier .cnt.
*.hhp
Cr&eacute;&eacute; lors de la g&eacute;n&eacute;ration d’un fichier CHM
*.htt
Fichier mod&egrave;le de rubrique
*.htm, *.html
Contenu de rubrique
Derni&egrave;re mise &agrave; jour le 16/3/2011
303
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Extension de nom de fichier
Description
*.skn
Informations &agrave; propos des habillages WebHelp ou WebHelp Pro
(WebHelp et WebHelp Pro uniquement)
*.txt
Journal de compilation du projet
Fichier journal
(HTML Help uniquement)
*.txt
Rubriques textuelles
Fichier de rubrique textuel pour les rubriques d’aide contextuelle (Qu’est-ce que c’est ?) inclus dans
le fichier CHM compil&eacute;
Mise en page de Microsoft HTML Help
A propos de Microsoft HTML Help
Microsoft HTML Help est une norme d’aide en ligne bas&eacute;e sur HTML.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
304
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
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 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;.
2 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
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.
5 Cliquez sur Extraire.
Derni&egrave;re mise &agrave; jour le 16/3/2011
.
305
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
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 uniques, 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 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.
2 Cliquez sur Rechercher.
pour r&eacute;organiser ou redimensionner les colonnes, faites glisser leurs en-t&ecirc;tes ou leurs barres de s&eacute;paration.
Remplacement de fichiers CHM
1 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.
2 S&eacute;lectionnez le fichier CHM &agrave; remplacer.
3 Cliquez sur le bouton Modifier.
4 Ensuite, cliquez sur Parcourir
pour acc&eacute;der au fichier CHM de remplacement.
5 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.
❖ 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
306
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
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
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 de la 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;.
Voir aussi
&laquo; G&eacute;n&eacute;ration de la sortie &raquo; &agrave; la page 321
Fusion de projets JavaHelp
❖ Ajoutez une r&eacute;f&eacute;rence &agrave; un fichier HelpSet externe (.hs) lorsque vous g&eacute;n&eacute;rez la sortie.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
307
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
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.
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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
308
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
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.
• SDK Sun Java 2 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.
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 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.
1 Ouvrez la rubrique dans l’&eacute;diteur HTML.
2 Dans la zone de la balise meta, ins&eacute;rez le nouvel ID de rubrique dans la balise NewTopicID.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
309
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
meta name = &quot;window-type&quot; content = [&quot;window name&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.
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
❖ 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
310
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Exemple d’index Oracle Help
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
311
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
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;.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
312
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
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.
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;.
Voir aussi
&laquo; D&eacute;finir les options de g&eacute;n&eacute;ration de sortie XML &raquo; &agrave; la page 334
&laquo; Importation de fichiers XML &raquo; &agrave; la page 100
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.
Pour obtenir une liste des avantages de la g&eacute;n&eacute;ration d'une sortie dans la mise en page d'Adobe AIR, reportez-vous &agrave;
la section &laquo; A propos des types de sortie &raquo; &agrave; la page 30.
Pour plus d’informations sur les applications d’aide 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
uniques. 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.
❖ S&eacute;lectionnez Adobe AIR dans le conteneur Mises en page source uniques 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 Edition &gt; Propri&eacute;t&eacute;s.
Derni&egrave;re mise &agrave; jour le 16/3/2011
313
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Voir aussi
&laquo; Fusion de projets d’aide &raquo; &agrave; la page 43
&laquo; Distribution de la sortie Adobe AIR &raquo; &agrave; la page 353
&laquo; H&eacute;bergement des mises &agrave; jour de l’aide AIR &raquo; &agrave; la page 343
&laquo; Cr&eacute;ation d’habillages personnalis&eacute;s pour les projets Adobe AIR &raquo; &agrave; la page 370
&laquo; R&eacute;vision et collaboration dans l’aide AIR &raquo; &agrave; la page 388
S&eacute;lection de la sortie d’aide
Vous pouvez s&eacute;lectionner l’une des quatre options de sortie pour Adobe AIR :
❖ 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 sur l'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 plug-in 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 le biais d’un 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 &laquo; Cr&eacute;ation et localisation d’un fichier de
configuration du contenu de l’aide &raquo; &agrave; la page 340.
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.
Configuration des param&egrave;tres de l’aide
❖ 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
314
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
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 d’aide.
Version Indiquez un num&eacute;ro de version pour l’application d’aide 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
Vous pouvez configurer les param&egrave;tres du programme d’installation de l’application d’aide.
❖ 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). Reportez-vous &agrave; la section &laquo; Cr&eacute;ation d’un certificat
num&eacute;rique sign&eacute; automatiquement &raquo; &agrave; la page 320
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.
❖ Dans l’onglet Cat&eacute;gories de contenu de la bo&icirc;te de dialogue Adobe AIR, proc&eacute;dez comme suit :
• Pour cr&eacute;er une cat&eacute;gorie de contenu, cliquez sur Nouveau et sp&eacute;cifiez un nom.
• 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
315
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
• 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.
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.
❖ 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. Reportez-vous &agrave; la section
&laquo; Tables des mati&egrave;res &raquo; &agrave; la page 180.
Index S&eacute;lectionnez l’index &agrave; afficher dans l’aide g&eacute;n&eacute;r&eacute;e. Reportez-vous &agrave; la section &laquo; Index &raquo; &agrave; la page 186.
Glossaire S&eacute;lectionnez le glossaire &agrave; afficher dans l’aide g&eacute;n&eacute;r&eacute;e. Reportez-vous &agrave; la section &laquo; Glossaires &raquo; &agrave; la
page 201.
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. Reportez-
vous &agrave; la section &laquo; Variables d&eacute;finies par l’utilisateur &raquo; &agrave; la page 163.
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.
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. Reportez-vous &agrave; la section &laquo; Expressions de balises de construction conditionnelles &raquo; &agrave; la page 246.
Appliquer &agrave; toutes les rubriques Pr&eacute;cisez si vous souhaitez appliquer une page type ou une feuille CSS &agrave; l’ensemble
des rubriques. Si vous ne s&eacute;lectionnez pas cette option, les pages type associ&eacute;es aux rubriques individuelles sont
appliqu&eacute;es. Si aucune page type n’est appliqu&eacute;e aux rubriques, elles sont g&eacute;n&eacute;r&eacute;es telles quelles. Reportez-vous &agrave; la
section &laquo; Application d’une page type ou d’une feuille CSS lors de la g&eacute;n&eacute;ration &raquo; &agrave; la page 129
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
316
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
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.
❖ 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.
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 de droits d’auteur s’affiche dans la bo&icirc;te de dialogue
A propos de.
Description Sp&eacute;cifiez une description de l’aide. La description appara&icirc;t dans la bo&icirc;te de dialogue A propos de.
Ic&ocirc;ne favorite (Aide accessible par navigateur) Sp&eacute;cifiez une ic&ocirc;ne &agrave; associer au syst&egrave;me d’aide. Cette ic&ocirc;ne
s’affiche dans l’onglet du 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 S&eacute;lectionner pour choisir des images PNG pour votre
syst&egrave;me d’aide Adobe AIR. Vous pouvez s&eacute;lectionner diff&eacute;rentes ic&ocirc;nes pour le raccourci affich&eacute; sur le bureau, la
bo&icirc;te de dialogue A propos de, la barre de titre et la barre des t&acirc;ches. Vous pouvez &eacute;galement afficher vos
informations de copyright ou autres informations commerciales dans la barre d’&eacute;tat de l’application d’aide.
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.
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...
Oui
Non
Non
Oui
Oui
Oui
Reportez-vous &agrave; la section
&laquo; S&eacute;quences de navigation &raquo; &agrave; la
page 225.
Recherche
Derni&egrave;re mise &agrave; jour le 16/3/2011
317
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
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.
❖ Dans la bo&icirc;te de dialogue Adobe AIR, s&eacute;lectionnez le groupe Affichage et d&eacute;finissez les options suivantes :
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.
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.
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 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 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 &laquo; Recherche de contenu externe &raquo; &agrave; la page 224.
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 &laquo; H&eacute;bergement des mises &agrave; jour de l’aide AIR &raquo; &agrave; la page 343
• 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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
318
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
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 Sp&eacute;cifiez l’URL &agrave; partir de laquelle l’afficheur charge l’aide en ligne. Cette option ne
s’applique que si vous avez s&eacute;lectionn&eacute; le type de sortie Application Adobe AIR ou Application AIR et aide
accessible par le biais d’un navigateur.
Configuration de la collaboration
Les param&egrave;tres de collaboration sont disponibles pour l’application Adobe AIR uniquement.
❖ 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
&laquo; Distribution de la sortie Adobe AIR &raquo; &agrave; la page 353.
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. Reportez-vous &agrave; la section &laquo; Format des URL formats pour Windows, Mac et Linux &raquo; &agrave; la page 355.
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.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
319
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
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.
• Utilisateur anonyme S&eacute;lectionnez Utilisateur anonyme si votre serveur FTP autorise les connexions FTP
anonymes. Aucun ID utilisateur ni mot de passe n’est demand&eacute; pour la connexion au serveur FTP.
Sp&eacute;cifiez ces informations pour la connexion du serveur HTTP :
• Nom de l’h&ocirc;te Saisissez le nom d’h&ocirc;te du serveur.
• R&eacute;pertoire du serveur Saisissez le r&eacute;pertoire sur le contenu HTTP pour placer le contenu du syst&egrave;me d'Aide.
Certains serveurs HTTP exigent une barre oblique (/) &agrave; la fin du chemin.
S&eacute;lectionnez Syst&egrave;me de fichiers et saisissez le chemin de destination si vous avez acc&egrave;s &agrave; un chemin r&eacute;seau dans
lequel vous pouvez t&eacute;l&eacute;charger directement votre contenu de syst&egrave;me d'aide.
Pour la connexion serveur Syst&egrave;me de fichiers, sp&eacute;cifiez le chemin de destination.
Pour la connexion serveur Microsoft SharePoint, sp&eacute;cifiez le chemin du r&eacute;pertoire SharePoint. Si le chemin d’acc&egrave;s
au site SharePoint est mapp&eacute; en tant que lecteur r&eacute;seau sur le syst&egrave;me ou ajout&eacute; dans les chemins d’acc&egrave;s au r&eacute;seau,
vous pouvez cliquer sur le bouton Parcourir pour s&eacute;lectionner le chemin d’acc&egrave;s au r&eacute;seau.
3 D&eacute;finissez les options suivantes :
Rechercher les fichiers supprim&eacute;s Cette option permet de rechercher les fichiers qui ont &eacute;t&eacute; supprim&eacute;s dans la
destination.
Demander confirmation avant de remplacer les fichiers Cette option permet de recevoir un avertissement avant la
suppression des fichiers sur le serveur.
Republier tout Cette option permet de republier tous les fichiers sur la destination, en rempla&ccedil;ant les fichiers
existants sur le serveur.
Remarque : s’il s’agit d’un projet ma&icirc;tre et qu’une copie du sous-projet est plac&eacute;e dans le dossier de sortie, veillez &agrave; ce
que la case Republier tout ne soit pas activ&eacute;e.
4 Pour publier l’aide, cliquez sur Enregistrer et g&eacute;n&eacute;rer.
Derni&egrave;re mise &agrave; jour le 16/3/2011
320
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Remarques :
• Pour les syst&egrave;mes d’aide fusionn&eacute;s, publiez les projets individuels dans le m&ecirc;me emplacement. Ne pas utiliser
l’option Republier tout lorsqu’il s’agit d’un projet ma&icirc;tre.
• D&eacute;finissez les options de mise en page et g&eacute;n&eacute;rez automatiquement la mise en page principale en cliquant sur le
bouton G&eacute;n&eacute;rer.
• Vous pouvez g&eacute;n&eacute;rer ou publier plusieurs mises en page dans un lot.
• Si la sortie est endommag&eacute;e, v&eacute;rifiez si un fichier de rubrique quelconque a le caract&egrave;re &amp;. Renommez la rubrique
et r&eacute;g&eacute;n&eacute;rez la sortie.
• Pour obtenir la liste des formats vid&eacute;o pris en charge dans la sortie Adobe AIR, voir
http://kb2.adobe.com/cps/402/kb402866.html.
Cr&eacute;ation d’un certificat num&eacute;rique sign&eacute; automatiquement
Vous pouvez cr&eacute;er un certificat num&eacute;rique pour le test ou distribuer de mani&egrave;re priv&eacute;e l'application d'aide
d'Adobe AIR. Cependant, si vous distribuez l'Aide par le biais de votre site Web, pensez &agrave; obtenir un certificat
num&eacute;rique de la part d'une autorit&eacute; de certification (CA) comme Thawte ou VeriSign. Signez le syst&egrave;me d'aide &agrave; l'aide
du certificat num&eacute;rique.
Les certificats num&eacute;riques des autorit&eacute;s de certification peuvent &ecirc;tre v&eacute;rifi&eacute;s sur le Web. Ils garantissent aux
utilisateurs finaux que le programme d'installation de l'application d'aide est authentique et ne comporte aucun
programme malveillant. Consultez la page www.adobe.com/go/learn_air_digital_certificate_fr pour obtenir plus
d'informations.
1 Cliquez sur Cr&eacute;er en regard du libell&eacute; du certificat num&eacute;rique.
2 Dans la bo&icirc;te de dialogue Cr&eacute;ation d’un certificat num&eacute;rique sign&eacute; automatiquement, fournissez les pr&eacute;cisions
suivantes :
Nom de l’&eacute;diteur Sp&eacute;cifiez le nom de l’&eacute;diteur. Il s’agit g&eacute;n&eacute;ralement du nom de votre soci&eacute;t&eacute;. Si vous cr&eacute;ez une
application d'aide &agrave; partir d'Adobe AIR pour une autre entreprise, sp&eacute;cifiez le nom de votre client. Vous pouvez
&eacute;ventuellement pr&eacute;ciser l’unit&eacute; organisationnelle et le nom de l’organisation.
Pays S&eacute;lectionnez le pays de l’&eacute;diteur.
Type S&eacute;lectionnez la norme de chiffrement pour le certificat num&eacute;rique. La norme 2048-RSA offre un chiffrement
plus fort que la norme 1024-RSA.
Enregistrer sous Cliquez sur Parcourir pour s&eacute;lectionner un dossier et enregistrer le certificat num&eacute;rique cr&eacute;&eacute;. Les
certificats num&eacute;riques sign&eacute;s automatiquement sont enregistr&eacute;s avec une extension .p12.
G&eacute;n&eacute;ration, affichage et publication d’une sortie
Vous pouvez g&eacute;n&eacute;rer une sortie pour v&eacute;rifier sa pr&eacute;sentation et tester ses liens, parcourir ses s&eacute;quences, etc. Cette
op&eacute;ration met &eacute;galement &agrave; jour les fichiers contenant des informations sur le projet et les fichiers de sortie.
La publication de la sortie (WebHelp et FlashHelp uniquement) place les fichiers de sortie ou les dossiers dans un
emplacement sp&eacute;cifi&eacute;. L'emplacement peut &ecirc;tre un site Web, le disque dur local ou un dossier du r&eacute;seau.
Derni&egrave;re mise &agrave; jour le 16/3/2011
321
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
G&eacute;n&eacute;ration de la sortie
La sortie g&eacute;n&eacute;r&eacute;e est plac&eacute;e sur votre disque dur local. Lorsque vous g&eacute;n&eacute;rez une sortie de mise en page pour la
premi&egrave;re fois, un sous-dossier est cr&eacute;&eacute;, qui contiendra les fichiers de sortie g&eacute;n&eacute;r&eacute;s. Il se trouve dans le dossier du
projet, sous \!SSL!\[nom de la mise en page].
Remarque : &agrave; chaque g&eacute;n&eacute;ration d’une sortie, RoboHelp supprime les fichiers du dossier de sortie cr&eacute;&eacute;s lors de la session
pr&eacute;c&eacute;dente. Si vous ajoutez ou &eacute;crivez des s&eacute;quences dans les fichiers d’un sous-dossier de sortie, copiez-les &agrave; un autre
emplacement avant de g&eacute;n&eacute;rer une sortie.
1 Dans le conteneur Mises en page source uniques, cliquez sur la mise en page avec le bouton droit de la souris.
S&eacute;lectionnez G&eacute;n&eacute;rer.
2 D&eacute;finissez les options voulues en fonction du type de mise en page.
3 Cliquez sur Terminer.
Conseils pour une g&eacute;n&eacute;ration de projets optimale
• Travaillez sur un ordinateur local et nom &agrave; partir d’un emplacement r&eacute;seau.
RoboHelp doit pouvoir acc&eacute;der &agrave; tous les fichiers de votre projet lors de la g&eacute;n&eacute;ration du r&eacute;sultat. Si un projet se
compose de milliers de fichiers, m&ecirc;me un l&eacute;ger retard du trafic r&eacute;seau constitue un facteur d'aggravation &agrave; mesure
que RoboHelp tente d'acc&eacute;der &agrave; chaque fichier. Ces retards peuvent avoir un effet d&eacute;favorable sur les dur&eacute;es de
g&eacute;n&eacute;ration.
• Excluez le dossier du projet de l’analyse antivirus.
Remarque : la d&eacute;sactivation du logiciel anti-virus augmente la rapidit&eacute; mais est d&eacute;conseill&eacute;e pour des raisons de
s&eacute;curit&eacute;.
• V&eacute;rifiez que la m&eacute;moire syst&egrave;me est suffisante.
Voir aussi
&laquo; Options de navigation &raquo; &agrave; la page 207
&laquo; Variables d&eacute;finies par l’utilisateur &raquo; &agrave; la page 163
D&eacute;finition des options de g&eacute;n&eacute;ration de WebHelp
1 Dans l’onglet G&eacute;n&eacute;ralit&eacute;s de la bo&icirc;te de dialogue Param&egrave;tres WebHelp, d&eacute;finissez les options suivantes :
Barre de titre Sp&eacute;cifiez le titre &agrave; afficher dans la barre de titre.
Ic&ocirc;ne favorite 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.
Dossier de sortie et page de lancement Indique un emplacement et une page de lancement pour les fichiers d’aide.
Pour s&eacute;lectionner un emplacement pour le dossier de sortie, cliquez sur le bouton Parcourir
. Pour s&eacute;lectionner
une page de lancement autre que la page par d&eacute;faut, saisissez son nom en ajoutant l’extension .html. La page de
lancement est un jeu de cadres qui permet d’afficher le contenu de l’aide. Il s’agit du fichier que le d&eacute;veloppeur lie
lors de l’appel de votre syst&egrave;me d’aide &agrave; partir d’une application.
Utiliser des noms de fichier en minuscules Permet de cr&eacute;er des noms de fichier qui utilisent uniquement des
minuscules. Cette option s’adresse aux utilisateurs UNIX.
Remarque : ne s&eacute;lectionnez pas cette option pour les projets fusionn&eacute;s. Les liens vers des rubriques d’autres projets sont
convertis en minuscules, tandis que les noms de fichier des rubriques restent identiques. Les casses mixtes entra&icirc;nent
des liens rompus sous UNIX.
Derni&egrave;re mise &agrave; jour le 16/3/2011
322
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
2 Dans l’onglet 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, de s&eacute;quences de navigation, d’un index et d’une fonctionnalit&eacute; de recherche propres.
• Pour cr&eacute;er une cat&eacute;gorie de contenu, cliquez sur Nouveau et sp&eacute;cifiez un nom.
• 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.
3 Dans l’onglet Contenu, 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. Reportez-vous &agrave; la section
&laquo; Tables des mati&egrave;res &raquo; &agrave; la page 180.
Index S&eacute;lectionnez l’index &agrave; afficher dans l’aide g&eacute;n&eacute;r&eacute;e. Reportez-vous &agrave; la section &laquo; Index &raquo; &agrave; la page 186.
Glossaire S&eacute;lectionnez le glossaire &agrave; afficher dans l’aide g&eacute;n&eacute;r&eacute;e. Reportez-vous &agrave; la section &laquo; Glossaires &raquo; &agrave; la
page 201.
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. Reportez-
vous &agrave; la section &laquo; Variables d&eacute;finies par l’utilisateur &raquo; &agrave; la page 163.
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.
S&eacute;quences de navigation S&eacute;lectionnez les s&eacute;quences de navigation &agrave; afficher.
Expression de construction conditionnelle Si le projet contient des balises conditionnelles, cliquez sur D&eacute;finir pour
sp&eacute;cifier des expressions de construction conditionnelles. Reportez-vous &agrave; la section &laquo; Expressions de balises de
construction conditionnelles &raquo; &agrave; la page 246.
Derni&egrave;re mise &agrave; jour le 16/3/2011
323
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Appliquer &agrave; toutes les rubriques S&eacute;lectionnez cette option pour appliquer des pages type ou des feuilles CSS au
niveau du projet :
• Page type La page type s&eacute;lectionn&eacute;e remplace les param&egrave;tres de toutes les rubriques individuelles, qu’une page
type leur soit appliqu&eacute;e ou pas dans le projet. La feuille CSS et la mise en page de la page type remplacent celles de
l’ensemble des rubriques. Si la page type s&eacute;lectionn&eacute;e ne comporte ni en-t&ecirc;te, ni pied de page, aucune rubrique
n’affiche d’en-t&ecirc;te ni de pied de page, m&ecirc;me si un tel &eacute;l&eacute;ment &eacute;tait d&eacute;fini.
• CSS Les pages type associ&eacute;es &agrave; des rubriques individuelles entrent en vigueur. La feuille CSS s&eacute;lectionn&eacute;e
remplace toutes les rubriques et leurs CSS, qu’elles soient ou pas associ&eacute;es &agrave; une page type.
Voir &laquo; Application d’une page type ou d’une feuille CSS lors de la g&eacute;n&eacute;ration &raquo; &agrave; la page 129.
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.
4 Dans l’onglet Navigation, d&eacute;finissez les options suivantes :
S&eacute;lection de l’habillage (Facultatif) Recherchez un habillage dans le projet ou cliquez sur Galerie pour en
s&eacute;lectionner un dans la galerie d’habillages. Appliquez des habillages pour personnaliser les couleurs, les boutons,
le texte, les polices et les ic&ocirc;nes dans la sortie.
Remarque : l’option Habillage est d&eacute;sactiv&eacute;e lorsque vous s&eacute;lectionnez Sortie conforme &agrave; la section 508. Utilisez
l’option Style traditionnel - sans habillage.
Rubriques conformes aux directives W3C Cette option lance l’ex&eacute;cution d’un valideur HTML sur les rubriques
devant &ecirc;tre conformes aux directives W3C.
Remarque : les effets dynamiques dans les styles ne sont pas pris en charge dans les sorties conformes aux directives W3C.
Ajouter un commentaire Il s'agit d'un commentaire dans les balises HTML d'une page Web. Internet Explorer
version 6 ou ult&eacute;rieure r&eacute;f&eacute;rence ce commentaire pour d&eacute;terminer la zone de s&eacute;curit&eacute; de la page sur l’ordinateur de
l’utilisateur. S&eacute;lectionnez cette option pour &eacute;viter qu’Internet Explorer ne bloque votre sortie.
Remarque : avant de fusionner des projets, v&eacute;rifiez que l’option Ajouter un commentaire est activ&eacute;e ou d&eacute;sactiv&eacute;e
pour les projets.
Sortie conforme &agrave; la section 508 S&eacute;lectionnez cette option pour produire une version de WebHelp conforme &agrave; la
section 508. La sortie ne peut inclure ni habillages ni fonctionnalit&eacute;s du type DHTML.
Optimiser la vitesse pour S&eacute;lectionnez l’option qui permet au plus grand nombre d’utilisateurs d’acc&eacute;der &agrave; l’aide.
XML r&eacute;duit les temps de chargement en ne t&eacute;l&eacute;chargeant que les donn&eacute;es n&eacute;cessaires imm&eacute;diatement. Par exemple,
le volet Table des mati&egrave;res s’affiche rapidement en ne t&eacute;l&eacute;chargeant dans un premier temps que la quantit&eacute; de
donn&eacute;es n&eacute;cessaire au remplissage du volet. Les autres &eacute;l&eacute;ments sont alors t&eacute;l&eacute;charg&eacute;s pour permettre &agrave; l’utilisateur
de faire d&eacute;filer la liste.
• Site Web (Internet) Pour les utilisateurs acc&eacute;dant au syst&egrave;me &agrave; partir d’un site Web. Prend en charge les
connexions lentes et n&eacute;cessite un nombre plus important de fichiers WebHelp, puisque les donn&eacute;es &agrave;
t&eacute;l&eacute;charger sont organis&eacute;es en groupes de taille r&eacute;duite.
Derni&egrave;re mise &agrave; jour le 16/3/2011
324
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
• PC local ou intranet (r&eacute;seau interne) Pour les utilisateurs acc&eacute;dant au syst&egrave;me depuis un site intranet ou un
ordinateur local. Prend en charge les connexions rapides et n&eacute;cessite un nombre moins important de fichiers
WebHelp, puisque les donn&eacute;es &agrave; t&eacute;l&eacute;charger sont organis&eacute;es en groupes de plus grande taille.
Format pr&eacute;f&eacute;r&eacute; Indiquez le mode de traitement du format HTML dynamique (DHTML) par WebHelp et pr&eacute;cisez
comment l’utilisateur final acc&egrave;de &agrave; l’aide. l’option choisie repose sur des facteurs li&eacute;s &agrave; l’environnement des
utilisateurs (types de navigateur et de pare-feu utilis&eacute;s, par exemple).
• DHTML &gt; HTML pur Utilise DHTML s’il est pris en charge ou HTML pur dans le cas contraire. Si cet
environnement int&egrave;gre un pare-feu bloquant les applets Java, s&eacute;lectionnez DHTML &gt; HTML pur. Le syst&egrave;me d’aide
ne contient alors aucune applet.
• HTML pur Affiche l’aide en recourant &agrave; un format HTML pur reposant sur des listes dans tous les navigateurs.
Cependant, cette option r&eacute;duit le nombre de fonctions de navigation.
Boutons de la barre d'outils S&eacute;lectionnez les boutons de la barre d'outils de navigation qui appara&icirc;tront dans le
volet de gauche.
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.
Ajouter des liens de chemins de navigation Ajoute des chemins de navigation dans les pages des rubriques.
Format Permet de modifier le format des chemins de navigation.
Activer la s&eacute;quence de navigation Sp&eacute;cifiez si la sortie doit afficher les s&eacute;quences de navigation.
Afficher le lien du volet de navigation dans les rubriques Inclut un lien vers le volet de navigation dans les
rubriques d’aide contextuelle.
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.
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.
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
5 Dans l’onglet Recherche, d&eacute;finissez les options suivantes :
Activer la recherche de sous-cha&icirc;ne 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.
Activer la mise en surbrillance dans les r&eacute;sultats de la recherche Cette option permet de mettre les r&eacute;sultats de la
recherche en surbrillance. Dans le menu contextuel, s&eacute;lectionnez une couleur de mise en surbrillance.
Derni&egrave;re mise &agrave; jour le 16/3/2011
325
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
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 &laquo; Recherche de contenu externe &raquo; &agrave; la page 224.
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.
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.
6 Dans l’onglet Publier, d&eacute;finissez les options suivantes, puis cliquez sur Enregistrer et g&eacute;n&eacute;rer.
Serveurs D&eacute;finissez un emplacement de serveur pour la sortie. Pour effectuer la publication sur un site SharePoint,
cliquez sur Nouveau, puis s&eacute;lectionnez SharePoint. Entrez le chemin UNC du dossier sur le site SharePoint (si le
dossier est mapp&eacute; en tant que lecteur r&eacute;seau, cliquez sur Parcourir pour s&eacute;lectionner le lecteur).
Options Indiquez le mode de traitement des modifications apport&eacute;es aux fichiers dans la sortie :
• Rechercher les fichiers supprim&eacute;s Si cette option est s&eacute;lectionn&eacute;e, RoboHelp HTML v&eacute;rifie les fichiers
supprim&eacute;s de l’emplacement de destination et les publie &agrave; nouveau.
• Demander confirmation avant de remplacer les fichiers S&eacute;lectionnez cette option si vous voulez que RoboHelp
vous envoie une invite avant de remplacer le contenu des fichiers.
• Republier tout Cette option permet la republication de l’ensemble des fichiers vers la cible. Ne s&eacute;lectionnez pas
cette option pour les projets ma&icirc;tres dont le sous-dossier inclut une copie du sous-projet. De cette mani&egrave;re, vous
&eacute;viterez d’&eacute;craser le contenu des fichiers de sortie d&eacute;j&agrave; publi&eacute;s au m&ecirc;me emplacement.
Remarque : si vous indiquez un nouvel h&ocirc;te en tant que destination, pr&eacute;cisez l’ID utilisateur et le mot de passe
correspondant ; enregistrez ce dernier dans le registre, le cas &eacute;ch&eacute;ant.
Voir aussi
&laquo; HTML dynamique et effets sp&eacute;ciaux &raquo; &agrave; la page 234
D&eacute;finition des options de g&eacute;n&eacute;ration de FlashHelp
D&eacute;finissez les options de g&eacute;n&eacute;ration standard ainsi que les options FlashHelp suivantes, le cas &eacute;ch&eacute;ant :
1 D&eacute;finissez les options ci-apr&egrave;s, puis cliquez sur Suivant.
Barre de titre Sp&eacute;cifiez le titre &agrave; afficher dans la barre de titre.
Ic&ocirc;ne favorite 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.
Dossier de sortie et page de lancement Indique un emplacement et une page de lancement pour les fichiers d’aide.
Pour s&eacute;lectionner un emplacement pour le dossier de sortie, cliquez sur le bouton Dossier
. Pour s&eacute;lectionner
une page de lancement autre que la page par d&eacute;faut, saisissez son nom en ajoutant l’extension .html. La page de
lancement est un jeu de cadres qui permet d’afficher le contenu de l’aide. Il s’agit du fichier que le d&eacute;veloppeur lie
lors de l’appel de votre syst&egrave;me d’aide &agrave; partir d’une application.
Utiliser des noms de fichier en minuscules S&eacute;lectionnez cette option si vous souhaitez cr&eacute;er des noms de fichier
incluant uniquement des minuscules. Cette option s’adresse aux utilisateurs UNIX.
Remarque : ne s&eacute;lectionnez pas cette option pour les projets fusionn&eacute;s. Les liens vers des rubriques d’autres projets sont
convertis en minuscules, tandis que les noms de fichier des rubriques restent identiques. Les casses mixtes entra&icirc;nent
des liens rompus sous UNIX.
Expression de construction conditionnelle Si le projet contient des balises conditionnelles, cliquez sur D&eacute;finir pour
sp&eacute;cifier des expressions de construction conditionnelles.
Derni&egrave;re mise &agrave; jour le 16/3/2011
326
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Habillage Choisissez un habillage parmi ceux qui accompagnent le projet ou cliquez sur Galerie pour en
s&eacute;lectionner un. Les habillages permettent de modifier les couleurs, les boutons, le texte, les polices et les ic&ocirc;nes de
votre sortie, afin de la personnaliser. Un habillage est requis pour la sortie FlashHelp.
Remarque : l’option Habillage est d&eacute;sactiv&eacute;e lorsque vous s&eacute;lectionnez Sortie conforme &agrave; la section 508. Utilisez
l’option Style traditionnel - sans habillage.
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.
Index S&eacute;lectionnez l’index &agrave; afficher dans l’aide g&eacute;n&eacute;r&eacute;e.
Glossaire S&eacute;lectionnez le glossaire &agrave; afficher dans l’aide g&eacute;n&eacute;r&eacute;e.
Variables S&eacute;lectionnez un jeu de variables pour remplacer les valeurs du jeu par d&eacute;faut dans l’aide g&eacute;n&eacute;r&eacute;e.
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.
Rubrique par d&eacute;faut Il s’agit de la rubrique qui appara&icirc;t lorsque l’aide s’ouvre. Cliquez sur S&eacute;lectionner pour
indiquer une rubrique. Par d&eacute;faut, la premi&egrave;re rubrique de la table des mati&egrave;res correspond &agrave; la rubrique par d&eacute;faut.
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.
Rubriques conformes aux directives W3C Cette option lance l’ex&eacute;cution d’un valideur HTML sur les rubriques
devant &ecirc;tre conformes aux directives W3C.
Remarque : les effets dynamiques dans les styles ne sont pas pris en charge dans les sorties conformes aux directives W3C.
Ajouter un commentaire Il s'agit d'un commentaire dans les balises HTML d'une page Web. Internet Explorer
version 6 ou ult&eacute;rieure r&eacute;f&eacute;rence ce commentaire pour d&eacute;terminer la zone de s&eacute;curit&eacute; de la page sur l’ordinateur de
l’utilisateur. S&eacute;lectionnez cette option pour &eacute;viter qu’Internet Explorer ne bloque votre sortie.
Remarque : avant de fusionner des projets, v&eacute;rifiez que l’option Ajouter un commentaire est activ&eacute;e ou d&eacute;sactiv&eacute;e
pour les projets.
G&eacute;rer automatiquement la s&eacute;curit&eacute; flash RoboHelp ajoute automatiquement le chemin de sortie au sandbox local
approuv&eacute; pour FlashPlayer, afin que la machine puisse garantir la compatibilit&eacute; avec les fonctions de s&eacute;curit&eacute; de
Flash
Appliquer &agrave; toutes les rubriques S&eacute;lectionnez cette option pour appliquer des pages type ou des feuilles CSS au
niveau du projet :
• Page type La page type s&eacute;lectionn&eacute;e remplace les param&egrave;tres de toutes les rubriques individuelles, qu’une page
type leur soit appliqu&eacute;e ou pas dans le projet. La feuille CSS et la mise en page de la page type remplacent celles de
Derni&egrave;re mise &agrave; jour le 16/3/2011
327
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
l’ensemble des rubriques. Par exemple, si la page type s&eacute;lectionn&eacute;e ne contient pas d'en-t&ecirc;te ou de pied de page, les
rubriques n'en contiendront pas non plus.
• CSS Les pages type associ&eacute;es &agrave; des rubriques individuelles entrent en vigueur. La feuille CSS s&eacute;lectionn&eacute;e
remplace toutes les rubriques et leurs CSS, qu’elles soient ou pas associ&eacute;es &agrave; une page type.
Optimiser la vitesse pour S&eacute;lectionnez l’option qui permet au plus grand nombre d’utilisateurs d’acc&eacute;der &agrave; l’aide.
XML r&eacute;duit les temps de chargement en ne t&eacute;l&eacute;chargeant que les donn&eacute;es n&eacute;cessaires imm&eacute;diatement. Par exemple,
le volet Table des mati&egrave;res s’affiche rapidement en ne t&eacute;l&eacute;chargeant dans un premier temps que la quantit&eacute; de
donn&eacute;es n&eacute;cessaire au remplissage du volet. Les autres &eacute;l&eacute;ments sont alors t&eacute;l&eacute;charg&eacute;s pour permettre &agrave; l’utilisateur
de faire d&eacute;filer la liste.
• Site Web (Internet) Pour les utilisateurs acc&eacute;dant au syst&egrave;me &agrave; partir d’un site Web. Prend en charge les
connexions lentes et n&eacute;cessite un nombre plus important de fichiers WebHelp, puisque les donn&eacute;es &agrave;
t&eacute;l&eacute;charger sont organis&eacute;es en groupes de taille r&eacute;duite.
• PC local ou intranet (r&eacute;seau interne) Pour les utilisateurs acc&eacute;dant au syst&egrave;me depuis un site intranet ou un
ordinateur local. Prend en charge les connexions rapides et n&eacute;cessite un nombre moins important de fichiers
WebHelp, puisque les donn&eacute;es &agrave; t&eacute;l&eacute;charger sont organis&eacute;es en groupes de plus grande taille.
2 D&eacute;finissez les options ci-apr&egrave;s, puis cliquez sur Suivant.
Boutons de la barre d’outils S&eacute;lectionnez les &eacute;l&eacute;ments &agrave; inclure comme boutons de barre d’outils. Cliquez sur les
fl&egrave;ches Haut ou Bas pour r&eacute;organiser les boutons, puis sur Utiliser par d&eacute;faut pour d&eacute;finir le bouton par d&eacute;faut.
Navigation S&eacute;lectionnez les &eacute;l&eacute;ments de navigation &agrave; inclure dans la sortie.
Options suppl&eacute;mentaires S&eacute;lectionnez les options suivantes, le cas &eacute;ch&eacute;ant :
• S&eacute;quences de navigation Permet la prise en charge des s&eacute;quences de navigation, si vous en avez cr&eacute;&eacute;. La fen&ecirc;tre
inclut les boutons Pr&eacute;c&eacute;dent et Suivant. Utilisez les habillages pour personnaliser les s&eacute;quences de navigation.
• Champ de saisie de la recherche dans la barre d’outils Ajoute le bouton Recherche &agrave; la barre d’outils. Utilisez les
habillages pour personnaliser le champ de saisie de la recherche.
• Synchroniser la table des mati&egrave;res Indique l’emplacement de la rubrique affich&eacute;e dans la table des mati&egrave;res.
• Ajouter la bo&icirc;te de dialogue A propos de Cliquez sur Ajouter pour sp&eacute;cifier les informations qui s’affichent
dans une fen&ecirc;tre A propos de que l’utilisateur appelle &agrave; partir de la barre d’outils principale.
Options de recherche D&eacute;finissez des options de recherche pour l’aide g&eacute;n&eacute;r&eacute;e :
• 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. Dans le menu contextuel, s&eacute;lectionnez une 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 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.
• 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 &laquo; Recherche de contenu externe &raquo; &agrave; la page 224.
3 D&eacute;finissez les options suivantes, puis cliquez sur Enregistrer et g&eacute;n&eacute;rer.
Serveur D&eacute;finissez un emplacement de serveur pour la sortie. Pour effectuer la publication sur un site SharePoint,
cliquez sur Nouveau, puis s&eacute;lectionnez SharePoint. Entrez le chemin UNC du dossier sur le site SharePoint (si le
dossier est mapp&eacute; en tant que lecteur r&eacute;seau, cliquez sur Parcourir pour s&eacute;lectionner le lecteur).
Derni&egrave;re mise &agrave; jour le 16/3/2011
328
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Options Indiquez le mode de traitement des modifications apport&eacute;es aux fichiers dans la sortie :
• Rechercher les fichiers supprim&eacute;s Si cette option est s&eacute;lectionn&eacute;e, RoboHelp HTML v&eacute;rifie les fichiers
supprim&eacute;s de l’emplacement de destination et les publie &agrave; nouveau.
• Demander confirmation avant de remplacer les fichiers S&eacute;lectionnez cette option si vous voulez que RoboHelp
vous envoie une invite avant de remplacer le contenu des fichiers.
• Republier tout Cette option permet la republication de l’ensemble des fichiers vers la cible. Ne s&eacute;lectionnez pas
cette option pour les projets ma&icirc;tres dont le sous-dossier inclut une copie du sous-projet. De cette mani&egrave;re, vous
&eacute;viterez d’&eacute;craser le contenu des fichiers de sortie d&eacute;j&agrave; publi&eacute;s au m&ecirc;me emplacement.
Remarque : si vous indiquez un nouvel h&ocirc;te en tant que destination, pr&eacute;cisez l’ID utilisateur et le mot de passe
correspondant ; enregistrez ce dernier dans le registre, le cas &eacute;ch&eacute;ant.
Remarques :
• Si vous g&eacute;n&eacute;rez un projet &agrave; l’aide d’une version ant&eacute;rieure d’un habillage de la galerie, cliquez sur Oui pour annuler
la g&eacute;n&eacute;ration, puis mettez l’habillage &agrave; jour. Si vous cliquez sur Non, vous pouvez lancer la g&eacute;n&eacute;ration avec
l’habillage, mais les nouvelles fonctionnalit&eacute;s de FlashHelp ne seront pas disponibles.
• Pour mettre l’habillage &agrave; jour, proc&eacute;dez &agrave; son nouveau t&eacute;l&eacute;chargement &agrave; partir du site de l'aide communautaire,
consultez la documentation SDK ou adressez-vous au d&eacute;veloppeur Flash.
D&eacute;finition des options de g&eacute;n&eacute;ration de WebHelp Pro ou FlashHelp Pro
1 D&eacute;finissez les options ci-apr&egrave;s, puis cliquez sur Suivant.
Remarque : l’ordre de certaines options d&eacute;pend du type de sortie g&eacute;n&eacute;r&eacute;.
Nom du projet Permet de diff&eacute;rencier plusieurs versions d’un projet sur un serveur, si vous fusionnez des projets.
Ic&ocirc;ne favorite 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.
Dossier de sortie et page de lancement Indique un emplacement et une page de lancement pour les fichiers d’aide.
Pour s&eacute;lectionner un emplacement pour le dossier de sortie, cliquez sur le bouton Dossier
. Pour s&eacute;lectionner
une page de lancement autre que la page par d&eacute;faut, saisissez son nom en ajoutant l’extension .html. La page de
lancement est un jeu de cadres qui permet d’afficher le contenu de l’aide. Il s’agit du fichier que le d&eacute;veloppeur lie
lors de l’appel de votre syst&egrave;me d’aide &agrave; partir d’une application.
Expression de construction conditionnelle Si le projet contient des balises conditionnelles, cliquez sur D&eacute;finir pour
sp&eacute;cifier des expressions de construction conditionnelles.
Habillage Choisissez un habillage parmi ceux qui accompagnent le projet ou cliquez sur Galerie pour en
s&eacute;lectionner un. Les habillages permettent de modifier les couleurs, les boutons, le texte, les polices et les ic&ocirc;nes de
votre sortie, afin de la personnaliser. Un habillage est requis pour la sortie FlashHelp.
Remarque : l’option Habillage est d&eacute;sactiv&eacute;e lorsque vous s&eacute;lectionnez Sortie conforme &agrave; la section 508. Utilisez
l’option Style traditionnel - sans habillage.
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.
Index S&eacute;lectionnez l’index &agrave; afficher dans l’aide g&eacute;n&eacute;r&eacute;e.
Glossaire S&eacute;lectionnez le glossaire &agrave; afficher dans l’aide g&eacute;n&eacute;r&eacute;e.
Variables S&eacute;lectionnez un jeu de variables pour remplacer les valeurs du jeu par d&eacute;faut dans l’aide g&eacute;n&eacute;r&eacute;e.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
329
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
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.
Rubrique par d&eacute;faut Il s’agit de la rubrique qui appara&icirc;t lorsque l’aide s’ouvre. Cliquez sur S&eacute;lectionner pour
indiquer une rubrique. Par d&eacute;faut, la premi&egrave;re rubrique de la table des mati&egrave;res correspond &agrave; la rubrique par d&eacute;faut.
Fen&ecirc;tre par d&eacute;faut Correspond au conteneur dans lequel s’affiche l’aide. Par d&eacute;faut, le syst&egrave;me d’aide s’ouvre dans
la fen&ecirc;tre de navigateur par d&eacute;faut de l’utilisateur.
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.
Appliquer &agrave; toutes les rubriques S&eacute;lectionnez cette option pour appliquer des pages type ou des feuilles CSS au
niveau du projet :
• Page type La page type s&eacute;lectionn&eacute;e remplace les param&egrave;tres de toutes les rubriques individuelles, qu’une page
type leur soit appliqu&eacute;e ou pas dans le projet. La feuille CSS et la mise en page de la page type remplacent celles de
l’ensemble des rubriques. Si la page type s&eacute;lectionn&eacute;e ne comporte ni en-t&ecirc;te, ni pied de page, aucune rubrique
n’affiche d’en-t&ecirc;te ni de pied de page, m&ecirc;me si un tel &eacute;l&eacute;ment &eacute;tait d&eacute;fini.
• CSS Les pages type associ&eacute;es &agrave; des rubriques individuelles entrent en vigueur. La feuille CSS s&eacute;lectionn&eacute;e
remplace toutes les rubriques et leurs CSS, qu’elles soient ou pas associ&eacute;es &agrave; une page type.
2 D&eacute;finissez les options ci-apr&egrave;s, puis cliquez sur Suivant.
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 &laquo; Recherche de contenu externe &raquo; &agrave; la page 224.
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. Dans le menu contextuel, s&eacute;lectionnez une 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.
Masquer la colonne de rang dans les r&eacute;sultats de la recherche (WebHelp Pro) S&eacute;lectionnez cette option pour ne
pas afficher la colonne de rang dans les r&eacute;sultats de la recherche.
Rubriques conformes aux directives W3C Cette option lance l’ex&eacute;cution d’un valideur HTML sur les rubriques
devant &ecirc;tre conformes aux directives W3C.
Remarque : les effets dynamiques dans les styles ne sont pas pris en charge dans les sorties conformes aux directives W3C.
Ajouter un commentaire Il s'agit d'un commentaire dans les balises HTML d'une page Web. Internet Explorer
version 6 ou ult&eacute;rieure r&eacute;f&eacute;rence ce commentaire pour d&eacute;terminer la zone de s&eacute;curit&eacute; de la page sur l’ordinateur de
l’utilisateur. S&eacute;lectionnez cette option pour &eacute;viter qu’Internet Explorer ne bloque votre sortie.
Remarque : avant de fusionner des projets, v&eacute;rifiez que l’option Ajouter un commentaire est activ&eacute;e ou d&eacute;sactiv&eacute;e
pour les projets.
Derni&egrave;re mise &agrave; jour le 16/3/2011
330
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Ajouter la bo&icirc;te de dialogue A propos de Cliquez sur Ajouter pour sp&eacute;cifier les informations qui s’affichent dans
une fen&ecirc;tre A propos de que l’utilisateur appelle &agrave; partir de la barre d’outils principale.
G&eacute;rer automatiquement la s&eacute;curit&eacute; flash (FlashHelp Pro) S&eacute;lectionnez cette option pour que le chemin de sortie
g&eacute;n&eacute;r&eacute; soit copi&eacute; dans le sandbox local approuv&eacute; pour Flash Player. Afin de tenir compte des modifications
apport&eacute;es &agrave; la s&eacute;curit&eacute; dans Flash 7 et version ult&eacute;rieure, placez les fichiers SWF dans le sandbox local approuv&eacute;
pour Flash Player. RoboHelp conserve le fichier RoboHelp[version].cfg dans le dossier FlashPlayerTrust.
Remarque : les effets dynamiques dans les styles ne sont pas pris en charge dans les sorties conformes aux directives W3C.
Afficher le bouton Imprimer dans l’habillage (FlashHelp Pro) Affiche le bouton Imprimer dans la sortie.
Afficher le lien du volet de navigation dans les rubriques Inclut un lien vers le volet de navigation dans les
rubriques ouvertes par l’interm&eacute;diaire de l’aide contextuelle.
Ajouter des liens de chemins de navigation Ajoute des chemins de navigation dans les pages des rubriques.
3 D&eacute;finissez les options suivantes, puis cliquez sur Enregistrer et g&eacute;n&eacute;rer.
Serveurs D&eacute;finissez un emplacement de serveur pour la sortie. Saisissez nom_du_serveur:port/contextname/server ou https://Servername:port/context-name/server selon le protocole que vous souhaitez
utiliser. RoboHelp utilise le protocole http par d&eacute;faut.
Options Indiquez le mode de traitement des modifications apport&eacute;es aux fichiers dans la sortie :
• Rechercher les fichiers supprim&eacute;s Si cette option est s&eacute;lectionn&eacute;e, RoboHelp HTML v&eacute;rifie les fichiers
supprim&eacute;s de l’emplacement de destination et les publie &agrave; nouveau.
• Demander confirmation avant de remplacer les fichiers S&eacute;lectionnez cette option si vous voulez que RoboHelp
vous envoie une invite avant de remplacer le contenu des fichiers.
• Republier tout Cette option permet la republication de l’ensemble des fichiers vers la cible. Ne s&eacute;lectionnez pas
cette option pour les projets ma&icirc;tres dont le sous-dossier inclut une copie du sous-projet. De cette mani&egrave;re, vous
&eacute;viterez d’&eacute;craser le contenu des fichiers de sortie d&eacute;j&agrave; publi&eacute;s au m&ecirc;me emplacement.
Remarque : si vous indiquez un nouvel h&ocirc;te en tant que destination, pr&eacute;cisez l’ID utilisateur et le mot de passe
correspondant ; enregistrez ce dernier dans le registre, le cas &eacute;ch&eacute;ant.
D&eacute;finition des options de g&eacute;n&eacute;ration de Microsoft HTML Help
❖ D&eacute;finissez les options suivantes, puis cliquez sur Enregistrer et g&eacute;n&eacute;rer.
S&eacute;lectionner un dossier et un nom de fichier de sortie Indique un emplacement et une page de lancement pour les
fichiers d’aide. Pour s&eacute;lectionner un emplacement pour le dossier de sortie, cliquez sur le bouton Parcourir
.
Pour s&eacute;lectionner une page de lancement autre que la page par d&eacute;faut pour le projet d’aide, saisissez son nom en
ajoutant l’extension .chm.
Expression de construction conditionnelle Si le projet contient des balises conditionnelles, cliquez sur D&eacute;finir pour
sp&eacute;cifier des expressions de construction conditionnelles.
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.
Index S&eacute;lectionnez l’index &agrave; afficher dans l’aide g&eacute;n&eacute;r&eacute;e.
Glossaire S&eacute;lectionnez le glossaire &agrave; afficher dans l’aide g&eacute;n&eacute;r&eacute;e.
Variables S&eacute;lectionnez un jeu de variables pour remplacer les valeurs du jeu par d&eacute;faut dans l’aide g&eacute;n&eacute;r&eacute;e.
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.
Derni&egrave;re mise &agrave; jour le 16/3/2011
331
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Rubrique par d&eacute;faut Il s’agit de la rubrique qui appara&icirc;t lorsque l’aide s’ouvre. Cliquez sur S&eacute;lectionner pour
indiquer une rubrique. Par d&eacute;faut, la premi&egrave;re rubrique de la table des mati&egrave;res correspond &agrave; la rubrique par d&eacute;faut.
Fen&ecirc;tre par d&eacute;faut Correspond au conteneur dans lequel s’affiche l’aide. Par d&eacute;faut, le syst&egrave;me d’aide s’ouvre dans
la fen&ecirc;tre de navigateur par d&eacute;faut de l’utilisateur.
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.
Ajouter des liens de chemins de navigation Ajoute des chemins de navigation dans les pages des rubriques.
Optimiser la taille du fichier CHM R&eacute;duit la taille du fichier CHM.
Param&egrave;tres avanc&eacute;s Cliquez sur cette option pour d&eacute;finir des styles personnalis&eacute;s pour la table des mati&egrave;res et
l’index.
Appliquer &agrave; toutes les rubriques S&eacute;lectionnez cette option pour appliquer une mise en forme au niveau du projet :
• Page type La page type s&eacute;lectionn&eacute;e remplace les param&egrave;tres de toutes les rubriques individuelles, qu’une page
type leur soit appliqu&eacute;e ou pas dans le projet. La feuille CSS et la mise en page de la page type remplacent celles de
l’ensemble des rubriques. Par exemple, si la page type s&eacute;lectionn&eacute;e ne contient pas d'en-t&ecirc;te ou de pied de page, les
rubriques n'en contiendront pas non plus.
• CSS Les pages type associ&eacute;es &agrave; des rubriques individuelles entrent en vigueur. La feuille CSS s&eacute;lectionn&eacute;e
remplace toutes les rubriques et leurs CSS, qu’elles soient ou pas associ&eacute;es &agrave; une page type.
D&eacute;finition des options de g&eacute;n&eacute;ration d’Oracle Help
1 D&eacute;finissez les options ci-apr&egrave;s, puis cliquez sur Suivant.
S&eacute;lectionner un dossier et un nom de fichier de sortie Nom et emplacement des fichiers de sortie.
Utiliser des noms de fichier en minuscules S’adresse tout particuli&egrave;rement aux utilisateurs UNIX ou aux
utilisateurs qui acc&egrave;dent &agrave; des fichiers stock&eacute;s sur un serveur UNIX.
Expression de construction conditionnelle Cliquez sur D&eacute;finir pour sp&eacute;cifier des expressions de construction
conditionnelles.
Rubrique par d&eacute;faut Cliquez sur S&eacute;lectionner pour sp&eacute;cifier la rubrique &agrave; afficher lors du d&eacute;marrage de l’aide.
Volet de navigation Permet de sp&eacute;cifier les onglets qui apparaissent dans le volet de navigation de l’aide.
Barre de navigation dans une rubrique Options de la barre de navigation.
Sortie Permet de sp&eacute;cifier le type de sortie Oracle Help :
• Oracle Help non compress&eacute; avec des fichiers source G&eacute;n&egrave;re des fichiers HS et des fichiers source individuels.
• Oracle Help compress&eacute; G&eacute;n&egrave;re des fichiers JAR et HS.
• Oracle Help compress&eacute; avec des fichiers source G&eacute;n&egrave;re des fichiers JAR et HS, ainsi que des fichiers source
individuels.
Remarque : la g&eacute;n&eacute;ration de fichiers source Oracle Help supprime le contenu du dossier de sortie Oracle Help.
Table des mati&egrave;res Permet de s&eacute;lectionner la table des mati&egrave;res &agrave; afficher dans la sortie.
Index Permet de s&eacute;lectionner l’index &agrave; afficher dans la sortie.
Variables S&eacute;lectionnez un jeu de variables pour remplacer les valeurs du jeu par d&eacute;faut dans l’aide g&eacute;n&eacute;r&eacute;e.
Derni&egrave;re mise &agrave; jour le 16/3/2011
332
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
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.
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.
Appliquer &agrave; toutes les rubriques S&eacute;lectionnez cette option pour appliquer une mise en forme au niveau du projet :
• Page type La page type s&eacute;lectionn&eacute;e remplace les param&egrave;tres de toutes les rubriques individuelles, qu’une page
type leur soit appliqu&eacute;e ou pas dans le projet. La feuille CSS et la mise en page de la page type remplacent celles de
l’ensemble des rubriques. Par exemple, si la page type s&eacute;lectionn&eacute;e ne contient pas d'en-t&ecirc;te ou de pied de page, les
rubriques n'en contiendront pas non plus.
• CSS Les pages type associ&eacute;es &agrave; des rubriques individuelles entrent en vigueur. La feuille CSS s&eacute;lectionn&eacute;e
remplace toutes les rubriques et leurs CSS, qu’elles soient ou pas associ&eacute;es &agrave; une page type.
2 D&eacute;finissez les options ci-apr&egrave;s, puis cliquez sur Suivant :
Libell&eacute; Texte affich&eacute; lorsque la souris survole le nom de la vue. Ne renseignez pas cette option pour utiliser le texte
par d&eacute;faut.
Image Cliquez sur le bouton Parcourir pour s&eacute;lectionner l’image &agrave; utiliser dans la barre d’outils.
3 D&eacute;finissez les options ci-apr&egrave;s, puis cliquez sur Suivant :
Titre (Facultatif) Permet de sp&eacute;cifier le texte qui appara&icirc;t dans l’afficheur. Ne renseignez pas les champs pour
utiliser le texte par d&eacute;faut (Table des mati&egrave;res, Index, Recherche de texte int&eacute;gral).
Image Cliquez sur le bouton Parcourir pour s&eacute;lectionner l’image &agrave; afficher en regard du titre de la table des
mati&egrave;res.
4 Cliquez sur Ajouter pour s&eacute;lectionner un affichage distant pour la table des mati&egrave;res, l’index et la fonctionnalit&eacute; de
recherche. Indiquez les propri&eacute;t&eacute;s de l’affichage, puis cliquez sur Suivant :
onglet G&eacute;n&eacute;ralit&eacute;s D&eacute;finissez les options suivantes :
• Nom (Facultatif) Nom unique de l’affichage distant.
• Type Type de l’affichage distant : TOCNavigator, KeywordNavigator ou SearchNavigator. Oracle Help
fusionne les affichages dont les libell&eacute;s et les types d’affichage sont identiques.
• Moteur Format du fichier de donn&eacute;es pour l’affichage.
• Fichier de donn&eacute;es Chemin d’acc&egrave;s (nom de fichier ou URL) &agrave; l’affichage distant.
Onglet Facultatif D&eacute;finissez les options suivantes :
• Texte Indiquez le libell&eacute; de l’onglet et le titre de l’affichage. Ne renseignez pas les champs pour utiliser le texte
par d&eacute;faut (Table des mati&egrave;res, Index, Recherche de texte int&eacute;gral).
• Image Cliquez sur le bouton Parcourir pour s&eacute;lectionner l’image &agrave; utiliser dans la barre d’outils.
Onglet R&eacute;f&eacute;rence de mappage Cliquez sur le bouton Parcourir pour ajouter un pointeur vers le fichier de mappage
pour l’affichage distant.
Derni&egrave;re mise &agrave; jour le 16/3/2011
333
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
5 Pour fusionner un fichier HelpSet (.hs) externe avec le projet, indiquez le chemin d’acc&egrave;s dans le champ SubHelp
Sets, puis cliquez sur Ajouter.
6 Cliquez sur Enregistrer et g&eacute;n&eacute;rer.
7 Si la bo&icirc;te de dialogue de demande de JavaHelp JDK appara&icirc;t, s&eacute;lectionnez l’une des options suivantes :
Remarque : cette bo&icirc;te de dialogue s’affiche si Sun Java 2 JDK ou version ult&eacute;rieure n’est pas install&eacute;.
G&eacute;n&eacute;rer sans recherche de texte int&eacute;gral Cliquez pour g&eacute;n&eacute;rer une sortie sans recherche de texte int&eacute;gral.
Localiser le dossier d’installation de Java SDK Cliquez pour rechercher le dossier d’installation de Java SDK.
Cliquez sur R&eacute;seau pour rechercher et mapper le dossier sur une unit&eacute; de r&eacute;seau.
D&eacute;finition des options de g&eacute;n&eacute;ration de JavaHelp
1 D&eacute;finissez les options suivantes, puis cliquez sur Enregistrer et g&eacute;n&eacute;rer.
S&eacute;lectionner un dossier et un nom de fichier de sortie Nom et emplacement des fichiers de sortie.
Utiliser des noms de fichier en minuscules S’adresse tout particuli&egrave;rement aux utilisateurs UNIX ou aux
utilisateurs qui acc&egrave;dent &agrave; des fichiers stock&eacute;s sur un serveur UNIX.
Expression de construction conditionnelle Cliquez sur D&eacute;finir pour sp&eacute;cifier des expressions de construction
conditionnelles.
Rubrique par d&eacute;faut Cliquez sur S&eacute;lectionner pour sp&eacute;cifier la rubrique &agrave; afficher lors du d&eacute;marrage de l’aide.
Barre de navigation dans une rubrique D&eacute;finissez des options pour la barre de navigation.
Table des mati&egrave;res S&eacute;lectionnez la table des mati&egrave;res &agrave; afficher dans la sortie.
Index : s&eacute;lectionnez l’index &agrave; afficher dans la sortie.
Glossaire S&eacute;lectionnez le glossaire &agrave; afficher dans la sortie.
Variables S&eacute;lectionnez un jeu de variables pour remplacer les valeurs du jeu par d&eacute;faut dans l’aide g&eacute;n&eacute;r&eacute;e.
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.
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.
Version Sp&eacute;cifiez la version de JavaHelp.
Compresser S&eacute;lectionnez l’une des options suivantes :
• JavaHelp non compress&eacute; avec des fichiers source G&eacute;n&egrave;re des fichiers HS et des fichiers source individuels.
• JAR JavaHelp compress&eacute; G&eacute;n&egrave;re des fichiers JAR et HS.
• JavaHelp compress&eacute; avec des fichiers source G&eacute;n&egrave;re des fichiers JAR et HS, ainsi que des fichiers source
individuels.
Remarque : la g&eacute;n&eacute;ration de fichiers source JavaHelp supprime le contenu du dossier de sortie JavaHelp.
Derni&egrave;re mise &agrave; jour le 16/3/2011
334
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Appliquer &agrave; toutes les rubriques S&eacute;lectionnez cette option pour appliquer une mise en forme au niveau du projet :
• Page type La page type s&eacute;lectionn&eacute;e remplace les param&egrave;tres de toutes les rubriques individuelles, qu’une page
type leur soit appliqu&eacute;e ou pas dans le projet. La feuille CSS et la mise en page de la page type remplacent celles de
l’ensemble des rubriques. Si la page type s&eacute;lectionn&eacute;e ne comporte ni en-t&ecirc;te, ni pied de page, aucune rubrique
n’affiche d’en-t&ecirc;te ni de pied de page, m&ecirc;me si un tel &eacute;l&eacute;ment &eacute;tait d&eacute;fini.
• CSS Les pages type associ&eacute;es &agrave; des rubriques individuelles entrent en vigueur. La feuille CSS s&eacute;lectionn&eacute;e
remplace toutes les rubriques et leurs CSS, qu’elles soient ou pas associ&eacute;es &agrave; une page type.
Avanc&eacute; Propri&eacute;t&eacute;s de la vue de navigation et options de fusion.
2 Si la bo&icirc;te de dialogue de demande de JavaHelp JDK appara&icirc;t, s&eacute;lectionnez l’une des options suivantes :
Remarque : cette bo&icirc;te de dialogue s’affiche si Sun Java 2 JDK ou version ult&eacute;rieure n’est pas install&eacute;.
G&eacute;n&eacute;rer sans recherche de texte int&eacute;gral Cliquez pour g&eacute;n&eacute;rer une sortie sans recherche de texte int&eacute;gral. La bo&icirc;te
de dialogue SubHelpSets JavaHelp s'affiche.
Cette bo&icirc;te de dialogue permet de fusionner un fichier externe JavaHelp HelpSet (fichier HS) dans le projet.
• Subhelp sets Indiquez le chemin d’acc&egrave;s complet (nom de fichier ou URL) au HelpSet (.hs).
• Ajouter Permet d’ajouter le fichier HS sp&eacute;cifi&eacute;.
• Mettre &agrave; jour Permet de modifier l’emplacement d’un fichier SubHelpSet d&eacute;j&agrave; ajout&eacute;. S&eacute;lectionnez le fichier,
changez le chemin d’acc&egrave;s dans la zone SubHelpSet, puis cliquez sur Mettre &agrave; jour.
• Supprimer Permet de supprimer le fichier SubHelpSet s&eacute;lectionn&eacute;.
Localiser le dossier d’installation de Java SDK Cliquez pour rechercher le dossier d’installation de Java SDK.
Cliquez sur R&eacute;seau pour rechercher et mapper le dossier sur une unit&eacute; de r&eacute;seau.
Vous pouvez d&eacute;finir la classe d'afficheur d'un type MIME donn&eacute; en sp&eacute;cifiant les informations suivantes.
Type Indiquez le type MIME.
Classe Indiquez une classe Java pour afficher le type MIME.
D&eacute;finir les options de g&eacute;n&eacute;ration de sortie XML
❖ D&eacute;finissez les options suivantes, puis cliquez sur Enregistrer et g&eacute;n&eacute;rer.
S&eacute;lectionner un dossier et un nom de fichier de sortie Nom et emplacement des fichiers de sortie.
Expression de construction conditionnelle Cliquez sur D&eacute;finir pour sp&eacute;cifier des expressions de construction
conditionnelles.
S&eacute;lectionner le gestionnaire d'exportation Les options avanc&eacute;es sont les suivantes :
• Exporter le projet au format DocBook Exporte l’ensemble du projet XML au format DocBook.
• Exporter les rubriques au format DocBook Exporte uniquement les rubriques, au format DocBook.
• Exporter le projet au format XHTML Exporte le projet XML au format XHTML. Toutes les rubriques sont
converties en fichiers XHTML.
Pour les options DocBook, cliquez sur Avanc&eacute; pour d&eacute;finir des options suppl&eacute;mentaires :
• Contenu uniquement Exporte uniquement le contenu pertinent (texte et donn&eacute;es) inclus dans le projet ou la
rubrique. Les effets DHTML sont exclus.
• Exportation compl&egrave;te Exporte l’int&eacute;gralit&eacute; du projet ou du contenu des rubriques (texte et donn&eacute;es et format
d’affichage associ&eacute;). Les effets DHTML sont inclus.
Derni&egrave;re mise &agrave; jour le 16/3/2011
335
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Table des mati&egrave;res S&eacute;lectionnez la table des mati&egrave;res &agrave; afficher dans la sortie.
Index : s&eacute;lectionnez l’index &agrave; afficher dans la sortie.
Glossaire S&eacute;lectionnez le glossaire &agrave; afficher dans la sortie.
Variables S&eacute;lectionnez un jeu de variables pour remplacer les valeurs du jeu par d&eacute;faut dans l’aide 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.
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.
Appliquer &agrave; toutes les rubriques S&eacute;lectionnez cette option pour appliquer une mise en forme au niveau du projet :
• Page type La page type s&eacute;lectionn&eacute;e remplace les param&egrave;tres de toutes les rubriques individuelles, qu’une page
type leur soit appliqu&eacute;e ou pas dans le projet. La feuille CSS et la mise en page de la page type remplacent celles de
l’ensemble des rubriques. Par exemple, si la page type s&eacute;lectionn&eacute;e ne contient pas d'en-t&ecirc;te ou de pied de page, les
rubriques n'en contiendront pas non plus.
• CSS Les pages type associ&eacute;es &agrave; des rubriques individuelles entrent en vigueur. La feuille CSS s&eacute;lectionn&eacute;e
remplace toutes les rubriques et leurs CSS, qu’elles soient ou pas associ&eacute;es &agrave; une page type.
Voir aussi
&laquo; Mise en page XML &raquo; &agrave; la page 312
G&eacute;n&eacute;ration d’EclipseHelp
EclipseHelp contient une foule de fichiers HTML avec une table des mati&egrave;res XML et un fichier plugin.xml. Eclipse
utilise le fichier de plug-in pour afficher l’aide en s&eacute;lectionnant Aide &gt; Contenu de l’aide.
1 Proc&eacute;dez de l’une des fa&ccedil;ons suivantes :
• S&eacute;lectionnez Fichier &gt; G&eacute;n&eacute;rer &gt; EclipseHelp.
• S&eacute;lectionnez Outils &gt; Scripts &gt; EclipseHelp Generator.
2 S&eacute;lectionnez le dossier dans lequel vous voulez enregistrer la sortie d’EclipseHelp.
3 Sp&eacute;cifiez les informations suivantes :
Titre Titre pour la sortie. Par d&eacute;faut, RoboHelp affiche le nom du projet.
Nom du fournisseur Le nom de l’entreprise.
Version Le num&eacute;ro de version de la sortie.
ID Un identifiant unique de la sortie.
4
Cliquez sur G&eacute;n&eacute;rer.
G&eacute;n&eacute;ration d’une sortie dans le format ePub
Le format ePub vous permet de distribuer du contenu sur des appareils mobiles, des lecteurs de livres &eacute;lectroniques et
des tablettes graphiques. Adobe Digital Editions, Calibre et le module externe ePub Reader avec Mozilla Firefox sont
des lecteurs ePub.
Derni&egrave;re mise &agrave; jour le 16/3/2011
336
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Le logiciel de lecture Adobe Digital Editions est gratuit et peut &ecirc;tre t&eacute;l&eacute;charg&eacute; &agrave; partir du site produit Digital Editions.
RoboHelp cr&eacute;e un fichier .epub unique incluant le contenu XHTML. Le fichier export&eacute; comprend l’image miniature
JPEG que vous sp&eacute;cifiez pour la page de couverture du document (voir &laquo; Ex&eacute;cution du script ePub Generator &raquo; &agrave; la
page 336). Cette miniature permet de repr&eacute;senter le livre dans la vue Biblioth&egrave;que de Digital Editions Reader.
Voir aussi
&laquo; Application de balises de construction conditionnelles au contenu &raquo; &agrave; la page 243
Ressources ePub
Pour obtenir la liste des fonctions principales d’ePub, voir www.adobe.com/go/learn_rh_blog_epub_fr.
Pour plus d’informations sur le format ePub, voir www.idpf.org.
Pour obtenir les instructions pour la cr&eacute;ation de documents ePub bien form&eacute;s et bien mis en forme, voir
www.adobe.com/go/learn_rh_epub_best_practices_fr (Guide des m&eacute;thodes recommand&eacute;es au format ePub).
Consultez le blog Digital Editions pour plus d’informations sur Digital Editions.
Pr&eacute;paration &agrave; la g&eacute;n&eacute;ration de la sortie ePub
1 T&eacute;l&eacute;chargez un ex&eacute;cutable 7-zip pour Windows &agrave; partir du site http://www.7-zip.org/download.html.
2 Passez en revue le contenu de votre projet et appliquez des balises de construction conditionnelle au contenu qui
n’est pas pris en charge par le format ePub (comme le texte d&eacute;roulant ou le texte d&eacute;velopp&eacute;).
3 Cr&eacute;ez la table des mati&egrave;res pour la sortie ePub.
4 Dans le conteneur Mises en page source uniques, cliquez avec le bouton droit sur Sortie XML et s&eacute;lectionnez
Nouvelle mise en page. Sp&eacute;cifiez un nom, puis cliquez sur OK.
5 S&eacute;lectionnez la table des mati&egrave;res que vous avez cr&eacute;&eacute;e pour la sortie ePub.
Remarque : la sortie ePub ne prend pas en charge les index ni les glossaires.
6 S&eacute;lectionnez ou d&eacute;finissez l’expression de construction conditionnelle.
7 Cliquez sur Enregistrer.
Les &eacute;chantillons de projet disponibles dans votre installation (accessibles depuis le conteneur D&eacute;marrage) contiennent
des mises en forme configur&eacute;es pour la sortie ePub. V&eacute;rifiez les param&egrave;tres de ces derni&egrave;res.
Ex&eacute;cution du script ePub Generator
1 Proc&eacute;dez de l’une des fa&ccedil;ons suivantes :
• S&eacute;lectionnez Fichier &gt; G&eacute;n&eacute;rer &gt; Sortie ePub.
• S&eacute;lectionnez Outils &gt; Scripts &gt; ePub Generator.
2 Sp&eacute;cifiez un emplacement pour le stockage de la sortie ePub.
3 S&eacute;lectionnez la mise en page XML qui contient les param&egrave;tres pour la sortie.
4 Dans l’onglet M&eacute;tadonn&eacute;es, sp&eacute;cifiez les m&eacute;tadonn&eacute;es pour &ecirc;tre conforme &agrave; la norme OPF (Open Packaging
Format) :
Titre Titre pour la sortie. Par d&eacute;faut, RoboHelp affiche le nom du projet.
Auteur(s) (Facultatif) Le nom de l’auteur. Pour sp&eacute;cifier plusieurs noms d’auteurs, utilisez une virgule comme
s&eacute;parateur.
Derni&egrave;re mise &agrave; jour le 16/3/2011
337
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Editeur (Facultatif) Le nom de l’entit&eacute; charg&eacute;e de rendre la sortie disponible, par exemple, l’auteur ou
l’organisation.
Balise(s) (Facultatif) Les mots-cl&eacute;s &agrave; associer avec le contenu.
Droits (Facultatif) D&eacute;claration au sujet des droits, telle qu’une mention des droits d’auteur.
Description (Facultatif) Description du contenu.
ISBN (Facultatif) Identificateur qui respecte la norme ISBN.
Date de publication La date de la publication de la sortie. Suivez le format sp&eacute;cifi&eacute; dans Formats de date et d’heure.
Langue La langue dans laquelle le contenu est &eacute;crit. Pour plus d’informations sur le format, voir Dublin Core
Metadata Element Set (document en anglais).
5 Dans l’onglet Cover Page, recherchez et s&eacute;lectionnez l’image que vous souhaitez afficher dans la page de couverture
de la sortie ePub.
6 Dans l’onglet 7-Zip Location, sp&eacute;cifiez l’emplacement de l’ex&eacute;cutable 7-zip pour Windows.
Remarque : si un ex&eacute;cutable 7-Zip n’est pas disponible sur votre ordinateur, cliquez sur le bouton Ouvrir dans un
navigateur pour t&eacute;l&eacute;charger un ex&eacute;cutable 7-Zip pour Windows.
7
S&eacute;lectionnez Open ePub In Default Application.
8
Cliquez sur G&eacute;n&eacute;rer.
G&eacute;n&eacute;ration de sortie par lots
La fonction de g&eacute;n&eacute;ration par lots permet d’&eacute;liminer les temps d’attente entre la g&eacute;n&eacute;ration de chaque sortie. Vous
pouvez publier des sorties &agrave; partir de mises en page diff&eacute;rentes et ce, &agrave; diff&eacute;rents emplacements. Gr&acirc;ce au traitement
par lots, vous gagnez du temps lorsque vous testez, affichez ou distribuez diff&eacute;rentes sorties au moyen de balises de
construction conditionnelles.
Les mises en page sont trait&eacute;es dans leur ordre d’apparition dans la bo&icirc;te de dialogue G&eacute;n&eacute;rer par lots.
Important : en cours de g&eacute;n&eacute;ration, RoboHelp supprime les fichiers du dossier de sortie cr&eacute;&eacute;s lors de la session pr&eacute;c&eacute;dente.
Si vous ajoutez ou &eacute;crivez des s&eacute;quences dans les fichiers d’un sous-dossier de sortie, copiez-les &agrave; un autre emplacement
avant de g&eacute;n&eacute;rer la sortie.
1 Dans le conteneur Mises en page source uniques, cliquez avec le bouton droit de la souris sur une mise en page.
2 S&eacute;lectionnez l’option G&eacute;n&eacute;rer par lots.
3 S&eacute;lectionnez la mise en page des sorties &agrave; g&eacute;n&eacute;rer.
4 Cliquez sur G&eacute;n&eacute;rer ou Publier.
Remarques :
• La g&eacute;n&eacute;ration d’un projet WebHelp ou WebHelp Pro n&eacute;cessite un navigateur.
• En cas de premi&egrave;re g&eacute;n&eacute;ration de documents Word imprim&eacute;s, activez les macros sous Word.
• l’option Publier n’est disponible que si les destinations des mises en page WebHelp s&eacute;lectionn&eacute;es sont d&eacute;finies.
• V&eacute;rifiez l’&eacute;tat d’une g&eacute;n&eacute;ration dans la bo&icirc;te de dialogue G&eacute;n&eacute;rer par lots. Si l’&eacute;tat en question est Echec, consultez
les messages du compilateur dans le volet inf&eacute;rieur afin de r&eacute;soudre l’incident. Dans le cas de projets WinHelp,
g&eacute;n&eacute;rez le projet dans l’assistant de mise en page et utilisez l’assistant de r&eacute;solution des erreurs pour localiser le
probl&egrave;me.
Derni&egrave;re mise &agrave; jour le 16/3/2011
338
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
• Affichez le r&eacute;sultat WebHelp ou WebHelp Pro une fois publi&eacute; &agrave; partir du serveur pour voir les modifications et les
fonctionnalit&eacute;s relatives au serveur.
Affichage de la sortie
❖ Proc&eacute;dez de l’une des fa&ccedil;ons suivantes :
• Si la sortie est d&eacute;j&agrave; g&eacute;n&eacute;r&eacute;e, acc&eacute;dez au conteneur Mises en page source uniques, cliquez sur la mise en page avec
le bouton droit de la souris et s&eacute;lectionnez Afficher. En cas d’invite en ce sens, cliquez sur Oui pour r&eacute;g&eacute;n&eacute;rer la
sortie avant de l’afficher.
• Si vous avez g&eacute;n&eacute;r&eacute; la mise en page, cliquez sur Afficher les r&eacute;sultats. Une fois les donn&eacute;es affich&eacute;es, vous pouvez
cliquer sur Termin&eacute; ou publier la sortie &agrave; l’emplacement indiqu&eacute; dans la mise en page, en cliquant sur Publier.
• Publiez d’abord le projet ma&icirc;tre, puis affichez-le &agrave; partir de l’emplacement de publication pour voir le syst&egrave;me
fusionn&eacute;. Pour publier le projet, cliquez sur Publier.
Remarque : si le bouton Publier est d&eacute;sactiv&eacute;, ajoutez une destination dans la bo&icirc;te de dialogue Publier.
Affichage d’une sortie WebHelp, WebHelp Pro et FlashHelp Pro
Pour cr&eacute;er un aper&ccedil;u d’un projet WebHelp Pro ou FlashHelp Pro en local sans le publier sur le serveur Adobe
RoboHelp Server, ouvrez-le dans un navigateur Web. Vous ne pouvez pas afficher d’aper&ccedil;u local de l’index, de la table
des mati&egrave;res, des liens ni des s&eacute;quences de navigation.
Vous pouvez &eacute;galement tester le projet publi&eacute; en l’affichant &agrave; partir du serveur. Il est alors possible de tester les
fonctions d&eacute;pendant du serveur.
Affichez le projet dans un navigateur pour tester les liens, les images et les s&eacute;quences de navigation, entre autres.
Remarque : Les param&egrave;tres de s&eacute;curit&eacute; Chrome n’autorisent pas le chargement des pages HTML &agrave; partir d’un disque
local. Pour afficher la sortie dans Chrome, lancez Chrome &agrave; partir de la ligne de commande dans le mode autoris&eacute; du
fichier d'acc&egrave;s. (Chrome.exe -allow-file-access-from-files).
Affichage de WebHelp, WebHelp Pro et FlashHelp Pro &agrave; distance
1 Ouvrez le projet et v&eacute;rifiez que la mise en page principale est appropri&eacute;e.
2 S&eacute;lectionnez Fichier &gt; Afficher &gt; Mise en page principale depuis le serveur.
Affichage de WebHelp, WebHelp Pro et FlashHelp Pro en local
1 Dans le conteneur Mises en page source uniques, cliquez sur la mise en page avec le bouton droit de la souris.
Proc&eacute;dez de l’une des fa&ccedil;ons suivantes :
• Pour afficher la sortie dans le navigateur par d&eacute;faut, s&eacute;lectionnez Afficher. Si vous y &ecirc;tes invit&eacute;, cliquez sur Oui
pour mettre la sortie &agrave; jour. Dans le cas contraire, cliquez sur Non.
• Pour afficher la sortie dans un navigateur s&eacute;lectionn&eacute;, cochez la case Afficher avec et choisissez l’un des
navigateurs install&eacute;s sur votre ordinateur.
les diff&eacute;rents navigateurs affichent un rendu diff&eacute;rent du contenu bas&eacute; sur CSS. La prise en charge de
navigateurs multiples pour l’aper&ccedil;u des rubriques et de la sortie d’un projet vous permet de tester si le contenu
s’affiche correctement dans les navigateurs d’utilisation courante.
2 Si une bo&icirc;te de dialogue intitul&eacute;e Limitations appara&icirc;t, cliquez sur OK. Cette bo&icirc;te de dialogue affiche les
fonctionnalit&eacute;s que vous ne pouvez consulter que si vous &ecirc;tes connect&eacute; &agrave; un serveur (bouton Rechercher et
propri&eacute;t&eacute;s Windows, par exemple).
Le projet s’ouvre dans le navigateur par d&eacute;faut.
Derni&egrave;re mise &agrave; jour le 16/3/2011
339
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
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.
Pour afficher un syst&egrave;me d’aide fusionn&eacute; &agrave; partir de la copie locale du projet ma&icirc;tre, copiez les fichiers WebHelp du
sous-projet dans le dossier mergedProject\[nom du projet] du projet ma&icirc;tre. Cliquez avec le bouton droit de la souris
sur une mise en page du conteneur Mises en page source uniques. S&eacute;lectionnez Afficher. Ne pas utiliser l’option Republier
tout lorsqu’il s’agit d’un projet ma&icirc;tre.
Affichage d’une aide compil&eacute;e Microsoft HTML Help
1 Dans le conteneur Mises en page source uniques, cliquez sur Microsoft HTML Help avec le bouton droit de la
souris.
2 Si vous y &ecirc;tes invit&eacute;, cliquez sur Oui pour mettre la sortie &agrave; jour. Dans le cas contraire, cliquez sur Non.
Remarque : pour afficher les liens entrants et sortants par rubrique, s&eacute;lectionnez Afficher &gt; Conteneur &gt; Affichage des
liens.
Voir aussi
&laquo; Affichage des rubriques et des &eacute;l&eacute;ments de conception &raquo; &agrave; la page 123
Assistant de l’afficheur d’aide
L’Assistant de cr&eacute;ation d’afficheur d’aide vous permet de g&eacute;n&eacute;rer un afficheur d’aide AIR (fichier AIR) et un
programme d’installation, de d&eacute;finir l’aspect du contenu et de sp&eacute;cifier d’autres param&egrave;tres.
G&eacute;n&eacute;ration d’un afficheur d’aide AIR
1 S&eacute;lectionnez Afficher &gt; Conteneurs &gt; Bo&icirc;te &agrave; outils.
2 Cliquez deux fois pour d&eacute;marrer l’Assistant de l'afficheur d’aide.
3 Fournissez les informations requises.
Remarque : il vous suffit de s&eacute;lectionner le chemin d’acc&egrave;s au fichier et d’entrer n’importe quel nom comme nom de
fichier.
4 Indiquez un num&eacute;ro de version et un ID.
5 Cr&eacute;ation d’un certificat num&eacute;rique sign&eacute; automatiquement. Reportez-vous &agrave; la section &laquo; Cr&eacute;ation d’un certificat
num&eacute;rique sign&eacute; automatiquement &raquo; &agrave; la page 320
6 Cliquez sur Terminer.
Copie du fichier de contenu de l’aide
❖ Copiez le fichier de contenu de l’aide (RHA) sur votre ordinateur. Il peut se trouver &agrave; n'importe quel emplacement,
mais le programme d'installation doit s'en souvenir.
Reportez-vous &agrave; la section &laquo; S&eacute;lection de la sortie d’aide &raquo; &agrave; la page 313 pour obtenir davantage d'informations sur
la g&eacute;n&eacute;ration d'un fichier RHA.
Installation de l’application d’aide
L’afficheur d’aide AIR est un fichier AIR qui installe l’application d’aide.
1 Allez sur le dossier C:/Program Files/[nom du dossier].
2 Cliquez deux fois sur le fichier AIR.
Derni&egrave;re mise &agrave; jour le 16/3/2011
340
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
3 Dans le m&ecirc;me dossier, cliquez deux fois sur le fichier EXE.
Cr&eacute;ation et localisation d’un fichier de configuration du contenu de l’aide
L’afficheur d’aide AIR doit &ecirc;tre associ&eacute; au fichier de contenu d'aide pour afficher le contenu au format s&eacute;lectionn&eacute;.
Cr&eacute;ez un fichier XML portant une extension .helpcfg pour associer le fichier RHA &agrave; l’afficheur d’aide AIR. Enregistrez
ce fichier au m&ecirc;me emplacement que le fichier AIR install&eacute;. L’afficheur d’aide AIR utilise le fichier .helpcfg pour
localiser le chemin du fichier de contenu de l’aide, puis affiche ce contenu.
R&eacute;p&eacute;tez le code XML pour chaque fichier d'aide que vous souhaitez afficher avec l'afficheur d'aide.
Par exemple, un fichier XML contenant la configuration de l’aide contient la ligne de code suivante :
&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot; ?&gt;
&lt;contents&gt;
&lt;data id=&quot;&quot; label=&quot;&quot; onlineurl=&quot;&quot; offlineurl=&quot;&quot;/&gt;
&lt;/contents&gt;
Nom de l’attribut
Valeur de l’attribut
ID
Cha&icirc;ne unique qui diff&eacute;rencie un fichier de donn&eacute;es d’aide des autres fichiers de donn&eacute;es d’aide
dans l’afficheur. Vous pouvez utiliser cet ID pour appeler l’API CSH ou pour d&eacute;marrer l’afficheur
d’aide AIR.
label
Libell&eacute; du contenu de l’aide lorsque l’afficheur de l’aide contient plusieurs fichiers de donn&eacute;es
d’aide. L’afficheur de l’aide affiche cette cha&icirc;ne dans le contenu de l’aide s&eacute;lectionn&eacute;.
onlineurl
URL en ligne du contenu de l’aide h&eacute;berg&eacute; sur un serveur.
offlineurl
Emplacement hors ligne du fichier d’aide si un contenu local de l’aide install&eacute;e est disponible.
useoffline
Param&egrave;tre facultatif. Lorsqu’il prend la valeur &laquo; true &raquo;, l’afficheur d’aide AIR charge le contenu de
l’aide hors ligne au d&eacute;marrage de l’application d’aide. Si aucune aide hors ligne n’est disponible, cet
attribut est inutile dans le fichier de configuration du contenu de l’aide.
Remarque : n’importe quel nom peut &ecirc;tre utilis&eacute; pour configurer le nom du fichier .helpcfg. Le nom n'a pas besoin de
correspondre au nom du fichier .air ou .exe dans le dossier d'installation.
Publication d’une sortie
Vous pouvez publier une sortie de projets WebHelp et FlashHelp. Apr&egrave;s avoir sp&eacute;cifi&eacute; un emplacement de sortie,
publiez la sortie selon vos besoins. Utilisez la fonction de traitement par lots pour publier plusieurs versions d’un projet
(m&ecirc;me en cas d’emplacements multiples).
Vous pouvez choisir de ne publier que les fichiers modifi&eacute;s depuis leur derni&egrave;re publication.
1 Dans le conteneur Mises en page source uniques, cliquez avec le bouton droit de la souris sur la mise en page et
s&eacute;lectionnez Propri&eacute;t&eacute;s.
2 Effectuez les op&eacute;rations suivantes :
• (WebHelp) Cliquez sur Publier.
• (FlashHelp) Cliquez sur Suivant jusqu’&agrave; ce que la bo&icirc;te de dialogue Publier s’affiche.
3 S&eacute;lectionnez une destination de publication en utilisant l’une des m&eacute;thodes suivantes :
• S&eacute;lectionnez ou modifiez une destination existante dans la bo&icirc;te de dialogue Serveurs, d&eacute;finissez les options
requises et cliquez sur Enregistrer.
Rechercher les fichiers supprim&eacute;s Si cette option est s&eacute;lectionn&eacute;e, RoboHelp HTML v&eacute;rifie les fichiers
supprim&eacute;s de l’emplacement de destination et les publie &agrave; nouveau.
Derni&egrave;re mise &agrave; jour le 16/3/2011
341
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Demander confirmation avant de remplacer les fichiers S&eacute;lectionnez cette option si vous voulez que RoboHelp
vous envoie une invite avant de remplacer le contenu des fichiers.
Republier tout Cette option permet la republication de l’ensemble des fichiers vers la cible. Ne s&eacute;lectionnez pas
cette option pour les projets ma&icirc;tres dont le sous-dossier inclut une copie du sous-projet. De cette mani&egrave;re, vous
&eacute;viterez d’&eacute;craser le contenu des fichiers de sortie d&eacute;j&agrave; publi&eacute;s au m&ecirc;me emplacement.
Remarque : si vous indiquez un nouvel h&ocirc;te en tant que destination, pr&eacute;cisez l’ID utilisateur et le mot de passe
correspondant ; enregistrez ce dernier dans le registre, le cas &eacute;ch&eacute;ant.
• Pour indiquer une nouvelle destination, cliquez sur Nouveau. Saisissez un nom descriptif et d&eacute;finissez les
options requises. Cliquez sur OK.
Protocoles de connexion Cette option permet de sp&eacute;cifier le type de protocole de transfert &agrave; utiliser pour
acc&eacute;der &agrave; la nouvelle destination. S&eacute;lectionnez Syst&egrave;me de fichiers pour publier les fichiers en local ou sur une
unit&eacute; de r&eacute;seau. Pour l’option FrontPage activ&eacute;, commencez par installer Microsoft FrontPage et ses extensions
de serveur, puis personnalisez-le. Pour la connexion serveur Microsoft SharePoint, sp&eacute;cifiez le chemin du
r&eacute;pertoire SharePoint. Si le chemin d’acc&egrave;s au site SharePoint est mapp&eacute; en tant que lecteur r&eacute;seau sur le syst&egrave;me
ou ajout&eacute; dans les chemins d’acc&egrave;s au r&eacute;seau, vous pouvez cliquer sur le bouton Parcourir pour s&eacute;lectionner le
chemin d’acc&egrave;s au r&eacute;seau.
Fusion des syst&egrave;mes d’aide Pour publier un sous-projet dans le dossier MergedProjects, pr&eacute;cisez les
informations suivantes :
• Dans le champ Nom de l’h&ocirc;te, saisissez une adresse IP ou URL.
• Dans le champ Nom du site Web, saisissez le nom d’un site Web sur le serveur. (Une cha&icirc;ne vide correspond
au site Web racine.)
• Dans le champ R&eacute;pertoire du serveur, indiquez le chemin d’acc&egrave;s au projet ma&icirc;tre : /.../[projet
ma&icirc;tre]/MergedProjects/[sous-projet]. Ce chemin se trouve sur le serveur une fois le projet ma&icirc;tre publi&eacute;.
Options Les options affich&eacute;es d&eacute;pendent du protocole de connexion s&eacute;lectionn&eacute;.
• Nom du serveur Il s’agit du serveur sur lequel les fichiers seront publi&eacute;s. Vous pouvez indiquer une adresse IP.
• ID utilisateur Permet de sp&eacute;cifier l’ID utilisateur pour la connexion &agrave; l’h&ocirc;te.
• Mot de passe D&eacute;termine le mot de passe associ&eacute; &agrave; l’ID utilisateur. l’administrateur syst&egrave;me du r&eacute;seau peut
indiquer ces informations.
• Enregistrer le mot de passe Enregistre le mot de passe, pour vous &eacute;viter de le saisir &agrave; nouveau lors de la
publication des fichiers. l’enregistrement du mot de passe entra&icirc;ne sa consignation dans le registre. Aucun
chiffrement n’est appliqu&eacute;.
• Port Port utilis&eacute; pour la connexion vers l’h&ocirc;te.
• Utilisateur anonyme Publie les fichiers sous un nom d’utilisateur anonyme ne n&eacute;cessitant pas de mot de
passe. Si vous indiquez un mot de passe ou d’autres informations anonymes, comme une adresse e-mail,
d&eacute;s&eacute;lectionnez cette option. Saisissez Anonyme dans le champ ID utilisateur, puis indiquez un mot de passe
dans le champ Mot de passe.
• R&eacute;pertoire du serveur Indique le r&eacute;pertoire de destination sur le serveur. La valeur par d&eacute;faut est une barre
oblique.
• Nom du site Web Nom du site Web FrontPage du serveur s&eacute;lectionn&eacute; dans le champ Nom de l’h&ocirc;te. Les
barres obliques initiales ne sont pas requises pour les sous-sites Web.
Remarque : le champ Nom du site Web est utilis&eacute; uniquement si les extensions serveur de FrontPage sont install&eacute;es
sur le serveur. Dans le cas contraire, les fichiers sont publi&eacute;s dans le r&eacute;pertoire du serveur, indiqu&eacute; ainsi : FTP://.
Derni&egrave;re mise &agrave; jour le 16/3/2011
342
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
• Chemin de destination (Protocole HTTP) Chemin d’acc&egrave;s &agrave; l’emplacement de publication des fichiers.
4 Dans le conteneur Mises en page source uniques, cliquez sur une mise en page avec le bouton droit de la souris et
s&eacute;lectionnez Publier. A l’invite, indiquez si vous voulez g&eacute;n&eacute;rer et inclure les modifications avant la publication.
5 Cliquez sur Fermer.
Affichez la sortie depuis le serveur pour voir les modifications et les fonctionnalit&eacute;s relatives au serveur.
G&eacute;n&eacute;ration et publication d’une sortie via l’invite de commande
La ligne de commande permet de g&eacute;n&eacute;rer et de publier des mises en page sans ouvrir RoboHelp ou de mani&egrave;re
automatique dans un travail par lots planifi&eacute;. Ces deux m&eacute;thodes de g&eacute;n&eacute;ration et de publication peuvent &ecirc;tre
ex&eacute;cut&eacute;es simultan&eacute;ment.
Remarque : pour acc&eacute;der &agrave; l’invite de commande depuis RoboHelp, s&eacute;lectionnez D&eacute;marrer &gt; Programmes &gt; Adobe
RoboHelp [version] &gt; Outils &gt; RoboHelp Command Prompt.
Ouverture de l’application &agrave; partir de l’invite de commande
1 Sur l’invite de commande, saisissez la commande au format suivant :
rhcl myproject\myproject.xpj
2 Acc&eacute;dez aux fichiers de sortie stock&eacute;s dans le dossier de sortie par d&eacute;faut.
G&eacute;n&eacute;ration de mises en page &agrave; l’aide d’une invite de commande
• Pour g&eacute;n&eacute;rer une mise en page unique dans le dossier de sortie par d&eacute;faut (!SSL!), indiquez la commande au format
suivant :
rhcl [project path] [-l] [layout name]
• Pour g&eacute;n&eacute;rer une mise en page unique dans un dossier de sortie personnalis&eacute;, indiquez la commande au format
suivant :
rhcl [project path] [-l] [layout name] [-o] [path of custom output folder]
• Pour g&eacute;n&eacute;rer toutes les mises en page dans le dossier de sortie par d&eacute;faut (!SSL!), indiquez la commande comme
suit :
rhcl [project installation path] [-b]
• Pour g&eacute;n&eacute;rer toutes les mises en page dans un dossier de sortie personnalis&eacute;, indiquez la commande au format
suivant :
rhcl [full or relative path of the RoboHelp project] [-b]
Publication de toutes les mises en page &agrave; partir de l’invite de commande
❖ Saisissez la commande comme suit :
rhcl [project path] [-p] [server name][user name][password]
Le nom de serveur, le nom d’utilisateur et le mot de passe sont facultatifs.
Options d’invite de commande
Les commandes doivent commencer par rhcl et inclure le chemin et le nom du projet. Indiquez-les comme suit :
rhcl [-?] [-h] [project path] [-l] [layout name] [-p] [server name:user name:password] [-o]
[output folder path] [-d] [-b] [-g]
Derni&egrave;re mise &agrave; jour le 16/3/2011
343
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Toutes ces options ne sont pas requises lorsque vous saisissez une commande.
-l G&eacute;n&egrave;re une mise en page. Indiquez le nom de la mise en page (par exemple : -l FlashHelp). Si aucune mise en page
sp&eacute;cifique n’a &eacute;t&eacute; indiqu&eacute;e, l’application g&eacute;n&egrave;re la mise en page principale.
-p Publie une mise en page. Configurez toutes les destinations de publication dans la bo&icirc;te de dialogue Nouvelle
destination.
“ Indique un espace.
-o Envoie la sortie vers un dossier.
-d Affiche les noms des mises en page et des destinations de publication dans l’invite de commande.
-b G&eacute;n&egrave;re les mises en page d&eacute;finies pour la g&eacute;n&eacute;ration par lots. Le r&eacute;sultat d’une mise en page source unique
particuli&egrave;re est envoy&eacute; vers le dossier de sortie.
-h Affiche l’aide.
•
rhcl
•
rhcl -h
•
rhcl -?
-g Indique un nom de fichier journal.
Si vous indiquez cette option au moyen de la commande rhcl, cette commande rhcl &eacute;crit le r&eacute;sultat dans le fichier
journal indiqu&eacute;. La sortie n’est pas envoy&eacute;e vers la console. Le nom de fichier journal ne doit contenir aucun caract&egrave;re
Unicode. Si un fichier porte d&eacute;j&agrave; le nom sp&eacute;cifi&eacute;, il est remplac&eacute;.
H&eacute;bergement des mises &agrave; jour de l’aide AIR
Apr&egrave;s avoir publi&eacute; votre application Adobe AIR initiale, vous pouvez corriger et r&eacute;viser le contenu, le cas &eacute;ch&eacute;ant. Par
d&eacute;faut, lorsqu'un utilisateur lance l'application d'aide, le contenu en ligne s'affiche et l'aide affich&eacute;e contient donc vos
mises &agrave; jour.
Lors de la g&eacute;n&eacute;ration d’une nouvelle version d’une application Adobe AIR, un fichier de configuration du contenu de
l’aide est cr&eacute;&eacute; parall&egrave;lement &agrave; la sortie. Ce fichier XML est unique pour chaque version de l'application d'aide. Il
contient des informations sur l'emplacement de l'application d'aide publi&eacute;e, l'ID de l'aide et le num&eacute;ro de version.
Placez ce fichier XML avec le programme d’installation de l’application d’aide dans l’emplacement de serveur partag&eacute;
sp&eacute;cifi&eacute; pour que les utilisateurs y aient acc&egrave;s. Lorsque la version install&eacute;e par un utilisateur recherche des mises &agrave; jour
&agrave; partir de cet emplacement, l’application d’aide est mise &agrave; jour.
Cr&eacute;ation et h&eacute;bergement d’une mise &agrave; jour
1 Cliquez sur Adobe AIR avec le bouton droit de la souris dans le conteneur Mises en page source uniques, puis
s&eacute;lectionnez Propri&eacute;t&eacute;s.
2 Sp&eacute;cifiez les informations mises &agrave; jour pour le contenu de l’aide.
Puisque vous proc&eacute;dez &agrave; la mise &agrave; jour d’un contenu d'aide existant, conservez le titre et l’ID de cette sortie d'aide
pr&eacute;c&eacute;demment configur&eacute;e, mais mettez &agrave; jour le num&eacute;ro de version.
3 Dans la bo&icirc;te de dialogue Adobe AIR, s&eacute;lectionnez le groupe Affichage, ainsi qu'Activer la mise &agrave; jour automatique,
si cette option n'est pas d&eacute;j&agrave; activ&eacute;e.
4 Sp&eacute;cifiez l’emplacement du fichier de configuration du contenu de l’aide mis &agrave; jour (fichier XML) qui est h&eacute;berg&eacute;
dans un emplacement partag&eacute; ou sur un serveur Web.
Derni&egrave;re mise &agrave; jour le 16/3/2011
344
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Pour distribuer les mises &agrave; jour de l'aide au sein de votre r&eacute;seau, s&eacute;lectionnez le chemin de fichier. Pour distribuer
&agrave; l'ext&eacute;rieur du r&eacute;seau, s&eacute;lectionnez un emplacement de serveur Web.
5 Mettez &agrave; jour tous les autres param&egrave;tres requis (onglets de ressources, par exemple).
6 G&eacute;n&eacute;rez les formats de sortie de l’aide.
Publication d’une mise &agrave; jour
Vous pouvez publier une mise &agrave; jour de l’application Adobe AIR &agrave; l’adresse de serveur Web sp&eacute;cifi&eacute;e (emplacement
HTTP) ou dans le dossier r&eacute;seau.
❖ G&eacute;n&eacute;rez l’aide, puis publiez le programme d’installation de l’application d’aide mise &agrave; jour et le fichier XML associ&eacute;
sur le serveur Web ou dans le dossier.
Distribution de la sortie du projet
Apr&egrave;s avoir cr&eacute;&eacute; et test&eacute; la sortie du projet, vous devez la distribuer au d&eacute;veloppeur ou &agrave; l’&eacute;diteur. La sortie distribu&eacute;e
d&eacute;pend du projet. Par d&eacute;faut, la sortie &agrave; distribuer se trouve dans le sous-dossier du projet. (Pour Microsoft HTML
Help, la sortie est compil&eacute;e dans un fichier CHM unique.)
Certains outils RoboHelp fournissent des fonctions d’aide par le biais de fichiers DLL et OCX. N’oubliez pas de
distribuer ces fichiers. Ils doivent &ecirc;tre inclus dans le programme d’installation du syst&egrave;me d’aide.
l’aide de l’application RoboHelp r&eacute;pertorie les DLL requises par l’application. Une liste des fichiers redistribuables est
disponible dans le fichier Redistrb.Txt, stock&eacute; dans le dossier Redist des fichiers de programme RoboHelp [version].
Remarque : ajoutez la sortie au contr&ocirc;le de version pour permettre &agrave; d’autres personnes d’y acc&eacute;der.
Distribution de WebHelp
Pour les syst&egrave;mes d’aide publi&eacute;s &agrave; un emplacement central, seules les informations relatives &agrave; la recherche en cours
sont t&eacute;l&eacute;charg&eacute;es dans les navigateurs des utilisateurs. Le syst&egrave;me peut &eacute;galement &ecirc;tre stock&eacute; localement.
Par d&eacute;faut, tous les fichiers de sortie WebHelp sont enregistr&eacute;s dans un sous-dossier de projet (!SSL!/WebHelp). Le
dossier WebHelp contient des sous-dossiers. Vous ne devez ni renommer, ni d&eacute;placer ces dossiers afin de conserver la
structure de projet intacte.
• Pour distribuer WebHelp avec une application, copiez le dossier WebHelp et son contenu &agrave; l’emplacement indiqu&eacute;
par le d&eacute;veloppeur. Fournissez-lui le nom de la page de lancement (fichier HTM).
• Pour publier les fichiers WebHelp sur un serveur, un site Web ou tout autre emplacement sur le r&eacute;seau, commencez
par publier les sous-projets dans le dossier appropri&eacute; du sous-dossier MergedProjects.
• Si vous distribuez WebHelp en tant que produit autonome, copiez le dossier WebHelp et son contenu sur un CDROM, un serveur ou &agrave; n’importe quel emplacement sur les syst&egrave;mes des utilisateurs. Indiquez aux utilisateurs la
page de lancement (fichier HTM) &agrave; s&eacute;lectionner pour l’affichage du syst&egrave;me d’aide.
Fichiers de sortie dans le dossier WebHelp
Lors de la g&eacute;n&eacute;ration de WebHelp, les fichiers de sortie suivants sont cr&eacute;&eacute;s dans les sous-dossiers du dossier du projet.
Remarque : n’importez pas les fichiers HTM g&eacute;n&eacute;r&eacute;s par WebHelp dans votre projet. Ces fichiers s'utilisent uniquement
lors de l'ex&eacute;cution.
Derni&egrave;re mise &agrave; jour le 16/3/2011
345
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Fichier
Description
cshdat_robohelp.htm
Donn&eacute;es d’aide contextuelle
cshdat_webhelp.htm
Fichier de support h&eacute;rit&eacute; pour les API contextuelles
default.css
Feuille de style
default.skn
Habillage par d&eacute;faut
EHLPDHTM.JS
JavaScript pour des fonctionnalit&eacute;s avanc&eacute;es telles que les effets HTML dynamiques
Fichiers .GIF
Images pour les habillages, la navigation et les s&eacute;quences de navigation
NouveauProjet.htm
Page de lancement du projet
NouveauProjet.log
Liste tous les fichiers n&eacute;cessaires
NouveauProjet_csh.htm
Fichier de support h&eacute;rit&eacute; pour les API contextuelles
NouveauProjet_rhc.htm
Prise en charge des API contextuelles
webhelp.jar
Prise en charge des applets WebHelp
whestart.ico
Ic&ocirc;ne du menu Favoris d’Internet Explorer
whfbody.htm
Volet inf&eacute;rieur de la recherche de texte int&eacute;gral
whfdhtml.htm
Jeu de cadres de la recherche de texte int&eacute;gral
whfform.htm
Volet sup&eacute;rieur de la recherche de texte int&eacute;gral
whfhost.js
JavaScript pour la recherche de texte int&eacute;gral
whform.js
Champs de recherche de l’index et de texte int&eacute;gral
whframes.js
Jeux de cadres
whgbody.htm
Terme du glossaire
whgdef.htm
D&eacute;finition du glossaire
whgdhtml.htm
Gestion des termes de glossaire et des d&eacute;finitions
whghost.js
Prise en charge du glossaire
whhost.js
Liste et chargement des fichiers dans l’index et le glossaire
whibody.htm
Volet inf&eacute;rieur de l’index
whidhtml.htm
Jeu de cadres de l’index
whiform.htm
Volet sup&eacute;rieur de l’index
whihost.js
Prise en charge de l’index
whlang.js
Prise en charge de la langue
whmozemu.js
Fonctionnalit&eacute;s de Netscape Navigator
whmsg.js
D&eacute;finition et structure des types de message
whnjs.htm
S’affiche lorsque JavaScript est d&eacute;sactiv&eacute;
whphost.js
D&eacute;termine le contenu du projet
whproj.htm
Donn&eacute;es de projet
WHPROJ.JS
JavaScript prenant en charge WHPROJ.HTM
Derni&egrave;re mise &agrave; jour le 16/3/2011
346
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Fichier
Description
whproj.xml
Donn&eacute;es de projet XML
whproxy.js
Prise en charge de la structure
whres.xml
Prise en charge des applets (polices et couleurs personnalis&eacute;es)
whskin_banner.htm
Pour la cr&eacute;ation de logos de bo&icirc;te de dialogue A propos de (habillages)
whskin_blank.htm
Fichier de support (identique &agrave; _blank.htm) (habillages)
whskin_frmset01.htm
Jeu de cadres s&eacute;parant le volet de navigation, la barre de navigation et les rubriques (habillages)
whskin_frmset010.htm
Jeu de cadres s&eacute;parant le volet de navigation et la barre de navigation (habillages)
whskin_info.htm
Page d’information du syst&egrave;me (habillages)
whskin_mbars.htm
Prise en charge de la barre de navigation (habillages)
whskin_papplet.htm
Volet de navigation pour l’applet (habillages)
whskin_pdhtml.htm
Volet de navigation pour le format HTML dynamique (habillages)
whskin_plist.htm
Volet de navigation pour le format HTML pur
whskin_tbars.htm
Barre d’outils (habillages)
whst_topics.xml
Analyse des rubriques pendant la g&eacute;n&eacute;ration
whstart.ico
Ic&ocirc;ne WebHelp
whstart.js
Prise en charge des pages de lancement
whstub.js
Prise en charge de la structure
whtbar.js
Prise en charge de la barre de navigation
whtdhtml.htm
Corps de la table des mati&egrave;res
whthost.js
Prise en charge de la table des mati&egrave;res
whtopic.js
Prise en charge de la barre de navigation dans une rubrique
whutils.js
Prise en charge des fonctionnalit&eacute;s courantes
whver.js
D&eacute;termine la version du navigateur.
Fichiers de sortie du sous-dossier Whgdata
Les fichiers du sous-dossier !SSL!\Webhelp\Whgdata sont utilis&eacute;s avec WebHelp au format HTML pur.
Fichier
Description
whexpbar.gif
D&eacute;finit la largeur du volet de navigation par d&eacute;faut
whlstf0.htm
Corps de la recherche de texte int&eacute;gral
whlstfl0.htm
Lettres de recherche de texte int&eacute;gral de deuxi&egrave;me niveau
whlstg0.htm
Terme du glossaire
whlsti0.htm
Termes d’index
whlstt0.htm
Table des mati&egrave;res (2&egrave;me partie)
whlstt1.htm
Table des mati&egrave;res (2&egrave;me partie)
Derni&egrave;re mise &agrave; jour le 16/3/2011
347
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Fichier
Description
whnvf30.htm
Cadre de la table des mati&egrave;res
whnvf31.htm
Cadre de l’index
whnvf32.htm
Cadre de la recherche de texte int&eacute;gral
whnvf33.htm
Cadre du glossaire
whnvl31.htm
Lettres d’index de premier niveau
whnvl32.htm
Lettres de recherche de texte int&eacute;gral de premier niveau
whnvl33.htm
Lettres du glossaire
whnvp30.htm
Volet de navigation de la table des mati&egrave;res
whnvp31.htm
Volet de navigation de l’index
whnvp32.htm
Volet de navigation de la recherche de texte int&eacute;gral
whnvp33.htm
Volet de navigation du glossaire
whnvt30.htm
Onglets de la table des mati&egrave;res
whnvt31.htm
Onglets de l’index
whnvt32.htm
Onglets de la recherche de texte int&eacute;gral
whnvt33.htm
Onglets du glossaire
Fichiers de sortie dans le sous-dossier Whdata
Les fichiers du sous-dossier !SSL!\Webhelp\Whdata sont destin&eacute;s aux versions DHTML de WebHelp sur des
navigateurs anciens.
Fichier
Description
whftdata0.htm
Donn&eacute;es de recherche de texte int&eacute;gral - Prise en charge HTML
whftdata.js
Donn&eacute;es de recherche de texte int&eacute;gral - Prise en charge de WHFDATA0.HTM par JavaScript
whftdata0.xml
Donn&eacute;es de recherche de texte int&eacute;gral - Prise en charge XML
whFull-text search.htm
Donn&eacute;es de l’index de recherche de texte int&eacute;gral - Prise en charge HTML
whFull-text search.js
Donn&eacute;es de l’index de recherche de texte int&eacute;gral - Prise en charge de whFull-text search.htm par
JavaScript
whFull-text search.xml
Donn&eacute;es de l’index de recherche de texte int&eacute;gral - Prise en charge XML
whfwdata0.htm
Mots-cl&eacute;s de recherche de texte int&eacute;gral - Prise en charge HTML
whfwdata.js
Donn&eacute;es de l’index de recherche de texte int&eacute;gral - Prise en charge de whfwdata0.htm par
JavaScript
whfwdata0.xml
Mots-cl&eacute;s de recherche de texte int&eacute;gral - Prise en charge XML
whgdata.js
Chargement des d&eacute;finitions des termes du glossaire
whGlossary.htm
Donn&eacute;es d’index du glossaire - Prise en charge HTML
whGlossary.js
Donn&eacute;es d’index du glossaire - Prise en charge de whGlossary.htm par JavaScript
whGlossary.xml
Donn&eacute;es d’index du glossaire - Prise en charge XML
whidata0.htm
Donn&eacute;es d’index pour les navigateurs autres que XML
Derni&egrave;re mise &agrave; jour le 16/3/2011
348
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Fichier
Description
whidata.js
Prise en charge de WHIDATA0.HTM par JavaScript
whidata0.xml
Donn&eacute;es d’index -Version XML
whidx.htm
Index des donn&eacute;es d’index - Prise en charge HTML
whidx.js
Index des donn&eacute;es d’index - Prise en charge de whidx.htm par JavaScript
whidx.xml
Index des donn&eacute;es d’index -Version XML
whtdata0.htm
Donn&eacute;es de la table des mati&egrave;res - Prise en charge HTML
whtdata.js
Donn&eacute;es de la table des mati&egrave;res - Prise en charge de whtdata0.htm par JavaScript
whtdata0.xml
Donn&eacute;es de la table des mati&egrave;res - Prise en charge XML
whtoc.htm
Index de table des mati&egrave;res du fichier de contenu - Prise en charge HTML
whtoc.js
Index de table des mati&egrave;res du fichier de contenu - Prise en charge de whtoc.htm par JavaScript
whtoc.xml
Index de table des mati&egrave;res du fichier de contenu - Prise en charge XML
Fichiers de sortie du sous-dossier Whxdata
Les fichiers du sous-dossier !SSL!\Webhelp\Whxdata sont utilis&eacute;s dans des applets Java et des versions DHTML de
WebHelp sur des navigateurs r&eacute;cents.
Fichier
Description
whftdata0.xml
Donn&eacute;es de recherche de texte int&eacute;gral
WHFTS.XML
Donn&eacute;es de l’index de recherche de texte int&eacute;gral
WHFWDATA0.XML
Mots-cl&eacute;s de recherche de texte int&eacute;gral
WHGDATA0.XML
Donn&eacute;es de d&eacute;finitions du glossaire
WHGLO.XML
Donn&eacute;es d’index du glossaire
WHIDATA0.XML
Donn&eacute;es d’index
WHIDX.XML
Index des donn&eacute;es d’index
WHTDATA0.XML
Donn&eacute;es de la table des mati&egrave;res
WHTOC.XML
Index de table des mati&egrave;res du fichier de contenu
Distribution de FlashHelp
Pour pouvoir afficher FlashHelp, il est n&eacute;cessaire de disposer d’un navigateur et de Flash Player 8.0 ou version
ult&eacute;rieure. Si le syst&egrave;me d'aide est stock&eacute; localement, la.
Par d&eacute;faut, tous les fichiers de sortie FlashHelp sont enregistr&eacute;s dans un sous-dossier de projet (!SSL!/FlashHelp). Lors
de la g&eacute;n&eacute;ration de FlashHelp, vous pouvez sp&eacute;cifier le nom du dossier h&eacute;bergeant les fichiers source FlashHelp, ainsi
que le nom de la page de lancement.
Si le projet contient des sous-dossiers, ils sont inclus dans le dossier FlashHelp, ainsi que les fichiers qui s’y trouvent.
Vous ne devez ni renommer, ni d&eacute;placer ces dossiers, afin de conserver la structure de projet intacte.
Derni&egrave;re mise &agrave; jour le 16/3/2011
349
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Distribution de FlashHelp avec une application
❖ Copiez le dossier FlashHelp et son contenu dans un emplacement d&eacute;sign&eacute; par le d&eacute;veloppeur. Indiquez-lui le fichier
.htm &agrave; utiliser comme page de lancement.
Publication de FlashHelp sur un disque, un serveur ou un ordinateur
1 Copiez le dossier FlashHelp et son contenu sur un disque, un serveur ou un ordinateur local.
2 Indiquez aux utilisateurs la page de lancement (fichier .htm) &agrave; s&eacute;lectionner pour l’affichage du syst&egrave;me d’aide.
Fichiers de sortie FlashHelp
Les fichiers de sortie sont cr&eacute;&eacute;s lorsque vous g&eacute;n&eacute;rez un syst&egrave;me FlashHelp dans RoboHelp. Lors de la g&eacute;n&eacute;ration du
projet, les fichiers de sortie sont enregistr&eacute;s par d&eacute;faut dans un sous-dossier intitul&eacute; FlashHelp.
Fichiers de sortie dans le dossier FlashHelp
Fichier
Description
cshdat_WEBHELP.htm
Fichier de support h&eacute;rit&eacute; pour les API contextuelles
*.css
Feuille de style
*.FHS
Fichier d’habillage FlashHelp
WF_TOPICS.CSS
Feuille de style pour les barres de d&eacute;filement des rubriques personnalis&eacute;es (g&eacute;n&eacute;r&eacute;e suivant les
param&egrave;tres de l’habillage FlashHelp)
EHLPDHTM.JS
Contient des fonctions JavaScript servant aux fonctionnalit&eacute;s avanc&eacute;es de RoboHelp (par exemple,
effets DHTML)
Fichiers .GIF
Images d’habillage, de navigation et des s&eacute;quences de navigation
&lt;NomProjet&gt;.htm
Page de lancement du projet
&lt;NomProjet&gt;_csh.htm
Fichier de support h&eacute;rit&eacute; pour les API contextuelles
&lt;NomProjet&gt;_rhc.htm
Fichiers de support des API d’aide contextuelle
wf_favicon.ico
Ic&ocirc;ne du menu Favoris dans Internet Explorer
WF_*.HTM
Fichiers FLA d’ex&eacute;cution de FlashHelp
SKIN_*.SWF
Fichiers d’habillage
WFRES.XML
Fichier de localisation (g&eacute;n&eacute;r&eacute; &agrave; partir du fichier LNG) contenant toutes les cha&icirc;nes charg&eacute;es dans le
syst&egrave;me FlashHelp lors de l’ex&eacute;cution
WHPROJ.XML
Fichier de projet utilis&eacute; par la version DHTML de FlashHelp pour charger les donn&eacute;es de navigation
whmozemu.js
Fonctions prises en charge dans Netscape Navigator
WF_MASTER.JS
Fichier JavaScript requis pour l’ex&eacute;cution de FlashHelp
wf_dispatcher.js
Fichier JavaScript requis pour l’ex&eacute;cution de FlashHelp
whtopic.js
Fichier de support de rubrique (barre de navigation interne aux rubriques).
whutils.js
Fichier d’utilitaire pour les fonctions courantes
whver.js
D&eacute;termine la version du navigateur
Derni&egrave;re mise &agrave; jour le 16/3/2011
350
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Fichiers de sortie du sous-dossier whgdata
Fichier
Description
whexpbar.gif
D&eacute;finit la largeur du volet de navigation par d&eacute;faut
whlstf0.htm
Corps de la recherche de texte int&eacute;gral
whlstfl0.htm
Lettres de recherche de texte int&eacute;gral de niveau 2
whlstg0.htm
Liste des termes du glossaire
whlsti0.htm
Liste des termes de l’index
whlstt0.htm
Liste de table des mati&egrave;res (1&egrave;re partie)
whlstt1.htm
Liste de table des mati&egrave;res (2&egrave;me partie)
whnvf30.htm
Cadre de la table des mati&egrave;res
whnvf31.htm
Cadre de l’index
whnvf32.htm
Cadre de la recherche de texte int&eacute;gral
whnvf33.htm
Cadre du glossaire
whnvl31.htm
Lettres d’index de niveau 1
whnvl32.htm
Lettres de recherche de texte int&eacute;gral de niveau 1
whnvl33.htm
Lettres du glossaire
whnvp30.htm
Volet de navigation de la table des mati&egrave;res
whnvp31.htm
Volet de navigation de l’index
whnvp32.htm
Volet de navigation de la recherche de texte int&eacute;gral
whnvp33.htm
Volet de navigation du glossaire
whnvt30.htm
Onglets de la table des mati&egrave;res
whnvt31.htm
Onglets de l’index
whnvt32.htm
Onglets de la recherche de texte int&eacute;gral
whnvt33.htm
Onglets du glossaire
Fichiers de sortie du sous-dossier whxdata
Les fichiers de sortie stock&eacute;s dans le dossier !Sl!\Flashhelp\whxdata sont des fichiers de donn&eacute;es XML utilis&eacute;s dans les
versions Applet Java et DHTML de FlashHelp ex&eacute;cut&eacute;es sur des navigateurs r&eacute;cents.
Fichier
Description
whftdata0.xml
Fichier de donn&eacute;es de la recherche de texte int&eacute;gral
WHFTS.XML
Fichier de donn&eacute;es d’index de la recherche de texte int&eacute;gral
WHFWDATA0.XML
Donn&eacute;es de mots-cl&eacute;s de la recherche de texte int&eacute;gral
WHGDATA0.XML
Fichier de donn&eacute;es de d&eacute;finitions du glossaire
WHGLO.XML
Fichier de donn&eacute;es d’index du glossaire
WHIDATA0.XML
Fichier de donn&eacute;es d’index
Derni&egrave;re mise &agrave; jour le 16/3/2011
351
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Fichier
Description
WHIDX.XML
Fichier de donn&eacute;es d’index de l’index
WHTDATA0.XML
Fichier de donn&eacute;es de la table des mati&egrave;res
WHTOC.XML
Index de table des mati&egrave;res du fichier de contenu
Remarque : n’importez pas les fichiers de sortie HTM g&eacute;n&eacute;r&eacute;s par FlashHelp dans vos projets. Ces fichiers s’utilisent
uniquement lors de l’ex&eacute;cution.
Distribution d’une aide Microsoft HTML Help
1 Distribuez les fichiers d’aide syst&egrave;me suivants au d&eacute;veloppeur, afin qu’il les installe avec le fichier ex&eacute;cutable du
programme (EXE). Vous pouvez &eacute;galement distribuer les fichiers pour une utilisation autonome.
Remarque : les utilisateurs peuvent ex&eacute;cuter une version autonome de Microsoft HTML Help en cliquant deux fois
sur le fichier CHM dans l’Explorateur Windows.
CHM Syst&egrave;me d’aide distribu&eacute; dans un fichier d’aide unique, venant s’ajouter aux fichiers CHM des sous-projets
associ&eacute;s au projet ma&icirc;tre. Ces fichiers CHM enfants ne sont pas compil&eacute;s dans le fichier CHM ma&icirc;tre.
HLP, CNT Si le projet comprend des liens vers des rubriques dans un fichier WinHelp compil&eacute;, distribuez les
fichiers HLM et CNT. Ils ne sont pas compil&eacute;s dans le fichier CHM ma&icirc;tre.
DOC, PDF, XLS Si le projet comprend des liens vers des fichiers externes, distribuez ces derniers. Ils ne sont pas
compil&eacute;s dans le fichier CHM ma&icirc;tre, sauf s’ils sont ajout&eacute;s dans le dossier Fichiers bagage.
2 Le d&eacute;veloppeur de l’application distribue les fichiers de support suivants, selon les fonctionnalit&eacute;s utilis&eacute;es dans le
projet et les versions de Windows dont disposent les utilisateurs.
• Fichiers de support Microsoft HTML Help : composants int&eacute;gr&eacute;s.
• HHActiveX.DLL est un contr&ocirc;le Adobe ActiveX prenant en charge les glossaires en ligne et les s&eacute;quences de
navigation. Installez et enregistrez ce contr&ocirc;le sur les syst&egrave;mes des utilisateurs. Ce fichier se trouve &agrave;
l’emplacement C:\Fichiers programmes\Adobe\Adobe RoboHelp [version]\RoboHTML. Copiez-le et collez-le
dans le m&ecirc;me dossier que le fichier CHM.
• Si le syst&egrave;me d’aide inclut des contr&ocirc;les ActiveX tiers, installez et enregistrez les fichiers de support des
composants correspondant aux syst&egrave;mes des utilisateurs. Les utilisateurs copient les fichiers des contr&ocirc;les
ActiveX vers un dossier personnalis&eacute;, en indiquant le chemin d’acc&egrave;s &agrave; l’autre dossier avant l’extension .ocx ou
.dll. Ensuite, ils enregistrent ces fichiers.
Remarque : l’accord de licence Adobe vous autorise &agrave; redistribuer les fichiers Microsoft HTML Help et Internet
Explorer avec la sortie HTML Help.
Enregistrement des contr&ocirc;les ActiveX
Si le projet inclut des contr&ocirc;les ActiveX, transmettez des instructions aux utilisateurs, afin qu’ils puissent enregistrer
les contr&ocirc;les distribu&eacute;s avec le syst&egrave;me d’aide.
1 S&eacute;lectionnez D&eacute;marrer &gt; Ex&eacute;cuter.
2 Pour enregistrer le fichier HHActiveX.DLL, tapez la commande qui suit en indiquant le chemin d’acc&egrave;s au fichier
concern&eacute; et cliquez sur OK :
regsvr32 [path] hhactivex.dll
3 Pour enregistrer les contr&ocirc;les ActiveX tiers, tapez la commande suivante :
regsvr32 [activex_name.dll or activex_name.ocx]
Derni&egrave;re mise &agrave; jour le 16/3/2011
352
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Voir aussi
&laquo; Cr&eacute;ation d’un projet &raquo; &agrave; la page 31
&laquo; Gestion des fichiers &raquo; &agrave; la page 49
&laquo; Contr&ocirc;les ActiveX &raquo; &agrave; la page 392
Distribution de JavaHelp
Distribuez les fichiers et composants ci-dessous.
• Si le projet est compress&eacute;, distribuez le fichier JAR.
• Si le projet n’est pas compress&eacute;, distribuez tous les fichiers source du dossier de sortie.
• Composants JavaHelp 1.1.3 ou version ult&eacute;rieure.
• Fichier de l’environnement JRE (Java Runtime Environment), t&eacute;l&eacute;chargeable &agrave; partir du site Web de Sun.
• Si le projet contient des boutons de rubriques connexes, distribuez le fichier Bsscjhrs.jar.
Fichiers de sortie JavaHelp
Fichier de sortie
Description
.HS
Fichier HelpSet. Pointe vers un jeu de fichiers de mappage et d&eacute;finit les vues de navigation associ&eacute;es
(Table des mati&egrave;res, Index et Recherche).
.JAR
Fichier JavaHelp compress&eacute; (facultatif) contenant la totalit&eacute; du r&eacute;sultat d’un projet.
default.css
Fichier de feuille de style en cascade par d&eacute;faut appliqu&eacute; &agrave; toutes les rubriques du projet.
nomprojet_ndx.xml
Fichier d’index d&eacute;crivant le contenu et la mise en page de l’index.
nomprojet_map.xml
Fichier de mappage associant des ID de rubrique d’aide &agrave; des fichiers HTML avec le contenu
appropri&eacute; et les types de fen&ecirc;tres. Utilis&eacute; dans l’API pour les appels de fen&ecirc;tres contextuelles, la table
des mati&egrave;res et l’index.
nomprojet_toc.xml
Fichier de la table des mati&egrave;res d&eacute;crivant le contenu et la mise en page de la table des mati&egrave;res.
Distribution d’Oracle Help
Lorsque vous g&eacute;n&eacute;rez la sortie, vous pouvez compresser l’ensemble des fichiers source en un fichier JAR unique. Ce
fichier sert aux applications logicielles et peut &ecirc;tre distribu&eacute; sous forme autonome.
❖ Lorsque vous distribuez Oracle Help, incluez les composants ci-dessous.
• Si le projet est compress&eacute;, distribuez le fichier JAR
• Si le projet n’est pas compress&eacute;, distribuez tous les fichiers et sous-dossiers du dossier de sortie OracleHelp
• Composants JavaHelp 1.1.3 ou version ult&eacute;rieure
• Environnement JRE (Java Runtime Environment) ou JDK (Java Development Kit).
Derni&egrave;re mise &agrave; jour le 16/3/2011
353
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Fichiers de sortie Oracle Help
Fichier
Description
.HS
Fichier HelpSet. Pointe vers un jeu de fichiers de mappage et d&eacute;finit les vues de navigation associ&eacute;es
(Table des mati&egrave;res, Index et Recherche).
.JAR
Fichier Oracle Help compress&eacute; (facultatif) contenant la totalit&eacute; du r&eacute;sultat d’un projet.
default.css
Fichier de feuille de style en cascade par d&eacute;faut appliqu&eacute; &agrave; toutes les rubriques du projet.
Numeroprojet_fts.idx
Fichier de recherche de texte int&eacute;gral contenant la base de donn&eacute;es de recherche de texte int&eacute;gral.
Numeroprojet_nd.xml
Fichier d’index d&eacute;crivant le contenu et la mise en page de l’index.
Numeroprojet_lnk.xml
Fichier contenant les liens associatifs (contr&ocirc;les Voir aussi) vers des rubriques assign&eacute;es &agrave; des motscl&eacute;s Voir aussi.
Numeroprojet_map.xml
Fichier de mappage associant des ID de rubrique d’aide &agrave; des fichiers HTML avec le contenu
appropri&eacute; et les types de fen&ecirc;tres. Utilis&eacute; dans l’API pour les appels de fen&ecirc;tres contextuelles, la table
des mati&egrave;res et l’index.
Numeroprojet_toc.xml
Fichier de la table des mati&egrave;res d&eacute;crivant le contenu et la mise en page de la table des mati&egrave;res.
Distribution de la sortie XML
Lors de la g&eacute;n&eacute;ration, les fichiers de sortie CSS, XSL, XML, HTM et GIF sont cr&eacute;&eacute;s dans un sous-dossier du dossier du
projet. Les autres fichiers incluent les &eacute;l&eacute;ments ci-dessous.
Fichiers de sortie dans le dossier XML_Output
Description
EHLPDHTM.JS
Contient les fonctions JavaScript assurant les fonctionnalit&eacute;s avanc&eacute;es
NouveauProjet.htm
Page de lancement du projet
NouveauProjet.log
Fichier de sortie r&eacute;pertoriant les fichiers requis
Voir aussi
&laquo; Affichage de la sortie &raquo; &agrave; la page 338
Distribution de la sortie Adobe AIR
La distribution de la sortie Adobe AIR d&eacute;pend du type de sortie que vous s&eacute;lectionnez.
Derni&egrave;re mise &agrave; jour le 16/3/2011
354
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Type de sortie
Fichier(s) &agrave; distribuer
Requis sur les ordinateurs des
utilisateurs
Application Adobe AIR
Fichier AIR (.air) g&eacute;n&eacute;r&eacute; &agrave; l'emplacement de sortie
Ex&eacute;cution d'AIR
Reportez-vous &agrave; la section Distribution
d'ex&eacute;cution d'Adobe AIR
Aide accessible par navigateur
Application AIR et aide accessible par
navigateur
Tous les fichiers g&eacute;n&eacute;r&eacute;s dans le dossier de sortie
Plug-in Flash 9.0 ou version ult&eacute;rieure
Si vous distribuez une aide accessible par navigateur en
tant que syst&egrave;me d’aide autonome, copiez le dossier de
sortie et son contenu sur un CD-ROM, sur un serveur ou
dans un emplacement quelconque sur les syst&egrave;mes des
utilisateurs. Indiquez aux utilisateurs la page de
lancement (fichier HTM) &agrave; s&eacute;lectionner pour afficher le
syst&egrave;me d’aide.
Reportez-vous &agrave; la section Configuration
de FlashPlayerTrust pour ex&eacute;cuter une
aide locale bas&eacute;e sur un navigateur.
Distribuer s&eacute;par&eacute;ment :
Ex&eacute;cution d'AIR
Fichier AIR (.air) g&eacute;n&eacute;r&eacute; &agrave; l'emplacement de sortie
Plug-in Flash 9.0 ou version ult&eacute;rieure
Tous les fichiers g&eacute;n&eacute;r&eacute;s dans le dossier de sortie
Contenu de l’aide seulement
Fichier RHA (.rha) g&eacute;n&eacute;r&eacute; &agrave; l'emplacement de sortie
Ex&eacute;cution d'AIR
Configuration de FlashPlayerTrust pour ex&eacute;cuter une aide locale bas&eacute;e sur un navigateur
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.
1 S&eacute;lectionnez D&eacute;marrer &gt; Ex&eacute;cuter.
2 Tapez %appdata%\Macromedia\Flash Player\#Security\FlashPlayerTrust\ et cliquez sur OK.
3 Ouvrez le fichier RoboHelp.cfg dans un &eacute;diteur de texte.
4 Ajoutez le chemin d’acc&egrave;s au dossier local dans lequel sont stock&eacute;s les fichiers de l’aide accessible par navigateur.
Mot de passe du mod&eacute;rateur et chemin du fichier de configuration
Lorsque vous distribuez la sortie Adobe AIR, assurez-vous de partager le mot de passe du mod&eacute;rateur et le chemin du
fichier de configuration sp&eacute;cifi&eacute; lors de la g&eacute;n&eacute;ration de la sortie.
Les organisations qui d&eacute;ploient la sortie ont besoin du mot de passe pour activer la mod&eacute;ration et permettre l’acc&egrave;s des
mod&eacute;rateurs au tableau de bord de mod&eacute;ration.
Elles ont &eacute;galement besoin du chemin du fichier de configuration pour enregistrer le fichier de configuration apr&egrave;s
avoir configur&eacute; la synchronisation et la mise &agrave; jour automatique des commentaires selon leurs pr&eacute;f&eacute;rences. Si le
chemin du fichier de configuration est un chemin relatif, le m&ecirc;me fichier d’aide AIR peut &ecirc;tre install&eacute; dans des
emplacements diff&eacute;rents avec des configurations diff&eacute;rentes.
Attributs du fichier de configuration
Les organisations qui d&eacute;ploient l’aide AIR peuvent d&eacute;sormais configurer les commentaires et la mise &agrave; jour
automatique selon leurs pr&eacute;f&eacute;rences. Copiez 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 modifiez les param&egrave;tres par d&eacute;faut.
Le fichier de configuration contient les param&egrave;tres suivants :
config topicrating : active ou d&eacute;sactive l’&eacute;valuation de rubrique Les valeurs valides sont &laquo; yes &raquo; ou &laquo; no &raquo;.
commentsync : active ou d&eacute;sactive les commentaires. Les valeurs valides sont &laquo; yes &raquo; ou &laquo; no &raquo;.
Derni&egrave;re mise &agrave; jour le 16/3/2011
355
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
updatecommentlocation : Sp&eacute;cifie le chemin que l’aide AIR utilise en vue de la synchronisation des commentaires
lorsqu’aucun emplacement de commentaire de mise &agrave; jour sp&eacute;cifique du syst&egrave;me d’exploitation n’est sp&eacute;cifi&eacute;.
windowsupdatecommentlocation : sp&eacute;cifie l’emplacement partag&eacute; pour le stockage et la synchronisation des
commentaires sur les ordinateurs Windows.
macupdatecommentlocation : sp&eacute;cifie l’emplacement partag&eacute; pour le stockage et la synchronisation des
commentaires sur les ordinateurs MAC OS.
linuxupdatecommentlocation : sp&eacute;cifie l’emplacement partag&eacute; pour le stockage et la synchronisation des
commentaires sur les ordinateurs Linux.
marknewcommentsaspending : sp&eacute;cifie si de nouveaux commentaires doivent avoir l’&eacute;tat &laquo; En attente &raquo; ou
&laquo; Accept&eacute; &raquo;. Les valeurs valides sont &laquo; yes &raquo; et &laquo; no &raquo;.
Remarque : les commentaires en attente doivent &ecirc;tre mod&eacute;r&eacute;s pour que les utilisateurs puissent les voir.
autoupdate : active ou d&eacute;sactive la mise &agrave; jour automatique. Les valeurs valides sont &laquo; yes &raquo; et &laquo; no &raquo;.
windowsupdatexmllocation : sp&eacute;cifie l’emplacement du fichier XML de mise &agrave; jour automatique sur les ordinateurs
Windows.
macupdatexmllocation : sp&eacute;cifie l’emplacement du fichier XML de mise &agrave; jour automatique sur les ordinateurs
MAC OS.
linuxupdatexmllocation : sp&eacute;cifie l’emplacement du fichier XML de mise &agrave; jour automatique sur les ordinateurs
Linux.
updatexmllocation : sp&eacute;cifie l’emplacement du fichier XML de mise &agrave; jour automatique.
Remarque : RoboHelp v&eacute;rifie la pr&eacute;sence de cet attribut avant de contr&ocirc;ler l’attribut updatexmllocation sp&eacute;cifique au
syst&egrave;me d’exploitation. Si cet attribut est pr&eacute;sent, RoboHelp ne v&eacute;rifie pas les attributs updatexmllocation sp&eacute;cifiques au
syst&egrave;me d’exploitation.
logoimage : sp&eacute;cifie l’emplacement du fichier image &agrave; utiliser pour afficher un logo dans l’aide AIR.
companytext : sp&eacute;cifie le nom de l’entreprise qui s’affiche dans la barre d’&eacute;tat de l’aide AIR (par exemple, Powered By
Adobe RoboHelp).
Format des URL formats pour Windows, Mac et Linux
Lors de la configuration des param&egrave;tres de collaboration de l’application Adobe AIR, sp&eacute;cifiez les chemins d’acc&egrave;s
dans les formats suivants :
Windows
Mac
Linux
Fichier du disque file:///C:/config.xml
dur
file:///Applications/config.xml
file:///etc/config.xml
Fichier du lecteur file:////robohelpserver/config.xml
r&eacute;seau
file:///Volumes/robohelpserver/config.xml
file:///media/robohelpserver/config.xml
A propos de la modification de l’&eacute;tat des nouveaux commentaires
Les auteurs d&eacute;finissent l’&eacute;tat des nouveaux commentaires sur En attente ou Accept&eacute; au moment de la g&eacute;n&eacute;ration de la
sortie Adobe AIR.
Les utilisateurs peuvent acc&eacute;der au fichier settings.xml pr&eacute;sent &agrave; l’emplacement r&eacute;seau pour le stockage et la
synchronisation des commentaires et changer l’&eacute;tat par d&eacute;faut des nouveaux commentaires. Si l’&eacute;tat est d&eacute;fini sur En
attente, les nouveaux commentaires doivent &ecirc;tre mod&eacute;r&eacute;s. Dans le cas contraire, les nouveaux commentaires sont
accept&eacute;s sans mod&eacute;ration et affich&eacute;s &agrave; l’intention des utilisateurs.
Derni&egrave;re mise &agrave; jour le 16/3/2011
356
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Documents imprim&eacute;s
A propos des documents imprim&eacute;s
La sortie en ligne et les documents imprim&eacute;s peuvent partager des fichiers source. De m&ecirc;me, vous pouvez g&eacute;n&eacute;rer des
fichiers PDF et imprimer des documents &agrave; partir des m&ecirc;mes fichiers source.
Organisation et personnalisation du contenu
Vous pouvez concevoir un document imprim&eacute; bas&eacute; sur une partie ou sur la totalit&eacute; du projet. D&eacute;terminez la
destination des rubriques dans le document en disposant les pages et les livres lors de la g&eacute;n&eacute;ration. Vous pouvez baser
la structure du document imprim&eacute; sur la table des mati&egrave;res du projet ou s&eacute;lectionner des rubriques &agrave; partir de dossiers
personnalis&eacute;s dans le gestionnaire de projets.
Mappage de styles de projet dans Word
Mappez les styles pour en contr&ocirc;ler l’utilisation dans les documents imprim&eacute;s. Copiez les styles du projet directement
dans un document Word. Tout style du projet appliqu&eacute; conserve le style de Word. Vous pouvez &eacute;galement ignorer le
mappage des styles et utiliser les styles de la rubrique.
Types de documents Word &agrave; cr&eacute;er
Documents individuels Fichiers Word s&eacute;par&eacute;s pour la page de titre, la table des mati&egrave;res, le glossaire et l’index. Un
document s&eacute;par&eacute; est &eacute;galement cr&eacute;&eacute; pour chaque livre (chapitre) et page de niveau racine dans la table des mati&egrave;res
imprim&eacute;e.
Document ma&icirc;tre Document facultatif qui est li&eacute; aux documents individuels. Exige une bonne connaissance des
documents ma&icirc;tres dans Word. Ne modifiez pas ce fichier, car il contient des codes de champ r&eacute;f&eacute;ren&ccedil;ant tous les
documents. N’utilisez pas de document ma&icirc;tre pour les manuels volumineux.
Document unique Cr&eacute;e un seul fichier Word contenant la page titre, la table des mati&egrave;res, les chapitres, le glossaire et
l’index.
Structure du document imprim&eacute;
• Les livres et les pages au niveau racine du document imprim&eacute; correspondent au d&eacute;but d’un nouveau chapitre.
• Les livres et pages de niveau secondaire se suivent sans interruption.
• Pour les livres incluant des liens vers des pages, la destination du lien est plac&eacute;e directement apr&egrave;s le livre dans le
document imprim&eacute;.
• Les pages comprenant un lien vers une destination autre qu’une rubrique ne sont pas disponibles dans le document
imprim&eacute;.
• La bo&icirc;te de dialogue Mise en page de section permet d’organiser les sections du r&eacute;sultat de la documentation
imprim&eacute;e.
Conversion des fonctions en ligne
RoboHelp convertit plusieurs fonctions communes du projet, tout en en supprimant d’autres (contr&ocirc;les ActiveX,
bordures, DHTML, en-t&ecirc;tes et pieds de page, JavaScript, contr&ocirc;les de lien et bordures de rubrique). Le tableau suivant
fournit des informations sur la conversion de fonctions sp&eacute;cifiques.
Derni&egrave;re mise &agrave; jour le 16/3/2011
357
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Fonction
Informations sur la conversion
Puces et num&eacute;rotation
Conversion (except&eacute; l’image de la puce).
Balises de construction conditionnelles
Les rubriques et le contenu des rubriques exclus avec des expressions
et des balises de construction conditionnelles sont supprim&eacute;s.
Zones cliquables d&eacute;roulantes et zones cliquables &agrave; d&eacute;velopper
Si indiqu&eacute;, le texte &agrave; d&eacute;velopper et d&eacute;roulant appara&icirc;t en ligne.
Mappez un style sur les zones cliquables pour que leur aspect soit
diff&eacute;rent de celui du reste du texte.
Zones cliquables de glossaire &agrave; d&eacute;velopper
Une fois s&eacute;lectionn&eacute;, le texte &agrave; d&eacute;velopper ou le texte d&eacute;roulant de la
sortie imprim&eacute;e est converti et s’affiche en ligne. Mappez un style sur
les zones cliquables pour que leur aspect soit diff&eacute;rent de celui du
reste du texte.
Jeux de polices
Word utilise la premi&egrave;re police. Si la premi&egrave;re police n’existe pas, Word
cr&eacute;e une police par d&eacute;faut.
Formulaires
Conversion au format HTML dans Word. Les formulaires tiers sont
supprim&eacute;s des documents.
Images
Indiquez si vous souhaitez positionner ou int&eacute;grer les images. Les
images positionn&eacute;es sont incluses dans un dossier images du dossier
de sortie. Int&eacute;grez les images si vous voulez les incorporer au
document. Les images peuvent &ecirc;tre incluses dans les en-t&ecirc;tes et
&eacute;galement appara&icirc;tre dans la table des mati&egrave;res imprim&eacute;e.
Texte d&eacute;filant
Conversion au format texte dans Word.
Zones de texte positionn&eacute;es
Converties et plac&eacute;es &agrave; la fin du document ou au bas de la page.
Trame
Les remplissages sont convertis mais les motifs ne le sont pas.
Zones de texte
Conversion et redimensionnement pour contenir du texte
uniquement.
Configuration des pages
RoboHelp assigne des param&egrave;tres de page par d&eacute;faut &agrave; la documentation imprim&eacute;e dans Microsoft Word.
Param&egrave;tres de page du corps
Page de lancement Tous les documents commencent sur une page de num&eacute;ro impair. Si le document se termine sur
une page impaire, une page blanche est ajout&eacute;e &agrave; la fin du document. (Elle ne poss&egrave;de ni en-t&ecirc;te, ni pied de page, ni
num&eacute;ro de page.)
En-t&ecirc;tes Les en-t&ecirc;tes se r&eacute;p&egrave;tent en haut de chaque page et sont vides sur la premi&egrave;re page des sections. Le nom du
document s’affiche sur les pages paires, justifi&eacute; &agrave; gauche. Le nom du chapitre racine s’affiche sur les pages impaires,
justifi&eacute; &agrave; droite.
Pieds de page Les pieds de page apparaissent au bas de chaque page et indiquent le num&eacute;ro de celle-ci. Les num&eacute;ros
de page sont justifi&eacute;s &agrave; gauche sur les pages paires et &agrave; droite sur les pages impaires.
Num&eacute;ros de page Les num&eacute;ros de page figurent dans les pieds de page et sont g&eacute;n&eacute;ralement en chiffres arabes (1, 2, 3,
etc.). En revanche, le document de la table des mati&egrave;res utilise des chiffres romains en minuscules (i, ii, iii, etc.).
Param&egrave;tres suppl&eacute;mentaires
Pour cr&eacute;er des documents Word, prenez connaissance des d&eacute;tails suivants, qui concernent les fichiers source et
configurez-les en cons&eacute;quence.
Derni&egrave;re mise &agrave; jour le 16/3/2011
358
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Page de titre
• Cette page utilise les param&egrave;tres du document.
• Indiquez un titre de page par d&eacute;faut au moment de la g&eacute;n&eacute;ration de la documentation imprim&eacute;e.
• Le nom du document qui s’affiche sur la page de titre correspond &agrave; celui du document imprim&eacute; que vous d&eacute;finissez
dans la bo&icirc;te de dialogue Imprimer le document G&eacute;n&eacute;ralit&eacute;s. Cette bo&icirc;te de dialogue appara&icirc;t lorsque vous cliquez
deux fois sur la mise en page de la documentation imprim&eacute;e.
• l’en-t&ecirc;te et le pied de page sont vides.
• La page de titre ne contient pas de num&eacute;ro de page.
• Le document de page de titre utilise le style TitrePageTitre copi&eacute; dans le document Word.
• Le nom de fichier est le suivant : Chapter_{##}_Title_page.doc.
• Lors de l’ajout du fichier, copiez-le dans le dossier du projet pour que RoboHelp g&eacute;n&egrave;re une copie dans le dossier
de sortie.
Table des mati&egrave;res
• La table des mati&egrave;res repose sur les niveaux d’en-t&ecirc;te de rubrique, ainsi que sur la hi&eacute;rarchie adapt&eacute;e au sein de la
structure du document. Vous pouvez d&eacute;finir cette structure dans la bo&icirc;te de dialogue Contenu du document
imprim&eacute;.
Remarque : il est &eacute;galement possible de cr&eacute;er une table des mati&egrave;res dans le gestionnaire de projets. Cliquez avec le
bouton droit de la souris sur une rubrique dans le conteneur Table des mati&egrave;res et s&eacute;lectionnez l’option Cr&eacute;er
automatiquement la table des mati&egrave;res. Les rubriques sont r&eacute;ordonn&eacute;es automatiquement dans le gestionnaire de
projets en fonction de leur position et de leur style d’en-t&ecirc;te, d&eacute;finis dans la structure du document imprim&eacute;.
• La plupart des tables des mati&egrave;res poss&egrave;dent plusieurs niveaux d’en-t&ecirc;te. Cette hi&eacute;rarchie (ou structure) des
informations permet aux utilisateurs de trouver les informations plus rapidement.
• Les entr&eacute;es de table des mati&egrave;res utilisent les styles TOC 1 &agrave; 9.
• Le titre de la table des mati&egrave;res utilise le style Titre de la page de la table des mati&egrave;res.
• Les num&eacute;ros de page de la table des mati&egrave;res s’&eacute;crivent en chiffres romains en minuscules (i, ii, iii, etc.).
• Le nom de fichier est le suivant : Chapter_00_Table_Of_Contents.doc.
Chapitres
• Les fichiers de chapitres contiennent les rubriques sp&eacute;cifi&eacute;es dans la bo&icirc;te de dialogue Imprimer le document
Contenu. Les rubriques et livres de niveau racine cr&eacute;ent des documents, sauf si vous avez s&eacute;lectionn&eacute; l’option
Document unique lors de la g&eacute;n&eacute;ration.
• Les num&eacute;ros de page des documents des chapitres s'&eacute;crivent en chiffres arabes (1, 2, 3, etc.).
• Le nom de fichier est le suivant : Chapter_{##}_{Nom Livre ou Page}.doc.
Glossaire
• Le glossaire est bas&eacute; sur les termes et d&eacute;finitions du projet. S’il n’en existe pas dans le projet, aucun glossaire n’est
g&eacute;n&eacute;r&eacute;.
• Pour convertir les zones cliquables &agrave; d&eacute;velopper dans le glossaire, cliquez sur l’ic&ocirc;ne D&eacute;marrer l’assistant des zones
cliquables du glossaire, dans la barre d’outils Glossaire du conteneur du m&ecirc;me nom. Vous pouvez pr&eacute;ciser si les
d&eacute;finitions sont converties en texte en ligne et si ce texte appara&icirc;t dans le paragraphe qui contenait le terme.
Derni&egrave;re mise &agrave; jour le 16/3/2011
359
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
• Le document de glossaire utilise trois styles copi&eacute;s dans le document Word :
En-t&ecirc;te de glossaire Style utilis&eacute; pour les lettres d’en-t&ecirc;te (A, B, etc.). Si une langue est sp&eacute;cifi&eacute;e pour le projet, les
lettres d’en-t&ecirc;te sont localis&eacute;es dans cette langue.
Libell&eacute; de glossaire Style utilis&eacute; pour les termes du glossaire.
D&eacute;finition du glossaire Style utilis&eacute; pour les d&eacute;finitions du glossaire. Les d&eacute;finitions s’affichent sur la m&ecirc;me ligne
que les termes avec un retrait n&eacute;gatif pour les lignes suivantes.
• Les num&eacute;ros de page du document du glossaire sont des chiffres arabes (1, 2, 3, etc.).
• Par d&eacute;faut, le nom de fichier est Chapter_{##}_Glossary.doc. La valeur ## correspond au num&eacute;ro suivant celui du
dernier chapitre.
Index
• l’index est bas&eacute; sur les mots-cl&eacute;s principaux et secondaires du projet. Les mots-cl&eacute;s de rubrique sont inclus
uniquement si les rubriques associ&eacute;es sont incluses dans le r&eacute;sultat.
• Les styles d’index sont bas&eacute;s sur le style En-t&ecirc;te d’index et Index (1 &agrave; 9) dans le mod&egrave;le Word s&eacute;lectionn&eacute; pour la
documentation imprim&eacute;e.
• Par d&eacute;faut, l’index est plac&eacute; en retrait avec deux colonnes. Si une langue est sp&eacute;cifi&eacute;e pour le projet, les lettres d’ent&ecirc;te sont localis&eacute;es dans cette langue.
• Les num&eacute;ros de page du document de l'index sont des chiffres arabes (1, 2, 3, etc.).
• Le nom de fichier est le suivant : Chapter_{##}_Index.doc. La valeur ## correspond au num&eacute;ro suivant celui du
chapitre du glossaire. Si le document ne contient aucun glossaire, il s’agit du num&eacute;ro suivant celui du dernier
chapitre.
Pages accessoires
• Il s’agit des pages de remerciements, de l’annexe, de l’avant-propos ou des copyrights. Elles conservent toutes leur
format d’origine.
• Le nom de fichier est le suivant : Chapter_{##}_{Nom document}.
• Lorsque vous ajoutez le fichier, vous pouvez le copier dans le dossier du projet. Une copie est &eacute;galement g&eacute;n&eacute;r&eacute;e
dans le dossier de sortie.
• Ajoutez des sections suppl&eacute;mentaires via la bo&icirc;te de dialogue Mise en page de section.
Images
Vous pouvez g&eacute;rer les images de plusieurs mani&egrave;res :
Imbriquer dans des documents Les images sont conserv&eacute;es dans le document. Cette op&eacute;ration cr&eacute;e des fichiers DOC
de taille sup&eacute;rieure, qui ne d&eacute;pendent pas de fichiers image externes.
Lier aux documents R&eacute;f&eacute;rence les images en dehors du document (cr&eacute;e des fichiers DOC de plus petite taille, qui font
r&eacute;f&eacute;rence &agrave; des fichiers image externes). Les fichiers image sont copi&eacute;s et stock&eacute;s dans un dossier Images, situ&eacute; dans le
dossier de sortie du document imprim&eacute;.
les images de styles d’en-t&ecirc;te sont supprim&eacute;es. Modifiez les param&egrave;tres pour inclure des images dans les en-t&ecirc;tes.
Organisation et personnalisation du contenu du document
1 Dans le conteneur Mises en page source uniques, cliquez deux fois sur Documentation imprim&eacute;e.
Derni&egrave;re mise &agrave; jour le 16/3/2011
360
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
2 Dans le champ Options g&eacute;n&eacute;rales du document imprim&eacute;, d&eacute;finissez les options g&eacute;n&eacute;rales du document imprim&eacute;.
Nom Sp&eacute;cifiez le nom du document. Ce nom sera utilis&eacute; dans les en-t&ecirc;tes du document et dans la page de titre.
Emplacement Sp&eacute;cifiez le chemin d’acc&egrave;s aux documents Word. Les documents PDF seront &eacute;galement enregistr&eacute;s
dans cet emplacement. Cette op&eacute;ration cr&eacute;e les fichiers relatifs &agrave; la documentation imprim&eacute;e, localis&eacute;s dans le
r&eacute;pertoire !SSL!\[nom de la mise en page] dans le dossier du projet. Cliquez sur le bouton Parcourir pour sp&eacute;cifier
un dossier diff&eacute;rent. Cliquez sur OK.
Remarque : les deux formats Word DOC et DOCX sont pris en charge par la documentation imprim&eacute;e.
Param&egrave;tres PDF D&eacute;finissez les param&egrave;tres PDF.
Param&egrave;tres S&eacute;lectionnez les options d&eacute;finissant la cr&eacute;ation des fichiers du document.
• G&eacute;n&eacute;rer des documents individuels Cr&eacute;e un fichier Word distinct pour chaque chapitre et section du
document. Un chapitre d&eacute;signe tout livre ou page au niveau racine de la table des mati&egrave;res sp&eacute;cifi&eacute;e dans la bo&icirc;te
de dialogue Contenu du document imprim&eacute;.
• G&eacute;n&eacute;rer un document unique Cr&eacute;e un seul fichier Word contenant la page de titre, la table des mati&egrave;res, les
chapitres, le glossaire et l’index.
Remarque : si vous s&eacute;lectionnez l’option G&eacute;n&eacute;rer des documents individuels, cliquez sur Cr&eacute;er un document ma&icirc;tre
pour permettre l’affichage de tous les documents.
• Conserver les liens hypertexte Choisissez de conserver ou non les liens hypertexte.
• Lancer chaque rubrique dans une nouvelle page Cette option permet de cr&eacute;er des sauts de page.
Images Permet de d&eacute;finir des options d'image.
• Imbriquer dans des documents Les images sont conserv&eacute;es dans le document.
• Lier aux documents R&eacute;f&eacute;rencez les images situ&eacute;es en dehors du document. Les fichiers image sont copi&eacute;s et
stock&eacute;s dans un dossier Images situ&eacute; dans le dossier de sortie du document imprim&eacute;.
par d&eacute;faut, les images incluses dans les styles d’en-t&ecirc;te sont supprim&eacute;es. Pour les inclure, cliquez sur le bouton
Avanc&eacute; et s&eacute;lectionnez Images de la table des mati&egrave;res.
D&eacute;finir Cliquez sur D&eacute;finir pour sp&eacute;cifier des expressions de construction conditionnelles.
Contenu S&eacute;lectionnez la table des mati&egrave;res, l’index et le glossaire &agrave; afficher dans l’aide g&eacute;n&eacute;r&eacute;e.
Jeu de variables S&eacute;lectionnez un jeu de variables pour le document imprim&eacute;.
Avanc&eacute; Indiquez les options d&eacute;taill&eacute;es relatives &agrave; la table des mati&egrave;res, au glossaire et au texte.
3 Cliquez sur Suivant.
4 Dans Contenu du document imprim&eacute;, sous Rubriques, cliquez sur le menu contextuel en pour afficher les
rubriques et les s&eacute;lectionner.
Afficher toutes les rubriques Affiche l’ensemble des rubriques, sans tenir compte des balises de construction
conditionnelles.
Table des mati&egrave;res Affiche l’ensemble des rubriques de la table des mati&egrave;res.
Boutons de dossier Pour afficher les rubriques du conteneur Gestionnaire de projets, cliquez sur le bouton du
dossier pour afficher un dossier personnalis&eacute;, un dossier de niveau sup&eacute;rieur ou tous les dossiers. (Affichez les
rubriques par titre ou par nom de fichier.)
5 Sous Rubriques, s&eacute;lectionnez les rubriques &agrave; ajouter et &eacute;laborez la table des mati&egrave;res.
Derni&egrave;re mise &agrave; jour le 16/3/2011
361
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
S&eacute;lectionnez Conserver les niveaux d’en-t&ecirc;te HTML pour d&eacute;sactiver le mappage automatique. Les niveaux de style
d’en-t&ecirc;te sont conserv&eacute;s. Si la structure du document imprim&eacute; ne correspond pas &agrave; celle de la colonne Mise en page
du chapitre, ouvrez ce document sous Word et d&eacute;finissez la structure appropri&eacute;e.
Faites glisser les rubriques de la liste de gauche vers la liste de droite. l’ic&ocirc;ne de la rubrique de la liste de gauche
s’affiche en bleu pour indiquer que l’ajout de la rubrique est en cours.
Dans la bo&icirc;te de dialogue G&eacute;n&eacute;ralit&eacute;s, les rubriques exclues qui utilisent des balises de construction conditionnelles
sont associ&eacute;es &agrave; une ic&ocirc;ne grise dans la liste Mise en page du chapitre.
Les rubriques manquantes s’affichent avec une ic&ocirc;ne de lien rompu
.
6 Modifiez ou r&eacute;arrangez le contenu de la liste Mise en page du chapitre.
Pour ajouter un nouveau livre, cliquez sur le bouton Nouveau chapitre. Pour d&eacute;placer un livre ou une page, cliquez
sur les boutons fl&eacute;ch&eacute;s.
D&eacute;place un &eacute;l&eacute;ment vers un niveau sup&eacute;rieur de la table des mati&egrave;res.
D&eacute;place un &eacute;l&eacute;ment vers un niveau inf&eacute;rieur de la table des mati&egrave;res.
D&eacute;place un &eacute;l&eacute;ment vers le haut de la table des mati&egrave;res.
D&eacute;place un &eacute;l&eacute;ment vers le bas de la table des mati&egrave;res.
7 Cliquez sur Suivant pour d&eacute;finir la mise en page des sections du document.
La colonne Mise en forme de section affiche la valeur par d&eacute;faut des sections. Vous pouvez supprimer une section
et ajouter des rubriques ou des documents Word existants en tant que nouvelles sections. Vous pouvez &eacute;galement
r&eacute;organiser les sections.
Cliquez sur ce bouton pour supprimer une section.
S&eacute;lectionnez une rubrique dans la colonne de gauche et cliquez sur cette ic&ocirc;ne pour ajouter la rubrique en tant
que section.
Cliquez pour ajouter un document Word en tant que section. Localisez le fichier, s&eacute;lectionnez-le et cliquez sur
Ouvrir.
Cliquez pour effectuer la modification dans Word si la section s&eacute;lectionn&eacute;e est un document Word. Les
modifications sont incluses dans le document imprim&eacute;.
Utilisez les fl&egrave;ches pour positionner une section au sein du document imprim&eacute;.
8 Proc&eacute;dez de l’une des fa&ccedil;ons suivantes :
• S&eacute;lectionnez Suivant pour mapper les styles.
• Enregistrez les modifications.
• S&eacute;lectionnez Terminer pour d&eacute;marrer la g&eacute;n&eacute;ration. Lorsque le message relatif aux macros de PrintDoc.dot
s’affiche, d&eacute;sactivez les macros et poursuivez l’op&eacute;ration. Lorsque le message relatif aux macros de PrintDoc.dot
s’affiche, d&eacute;sactivez les macros et poursuivez l’op&eacute;ration.
Remarques :
• Tous les documents Microsoft Word doivent &ecirc;tre ferm&eacute;s.
• Les modifications apport&eacute;es au contenu du document n’affectent pas les tables des mati&egrave;res.
• Les modifications apport&eacute;es aux tables des mati&egrave;res dans le module de composition de table des mati&egrave;res n’ont pas
d’incidence sur la mise en page du chapitre.
• Pour utiliser la table des mati&egrave;res mise &agrave; jour, cliquez sur Supprimer tout, puis sur Ajouter tout.
Derni&egrave;re mise &agrave; jour le 16/3/2011
362
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Pr&eacute;paration des documents imprim&eacute;s
Pr&eacute;paration
• Avant la g&eacute;n&eacute;ration, imprimez un rapport sur la table des mati&egrave;res. Pour ce faire, s&eacute;lectionnez Outils &gt; Rapports &gt;
Table des mati&egrave;res. Cochez les rubriques destin&eacute;es au document imprim&eacute; pour faciliter leur identification lors de
la g&eacute;n&eacute;ration du document.
• Pour les documents volumineux, cr&eacute;ez des documents individuels. Placez davantage de livres au niveau racine dans
la structure du document imprim&eacute; pour cr&eacute;er plus de fichiers DOC. Sans cela, le document imprim&eacute; se compose
uniquement de plusieurs fichiers de grande taille. Ne cr&eacute;ez pas de documents de plus de 100 pages.
Styles et formatage
V&eacute;rifiez que les styles de projet et les styles de mod&egrave;le sont pr&ecirc;ts &agrave; &ecirc;tre g&eacute;n&eacute;r&eacute;s.
Application de styles &agrave; tout le texte de rubrique
Lorsque vous utilisez un mod&egrave;le Word pour une documentation imprim&eacute;e, v&eacute;rifiez que le style provenant d’une feuille
de style externe est appliqu&eacute; &agrave; la totalit&eacute; du texte de rubrique.
Avec le formatage en ligne, les styles du projet ne sont pas mapp&eacute;s sur ceux de Word et s’appliquent tels quels au texte.
Les styles int&eacute;gr&eacute;s ne sont pas non plus mapp&eacute;s sur ceux de Word. Ils sont convertis en styles en ligne. Si des rubriques
utilisent des styles int&eacute;gr&eacute;s, associez une feuille de style externe &agrave; la rubrique, puis appliquez les styles au texte.
Application de styles aux en-t&ecirc;tes de rubriques
Pour traiter les rubriques en tant que sections distinctes et non en tant que texte en continu, v&eacute;rifiez que chaque ent&ecirc;te de rubrique est bien associ&eacute; &agrave; un style d’en-t&ecirc;te. Ensuite, placez-les &agrave; la racine de la structure du document
imprim&eacute;.
Si un en-t&ecirc;te personnalis&eacute; n’utilise pas les noms de styles d’en-t&ecirc;te RoboHelp au format En-t&ecirc;te [num&eacute;ro], la rubrique
associ&eacute;e n’appara&icirc;t pas dans la table des mati&egrave;res. Pour r&eacute;soudre ce probl&egrave;me, vous pouvez modifier l’un des styles
d’en-t&ecirc;te de RoboHelp afin qu’il utilise les param&egrave;tres de votre style d’en-t&ecirc;te personnalis&eacute;.
Utilisation coh&eacute;rente des styles
La documentation imprim&eacute;e mappe les styles du projet sur les styles de Word.
Appliquez les styles de projet de mani&egrave;re coh&eacute;rente d’une rubrique &agrave; l’autre. Par exemple, plut&ocirc;t que d’appliquer au
texte des styles en ligne tel que Gras, appliquez-lui un style qui utilise du gras. En v&eacute;rifiant la coh&eacute;rence, vous
garantissez une conversion ad&eacute;quate de la table des mati&egrave;res imprim&eacute;e. Cela fait, vous pourrez toujours mettre les
styles &agrave; jour dans leur ensemble, le cas &eacute;ch&eacute;ant.
S&eacute;lection d’un mod&egrave;le
• Mod&egrave;le personnalis&eacute;
• Mod&egrave;le de mappage des styles RoboHelp (.dot)
• Mod&egrave;le Word par d&eacute;faut
Derni&egrave;re mise &agrave; jour le 16/3/2011
363
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Ajout de nouveaux styles au mod&egrave;le
Analysez les styles de projet pour identifier la fa&ccedil;on dont ils seront mapp&eacute;s sur Word. Cr&eacute;ez des styles si n&eacute;cessaire.
Tenez compte des informations suivantes :
Styles manquants Une fois la conversion effectu&eacute;e, le texte &agrave; d&eacute;velopper et d&eacute;roulant appara&icirc;t en tant que texte en
ligne, par exemple.
Styles de caract&egrave;re Le mappage des styles est possible uniquement sur des styles de mod&egrave;le du m&ecirc;me type. Cr&eacute;ez un
style de caract&egrave;re correspondant avant la g&eacute;n&eacute;ration. Simplifiez le mappage en choisissant des noms de mod&egrave;les et de
styles de projet qui correspondent. Cr&eacute;ez des styles de caract&egrave;res Word, par exemple.
Texte conditionnel
La d&eacute;finition d’expressions de construction conditionnelles permet d’exclure des rubriques ou du contenu de rubrique
de la documentation imprim&eacute;e. Les rubriques exclues sont signal&eacute;es par une ic&ocirc;ne
dans la bo&icirc;te de dialogue
Imprimer le contenu du document.
Voir aussi
&laquo; D&eacute;finition d’expressions de balises de construction conditionnelles &raquo; &agrave; la page 246
Mises en page source uniques
Les balises de construction conditionnelles permettent de personnaliser le r&eacute;sultat et d’enregistrer les param&egrave;tres.
Pour que votre projet reste coh&eacute;rent, partagez les mappages de styles avec les autres auteurs &agrave; partir d’une mise en page
de documentation imprim&eacute;e. Importez les mappages de styles (fichier ZPL) dans le projet ou exportez-les vers un autre
emplacement.
Mappage de styles
Styles mapp&eacute;s
Les styles non mapp&eacute;s sont format&eacute;s tels qu’ils s’affichent dans l’&eacute;diteur de conception. Les mappages de styles sont
enregistr&eacute;s dans un fichier ZPL.
Styles d’en-t&ecirc;te
Le mappage d’en-t&ecirc;tes n’est possible que si un style d’en-t&ecirc;te HTML standard est appliqu&eacute; aux titres de rubrique. Les styles
d’en-t&ecirc;te personnalis&eacute;s dont le nom ne respecte pas le format En-t&ecirc;te &lt; num&eacute;ro &gt; ne sont pas consid&eacute;r&eacute;s comme tels.
Les styles d’en-t&ecirc;te sont automatiquement mapp&eacute;s sur ceux de Word. S&eacute;lectionnez Conserver les niveaux d’en-t&ecirc;te
HTML dans la bo&icirc;te de dialogue Imprimer le document Contenu pour d&eacute;sactiver le mappage automatique. Les
niveaux de style d’en-t&ecirc;te sont conserv&eacute;s, quelle que soit leur position dans la bo&icirc;te de dialogue Imprimer le contenu
du document.
RoboHelp tient compte du style de projet RoboHelp appliqu&eacute; &agrave; l’en-t&ecirc;te et du placement de la rubrique dans la
hi&eacute;rarchie de la table des mati&egrave;res imprim&eacute;e.
Le fait de g&eacute;n&eacute;rer une table des mati&egrave;res de document imprim&eacute; identique &agrave; celle du projet entra&icirc;ne la cr&eacute;ation de
documents Word avec des styles d’en-t&ecirc;te et une hi&eacute;rarchie de table des mati&egrave;res analogues. Si la hi&eacute;rarchie de la table
des mati&egrave;res change, des niveaux d’en-t&ecirc;te sont assign&eacute;s de mani&egrave;re automatique.
• Les styles d’en-t&ecirc;te des livres et pages de niveau racine sont toujours de type En-t&ecirc;te 1. Si le style d’en-t&ecirc;te du projet
se trouve &agrave; un niveau inf&eacute;rieur (En-t&ecirc;te 2 par exemple), il est ajust&eacute; &agrave; un style de niveau sup&eacute;rieur.
Derni&egrave;re mise &agrave; jour le 16/3/2011
364
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
• Les styles d’en-t&ecirc;te des livres et pages de niveaux 2 &agrave; 6 sont r&eacute;gl&eacute;s en fonction de leur niveau dans la structure du
document imprim&eacute; et du style d’en-t&ecirc;te de leur projet. Diff&eacute;rents styles d’en-t&ecirc;te de projet peuvent &ecirc;tre d&eacute;finis, le
cas &eacute;ch&eacute;ant.
• Les styles d'en-t&ecirc;te 7 &agrave; 9 des livres et des pages sont automatiquement mapp&eacute;s sur les styles d'en-t&ecirc;te 7 &agrave; 9 de Word.
• Les livres faisant r&eacute;f&eacute;rence &agrave; des pages sont trait&eacute;s comme des rubriques.
RoboHelp apporte ces ajustements aux en-t&ecirc;tes lors de la cr&eacute;ation de la table des mati&egrave;res du document imprim&eacute;.
Styles de paragraphe Vous pouvez uniquement mapper des styles de paragraphe sur des styles de paragraphe dans
Word. Ces styles portent sur les attributs de polices, l’espacement des lignes, la num&eacute;rotation et les bordures et la
trame.
Styles de caract&egrave;re Vous pouvez uniquement mapper des styles de caract&egrave;re sur des styles de caract&egrave;re dans Word. Ils
portent sur les attributs de police.
Styles de liste multi-niveau Les styles de liste multi-niveau dans RoboHelp peuvent &ecirc;tre mapp&eacute;s uniquement aux
styles de liste multi-niveau dans Word. Les niveaux individuels des listes multi-niveau sont mapp&eacute;s automatiquement.
Par exemple, le style des &eacute;l&eacute;ments du niveau 3 dans la liste RoboHelp est mapp&eacute; automatiquement &agrave; celui des &eacute;l&eacute;ments
du niveau 3 dans la liste Word.
Styles de tableau Les styles de tableau dans RoboHelp peuvent &ecirc;tre mapp&eacute;s uniquement aux styles de tableau dans Word.
Styles int&eacute;gr&eacute;s Lorsqu’ils ne sont pas d&eacute;finis dans une feuille de style externe, ces styles sont appliqu&eacute;s en ligne dans
le document Word. Ils ne peuvent &ecirc;tre utilis&eacute;s de mani&egrave;re globale.
Styles en ligne Les styles en ligne sont appliqu&eacute;s en ligne dans le document Word et ne peuvent pas &ecirc;tre utilis&eacute;s de
fa&ccedil;on globale dans le mod&egrave;le.
Styles non mapp&eacute;s
Le mappage des styles suivants est impossible :
• Arri&egrave;re-plan + Texte (CORPS). Ces param&egrave;tres de style sont appliqu&eacute;s en ligne.
• Styles d’en-t&ecirc;te.
Les styles non mapp&eacute;s (signal&eacute;s par la mention Non attribu&eacute; - Utiliser le style du projet dans la bo&icirc;te de dialogue
Apparence du document imprim&eacute;) sont ajout&eacute;s au document Word. Les attributs de ce style sont similaires &agrave; ceux du
style du projet. Pour acc&eacute;der &agrave; la bo&icirc;te de dialogue Apparence du document imprim&eacute;, cliquez deux fois sur une mise
en page de documentation imprim&eacute;e, dans le conteneur Mises en page source uniques, puis cliquez trois fois sur
Suivant.
Noms de styles
Les noms des styles du mod&egrave;le Word sont utilis&eacute;s comme noms pour les styles du mod&egrave;le mapp&eacute;s.
Ajout de styles RoboHelp
Si le titre de la page de titres, celui de la table des mati&egrave;res et les termes, d&eacute;finitions et en-t&ecirc;tes du glossaire sont d&eacute;finis
dans le mod&egrave;le Word s&eacute;lectionn&eacute;, ils sont ajout&eacute;s au document Word.
Styles en double
Si le projet poss&egrave;de plusieurs feuilles de style avec des noms de style en double, le style le plus fr&eacute;quemment utilis&eacute; sera
mapp&eacute;.
Derni&egrave;re mise &agrave; jour le 16/3/2011
365
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Mappage de styles
1 Dans le conteneur Mises en page source uniques, cliquez deux fois sur Documentation imprim&eacute;e, puis sur Suivant,
jusqu’&agrave; ce que la fen&ecirc;tre Apparence du document imprim&eacute; s’affiche.
Les styles du projet s’affichent &agrave; gauche. Les styles de mod&egrave;le correspondants s’affichent &agrave; droite. Si un style
correspondant est introuvable, le message [Non attribu&eacute; - Utiliser le style du projet] appara&icirc;t. Les styles d’en-t&ecirc;te,
qui sont mapp&eacute;s automatiquement, ne sont pas r&eacute;pertori&eacute;s.
2 Sous Mod&egrave;le Microsoft Word, s&eacute;lectionnez un mod&egrave;le d&eacute;j&agrave; pr&eacute;sent dans le projet ou une autre option de mod&egrave;le
dans le menu contextuel en
(Aucun) - Utiliser les styles CSS du projet Le formatage est effectu&eacute; &agrave; partir des rubriques et non &agrave; partir d’un
mod&egrave;le.
Utiliser les mod&egrave;les Microsoft Word Dans la bo&icirc;te de dialogue S&eacute;lectionner le fichier mod&egrave;le, ouvrez un mod&egrave;le.
Copiez le mod&egrave;le dans votre dossier de projet ou &eacute;crasez un mod&egrave;le existant. Cliquez sur Oui pour permettre un
acc&egrave;s rapide au mod&egrave;le. Pour partager le mod&egrave;le avec d’autres auteurs et le conserver dans un emplacement
centralis&eacute;, cliquez sur Non.
Style Mapping. dot Utilise le mod&egrave;le par d&eacute;faut.
Parcourir
Vous permet de s&eacute;lectionner un mod&egrave;le personnalis&eacute; non encore inclus au projet ou de rechercher
l’emplacement d’un fichier ZPL &agrave; partir d’une autre mise en page. Cliquez sur Parcourir pour rechercher
l’emplacement du mod&egrave;le voulu. Copiez le mod&egrave;le dans votre dossier de projet ou &eacute;crasez un mod&egrave;le existant.
Remarque : si le mod&egrave;le s&eacute;lectionn&eacute; porte le m&ecirc;me nom que l’un des mod&egrave;les Word par d&eacute;faut, l’extension _RHT est
ajout&eacute;e au nom du mod&egrave;le personnalis&eacute;.
3 Sous Styles CSS du projet, s&eacute;lectionnez un style de projet &agrave; mapper sur un style de mod&egrave;le. Un exemple du style
s&eacute;lectionn&eacute; s’affiche sous Aper&ccedil;u.
Styles CSS du projet (tous) Affiche l’ensemble des styles dans le projet.
Styles CSS du projet (utilis&eacute;s uniquement) Affiche uniquement les styles utilis&eacute;s dans le projet.
Caract&egrave;re Cr&eacute;e un aper&ccedil;u des attributs de police d’un style.
Paragraphe Cr&eacute;e un aper&ccedil;u des attributs de police et d’espacement d’un style.
Description Cr&eacute;e un aper&ccedil;u d’une description de texte d’un style.
4 Sous Styles de mod&egrave;le Microsoft Word, cliquez sur le menu contextuel en pour afficher les styles de mod&egrave;le.
Styles Microsoft Word (tous) Affiche tous les styles du mod&egrave;le, y compris les styles Word par d&eacute;faut.
Styles Microsoft Word (d&eacute;finis par l’utilisateur) Affiche uniquement les styles d&eacute;finis par l’utilisateur.
Remarque : les styles doivent &ecirc;tre mapp&eacute;s &agrave; d’autres styles du m&ecirc;me type. Par exemple, caract&egrave;re &agrave; caract&egrave;re,
paragraphe &agrave; paragraphe, tableau &agrave; tableau et liste multi-niveau &agrave; liste multi-niveau.
5 S&eacute;lectionnez un style et mappez l’ensemble des styles de projet souhait&eacute;s en les s&eacute;lectionnant dans le menu
contextuel du style Microsoft Word choisi.
6 Mappez tous les styles du projet souhait&eacute;s.
7 Cliquez sur Terminer pour d&eacute;marrer la g&eacute;n&eacute;ration.
8 Lorsque le message relatif aux macros s’affiche, cliquez sur Toujours faire confiance aux macros provenant de cet
&eacute;diteur. Ensuite, cliquez sur Activer les macros. Les fichiers de la documentation imprim&eacute;e apparaissent sous
!SSL!\[nom de la mise en page] dans le dossier du projet.
9
Cliquez sur Afficher les r&eacute;sultats pour consulter la sortie ou cliquez sur Termin&eacute;.
Derni&egrave;re mise &agrave; jour le 16/3/2011
366
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Microsoft Word ouvre le document. Selon les param&egrave;tres s&eacute;lectionn&eacute;s, la table des mati&egrave;res, le document ma&icirc;tre ou
un document unique s’affiche.
Exportation de mappages de styles
V&eacute;rifiez que les styles du projet sont tous mapp&eacute;s sur les m&ecirc;mes styles Word.
1 Ouvrez le projet.
2 Cr&eacute;ez une mise en page de documentation imprim&eacute;e.
3 Mappez les styles. Enregistrez les param&egrave;tres.
4 Dans le conteneur Mises en page source uniques, cliquez avec le bouton droit de la souris sur la mise en page
contenant le mappage de styles &agrave; exporter. S&eacute;lectionnez Exporter les pr&eacute;f&eacute;rences.
5 Acc&eacute;dez &agrave; l’emplacement de destination du mappage de styles. Cliquez sur Enregistrer.
Importation de mappages de styles
Partagez les mappages de styles pour vous assurer que les styles de projet sont tous mapp&eacute;s sur les m&ecirc;mes styles de
mod&egrave;le Word.
1 Dans le conteneur Mises en page source uniques, cliquez sur la mise en page de la documentation imprim&eacute;e avec
le bouton droit de la souris. S&eacute;lectionnez Importer les pr&eacute;f&eacute;rences.
2 Recherchez le mappage de styles export&eacute; (fichier .zpl).
3 S&eacute;lectionnez Ouvrir.
• Si le mod&egrave;le associ&eacute; au mappage de styles ne se trouve pas dans le projet, s&eacute;lectionnez Oui pour le copier dans
le dossier du projet.
• S&eacute;lectionnez Oui pour &eacute;craser le mod&egrave;le.
Lorsque vous g&eacute;n&eacute;rez la sortie, le mappage de styles import&eacute; est utilis&eacute;.
4 Pour modifier ce mappage apr&egrave;s son importation, 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 et cliquez sur Suivant sur chaque &eacute;cran de la bo&icirc;te de dialogue
Propri&eacute;t&eacute;s.
5 Cliquez sur Enregistrer.
G&eacute;n&eacute;ration de PDF
Les PDF conservent les liens, les signets, la mise en forme, les graphiques, les polices, les caract&egrave;res sp&eacute;ciaux et les
couleurs.
G&eacute;n&eacute;ration d’un PDF
1 Ouvrez le projet.
2 S&eacute;lectionnez Fichier &gt; G&eacute;n&eacute;rer &gt; PDF.
G&eacute;n&eacute;ration d’un PDF avec des options de configuration
1 Dans le conteneur Mises en page source uniques, cliquez deux fois sur la mise en page de la documentation
imprim&eacute;e.
2 Dans la zone Format de sortie, s&eacute;lectionnez G&eacute;n&eacute;rer un PDF Adobe.
3 Cliquez sur Param&egrave;tres PDF. D&eacute;finissez les options.
Derni&egrave;re mise &agrave; jour le 16/3/2011
367
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
4 S&eacute;lectionnez des options sur chaque &eacute;cran pour d&eacute;finir la mise en forme des chapitres et des sections, ainsi que les
styles. Cliquez sur Suivant pour passer d’un &eacute;cran au suivant.
5 Cliquez sur Terminer.
6 (Facultatif) Cliquez sur Afficher les r&eacute;sultats.
G&eacute;n&eacute;ration de documents imprim&eacute;s
Vous pouvez cr&eacute;er une documentation imprim&eacute;e ainsi que des mises en page source uniques et g&eacute;n&eacute;rer des fichiers
PDF en m&ecirc;me temps que des documents imprim&eacute;s.
Si vous n’utilisez aucun mod&egrave;le, chaque document conserve la mise en forme utilis&eacute;e au sein des rubriques.
1 Dans le conteneur Mises en page source uniques, cliquez deux fois sur la mise en page de la documentation
imprim&eacute;e.
2 Dans la bo&icirc;te de dialogue Options g&eacute;n&eacute;rales du document imprim&eacute;, s&eacute;lectionnez les options.
3 Dans la bo&icirc;te de dialogue Contenu du document imprim&eacute;, organisez la structure du document.
4 Mappez les styles Microsoft Word dans la bo&icirc;te de dialogue Apparence du document imprim&eacute;.
5 Copiez les fichiers ajout&eacute;s ou dans lesquels des s&eacute;quences ont &eacute;t&eacute; &eacute;crites et collez-les &agrave; un autre emplacement avant
de g&eacute;n&eacute;rer la mise en page.
6 Cliquez sur Terminer, puis sur D&eacute;sactiver les macros.
7 Cliquez sur Afficher le r&eacute;sultat. S&eacute;lectionnez des documents individuels ou un document unique dans la bo&icirc;te de
dialogue Options g&eacute;n&eacute;rales du document imprim&eacute;.
Par d&eacute;faut, les fichiers de la documentation imprim&eacute;e sont cr&eacute;&eacute;s sous !SSL!\[Nom de la mise en page] dans le dossier
du projet. Les mod&egrave;les sont enregistr&eacute;s dans le dossier du projet racine.
Remarque : si Microsoft Office 2000 SP2 (ou version ult&eacute;rieure) n’est pas install&eacute;, la conversion de certains &eacute;l&eacute;ments de
liste ne s’effectue pas correctement lorsque vous g&eacute;n&eacute;rez des documents imprim&eacute;s comportant plus de 1 500 &eacute;l&eacute;ments de
liste.
D&eacute;finition d’options d’impression par d&eacute;faut
Vous pouvez configurer les param&egrave;tres par d&eacute;faut de l'imprimante depuis RoboHelp. Les options disponibles
d&eacute;pendent de l’imprimante s&eacute;lectionn&eacute;e.
Remarque : les param&egrave;tres d&eacute;finis d&eacute;terminent le mode d’impression des documents dans les autres applications
Windows.
Les param&egrave;tres sont les suivants :
Taille de papier Indique la taille du papier.
Source de papier Indique l'emplacement du papier dans l'imprimante. Les options d&eacute;pendent de l’imprimante. Bac
sup&eacute;rieur et bac d'enveloppes sont des exemples de source de papier.
Orientation Indique si l'orientation est Portrait ou Paysage.
Marges Indique, en pouces, les marges gauche, droite, sup&eacute;rieure et inf&eacute;rieure.
Derni&egrave;re mise &agrave; jour le 16/3/2011
368
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Habillages
A propos des habillages
Les habillages permettent de modifier l’apparence des syst&egrave;mes Adobe AIR, WebHelp et FlashHelp. Les habillages
s’appliquent &agrave; gauche d’une fen&ecirc;tre et la barre d’outils au-dessus de la sortie. Personnalisez le syst&egrave;me d’aide en
modifiant les couleurs, les boutons, les polices et les ic&ocirc;nes ou en ajoutant un arri&egrave;re-plan ou des logos.
RoboHelp comprend des habillages pr&eacute;d&eacute;finis, stock&eacute;s dans la galerie d’habillages RoboHelp.
Modification d'habillages
Suivez cette proc&eacute;dure pour modifier des habillages WebHelp et AIRHelp &agrave; partir de RoboHelp. Les modifications des
propri&eacute;t&eacute;s d’habillage prennent effet &agrave; la g&eacute;n&eacute;ration suivante faisant appel &agrave; cet habillage. si vous localisez un projet,
le texte de l’habillage par d&eacute;faut est converti par le biais du param&egrave;tre de langue du projet. Si vous modifiez le texte de
l’habillage, RoboHelp remplace les personnalisations dans le fichier LNG.
Remarque : les habillages FlashHelp sont modifi&eacute;s &agrave; l’aide du Kit de d&eacute;veloppement d’habillage FlashHelp. Voir
&laquo; Personnalisation des habillages FlashHelp &raquo; &agrave; la page 373.
1 Dans le conteneur Configuration du projet, d&eacute;veloppez le dossier Habillages.
2 Cliquez sur un habillage avec le bouton droit de la souris. S&eacute;lectionnez Modifier.
3 Selon le type d’habillage, l’&eacute;diteur d’habillage de WebHelp ou de l’aide Adobe AIR d&eacute;marre. D&eacute;finissez les options
de votre choix.
Remarque : en fonction du type de sortie, certaines options ne sont pas disponibles.
4 Cliquez sur OK.
5 Cliquez sur Mettre &agrave; jour la vue pour afficher les modifications dans la bo&icirc;te de dialogue. S&eacute;lectionnez Aper&ccedil;u pour
afficher les modifications dans une fen&ecirc;tre s&eacute;par&eacute;e.
Conseils :
• Utilisez les ic&ocirc;nes d’URL pour les liens de sites Web ou utilisez des ic&ocirc;nes de dossier plut&ocirc;t que des ic&ocirc;nes de livre.
• Pour utiliser des ic&ocirc;nes de table des mati&egrave;res de couleur diff&eacute;rente, acc&eacute;dez &agrave; la galerie d’images. Cette galerie se
trouve sous C:\Program Files\Adobe\Adobe RoboHelp [version]\ RoboHTML\gallery\images\Books_and_Pages.
Vous pouvez &eacute;galement ouvrir l’image dans un &eacute;diteur graphique, puis d&eacute;finir la couleur souhait&eacute;e.
• Pour g&eacute;n&eacute;rer un projet avec des &eacute;l&eacute;ments de barre d’outils personnalis&eacute;s, s&eacute;lectionnez le bouton personnalis&eacute; de la
bo&icirc;te de dialogue Navigation.
• Pour supprimer un bouton d’un habillage sans &eacute;liminer le fichier image, d&eacute;sactivez cette option au moment de
g&eacute;n&eacute;rer le projet. Ne l’effacez pas dans l’&eacute;diteur d’habillage WebHelp.
• Les fichiers suppl&eacute;mentaires tels que les fichiers image ou JavaScript pour les boutons se trouvent dans le dossier
de projet\!SkinSubFolder!\&lt;Nom de l’habillage&gt;. Les habillages sont stock&eacute;s dans des sous-dossiers diff&eacute;rents de
!SkinSubFolder!.
• Pour indiquer un script utilisant d’autres fichiers (HTML ou images, par exemple), copiez ces fichiers dans le sousdossier de l’habillage, sous !Skinsubfolder!.
Derni&egrave;re mise &agrave; jour le 16/3/2011
369
UTILISATION DE ROBOHELP HTML 9
G&eacute;n&eacute;ration de l’aide et de documents imprim&eacute;s
Voir aussi
&laquo; Cr&eacute;ation d’habillages personnalis&eacute;s dans les projets WebHelp et WebHelp Pro &raquo; &agrave; la page 371
&laquo; Cr&eacute;ation d’habillages personnalis&eacute;s pour les projets Adobe AIR &raquo; &agrave; la page 370
Ajout d’habillages &agrave; la galerie
Pour stocker des habillages et les r&eacute;utiliser dans l’ensemble des projets, vous devez les ajouter &agrave; la galerie d’habillages.
1 Dans le conteneur Configuration du projet, d&eacute;veloppez le dossier Habillages.
2 Cliquez sur un habillage avec le bouton droit de la souris. S&eacute;lectionnez l’option Ajouter &agrave; la galerie.
Importation d’habillages
Lorsque vous importez des fichiers AHS Adobe AIR, SKN WebHelp ou FHS FlashHelp, l’ensemble des fichiers
associ&eacute;s est ajout&eacute; au sous-dossier d’habillages. Vous pouvez &eacute;galement importer un fichier AHZ (Adobe AIR), ZKN
(WebHelp) ou FHZ (FlashHelp) compress&eacute;.
1 Dans le conteneur Configuration du projet, cliquez avec le bouton droit de la souris sur le dossier Habillages.
S&eacute;lectionnez Importer.
2 Acc&eacute;dez &agrave; un fichier d’habillage, compress&eacute; ou non.
3 S&eacute;lectionnez le fichier. Cliquez sur Ouvrir.
4 (Facultatif) Indiquez un nom et un nom de fichier pour l’habillage.
5 Cliquez sur OK.
Vous pourrez s&eacute;lectionner cet habillage lors de la g&eacute;n&eacute;ration suivante de la sortie.
Exportation d’habillages
l’exportation d’un habillage produit un fichier compress&eacute; contenant l’habillage et les fichiers associ&eacute;s.
1 Dans le conteneur Configuration du projet, d&eacute;veloppez le dossier Habillages.
2 Cliquez sur un habillage avec le bouton droit de la souris. S&eacute;lectionnez Exporter.
3 Acc&eacute;dez &agrave; l’emplacement o&ugrave; enregistrer l’habillage export&eacute;. Cliquez sur Enregistrer.
Suppression d’habillages
1 Proc&eacute;dez de l’une des fa&ccedil;ons suivantes :
• Pour supprimer un habillage d’un projet, s&eacute;lectionnez-le dans le dossier Habillages du conteneur Configuration
du projet.
• Pour supprimer un habillage d’une galerie, s&eacute;lectionnez-le dans le r&eacute;pertoire C:\Program Files\Adobe
RoboHelp [version]\RoboHTML\Sqskinsext\Gallery.
2 Appuyez sur la touche Suppr.
Aper&ccedil;us d’habillages
Vous pouv
Manuel du propriétaire | Adobe ROBOHTML 9 Manuel utilisateur

Manuels associés

Adobe

RoboHelp HTML 11

Adobe

ROBOHELP 10

Adobe

ROBOHTML 8

Adobe

RoboHelp 2017

Adobe

RoboHelp HTML 10

Adobe

ROBOHTML 10

Adobe

RoboHelp 2019

Adobe

FRAMEMAKER 10

Adobe

Technical Communication Suite 4

Adobe

Framemaker 12

Adobe

RoboHelp 7

Adobe

Technical Communication Suite 5
