Guide d'utilisation Annuler

Microcontenu

  1. Guide de l’utilisateur RoboHelp
  2. Introduction
    1. Nouveautés d'Adobe RoboHelp
    2. Nouveautés dans la mise à jour 7 de RoboHelp (version 2020)
    3. Nouveautés de la mise à jour 6 de RoboHelp (version 2020)
    4. Nouveautés de la mise à jour 5 de RoboHelp (version 2020)
    5. Nouveautés de la mise à jour 4 de RoboHelp (version 2020)
    6. Configuration système requise pour RoboHelp
    7. FAQ RoboHelp
    8. Télécharger et installer votre application Adobe
    9. Télécharger et installer RoboHelp sur macOS
    10. Découverte de l’espace de travail RoboHelp
    11. Problèmes résolus dans RoboHelp
  3. Projets
    1. Planification d’un projet RoboHelp
    2. Création d’un projet
    3. Utilisation des rubriques et des dossiers
    4. Génération de rapports
    5. Travailler avec l’aide contextuelle
    6. Gérer les références
    7. 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. 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
  6. 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
  7. Tables des matières, index et glossaires
    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éer et gérer des séquences de navigation
    5. Utilisation des fonctions Voir aussi et Rubriques connexes
  8. 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
  9. Microcontenu
    1. Microcontenu
  10. Révision et collaboration
    1. Révision et collaboration
  11. Traduction
    1. Traduction de contenu dans plusieurs langues
    2. Configurer un cadre de traduction pour un fournisseur de services
  12. Habillages et pages principales
    1. Utilisation des habillages
    2. Utilisation des pages principales
    3. Utilisation des intitulés
    4. Personnaliser des fichiers PDF
    5. Introduction à l'éditeur d’habillage sans cadre
  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
  15. Annexe
    1. Référence des scripts Adobe RoboHelp
    2. Raccourcis clavier de RoboHelp

Créez du microcontenu à partir des éléments de base de votre contenu, puis utilisez-le pour promouvoir le contenu plus volumineux.

Introduction au microcontenu

Le microcontenu est un petit extrait de code autonome livré par le biais de chatbots, micro-aide et FAQ.

En plus de la création basée sur des rubriques, RoboHelp vous permet de créer un microcontenu ou de réutiliser votre contenu existant, tel qu’une partie spécifique d’une rubrique, afin de l’utiliser en tant que microcontenu, qui peut être facilement assimilé par les applications d’intelligence artificielle (IA).

Dans RoboHelp, cela commence par la création du groupe de microcontenu, la collecte d’intention et la réponse correspondante, comme question et réponse. Bref, le microcontenu désigne un petit contenu créé pour une entité spécifique, l'« intention ». L’utilisateur définira une intention, par exemple, Qu’est-ce que Parcourir la séquence ?, et définira sa réponse comme un contenu de texte enrichi. Le texte de réponse peut être rédigé ou créé à l’aide d’un contenu de rubrique existant.La combinaison intention/réponse peut aider à susciter la curiosité de l’utilisateur.

Utilisations du microcontenu

Vous pouvez envisager d'utiliser plusieurs types de contenu comme microcontenu engageant, attrayant et rapide à obtenir.Après avoir créé du microcontenu dans RoboHelp, vous pouvez le déployer de différentes façons pour l'utiliser au sein d'un chatbot, d'un extrait de code de recherche, de FAQ ou d'une micro-aide. Chaque microcontenu peut être utilisé de manière adaptée pour diriger le trafic pour engager l'audience. 

Chatbot Créer une réponse qui peut être intégrée à n’importe quel moteur de chatbot. Pour plus de détails, voir Configuration des paramètres prédéfinis pour le chatbot

Rechercher un extrait de code Récupérer une réponse concise à la requête de recherche dans toutes les sorties de la page d’accueil et de la page de la rubrique. Pour plus de détails, voir la section Ajouter la page FAQ à une sortie Frameless.

FAQ Créer une rubrique FAQ pour toutes les sorties. Pour plus de détails, voir Configurer un paramètre prédéfini de sortie Frameless et Ajouter une page FAQ à une sortie sans cadre.

Micro-aide Créer un petit fichier (HTML, JSON, XML, Text) auquel les développeurs peuvent accéder dans une application, avec ou sans liens vers l’aide principale. Il est de très petite taille et est autonome sur un serveur. Cette sortie ne nécessite ni phrase ni mot clé. Pour plus de détails, voir Configuration des paramètres prédéfinis de sortie pour la micro-aide.

Utilisations du microcontenu

Comprendre les intentions

Le terme « Intention » désigne des d'informations destinées à aider l’utilisateur. Il s’agit de ce qu’un lecteur utilise lorsqu'il effectue une recherche ou interagit, par exemple, avec un chatbot ou quelque chose qui est inclus dans une page FAQ. Il peut s’agir d’une question possible sur le projet que l’utilisateur peut interroger lors de l’exécution d’une recherche ou de l’interaction avec le chatbot.

