DocumentatieAEM GuidesDocumentatie voor AEM Guides

Niet-DITA-inhoud migreren id181AH0R02HT

Last update: Wed Feb 11 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Ervaren
  • Beheerder

Deze sectie begeleidt u door het migratieproces om niet-DITA documenten in formaat te migreren DITA. AEM Guides biedt migratie uit de volgende bronnen:

Microsoft Word-documenten migreren id1949B040Z5Z

AEM Guides staat u toe om uw bestaande documenten van Word \ (.docx ) in DITA onderwerptypedocumenten te migreren. U moet de locatie van de invoer- en uitvoermap en andere parameters opgeven en het document wordt geconverteerd naar DITA-document. Afhankelijk van de inhoud, zou u een.dita dossier en een.ditamap- dossier kunnen hebben.

Als u een Word-document wilt converteren, moet het document een goede structuur hebben. Uw document moet bijvoorbeeld een titel hebben, gevolgd door Kop 1, Kop 2 enzovoort. Elk van de rubrieken zou wat inhoud in het moeten hebben. Als uw document niet goed gestructureerd is, werkt het proces mogelijk niet naar behoren.

Door gebrek, gebruikt AEM Guides ​ Word-aan-DITA \ (Word2DITA ) transformatiekader ​. Deze transformatie hangt van het ​ stijl-aan-markering van afbeelding ​ configuratiedossier af. Als u de Word2DITA-transformatie met succes wilt kunnen gebruiken, moet u de volgende richtlijnen in overweging nemen voor het voorbereiden van uw Word-document voor conversie:

NOTE
Als u wijzigingen aanbrengt in het standaardconfiguratiebestand voor de toewijzing van stijl naar label, moet u de richtlijnen bijwerken en gebruiken die bevestigen bij uw bijgewerkte stijltoewijzing.

  • Zorg ervoor dat het document begint met een titel. Deze titel wordt toegewezen aan de titel van de DITA-kaart. Daarnaast moet de titel worden gevolgd door gewone inhoud.

  • Na de titel moet er rubriek 1, rubriek 2 enzovoort zijn. Elke kop moet inhoud bevatten. De rubrieken worden omgezet in nieuwe Concept typeonderwerpen. De hiërarchie van de gegenereerde onderwerpen is afhankelijk van de niveaus van Kop in het document. Kop 1 komt bijvoorbeeld voor Kop 2 en Kop 2 komt voor Inhoud Kop 3.

  • Het document moet ten minste één koptekstinhoud hebben.

  • Zorg ervoor dat u geen gegroepeerde afbeeldingen hebt. Als u afbeeldingen in uw document hebt gegroepeerd, degroepeert u deze allemaal.

  • Alle kop- en voetteksten verwijderen.

  • Inline stijlen zoals vet, cursief en onderstrepen worden omgezet in b -, i - en u -elementen.

  • Alle geordende en ongeordende lijsten worden geconverteerd naar ol - en ul -elementen. Dit geldt ook voor geneste lijsten, lijsten binnen tabellen, notities of voetnoten.

  • Alle hyperlinks worden geconverteerd naar xref .

  • De bestandsnaam van de omgezette bestanden is gebaseerd op de koptekst gevolgd door een bestandsnummer. Het bestandsnummer is een opeenvolgend nummer op basis van de positie van de koptekst in het document. Als een koptekst bijvoorbeeld 'Voorbeeldkop' is en de tekst een tiende kop in het document heeft, is de resulterende bestandsnaam voor dit onderwerp vergelijkbaar met Sample_Heading_10.dita.

