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

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:

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:

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 AEM webbplatsutdata id166TG0B30WR

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

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:

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:

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:

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:

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:

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.

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

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:

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

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