Guide d'utilisation Annuler

Générer une sortie sans cadre

  1. Guide de l’utilisateur RoboHelp
  2. Introduction
    1. Découverte de l’espace de travail RoboHelp
    2. Nouveautés de RoboHelp version 2022
      1. Nouveautés de la mise à jour 5
      2. Nouveautés de la mise à jour 4
      3. Nouveautés de la mise à jour 3
      4. Nouveautés de la mise à jour 2
      5. Nouveautés de la mise à jour 1
    3. Problèmes résolus dans RoboHelp
    4. Configuration requise pour RoboHelp
    5. Téléchargement de RoboHelp sous Windows et macOS
    6. Télécharger et installer l’application Adobe
    7. FAQ RoboHelp
    8. Nouveautés de RoboHelp version 2020
      1. Nouveautés de la mise à jour 8
      2. Nouveautés de la mise à jour 7
      3. Nouveautés de la mise à jour 6
      4. Nouveautés de la mise à jour 5
      5. Nouveautés de la mise à jour 4
      6. Nouveautés de la mise à jour 3
      7. Nouveautés de la mise à jour 2
      8. Nouveautés de la mise à jour 1
  3. Projets
    1. Planification d’un projet RoboHelp
    2. Création d’un projet
    3. Gestion des projets
    4. Utilisation des rubriques et des dossiers
    5. Génération de rapports
    6. Travailler avec l’aide contextuelle
    7. Gérer les références
    8. Définir les préférences dans RoboHelp
  4. Collaboration avec les auteurs
    1. Collaboration à l’aide de Git
    2. Collaboration à l’aide de SharePoint Online
    3. Collaboration à l’aide d’Azure DevOps (Team Foundation Server)
  5. Mise en page PDF
    1. Modèles PDF
    2. Concevoir une mise en page
    3. Publier une sortie PDF
    4. Utiliser les styles de contenu courants
    5. Composants d’un modèle PDF
    6. Prise en charge des variables de langue
    7. Personnalisation des fichiers PDF
  6. Modification et mise en forme
    1. Mise en forme du contenu
    2. Créer et gérer des références croisées
    3. Créer et gérer des liens
    4. Source unique avec des extraits de code
    5. Utilisation d’images et d’objets multimédias
    6. Création et utilisation de variables pour simplifier les mises à jour
    7. Utilisation des ensembles de variables
    8. Utilisation de la fonction Rechercher et remplacer
    9. Enregistrement automatique de votre contenu
    10. Modification côte à côte dans la vue fractionnée
    11. Utilisation de la fonction Vérification orthographique
    12. Créer et modifier des signets
    13. Insérer et mettre à jour des champs
    14. Permutation des vues
    15. Numérotation automatique dans CSS
  7. Importation et liaison
    1. Importation de fichiers Markdown dans un projet
    2. Importation de documents Word dans un projet
    3. Importation de documents FrameMaker dans un projet
  8. Tables des matières, index, glossaires et citations
    1. Création et gestion d’une table des matières
    2. Création et gestion d’un index
    3. Création et gestion d’un glossaire
    4. Création et gestion des citations
    5. Créer et gérer des séquences de navigation
    6. Utilisation des fonctions Voir aussi et Rubriques connexes
  9. Contenu conditionnel
    1. Qu’est-ce qu’un contenu conditionnel ?
    2. Création et application de balises de condition
    3. Configuration des paramètres prédéfinis de sortie de contenu conditionnel
    4. Optimisation et gestion de contenu conditionnel
  10. Microcontenu
    1. Microcontenu
  11. Révision et collaboration
    1. Révision et collaboration
  12. Traduction
    1. Traduction de contenu dans plusieurs langues
    2. Configurer un cadre de traduction pour un fournisseur de services
  13. Génération d'une sortie
    1. Génération d’une sortie
    2. Générer une sortie sans cadre
    3. Générer la sortie de la base de connaissances
    4. Génération d’une sortie PDF
    5. Génération d’une sortie en Responsive HTML5
    6. Génération d'une sortie Document Word
    7. Générer la sortie Contenu uniquement
    8. Génération d’une sortie eBook
    9. Génération d’une sortie Microsoft HTML Help
    10. Génération de la sortie de l’application mobile
  14. Publication d’une sortie
    1. Publier sur RoboHelp Server
    2. Publication sur un serveur FTP, un serveur FTP sécurisé, ou un système de fichiers
    3. Publier sur SharePoint Online
    4. Publier dans le Centre d’aide Zendesk
    5. Publier dans la base de connaissances Salesforce
    6. Publier dans la base de connaissances ServiceNow
    7. Publier dans la base de connaissances Zoho
    8. Publier sur Adobe Experience Manager
    9. Publication dans la base de connaissances Atlassian Confluence
  15. Annexe
    1. Référence des scripts Adobe RoboHelp
    2. Raccourcis clavier de RoboHelp