Voer de volgende stappen uit om uw bestaande documenten van Word in DITA onderwerptype document om te zetten:

  1. Meld u aan bij AEM en open de CRXDE Lite-modus.

  2. Navigeer naar het standaardconfiguratiebestand dat beschikbaar is op de volgende locatie:

    /libs/fmdita/config/w2d_io.xml

  3. Maak een overlayknooppunt van de map config in het knooppunt apps .

  4. Navigeer naar het configuratiebestand dat beschikbaar is in het knooppunt apps :

    /apps/fmdita/config/w2d_io.xml

    Het bestand w2d_io.xml bevat de volgende configureerbare parameters:

    • Geef in het element inputDir de locatie op van de invoermap waarin uw Word-brondocumenten beschikbaar zijn. Als uw Word-documenten bijvoorbeeld zijn opgeslagen in een map met de naam wordtodita in de map projects , geeft u de locatie op als: /content/dam/projects/wordtodita/

    • In het outputDir element, specificeer de plaats van de outputomslag of houd de standaardoutputplaats om het omgezette DITA- document te bewaren. Als de opgegeven uitvoermap niet bestaat op DAM, maakt de conversieworkflow de uitvoermap.

    • Voor het createRev element, specificeer of een nieuwe versie van het omgezette onderwerp DITA \ (true ) of niet \ (false ) moet worden gecreeerd.

    • Geef in het element s2tMap de locatie op van het kaartbestand dat toewijzingen voor Word-documentstijlen aan DITA-elementen bevat. De standaardtoewijzing wordt opgeslagen in het bestand dat zich bevindt op:

      code language-xml 
      /libs/fmdita/word2dita/word-builtin-styles-style2tagmap.xml
      note note
      NOTE
      Voor meer informatie over de structuur van word-builtin-styles-style2tagmap.xml dossier en hoe u het kunt aanpassen, zie ​ Stijl aan Tagtoewijzing ​ in DITA voor de Gids van de Gebruiker van Uitgevers.

    • In het element props2Propagate, specificeer de eigenschappen die tot de kaart moeten worden overgegaan DITA. Dit bezit wordt vereist om de standaardmeta-gegevens zoals dc :title, dc :subject, dam :keywords over te gaan, dam :category van documentmeta-gegevens aan omgezette activa DITA.

  5. Sla het w2d_io.xml -bestand op.

  6. Nadat u de vereiste parameters in het w2d_io.xml -bestand hebt geconfigureerd, meldt u zich aan bij AEM en opent u de gebruikersinterface van Assets.

  7. Navigeer naar de locatie van de invoermap (wordtodita).

  8. Upload de Word-brondocumenten naar deze map. Voor informatie bij het uploaden van inhoud op DAM, zie ​ Bestaande inhoud uploaden DITA ​.

Met behulp van het blok config /config kunt u een of meer configuraties definiëren voor conversie. De omzettingswerkstroom wordt uitgevoerd en de definitieve output in de vorm van een onderwerp DITA wordt bewaard in de plaats die in het outputDir element wordt gespecificeerd.

Adobe InDesign-documenten migreren id195AD0B0K5Z

Met AEM Guides kunt u InDesign-documenten converteren. Net als in FrameMaker kunt u met InDesign ook ongestructureerde en gestructureerde documenten maken. De ongestructureerde documenten gebruiken de alinea- en tekenstijlen om inhoud op te maken. In het gestructureerde document worden elementen en de bijbehorende kenmerken gebruikt.

Voor het conversieproces moeten de opmaak van de alinea- en tekenstijl worden toegewezen aan relevante DITA-elementen. Op dezelfde manier bevat het toewijzingsbestand in het geval van gestructureerde documenten een-op-een-toewijzing van InDesign-elementen en -kenmerken met DITA-elementen en -kenmerken.

Het conversieproces omvat de volgende acties op de achtergrond:

  • Het dossier van de Taal van de Prijsverhoging van InDesign \ (IDML ) is uitgepakt aan een werkende folder.
  • Het bestand designmap.xml wordt gelezen om de afzonderlijke InDesign-artikelen te zoeken.
  • Alle artikelen worden samengevoegd tot één XML-instantie, 'lege' artikelen worden genegeerd.
  • Alle ingesloten afbeeldingen worden geëxporteerd.
  • Pre-conversie van standaardstructuren zoals tabellen en afbeeldingen naar DITA-indeling.
  • Stijl- of structuurtoewijzing aan de uiteindelijke uitvoer op basis van het toewijzingsbestand.
  • Creatie en bevestiging van individuele onderwerpen DITA en DITA kaartdossiers.
  • Verwijderen van tijdelijke bestanden.

In het algemeen, vereist het omzettingsproces u om ​ InDesign dossiers voor omzetting ​ voor te bereiden en ​ het toewijzingsdossier voor InDesign aan migratie DITA ​ voor te bereiden dan moet u de bepaalde procedure volgen om het omzettingsproces in werking te stellen.

