Anpassa verktygsfältet id172FB00L0V6
Som standard levereras webbredigeraren med de vanligaste redigeringsfunktionerna som krävs av alla DITA-redigerare. Du kan använda funktioner som att infoga element av typen lista (numrerad eller punktad), korsreferens, innehållsreferens, tabell-, stycke- och teckenformatering i redigeraren. Förutom dessa grundläggande element kan du anpassa Web Editor för att infoga element som används i redigeringsmiljön.
Det finns två sätt att anpassa Web Editors verktygsfält:
-
Lägga till en ny funktion i verktygsfältet
-
Ta bort alla befintliga funktioner från verktygsfältet
Lägga till en funktion i verktygsfältet
Om du lägger till en funktion i Web Editor innebär det två primära åtgärder - att lägga till en ikon för funktionen i ui_config.json och lägga till bakgrundsfunktioner i JavaScript.
Gör så här för att lägga till en funktion i Web Editor-verktygsfältet:
-
Om du vill hämta UI-konfigurationsfilen loggar du in på Adobe Experience Manager som administratör.
-
Klicka på länken Adobe Experience Manager överst och välj verktyg.
-
Välj Stödlinjer i listan med verktyg och klicka på Mappprofiler.
-
Klicka på Global profil platta.
-
Välj Konfiguration av XML-redigerare och klicka Redigera ikonen längst upp
-
Klicka på Ladda ned om du vill hämta filen ui_config.json på ditt lokala system. Du kan sedan göra ändringar i filen och sedan överföra samma fil.
-
I
ui_config.json
lägger du till definitionen av den nya funktionen i verktygsfältsavsnittet. Spara filen och överför den.Vanligtvis kan du skapa en ny verktygsfältsknappgrupp och lägga till en eller flera knappar i den. Du kan också lägga till en ny verktygsfältsknapp i en befintlig verktygsfältgrupp. Följande information krävs för att skapa en ny verktygsfältgrupp:
type: Ange
blockGroup
somtype
värde. Detta värde anger att du skapar en blockgrupp som skulle innehålla en eller flera verktygsfältsgrupper.extraclass: Namnet på klassen eller klasserna avgränsade med blanksteg.
objekt: Ange definitionen för alla grupper i verktygsfältet. Varje grupp kan innehålla en eller flera verktygsfältsikoner. Om du vill definiera ikoner i en verktygsfältgrupp måste du definiera
type
-attribut iitems
och ange värdet tillbuttonGroup
. Ange ett eller flera klassnamn iextraclass
-egenskap. Ange funktionsnamnet i dialogrutanlabel
-egenskap. Följande utdrag frånui_config.json
filen visar definitionen för huvudverktygsfältets block, följt avbuttonGroup
definition:code language-none " "toolbar": { "type": "blockGroup", extraklass: "verktygsfältsoperationer", "items": [ { "type": "buttonGroup", "extraclass": "left-controls", "label": "Left Controls", "items": [ "
I
items
-samling måste du ange definitionen för en eller flera verktygsfältsikoner.Du måste definiera följande egenskaper för att lägga till en verktygsfältsikon:
type: Ange
button
somtype
värde. Detta värde anger att du lägger till en verktygsfältsknapp.icon: Ange namnet på den korallikon som du vill använda i verktygsfältet.
variant: Ange
quiet
somvariant
värde.title: Ange verktygstipset för ikonen.
klicka: Ange det kommandonamn som är definierat för funktionen i JavaScript-filen. Om kommandot kräver indataparametrar anger du kommandonamnet som:
code language-none "Javascript "on-click": {"name": "AUTHOR_INSERT_ELEMENT", "args": "simpletable"} "
visa eller dölja: Om du definierar
show
anger sedan de lägen som ikonen ska visas i. Möjliga värden är -@isAuthorMode
,@isSourceMode
,@isPreviewMode
,true
(visas i alla lägen), ellerfalse
(dölj i alla lägen).I stället för
show
kan du också definierahide
-egenskap. Möjliga värden är desamma som ishow
-egenskapen med den enda skillnaden att ikonen inte visas för det angivna läget.I följande exempel visas versionsnumret AEM stödlinjerna när användaren klickar på ikonen Visa version i verktygsfältet.
Lägg till följande kod i en JavaScript-fil:
code language-javascript $(document).ready(setTimeout(function() { fmxml.commandHandler.subscribe({ key: 'user.alert', next: function() { alert("AEM Guides version x.x") } }) }, 1000))
Lägg till funktionen i ui_config.json fil som:
code language-javascript "type": "button", "icon": "alert","variant": "quiet","title": "About AEM Guides","show": "true","on-click": "user.alert"
-
Skapa en clientlib och lägg till ditt JavaScript i den här mappen.
-
Uppdatera kategoriegenskapen för clientlib genom att tilldela den värdet apps.fmdita.xml_editor.page_overrides.
-
Spara ui_config.json och läsa in webbredigeraren igen.
Ta bort en funktion från verktygsfältet
Ibland kanske du inte vill ge alla funktioner som är tillgängliga i Web Editor, och då kan du ta bort den oönskade funktionen från Web Editor.
Så här tar du bort oönskade funktioner från verktygsfältet:
-
Om du vill hämta UI-konfigurationsfilen loggar du in på Adobe Experience Manager som administratör.
-
Klicka på länken Adobe Experience Manager överst och välj verktyg.
-
Välj Stödlinjer i listan med verktyg och klicka på Mappprofiler.
-
Klicka på Global profil platta.
-
Välj Konfiguration av XML-redigerare och klicka Redigera ikonen längst upp
-
Klicka på Ladda ned om du vill hämta filen ui_config.json på ditt lokala system. Du kan sedan göra ändringar i filen och sedan överföra samma fil.
The
ui_config.json
filen har tre avsnitt:-
verktygsfält: Det här avsnittet innehåller en definition av alla funktioner som är tillgängliga i redigerarens verktygsfält, t.ex. Infoga/ta bort numrerad lista, Stäng, Spara, Kommentarer med mera.
-
genvägar: Det här avsnittet innehåller definitionen av kortkommandon som tilldelats en viss funktion i redigeraren.
-
mallar: Det här avsnittet innehåller den fördefinierade strukturen för DITA-element som du kan använda i ditt dokument. Som standard innehåller mallavsnittet malldefinitioner för ett stycke-, enkel tabell-, tabell- och body-element. Du kan skapa en malldefinition för vilket element som helst genom att lägga till en giltig XML-struktur för det önskade elementet. Om du till exempel vill lägga till en
p
element med alla nyali
-element i en lista kan du lägga till följande kod i slutet av mallavsnittet för att uppnå detta:
code language-css "li": "<li><p></p></li>"
-
-
I verktygsfältsavsnittet tar du bort den funktion som du inte vill visa för användarna.
-
Spara ui_config.json och läsa in webbredigeraren igen.
Överordnat ämne: Anpassa Web Editor