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

Så här döljer du fliken Baslinje på DITA-kartkontrollpanelen:

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:

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.

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-plugin-program (DITA-OT) 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-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.

Använd instruktionerna i Konfigurationsåsidosättningar för att skapa konfigurationsfilen. Ange följande (egenskap)-information i konfigurationsfilen för att konfigurera URL-generering i AEM platsutdata:

Konfigurera URL:en för AEM som ska använda dokumenttiteln

Du kan använda dokumenttitlarna i URL:en för AEM platsutdata. Om filnamnet inte finns eller innehåller alla specialtecken kan du konfigurera systemet så att specialtecknen ersätts med en avgränsare i URL:en för AEM. Du kan också konfigurera det så att det ersätter dem med namnet på det första underordnade ämnet.

Så här konfigurerar du sidnamnen:

Om exempelvis @navtitle i <topichead> har alla specialtecken och du anger egenskapen aemsite.pagetitle till true, används som standard en avgränsare. Om du ställer in egenskapen nodename.systemDefinedPageName på true visas det första underordnade ämnets namn.

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

Använd instruktionerna i Konfigurationsåsidosättningar för att skapa konfigurationsfilen. Ange följande (egenskap)-information i konfigurationsfilen för att konfigurera giltiga specialtecken i filnamn och AEM platsutdata:

Du kan också konfigurera andra egenskaper, till exempel använda gemener i filnamn, avgränsare för att hantera ogiltiga tecken och maximalt antal tecken som tillåts i filnamnen. Om du vill konfigurera de här egenskaperna lägger du till följande nyckelvärdepar i konfigurationsfilen:

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.

Sök efter en sträng i innehållet i AEM

Som standard kan du bara söka efter en sträng i titlarna i AEM platsutdata. Du kan konfigurera systemet så att det söker efter en sträng både i titlarna och i innehållet eller i innehållet i AEM.

Om du vill aktivera sökningen bör du konfigurera förenklingen AEM platsnodstrukturen.

VARNING:

Du kan söka efter upp till 1 MB förenklat innehåll. I den föregående skärmbilden kan du till exempel söka efter om innehållet under taggen <p> är <= 1 MB.

Förhindra förenkling AEM platsnodstrukturen

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:

Konfigurera anpassad omskrivare med Experience Manager Guides custom-rewriter

Experience Manager Guides har en anpassad rewriter-modul för hantering av länkar som genereras vid korsmappningar (länkar mellan ämnen på två olika kartor). Denna omskrivarkonfiguration installeras på följande sökväg:
/apps/fmdita/config/rewriter/fmdita-crossmap-link-patcher.

Om du har en annan anpassad återskrivningsskrivare i kodbasen använder du ett 'order'-värde som är större än 50, eftersom Experience Manager Guides återskrivningsprogram använder 'order' 50. Om du vill åsidosätta detta måste du ange ett värde >50. Mer information finns i Skriva om utdata.

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.

Validera metadata som skickas till DITA-OT för bearbetning

För att validera de metadatavärden som skickas till DITA-OT kan man använda en molnklar burk. Eftersom vi inte har åtkomst till det lokala filsystemet i molnet kan vi bara validera metadatafilen via molnklar behållare.

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 kan komma åt med hjälp av pakethanteraren.

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 t.ex. har en uppsättning rapporter som skiljer sig från vad som finns 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.

Använd instruktionerna i Konfigurationsåsidosättningar för att skapa konfigurationsfilen. Ange följande (egenskap)-information i konfigurationsfilen för att ange 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.

Använd instruktionerna i Konfigurationsåsidosättningar för att skapa konfigurationsfilen. Ange följande (egenskap)-information i konfigurationsfilen för att ändra antalet utdata som ska visas i listan: