DokumentationAEM GuidesDokumentation om AEM Guides

Använd anpassad DITA-OT- och DITA-specialisering id181GAJ0005Z

Last update: Thu Sep 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Erfaren
  • Administratör

DITA Open Toolkit (DITA-OT) är en uppsättning Java-baserade verktyg med öppen källkod som hanterar DITA-kartor och ämnesinnehåll. Med AEM Guides kan du enkelt importera och använda anpassade DITA-OT-plugin-program. När AEM Guides har importerats kan det konfigureras att använda den anpassade DITA-OT-pluginen för att generera utdata i vilket format som helst. När du genererar utdata markerar du bara DITA-OT-alternativet och AEM Guides använder det anpassade plugin-programmet DITA-OT för att generera det önskade utdata.

Om du vill bearbeta Ant-parametrar när du publicerar utdata kan du göra det enkelt med AEM Guides. Du kan ange vilka Ant-parametrar som du vill använda och vilka som ska bearbetas i publiceringsprocessen.

NOTE
AEM Guides levereras med DITA-OT version 3.3.2. AEM Guides har dock stöd för DITA-OT version 1.7 och senare. En fullständig lista över DITA-OT-versioner finns i DITA-OT-versioner.
TIP
Se avsnitten Konfigurera DITA-OT-profiler och Använda anpassade DITA-OT i Best practices Guide för bästa praxis vid användning av anpassade DITA-OT-plugin-program.

Använda anpassade DITA-OT-plugin-program id181NH1020L7

Det finns två sätt att använda en anpassad DITA-OT-plugin för publicering. Den första metoden är att överföra det anpassade plugin-programmet DITA-OT till AEM. Den andra metoden är att spara det anpassade DITA-OT-plugin-programmet på servern, skapa en profil och ange platsen för det anpassade DITA-OT-plugin-programmet i din profil.

Som standard har AEM Guides en förkonfigurerad profil som innehåller konfigurationerna för standardmallarna som ska användas för att redigera och publicera innehåll. Du kan skapa anpassade profiler med anpassade mallar som ska användas när du redigerar dokument och anpassade DITA-OT-plugin-program för publicering av innehåll.

Standardpaketet för DITA-OT som är tillgängligt med AEM Guides har en Apache FOP XSL-FO-processor som inte stöder återgivning av MathML-ekvationer. Om du använder MathML-ekvationer i ditt innehåll måste du se till att du har integrerat ett plugin-program för MathML-renderingsmotor för Apache FOP eller använda en annan XSL-FO-processor.

IMPORTANT
Om du har uppgraderat AEM Guides från version 2.2 till 2.5.1 eller 2.6 plockas alla ändringar som görs via konfigurationshanteraren automatiskt och lagras i standardprofilen.

Utför följande steg för att överföra ett anpassat DITA-OT-plugin-program till AEM:

  1. Logga in AEM och öppna läget CRXDE Lite.

  2. Hämta filen DITA-OT.ZIP.

    Platsen för filen DITA-OT.ZIP är /libs/fmdita/dita_resources/DITA-OT.zip.

  3. Extrahera innehållet i zip-filen på servern.

  4. Använd en DITA-OT-plugin för att integrera den nya versionen av DITA-OT med din anpassade DITA-OT-plugin.

    note note
    NOTE
    Klasssökvägsavgränsaren i plugin-programmets ZIP-fil är operativsystemberoende, vilket innebär att om servern finns i Windows är klassökvägsavgränsaren en annan än den som används i Linux. Mer information om hur du integrerar plugin-program manuellt finns i avsnittet Installera plugin-program manuellt i DITA-OT-dokumentationen.

  5. Skapa ZIP-filen igen med samma namn (DITA-OT.ZIP) och mappstrukturen.

  6. Överför den uppdaterade ZIP-filen tillbaka till AEM.

    Kontrollera följande innan du överför ZIP-filen:

    • Kör integratorn (för att installera det anpassade plugin-programmet) i ett Mac/Linux OS för att undvika problem med filavgränsare - eftersom Windows och Linux OS har olika filavgränsare är det inbyggda plugin-programmet i Mac/Linux OS kompatibelt med både Windows- och Linux-installationen.
    • Kontrollera att filen DITA-OT.ZIP innehåller en mapp med namnet DITA-OT som har alla relevanta plugin-program och filer.
    • Kontrollera att filen DITA-OT.ZIP som du skapar är av mimeType: "nt:file" (detta motsvarar den primära typen av ZIP-fil när den överförs till AEM). Använd ett WebDAV-verktyg eller koddistribution för att överföra den här ZIP-filen till önskad sökväg i AEM. (Använd inte AEM pakethanteraren för att distribuera den här ZIP-filen eftersom den inte är ett AEM innehållspaket utan bara en arkivfil.)
    note note
    NOTE
    Vi rekommenderar att du inte skriver över DITA-OT-standardpaketet. Du bör överföra ditt anpassade DITA-OT-paket som innehåller ditt plugin-program till någon annan plats under mappen apps.

  7. Öppna DITA-standardprofilen för redigering och spara den (utan att göra några uppdateringar) för att ändringarna ska börja gälla.