Voer de volgende stappen uit om uw bestaande InDesign-documenten om te zetten in DITA-onderwerpdocument:

  1. Meld u aan bij AEM en open de CRXDE Lite-modus.

  2. Navigeer naar het standaardconfiguratiebestand dat beschikbaar is op de volgende locatie:

    /libs/fmdita/config/idml2dita_io.xml

  3. Als u een aangepaste configuratie wilt maken die voldoet aan uw vereisten, maakt u een overlayknooppunt van de map config in het knooppunt apps .

  4. Kopieer de volgende bestanden of mappen vanuit de map libs naar de map Apps:

    • /fmdita/config/idml2dita_io.xml
    • /fmdita/idml2dita/config
    • /fmdita/idml2dita/xsl

  5. Navigeer naar het configuratiebestand dat beschikbaar is in het knooppunt apps :

    /apps/fmdita/config/idml2dita_io.xml

  6. Voeg de toewijzing van de configuraties toe die aanwezig zijn in de map idml12dita in het idml2dita_io.xml -bestand.

  7. Voeg de volgende eigenschappen toe aan het bestand idml2dita_io.xml :

    code language-none 
    <entry key="idml2DitaConfig">/apps/fmdita/idml2dita/config</entry>

<entry key="idml2DitaXsl">/apps/fmdita/idml2dita/xsl</entry>

Configureer de volgende parameters in het idml2dita_io.xml -bestand:

  • Geef in het element inputDir de locatie op van de invoermap waarin uw InDesign-brondocumenten beschikbaar zijn. Als uw InDesign-documenten bijvoorbeeld zijn opgeslagen in een map met de naam indesigntodita in de map projects , geeft u de locatie op als: /content/dam/idmlfiles/indesigntodita/

  • In het outputDir element, specificeer de plaats van de outputomslag of houd de standaardoutputplaats om het omgezette DITA- document te bewaren. Als de opgegeven uitvoermap niet bestaat op DAM, maakt de conversieworkflow de uitvoermap.

  • Geef in het element mapStyle de locatie op van het toewijzingsbestand dat toewijzingen voor InDesign-documentstijlen aan DITA-elementen bevat. De standaardtoewijzing wordt opgeslagen in het bestand dat zich bevindt op:

    /stmap.adobeidml.xml
NOTE
Voor meer informatie over de structuur van stmap.adobeidml.xml dossier en hoe u het kunt aanpassen, zie ​ het toewijzingsdossier voor InDesign aan migratie DITA ​ sectie in Bijlage voorbereiden.

  1. Sla het idml2dita_io.xml -bestand op.

  2. Nadat u de vereiste parameters in het idml2dita_io.xml -bestand hebt geconfigureerd, meldt u zich aan bij AEM en opent u de gebruikersinterface van Assets.

  3. Navigeer naar de locatie van de invoermap (indesigntodita).

  4. Upload de InDesign-brondocumenten naar deze map. Voor informatie bij het uploaden van inhoud op DAM, zie ​ Bestaande inhoud uploaden DITA ​.

XHTML-documenten migreren id1949B04L0Y4

Met AEM Guides kunt u uw bestaande XHTML-documenten converteren naar DITA-onderwerpdocumenten. U moet de locatie van de invoer- en uitvoermap en andere parameters opgeven en de documenten worden geconverteerd naar DITA-indeling. U kunt uw gestructureerde HTML-documenten op twee manieren converteren:

  • Alle documenten uploaden naar de invoermap, of
  • Maak een ZIP van alle documenten samen met de mediabestanden en upload deze naar de invoermap. Deze aanpak wordt over het algemeen gebruikt voor een set HTML-bestanden die aan elkaar zijn gekoppeld en er is een inhoudsopgave (index.html). Het bestand index.html bevat koppelingen naar alle HTML-bestanden in de set.

Of u nu alle bestanden afzonderlijk uploadt of in een ZIP-bestand gebundeld, het conversieproces zorgt voor een een-op-een-toewijzing tussen de HTML-bestanden en de resulterende DITA-bestanden. Dit betekent in wezen dat er een .dita dossier voor elk .html dossier in de inputomslag wordt gecreeerd.

Voor het uploaden van uw documenten in een ZIP-bestand moet u rekening houden met de volgende punten:

  • Alle onderwerpen waarnaar wordt verwezen, moeten in het ZIP-bestand worden geplaatst.

  • Alle mediabestanden waarnaar wordt verwezen, moeten worden doorverwezen in de onderwerpbestanden met behulp van de relatieve koppeling.

  • Maak een bestand index.html en voeg koppelingen toe naar de onderwerpen die u wilt toevoegen aan de inhoudsopgave. Dit bestand index.html wordt gebruikt om het DITA-kaartbestand te maken. In het bestand index.html kunt u ook geneste onderwerpen maken die worden vermeld in het volgende codevoorbeeld:

    code language-xml 
    <?xml version="1.0" encoding="UTF-8"?>