Découvrez comment générer une sortie sans cadre dans RoboHelp, de sorte que votre contenu puisse être visualisé en ligne et à partir d’applications de bureau.

Qu’est-ce qu’une sortie sans cadre ?

La sortie sans cadre peut être visualisée sur le Web ou à l’aide d’une application de bureau. Ce type de sortie fonctionne avec n’importe quel navigateur et n’importe quelle plate-forme, et offre plusieurs fonctionnalités de personnalisation.

Configurer un paramètre prédéfini de sortie sans cadre

La première étape de la génération de sortie d’un projet RoboHelp consiste à créer un paramètre prédéfini de sortie et à configurer divers paramètres pour ce dernier. Vous pouvez utiliser les paramètres suivants pour configurer un paramètre prédéfini de sortie sans cadre :

Généralités

Utilisez les options suivantes pour spécifier les paramètres de sortie de base comme le titre, le chemin d’accès de sortie, la langue des chaînes de l’interface utilisateur, etc. :

Titre Indiquez le titre de la sortie générée.

Vous pouvez utiliser des variables dans le titre. Pour ce faire, saisissez Ctrl + 1 et sélectionnez une variable dans la liste déroulante, puis appuyez sur Entrée. Notez que si vous avez fourni un ensemble variable dans l’onglet Contenu > champ Jeu de variables, lors de la génération de sortie, la valeur de la variable sélectionnée est choisie dans le jeu des variables.

Le titre, ainsi que les variables, le cas échéant, apparaissent dans l’onglet Navigateur de la sortie.

Icône favorite Indiquez une icône à associer à la sortie. L’icône s’affiche dans l’onglet du navigateur de la sortie. Cliquez sur  pour parcourir et sélectionner l’icône souhaitée.

Chemin d’accès de sortie Indiquez un emplacement pour la sortie. Pour sélectionner un emplacement, cliquez sur 

Assurez-vous que le chemin d’accès de sortie ne se trouve PAS dans le dossier du projet. Si le chemin d’accès de sortie se trouve dans le dossier du projet, la génération de sortie échouera. De plus, le contenu nécessaire ne doit PAS se trouver dans le dossier sélectionné. RoboHelp supprime le contenu du dossier avant de générer la sortie.

Enregistrer le chemin de sortie comme relatif au projet : si cette option est activée et que vous naviguez vers le chemin de sortie, le chemin vers la sortie sera désormais relatif et non plus absolu. 

Page de lancement Indiquez le nom de la page et l’extension (.htm ou .html) que RoboHelp peut utiliser pour générer l’URL de la sortie. Par exemple, indiquez index.html.

Langue Utilisez la liste déroulante pour indiquer une langue pour le paramètre prédéfini de sortie si la langue de l’interface utilisateur de la sortie générée doit être différente de la langue du contenu indiquée dans les paramètres du projet. 

Codage Utilisez la liste déroulante pour spécifier le type de format de codage de caractères à utiliser pour votre contenu.

Utiliser les noms de fichiers en minuscules Sélectionnez cette option pour générer tous les fichiers de sortie avec des noms de fichiers en minuscules.

Exécution d’un script généré Pour exécuter votre script personnalisé une fois la génération du contenu de sortie terminée, sélectionnez le fichier de script .js dans la liste déroulante.

Contenu

Utilisez les options suivantes pour spécifier les paramètres de sortie relatifs au contenu, comme les paramètres de la table des matières, de l’index, du glossaire et de l’expression de condition :

Table des matières Utilisez la liste déroulante pour sélectionner une table des matières à inclure dans la sortie. Cette liste déroulante affiche les tables des matières disponibles dans votre projet. La première table des matières de cette liste déroulante est sélectionnée par défaut.

L'ensemble de fichiers et leurs références présents dans la table des matières sélectionnée apparaissent dans la sortie générée.

