Niet-DITA-inhoud migreren id181AH0R02HT
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 afbeeldingconfiguratiedossier 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:
-
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
- enu
-elementen. -
Alle geordende en ongeordende lijsten worden geconverteerd naar
ol
- enul
-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:
-
Gebruik Pakketbeheer om het bestand /libs/fmdita/config/w2d_io.xml te downloaden.
-
Pas het gedownloade bestand w2d_io.xml aan.
-
Voeg het bestand toe op de volgende locatie in de Cloud Manager Git-opslagplaats:
/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 naamwordtodita
in de mapprojects
, 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-none /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 Tagtoewijzingin DITA voor de Gids van de Gebruiker van Uitgevers. -
In het element props2Propagate, specificeer de eigenschappen die tot de kaart moeten worden overgegaan DITA. Deze eigenschap is vereist voor het doorgeven van de standaardmetagegevens, zoals dc:title,dc:subject,dam:trefwoorden,dam:categorie van documentmetagegevens naar geconverteerde DITA-elementen.
-
-
Stel de pijpleiding van Cloud Manager in werking om de bijgewerkte configuratie op te stellen.
-
Nadat u de vereiste parameters in het
w2d_io.xml
-bestand hebt geconfigureerd, meldt u zich aan AEM en opent u de interface van Assets. -
Navigeer naar de locatie van de invoermap (
wordtodita
). -
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.
updates van de Aanpassing voor bestaande gebruikers
Als u een bestaande gebruiker bent voor AEM Guides as a Cloud Service en een upgrade uitvoert van de release van augustus 2021 naar de versies januari 2022 of hoger, werkt u de gegeven eigenschappen bij als er maar weinig bestanden zijn verplaatst.
- Bestandspad: /apps/fmdita/config/w2d_io.xml
- Wijzig de waarde voor
<s2tMap>
in /libs/fmdita/word2dita/word-builtin-styles-style2tagmap.xml - Breng de noodzakelijke wijzigingen aan in uw Cloud Manager Git-opslagplaats, net zoals voor cloudservice, worden alle bestanden in /apps overschreven via Cloud Manager Git.
Adobe InDesign-documenten migreren id195AD0B0K5Z
Met AEM Guides kunt u documenten met InDesigns converteren. Net als 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 zal in het geval van gestructureerde documenten het toewijzingsdossier één-aan-één afbeelding van de elementen en de attributen van het InDesign met elementen DITA en attributen bevatten.
Het conversieproces omvat de volgende acties op de achtergrond:
- Het dossier van de Taal van de Prijsverhoging van het InDesign \ (IDML ) is uitgepakt aan een werkende folder.
- Het bestand designmap.xml wordt gelezen om de afzonderlijke artikelen van het InDesign 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.
Breedweg, vereist het omzettingsproces u InDesign dossiers voor omzettingappendix.md #id195DBF0045Zen voorbereidt het kaartdossier voor InDesign aan migratie DITAappendix.md \ #id194AF003HT, u moet de bepaalde procedure volgen om het omzettingsproces te leiden.
Voer de volgende stappen uit om uw bestaande documenten van het InDesign in DITA onderwerptype document om te zetten:
-
Meld u aan bij AEM en open de modus CRXDE Lite.
-
Navigeer naar het standaardconfiguratiebestand dat beschikbaar is op de volgende locatie:
/libs/fmdita/config/idml2dita_io.xml
-
Als u een aangepaste configuratie wilt maken die voldoet aan uw vereisten, maakt u een overlayknooppunt van de map
config
in het knooppuntapps
. -
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
-
Navigeer naar het configuratiebestand dat beschikbaar is in het knooppunt
apps
:/apps/fmdita/config/idml2dita_io.xml
-
Voeg de toewijzing van de configuraties toe die aanwezig zijn in de map
idml12dita
in hetidml2dita_io.xml
-bestand. -
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>
-
Maak een overlayknooppunt van de map
config
in het knooppuntapps
.Configureer de volgende parameters in het
idml2dita_io.xml
-bestand:-
Geef in het element
inputDir
de locatie op van de invoermap waarin de brondocumenten van het InDesign beschikbaar zijn. Als uw documenten met InDesigns bijvoorbeeld zijn opgeslagen in een map met de naamindesigntodita
in de mapprojects
, 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
mapStyle
-element de locatie op van het toewijzingsbestand dat toewijzingen bevat voor documentstijlen van InDesigns naar DITA-elementen. De standaardtoewijzing wordt opgeslagen in het bestand dat zich bevindt op:code language-none /stmap.adobeidml.xml
note note NOTE Voor meer informatie over de structuur van stmap.adobeidml.xml
dossier en hoe u het kunt aanpassen, zie de sectie appendix.md #id194AF003HTin Bijlage.
-
-
Sla het
idml2dita_io.xml
-bestand op. -
Nadat u de vereiste parameters in het
idml2dita_io.xml
-bestand hebt geconfigureerd, meldt u zich aan AEM en opent u de interface van Assets. -
Navigeer naar de locatie van de invoermap (
indesigntodita
). -
Upload de documenten van het bronInDesign in deze omslag. 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. Er zijn twee methoden waarmee u gestructureerde HTML-documenten kunt omzetten:
- 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-none <?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 hetclass
-kenmerk zijn ingesteld opbook
. Op dezelfde manier moet elkeli
tagclass
worden ingesteld optopicref
. -
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 de HTML-inhoud van uw bron.
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:
-
Gebruik Pakketbeheer om het bestand /libs/fmdita/config/h2d_io.xml te downloaden.
-
Pas het gedownloade bestand h2d_io.xml aan.
-
Voeg het bestand toe op de volgende locatie in de Cloud Manager Git-opslagplaats:
/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 naamxhtmltodita
in deprojects
-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.
-
-
Stel de pijpleiding van Cloud Manager in werking om de bijgewerkte configuratie op te stellen.
-
Nadat u de vereiste parameters in het
w2d_io.xml
-bestand hebt geconfigureerd, meldt u zich aan AEM en opent u de interface van Assets. -
(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. -
Gebruik Package Manager om het bestand /libs/fmdita/html2dita/h2d.xsl te downloaden.
-
Zoek naar de volgende parameter:
<xsl:param name="generate-related-links" select="false()"/>
-
Stel de waarde van de bovenstaande parameter in op
true()
. -
Leg het bijgewerkte bestand vast op de volgende locatie in de Cloud Manager Git-opslagplaats:
/libs/fmdita/html2dita/
-
Stel de pijpleiding van Cloud Manager in werking om de bijgewerkte configuratie op te stellen.
-
-
Navigeer naar de locatie van de invoermap (
xhtmltodita
). -
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 FrameMakers migreren id1949B050VUI
Met AEM Guides kunt u uw bestaande ongestructureerde FrameMaker (.fm
en .book
)-documenten converteren naar DITA-documenten. De eerste stap bestaat uit het maken van stijltoewijzingen met behulp van FrameMaker en het opslaan van deze instellingen in een .sts-bestand. Als u vervolgens aangepaste DITA gebruikt, kunt u uw aangepaste elementen toewijzen aan de indeling van de bronFrameMaker in het ditaElems.xml
-bestand. Als u bijvoorbeeld een aangepast element met de naam impnote
hebt gemaakt voor de verwerking van alle belangrijke notities, kunt u dit aangepaste element definiëren in het ditaElems.xml
-bestand. Zodra dit aangepaste element is gedefinieerd, genereert AEM Guides geen fout tijdens het converteren van een FrameMaker-document dat impnote
-element bevat.
Ook, als u sommige extra attributen met uw douane of geldig element wilt specificeren DITA, kunt u die in het style2attrMap.xml- dossier bepalen. U kunt bijvoorbeeld het kenmerk type
opgeven met de waarde important
die met het element impnote
moet worden doorgegeven. Deze aanvullende informatie kan worden opgegeven in het bestand style2attrMap.xml.
Naast het specificeren van
Ga als volgt te werk om uw bestaande ongestructureerde documenten van de FrameMaker om te zetten in DITA-indeling:
-
Maak stijltoewijzingen in FrameMaker en sla deze instellingen op in een .sts-bestand.
-
Gebruik Package Manager om het bestand /libs/fmdita/config/ditaElems.xml te downloaden.
-
Als u aangepaste DITA-elementen hebt, definieert u de elementen in het
ditaElems.xml
-bestand dat beschikbaar is op de volgende locatie:/libs/fmdita/config/ditaElems.xml
-
Maak een kopie van het bestand ditaElems.xml op de volgende locatie in de Cloud Manager Git-opslagplaats:
/apps/fmdita/config/ditaElems.xml
-
Navigeer naar het configuratiebestand dat beschikbaar is in het knooppunt
apps
:/apps/fmdita/config/ditaElems.xml
Het bestand
ditaElems.xml
bevat één configureerbare parameter:- Geef in de parameter
elem
de naam op van het aangepaste element dat u wilt gebruiken in uw omgezette DITA-documenten. Dit element wordt doorgegeven, net als in de gegenereerde DITA-documenten.
- Geef in de parameter
-
Als u aanvullende kenmerken wilt opgeven, definieert u de kenmerken in het
style2attrMap.xml
-bestand dat beschikbaar is op de volgende locatie:/libs/fmdita/config/style2attrMap.xml
-
Maak een overlayknooppunt van de map
config
in het knooppuntapps
. -
Navigeer naar het configuratiebestand dat beschikbaar is in het knooppunt
apps
:/apps/fmdita/config/style2attrMap.xml
Het bestand
style2attrMap.xml
bevat de volgende configureerbare parameters:-
Geef in de parameter
fmStyle
de bronindeling op die wordt gebruikt in het FrameMaker-document dat u wilt toewijzen. -
In het
ditaAttr
element, specificeer de attributen DITA die u met het bronformaat wilt in kaart brengen. -
Geef in het element
ditaVal
de waarde voor het toegewezen kenmerk op. Als u geen waarde hebt, kunt u dit item leeg laten.
-
-
Sla het
style2attrMap.xml
-bestand op. -
Nadat u de vereiste parameters in het
style2attrMap.xml
-bestand hebt geconfigureerd, meldt u zich aan AEM en opent u de interface van Assets. -
Navigeer naar en klik op het document van de FrameMaker dat u wilt omzetten.
De DITA kaartconsole verschijnt tonend de lijst van Output stelt beschikbaar om output te produceren.
-
Selecteer DITA-uitvoerindeling en configureer de vereiste parameters.
note note NOTE U moet het instellingenbestand (.sts) gebruiken dat u in de FrameMaker hebt gemaakt. Geef ook de naam van de instellingen en het bestemmingspad op. -
Klik produceren pictogram om het proces van de outputgeneratie te beginnen.
Met behulp van het blok <attrMap> </attrMap>
kunt u een of meer configuraties definiëren voor conversie. Afhankelijk van de inhoud, zou u een.dita- dossier en een.ditamap- dossier als omgezette dossiers kunnen hebben.
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:
-
Gebruik Package Manager om het bestand /libs/fmdita/config/XSLConfig.xml te downloaden.
-
Maak een kopie van het bestand XSLConfig.xml op de volgende locatie in de Cloud Manager Git-opslagplaats:
/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 naamxsltodita
in de mapprojects
, 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.
-
-
Sla het
XSLConfig.xml
-bestand op. -
Nadat u de vereiste parameters in het
XSLConfig.xml
-bestand hebt geconfigureerd, meldt u zich aan AEM en opent u de interface van Assets. -
Navigeer naar de locatie van de invoermap (
xsltodita
). -
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