<html
xmlns="http://www.w3.org/1999/xhtml">
    <head>
        <title>Sample Index File</title>
    </head>
    <body>
        <h1>Sample Index</h1>
        <div class="content">
            <ul class="book">
                <li class="topicref">
                    <a href="Topic1.html">Topic 1</a>
                    <ul class="book">
                        <li class="topicref">
                            <a href="Topic1-1.html">Topic 1.1</a>
                        </li>
                        <li class="topicref">
                            <a href="Topic1-2.html">Topic 1.2</a>
                        </li>
                    </ul>
                </li>
                <li class="topicref">
                    <a href="Topic2.html">Topic 2</a>
                </li>
            </ul>
        </div>
    </body>
</html>

    Voor elke ul -tag moet het class -kenmerk zijn ingesteld op book . Op dezelfde manier moet elke li tag class worden ingesteld op topicref .

  • Als u inline stijlen gebruikt, zet u de inline stijlen om in op CSS gebaseerde stijlklassen in uw XHTML-bestand. Gebruik vervolgens stijlkenmerktoewijzing om deze op klassen gebaseerde stijlen te converteren naar het attribuut DITA outputclass in het geconverteerde DITA-bestand.

    Tijdens het genereren van HTML- of AEM-site-uitvoer uit deze DITA-bestanden, kunnen de outputclass -kenmerken worden gebruikt om stijlklasse toe te passen op gegenereerde HTML- of AEM-site, zodat deze overeenkomt met uw HTML-broninhoud.

Naast de overwegingen voor het maken van het ZIP-bestand moet uw XHTML-document ook goed gestructureerd zijn. Bijvoorbeeld, zou uw document a Titel moeten hebben, die door Kop 1 wordt gevolgd, Kop 2, etc. Elk van de rubrieken zou wat inhoud in het moeten hebben. Als uw document niet goed gestructureerd is, werkt het migratieproces mogelijk niet naar behoren.

Voer de volgende stappen uit om uw bestaande XHTML-document om te zetten in DITA-onderwerp:

  1. Meld u aan bij AEM en open de CRXDE Lite-modus.

  2. Navigeer naar het standaardconfiguratiebestand dat beschikbaar is op de volgende locatie:

    /libs/fmdita/config/h2d_io.xml

  3. Maak een overlayknooppunt van de map config in het knooppunt apps .

  4. Navigeer naar het configuratiebestand dat beschikbaar is in het knooppunt apps :

    /apps/fmdita/config/h2d_io.xml

    Het bestand h2d_io.xml bevat de volgende configureerbare parameters:

    • Geef in het element inputDir de locatie op van de invoermap waarin uw bron-XHTML-documenten beschikbaar zijn. Als uw XHTML-documenten bijvoorbeeld zijn opgeslagen in een map met de naam xhtmltodita in de projects -map, geeft u de locatie op als: /content/dam/projects/xhtmltodita/

    • In het outputDir element, specificeer de plaats van uw outputomslag of houd de standaardoutputplaats. Als de opgegeven uitvoermap niet bestaat op DAM, maakt de conversieworkflow de uitvoermap.

    • Voor het createRev element, specificeer of een nieuwe versie van het omgezette onderwerp DITA \ (true ) of niet \ (false ) moet worden gecreeerd.

  5. Sla het h2d_io.xml -bestand op.

  6. Nadat u de vereiste parameters in het h2d_io.xml -bestand hebt geconfigureerd, meldt u zich aan bij AEM en opent u de gebruikersinterface van Assets.

  7. (Optioneel) U kunt de verwante sectie van verbindingen aan de omgezette documenten ook toevoegen. Voer de volgende stappen uit om deze functie in te schakelen:

    note note
    NOTE
    Standaard wordt de sectie Verwante koppelingen niet gemaakt in de omgezette documenten.

    1. Navigeer naar het bestand h2d.xsl op de volgende locatie:

      /libs/fmdita/html2dita/

    2. Zoek naar de volgende parameter:

      <xsl:param name="generate-related-links" select="false()"/>

    3. Stel de waarde van de bovenstaande parameter in op true() .

    4. Sla het bestand op en sluit het.

  8. Navigeer naar de locatie van de invoermap (xhtmltodita).

  9. Upload de bron-XHTML-documenten naar deze map. Voor informatie bij het uploaden van inhoud op DAM, zie ​ Bestaande inhoud uploaden DITA ​.

