Configuration de profils globaux ou au niveau du dossier id181AH2003PF

Dans une entreprise, différents groupes ou produits peuvent utiliser différents modèles de création, modèles de sortie, profils d’attributs conditionnels (ou schémas d’objet) et configurations de l’éditeur web. Leur configuration uniquement au niveau de l’entreprise (ou global) peut rendre l’expérience difficile pour les auteurs, car ils verront des modèles ou des profils qui ne les concernent pas.

AEM Guides vous permet de configurer les modèles de création (rubrique ou mappage), les modèles de sortie, les attributs conditionnels et les configurations de l’éditeur web au niveau de l’entreprise (global) ainsi qu’au niveau des dossiers. Vous pouvez ainsi séparer les configurations pour différents services ou produits de votre entreprise.

Vous pouvez également déléguer les configurations spécifiques aux dossiers à un service ou à des administrateurs de produit afin de décentraliser l’administration.

À l’aide de la mosaïque Profils de dossier dans les paramètres Guides, vous pouvez configurer les paramètres dans les onglets suivants :

{width="800"}

Vous pouvez configurer les deux types de profil : profil global et profil au niveau du dossier. Dans un profil au niveau du dossier, vous pouvez définir les dossiers auxquels les paramètres seront applicables. Ces paramètres incluent les attributs conditionnels, les modèles, les paramètres prédéfinis de sortie et les paramètres de l’éditeur XML. Les paramètres prédéfinis conditionnels, les modèles et les configurations de l’éditeur XML sont ensuite mis à la disposition des auteurs qui travaillent dans les dossiers configurés. De même, les éditeurs auront accès aux paramètres prédéfinis de sortie configurés dans les dossiers configurés.

Un profil au niveau du dossier remplace les paramètres configurés dans le profil global. En d’autres termes, si un dossier possède un profil au niveau du dossier, il affichera les modèles, les modèles de sortie et les paramètres de l’éditeur XML configurés dans son profil de dossier correspondant. Les paramètres configurés dans le profil global ne s’affichent pas. Toutefois, cela ne s’applique pas aux attributs conditionnels. Dans le cas d’attributs conditionnels, les attributs conditionnels sont fusionnés au niveau global et au niveau du dossier.

Les sections suivantes vous guident tout au long du processus de configuration des profils globaux et des profils au niveau des dossiers.

Configurer le profil global

Pour configurer le profil global, procédez comme suit :

Création et configuration d’un profil au niveau du dossier

Pour configurer un profil au niveau du dossier, procédez comme suit :

Vous êtes maintenant prêt à configurer les attributs conditionnels, les modèles, les paramètres prédéfinis de sortie et l’éditeur XML.

Configurer des attributs conditionnels pour les profils globaux ou au niveau du dossier id1889D0I305Z

Pour configurer les attributs conditionnels standard pris en charge par DITA au niveau global ou du dossier, procédez comme suit :

Si vous utilisez un attribut personnalisé, il doit s'agir d'un attribut DITA valide pris en charge par la DTD. Si vous souhaitez utiliser un attribut qui n'est pas un attribut DITA standard, effectuez les étapes supplémentaires suivantes :

Configurer des modèles id1889D0IL0Y4

AEM Guides est fourni avec 7 modèles de rubrique prêts à l'emploi, 2 modèles de plan DITA et 3 modèles PDF. Vous pouvez choisir de ne laisser que quelques modèles à la disposition des auteurs et des éditeurs. Si vous utilisez un modèle personnalisé, celui-ci peut être configuré et mis à disposition pour la création et la publication. Utilisez l’onglet Modèles dans la configuration des profils de dossier pour ajouter ou supprimer des modèles de rubrique, de mappage ou de PDF des profils globaux ou au niveau du dossier.

Avant même de configurer les modèles de rubrique, de mappage ou de PDF au niveau global ou du dossier, vous pouvez également définir un emplacement pour stocker vos modèles personnalisés. Pour configurer un emplacement personnalisé afin de stocker les modèles, voir Configurer le chemin d'accès au dossier de modèles DITA personnalisés.

