Publication dans la base de connaissances Atlassian Confluence

Introduction

La base de connaissances Atlassian Confluence permet aux équipes d’accéder rapidement et facilement aux solutions. Il s’agit d’une plateforme accessible de gestion des connaissances, offrant une organisation et une création faciles de contenu, ainsi qu’un moteur de recherche puissant afin d’assister le personnel et les clients.

Avec l’intégration de Confluence, Adobe RoboHelp a étendu ses capacités de publication pour permettre la publication directe d’articles sur la Base de connaissances Confluence.

Pour vous connecter à la base de connaissances Confluence, votre organisation doit configurer un compte dans Atlassian. Pour plus d’informations, consultez Support Atlassian.

Ressources clés :

• Profils
• Configuration des comptes

Configurer le flux de travail

Voici les étapes pour configurer la base de connaissances Confluence avant de publier votre sortie.

• Configurez un profil de publication.
• Créez et configurez un paramètre prédéfini de sortie.

Configurer un profil de publication

Vous devez créer et configurer un profil de publication avant de publier votre sortie dans la base de connaissances
Confluence. Pour créer et configurer un profil :

MODIFIER UN PROFIL

Pour modifier un profil, cliquez sur son nom et modifiez ses champs.

SUPPRIMER UN PROFIL

Pour supprimer un profil, cliquez sur  à côté du profil.

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

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

Configuration d’un paramètre prédéfini de sortie pour la base de connaissances Confluence

Vous pouvez utiliser les paramètres suivants pour configurer le paramètre prédéfini de sortie Base de connaissances Confluence :

Général

Utilisez les options suivantes pour spécifier les paramètres de sortie de base comme le titre, la cible, le chemin de sortie, le codage, 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+Shift+9, 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.

Chemin de sortie : Indiquer un emplacement pour la sortie. Pour sélectionner un emplacement, sélectionnez  . 

Assurez-vous que le chemin d’accès de sortie ne se trouve PAS dans le dossier du projet. La génération de la sortie échoue si le chemin d’accès de sortie se trouve dans le dossier du projet. 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.

Langue : utilisez la liste déroulante afin de sélectionner la langue pour la sortie. La liste des langues prises en charge par Confluence s’affiche.

Codage : Confluence recommande le codage Unicode (UTF-8) défini par défaut.

Publication d’un script généré : sélectionnez le fichier de script .js dans la liste déroulante pour exécuter votre script personnalisé après la génération de la sortie.

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’expression de condition et du jeu de variables.

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.

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.

Inclure le texte à développer : sélectionnez cette option pour inclure le texte à développer dans votre sortie Base de connaissances. Sinon, seul le titre à développer est inclus dans la sortie. 

Inclure le contenu du texte déroulant : sélectionnez cette option pour inclure le texte déroulant dans votre sortie Base de connaissances. Sinon, seul le titre déroulant est inclus dans la sortie. 

Mise en page

Utilisez l’option pour configurer l’aspect de votre sortie.

Confluence

Profil de publication :  utilisez la liste déroulante pour sélectionner votre profil de connexion Confluence. Pour savoir comment créer un profil de publication, voir Configurer un profil de publication.

Espace : entrez l’espace où le contenu doit être publié. Cet espace doit exister dans votre site Confluence.

Page : entrez la page parente sous laquelle le contenu doit être publié. Si aucune page n’est sélectionnée, le contenu est publié à la racine de l’espace sélectionné.

Convertir tous les styles en styles inline : sélectionnez cette option pour vous assurer que le style utilisé dans RoboHelp est conservé lorsque vous publiez la sortie sur Confluence, car il n’est pas possible de joindre des feuilles de style.

Supprimer l’en-tête de rubrique du corps de l’article : sélectionnez cette option pour supprimer les en-têtes de rubrique utilisés dans RoboHelp lorsque vous publiez la sortie dans Confluence.

Utiliser des mots-clés de recherche de la rubrique comme étiquettes d’article : sélectionnez cette option pour utiliser des mots-clés de recherche de la rubrique comme étiquettes d’article de la sortie que vous avez publiée dans Confluence.

Charger comme brouillon : si vous activez cette option, tous les articles publiés sur Confluence s’afficheront à l’état de brouillon.

Charger les images : sélectionnez cette option si vous souhaitez que des images dans les rubriques soient incluses dans la sortie publiée.

Charger les documents liés : sélectionnez cette option si vous souhaitez que les documents (par exemple PPT, PPTX, DOC, DOCX et PDF) liés dans les rubriques soient inclus dans la sortie publiée.

Articles

Choisissez les rubriques que vous souhaitez publier dans la base de connaissances Confluence. Développez un nœud de table des matières et choisissez les rubriques que vous souhaitez publier.

Sélectionner Enregistrer   pour enregistrer les modifications apportées au paramètre prédéfini de sortie.

Publier dans la base de connaissances Confluence

Vous pouvez configurer le paramètre prédéfini de sortie Base de connaissances pour effectuer la liaison avec Confluence, puis publier votre contenu dans la base de connaissances Confluence.