Conversion de contenu FrameMaker

Conversion des formats de paragraphe FrameMaker en styles RoboHelp

Par défaut, RoboHelp convertit tous les formats de paragraphe de FrameMaker vers des styles CSS RoboHelp. Il conserve l’apparence et le comportement des formats FrameMaker dans un projet RoboHelp. Pour garantir la cohérence des projets d’aide en ligne, faites correspondre les formats FrameMaker aux styles RoboHelp et modifiez-les.

  1. Sélectionnez Fichier > Paramètres du projet.

  2. Dans l’onglet Importer de la boîte de dialogue Paramètres du projet, sous Document FrameMaker, cliquez sur Modifier.

  3. Dans le volet Paramètres de conversion, sélectionnez le format FrameMaker dans le groupe Paragraphe.

  4. Dans le menu Style RoboHelp, sélectionnez le style à mapper au format FrameMaker. Pour conserver l’apparence du texte FrameMaker dans le format de l’aide, sélectionnez [Source].

    Pour modifier le style RoboHelp sélectionné, cliquez sur Modifier le style.

  5. Sélectionnez les propriétés du style RoboHelp mappé :

    Exclure de la sortie
    Sélectionnez cette option pour ignorer le contenu du document FrameMaker auquel le format de paragraphe FrameMaker sélectionné est appliqué.

    Pagination
    Sélectionnez cette option pour créer une rubrique d’aide à chaque occurrence pour le format de paragraphe sélectionné.

    Balise HTML définie par l’utilisateur
    Sélectionnez ou saisissez une balise HTML définie par l’utilisateur pour le format de paragraphe sélectionné.

    Si les propriétés de numérotation automatique sont définies pour le format FrameMaker sélectionné, indiquez de quelle manière la numérotation automatique est convertie.

Conversion des formats de caractères FrameMaker en styles RoboHelp

Vous pouvez mapper les formats de caractères FrameMaker avec les styles de caractère de RoboHelp.

Vous pouvez également modifier les styles dans RoboHelp.

  1. Sélectionnez Fichier > Paramètres du projet.

  2. Dans l’onglet Importer de la boîte de dialogue Paramètres du projet, sous Document FrameMaker, cliquez sur Modifier.

  3. Sélectionnez le format de caractère FrameMaker dans le volet gauche de la boîte de dialogue Paramètres de conversion.

  4. Sélectionnez le style de caractère RoboHelp dans le menu contextuel. Si vous le souhaitez, vous pouvez effectuer les opérations suivantes :
    • Pour importer le format de caractère FrameMaker, sélectionnez [Source] dans le menu contextuel. ;

    • Pour modifier le style RoboHelp sélectionné, cliquez sur Modifier le style.

    • Pour exclure le texte dans le document FrameMaker auquel est appliqué le format de caractère sélectionné, sélectionnez Exclure du résultat.

    • Pour appliquer une balise HTML définie par l’utilisateur au texte importé dans la sortie HTML, sélectionnez Balise HTML définie par l’utilisateur, puis la balise dans le menu contextuel. Vous pouvez également entrer une nouvelle balise HTML. La balise HTML personnalisée du format de caractère remplace la balise <span> dans le fichier HTML généré.

Exclusion d’un format de paragraphe FrameMaker des rubriques d’aide

Vous pouvez exclure de la sortie convertie le contenu de documents FrameMaker ayant un format de paragraphe spécifié. Cette option permet de supprimer du contenu qui n’est pas requis dans la sortie en ligne, par exemple des notes spéciales.

  1. Sélectionnez Fichier > Paramètres du projet.

  2. Dans l’onglet Importer de la boîte de dialogue Paramètres du projet, sous Document FrameMaker, cliquez sur Modifier.

  3. Dans les paramètres du projet, sélectionnez un format de paragraphe dans le volet de gauche.

  4. Cliquez sur Exclure de la sortie.