Pour ajouter les modèles de rubrique, de mappage ou PDF à un profil de dossier, procédez comme suit :

Si vous avez configuré les modèles sur un profil au niveau du dossier, les modèles configurés sont associés au dossier configuré. Tous les projets créés sous le dossier configuré auront accès uniquement aux modèles configurés sous le profil au niveau du dossier.

Créer un modèle de création personnalisé id1917D0EG0HJ

AEM Guides permet de créer facilement des modèles. En tant qu’administrateur ou administratrice système, vous pouvez utiliser l’éditeur web pour créer des modèles à partir de zéro. Vous pouvez ensuite ajouter le nouveau modèle dans le profil global ou l’affecter à un dossier spécifique à l’aide du profil spécifique au dossier.

Pour créer un modèle de création personnalisé, procédez comme suit :

Configuration des paramètres prédéfinis de sortie id18AGD0IH0Y4

Dans une configuration d’entreprise standard, différents modèles de sortie peuvent être utilisés pour différents produits ou guides d’utilisation. En outre, il pourrait y avoir certains processus communs de génération de sortie qui devraient être utilisés par tous les éditeurs et un ensemble de processus spécifiques de génération de sortie pour un groupe spécifique d’éditeurs ou de projets.

AEM Guides permet à l’administrateur de créer des paramètres prédéfinis de sortie avec des paramètres spécifiques qui peuvent ensuite être utilisés par l’ensemble des éditeurs ou un ensemble spécifique d’éditeurs et éditrices pour générer une sortie. Par exemple, l’administrateur peut créer un paramètre prédéfini de sortie pour générer un guide de l’utilisateur commun à tous les éditeurs. Et un autre pour créer les manuels d'utilisation de programmation qui sont spécifiques à un ensemble d'éditeurs. Ces deux paramètres prédéfinis peuvent être configurés pour utiliser différents modèles de sortie. Dans cet exemple, le paramètre prédéfini de publication commun pour la génération du guide d’utilisation peut être configuré au niveau global. De plus, le paramètre prédéfini de sortie pour générer le manuel d’utilisation de programmation peut être configuré au niveau du dossier.

Une fois les paramètres prédéfinis de sortie par défaut créés dans le système, tous les plans DITA créés par la suite utiliseront les paramètres prédéfinis par défaut pour générer la sortie. Cependant, tous les mappages DITA existants continueront à utiliser les paramètres prédéfinis de sortie qui ont été configurés précédemment avec eux. Si vous souhaitez appliquer le nouveau paramètre prédéfini de sortie à tous les plans DITA existants, vous devez exécuter le workflow Appliquer les modifications de paramètre prédéfini .

Outre les paramètres prédéfinis configurés au niveau global ou d’entreprise, un éditeur disposerait toujours des droits nécessaires pour créer d’autres paramètres prédéfinis de sortie. Toutefois, ces paramètres prédéfinis sont liés au plan DITA pour lequel ils sont créés. Pour plus d'informations sur la création de paramètres prédéfinis de sortie standard pour un plan DITA, voir Créer, modifier, dupliquer ou supprimer un paramètre prédéfini de sortie dans le guide Utilisation d'Adobe Experience Manager Guides as a Cloud Service.

Effectuez les étapes suivantes pour configurer des paramètres prédéfinis de sortie globaux ou spécifiques à un dossier :

Tous les plans DITA créés ou chargés par la suite auront le nouveau paramètre de sortie prédéfini ou celui mis à jour.

Application des modifications de paramètre prédéfini id18AGD0K0OHS

Un nouveau paramètre prédéfini de sortie créé au niveau global est disponible pour tous les nouveaux plans DITA que vous créerez à l'avenir. De même, si un nouveau paramètre prédéfini de sortie est créé au niveau d’un dossier, il est mis à la disposition de tous les mappages qui seront créés dans le dossier configuré. Par défaut, aucun nouveau paramètre prédéfini de sortie n'est disponible pour les plans DITA existants.