Séquence de navigation Utilisez cette liste déroulante pour afficher les séquences de navigation définies dans votre projet. Vous pouvez sélectionner plusieurs séquences de navigation. Les séquences de navigation sélectionnées sont ensuite fusionnées pour la sortie. En cas de conflit dans les séquences de navigation sélectionnées, la première séquence est privilégiée.

Rubrique par défaut Cliquez sur  pour choisir la rubrique qui s’affiche dans le panneau Rubrique lorsque vous ouvrez la sortie. Par défaut, la première rubrique dans la table des matières sélectionnée pour cette sortie correspond à la rubrique par défaut.

Vous pouvez également sélectionner la rubrique par défaut parmi les projets enfants fusionnés.La liste indiquée sous les projets enfants fusionnés est lue à partir de la table des matières sélectionnée.

Inclure l’index Sélectionnez ce paramètre pour inclure la page d'index dans la sortie.

Glossaire Utilisez la liste déroulante pour sélectionner le glossaire à inclure dans la sortie. Le glossaire permet aux utilisateurs de récupérer rapidement les termes appropriés dans votre projet, ainsi que les définitions correspondantes.

Expression de condition Utilisez la liste déroulante pour indiquer l’expression de condition de votre sortie. Ce paramètre vous permet d’inclure ou d’exclure facilement du contenu en fonction du type de sortie ou de base d’utilisateurs souhaité. Cliquez sur  pour modifier l’expression de condition sélectionnée. Vous pouvez également choisir Aucun dans la liste déroulante pour ne pas spécifier une expression de condition.

Filtre de contenu dynamique Utilisez la liste déroulante pour sélectionner un filtre de contenu dynamique pour permettre à vos utilisateurs finaux de filtrer le contenu dans la sorte générée. Cliquez sur  pour modifier le filtre de contenu dynamique sélectionné. Vous pouvez également sélectionner Aucun dans la liste déroulante pour ne pas spécifier de filtre de contenu dynamique.

Jeu de variables Utilisez la liste déroulante pour spécifier le jeu de variables à utiliser dans cette sortie. Dans la liste déroulante, vous pouvez sélectionner <Jeu de variables par défaut> pour utiliser le jeu de variables par défaut du projet. Les jeux de variables vous permettent de mettre en œuvre une utilisation spécifique à la sortie des variables. Par exemple, vous pouvez avoir plusieurs jeux de variables pour générer une sortie pour des clients et des utilisateurs internes.

Fichiers de mappage Utilisez la liste déroulante pour sélectionner un fichier de mappage afin d’utiliser l’aide contextuelle. Pour plus d’aide, voir Travailler avec l’aide contextuelle.

Mise en page

Utilisez les options suivantes pour configurer l’aspect de votre sortie :

Vous pouvez créer une page d’accueil personnalisée ou un pied de page de rubrique et l’appliquer aux rubriques de votre choix. Le pied de page peut contenir tous les éléments dynamiques (extraits, variables, balises conditionnelles, etc.) qu'une rubrique peut contenir.

Contenu du pied de page d’accueil  Cliquez  pour parcourir et sélectionner une rubrique (.htm) que vous souhaitez afficher en tant que pied de page sur la page d’accueil. Par exemple, indiquez README.htm.

Contenu de pied de page de la rubrique  Cliquez sur  pour parcourir et sélectionner une rubrique(.htm) que vous souhaitez afficher en tant que pied de page sur la page de la rubrique. Par exemple, indiquez README.htm.

PDF pour télécharger Cliquez sur  pour parcourir et sélectionnez le PDF que vous souhaitez que les utilisateurs téléchargent lorsqu'ils cliquent sur le bouton Télécharger le PDF dans la sortie.

Utiliser l'habillage de la page d'accueil Sélectionnez ce champ pour afficher la page d'accueil dans la sortie.

Contenu de l'habillage de la page d'accueil Cliquez sur  pour parcourir la rubrique que vous souhaitez afficher sur la page d'accueil avec les vignettes Table des matières.

Utilisez les options suivantes pour spécifier les paramètres associés à la recherche de votre sortie :