Utför följande steg för att skapa en ny profil och konfigurera den så att den använder ett anpassat DITA-OT-plugin-program som lagras på servern:

  1. Lagra det anpassade plugin-programmet DITA-OT på servern.

    note note
    NOTE
    Mappstrukturen för lagring av det anpassade DITA-OT-plugin-programmet bör vara: \*<parent-folder\>*\DITA-OT.

  2. Klicka på länken Adobe Experience Manager överst och välj Verktyg.

  3. Välj Stödlinjer i listan över verktyg.

  4. Klicka på rutan DITA-profiler.

    note note
    NOTE
    Standardprofilinformationen visas på sidan Profiler. Om du har uppgraderat AEM Guides från version 2.2 till 2.5.1 eller 2.6 plockas alla ändringar som görs via konfigurationshanteraren automatiskt och lagras i standardprofilen.

  5. Du kan välja att redigera standardprofilen, skapa en ny profil eller duplicera inställningar från standardprofilen för att skapa en ny profil.

    note note
    NOTE
    Du kan uppdatera standardprofilen, men du kan inte ta bort den. Alla nya profiler som du skapar kan dock redigeras och tas bort.

  6. Konfigurera följande egenskaper för att använda det anpassade DITA-OT-plugin-programmet:

    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 14-row-2 15-row-2 16-row-2 17-row-2 18-row-2 19-row-2
    Egenskapsnamn Beskrivning
    Profilegenskaper
    Profilnamn Ange ett unikt namn för den här profilen.
    Återanvänd utdata (Valfritt) Om din profil baseras på en befintlig profil väljer du det här alternativet. Om du väljer det här alternativet kan du vara säker på att AEM Guides inte extraherar innehållet i DITA-OT-paketet igen och återanvänder det befintliga DITA-OT-paketet.
    Sökväg för profilextrahering (Valfritt) Ange sökvägen där DITA-OT finns på disken. Som standard paketerar AEM Guides ett DITA-OT-paket i sin databas och det extraheras på disken på den här sökvägen.
    Obs! Du kan definiera den här sökvägen med hjälp av en befintlig systemvariabel eller systemegenskap. Mer information finns i beskrivningen av egenskapen DITA-OT Environment Variables .
    Tilldelad sökväg (Valfritt) Ange sökvägen i innehållsdatabasen som den här profilen gäller för. Du kan ange flera platser.
    DITA-OT-egenskaper
    DITA-OT-timeout (Valfritt) Ange tiden (i sekunder) som AEM Guides väntar på ett svar från plugin-programmet DITA-OT. Om inget svar tas emot under den angivna tiden avbryts publiceringsaktiviteten och aktiviteten flaggas som misslyckad. Felloggarna är också tillgängliga i loggfilen för generering av utdata.
    Standardvärde: 300 sekunder (5 minuter)
    DITA-OT PDF argument Ange kommandoradsargumenten som bearbetas av det anpassade plugin-programmet DITA-OT för att generera utdata från PDF. Ange följande kommandoradsargument för alla anpassade DITA-OT-profiler:-lib plugins/org.dita.pdf2.fop/lib/
    AEM (Valfritt) Ange de anpassade kommandoradsargument som bearbetas av det anpassade plugin-programmet DITA-OT för att generera AEM platsutdata.
    DITA-OT-bibliotekssökvägar (Valfritt) Ange ytterligare bibliotekssökvägar för DITA-OT-plugin-programmet.
    DITA-OT Bygg XML (Valfritt) Ange sökvägen för det anpassade Ant-byggskriptet som paketerats med det anpassade DITA-OT-plugin-programmet. Den här sökvägen är relativ till DITA-OT-katalogen i filsystemet.
    DITA-OT Ant Script-mapp (Valfritt) Ange sökvägen till skriptmappen DITA-OT Ant. Den här sökvägen är relativ till DITA-OT-katalogen i filsystemet.
    DITA-OT-miljövariabler (Valfritt) Ange systemvariabler som ska överföras till DITA-OT-processen. Som standard lägger AEM Guides till fyra variabler - ANT_OPTS, ANT_HOME, PATH och CLASSPATH.
    Du kan återanvända någon av de befintliga systemmiljövariablerna eller egenskaperna för att skapa nya miljövariabler. Om du till exempel har JAVA_HOME systemvariabel definierad i systemet och vill definiera en ny miljövariabel som heter JAVA_BIN som har skapats med JAVA_HOME. Sedan kan du lägga till definitionen för JAVA_BIN som:
    JAVA_BIN= ${JAVA_HOME}/bin
    Obs! Du kan också använda Java-systemegenskaper för att skapa miljövariabler. Om AEM startskript till exempel definierar en Java-systemegenskap java.io.tmpdir för en tillfällig katalog kan du använda den här egenskapen för att definiera den nya variabeln som: ${java.io.tmpdir}/fmdita/dita_ot.
    Viktigt Om du vill återanvända en befintlig systemvariabel eller egenskap måste den omslutas av ${}.
    Skriv över DITA-OT-utdata (Valfritt) Om det här alternativet är markerat kan du ange det DITA-OT-paket som är tillgängligt på det lokala systemet för att generera utdata med DITA-OT. Den här konfigurationen ställs in när ConfigManager aktiveras.
    Om du vill ange sökvägen till ett DITA-OT-paket som lagras på AEM server avmarkerar du det här alternativet.
    AEM DITA-OT Zip Path/ Local DITA-OT Directory Path Beroende på vad du har valt i Skriv över DITA-OT-utdata anger du den fullständiga sökvägen där den anpassade DITA-OT.zip-filen lagras. Detta kan vara sökvägen i AEM eller det lokala systemet.
    DITA-OT-plug-in-sökväg Sökväg för det anpassade plugin-programmet. Denna plugin integreras automatiskt med DITA-OT-huvudpaketet.
    Integrera kataloger (Valfri) Sökväg till de anpassade DTD- och XSD-katalogfilerna.xml i AEM. Detta bör endast anges när katalogerna saknas i DITA-OT-paketet. Katalogerna integreras automatiskt med huvudversionen av DITA-OT som ett plugin-program.
    Lägg till katalog för system-ID (Valfritt) Välj det här alternativet endast om det saknas offentliga ID-poster i katalogen eller om DITA-filerna bara använder system-ID:n som är relativa till serversökvägen som de överförs från.
    Tillfällig DITA-OT-sökväg (Valfritt) Ange en tillfällig plats där DITA-filer kopieras för bearbetning. Innan DITA-OT bearbetar filer kopieras de på den här tillfälliga platsen. Som standard är den tillfälliga lagringsplatsen:
    Obs! Du kan definiera den här sökvägen med hjälp av en befintlig systemvariabel eller systemegenskap. Mer information finns i beskrivningen av egenskapen DITA-OT Environment Variables .
    note note
    NOTE
    AEM Guides installationsprogram skapar två miljövariabler som du kan använda för att ange sökvägen till de anpassade DITA-OT-plugin-filerna. Dessa miljövariabler är: DITAOT_DIR, som innehåller sökvägen till DITA-OT-katalogen i filsystemet, och DITAMAP_DIR, som innehåller sökvägen där DITA-kartinnehållet extraheras i filsystemet.

  7. Klicka på Klar för att spara profilen.