Balises HTML personnalisées

Vous pouvez définir ou appliquer une balise HTML personnalisée pour remplacer la balise standard <p> pour les styles de paragraphe et la balise <span> pour les styles de caractères dans la sortie HTML pour les formats que vous importez à partir de FrameMaker. Vous pouvez définir des balises HTML distinctes pour chaque format du document FrameMaker.

  1. Sélectionnez Fichier > Paramètres du projet.

  2. Dans l’onglet Importer de la boîte de dialogue Paramètres du projet, sous Document FrameMaker, cliquez sur Modifier.

  3. Dans la boîte de dialogue Paramètres de conversion, sélectionnez l’option Balise HTML définie par l’utilisateur.

  4. Tapez le nom de la balise HTML personnalisée ou sélectionnez une balise existante à utiliser à la place de la balise HTML par défaut.

Application d’expressions FrameMaker de création de texte conditionnel

Vous pouvez appliquer les paramètres Afficher/Masquer des expressions de construction de texte conditionnel au contenu de vos documents FrameMaker importés dans les projets RoboHelp. RoboHelp importe le contenu après avoir appliqué les paramètres Afficher/Masquer au contenu FrameMaker. Le texte masqué n’est pas transféré dans le projet RoboHelp.
  1. Sélectionnez Fichier > Paramètres du projet.

  2. Dans l’onglet Importer de la boîte de dialogue Paramètres du projet, sous Document FrameMaker, cliquez sur Modifier.

  3. Dans le groupe Autres paramètres de la boîte de dialogue Paramètres de conversion, sélectionnez Appliquer une expression de construction de texte conditionnel FrameMaker.

Mappage des styles de numérotation automatique

Sélectionnez le paramètre pour convertir les formats de numérotation automatique du document FrameMaker au format de l’aide. Si le document FrameMaker contient des listes numérotées hiérarchiques, vous pouvez sélectionner l’une des options suivantes :

Ignorer la numérotation automatique
Sélectionnez cette option si le texte de la numérotation automatique est important pour la version imprimée uniquement. Le paragraphe converti ne contient pas de numérotation automatique. Vous pouvez par exemple choisir d’ignorer la numé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énérée.

Convertir la numérotation automatique en texte
Sélectionnez cette option pour conserver l’apparence des listes numérotées FrameMaker. La partie numérotée perd ses propriétés de séquençage et apparaît sous forme de texte de paragraphe dans la rubrique RoboHelp.

Convertir la numérotation automatique en liste HTML
Sélectionnez cette option pour convertir la numérotation automatique en listes HTML à l’aide de balises HTML telles que <ol>, <ul> et <li>.

Convertir la numérotation automatique en liste RoboHelp
Sélectionnez cette option si vous souhaitez modifier les rubriques HTML générées dans RoboHelp ou utiliser les styles RoboHelp pour contrôler les propriétés de numérotation.

Scénarios de mappage de listes

RoboHelp vous permet de convertir les propriétés de liste des formats de paragraphe FrameMaker de plusieurs façons. Prenez en compte les scénarios ci-dessous.

Mappage d’une liste numérotée FrameMaker avec [Source]

La caractéristique de numérotation automatique du format de paragraphe FrameMaker est convertie en liste en fonction des paramètres définis pour ce format de paragraphe.

Ignorer la numérotation automatique
La partie automatiquement numérotée du format de paragraphe FrameMaker est ignorée. Le style de paragraphe converti dans la rubrique RoboHelp ne contient pas la liste.

Convertir la numérotation automatique en texte
La partie numérotée du paragraphe est convertie en texte et fera partie du texte du paragraphe dans la rubrique RoboHelp.

Convertir la numérotation automatique en liste HTML
Le format de numérotation automatique est converti en éléments de liste utilisant des balises HTML telles que <ol>, <ul> et <li>.