Contexte de recherche. Vous pouvez spécifier le contexte de recherche pour personnaliser les résultats de la recherche en fonction de vos besoins. Les trois options disponibles pour le contexte de recherche sont les suivantes :

  • Texte autour du terme de la recherche : La sélection de cette option affiche le texte autour de la première occurence du terme de la recherche. 
  • Description de la rubrique : Choisissez cette option pour afficher la description de la rubrique en tant que contexte. Cela affiche la description que vous ajoutez sous Général>Description dans les propriétés de la rubrique.
  • Texte de début de la rubrique : Choisissez cette option pour afficher le contenu d’ouverture de la rubrique.

Définir la limite de caractères du contexte de recherche. Vous pouvez ajouter une valeur ici pour définir une limite au nombre de caractères qui s’affichent dans les résultats de la recherche.

Activer la saisie automatique dans le  zone de recherche. Sélectionnez cette option pour afficher les options de prédiction pour la requête de recherche en fonction des caractères initiaux saisis par les utilisateurs.  

Correction automatique  requête de recherche. Sélectionnez cette option pour corriger les termes mal orthographiés qui sont saisis pendant la recherche. Ce paramètre permet de corriger jusqu’à un caractère dans chaque mot saisi lors de la recherche. Cela garantit des résultats de recherche pertinents, même si vous saisissez un terme mal orthographié.

Afficher les définitions du glossaire. Sélectionnez cette option pour afficher les définitions des termes de recherche dans le glossaire sélectionné pour cette sortie. Si le terme de recherche correspond à un terme du glossaire, la définition du terme est  affichée.

Génération de plan de site XML. Sélectionnez ce paramètre afin de générer un plan de site pour votre sortie publiée. Le fichier sitemap.xml de la sortie publiée contient le plan de site. Vous pouvez envoyer ce fichier dans votre moteur de recherche pour améliorer les résultats de recherche sur votre site. Suivez la procédure décrite dans la documentation de votre moteur de recherche pour envoyer le fichier sitmap.xml. Dans URL de base du contenu hébergé, saisissez une URL relative au site. Dans Fréquence de modification de contenu, indiquez le rythme d’indexation du contenu.

Sélectionnez les types de fichiers à exclure de la recherche. Vous pouvez exclure de la recherche certains types de fichiers, tels que PDF, Word et Excel. Le contenu des fichiers sélectionnés ne sera pas inclus lors de la recherche.

Remarque :

Pour que les fichiers compressés soient utilisés dans la recherche et autrement, la compression doit être activée côté serveur.

À l’heure actuelle, tous les fichiers CSS et JavaScript de plus de 1 Ko sont compressés au format gzip et sont inclus avec le fichier d’origine dans le dossier de sortie. Les fichiers sont ensuite appelés par le serveur chaque fois que le serveur demande les fichiers compressés.

Publication

Vous pouvez publier votre contenu de sortie sur SharePoint Online et FTP, SFTP ou File System. Pour pouvoir publier votre sortie, configurez d’abord un profil de publication pour le type de serveur approprié. Pour plus d’informations, reportez-vous aux sections suivantes :

Une fois le profil de publication enregistré, RoboHelp l’affiche dans l’onglet Publier. Pour publier votre contenu de sortie, sélectionnez les profils de publication pertinents et cliquez sur .

Par défaut, seuls les fichiers modifiés sont publiés à l’aide des profils de publication choisis depuis la dernière publication.

Pour publier tous les fichiers, sélectionnez Republier tout et cliquez sur . Pour afficher le journal de publication, dans le panneau Paramètres prédéfinis de sortie, choisissez  > Afficher le journal de publication comme paramètre prédéfini de sortie.

