DocumentatieAEM GuidesDocumentatie voor AEM Guides

Aangepaste DITA-OT en DITA-specialisatie gebruiken id181GAJ0005Z

Last update: Fri Jan 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Experienced
  • Admin

De Open Toolkit DITA (DITA-OT ) is een reeks op Java-Gebaseerde, open-bronhulpmiddelen die verwerking voor kaarten DITA en onderwerpinhoud verstrekken. Met AEM hulplijnen kunt u eenvoudig aangepaste DITA-OT-plug-ins importeren en gebruiken. Na het importeren kunnen AEM hulplijnen zo worden geconfigureerd dat de aangepaste DITA-OT-plug-in wordt gebruikt om uitvoer in elke gewenste indeling te genereren. Op het moment dat de uitvoer wordt gegenereerd, selecteert u gewoon de optie DITA-OT en gebruikt de AEM de aangepaste DITA-OT-plug-in om de vereiste uitvoer te genereren.

Als u Ant-parameters wilt verwerken terwijl u uitvoer publiceert, biedt AEM hulplijnen u een eenvoudige manier om dit te doen. U kunt opgeven welke Ant-parameters u wilt gebruiken en dezelfde parameters vervolgens door het publicatieproces worden verwerkt.

NOTE
AEM hulplijnen worden geleverd met DITA-OT versie 3.3.2. AEM hulplijnen bieden echter ondersteuning voor DITA-OT versie 1.7 en hoger. Voor de volledige lijst van DITA-OT versies, zie DITA-OT-versies.
TIP
Zie de Configuratie DITA-OT-profielen en Aangepaste DITA-OT gebruiken in de handleiding met aanbevolen procedures vindt u de beste werkwijzen voor het gebruik van aangepaste DITA-OT-plug-ins.

Aangepaste DITA-OT-plug-ins gebruiken id181NH1020L7

U kunt aangepaste DITA-OT-plug-in gebruiken voor publicatie door de aangepaste DITA-OT-plug-in te uploaden naar de AEM opslagplaats. Standaard wordt bij AEM hulplijnen een vooraf geconfigureerd profiel geleverd met de configuraties van de standaardsjablonen die kunnen worden gebruikt voor het bewerken en publiceren van inhoud. U kunt aangepaste profielen maken met aangepaste sjablonen die u kunt gebruiken tijdens het bewerken van documenten en aangepaste DITA-OT-plug-ins voor het publiceren van inhoud.

Het standaard DITA-OT-pakket dat beschikbaar is bij AEM hulplijnen wordt geleverd met Apache FOP XSL-FO-processor, die geen ondersteuning biedt voor het renderen van MathML-vergelijkingen. Als u MathML vergelijkingen in uw inhoud gebruikt, dan zorg ervoor dat u een MathML het teruggeven motorstop - binnen voor Apache FOP of gebruik een verschillende bewerker XSL-FO hebt geïntegreerd.

