Concepts de conversion de base

Conversion des formats FrameMaker en styles RoboHelp

Vous pouvez définir la manière dont les formats FrameMaker sont convertis en styles RoboHelp au niveau du projet. Toutes les définitions de format FrameMaker dans le document FrameMaker apparaissent dans la boîte de dialogue Paramètres de conversion, même si elles ne sont pas utilisées. En ce qui concerne les documents structurés, les formats FrameMaker qui sont mappés avec des éléments dans le modèle structuré sont répertoriés. Spécifiez les éléments ci-dessous :

  • Le modèle FrameMaker utilisé pour la conversion. Cette étape est facultative.

  • La feuille de style RoboHelp pour le mappage des styles.

Sélection d’un modèle FrameMaker de conversion

Si le document FrameMaker que vous importez est un livre FrameMaker non structuré, vous pouvez définir un modè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érents dans leur version imprimée, mais aucun de ces éléments n’est applicable pour la sortie en ligne. Dans ce cas, vous pouvez définir un modèle contenant les définitions de format pour tous les documents à convertir.

Vous pouvez ensuite l’utiliser comme modèle du projet, remplaçant les formats des documents individuels au niveau du projet RoboHelp. Vous pouvez également réutiliser les paramètres de conversion dans d’autres projets en les exportant.

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

  2. Cliquez sur l’onglet Importer de la boîte de dialogue Paramètres du projet. Sélectionnez Appliquer un modèle FrameMaker avant l’importation.

  3. Cliquez sur Parcourir, puis sélectionnez le modèle FrameMaker à utiliser pour le projet.

Sélection de la feuille CSS pour le mappage des styles

Vous pouvez sélectionner la feuille de style en cascade (CSS) que RoboHelp utilise pour mapper les formats FrameMaker aux styles RoboHelp. Par défaut, RoboHelp utilise le fichier RHStyleMapping.css pour le projet. Vous pouvez également utiliser un fichier CSS personnalisé. Vous pouvez modifier les styles ultérieurement dans RoboHelp ou dans une application externe d’édition de feuilles CSS, telle qu’Adobe® Dreamweaver®.

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

  2. Cliquez sur l’onglet Importer de la boîte de dialogue Paramètres du projet. Effectuez l’une des opérations suivantes :

    • Sélectionnez le fichier CSS dans le menu CSS pour le mappage de styles.

    • Cliquez sur Ajouter, en regard du menu déroulant CSS pour le mappage de styles, puis sélectionnez un fichier CSS.

      Cette option permet de spécifier un fichier CSS personnalisé pour le projet. Lorsque vous sélectionnez cette option, RoboHelp copie le fichier CSS sélectionné vers le dossier à la racine du projet, puis l’utilise pour le mappage des styles.

Structure hiérarchique d’un livre FrameMaker

Vous pouvez appliquer une structure et un regroupement hiérarchiques dans le livre. Vous pouvez également inclure des livres enfants dans un livre et créer des dossiers et des groupes dans un livre.

Lorsque vous liez ou importez un livre FrameMaker, le conteneur Gestionnaire de projets dans RoboHelp indique la hiérarchie du livre. Une fois liés ou importés dans RoboHelp, les livres enfants héritent de la table des matières, de l’index et du glossaire du livre parent.

Afficher le graphique en taille réelle
Hiérarchie d’un livre FrameMaker affichée dans le conteneur Gestionnaire de projets lors de la liaison de ce livre dans RoboHelp

Conversion des formats de références croisées FrameMaker en styles RoboHelp

Par défaut, les styles de références croisées du document source sont utilisés sans mappage dans les rubriques générées. Vous devez définir le mappage de ces formats, car les documents FrameMaker peuvent contenir des références à des pages ou volumes qui ne sont pas utiles pour les formats d’aide.

  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 un format de référence croisée dans le groupe Référence croisée de la boîte de dialogue Paramètres de conversion.

  4. Sélectionnez un style RoboHelp pour le mapper ou saisissez le champ du style pour redéfinir les références croisées dans le document FrameMaker.

  5. Cliquez deux fois sur un bloc fonctionnel pour l’ajouter à la définition de référence croisée RoboHelp.

Référence de contenu

Le texte ou les fichiers que vous avez insérés dans les documents FrameMaker en tant que références de contenu apparaissent comme faisant partie des rubriques dans lesquelles ils sont référencés. Ils n’apparaissent pas comme des références dans l’aide en ligne obtenue.

Paramètres de conversion

Vous pouvez créer un ensemble standard de paramètres de conversion pour importer du contenu FrameMaker dans des projets RoboHelp, puis utiliser ces paramètres de façon cohérente dans plusieurs projets.

Vous définissez ces paramètres une fois. Pour les projets ultérieurs, importez ces paramètres dans le projet. De cette manière, vous pouvez rapidement configurer l’environnement du projet et publier un contenu FrameMaker dans plusieurs formats en ligne.

Ces paramètres sont les suivants :

  • Modèle FrameMaker spécifié

  • Feuilles de style en cascade (CSS) pour les projets RoboHelp

  • Mappage des styles entre les formats FrameMaker et les styles RoboHelp

  • Paramètres de conversion de format et d’image, et autres paramètres

Exportation des paramètres de conversion

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

  2. Dans l’onglet Importer, cliquez sur Exporter.

  3. Spécifiez le nom du fichier des paramètres d’importation RoboHelp (fichier ISF), puis cliquez sur Enregistrer.

Importation des paramètres de conversion dans un projet

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

  2. Dans l’onglet Importer, cliquez sur Parcourir.

  3. Sélectionnez un fichier de paramètres d’importation (ISF) RoboHelp et cliquez sur Ouvrir.