Prenons un exemple :

Supposons que le propriétaire d’un café ait créé un projet pour former les nouveaux employés à préparer du café et d’autres boissons. La personne en formation aura la sortie du projet sur lui sous la forme d’un site web d’aide.S’il veut chercher « Comment faire du cappuccino », il va simplement taper la requête dans la zone de recherche et obtenir une réponse. Donc « Comment faire du cappuccino » forme une intention. Il y a aussi un concept de « Phrases ». Une phrase est associée à une intention. Ici, les phrases pour « Comment faire du cappuccino » peuvent être 

1. Comment préparer du cappuccino.
2. Comment élaborer du cappuccino... etc ;

fondamentalement, toutes les manières possibles dont l’utilisateur peut poser la question « Comment faire du cappuccino ».

Maintenant, l’intention décrite ci-dessus peut être utilisée dans le chatbot ou bien inscrite comme FAQ ou comme extrait de code de recherche dans toutes les sorties.

Créer un groupe de microcontenu

Vous pouvez créer plusieurs groupes de microcontenus pour vous aider à organiser vos intentions en différents groupes. Pour créer un groupe de microcontenus, procédez comme suit :

  1. Procédez de l’une des façons suivantes :

    • Dans la barre d'outils Auteur, sélectionnez Microcontenu. Le panneau Groupe microcontenu s'ouvre. 
    • Dans la barre d’outils Auteur, sélectionnez Contenus. Le panneau Contenus s’ouvre.
  2. Procédez de l’une des façons suivantes :

    • Dans le panneau Microcontenu, cliquez sur  La boîte de dialogue Nouveau groupe de microcontenus s’ouvre.
    • Dans le panneau Contenus , cliquez avec le bouton droit sur le dossier, ou cliquez  directement dessus, choisissez Nouveau  > groupe de microcontenus. La boîte de dialogue Nouveau groupe de microcontenus s’ouvre.
  3. Dans la boîte de dialogue Nouveau groupe de microcontenus, spécifiez le nom du groupe de microcontenus. Le nom de fichier correspondant est automatiquement ajouté avec l’extension .mc.

  4. Cliquez sur Terminé. 

    Le groupe de microcontenus est ajouté au panneau Microcontenu.

Créer l’intention et la réponse dans le panneau Microcontenu

Le fichier de microcontenu s’ouvre dans la zone de création, sous la forme d’une table à ligne unique à laquelle vous pouvez ajouter l'intention et la réponse. Chaque intention que vous créez doit être associée à une réponse.

Intentions et réponses
Comment ajouter des intentions et des réponses

La colonne de gauche « Intention » vous permet de créer une intention sous forme de texte. 
    Par exemple : « Quels sont les avantages du personnel ? »

Alors que la colonne de droite « Réponse » vous permet de créer du contenu riche et offre des options familières telles que la création de sujets, comme l’ajout de contenu de références croisées, d’hyperliens, d’images, de variables, d’extraits de code et de listes déroulantes.

Propriétés de l’intention

Une intention peut avoir plusieurs phrases définies correspondre à la même réponse. Par exemple, Qu’est-ce que la séquence de navigation w.r.t. Qu’est-ce que la séquence de parcours ? Une intention peut avoir des métadonnées comme des mots clés, par exemple, navigation, séquence, ordre, etc. pour l'intention Séquence de navigation

Les propriétés de l'intention sont affichées à droite dans le panneau des propriétés et représentent les caractéristiques déterminantes d’une intention.

Nom Affiche le nom de l’intention ajoutée dans la colonne de gauche.

Phrases Ajoutez de nouvelles phrases alternatives pour chaque intention qui aurait la même réponse. Les phrases alternatives sont très utiles, car il est impossible de prédire la formulation qu’un utilisateur utilisera. L’ajout d’une autre phrase augmente les chances que la réponse correspondante s’affiche pour l’utilisateur final, même si l’intention principale n’est pas utilisée.
Par exemple : « Quels sont les avantages du personnel ? », « Quels sont les avantages pour le personnel ? » ou « Protection sociale du personnel ? ».

Mots clés Ajoutez des balises et des mots clés associés à votre contenu afin que l’utilisateur puisse les utiliser dans sa recherche. L’ajout de mots clés est une fois encore très utile, car l’utilisateur peut entrer un mot ou deux là où les mêmes informations seraient pertinentes.

ID Vous pouvez entrer des ID pour une utilisation avec la sortie de micro-aide.

Balises de condition Vous pouvez appliquer des balises de condition de sorte qu’une intention particulière au sein d’un groupe ne soit pas incluse lorsque les balises sélectionnées sont appliquées à la sortie.