Voer de volgende stappen uit om aangepaste DITA-OT-plug-in te uploaden naar de AEM opslagplaats:

  1. Download het bestand DITA-OT.zip via de koppeling die wordt gedeeld in de welkomstmail.

  2. Extraheer de inhoud van het ZIP-bestand op uw systeem.

  3. Gebruik een integratormechanisme voor DITA-OT-plug-ins om de nieuwe versie van DITA-OT te integreren met uw aangepaste DITA-OT-plug-in.

  4. Maak het ZIP-bestand opnieuw met dezelfde naam (DITA-OT.ZIP) en de mapstructuur.

  5. Upload het bijgewerkte ZIP-bestand weer naar de AEM-opslagplaats.

    Controleer het volgende voordat u het ZIP-bestand uploadt:

    • Voer de integrator (om de aangepaste insteekmodule te installeren) uit op een Mac/Linux-besturingssysteem om problemen met bestandsscheidingstekens te voorkomen - aangezien Windows en Linux-besturingssystemen verschillende bestandscheiders hebben, is de insteekmodule die is geïntegreerd in Mac/Linux OS compatibel met zowel Windows- als Linux-instellingen.
    • Zorg ervoor dat de DITA-OT.ZIP Het bestand bevat een map met de naam "DITA-OT" die alle relevante plug-ins en bestanden bevat.
    • Controleren of DITA-OT.ZIP Het bestand dat u maakt, is van het type mimeType: "nt:file" (dit komt overeen met het primaire type ZIP-bestand bij het uploaden naar AEM). Gebruik een WebDAV-tool of code-implementatie om dit ZIP-bestand te uploaden naar het gewenste pad in AEM. (Gebruik AEM pakketbeheer niet om dit ZIP-bestand te implementeren, omdat dit ZIP-bestand geen pakket met AEM inhoud is, maar slechts een archiefbestand.)
    note note
    NOTE
    Het wordt aanbevolen het standaard DITA-OT-pakket niet te overschrijven. U moet het aangepaste DITA-OT-pakket uploaden dat de map Plug-in /var/dxml/dita_resources/dita-ot bevat. U kunt dit ook doen via de pijplijn Cloud Manager. Ga naar Distribueren naar AEM as a Cloud Service in AEM documentatie voor meer informatie.

  6. U kunt het standaardprofiel bewerken, een nieuw profiel maken of instellingen in het standaardprofiel dupliceren om een nieuw profiel te maken.

    note note
    NOTE
    U kunt het standaardprofiel bijwerken, maar u kunt het niet verwijderen. Alle nieuwe profielen die u maakt, kunnen echter worden bewerkt en verwijderd.

  7. Configureer de volgende eigenschappen voor het gebruik van de aangepaste DITA-OT-plug-in:

    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
    Eigenschapnaam Beschrijving
    Profieleigenschappen
    Profielnaam Geef dit profiel een unieke naam.
    Uitvoer opnieuw gebruiken (Optioneel) Als uw profiel is gebaseerd op een bestaand profiel, selecteert u deze optie. Als u deze optie selecteert, zorgt u ervoor dat AEM hulplijnen de inhoud van het DITA-OT-pakket niet opnieuw extraheert en het bestaande DITA-OT-pakket opnieuw gebruikt.
    Pad voor exporteren van profiel (Optioneel) Geef het pad op waar DITA-OT op de schijf wordt gehouden. Standaard bundelt AEM hulplijnen een DITA-OT-pakket in de opslagplaats en wordt het op de schijf opgehaald bij dit pad.
    OPMERKING U kunt dit pad definiëren met een bestaande systeemvariabele of -eigenschap. Zie de beschrijving van DITA-OT-omgevingsvariabelen eigenschap voor meer informatie.
    Toegewezen pad (Optioneel) Geef het pad op in de opslagplaats voor inhoud waarvoor dit profiel van toepassing is. U kunt meerdere locaties opgeven.
    DITA-OT-eigenschappen
    Tijdslimiet DITA-OT (Optioneel) Geef de tijd op (in seconden) waarop de AEM hulplijnen wachten op een reactie van de DITA-OT-plug-in. Als er geen reactie is ontvangen binnen de opgegeven tijd, wordt de publicatietaak beëindigd door AEM hulplijnen en wordt de taak gemarkeerd als mislukt. Ook, worden de mislukkingslogboeken ter beschikking gesteld in het dossier van het outputgeneratie.
    Standaardwaarde: 300 seconden (5 minuten)
    DITA-OT PDF-argumenten Geef de opdrachtregelargumenten op die door de aangepaste DITA-OT-plug-in worden verwerkt voor het genereren van de PDF-uitvoer. Geef voor alle aangepaste DITA-OT-profielen het volgende opdrachtregelargument op:-lib plugins/org.dita.pdf2.fop/lib/
    DITA-OT AEM Argumenten (Optioneel) Geef de aangepaste opdrachtregelargumenten op die door de aangepaste DITA-OT-plug-in worden verwerkt voor het genereren van de uitvoer van de AEM Site.
    DITA-OT bibliotheekpaden (Optioneel) Geef de extra bibliotheekpaden van de DITA-OT-plug-in op.
    DITA-OT XML samenstellen (Optioneel) Geef het pad op van het aangepaste Ant-constructiescript dat is gebundeld met de aangepaste DITA-OT-plug-in. Dit pad is relatief ten opzichte van de map DITA-OT op uw bestandssysteem.
    DITA-OT map Ant Script (Optioneel) Geef het pad op van de map DITA-OT Ant-script. Dit pad is relatief ten opzichte van de map DITA-OT op uw bestandssysteem.
    DITA-OT-omgevingsvariabelen (Optioneel) Omgevingsvariabelen opgeven die aan het DITA-OT-proces moeten worden doorgegeven. Standaard voegt de AEM hulplijnen vier variabelen toe: ANT_OPTS, ANT_HOME, PATH, en CLASSPATH.
    U kunt alle bestaande systeemomgevingsvariabelen of -eigenschappen opnieuw gebruiken om nieuwe omgevingsvariabelen samen te stellen. Als u bijvoorbeeld JAVA_HOME systeemvariabele gedefinieerd in uw systeem en u wilt een nieuwe omgevingsvariabele definiëren met de naam JAVA_BIN dat is gemaakt met JAVA_HOME. Vervolgens kunt u de definitie van JAVA_BIN als:JAVA_BIN= ${JAVA_HOME}/bin
    Opmerking: U kunt ook eigenschappen van het Java-systeem gebruiken om omgevingsvariabelen te maken. Als AEM beginscript bijvoorbeeld een Java-systeemeigenschap definieert java.io.tmpdir aan een tijdelijke folder, kunt u dit bezit gebruiken om nieuwe variabele als te bepalen: ${java.io.tmpdir}/fmdita/dita_ot.
    Belangrijk: Als u een bestaande systeemvariabele of -eigenschap opnieuw wilt gebruiken, moet deze binnen ${}.
    DITA-OT-uitvoer overschrijven Geef op of de DITA-OT-uitvoer moet worden overschreven. Laat deze optie ingeschakeld.
    AEM ZIP-pad DITA-OT Geef het volledige pad op waar het aangepaste DITA-OT.zip-bestand wordt opgeslagen in de AEM opslagplaats.
    DITA-OT plug-inpad Pad van de aangepaste plug-in. Deze plug-in wordt automatisch geïntegreerd met het hoofdpakket DITA-OT.
    Catalogi integreren (Optioneel) Pad van de aangepaste DTD- en XSD catalog.xml-bestanden in de AEM-opslagplaats. Dit moet alleen worden opgegeven wanneer de catalogi ontbreken in het DITA-OT-pakket. Deze catalogi worden automatisch als een plug-in geïntegreerd met de hoofdmap DITA-OT.
    Catalogus systeem-id toevoegen (Optioneel) Selecteer deze optie alleen als er openbare-id-items ontbreken in de catalogus of als de DITA-bestanden alleen de systeem-id's gebruiken die relatief zijn ten opzichte van het serverpad vanwaar ze worden geüpload.
    DITA-OT tijdelijk pad Een tijdelijke locatie waar DITA-bestanden worden gekopieerd voor verwerking. Voordat DITA-OT bestanden verwerkt, worden ze naar deze tijdelijke locatie gekopieerd. Standaard is de locatie voor tijdelijke opslag:
    <*AEM-Install*>/crx-quickstart/profiles/ditamaps
    Belangrijk: U mag het standaardpad niet wijzigen.
    note note
    NOTE
    Het installatieprogramma voor AEM hulplijnen maakt twee omgevingsvariabelen waarmee u het pad van de aangepaste DITA-OT-plug-inbestanden kunt opgeven. Deze omgevingsvariabelen zijn: DITAOT\_DIR, die het pad bevat van de map DITA-OT op het bestandssysteem, en DITAMAP\_DIR, die het pad bevat waar de DITA-kaartinhoud wordt geëxtraheerd naar het bestandssysteem.

  8. Klikken Gereed om het profiel op te slaan.