Générer une sortie sans cadre

  1. Dans la fenêtre de création de votre projet, cliquez sur l’icône Génération rapide  dans le coin supérieur droit de la barre d’outils standard. Vous pouvez également sélectionner Génération rapide dans le menu Sortie.

  2. Sélectionnez une sortie sans cadre prédéfinie dans la boîte de dialogue Génération rapide.

  3. Pour configurer les paramètres, procédez de l’une des façons suivantes :

    • Cliquez sur l’icône Modifier les paramètres  dans la boîte de dialogue Génération rapide.
    • Cliquez sur l’onglet Sortie à gauche de la barre d’outils standard.

    La vue Sortie s’ouvre.

  4. Dans la barre d’outils Sortie, cliquez sur Paramètres prédéfinis de sortie. Dans le panneau Paramètres prédéfinis de sortie, procédez de l’une des façons suivantes :

    • Double-cliquez sur le paramètre prédéfini de sortie sans cadre souhaité.
    • Cliquez sur l’icône  en regard du paramètre prédéfini de sortie souhaité et sélectionnez Modifier.
  5. Consultez Configurer un paramètre prédéfini de sortie sans cadre pour configurer les paramètres de sortie.

  6. Pour enregistrer vos paramètres, cliquez sur l’icône Enregistrer  dans le coin supérieur gauche de la barre d’outils standard dans la vue Sortie.

  7. Cliquez sur l’icône Générer un paramètre prédéfini  dans le panneau Paramètres prédéfinis de sortie.

    Vous pouvez ensuite afficher une barre de progression à côté du paramètre prédéfini de sortie sélectionné dans le panneau Paramètres prédéfinis de sortie. Une fois la génération de la sortie terminée, une boîte de dialogue Succès est visible dans le coin inférieur droit de l’écran.

    À la fin de la génération de la sortie, cliquez sur  dans le panneau Paramètres prédéfinis de sortie pour l’afficher.

    Remarque :

    Vous pouvez également générer une sortie dans la fenêtre de création.Cliquez sur Génération rapide  dans la barre d’outils, sélectionnez le paramètre prédéfini de sortie souhaité, puis cliquez sur Générer.

    Une barre de progression s’affichera alors dans la boîte de dialogue Génération rapide. À la fin de la génération de la sortie, cliquez sur  en regard du paramètre prédéfini de sortie pour l’afficher. Si la génération de la sortie échoue, cliquez sur  en regard du paramètre prédéfini de sortie pour afficher le journal d’erreurs.

  8. Pour afficher la sortie dans un navigateur sélectionné, sélectionnez Afficher avec et choisissez l'un des navigateurs installés sur votre ordinateur. Les navigateurs actuellement disponibles sont répertoriés par ordre alphabétique, par exemple Google Chrome, Internet Explorer et Mozilla Firefox. Vous pouvez prévisualiser votre sortie avec n’importe lequel des navigateurs installés sur votre ordinateur. Cette option Afficher avec est également disponible en mode Aperçu de la rubrique lors de la création.

    Les utilisateurs peuvent également télécharger et d’installer n’importe quel nouveau navigateur. Chaque fois qu’un nouveau navigateur est installé, il apparaît dans la liste des navigateurs.

Prise en charge des Google Analytics dans la sortie sans cadre

Google Analytics vous permet de suivre facilement les mesures telles que les consultations de pages, la durée de la session et les interactions des utilisateurs, entre autres. La sortie sans cadre se comporte comme une application SPA (Single Page Application), ce qui signifie que l’ouverture de différentes rubriques ne recharge pas l’ensemble de la sortie. Cependant, l’URL change lorsque différentes rubriques ou différents signets sont ouverts. En suivant cet historique des modifications d’URL, Google Analytics capture les données.

Procédez comme suit pour intégrer la sortie sans cadre (hébergée sur un serveur) à Google Analytics :

Remarque :

Reportez-vous à Prise en charge du Gestionnaire de balises Google pour en savoir plus sur le suivi des mesures à l’aide du déclencheur Historique des modifications dans le gestionnaire de balises Google.

  1. Accéder au Gestionnaire de balises Google et configurez votre compte.

  2. Rechercher la balise ci-dessous dans votre espace de travail.

    balise google

  3. Ouvrir le projet Robohelp . Sélectionner Disposition de rubrique dans l’onglet Auteur .

  4. Sélectionnez la vue Source de la disposition de rubrique et collez le code ci-dessus dans la balise <head> et <body>.

  5. Sélectionnez l’onglet Sortie  > Paramètres prédéfinis de sortie  > Sans cadre > Disposition.

  6. Sélectionner la disposition de rubrique dans la liste déroulante Disposition de rubrique.

    robohelp google analytics

  7. Générer la sortie Sans cadre et l’héberger sur le serveur.

  8. Sélectionner Aperçu dans votre espace de travail dans le Gestionnaire de balises Google, pour ouvrir la fenêtre Connecter l'Assistant de balises à votre site.

  9. Entrez une URL vers votre site et sélectionnez Se connecter pour connecter le Gestionnaire de rubriques Google à votre sortie hébergée.

    google tag connect

    Désormais, lorsque vous commencez à parcourir votre sortie, elle collecte les données et commence à afficher votre historique suivi.

Articles connexes

Recevez de l’aide plus rapidement et plus facilement

Nouvel utilisateur ?