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:

Konfigurera FrameMaker Publishing Server id1678G0Z0TN6

Du kan använda FrameMaker Publishing Server (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.

Konfigurera blandad publicering på en befintlig AEM-webbplats id1691I0V0MGR

Om du har en AEM-webbplats som innehåller DITA-innehåll kan du konfigurera dina AEM Site-utdata så att DITA-innehåll publiceras på en fördefinierad plats på webbplatsen. I följande skärmbild på en AEM Site-sida är noden ditacontent reserverad för lagring av DITA-innehåll:

{width="300"}

De återstående noderna på sidan redigeras direkt i AEM Site Editor. 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:

Utför följande steg för att konfigurera den befintliga platsens mallegenskaper:

På följande skärmbild visas de egenskaper som lagts till i standardmallnoden i AEM Guides:

{width="800"}

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:

Anpassa utdata för AEM Site id166TG0B30WR

AEM Guides har stöd för att skapa utdatafiler i följande format:

För utdata från AEM Site 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 PDF-utdata på ett specifikt 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 utdata från AEM Site. 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 utdata från AEM Site 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.

Gör så här för att ange en egen designmall som ska användas för att generera utdata för AEM Site:

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 utdata från AEM webbplats

När du genererar utdata för AEM Site spelar det sätt på vilket URL:er genereras en viktig roll för att ditt innehåll ska kunna upptäckas. 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 utdata från AEM Site. AEM Guides ger dig en konfiguration genom vilken du kan välja att generera URL:er för AEM Site-utdata med hjälp av filens titel 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 från AEM Site 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 utdata för AEM Site spelar det sätt på vilket URL:er genereras en viktig roll för att ditt innehåll ska kunna upptäckas. Om filsystemet inte är UUID genereras utdata från AEM Site med filnamnen och inte filens namn. Som administratör eller utgivare kan du styra hur du vill generera URL:er för utdata från AEM Site. AEM Guides ger dig en konfiguration genom vilken du kan välja att generera URL:er för AEM Site-utdata med hjälp av filens titel i stället för filnamnen. Som standard är det här alternativet inaktiverat. Detta innebar att när du genererade utdata för AEM Site 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 i utdata för AEM Site:

Konfigurera renderingsregler för filnamn för att skapa ämnen och publicera utdata för AEM Site 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 utdata från en AEM-plats. I tidigare versioner tilläts användare att definiera filnamn som innehåller specialtecken som @, $, > med flera. Specialtecknen resulterade i kodad URL för generering av AEM Site-sidor.

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 Site-utdata:

Konfigurera förenkling av nodstrukturen för AEM Site

När du genererar utdata för AEM Site 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. Följande bild visar djupt kapslad nodstruktur för utdata från AEM Site:

{width="300"}

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 för AEM Site-utdata ska 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:

{width="300"}

Så här förenklar du nodstrukturen i AEM Site:

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.

{width="650"}

Förhindra förenkling av anteckningsstrukturen för AEM Site Notes

På samma sätt som du anger vilken nod som ska förenklas i utdata för AEM Site, 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 i AEM Site-utdata

När du genererar utdata för AEM-webbplatsen 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:

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:

Så här lägger du till de metadata som krävs i systemet:

Den nya parametern visas nu på sidan Egenskaper för alla DITA-kartor.

{width="650"}

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:

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:

De valda egenskaperna/metadata skickas vidare till publiceringsprocessen och blir tillgängliga i det slutliga resultatet.

Anpassa DITA-elementmappning med AEM-komponenter id1679J600HEL

DITA-element i AEM Guides mappas till motsvarande AEM-komponenter. 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-komponent. Mappningen definieras i filen elementmapping.xml, som du kommer åt i CRXDE Lite-läge. Öppna följande URL i CRXDE Lite-läge:

/libs/fmdita/config/elementmapping.xml

Du kan använda de fördefinierade DITA-elementmappningarna eller mappa DITA-element till dina anpassade AEM-komponenter. Om du vill använda dina anpassade AEM-komponenter 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:

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:

Ytterligare information

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 kunna 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 det fördefinierade arbetsflöden för att hantera resurshantering 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 i 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 dokumentationen för 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>
   <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, HTML5, EPUB och CUSTOM.

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:

Ä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.