Créer une réponse à l’aide du contenu d'une rubrique existante

Vous pouvez créer une réponse à votre intention à l’aide d’une rubrique ou d’un extrait de code existant. Pour ce faire, procédez comme suit :

  1. Dans la barre d’outils Auteur, sélectionnez Contenus et ouvrez la rubrique de votre choix dans le panneau Contenus.

  2. Sélectionnez le contenu requis dans une rubrique et cliquez avec le bouton droit. Un menu contextuel s’affiche. 

  3. Sélectionnez Ajouter au microcontenu dans le menu contextuel.

  4. Dans la boîte de dialogue Ajouter comme réponse, spécifiez le groupe et l’intention. 

    Ajoutez comme réponse

  5. Cliquez sur Appliquer.

    La réponse est ajoutée à l’intention sélectionnée.

Génération de la sortie d’un microcontenu

Avant de générer la sortie de votre microcontenu dans RoboHelp, vous devez créer et configurer un paramètre prédéfini de sortie. Une fois que les paramètres prédéfinis de sortie sont prêts, vous pouvez utiliser les paramètres prédéfinis pour générer la sortie sous diverses formes telles que le chatbot, la micro-aide et les FAQ.

Créer un paramètre prédéfini de sortie pour le microcontenu

Pour créer un paramètre prédéfini de sortie dans RoboHelp, procédez comme suit :

  1. Cliquez sur l’onglet Sortie à gauche de la barre d’outils Standard. La vue Sortie s’ouvre.

  2. Dans la barre d’outils Sortie, cliquez sur Paramètres prédéfinis de sortie. Le panneau Paramètres prédéfinis de sortie s'ouvre.

  3. Dans le panneau Paramètres prédéfinis de sortie, cliquez sur .

  4. Dans la boîte de dialogue Nouveau paramètre prédéfini , spécifiez les options suivantes :

    Tapez Utilisez la liste déroulante pour sélectionner le type prédéfini Chatbot, Frameless ou Micro-aide, selon vos besoins.

    Nom Spécifiez un nom pour le paramètre prédéfini de sortie.

  5. Cliquez sur Terminé.

    Vous pouvez accéder au paramètre prédéfini de sortie dans le panneau Paramètres prédéfinis de sortie de la barre d’outils Sortie. Sinon, vous pouvez accéder au paramètre prédéfini de sortie dans la boîte de dialogue Génération rapide de la fenêtre de création.

Configurer le paramètre prédéfini de sortie pour le chatbot

Vous pouvez utiliser les paramètres suivants pour configurer les différents éléments du paramètre prédéfini de sortie du microcontenu pour le chatbot :

Généralités

Utilisez les options suivantes pour spécifier les paramètres de sortie de base, tels que le titre, le moteur de chatbot, le chemin d'accès de sortie, la langue et le script de post-génération.

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 jeu de variables dans l’onglet Contenu > champ Jeu de variables, la valeur de la variable sélectionnée est choisie dans le jeu des variables lors de la génération de la sortie.

Moteur de chatbot Dans la liste déroulante, sélectionnez un moteur de chatbot. Actuellement, la sortie de chatbot dispose de connecteurs pour permettre l'intégration de Google Dialogflow .  

Chemin 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. 

Langue Vous pouvez créer des chatbots dans un certain nombre de langues pour atteindre un public beaucoup plus large. Spécifiez ce paramètre pour créer un chatbot dans l’une des langues répertoriées dans la liste déroulante.

Exécution d’un script généré Pour exécuter votre script personnalisé une fois la génération de la sortie terminée, sélectionnez le fichier script.js dans la liste déroulante. Les fichiers .js affichés dans la liste proviennent du dossier de script de vos données d'application RoboHelp.

Contenu

Utilisez les options suivantes pour spécifier les paramètres de sortie liés au contenu, tels que les groupes de microcontenu, l’expression de conditions et le jeu de variables.

Groupes de microcontenus Utilisez la liste déroulante pour sélectionner autant de groupes de microcontenus que nécessaire, en stockant plusieurs intentions/réponses des groupes sélectionnés, ce qui génère diverses réponses à la requête de l’utilisateur.

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.

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.

Dialogflow

Utilisez les options suivantes pour spécifier les paramètres de sortie, tels que Informations sur le client JSON et Incorporer ce code.

Informations sur le client JSON Spécifiez le fichier JSON contenant les informations d’identification de l’agent Google Dialogflow.Pour Configuration de l'authentification Dialogflow, cliquez sur la note en fin de page pour être guidé étape par étape afin d'obtenir le fichier Informations sur le client JSON.

Client

Les paramètres suivants contiennent un ensemble de messages prédéfinis destinés à être utilisés uniquement avec l’exemple d’agent.Vous pouvez accepter ou modifier les chaînes par défaut (texte de bienvenue, texte par défaut, messages d’erreur, etc.), puis générer la sortie de chatbot. 