Si vous avez mis à jour un paramètre prédéfini de sortie existant ou si vous souhaitez rendre un nouveau paramètre prédéfini de sortie disponible pour les plans DITA existants, effectuez les étapes suivantes :

Configurer l’assistant AI pour l’aide et la création intelligentes

Pour Experience Manager Guides as a Cloud Service .

L’assistant AI d’Adobe Experience Manager Guides est un puissant outil piloté par l’IA conçu pour améliorer votre contenu grâce à des expériences de création et de réutilisation de contenu intelligentes. Il associe deux puissantes fonctionnalités d’IA (Création et Aide) à l’interface de Experience Manager Guides, ce qui vous permet de créer des documents et d’accéder aux informations plus rapidement et plus efficacement.

Pour plus d’informations sur la configuration, voir Configuration de l’assistant AI.

Configurer des suggestions intelligentes optimisées par l’IA

Vous pouvez configurer les suggestions intelligentes optimisées par l’IA et aider les auteurs à réutiliser le contenu existant et à créer facilement des références de contenu correctes et cohérentes. L’onglet Configuration de l’IA vous permet de contrôler les paramètres de Suggérer du contenu réutilisable à partir du panneau de l’assistant d’IA dans l’éditeur web.

Effectuez les étapes suivantes pour configurer la configuration d’IA standard au niveau du profil global ou du dossier :

Découvrez comment afficher et ajouter des suggestions intelligentes basées sur l’IA pour ajouter des références de contenu lors de la création dans l’éditeur web.

Personnaliser les questions par défaut pour l’aide dynamique

Pour Experience Manager Guides as a Cloud Service.

Vous pouvez configurer l’aide intelligente optimisée par l’IA Aide pour aider les auteurs à poser des questions et à rechercher facilement le contenu requis dans la documentation de Experience Manager Guides.

L’onglet Configuration de l’éditeur XML vous permet de configurer les questions par défaut du panneau Aide.

Pour configurer les questions par défaut, procédez comme suit :

Pour en savoir plus sur l’utilisation de l’aide intelligente optimisée par IA afin de rechercher le contenu requis, consultez la documentation de Experience Manager Guides.

Configuration et personnalisation de l’éditeur XML id2065G300O5Z

Par défaut, l'éditeur XML est fourni avec de nombreuses fonctions pour aider vos auteurs à créer des documents DITA. Si vous travaillez dans un environnement restrictif, vous pouvez choisir les fonctionnalités exposées à vos auteurs. L’onglet Configuration de l’éditeur XML vous permet de contrôler facilement les fonctionnalités et de modifier également l’aspect de votre éditeur. En tant qu’administrateur, vous pouvez personnaliser les composants suivants de l’éditeur :

Configuration de l’interface utilisateur de l’éditeur XML

Ce paramètre vous permet de créer des extensions JSON qui reflètent les modifications apportées au fichier ui_config.json. Vous pouvez charger ces extensions indépendamment au niveau du profil du dossier, offrant ainsi une flexibilité et une personnalisation améliorées. Par exemple, lorsque vous apportez des modifications à la configuration de l’éditeur XML, comme la mise à jour d’un bouton, le système identifie automatiquement les différences. En chargeant ces modifications dans la Configuration de l’interface utilisateur de l’éditeur XML et en les convertissant en extensions JSON à l’aide du bouton Convertir la configuration de l’interface utilisateur en JSON, le système génère une extension qui incorpore la nouvelle fonctionnalité.

En savoir plus sur la personnalisation des configurations JSON et la conversion des configurations de l’interface utilisateur pour le nouvel éditeur AEM Guides.

Mise en page de l’éditeur XML