Met behulp van het blok <config> </config> kunt u een of meer configuraties definiëren voor conversie. De omzettingswerkstroom wordt uitgevoerd en de definitieve output in de vorm van een onderwerp DITA wordt bewaard in de plaats die in het outputDir element wordt gespecificeerd.

Niet-gestructureerde FrameMaker-documenten migreren id1949B050VUI

Als u ongestructureerde Adobe FrameMaker-inhoud (.fm en .book) wilt converteren naar gestructureerde DITA, kunt u het tabelmechanisme voor FrameMaker-conversie gebruiken. Het proces richt zich op het evalueren van bestaande inhoud, het gebruiken van een op malplaatje-gebaseerde benadering, en het in kaart brengen van de stijlen van FrameMaker aan DITA door omzettingslijsten. Voor meer details, mening ​ migrerend technische documentatie van ongestructureerd aan DITA in Adobe FrameMaker ​.

Na de conversie kan de gestructureerde inhoud naar AEM Guides worden gemigreerd. Voor meer details, uploadt de mening ​ bestaande inhoud DITA ​.

Andere gestructureerde documenten migreren id1949B0590YK

Met AEM Guides kunt u uw bestaande gestructureerde documenten converteren naar geldige DITA-documenten. U moet de locatie van de invoer- en uitvoermap, de locatie van het transformatiebestand, de extensie opgeven waarmee de uiteindelijke uitvoer wordt opgeslagen en of een nieuwe versie van het document is vereist of niet.

Voer de volgende stappen uit om uw bestaande gestructureerde documenten om te zetten in DITA-indeling:

  1. Meld u aan bij AEM en open de CRXDE Lite-modus.

  2. Navigeer naar het standaardconfiguratiebestand dat beschikbaar is op de volgende locatie:

    /libs/fmdita/config/XSLConfig.xml

  3. Maak een overlayknooppunt van de map config in het knooppunt apps .

  4. Navigeer naar het configuratiebestand dat beschikbaar is in het knooppunt apps :

    /apps/fmdita/config/XSLConfig.xml

    Het bestand XSLConfig.xml bevat de volgende configureerbare parameters:

    • Geef in het element inputDir de locatie op van de invoermap waarin de gestructureerde brondocumenten beschikbaar zijn. Als uw gestructureerde documenten bijvoorbeeld zijn opgeslagen in een map met de naam xsltodita in de map projects , geeft u de locatie op als: /content/dam/projects/xsltodita/

    • In het outputDir element, specificeer de plaats van uw outputomslag of houd de standaardoutputplaats. Als de opgegeven uitvoermap niet bestaat op DAM, maakt de conversieworkflow de uitvoermap.

    • Geef in het element xslFolder de locatie op van de map waarin de XSL-transformatiebestanden zijn opgeslagen.

    • Geef in het element xslPath de locatie op van het primaire XSL-bestand waarmee het conversieproces wordt gestart.

    • Geef in het element outputExt de bestandsextensies op van het uiteindelijke uitvoerbestand dat met de transformatiestream is gemaakt.

    • Voor het createRev element, specificeer of een nieuwe versie van het omgezette onderwerp DITA \ (true ) of niet \ (false ) moet worden gecreeerd.

  5. Sla het XSLConfig.xml -bestand op.

  6. Nadat u de vereiste parameters in het XSLConfig.xml -bestand hebt geconfigureerd, meldt u zich aan bij AEM en opent u de gebruikersinterface van Assets.

  7. Navigeer naar de locatie van de invoermap (xsltodita).

  8. Upload de gestructureerde brondocumenten naar deze map. Voor informatie bij het uploaden van inhoud op DAM, zie ​ Bestaande inhoud uploaden DITA ​.

Met behulp van het blok <config> </config> kunt u een of meer configuraties definiëren voor conversie. De omzettingswerkstroom wordt uitgevoerd en de definitieve output in de vorm van een onderwerp DITA wordt bewaard in de plaats die in het outputDir element wordt gespecificeerd.

Bovenliggend onderwerp:​​ Migreer bestaande inhoud ​

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