Message de bienvenue Utilisez-le comme première réponse envoyée par le bot à l’utilisateur qui lance une conversation en direct. Par exemple : « Comment puis-je vous aider ? » 

Réponse par défaut Il s’agit d’une réponse de secours pour votre chatbot lorsqu’un utilisateur envoie un message auquel votre chatbot n’est pas configuré pour avoir une réponse.

Message de nouvelle tentative Il s’agit du processus de nouvelle tentative d'envoi de la réponse qui n’a pas pu être remise. Si la remise d’une réponse échoue, le message de nouvelle tentative s’affiche.  Par exemple : « Accordez-moi une minute pour vous aider. »

Texte de l’espace réservé de la zone de saisie Il s'agit d'un texte prédéfini visible dans l’interface utilisateur Chatbot. Le texte s’affiche dans le champ de saisie avant que l’utilisateur n’entre du texte au format attendu.

Message d’erreur Il est affiché lorsque le bot ne parvient à obtenir aucune réponse du serveur Dialogflow.  Par exemple : « Veuillez contacter l’administrateur. »

Incorporer ce code Copier-coller ce code dans la rubrique En-tête HTML dans laquelle vous souhaitez rendre le chatbot.

Configurer le préréglage de sortie pour la micro-aide

Vous pouvez utiliser les paramètres suivants pour configurer les différents éléments du paramètre prédéfini de sortie de microcontenu pour la micro-aide :

Généralités

Utilisez les options suivantes pour spécifier les paramètres de sortie de base, tels que le chemin de sortie, le format, la langue et le script de post-génération.

Chemin 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. 

Format Spécifier le format souhaité pour votre microcontenu.

  • HTML5 + CSS3 - Utiliser pour générer la sortie en langage de balisage avec un style (par exemple, contrôle de la taille du texte, du type de police, de la couleur d’arrière-plan, etc.).
  • HTML5 - Utiliser pour générer une sortie dans le langage de balisage sans style.
  • JSON - Utiliser pour générer une sortie au format JSON.
  • XML - Utiliser pour générer une sortie au format XML.
  • Texte - Utiliser pour générer une sortie au format texte.

Langue Spécifier ce paramètre pour ajouter un attribut de langue dans le contenu.

Exécution d’un script généré Pour exécuter votre script personnalisé une fois la génération de la sortie terminée, sélectionnez le fichier script.js dans la liste déroulante. Les fichiers .js affichés dans la liste proviennent du dossier de script de vos données d'application RoboHelp.

Contenu

Utilisez les options suivantes pour spécifier les paramètres de sortie liés au contenu, tels que les groupes de microcontenu, l’expression de conditions et le jeu de variables.

Groupes de microcontenus Utilisez la liste déroulante pour sélectionner autant de groupes de microcontenus que nécessaire, en stockant plusieurs intentions/réponses des groupes sélectionnés, ce qui génère diverses réponses à la requête de l’utilisateur.

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.

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.

Publication

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. Après avoir généré la sortie, cliquez sur  en regard du paramètre prédéfini de sortie pour l’afficher. 

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, en regard de la sortie correspondante, choisissez  > Afficher le journal de publication.

Ajouter la page FAQ à la sortie Frameless

Vous pouvez créer un groupe de microcontenus, puis les combiner pour créer des FAQ. Pour ajouter une page FAQ dans la sortie Frameless, procédez comme suit :

Insérez rapidement un microcontenu dans la table des matières en le faisant glisser depuis le panneau Contenus et en le déposant dans la table des matières.

Ou bien suivez les étapes suivantes :

  1. Dans la barre d’outils Auteur, sélectionnez la table des matières dans laquelle vous souhaitez ajouter un fichier de microcontenu.

  2. Procédez de l’une des façons suivantes :

    • Dans la barre d’outils Table des matières, cliquez sur .
    • Cliquez avec le bouton droit de la souris dans l’éditeur de table des matières, puis sélectionnez Insérer une rubrique. 
  3. Dans la boîte de dialogue Insérer une rubrique, recherchez un fichier de microcontenu de votre choix.
    Cliquez sur Terminé.

  4. Le fichier de microcontenu est ajouté sous forme de FAQ dans votre sortie.

    FAQ
    Illustration de l’apparence de la page FAQ

  5. Vous pouvez également récupérer une réponse concise à la requête de recherche dans toutes les sorties de la page d’accueil et de la page de la rubrique. 
    Remarque : une réponse s’affichera sous forme d’extrait de code dans les résultats de recherche si les mots recherchés sont présents dans l’intention, les phrases ou les mots-clés de votre intention.

    extrait de code
    Rechercher des extraits de code sur la page d’accueil et la page de rubrique Frameless

Logo Adobe

Accéder à votre compte