Cette fonctionnalité vous permet de charger des fichiers CSS pour appliquer un style aux nouvelles extensions chargées sous la Configuration de l’interface utilisateur de l’éditeur XML. La feuille de style CSS chargée est appliquée de manière cohérente dans toutes les applications pertinentes, ce qui garantit une apparence unifiée et soignée pour vos personnalisations de l’interface utilisateur.

Configuration de l’éditeur XML

Ce paramètre contrôle la barre d’outils et les autres éléments de l’interface utilisateur de l’éditeur. Sélectionnez l’icône Télécharger pour télécharger le fichier ui\_config.json sur votre système local. Vous pouvez ensuite apporter des modifications au fichier et le charger. Selon l’endroit où vous téléchargez le fichier, le profil global ou le profil au niveau du dossier, les modifications sont appliquées en conséquence. Pour plus d’informations sur la personnalisation de l’éditeur XML à l’aide de l’ui\_config.json file, consultez la section Personnaliser la barre d’outils.

Disposition du modèle CSS

Téléchargez le fichier disponible dans cette section pour personnaliser l’aspect de votre document lorsqu’il est prévisualisé ou ouvert pour modification dans l’éditeur web. Le fichier CSS par défaut disponible au téléchargement est uniquement un fichier test, qui ne doit pas être utilisé à des fins de personnalisation. Vous pouvez créer un fichier CSS avec des personnalisations pour l’éditeur web et le charger. Par exemple, vous pouvez créer un fichier .css avec le code suivant :

.title {    font-size: 9em;}

Enregistrez ce fichier et chargez-le dans la section Disposition du modèle CSS. La prochaine fois que vous téléchargerez le fichier , vous obtiendrez le dernier fichier CSS utilisé dans l’éditeur web.

Fragments de code de l’éditeur XML

À l’aide du fichier de configuration de cette section, vous pouvez créer des fragments de code par défaut et les partager avec vos auteurs. La structure par défaut du fichier est présentée ci-dessous :

{
   "snippetID": {
      "name": "snippet Name",
      "description": "snippet Description",
      "value": "<i>this is snippet value</i>"
  }
}

Les informations suivantes sont requises pour créer un fragment de code :

snippetID : ID unique du fragment de code. Elle peut prendre une valeur alphanumérique.

name - Nom descriptif pour identifier le fragment de code. Ce nom s’affiche dans le panneau Fragments de code.

description - Ajoutez une description du fragment de code.

value - Indiquez le code XML du fragment de code.

Libellés de version du contenu XML

Par défaut, les auteurs sont autorisés à créer les libellés de leur choix et à les associer à leurs fichiers de rubrique. Cependant, cela peut entraîner de nombreuses variations d’un même libellé, par exemple des libellés « Version 1.0 », « Version 1.0 », « Version 1 » pour identifier la même étape d’une rubrique. Pour éviter une telle incohérence dans les libellés du système, vous pouvez créer une liste prédéfinie de libellés parmi lesquels les créateurs et créatrices seraient ensuite autorisés à choisir. L’étiquetage cohérent permet une meilleure gestion des fichiers dans votre système.

La configuration des libellés de version vous permet de charger une liste de libellés valides pour votre organisation. Téléchargez le fichier label.json par défaut et modifiez-le comme illustré ci-dessous :

{
"label1":"Draft",
"label2":"PM-Review",
"label3":"Engg-Review",
"label4":"QE-Review",
"label5":"Ready for Loc",
"label6":"Ready for Publish"
}

Dans l’exemple ci-dessus, « label1 » est l’identifiant de la séquence de libellés et il est ajouté par le libellé affiché pour les auteurs où un libellé est requis. Enregistrez ce fichier et chargez-le dans la section Libellés de version du contenu XML .

Rootmap

Si vos auteurs utilisent une carte racine spécifique, vous pouvez accéder à cette carte racine et la sélectionner ici. Notez que vous ne pouvez définir la feuille de route que pour un profil au niveau du dossier.