NOTE
Du kan exportera den anpassade DITA-profilen som ett paket och överföra den till andra AEM Guides-instanser för att spara tid. Mer information finns i Bilaga.

Integrera DITA-specialisering id211MB0E00XA

DITA-specialisering är processen att skapa nya DITA-strukturer genom att lägga till nya element eller ta bort befintliga element. Om du vill skapa ett nytt DITA-element kan du ta ett befintligt DITA-element som bas och ändra det enligt dina redigeringskrav. Med DITA-specialisering kan ni skapa anpassade informationsmodeller som uppfyller era verksamhetskrav samtidigt som ni behåller fördelarna med den befintliga DITA-arkitekturen.

Du kan använda profilfunktionen för att lagra anpassade DITA-specialiseringsinställningar. Dessa inställningar kan sedan användas när du redigerar och publicerar anpassat DITA-innehåll. Med AEM Guides kan du använda publikt ID och system-ID i dina anpassade DTD-/XSD-filer.

NOTE
AEM Guides Web Editor har inte stöd för XSD.

Så här skapar du en ny profil och konfigurerar den så att den använder specialiserade DTD:er och XSD:er AEM Guides:

  1. Skapa en specialmapp på din lokala dator som innehåller specialiserade DTD- och XSD-filer.

  2. Ange DTD-informationen i filen catalog.xml som också måste inkluderas i specialmappen.

    note note
    NOTE
    När det gäller DITA 1.3 är standardplatsen för DTD catalog.xml-filen i AEM: /libs/fmdita/dita_resources/DITA-1.3/dtd/catalog.xml.

  3. Ange XSD-informationen i filen catalog.xml som också måste inkluderas i specialmappen.

    note note
    NOTE
    För DITA 1.3 är standardplatsen för XSD-filen catalog.xml i AEM: /libs/fmdita/dita_resources/DITA-1.3/xsd/catalog.xml.

  4. Överför mappen till följande plats:

    /apps/fmdita/dita_resources

  5. Klicka på länken Adobe Experience Manager överst och välj Verktyg.

  6. Välj Stödlinjer i listan över verktyg.

  7. Klicka på rutan DITA-profiler.

    note note
    NOTE
    Standardprofilinformationen visas på sidan Profiler. Om du har uppgraderat AEM Guides från version 2.2 till 2.5.1 eller 2.6 plockas alla ändringar som görs via konfigurationshanteraren automatiskt och lagras i standardprofilen.

  8. Du kan välja att redigera standardprofilen, skapa en ny profil eller duplicera inställningar från standardprofilen för att skapa en ny profil.

    note note
    NOTE
    Du kan inte ta bort standardprofilen. Alla nya profiler som du skapar kan dock redigeras och tas bort.

  9. Ange sökvägen till anpassade DTD- och XSD catalog.xml -filer i AEM Schema > Katalog -inställningarna.

    note note
    NOTE
    Om du använder det anpassade schemat måste du definiera sökvägen för de anpassade DTD- och XSD-filerna catalog.xml i AEM i alternativet Integrera kataloger.

  10. Välj alternativet Lägg till system-ID-katalog.

    note note
    NOTE
    Välj bara det här alternativet om det saknas offentliga ID-poster i katalogen eller om DITA-filerna bara använder de system-ID som är relativa till den lokala filsökvägen som de överförs från.

    Mer information om andra egenskaper på profilsidan finns i egenskapstabellen i Steg 6 i avsnittet Använd anpassade DITA-OT-plugin-program.

  11. Klicka på Klar för att spara profilen.

NOTE
Du kan exportera den anpassade DITA-profilen som ett paket och överföra den till andra AEM Guides-instanser för att spara tid. Mer information finns i Appendix.md.
recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178