Convertir la numérotation automatique en liste RoboHelp
Les caractéristiques de numérotation automatique du style de paragraphe sont converties en liste RoboHelp.

Exemple :

  • Créez un style de paragraphe « FM_Para1 » dans FrameMaker, avec une numérotation automatique définie en tant que <a+> et appliquez-le aux paragraphes. Ils seront ainsi classés selon le format a, b, c, etc.

  • Mappez le format de paragraphe FrameMaker « FM_Para1 » avec [Source].

Le style de liste est appliqué aux paragraphes générés dans les rubriques RoboHelp. Les caractéristiques de la liste sont identiques à celles du document source.

Mappage d’une liste numérotée FrameMaker avec un style non numéroté RoboHelp

Vous pouvez mapper un format de paragraphe FrameMaker avec des caractéristiques de numérotation automatique à un style de paragraphe RoboHelp qui n’est lié à aucun style de liste. Dans ce cas, la numérotation automatique est convertie en liste en fonction des paramètres de conversion définis pour le format de paragraphe.

Ignorer la numérotation automatique
La numérotation automatique de paragraphe FrameMaker est ignorée et n’apparaît pas dans la rubrique RoboHelp, mais le style de paragraphe est mappé.

Convertir la numérotation automatique en texte
La partie automatiquement numérotée FrameMaker est convertie en texte et fera partie du texte du paragraphe dans la rubrique RoboHelp. Le style de paragraphe est mappé.

Convertir la numérotation automatique en liste HTML
Le format de paragraphe FrameMaker est converti en éléments de liste HTML à l’aide de balises HTML telles que <ol>, <ul> et <li>.

Convertir la numérotation automatique en liste RoboHelp
Les caractéristiques de numérotation automatique du format de paragraphe FrameMaker sont ignorées. Le style de paragraphe est mappé.

Mappage du format non numéroté FrameMaker avec le style numéroté RoboHelp

Dans ce cas, le paragraphe converti est pourvu du style de paragraphe RoboHelp et hérite du style de liste RoboHelp. Les options de conversion de la numérotation automatique n’affectent pas le comportement du paragraphe dans la rubrique RoboHelp.

Par exemple :

  • Dans le document FrameMaker, créez un format de paragraphe « FM_Para 1 » sans propriétés de numérotation automatique.

  • Définissez un style de liste RoboHelp « RH_Liste1 » dans la feuille CSS de mappage de styles RH.

  • Créez un style de paragraphe « RH_Para1 » et liez le premier niveau du style de liste « RH_Liste1 » au style de paragraphe « RH_Para1 ».

  • Mappez le style de paragraphe FrameMaker, « FM_Para1 », avec le style de paragraphe RoboHelp, « RH_Para1 ».

Le paragraphe généré dans la rubrique RoboHelp hérite des propriétés du style de liste « RH_Liste1 ».

Mappage d’une liste numérotée FrameMaker avec une liste numérotée RoboHelp

Le paragraphe converti prend le style de paragraphe RoboHelp et hérite du style de liste RoboHelp. Les options de conversion de la numérotation automatique n’affectent pas le comportement du paragraphe dans la rubrique RoboHelp.

Par exemple :

  • Dans FrameMaker, créez le format de paragraphe « FM_Para1 », avec une numérotation automatique définie sous la forme <a+> et appliquez-le à un paragraphe. Ainsi, la liste triée du paragraphe sera du type a, b, c, etc.

  • Définissez le style de liste numérique « RH_Liste1 » dans la feuille CSS de mappage de styles RoboHelp, avec <x> comme définition du premier niveau.

  • Dans RoboHelp, définissez un style de paragraphe « RH_Para1 » et liez le premier niveau du style de liste « RH_Liste1 » au style de paragraphe « RH_Para1 ».

  • Mappez le format de paragraphe FrameMaker « FM_Para1 » au style de paragraphe RoboHelp « RH_Para1 ».

