Werkbalk Aanpassen id172FB00L0V6

Standaard wordt de webeditor geleverd met de meest voorkomende redactionele functies die door elke DITA-editor worden vereist. Functies zoals het invoegen van elementen van het type lijst (genummerd of met opsommingstekens), kruisverwijzing, inhoudsverwijzing, tabel, alinea en tekenopmaak zijn beschikbaar in de editor. Naast deze basiselementen, kunt u de Redacteur van het Web aanpassen om elementen op te nemen die in uw auteursmilieu worden gebruikt.

NOTE
Wanneer u van de oude gebruikersinterface naar de nieuwe gebruikersinterface van AEM Guides migreert (van toepassing vanaf de release van AEM Guides 2502 en 5.0), moeten updates naar ui_config worden omgezet in flexibelere en modulaire gebruikersinterfaceconfiguraties. Met dit framework kunt u naadloos wijzigingen aanbrengen in de editor_toolbar en andere doelwidget, indien van toepassing. Voor details, mening ​ Overzicht van Omzetten UI Config ​.

Er zijn twee manieren om de toolbar van de Redacteur van het Web aan te passen:

  • Nieuwe functionaliteit toevoegen aan de werkbalk

  • Bestaande functies van de werkbalk verwijderen

Een functie toevoegen aan de werkbalk

Het toevoegen van een functionaliteit aan de Redacteur van het Web impliceert twee primaire taken - toevoegend een pictogram voor de eigenschap in het {dossier 0} ui_config.json en toevoegend de achtergrondfunctionaliteit in JavaScript.

Op de volgende tabbladen vindt u instructies die zijn gebaseerd op de Experience Manager Guides-instellingen: Cloud Service of On-Premise.

