Konfigurera inställningar för utdatagenerering id181AI0B0E30
AEM Guides har många konfigurationsalternativ som du kan använda för att anpassa processen för generering av utdata. I det här avsnittet beskrivs alla konfigurationer och anpassningar som kan hjälpa dig att skapa utdata.
Konfigurera fliken Baslinje på kontrollpanelen för DITA-kartor id223MD0D0YRM
Du kan konfigurera och dölja fliken Baslinje som finns på kartkontrollpanelen.
Alternativet Dölj baslinjeflik är inte aktiverat som standard och du måste aktivera det från configMgr. Följ de här stegen för att aktivera alternativet som standard i Web Editor:
-
Öppna konfigurationssidan för Adobe Experience Manager Web Console.
Standardwebbadressen för åtkomst till konfigurationssidan är:
code language-http http://<server name>:<port>/system/console/configMgr
-
Sök efter och klicka på paketet com.adobe.fmdita.config.ConfigManager.
-
Välj alternativet Dölj fliken Baslinje.
-
Klicka på Spara.
note note NOTE Den här konfigurationen är inaktiverad som standard och fliken Baslinje är tillgänglig på kartkontrollpanelen.
Konfigurera FrameMaker Publishing Server id1678G0Z0TN6
Du kan använda FrameMakra Publishing Servern (FMPS) för att generera utdata för DITA-innehåll. Om du konfigurerar FMPS kan du generera utdata i flera format som stöds av FMPS.
Om du vill konfigurera AEM Guides att använda FMPS uppdaterar du följande egenskaper för paketet com.adobe.fmdita.config.ConfigManager
i webbkonsolen.
- FMPS 2019 och tidigare: IP-adress eller domännamn
- FMPS 2020:
http://<fmps_ip>:<port>
(http://192.168.1.101:7000)- FMPS 2019 och tidigare:
http://<fmps_ip>:<port>/fmserver/v1/
- FMPS 2020: 2020
- FMPS 2019 och tidigare: 2019 eller 2017
Standardvärde: 300 sekunder (5 minuter)
http://<server-name>:<port>/
.Konfigurera blandad publicering på en befintlig AEM id1691I0V0MGR
Om du har en AEM webbplats som innehåller DITA-innehåll kan du konfigurera dina AEM webbplatsutdata så att DITA-innehåll publiceras på en fördefinierad plats på platsen. I följande skärmbild på en AEM webbplatssida är noden ditacontent
reserverad för lagring av DITA-innehåll:
De återstående noderna på sidan redigeras direkt från AEM. Om du konfigurerar publiceringsinställningen för att publicera DITA-innehåll på en fördefinierad plats, säkerställs att inget av ditt befintliga icke-DITA-innehåll ändras i AEM Guides publiceringsprocess.
Du måste göra följande konfigurationer på din befintliga webbplats för att tillåta publicering av DITA-innehåll till en fördefinierad nod:
-
Konfigurera platsens mallegenskaper
-
Lägg till noder på webbplatsen för att publicera DITA-innehåll
Utför följande steg för att konfigurera den befintliga platsens mallegenskaper:
-
Logga in AEM och öppna läget CRXDE Lite.
-
Navigera till platsens mallkonfigurationsnod. AEM Guides lagrar till exempel standardmallkonfigurationerna i följande nod:
/libs/fmdita/config/templates/default
note note NOTE Gör inga anpassningar i standardkonfigurationsfilerna tillgängliga i noden libs
. Du måste skapa en övertäckning av nodenlibs
i nodenapps
och endast uppdatera de filer som krävs i nodenapps
. -
Lägg till följande egenskaper:
table 0-row-3 1-row-3 2-row-3 Egenskapsnamn Typ Värde topicContentNode
Sträng Ange det nodnamn där du vill publicera DITA-innehållet. Standardnoden där AEM Guides publicerar DITA-innehåll är: jcr:content/contentnode
topicHeadNode
Sträng Ange det nodnamn där du vill lagra metadatainformationen för DITA-innehållet. Standardnoden där AEM Guides lagrar metadatainformation är till exempel: jcr:content/headnode
På följande skärmbild visas de egenskaper som lagts till i standardmallnoden i AEM Guides:
Nästa gång du publicerar DITA-innehåll med mallkonfigurationer för din webbplats publiceras innehållet i de noder som anges i egenskaperna topicContentNode
och topicHeadNode
.
För befintliga webbplatser måste du dock lägga till noderna topicContentNode
och topicHeadNode
manuellt.
Utför följande steg för att lägga till de nödvändiga noderna på din befintliga plats:
-
Logga in AEM och öppna läget CRXDE Lite.
-
Leta reda på
jcr:content
i platsnoden. -
Lägg till
topicContentNode
- ochtopicHeadNode
-noder med samma namn som du angav i platsens mallkonfigurationer.
Anpassa AEM webbplatsutdata id166TG0B30WR
AEM Guides har stöd för att skapa utdatafiler i följande format:
-
AEM
-
PDF
-
HTML5
-
EPUB
-
Anpassade utdata via DITA-OT
För AEM platsutdata kan du tilldela olika designmallar med olika utdatauppgifter. Dessa designmallar kan återge DITA-innehållet i olika layouter. Du kan till exempel ange olika designmallar för interna och externa målgrupper.
Du kan också använda anpassade DITA Open Toolkit-plugins med AEM Guides. Du kan överföra dessa anpassade DITA-OT-plugin-program för att generera utdata från PDF på ett visst sätt.
Anpassa designmall för generering av utdata customize_xml-add-on
AEM Guides använder en uppsättning fördefinierade designmallar för att generera AEM webbplatsutdata. Du kan anpassa AEM Guides designmallar för att generera utdata som passar företagets grafiska profil. En designmall är en samling med olika format (CSS), skript (både server- och klientsidan), resurser (bilder, logotyper och andra resurser) och JCR-noder som knyter samman alla dessa resurser. En designmall kan vara så enkel som ett enda skript på servern med bara ett par JCR-noder, eller en komplex kombination av format, resurser och JCR-noder. Designmallar används av AEM Guides undersystem för publicering när AEM genereras och de styr strukturen, utseendet och känslan hos de genererade utdata.
Det finns ingen begränsning för var designmallresurserna ska placeras på servern, men de är vanligtvis logiskt ordnade efter sin funktion. Standardmallen innehåller till exempel alla sina JavaScript- och CSS-filer som lagras i mappen /etc/designs/fmdita/clientlibs/siteoutput/default
. Oavsett var filerna finns länkas de ihop av en samling JCR-noder. Tillsammans utgör dessa JCR-noder och filerna hela designmallen.
Med standarddesignmallen som levereras med AEM Guides kan du anpassa komponenterna för landning, ämne och söksida. Du kan skapa en kopia av standarddesignen och motsvarande referensmallar och ange olika komponenter för att generera önskat utvärde.
Utför följande steg för att ange en egen designmall som ska användas för att generera utdata AEM webbplatsen:
-
Logga in AEM och öppna läget CRXDE Lite.
-
Navigera till standarddesignmallsnoden. Standarddesignmallsnodens plats är:
/libs/fmdita/config/templates/
note note NOTE Kopiera standarddesignmallarna från mappen libs
till mappenapps
och gör ändringarna i mappenapps
. Du måste också göra ändringar i mallarna som refereras från standardmallnoden. De refererade mallarna placeras under noden/libs/fmdita/templates/default/cqtemplates
. Gör en kopia av de refererade mallarna i mappenapps
innan du gör några ändringar. -
Klicka på komponenten default i noden templates för att komma åt dess egenskaper.
AEM Guides designmallsegenskaper beskrivs i följande tabell.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 Egenskap Beskrivning landingPageTemplate
,searchPageTemplate
,topicPageTemplate
,shadowPageTemplate
Ange noden cq:Template
för de motsvarande sidorna (landning, sökning och ämne). Som standard finns nodencq:Template
för de här sidorna i noden/libs/fmdita/templates/default/cqtemplates
. Den här noden definierar strukturen och egenskaperna för landnings-, söknings- och ämnessidorna.shadowPageTemplate
används för att optimera det segmenterade innehållet. Du måste ange värdet för den här egenskapen till:fmdita/templates/default/cqtemplates/shadowpage
Obs! Du måste ange ett värde förtopicPageTemplate
.landingPageTemplate
ochsearchPageTemplate
är valfria egenskaper. Om du inte vill att sök- och landningssidorna ska genereras ska du inte ange dessa egenskaper.title
Ett beskrivande namn på designmallen. topicContentNode
Platsen för noden som ska innehålla DITA-innehållet på en ämnessida. Sökvägen är relativ till ämnessidan. topicHeadNode
Platsen för noden som ska innehålla huvudvärdena (eller metadata) som härleds från DITA-innehållet. Sökvägen är relativ till ämnessidan. tocNode
Platsen för noden som ska innehålla innehållsförteckningen. Sökvägen är relativ till landningssidan eller målsökvägen. basePathProp
Egenskapsnamnet för lagring av sökvägen till den publicerade platsens rot. indexPathProp
Egenskapsnamnet för lagring av sökvägen till den publicerade platsens landnings-/indexsida. pdfPathProp
Egenskapsnamnet för lagring av PDF-sökvägen, om generering av ämnet PDF är aktiverat. pdfTypeProp
Egenskapsnamnet för lagring av PDF-genereringens typ. För närvarande innehåller den här egenskapen alltid"Ämne". searchPathProp
Egenskapsnamnet för lagring av söksidans sökväg, om mallen innehåller en söksida. siteTitleProp
Egenskapsnamnet för lagring av titeln på den webbplats som publiceras. Den här titeln är vanligtvis densamma som titeln på kartan som publiceras. sourcePathProp
Egenskapsnamnet för lagring av sökvägen till källans DITA-ämne för den aktuella sidan. tocPathProp
Egenskapsnamnet för lagring av sökvägen till TOC-roten för den publicerade webbplatsen.
Mer information finns i Skapa din första Adobe Experience Manager 6.3-webbplats och Grunderna för att utveckla din egen webbplats på AEM.
Använd dokumenttitel för att generera AEM webbplatsutdata
När du genererar AEM webbplatsutdata spelar det sätt på vilket URL:er genereras en viktig roll för att ditt innehåll ska kunna identifieras. Om du använder UUID-baserade filnamn är det inte sökvänligt att generera URL:er baserade på UUID för dina filer. Som administratör eller utgivare kan du styra hur du vill generera URL:er för AEM webbplatsutdata. AEM Guides ger dig en konfiguration genom vilken du kan välja att generera URL:er för AEM platsutdata med hjälp av filens namn i stället för UID-baserade filnamn. Som standard är det här alternativet aktiverat för UUID-baserade filsystem. Detta innebar att när du genererade utdata AEM platsen för UUID-baserade filsystem, används filens namn för att generera URL:er och inte UUID:n för filerna.
När du genererar AEM webbplatsutdata spelar det sätt på vilket URL:er genereras en viktig roll för att ditt innehåll ska kunna identifieras. Om det inte finns UUID-baserade filsystem genereras AEM platsutdata med filnamnen och inte filens titlar. Som administratör eller utgivare kan du styra hur du vill generera URL:er för AEM webbplatsutdata. AEM Guides ger dig en konfiguration genom vilken du kan välja att generera URL:er för AEM webbplatsutdata med hjälp av filens namn i stället för filnamnen. Som standard är det här alternativet inaktiverat. Detta innebar att när du genererade AEM Site-utdata används filnamnen för att generera URL:er och inte filens titel. Du kan välja att generera URL:er baserat på filens titlar genom att aktivera det här alternativet.
Så här konfigurerar du URL-generering AEM platsutdata:
-
Öppna konfigurationssidan för Adobe Experience Manager Web Console.
Standardwebbadressen för åtkomst till konfigurationssidan är:
code language-http http://<server name>:<port>/system/console/configMgr
-
Sök efter och klicka på paketet com.adobe.fmdita.config.ConfigManager.
-
Välj alternativet Använd rubrik AEM webbplatssidnamn.
note note NOTE Om du vill generera utdata med hjälp av filnamnen avmarkerar du det här alternativet. -
Klicka på Spara.
Konfigurera filnamnssaneringsregler för att skapa ämnen och publicera AEM webbplatsutdata id2164D0KD0XA
Som administratör kan du definiera en lista med giltiga specialtecken som tillåts i filnamn, som till slut utgör URL:en för en AEM webbplatsutdata. I tidigare versioner tilläts användare att definiera filnamn som innehåller specialtecken som @
, $
, >
med flera. Specialtecknen resulterade i kodad URL-adress när AEM webbplatssidor genererades.
Från och med version 3.8 har konfigurationer lagts till för att definiera en lista med specialtecken som tillåts i filnamnen. Som standard innehåller den giltiga filnamnskonfigurationen a-z A-Z 0-9 - _
. Detta innebär att när du skapar en fil kan du ha ett specialtecken i filens titel, men internt kommer det att ersättas med ett bindestreck (-
) i filnamnet. Du kan t.ex. ha filens namn som Introduktion 1 eller Introduction@1, så kommer motsvarande filnamn som skapas för båda dessa fall att vara Introduktion-1.
När du definierar en lista med giltiga tecken måste du komma ihåg att de här tecknen */:[\]|#%{}?&<>"/+
och a space
alltid ersätts med ett bindestreck (-
).
Så här konfigurerar du giltiga specialtecken i filnamn och AEM platsutdata:
-
Öppna konfigurationssidan för Adobe Experience Manager Web Console.
Standardwebbadressen för åtkomst till konfigurationssidan är:
code language-http http://<server name>:<port>/system/console/configMgr
-
Sök efter och klicka på paketet com.adobe.fmdita.common.SanitizeNodeNameImpl.
-
I egenskapen Otillåten teckenuppsättning för publicering till AEM Sites kontrollerar du att egenskapen är inställd på
'<>`@$
. Du kan lägga till fler specialtecken i den här listan, men det måste innehålla dessa specialtecken.note note NOTE Du kan också konfigurera andra egenskaper, till exempel Använd gemener i filnamn, Avgränsare för att hantera ogiltiga tecken och Maximalt antal tecken som tillåts i filnamn. -
Klicka på Spara.
-
Sök efter och klicka på paketet com.adobe.fmdita.config.ConfigManager.
-
Kontrollera att egenskapen är inställd på
[-a-zA-Z0-9_]
i egenskapen Regex för giltiga tecken . Du kan lägga till fler tecken i den här listan, men den måste innehålla dessa grundläggande tecken och listan måste börja med ett bindestreck (-
).note note NOTE This property define the list of valid character used to create a new file. -
Klicka på Spara.
Konfigurera förenkling AEM platsnodens struktur
När du genererar utdata AEM platsen skapas en nod för varje element i avsnitten internt. För en DITA-karta med tusentals ämnen kan den här nodstrukturen bli för djup. Den här typen av djupt kapslad nodstruktur kan ha prestandaproblem för större platser. I följande bild visas djupt kapslad nodstruktur för en AEM webbplatsutdata:
Observera att det i ögonblicksbilden ovan finns en nod som skapas för varje p
-element och dess efterföljande underelement, och en liknande struktur skapas för alla andra element som används i avsnittet.
Med AEM Guides kan du konfigurera hur nodstrukturen AEM platsutdata skapas internt. Du kan förenkla nodstrukturen vid angivna element, vilket innebär att du kan definiera ett element som ska betraktas som huvudelement och alla underelement i det sammanfogas med huvudelementet. Om du till exempel bestämmer dig för att förenkla elementet p
sammanfogas alla element som finns i elementet p
med huvudelementet p
. Ingen separat anteckning skulle skapas för något underelement i elementet p
. I följande ögonblicksbild visas nodstrukturen förenklad vid elementet p
:
Så här förenklar du strukturen AEM platsnoden:
-
Ange det element som du vill lägga samman nodstrukturen i.
-
Täcka över noden
libs
i nodenapps
och öppna filen elementmapping.xml. -
Lägg till egenskapen
<flatten>true</flatten>
i definitionen av elementet där du vill lägga samman nodstrukturen. Om du till exempel vill förenkla nodstrukturen vid elementetp
lägger du till attributet flatten i definitionen av elementetp
enligt nedan:code language-xml <ditaelement> <name>p</name> <class>- topic/p</class> <componentpath>fmdita/components/dita/wrapper</componentpath> <type>COMPOSITE</type> <target>para</target> <flatten>true</flatten> <wrapelement>div</wrapelement> </ditaelement>
note note NOTE Som standard har egenskapen flatten node konfigurerats vid elementet p
.
-
-
Aktivera platsnodens förenklingskonfiguration i configMgr.
-
Öppna konfigurationssidan för Adobe Experience Manager Web Console.
Standardwebbadressen för åtkomst till konfigurationssidan är:
code language-http http://<server name>:<port>/system/console/configMgr
-
Sök efter och klicka på paketet com.adobe.dxml.flattening.FlatteningConfigurationService.
-
Välj alternativet Egenskap flattening.enabled.
-
Klicka på Spara.
-
När du genererar AEM Site-utdata förenklas nu noderna i elementet p
och lagras i själva elementet p
. Du hittar de nya förenklingsegenskaperna för elementet p
i CRXDE.
Förhindra förenkling av strukturen för AEM
På samma sätt som du anger vilken nod som ska förenklas AEM platsutdata kan du även ange ett element som du vill utesluta från den här konfigurationen. Om du till exempel vill lägga samman noder vid elementet body
, men inte vill att något table
-element i body
ska läggas samman, kan du lägga till egenskapen exclude i elementets definition för table
.
Om du vill utesluta elementet table
från förenkling lägger du till följande egenskap i elementets definition för table
:
<preventancestorflattening>true|false</preventancestorflattening>
Konfigurera versionshantering för borttagna sidor AEM webbplatsutdata
När du genererar AEM webbplatsutdata med alternativet Ta bort och Skapa valt för inställningen Befintliga utdatasidor skapas en version för sidan/sidorna som tas bort. Du kan konfigurera systemet så att det inte längre skapas en version innan du tar bort den.
Utför följande steg för att stoppa skapandet av en version för den sida/de sidor som ska tas bort:
-
Öppna konfigurationssidan för Adobe Experience Manager Web Console.
Standardwebbadressen för åtkomst till konfigurationssidan är:
code language-http http://<server name>:<port>/system/console/configMgr
-
Sök efter och klicka på paketet com.adobe.fmdita.config.ConfigManager.
-
Välj alternativet Skapa inte version för borttagna sidor.
note note NOTE När det här alternativet är markerat kan användare ta bort alla sidor direkt utan att skapa någon version för dem. Om alternativet inte är markerat skapas en version innan sidan tas bort. -
Klicka på Spara.
Använda metadata i publicering via DITA-OT id191LF0U0TY4
AEM Guides erbjuder ett sätt att skicka anpassade metadata när utdata publiceras med DITA-OT. Som administratör och utgivare måste du utföra följande uppgifter för att konfigurera och använda anpassade metadata i publicerade utdata:
-
Som administratör lägger du till nödvändiga metadata i systemet så att de blir tillgängliga på sidan Egenskaper på DITA-kartan.
-
Som administratör lägger du till anpassade metadata i metadatalistan så att den visas i DITA-kartkonsolen.
-
Som utgivare konfigurerar och lägger du till anpassade metadata med DITA-kartan och skapar önskade utdata.
Så här lägger du till de metadata som krävs i systemet:
-
Logga in i Adobe Experience Manager som administratör.
-
Klicka på länken Adobe Experience Manager överst och välj Verktyg.
-
Välj Assets i listan över verktyg.
-
Klicka på panelen Metadatascheman.
Forms-sidan Metadata Schema visas.
-
Välj standardformuläret i listan.
note note NOTE Egenskaperna som visas på egenskapssidan för en DITA-karta hämtas från det här formuläret. -
Klicka på Redigera.
-
Lägg till anpassade metadata som du vill använda i publicerade utdata. Vi lägger till exempel till målgruppsmetadata med följande steg:
-
Dra och släpp komponenten Enkelradig text på formuläret från komponentlistan Skapa formulär .
-
Markera det nya fältet för att öppna fältets inställningar.
-
I fältetikett anger du metadatanamnet - målgrupp.
-
I inställningen Mappa till egenskap anger du ./jcr:content/metadata/<namn på metadata>. Vi kommer till exempel att ställa in den på ./jcr:content/metadata/audition.
Lägg till alla metadataparametrar som krävs med dessa steg.
-
-
Klicka på Spara.
Den nya parametern visas nu på sidan Egenskaper för alla DITA-kartor.
Därefter måste du göra anpassade metadata tillgängliga i DITA-kartkonsolen. Gör så här för att göra anpassade metadata tillgängliga på DITA-kartans dashboard:
-
Logga in AEM och öppna läget CRXDE Lite.
-
Gå till filen metadataList som finns på följande plats:
/libs/fmdita/config/metadataList
note note NOTE Filen metadataList innehåller en lista med egenskaper som visas i listrutan Egenskaper för en DITA-karta på kartkontrollpanelen. Som standard visas fyra egenskaper i den här filen: docstate, dc:language, dc:description och dc:title. -
Lägg till anpassade metadata som du har lagt till på Forms-sidan Metadata Schema. Lägg till exempel till målgruppsparameter i slutet av standardlistan.
-
Klicka på Spara alla.
Nu visas anpassade metadata i DITA-kartkonsolens Egenskaper-listruta.
Som utgivare måste du slutligen inkludera anpassade metadata i publicerade utdata. Så här bearbetar du anpassade metadata när du genererar utdata:
-
Navigera till den DITA-karta som du vill publicera i Assets-gränssnittet.
-
Markera DITA-schemafilen och öppna egenskapssidan.
-
Ange värdet för anpassade metadata på sidan Egenskaper. Vi har till exempel angett värdet External som målgruppsparameter.
-
Klicka på Spara och stäng.
-
Klicka på DITA-kartfilen för att öppna DITA-kartkonsolen.
-
Välj den förinställning du vill använda för att generera utdata på fliken Utdatainställningar.
-
Klicka på Redigera.
-
I listrutan Egenskaper väljer du de egenskaper som du vill skicka vidare till publiceringsprocessen.
De valda egenskaperna/metadata skickas vidare till publiceringsprocessen och blir tillgängliga i det slutliga resultatet.
Anpassa DITA-elementmappning med AEM id1679J600HEL
DITA-element i AEM Guides mappas till motsvarande AEM. AEM Guides använder den här mappningen i arbetsflöden som publicering och granskning för att konvertera DITA-element till en motsvarande AEM. Mappningen definieras i filen elementmapping.xml
, som du kommer åt i läget CRXDE Lite. Gå till följande URL i läget CRXDE Lite:
/libs/fmdita/config/elementmapping.xml
libs
. Du måste skapa en övertäckning av noden libs
i noden apps
och endast uppdatera de filer som krävs i noden apps
.Du kan använda de fördefinierade DITA-elementmappningarna eller mappa DITA-element till dina anpassade AEM. Om du vill använda dina anpassade AEM måste du förstå strukturen för filen elementmapping.xml
.
elementmapping.xml-struktur
En översikt på hög nivå av strukturen elementmapping.xml
förklaras nedan:
-
Alla DITA-element söks först efter en motsvarande komponentmappning baserat på elementnamnet. Till exempel:
code language-xml <ditaelement> <name>**substeps**</name> <class>- topic/ol task/substeps</class> <componentpath>dita/components/ditaolist</componentpath> <type>COMPOSITE</type> <target>para</target> </ditaelement>
I ovanstående exempel återges alla
substeps
DITA-element med komponentendita/components/ditaolist
. -
Om ett DITA-element inte hittar någon matchning baserat på namnet görs en matchning utifrån
class
. Till exempel:code language-xml <ditaelement> <name>topic</name> <class>**- topic/topic**</class> <componentpath>fmdita/components/dita/topic</componentpath> <type>COMPOSITE</type> <target>para</target> <attributemap> <attribute from="id" to="id" /> </attributemap> </ditaelement>
Om ingen mappning har definierats för elementet
task
i ovanstående exempel mappas elementettask
till ovanstående komponent eftersomtask
ärvs från komponententopic
. -
När ett element har en motsvarande komponentmappning bestäms vidare bearbetning av dess underordnade element av
type
. Till exempel:code language-xml <ditaelement> <name>title</name> <class>- topic/title</class> <componentpath>foundation/components/title</componentpath> <type>**STANDALONE**</type> <target>para</target> <textprop>jcr:title</textprop> </ditaelement>
type
har följande värden:-
COMPOSITE: Mappningen av element till komponent fortsätter även för underordnade element.
-
STANDALONE: underordnade element för det aktuella elementet har inte mappats ytterligare.
Om elementet
<title>
har några underordnade element mappas de inte till någon annan komponent i ovanstående exempel. Komponenten för elementet<title>
ansvarar för återgivningen av alla underordnade element i elementet<title>
. -
-
Om det finns flera komponenter som är mappade till ett enskilt DITA-element väljs den bästa matchningen för elementet. För att välja den bästa matchningskomponenten övervägs domän- och strukturexSpecialisering för DITA-element.
Om det finns DITA-element med domänspecialisering och en komponent mappas för domänspecialisering får den komponenten hög prioritet.
Om det finns DITA-element med strukturell specialisering och en komponent mappas för strukturell specialisering får den komponenten hög prioritet.
-
Du kan använda
<attributemap>
i elementmappningen för att mappa attributvärden till motsvarande nodegenskaper. -
textprop
kan användas för att serialisera textinnehållet i ett DITA-element till en nodegenskap. Dessutom kan den användas flera gånger i en elementtagg för att serialisera textinnehållet på flera platser i den publicerade hierarkin. Du kan också anpassa platsen och namnet för målegenskapen. Till exempel:code language-xml <ditaelement> <name>title</name> <class>- topic/title</class> <componentpath>foundation/components/title</componentpath> <type>STANDALONE</type> <target>para</target> <textprop>**jcr:title**</textprop> </ditaelement>
Ovanstående elementmappning anger att textinnehållet i elementet
<title>
kommer att sparas som värdet för en egenskap med namnetjcr:title
på utdatanoden. -
xmlprop
kan användas för serialisering av hela XML för ett givet element till en nodegenskap. Komponenten kan sedan läsa den här nodegenskapen och göra anpassad återgivning. Till exempel:code language-xml <ditaelement> <name>svg-container</name> <class>+ topic/foreign svg-d/svg-container</class> <componentpath>fmdita/components/dita/svg</componentpath> <type>STANDALONE</type> <target>para</target> <xmlprop>**data**</xmlprop> </ditaelement>
Ovanstående elementmappning anger att hela XML-koden för elementet
<svg-container>
kommer att sparas som ett värde för egenskapendata
på utdatanoden. -
Det finns en särskild attributmappning som hanterar sökvägsupplösning i utdatagenereringsprocessen. Till exempel:
code language-xml <attributemap> <attribute from="href" to="fileReference" ispath="true" rel="source" /> <attribute from="height" to="height" /> <attribute from="width" to="width" /> </attributemap>
För ovanstående
attributemap
mappas attributethref
i DITA-elementet till en nodegenskap med namnetfileReference
. Eftersomispath
är inställt påtrue
löser utdatagenereringsprocessen den här sökvägen och anger den sedan i nodegenskapenfileReference
.Hur den här upplösningen sker bestäms utifrån värdet för attributet
rel
i attributmappningen.-
Om
rel=source
, löses värdet förhref
med avseende på DITA-källfilen som bearbetas just nu. Värdet förhref
tolkas och placeras i värdet för egenskapenfileReference
. -
Om
rel=target
tolkas värdet förhref
med avseende på rotpubliceringsplatsen. Värdet förhref
tolkas och placeras i värdet för egenskapenfileReference
.
Om du inte vill att någon förbearbetning eller upplösning ska ske för sökvägsattribut behöver du inte ange attributet
ispath
. Värdet kopieras som det är och komponenten kan utföra den önskade upplösningen. -
DITA-elementschema
Följande är ett exempel på DITA-elementschemat i filen elementmapping.xml
:
<ditaelement>
<name>element_name</name>
<class>element_class</class>
<componentpath>fmdita/components/dita/component_name</componentpath>
<type>COMPOSITE|STANDALONE</type>
<attributeprop>propname_a</attributeprop>
<textprop>propname_t</textprop>
<xmlprop>propname_x</xmlprop>
<xpath>xpath expression string</xpath>
<target>head|para</target>
<wrapelement>div</wrapelement>
<wrapclass>class_name</wrapclass>
<attributemap>
<attribute from="attrname" to="propname" ispath="true|false" rel="source|target" />
</attributemap>
<skip>true|false</skip>
</ditaelement>
I följande tabell beskrivs elementen i DITA-elementschemat:
<ditaelement>
<class>
Klassattributet för DITA-ämnet är till exempel:
topic/topic
<componentpath>
<type>
- COMPOSITE: Bearbeta underordnade element samt
- STANDALONE: Hoppar över bearbetning av underordnade element
<attributeprop>
<note type="Caution">
och komponenten som är mappad för det här elementet har <attributeprop>attr_t</ attributeprop>
serialiseras nodens attribut och värde till egenskapen attr_t
för motsvarande AEM nod ( attr_t->type="caution"
).<textprop>propname_t</textprop>
getTextContent()
-utdata till en egenskap som definieras av propname_t.
Obs! Detta är en optimerad egenskap.<xmlprop>propname_x </xmlprop>
propname_x.
Obs! Detta är en optimerad egenskap.<xpath>
<target>
Möjliga värden:
- head: Under huvudnoden
- text: Under styckenoden
<wrapelement>
<wrapclass>
wrapclass.
<attributemap>
<attribute>
-noder.Ytterligare information
-
Om du tänker åsidosätta standardelementmappningen rekommenderar vi att du inte gör ändringarna i standardfilen
elementmapping.xml
. Du bör skapa en ny XML-mappningsfil och placera filen på en annan plats, helst i en anpassad programmapp som du skapar. -
I filen
elementmapping.xml
finns det många mappningsposter som refererar till komponenten fmdita/components/dita/wrapper. Wrapper är en generisk komponent som återger relativt enkla DITA-konstruktioner med hjälp av egenskaper på webbplatsnoden för att generera relevant HTML. Egenskapenwrapelement
används för att generera omslutande taggar och för att delegera den underordnade återgivningen till motsvarande komponenter. Detta är användbart om du bara vill ha en behållarkomponent. I stället för att skapa en ny komponent som återger en viss behållartagg somdiv
ellerp
kan du använda komponenten Wrapper med egenskapernawrapelement
ochwrapclass
för att uppnå samma effekt. -
Du bör inte spara stora mängder text i JCR-egenskaper för strängar. Beräkningen av den optimerade egenskapstypen i utdatagenereringen säkerställer att stort textinnehåll inte sparas som strängtyp. Om innehåll som är större än ett visst tröskelvärde behöver sparas, ändras egenskapstypen till binär. Som standard är det här tröskelvärdet konfigurerat till 512 byte, men du kan ändra det i Configuration Manager (com.adobe.fmdita.config.ConfigManager) genom att ändra inställningen Spara som binärt tröskelvärde .
-
Om du tänker åsidosätta en del (och inte alla) av elementmappningarna behöver du inte replikera hela
elementmapping.xml
-filen. Du måste skapa en ny XML-mappningsfil och definiera endast de element som du åsidosätter. -
När du har skapat XML-filen på den anpassade platsen uppdaterar du inställningen
Override Element Mapping
icom.adobe.fmdita.config.ConfigManager
-paketet.
Anpassa DITA-kartkonsolen id188HC08M0CZ
AEM Guides ger dig flexibiliteten att utöka funktionerna i DITA-kartkonsolen. Om du till exempel har en uppsättning rapporter som skiljer sig från den som är tillgänglig i AEM Guides, kan du lägga till sådana rapporter i kartkonsolen. Om du vill anpassa kartkonsolen måste du skapa ett AEM klientbibliotek (eller ClientLib) som innehåller koden för att utföra de funktioner du behöver.
AEM Guides tillhandahåller kategorin apps.fmdita.dashboard-extn
för att anpassa kartkonsolen. När kartkonsolen läses in körs och läses de funktioner som skapas under kategorin apps.fmdita.dashboard-extn
in.
Hantera bildåtergivning under generering av utdata id177BF0G0VY4
AEM innehåller en uppsättning standardarbetsflöden och mediehandtag för att bearbeta resurser. I AEM finns fördefinierade arbetsflöden för att hantera resursbearbetning för de vanligaste MIME-typerna. För varje bild som du överför skapas vanligtvis flera återgivningar av samma bild i binärt format AEM. Dessa återgivningar kan ha olika storlek, med olika upplösning, med vattenstämpel eller någon annan förändrad egenskap. Mer information om hur AEM hanterar resurser finns i Bearbeta Assets med mediehanterare och arbetsflöden i AEM.
Med AEM Guides kan du konfigurera vilken bildåtergivning som ska användas när utdata genereras för dina dokument. Du kan till exempel välja mellan en av standardbildåtergivningarna eller skapa en och använda samma för att publicera dina dokument. Mappning av bildåtergivning för publicering av dina dokument lagras i filen /libs/fmdita/config/ **renditionmap.xml**
. Ett fragment av filen renditionmap.xml
är följande:
renditionmap.xml
i mappen apps
för alla anpassningar.<renditionmap>
<mapelement>
<mimetype>image/png</mimetype>
<rendition output="AEMSITE">cq5dam.web.1280.1280.jpeg</rendition>
<rendition output="PDF">original</rendition>
<rendition output="HTML5">cq5dam.web.1280.1280.jpeg</rendition>
<rendition output="EPUB">cq5dam.web.1280.1280.jpeg</rendition>
<rendition output="CUSTOM">cq5dam.web.1280.1280.jpeg</rendition>
</mapelement>
...
</renditionmap>
Elementet mimetype
anger filformatets MIME-typ. Elementet rendition output
anger vilken typ av utdataformat och namnet på återgivningen (till exempel cq5dam.web.1280.1280.jpeg
) som ska användas för att publicera den angivna utdatafilen. Du kan ange bildåtergivningarna som ska användas för alla utdataformat som stöds - AEMSITE, PDF, HTML 5, EPUB och ANPASSAD.
Om den angivna återgivningen inte finns söker AEM Guides först efter webbåtergivningen av den angivna bilden. Om inte ens webbåtergivningen hittas används den ursprungliga återgivningen av bilden.
Konfigurera automatisk tömningsperiod för utdathistorik id19AAI070V8Q
När du genererar utdata skapas utdata tillsammans med utdataloggarna. För stora DITA-kartor kan dessa loggar ta mycket plats i din databas. Som standard lagras loggarna på följande plats i databasen:
/var/dxml/metadata/outputHistory/
Under en tidsperiod kan den sammanlagda storleken på alla loggfiler uppgå till GB. I AEM Guides kan du konfigurera en tidsperiod för att behålla dessa loggfiler i databasen. Efter den angivna tidsperioden tas loggarna och historiken för utdatagenerering bort från databasen.
Om du konfigurerar historikrensningsfunktionen påverkas utdatagenereringen för alla DITA-kartor i databasen. På fliken Utdata i en DITA-karta rensas historiken efter det angivna antalet dagar och vid den tidpunkt som anges i inställningen.
Utför följande steg för att ställa in en dag och en tid för att rensa utdatahistorik och -loggar:
-
Öppna konfigurationssidan för Adobe Experience Manager Web Console.
Standardwebbadressen för åtkomst till konfigurationssidan är:
code language-http http://<server name>:<port>/system/console/configMgr
-
Sök efter och klicka på paketet com.adobe.fmdita.config.ConfigManager.
-
I egenskapen Rensningsperiod för utdatahistorik anger du efter hur många dagar som utdatahistoriken och utdataloggarna rensas. Som standard är den inställd på 5 dagar. Om du vill inaktivera den här funktionen anger du egenskapen till 0.
-
I egenskapen Tömningstid för utdatahistorik anger du den tid då rensningsprocessen initieras. Som standard är det 0:00 (eller 12:00 midnatt). Rensningsprocessen körs dagligen vid den här tidpunkten på utdata som genereras före det antal dagar som anges i egenskapen Rensningsperiod för utdatahistorik.
note note NOTE Som standard utförs rensningsfunktionen varje midnatt på utdata som är äldre än 5 dagar. -
Klicka på Spara.
Ändra gränsen för den nyligen genererade utdatalistan id1679JH0H0O2
Du kan ändra det maximala antalet genererade utdata som visas på fliken Utdata för en DITA-karta. Som standard visas en lista med de senaste 25 genererade utdatafilerna. Om du vill ändra antalet utdata som ska visas i listan uppdaterar du inställningen Utdatalistegräns i paketet com.adobe.fmdita.config.ConfigManager
.
Prestandaoptimering för utdatagenerering id176LB050VUI
Med AEM Guides kan du konfigurera poolstorleken för utdatagenereringsprocesser som styr antalet processer för utdatagenerering som körs samtidigt. Som standard är processpoolens storlek inställd på antalet processorkärnor som är tillgängliga i systemet plus ett. Du kan ändra värdet till 1 om du vill ha sekventiell publicering. I det här fallet körs den första publiceringsaktiviteten och nästa publiceringsåtgärd lagras i publiceringskön.
Om du vill ändra storleken på bearbetningspoolen för utdatagenerering uppdaterar du inställningen Genereringspoolstorlek i paketet com.adobe.fmdita.publish.manager.PublishThreadManagerImpl
.