DokumentationAEM GuidesDokumentation om AEM Guides

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

Last update: Fri Jul 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 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

Du kan använda en anpassad DITA-OT-plugin för publicering genom att överföra den anpassade DITA-OT-pluginen till AEM. 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 innehåller 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 MathML-renderingsprogram för Apache FOP eller använder en annan XSL-FO-processor.

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

  1. Hämta filen DITA-OT.zip från länken som delas i välkomstmeddelandet.

  2. Extrahera innehållet i zip-filen på datorn.

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

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

  5. Ö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 din plugin-mapp /var/dxml/dita_resources/dita-ot-mapp. Du kan också göra det med Cloud Manager pipeline. Mer information finns i Distribuera till AEM as a Cloud Service i AEM.

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

  7. 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 inneslutas i ${}.
    Skriv över DITA-OT-utdata Välj om DITA-OT-utdata ska skrivas över. Behåll alternativet markerat.
    AEM DITA-OT Zip-sökväg Ange den fullständiga sökvägen där den anpassade DITA-OT.zip-filen lagras i din AEM.
    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 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:
    <*AEM-Install*>/crx-quickstart/profiles/ditamaps
    Viktigt! Du får inte ändra standardsökvägen.
    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-mappningsinnehållet extraheras i filsystemet.

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

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

    /var/dxml/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å panelen DITA-profiler.

  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.

  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.

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178