Le paragraphe généré dans la rubrique RoboHelp hérite des caractéristiques du style de liste « RH_Liste1 » et affiche une liste de type 1, 2, 3, etc.

Conversion des formats de tableau FrameMaker en styles de tableau RoboHelp

Vous pouvez mapper les formats de tableau FrameMaker avec les styles de tableau RoboHelp. Vous pouvez également importer des formats de tableau à partir du document FrameMaker. Vous pouvez également modifier les formats de tableau dans RoboHelp. Dans le document FrameMaker, il est impossible d’annuler la fusion des cellules. Les cellules fusionnées dans un document FrameMaker apparaissent néanmoins comme telles dans la rubrique RoboHelp.

Si les formats de tableau FrameMaker contiennent des titres et des notes de bas de page de tableau, convertissez séparément ces formats de paragraphe FrameMaker en styles de paragraphe RoboHelp. Vous pouvez choisir de conserver ou non la numérotation automatique dans les styles de titre de tableau et spécifier les caractéristiques de numérotation pour le style de paragraphe RoboHelp mappé. Si par exemple les formats de titre de tableau des documents FrameMaker incluent un numéro de chapitre, comme « Tableau 2-3 : Résultats trimestriels », vous pouvez choisir d’ignorer la numérotation automatique et conserver uniquement le nom de ce tableau.

  1. Sélectionnez Fichier > Paramètres du projet.

  2. Dans l’onglet Importer de la boîte de dialogue Paramètres du projet, sous Document FrameMaker, cliquez sur Modifier.

  3. Sélectionnez le format de tableau FrameMaker dans le volet gauche de la boîte de dialogue Paramètres de conversion.

  4. Sélectionnez le style de tableau RoboHelp dans le menu contextuel et cliquez sur OK. Vous pouvez également modifier le style de tableau en cliquant sur Modifier le style.

Paramètres de conversion d’image

Certains documents FrameMaker, notamment ceux optimisés pour une impression PDF haute qualité, contiennent des images au format EPS. Vous pouvez laisser RoboHelp utiliser Adobe Distiller pour convertir ces images aux formats en ligne.

Spécifiez les paramètres de conversion d’image suivants dans la boîte de dialogue Paramètres de conversion :

Utiliser des formats PDF pour générer des images
Sélectionnez cette option pour générer des formats d’image adaptés au Web à partir de graphiques liés et insérés dans des documents FrameMaker. Vous devez utiliser cette option en particulier si vous avez des formats de graphiques vectoriels, tels que EPS ou AI, ou des graphiques contenant du texte.

Conserver les images 3D
Sélectionnez cette option pour convertir les graphiques 3D au format PDF, en conservant le rendu 3D au sein du fichier PDF. Pour vous assurer que l’image 3D conserve son rendu, activez l’imbrication dans FrameMaker.

Dimensions
Spécifiez les dimensions des images. Sélectionnez l’une des options suivantes :
Echelle
Mettez les images à l’échelle en appliquant un pourcentage à la taille existante. Les proportions des images sont conservées.

Largeur et hauteur
Spécifiez la taille absolue de l’image en hauteur et en largeur, en nombre de points. Sélectionnez Conserver le rapport de grandeur pour vous assurer que les images ne sont pas déformées.
Remarque : pour convertir les images de documents FrameMaker à leurs dimensions réelles, spécifiez une hauteur et largeur de 0 pt. La balise <img> dans la version HTML générée ne spécifie aucune valeur de hauteur ou de largeur. La conversion ne tient pas compte des dimensions des cadres ancrés contenant les images.

Dimensions maximales
Définissez les dimensions maximales des images au format en ligne. Les images qui excèdent ces dimensions sont automatiquement réduites en proportion pour s’adapter à la taille maximale que vous spécifiez. Si vous mettez à l’échelle les images et spécifiez un rapport de grandeur, RoboHelp les met à l’échelle dans le cadre des dimensions maximales spécifiées et conserve le rapport de grandeur.

