AEM Sites-förinställningar på kartkontrollpanelen id205BE3008SW
Du kan skapa förinställningar för AEM Sites från kartkontrollpanelen och konfigurera dem för att generera AEM Sites-utdata.
Följande alternativ är tillgängliga för AEM Sites-utdata:
En nod i AEM skapas med det namn som anges här. Om du inte anger platsnamnet skapas platsnoden med DITA-mappningsfilens namn.
Webbplatsnamnet som du anger här används också som rubrik på fliken Webbläsare.
Du kan också använda variabler när du anger platsnamn. Mer information om hur du använder variabler finns i Använd variabler för att ange alternativen Målsökväg, Platsnamn eller Filnamn.
Kontakta publiceringsadministratören om du vill ha mer information om hur du använder anpassade designmallar för att generera utdata.
user-guide och målsökvägen som /content/output/aem-guides, genereras slutresultatet under noden /content/output/aem-guides/user-guide.Du kan också använda variabler när du anger målsökvägen. Mer information om hur du använder variabler finns i Använd variabler för att ange alternativen Målsökväg, Platsnamn eller Filnamn.
Inget använt: Välj det här alternativet om du inte vill använda något villkor på publicerade utdata.
DITAVal-fil: Välj DITAVal-filer om du vill generera villkorat innehåll. Du kan markera flera DITAVal-filer i dialogrutan Bläddra eller genom att skriva filsökvägen. Använd kryssikonen bredvid filnamnet för att ta bort den. DITAVal-filer utvärderas i den ordning som anges, så de villkor som anges i den första filen har företräde framför de matchande villkor som anges i senare filer. Du kan behålla filordningen genom att lägga till eller ta bort filer. Om DITAVal-filen flyttas till en annan plats eller tas bort, tas den inte automatiskt bort från kartkontrollpanelen. Du måste uppdatera platsen om filerna flyttas eller tas bort. Du kan hovra över filnamnet för att se sökvägen i AEM databas där filen lagras. Du kan bara välja DITAVal-filer och ett fel visas om du väljer någon annan filtyp.
Villkorsförinställning: Välj en villkorsförinställning i listrutan om du vill använda ett villkor när du publicerar utdata. Det här alternativet är synligt om du har lagt till ett villkor för DITA-kartfilen. De villkorliga inställningarna finns på fliken Villkorsförinställningar i DITA-kartkonsolen. Mer information om villkorsförinställningar finns i Använda villkorsförinställningar.
Markera alternativet Ta bort och skapa om du vill framtvinga borttagning av befintliga sidor under publiceringen. Med det här alternativet tas sidnoden bort tillsammans med innehållet och alla underordnade sidor under den. Använd det här alternativet om du har ändrat designmallen för förinställningen för utdata eller om du vill att eventuella extra sidor som redan finns i målet ska tas bort.
Säg att du har publicerat en DITA-karta som innehåller avsnitten a.dita, b.dita och c.dita. Innan du publicerade kartan igen tog du bort b.dita-ämnet från kartan. Om du har valt det här alternativet tas nu allt innehåll som är relaterat till b.dita bort från AEM Sites-utdata och bara a.dita och c.dita publiceras.
Den här funktionen tar inte bort någon publicerad underordnad karta. Om den överordnade kartan till exempel innehåller en underordnad karta och du tar bort hela den underordnade kartan tas inte innehållet bort från den publicerade utdata. Om du däremot tar bort ett ämne från en underordnad karta och publicerar om, tas innehållet i det borttagna ämnet bort från webbplatsens utdata.
Om det finns något refererat innehåll, och det innehållet tas bort innan det publiceras igen, tas det refererade innehållets data inte bort.
Obs!: Information om borttagna överblivna sidor hämtas också i loggarna för utdatagenerering. Mer information om åtkomst till loggfilerna finns i Visa och kontrollera loggfilen.
När du har skapat utdata väljer du ikonen Hämta temporära filer
Obs! Om filegenskaper läggs till under genereringen innehåller de tillfälliga utdatafilerna även en metadata.xml-fil som innehåller dessa egenskaper.
I fältet Delad PDF-sökväg anger du sökvägen för att lagra PDF som genereras för varje ämne.
Obs! AEM Guides använder DITA-OT-plugin-programmet pdfx för att generera PDF för varje ämne. Denna plugin medföljer DITA-OT-paketet som levereras i kartong. Du kan anpassa det här plugin-programmet för att skapa PDF efter dina behov. Om du använder en anpassad DITA-OT-plugin måste du integrera pdfx-pluginen för att kunna skapa PDF på ämnesnivå.
Viktigt: När du genererar inkrementella utdata för den AEM platsen skapas utdata med den aktuella versionen av filerna och inte med den kopplade baslinjen.
Mer information finns i Arbeta med baslinje.
Obs! Metadataegenskaperna är skiftlägeskänsliga.
Om du har valt en baslinje baseras värdena för egenskaperna på versionen av den valda baslinjen. Om du inte har valt en baslinje baseras värdena för egenskaperna på den senaste versionen.
Du kan också skicka metadata till utdata med DITA-OT-publicering. Mer information finns i Skicka metadata till utdata med DITA-OT.
Obs!: Om du inte har definierat
cq:tags i alternativet Egenskaper hämtas värdena för cq:tags från den aktuella arbetskopian, även om du har valt en baslinje för publicering.Endast egenskaperna String, Date eller Long (en och flera värden) kan skickas till AEM Sites-sidorna. Metadatavärdena för en String-typegenskap stöder inte några specialtecken (till exempel
@, #, " ").* Det här alternativet bör användas tillsammans med alternativet
Properties.Ytterligare information om AEM Sites
Generera artikelbaserade utdata från Web Editor
Du kan generera AEM Sites-utdata för ett eller flera ämnen, eller hela DITA-kartan från Web Editor. Du måste skapa förinställningar för DITA-kartan och sedan enkelt skapa AEM Sites-utdata för kartan. Om du har uppdaterat några avsnitt på kartan kan du även generera AEM Sites-utdata endast för dessa ämnen från Web Editor. Mer information finns i Artikelbaserad publicering från webbredigeraren.
Generera utdata för att länka ämnen från andra kartor
Det är ett mycket vanligt scenario att ha en stor uppsättning dokumentation spridda över flera mappar och DITA-kartor. Det blir extremt komplext att publicera innehåll som är länkat från olika platser. Som standard skapas alla länkar <xref> med local @scope. Publicering av sådana ämnen innebär inga utmaningar eftersom den använder direktlänk till ämnet. Om ämnet ligger utanför den aktuella DITA-kartan visas inte det länkade innehållet i länken.
Ett annat sätt att länka innehåll är att skapa en länk med peer @scope. För sådant innehåll löses länken vid körning genom att filens namn och det konfigurerade sammanhanget för det länkade ämnet väljs från DITA-kartans publiceringskontext. På följande skärmbild visas egenskapspanelen för en länk med peer @scope:
För att förenkla publiceringen av komplexa kartor och ämnen som länkar till andra ämnen i andra kartor kan du med AEM Guides ange publiceringskontext för varje utdatapresentation.
I publiceringssammanhanget kan du ange vilket ämne som ska användas för att publicera ett visst utdataavsnitt. Låt oss förstå detta med hjälp av ett exempel - låt oss säga att du har fyra mappar: exempel a, exempel b, exempel c och exempel d. Varje mapp innehåller en DITA-karta - DITA-karta A, DITA-karta B, DITA-karta C och DITA-karta D. Koppling mellan kartor sker när ett ämne i DITA-karta A länkar till ett ämne på DITA-kartan B, C eller D. I skärmbilden nedan innehåller exempelavsnittet länkar (eller referenser) till filer som ingår i andra DITA-kartor.
När du nu konfigurerar AEM Sites publiceringsinställningar för kartfilen som innehåller det här avsnittet kan du välja vilken publiceringskontext för det länkade innehållet som ska användas vid publiceringen. En publiceringskontext är en kombination av DITA-kartan och dess förinställning för utdata. Utdataförinställningen innehåller i sin tur en specifik version av innehållet och villkorliga förinställningar. Hela den här kombinationen av DITA-kartan, förinställningen för utdata, versionen (filer) och villkoren definierar publiceringskontexten för en länkad karta.
Gör så här för att ange publiceringskontext för korslänkade filer:
-
Öppna fliken Utdatainställningar i den DITA-karta som du vill publicera.
-
Välj AEM-utdatainställningen.
Du kan hämta AEM förinställningar och Publish-kontextflikar.
-
Öppna fliken Publish Context.
Du visas en lista med beroende ämnen. Det här är ämnen som är länkade från något ämne i den aktuella kartan, men de är tillgängliga i vissa andra DITA-kartor.
note note NOTE På fliken Publish Context visas ämnen som bara är länkade med peer@scope. För länkar medlocal@scopebehöver du inte ange publiceringskontext.Som standard är alla länkade ämnen markerade med sin senaste förinställning och karta för utdata.
-
Klicka på Redigera (i huvudverktygsfältet) om du vill ändra standardvalet för DITA-karta och förinställning.
-
Om du vill använda de senast publicerade utdata för varje beroende fil på kartan väljer du Använd den senast genererade publiceringskontexten för alla beroende ämnen.
-
I listrutan Överordnad karta markerar du den kartfil vars utdata du vill länka den aktuella kartans utdata.
När du väljer en kartfil visas kartans UUID i kolumnen Överordnad karta. De förinställningar för utdata som är associerade med den valda kartan visas i listan Förinställningar för överordnad karta.
-
I listrutan Förinställning för överordnad karta väljer du den förinställning som du vill länka den aktuella kartans utdata med.
-
Välj önskad karta och dess förinställning för alla beroende ämnen och klicka på Klar.
Kontexten för de beroende ämnena ställs nu in. Du kan generera utdata för den aktuella kartan. Mer information om hur du genererar utdata finns i Generera utdata för en DITA-karta från kartkonsolen.
Blandad publicering
AEM Guides har stöd för publicering av DITA-innehåll på din befintliga AEM. Om du till exempel har en befintlig webbplats kan du använda AEM Sites-utdata för att publicera endast DITA-innehållet på den webbplatsen. I den här processen ändras inte det befintliga icke-DITA-innehållet i publiceringsprocessen. Kontakta din publiceringsadministratör om du vill ha mer information om hur du konfigurerar webbplatsen så att endast DITA-innehåll publiceras.
Publicerar conref
Om du använder conref i ditt innehåll publiceras det som normalt eller inbäddat innehåll tillsammans med innehållet i källämnet (eller refererande). conref-innehållet återges tillsammans med huvudinnehållet och ingen separat webbplatssida skapas för det. När du söker efter innehållet som refereras i conref visas endast huvudavsnittet eller huvudsidan med conref -innehållet i sökresultaten.
conref-innehållet med AEM Guides version 3.5 eller tidigare rekommenderar vi att du rensar/tar bort dessa sidor med alternativet Ta bort enstaka webbplatssidor.Söka efter en sträng i innehållet
Du kan söka efter en sträng i AEM Sites-utdata. Som standard kan du bara söka efter strängen i rubrikerna. Om du vill söka efter strängen i AEM Sites-utdatafilens innehåll eller innehåll kontaktar du systemadministratören för att aktivera egenskapen flattening.enabled.
Mer information finns i avsnittet Konfigurera förenkling AEM platsnodstrukturen i guiden Installera och konfigurera Adobe Experience Manager Guides.
Överordnat ämne: Förstå förinställningarna för utdata