DITA-specialisatie integreren id211MB0E00XA

De specialisatie DITA is het proces om nieuwe structuren te creëren DITA door nieuwe elementen toe te voegen of bestaande elementen te verwijderen. Om een nieuw element te creëren DITA, kunt u een bestaand element DITA als basis nemen en het wijzigen volgens uw auteursvereisten. In wezen, staat de specialisatie DITA u toe om aangepaste informatiemodellen tot stand te brengen die aan uw bedrijfsvereisten voldoen terwijl het behouden van de voordelen van de bestaande architectuur DITA.

Met de functie Profiel kunt u aangepaste DITA-specialisatie-instellingen opslaan. Deze instellingen kunnen vervolgens worden gebruikt bij het ontwerpen en publiceren van aangepaste DITA-inhoud. AEM de Gidsen staat u toe om Openbare identiteitskaart en identiteitskaart van het Systeem in uw douane DTDs/XSDs te gebruiken.

NOTE
AEM de Redacteur van het Web van Gidsen heeft geen steun voor XSDs.

Voer de volgende stappen uit om een nieuw profiel te creëren en het te vormen om gespecialiseerde DTDs en XSDs in uw Gidsen van de AEM te gebruiken:

  1. Maak op uw lokale computer een specialisatiemap met de gespecialiseerde DTD's en XSD's.

  2. Geef de DTD-details op in het dialoogvenster catalog.xml bestand dat ook in de specialisatiemap moet worden opgenomen.

    note note
    NOTE
    In het geval van DITA 1.3, de standaardplaats voor DTD catalog.xml bestand in de AEM opslagplaats is: /libs/fmdita/dita_resources/DITA-1.3/dtd/catalog.xml.

  3. Geef de XSD-details op in het dialoogvenster catalog.xml bestand dat ook in de specialisatiemap moet worden opgenomen.

    note note
    NOTE
    In het geval van DITA 1.3, is de standaardplaats voor XSD catalog.xml- dossier in de AEM bewaarplaats: /libs/fmdita/dita_resources/DITA-1.3/xsd/catalog.xml.

  4. Upload de map naar de volgende locatie:

    /var/dxml/dita_resources

  5. Klik op de Adobe Experience Manager-koppeling bovenaan en kies Gereedschappen.

  6. Selecteren Hulplijnen in de lijst met gereedschappen.

  7. Klik op de knop DITA-profielen tegel.

  8. U kunt het standaardprofiel bewerken, een nieuw profiel maken of instellingen in het standaardprofiel dupliceren om een nieuw profiel te maken.

    note note
    NOTE
    U kunt het standaardprofiel niet verwijderen. Alle nieuwe profielen die u maakt, kunnen echter worden bewerkt en verwijderd.

  9. In de Schema > Catalogus instellingen, geeft u het pad op van de aangepaste DTD en XSD catalog.xml in uw AEM opslagplaats.

  10. Selecteer de Catalogus systeem-id toevoegen -optie.

    note note
    NOTE
    Selecteer deze optie alleen als er items voor openbare id's ontbreken in de catalogus of als de DITA-bestanden alleen de systeem-id's gebruiken die relatief zijn ten opzichte van het lokale bestandspad van waaruit ze worden geüpload.

    Zie de eigenschappentabel in voor meer informatie over andere eigenschappen op de pagina Profielen Stap 6 van de Aangepaste DITA-OT-plug-ins gebruiken sectie.

  11. Klikken Gereed om het profiel op te slaan.

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