Utilisez cette option pour ne pas avoir à faire défiler verticalement ou horizontalement la fenêtre du navigateur pour visionner des images de grande taille. Exemple : si vous spécifiez la taille de la fenêtre sur 800 x 600 pixels, vous pouvez définir les dimensions maximales sur 640 x 480, afin que les images n’excèdent pas la taille de la fenêtre.

Marges
Spécifiez les marges des images :
  • Définissez des marges égales pour tous les côtés dans Tous les côtés.

  • Pour définir des marges sur des côtés particuliers, définissez-les côté par côté.

Bordures
Définissez la bordure des images :
  • Pour définir une bordure uniforme sur tous les côtés, sélectionnez Tout dans le menu contextuel Bordure. Vous pouvez également spécifier le côté auquel appliquer la bordure dans le menu contextuel.

  • Pour définir le style de bordure, sélectionnez le style dans le menu contextuel Style.

  • Pour définir la couleur de bordure, sélectionnez la couleur dans le menu contextuel Couleur.

  • Le menu déroulant Largeur permet de définir la largeur de la bordure.

Format
Définissez les paramètres de format, de codage des couleurs et de qualité des images Web converties à partir des images du document FrameMaker :
Tel quel
Sélectionnez cette option pour conserver les images au format actuel.

JPG
Sélectionnez cette option pour les images en couleurs, telles que des captures d’écran ou des photographies. Le format JPG, avec un codage des couleurs élevé, offre une qualité optimale pour un affichage en ligne, mais crée des fichiers de grande taille.

GIF
Sélectionnez cette option si le document FrameMaker contient uniquement des graphiques en mode point, tels que des diagrammes schématiques.

BMP
Sélectionnez cette option pour des captures d’écran et d’autres images. Les fichiers BMP sont de bonne qualité pour une taille de fichier augmentée.

PNG
Sélectionnez cette option pour les captures d’écran et les photographies.

Qualité JPEG
Définissez le pourcentage de qualité pour les images JPG.

Profondeur de bit de couleur
Définissez la profondeur de bit de couleur pour les images bitmap. Les formats JPG et PNG peuvent avoir un codage des couleurs sur 8 ou 24 bits et les images BMP sur 1, 4, 8, 16, 24 ou 32 bits. Les images GIF peuvent être associées uniquement à un codage des couleurs sur 8 bits.

Niveaux de gris
Sélectionnez cette option pour les images monochromes.

Conservation des images converties

RoboHelp convertit les images et les cadres ancrés dans les documents FrameMaker à chaque mise à jour ou génération des rubriques. Vous pouvez ignorer la mise à jour des images si les images correspondantes ou les fichiers SWF des cadres ancrés correspondants sont déjà présents dans le projet RoboHelp. Utilisez cette option dans les cas suivants :
  • Vous ne souhaitez pas régénérer les images à chaque mise à jour du document FrameMaker

  • Vous avez modifié les images dans le projet RoboHelp à l’aide d’un autre outil de retouche d’images et vous ne souhaitez pas écraser les images modifiées.

  • Vous souhaitez conserver l’image générée précédemment dans le projet RoboHelp, alors que l’image dans le document FrameMaker a été modifiée.

Si le nom ou l’ordre d’apparition des images dans le document a changé, vous devez désactiver cette option et laisser RoboHelp mettre à jour les images.

 Dans l’onglet Image de la boîte de dialogue Paramètres de conversion, sélectionnez Ne pas régénérer les images.

Création d’un texte alternatif pour les images

Pour créer un contenu accessible, créez un texte alternatif pour les images, afin de permettre aux malvoyants d’y accéder par le biais de lecteurs d’écran. Si vous liez ou importez des livres FrameMaker complets dans RoboHelp en vue d’une publication, ajoutez un texte alternatif aux graphiques utilisés dans les documents FrameMaker. Ces entré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.