Cloud Service
  1. U kunt als beheerder het configuratiebestand van de gebruikersinterface downloaden door u aan te melden bij Adobe Experience Manager.

  2. Klik op de verbinding van Adobe Experience Manager bij de bovenkant en kies Hulpmiddelen.

  3. Selecteer Gidsen van de lijst van hulpmiddelen en klik de Profielen van de Omslag.

  4. Klik op de Globale tegel van het Profiel.

  5. Selecteer het lusje van de Configuratie van de Redacteur van XML en klik uitgeven pictogram op de bovenkant

  6. Klik het pictogram van de Download om het ui _config.json- dossier op uw lokaal systeem te downloaden. Vervolgens kunt u wijzigingen in het bestand aanbrengen en het bestand vervolgens uploaden.

  7. Voeg in het bestand ui_config.json de definitie van de nieuwe functie toe in de sectie Werkbalken. Sla het bestand op en upload het.

    Doorgaans kunt u een nieuwe werkbalkknoopgroep maken en er een of meer werkbalkknoppen aan toevoegen. U kunt ook een nieuwe werkbalkknop toevoegen binnen een bestaande werkbalkgroep. U moet de volgende gegevens opgeven om een nieuwe werkbalkgroep te maken:

    type: Geef blockGroup op als de type -waarde. Deze waarde geeft aan dat u een blokgroep maakt die een of meer werkbalkgroepen zou bevatten.

    extraclass: Naam van de klasse of klassen, gescheiden door spatie.

    punten: Geef de definitie van alle groepen op de werkbalk op. Elke groep kan een of meerdere werkbalkpictogrammen bevatten. Als u pictogrammen in een werkbalkgroep wilt definiëren, moet u het kenmerk type opnieuw definiëren in de items -sectie en de waarde ervan instellen op buttonGroup . Geef een of meer klassenamen op in de eigenschap extraclass . Geef de functienaam op in de eigenschap label . In het volgende fragment uit het bestand ui_config.json wordt de definitie van het hoofdwerkbalkblok weergegeven, gevolgd door de definitie buttonGroup :

    "
    “toolbar”:
    “type”: “blockGroup”,
    “extraclass”:
    “toolbarverrichtingen”,
    “items”: [
    {
    “type”: “buttonGroup”,
    “extraclass”: “left-controls”,
    “label”: “Left Controls”,
    “items”: [
    "

    In de items -verzameling moet u de definitie voor een of meer werkbalkpictogrammen opgeven.

    U moet de volgende eigenschappen definiëren om een werkbalkpictogram toe te voegen:

    type: Geef button op als de type -waarde. Deze waarde geeft aan dat u een werkbalkknop toevoegt.

    pictogram: Geef de naam op van het koraalpictogram dat u wilt gebruiken op de werkbalk.

    variant: Geef quiet op als de variant -waarde.

    titel: Geef de knopinfo voor het pictogram op.

    on-click: Geef de opdrachtnaam op die voor de functie in het JavaScript-bestand is gedefinieerd. Als voor uw opdracht invoerparameters zijn vereist, geeft u de opdrachtnaam op als:

    "JavaScript
    “on-click”: {“name”: “AUTHOR_INSERT_ELEMENT”, “args”: “simpletable”}
    "

    toon of verberg: Als u de eigenschap show definieert, geeft u de modi op waarin het pictogram wordt weergegeven. Mogelijke waarden zijn - @isAuthorMode, @isSourceMode, @isPreviewMode, true (weergeven in alle modi) of false (verbergen in alle modi).

    In plaats van show kunt u ook de eigenschap hide definiëren. De mogelijke waarden zijn gelijk aan die in de eigenschap show , met het enige verschil dat het pictogram niet wordt weergegeven voor de opgegeven modus.

    In het volgende voorbeeld ziet u het AEM Guides-versienummer wanneer de gebruiker op het pictogram Versie tonen op de werkbalk klikt.

    Voeg de volgende code toe aan een JavaScript-bestand:

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

    Voeg de eigenschap in het {dossier 0} toe ui _config.json als:

    code language-javascript
    "type": "button",
    "icon": "alert","variant": "quiet","title": "About AEM Guides","show": "true","on-click": "user.alert"
    
  8. Creeer a clientlib omslag en voeg uw JavaScript in deze omslag toe.

  9. Werk het categoriereigenschap van de clientlib omslag bij door het de waarde van apps.fmdita.xml _editor.page_overrides toe te wijzen.

  10. Sparen het {dossier 0} ui_config.json en laad de Redacteur van het Web opnieuw.

Op locatie
  1. Meld u aan bij AEM en open de CRXDE Lite-modus.

  2. Navigeer naar het standaardconfiguratiebestand dat beschikbaar is op de volgende locatie:

    /libs/fmdita/clientlibs/clientlibs/xmleditor/ui_config.json

  3. Maak een kopie van het standaardconfiguratiebestand op de volgende locatie:

    /apps/fmdita/xmleditor/ui_config.json

  4. Navigeer naar het ui_config.json -bestand in het knooppunt apps en open het voor bewerking.

  5. Voeg in het bestand ui_config.json de definitie van de nieuwe functie toe in de sectie Werkbalken. Doorgaans kunt u een nieuwe werkbalkknoopgroep maken en er een of meer werkbalkknoppen aan toevoegen. U kunt ook een nieuwe werkbalkknop toevoegen binnen een bestaande werkbalkgroep. U moet de volgende gegevens opgeven om een nieuwe werkbalkgroep te maken:

    • type:​Specify blockGroup als type waarde. Deze waarde geeft aan dat u een blokgroep maakt die een of meer werkbalkgroepen zou bevatten.

    • extraclass: Naam van de klasse of de klassen die met ruimte worden gescheiden.

    • punten: specificeer de definitie van alle groepen in de toolbar. Elke groep kan een of meerdere werkbalkpictogrammen bevatten. Als u pictogrammen in een werkbalkgroep wilt definiëren, moet u het kenmerk type opnieuw definiëren in de items -sectie en de waarde ervan instellen op buttonGroup . Geef een of meer klassenamen op in de eigenschap extraclass . Geef de functienaam op in de eigenschap label . In het volgende fragment uit het bestand ui_config.json wordt de definitie van het hoofdwerkbalkblok weergegeven, gevolgd door de definitie buttonGroup :

      code language-json
      "toolbar": {
        "type": "blockGroup",
        "extraclass":
        "toolbar operations",
          "items": [
            {
              "type": "buttonGroup",
              "extraclass": "left-controls",
              "label": "Left Controls",
              "items": [
      

      In de items -verzameling moet u de definitie voor een of meer werkbalkpictogrammen opgeven.
      U moet de volgende eigenschappen definiëren om een werkbalkpictogram toe te voegen:

    • type: specificeer button als type waarde. Deze waarde geeft aan dat u een werkbalkknop toevoegt.

    • pictogram: specificeer de naam van het pictogram van het Koraal dat u in de toolbar wilt gebruiken.

    • variant: specificeer quiet als variant waarde.

    • titel: specificeer tooltip voor het pictogram.

    • on-click: specificeer de bevelnaam die voor de eigenschap in het dossier van JavaScript wordt bepaald. Als voor uw opdracht invoerparameters zijn vereist, geeft u de opdrachtnaam op als:

      code language-javascript
      "on-click": {"name": "AUTHOR_INSERT_ELEMENT", "args": "simpletable"}
      
    • tonen of verbergen: als u het show bezit bepaalt, dan specificeer de wijzen waarin het pictogram wordt getoond. Mogelijke waarden zijn - @isAuthorMode, @isSourceMode, @isPreviewMode, true (weergeven in alle modi) of false (verbergen in alle modi).

    In plaats van show kunt u ook de eigenschap hide definiëren. De mogelijke waarden zijn gelijk aan die in de eigenschap show , met het enige verschil dat het pictogram niet wordt weergegeven voor de opgegeven modus.

  6. Creeer a clientlib omslag en voeg uw JavaScript in deze omslag toe.

  7. Werk het categoriereigenschap van de clientlib omslag bij door het de waarde van apps.fmdita.xml _editor.page_overrides toe te wijzen.

  8. Sparen het {dossier 0} ui_config.json en laad de Redacteur van het Web opnieuw.

de codesteekproeven van JavaScript

Deze sectie bevat twee voorbeelden van JavaScript-code die u helpen om aangepaste functionaliteit toe te voegen. In het volgende voorbeeld ziet u het AEM Guides-versienummer wanneer een gebruiker op het pictogram Versie tonen op de werkbalk klikt.

Voeg de volgende code toe aan een JavaScript-bestand:

code language-javascript
/**
* This file contains an example to show AEM Guides version
* number when a user clicks on the Show Version icon in the toolbar.
* Step 1. Create a clientlib folder and add save a file with your *JavaScript code into this folder. A code sample is shared below.
* Step 2: Update the categories property of the clientlib folder by *assigning it the value of
* "apps.fmdita.xml_editor.page_overrides".
* Step 3: Add the feature in the ui_config.json file as shown after the *sample code. Save the ui_config.json file and reload the Web Editor
 */

(function (window) {
  "use strict";

  window.addEventListener('DOMContentLoaded', function () {
    fmxml.ready(function () {
      fmxml.eventHandler.subscribe({
        key: 'user.alert',
        next: function next() {
          alert("AEM Guides version x.x");
        }
      });
    });
  });
})(window);

Voeg de functie in het bestand ui_config.json toe als:

code language-json
 {
      "type": "button",
      "icon": "alert",
      "title": "About AEM Guides",
      "variant": "quiet",

  "show": "true",
      "on-click": "user.alert"
  }

In het volgende voorbeeld ziet u hoe u de status van een actief bestand in een document kunt wijzigen in “In-Review”.

code language-javascript
/**
* This file contains an example to set the document state of an active *open documen to "In-Review".
* Step 1. Create a clientlib folder and add save a file with your *JavaScript code into this folder. A code sample is shared below.
* Step 2: Update the categories property of the clientlib folder by *assigning it the value of
* "apps.fmdita.xml_editor.page_overrides".
* Step 3: Add the feature in the ui_config.json file as shown after the *sample code. Save the ui_config.json file and reload the Web Editor
 */

(function (window) {
  "use strict";

  //Wait for the page has been completely loaded

  window.addEventListener('DOMContentLoaded', function () {

    //Wait for the xml editor to start
    fmxml.ready(function () {

      //Subscribe to 'user.docstate.to.in-review' event
      fmxml.eventHandler.subscribe({
        key: 'user.docstate.to.in-review',
        next: function next() {
          var docstate = "In-Review"; // New docstate name
          var filePath = fmxml.curEditor.filePath;
// Get the file path of active open file
          if (filePath) {
            //Call API to change the doc state
            $.ajax({
              type: 'POST',
              url: '/bin/fmdita/states',
              data: {
                paths: filePath,
                operation: "setdocstates",
                docstate: docstate
              }
            }).fail(function (xhr, textStatus, errorThrown) {
              console.error("Cannot update docstate to " + docstate);
            }).success(function (data) {
              console.log('docstate updated to ' + docstate);
            });
          }
        }
      });
    });
  });
})(window);

Voeg de functie in het bestand ui_config.json toe als:

code language-json
 {
      "type": "button",
      "icon": "actions",
      "title": "Change document state to In-Review",
      "variant": "quiet",
      "show": "true",
      "on-click": "user.docstate.to.in-review"
    }

Een functie verwijderen uit de werkbalk

Soms wilt u wellicht niet alle functies weergeven die momenteel beschikbaar zijn in de webeditor. In dat geval kunt u de ongewenste functie verwijderen van de werkbalk van de webeditor.

Op de volgende tabbladen vindt u instructies voor het verwijderen van ongewenste functies van de werkbalk op basis van de Experience Manager Guides-instellingen: Cloud Service of On-Premise.

Cloud Service
  1. U kunt als beheerder het configuratiebestand van de gebruikersinterface downloaden door u aan te melden bij Adobe Experience Manager.

  2. Klik op de verbinding van Adobe Experience Manager bij de bovenkant en kies Hulpmiddelen.

  3. Selecteer Gidsen van de lijst van hulpmiddelen en klik de Profielen van de Omslag.

  4. Klik op de Globale tegel van het Profiel.

  5. Selecteer het lusje van de Configuratie van de Redacteur van XML en klik uitgeven pictogram op de bovenkant

  6. Klik het pictogram van de Download om het ui _config.json- dossier op uw lokaal systeem te downloaden. Vervolgens kunt u wijzigingen in het bestand aanbrengen en het bestand vervolgens uploaden.

    Het bestand ui_config.json heeft drie secties:

    1. toolbars: Deze sectie bevat de definitie van alle functies die beschikbaar zijn op de werkbalk van de editor, zoals Genummerde lijst invoegen/verwijderen, (bestand) Sluiten, Opslaan, Opmerkingen en meer.

    2. kortere weg: Deze sectie bevat de definitie van toetsenbordkortere weg die aan een bepaalde eigenschap in de redacteur wordt toegewezen.

    3. malplaatjes: Deze sectie bevat de vooraf gedefinieerde structuur van DITA-elementen die u in uw document kunt gebruiken. Standaard bevat de sjabloonsectie sjabloondefinities voor een alinea, eenvoudige tabel, tabel en tekstelementen. U kunt een sjabloondefinitie maken voor elk element door een geldige XML-structuur toe te voegen voor het gewenste element. Als u bijvoorbeeld een p -element wilt toevoegen met elk nieuw li -element in een lijst, kunt u de volgende code toevoegen aan het einde van de sjabloonsectie om dit te bereiken:

    code language-css
    "li": "<li><p></p></li>"
    
  7. Verwijder in de sectie Werkbalken het item van de functie die u niet aan uw gebruikers wilt tonen.

  8. Sparen het {dossier 0} ui_config.json en laad de Redacteur van het Web opnieuw.

Op locatie
  1. Meld u aan bij AEM en open de CRXDE Lite-modus.

  2. Navigeer naar het standaardconfiguratiebestand dat beschikbaar is op de volgende locatie:

    /libs/fmdita/clientlibs/clientlibs/xmleditor/ui_config.json

  3. Maak een kopie van het standaardconfiguratiebestand op de volgende locatie:

    /apps/fmdita/xmleditor/ui_config.json

  4. Navigeer naar het ui_config.json -bestand in het knooppunt apps en open het voor bewerking.
    Het bestand ui_config.json heeft drie secties:

  • toolbars: Deze sectie bevat de definitie van alle functies die beschikbaar zijn op de werkbalk van de editor, zoals Genummerde lijst invoegen/verwijderen, (bestand) Sluiten, Opslaan, Opmerkingen en meer.

  • kortere weg: Deze sectie bevat de definitie van toetsenbordkortere weg die aan een bepaalde eigenschap in de redacteur wordt toegewezen.

  • malplaatjes: Deze sectie bevat de vooraf gedefinieerde structuur van DITA-elementen die u in uw document kunt gebruiken. Standaard bevat de sjabloonsectie sjabloondefinities voor een alinea, eenvoudige tabel, tabel en tekstelementen. U kunt een sjabloondefinitie maken voor elk element door een geldige XML-structuur toe te voegen voor het gewenste element. Als u bijvoorbeeld een p -element wilt toevoegen met elk nieuw li -element in een lijst, kunt u de volgende code toevoegen aan het einde van de sjabloonsectie om dit te bereiken:

code language-html
"li": "<li><p></p></li>"
  1. Verwijder in de sectie Werkbalken het item van de functie die u niet aan uw gebruikers wilt tonen.

  2. Sla het *ui\_config.json* -bestand op en laad de webeditor opnieuw.

recommendation-more-help
experience-manager-guides-help-product-guide