DocumentatieAEM GuidesDocumentatie voor AEM Guides

Aangepaste DITA-OT en DITA-specialisatie gebruiken id181GAJ0005Z

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Ervaren
  • Beheerder

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

Als u Ant-parameters wilt verwerken terwijl u uitvoer publiceert, biedt AEM Guides 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 Guides wordt geleverd met DITA-OT versie 3.3.2. AEM Guides biedt echter wel ondersteuning voor DITA-OT versie 1.7 en hoger. Voor de volledige lijst van versies DITA-OT, zie versies DITA-OT.
TIP
Zie de configuratie van Profielen DITA-OT en Gebruikend douaneDITA-OT secties in de Beste praktijken gids voor beste praktijken rond het gebruiken van douaneDITA-OT stop-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. AEM Guides wordt standaard geleverd met een vooraf geconfigureerd profiel dat de configuraties bevat voor de standaardsjablonen die moeten 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 Guides 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 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 het DITA-OT.ZIP -bestand een map met de naam "DITA-OT" bevat die alle relevante plug-ins en bestanden bevat.
    • Controleer of het DITA-OT.ZIP -bestand dat u maakt van het mimeType is: "nt:file" (dit komt overeen met het primaire type ZIP-bestand wanneer het wordt geüpload 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 het ook doen gebruikend de pijpleiding van Cloud Manager, zie het Opstellen aan AEM as a Cloud Servicein AEM documentatie voor meer details.

  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
    Eigenschappen van het Profiel
    Profielnaam Geef dit profiel een unieke naam.
    Uitvoer opnieuw gebruiken (Optioneel) Als uw profiel op een bestaand profiel gebaseerd is, dan selecteer deze optie. Als u deze optie selecteert, zorgt AEM Guides ervoor dat de inhoud van het DITA-OT-pakket niet opnieuw wordt geëxtraheerd en wordt het bestaande DITA-OT-pakket opnieuw gebruikt.
    Pad voor exporteren van profiel \ (Facultatief ) specificeer de weg waar DITA-OT op schijf wordt gehouden. Standaard bundelt AEM Guides een DITA-OT-pakket in de opslagplaats en wordt het op de schijf opgehaald bij dit pad.
    NOTA U kunt deze weg bepalen gebruikend om het even welk bestaand systeemvariabele of bezit. Zie beschrijving het DITA-OT bezit van de Variabelen van het Milieuvoor meer informatie.
    Toegewezen pad \ (Facultatief ) specificeer de weg in uw inhoudsbewaarplaats waarvoor dit profiel van toepassing is. U kunt meerdere locaties opgeven.
    DITA-OT Eigenschappen
    Tijdslimiet DITA-OT \ (Facultatief ) specificeer de tijd \ (in seconden ) waarvoor AEM Guides op een reactie van de stop DITA-OT wacht. Als er geen reactie is ontvangen binnen de opgegeven tijd, wordt de publicatietaak beëindigd 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. Voor alle douaneDITA-OT profielen, specificeer het volgende bevel-lijn argument:-lib plugins/org.dita.pdf2.fop/lib/
    DITA-OT AEM Argumenten \ (Facultatief ) specificeer de douane bevel-lijn argumenten die door de douaneDITA-OT stop-binnen voor het produceren van de output van de Plaats worden verwerkt AEM.
    DITA-OT bibliotheekpaden \ (Facultatief ) specificeer de extra bibliotheekwegen van stop - van DITA-OT.
    DITA-OT XML samenstellen \ (Facultatieve ) specificeer de weg van het douaneAnt bouwt manuscript dat met de aangepaste stop DITA-OT wordt gebundeld. 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 \ (Facultatief ) specificeer omgevingsvariabelen om tot het DITA-OT proces over te gaan. Standaard voegt de AEM Guides 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 in uw systeem hebt gedefinieerd en u een nieuwe omgevingsvariabele wilt definiëren met de naam JAVA_BIN die is gemaakt met JAVA_HOME . Vervolgens kunt u de definitie van JAVA_BIN toevoegen als: JAVA_BIN= ${JAVA_HOME}/bin
    Nota: u kunt het systeemeigenschappen van Java ook gebruiken om omgevingsvariabelen te bouwen. Als AEM beginscript bijvoorbeeld een Java-systeemeigenschap java.io.tmpdir in een tijdelijke map definieert, kunt u deze eigenschap gebruiken om de nieuwe variabele als: ${java.io.tmpdir}/fmdita/dita_ot
    te definiëren. Belangrijk: om het even welk bestaand systeemvariabele of bezit opnieuw te gebruiken, moet het binnen ${} worden ingesloten.
    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 \ (Facultatieve ) Weg van de dossiers van aangepaste DTD en XSD catalog.xml in de AEM bewaarplaats. 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 \ (Facultatieve ) selecteer deze optie slechts als er ontbrekende Publieke ingangen van identiteitskaart in de catalogus zijn of als de DITA- dossiers slechts systeem IDs gebruiken die met betrekking tot de serverweg van waar zij worden geupload zijn.
    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. De tijdelijke opslaglocatie is standaard:
    <*AEM-Install*>/crx-quickstart/profiles/ditamaps
    Belangrijk: u moet niet de standaardweg veranderen.
    note note
    NOTE
    Het AEM Guides-installatieprogramma maakt twee omgevingsvariabelen waarmee u het pad van de aangepaste DITA-OT-plug-inbestanden kunt opgeven. Deze omgevingsvariabelen zijn: DITAOT\_DIR , dat het pad bevat van de map DITA-OT op het bestandssysteem, en DITAMAP\_DIR , dat het pad bevat waar de DITA-kaartinhoud wordt geëxtraheerd naar het bestandssysteem.

  8. Klik Gedaan om het profiel te bewaren.

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 Guides staat u toe om Openbare identiteitskaart en identiteitskaart van het Systeem in uw douane DTDs/XSDs te gebruiken.

NOTE
AEM Guides Web Editor biedt geen ondersteuning voor XSD's.

Voer de volgende stappen uit om een nieuw profiel te maken en dit te configureren voor gebruik van gespecialiseerde DTD's en XSD's in uw AEM Guides:

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

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

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

  3. Geef de XSD-gegevens in het catalog.xml -bestand op die ook in de specialisatiemap moeten worden opgenomen.

    note note
    NOTE
    In het geval van DITA 1.3 is de standaardlocatie voor het bestand XSD catalog.xml in de AEM opslagplaats: /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 verbinding van Adobe Experience Manager bij de bovenkant en kies Hulpmiddelen.

  6. Selecteer Gidsen van de lijst van hulpmiddelen.

  7. Klik op de 1} tegel van Profielen DITA {.

  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 het Schema > Catalogus montages, specificeer de weg van de douaneDTD en XSD catalog.xml dossiers in uw AEM bewaarplaats.

  10. Selecteer toevoegen de Catalogus van identiteitskaart van het Systeem 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.

    Voor meer informatie over andere eigenschappen op de pagina van Profielen, zie de eigenschappen lijst in Stap 6van de douane DITA-OT stop-ins van het Gebruik { sectie.

  11. Klik Gedaan om het profiel te bewaren.

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