Barre d’outils Personnaliser id172FB00L0V6

Par défaut, l’éditeur web est fourni avec les fonctionnalités éditoriales les plus courantes requises par n’importe quel éditeur DITA. Des fonctionnalités telles que l’insertion d’éléments de type liste (numérotée ou à puces), référence croisée, référence de contenu, tableau, paragraphe et mise en forme des caractères sont disponibles dans l’éditeur. Outre ces éléments de base, vous pouvez personnaliser l’éditeur Web pour insérer les éléments utilisés dans votre environnement de création.

La barre d’outils de l’éditeur Web peut être personnalisée de deux façons :

  • Ajouter une nouvelle fonctionnalité à la barre d’outils

  • Supprimer toutes les fonctionnalités existantes de la barre d’outils

Ajouter une fonction dans la barre d’outils

L’ajout d’une fonctionnalité à l’éditeur Web implique deux tâches principales : l’ajout d’une icône pour la fonctionnalité dans la fonction ui_config.json et ajouter la fonctionnalité d’arrière-plan dans JavaScript.

Pour ajouter une fonction à la barre d’outils de l’éditeur web, procédez comme suit :

  1. Pour télécharger le fichier de configuration de l’interface utilisateur, connectez-vous à Adobe Experience Manager en tant qu’administrateur.

  2. Cliquez sur le lien Adobe Experience Manager en haut de l’écran et choisissez Outils.

  3. Sélectionner Guides dans la liste des outils, puis cliquez sur l’icône Profils de dossier.

  4. Cliquez sur le bouton Profil global mosaïque.

  5. Sélectionnez la variable Configuration de l’éditeur XML et cliquez sur Modifier icône en haut

  6. Cliquez sur le bouton 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, puis charger le même fichier.

  7. Dans le ui_config.json , ajoutez la définition de la nouvelle fonctionnalité dans la section barres d’outils. Enregistrez le fichier et téléchargez-le.

    En règle générale, vous pouvez créer un groupe de boutons de barre d’outils et y ajouter un ou plusieurs boutons. Vous pouvez également ajouter un nouveau bouton de barre d’outils dans un groupe existant. Les détails suivants sont requis pour créer un groupe de barres d’outils :

    type: spécifiez blockGroup comme la propriété type . Cette valeur indique que vous créez un groupe de blocs qui contiendra un ou plusieurs groupes de barres d’outils.

    extraclass: nom de la ou des classes séparées par un espace.

    items: spécifiez la définition de tous les groupes dans la barre d’outils. Chaque groupe peut contenir une ou plusieurs icônes de barre d’outils. Pour définir des icônes dans un groupe de barres d’outils, vous devez définir à nouveau le type dans l’attribut items, puis définissez sa valeur sur buttonGroup. Spécifiez un ou plusieurs noms de classe dans la variable extraclass . Indiquez le nom de la fonction dans la variable label . Le fragment de code suivant de la fonction ui_config.json affiche la définition du bloc de barre d’outils principal, suivie de la propriété buttonGroup définition :

    code language-none
    "
    "toolbar": {
    "type": "blockGroup",
    "extraclass":
    "opérations de la barre d’outils",
    "items": [
    {
    "type": "buttonGroup",
    "extraclass": "left-control",
    "label": "Contrôles à gauche",
    "items": [
    "
    

    Dans le items , vous devez spécifier la définition d’une ou de plusieurs icônes de barre d’outils.

    Pour ajouter une icône de barre d’outils, vous devez définir les propriétés suivantes :

    type: spécifiez button comme la propriété type . Cette valeur indique que vous ajoutez un bouton de barre d’outils.

    icon: indiquez le nom de l’icône Coral que vous souhaitez utiliser dans la barre d’outils.

    variant: spécifiez quiet comme la propriété variant .

    title: spécifiez l’info-bulle de l’icône.

    on-click: spécifiez le nom de la commande définie pour la fonction dans le fichier JavaScript. Si votre commande nécessite des paramètres d’entrée, indiquez le nom de la commande comme suit :

    code language-none
    "Javascript
    "on-click": {"name": "AUTHOR_INSERT_ELEMENT", "args": "simpletable"}
    "
    

    afficher ou masquer: si vous définissez la variable show , puis spécifiez les modes d’affichage de l’icône. Les valeurs possibles sont : @isAuthorMode, @isSourceMode, @isPreviewMode, true (affichage dans tous les modes) ou false (masquer dans tous les modes).

    À la place de show, vous pouvez également définir la variable hide . Les valeurs possibles sont les mêmes que dans show avec la seule différence que l’icône ne s’affiche pas pour le mode spécifié.

    L’exemple suivant montre le numéro de version des Guides d’AEM lorsque l’utilisateur clique sur l’icône Afficher la version dans la barre d’outils.

    Ajoutez le code suivant à un fichier JavaScript :

    code language-javascript
    $(document).ready(setTimeout(function() {
                            fmxml.commandHandler.subscribe({
                            key: 'user.alert',
                            next: function() {
                            alert("AEM Guides version x.x")
                            }
                            })
                            }, 1000))
    

    Ajoutez la fonction dans le ui_config.json en tant que :

    code language-javascript
    "type": "button",
    "icon": "alert","variant": "quiet","title": "About AEM Guides","show": "true","on-click": "user.alert"
    
  8. Créez un clientlib et ajoutez votre JavaScript dans ce dossier.

  9. Mettez à jour la propriété categories du clientlib en lui attribuant la valeur de apps.dita.xml_editor.page_overrides.

  10. Enregistrez le ui_config.json et rechargez l’éditeur Web.

Suppression d’une fonction de la barre d’outils

Parfois, vous pouvez ne pas proposer toutes les fonctionnalités actuellement disponibles dans l’éditeur web. Dans ce cas, vous pouvez supprimer la fonction indésirable de la barre d’outils de l’éditeur web.

Pour supprimer toute fonction indésirable de la barre d’outils, procédez comme suit :

  1. Pour télécharger le fichier de configuration de l’interface utilisateur, connectez-vous à Adobe Experience Manager en tant qu’administrateur.

  2. Cliquez sur le lien Adobe Experience Manager en haut de l’écran et choisissez Outils.

  3. Sélectionner Guides dans la liste des outils, puis cliquez sur l’icône Profils de dossier.

  4. Cliquez sur le bouton Profil global mosaïque.

  5. Sélectionnez la variable Configuration de l’éditeur XML et cliquez sur Modifier icône en haut

  6. Cliquez sur le bouton 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, puis charger le même fichier.

    La variable ui_config.json comporte trois sections :

    1. barres d’outils: cette section contient la définition de toutes les fonctionnalités disponibles dans la barre d’outils de l’éditeur, telles que Insérer/Supprimer la liste numérotée, (fichier) Fermer, Enregistrer, Commentaires, etc.

    2. raccourcis: cette section contient la définition des raccourcis clavier affectés à une fonction particulière de l’éditeur.

    3. templates: cette section contient la structure prédéfinie des éléments DITA que vous pouvez utiliser dans votre document. Par défaut, la section Modèles contient des définitions de modèle pour un paragraphe, un tableau simple, un tableau et des éléments de corps. Vous pouvez créer une définition de modèle pour n’importe quel élément en ajoutant une structure XML valide pour l’élément souhaité. Par exemple, si vous souhaitez ajouter une p élément avec chaque nouveau li dans une liste, vous pouvez ajouter le code suivant à la fin de la section templates pour obtenir ce résultat :

    code language-css
    "li": "<li><p></p></li>"
    
  7. Dans la section des barres d’outils, supprimez l’entrée de la fonction que vous ne souhaitez pas afficher à vos utilisateurs.

  8. Enregistrez le ui_config.json et rechargez l’éditeur Web.

Rubrique parente : Personnalisation de l’éditeur web

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178