Bijlage id195AD0L60Y4
Bestanden van InDesigns voorbereiden voor conversie id195DBF0045Z
InDesign biedt auteurs een uitgebreide reeks functies voor het maken van aantrekkelijke en complexe documenten. Dit betekent vaak dat de verschillende delen van een document visueel op de pagina worden geplaatst, maar zonder dat wordt geprobeerd om stroom tussen die tekstkaders tot stand te brengen. Wanneer 'leesvolgorde' van de tekstkaders is niet gedefinieerd, bevat het IDML-bestand artikelen die geen betekenisvolle volgorde volgen. Het eindresultaat zal één of meerdere onderwerpen DITA met paragrafen, lijsten en grafiek in een willekeurige orde zijn.
Terwijl het mogelijk is om de inhoud DITA in een zinnige orde in een redacteur uit te geven DITA, is het veel gemakkelijker om het dossier van het InDesign te bevestigen alvorens het IDML- dossier tot stand te brengen. Dit kan worden gedaan zonder de blik van het brondocument te veranderen. Het heeft ook het voordeel dat het brondocument toegankelijk wordt gemaakt door de leesvolgorde correct te definiëren.
Tekstkaders verbinden
InDesign gebruikt de term 'threading' voor het koppelen van een frame naar een ander frame. Zie voor meer informatie over het verbinden van tekstkaders Tekst met verbindingen onderwerp in de documentatie van het InDesign.
Overlappende frames
Sommige documenten van het InDesign gebruiken niet-verbonden overlappende kaders voor lay-outredenen. Het kan erg moeilijk zijn om deze inhoud samen te voegen in de hoofdthread. De beste optie kan zijn om het resultaat in het milieu uit te geven DITA.
InDesigns
Elke verbonden stroom van inhoud in een document van het InDesign wordt genoemd "verhaal". Voor de beste resultaten is het raadzaam het aantal artikelen beperkt te houden. Er zijn echter delen van uw document die niet nodig zijn in de DITA-uitvoer. Pagina-voetteksten zijn bijvoorbeeld zelden nodig, maar kunnen in het midden van een onderwerp verschijnen als ze niet zorgvuldig worden verwerkt.
De eenvoudigste manier om tekst uit te sluiten die niet in het document is vereist, is om deze een speciale code te geven Alinealabel die alleen voor de ongewenste inhoud wordt gebruikt. In plaats van een [Basisalinea] voor de voettekst, maakt u een speciale Voettekst -tag. Vervolgens stelt u in het MapStyle-bestand gewoon het Voettekst alinea's die als volgt moeten worden verwijderd:
<paraRule style="Footer" local="0" refactor="drop">
<attributeRules createID="false"/>
</paraRule>
Toewijzen aan DITA-documenttypen
Het is van essentieel belang dat uw brondocument ten minste één alineastijl of -element heeft die het begin van een onderwerp kan markeren. Documenten worden veel gebruikt Kop1 als de naam van de titels op hoofdniveau in het document. U kunt dan een afbeelding van die stijl aan een specifiek DITA documenttype tot stand brengen. Als uw document goed is georganiseerd en u kunt Kop1 is constant door, dan zult u goede resultaten krijgen.
Meerdere DITA-doctypen
Als sommige van de Kop1 alinea's moeten worden omgezet in verschillende DITA-documenttypen en vervolgens de alineastijl in het InDesign dupliceren. Geef deze stijlen een herkenbare naam, zoals Heading1_genTask of Kop1_problemen oplossen in voorkomend geval. Stel vervolgens het mapStyle-bestand in zoals hieronder wordt weergegeven:
<doctypes>
<doctypeParaRule style="Heading1" local="0" mapToDoctype="concept">
<attributeRules createID="true"/>
</doctypeParaRule>
<doctypeParaRule style="Heading1_genTask" local="0" mapToDoctype=" generalTask">
<attributeRules createID="true"/>
</doctypeParaRule>
<doctypeParaRule style="Heading1_troubleshooting" local="0"mapToDoctype=" troubleshooting">
<attributeRules createID="true"/>
</doctypeParaRule>
</doctypes>
Gestructureerde documenten van InDesigns
InDesign heeft een losse relatie met XML. Hoewel een document een XML DTD kan bevatten en het hoofdartikel geldig kan zijn tegen die DTD, is het ook mogelijk om hybride documenten te maken waar sommige inhoud XML is, maar geen DTD is inbegrepen. Dit zijn de ongewenste gevallen van een geslaagde conversie naar DITA. Als een document XML-onderdelen bevat, probeert u de uitvoer op te slaan in XML en controleert u of de resultaten acceptabel zijn. Als dat niet het geval is, bevat de DITA-inhoud ook ongeldige inhoud of kan deze volledig mislukken.
Tabelopmaak
De conversie van InDesign van de de lijsthet formatteren regels aan het gelijkwaardige lijst formatteren in DITA is een complex proces. Dit komt door de rijke opmaakkenmerken die beschikbaar zijn in de bronbestanden in vergelijking met de basisopties in het tabelmodel Oasis (CALS) dat wordt gebruikt in DITA. Verticale en horizontale tekstuitlijning is beschikbaar en geeft vergelijkbare resultaten, hoewel uitgevulde tekst altijd wordt uitgevuld volgens de tekstrichting, terwijl InDesign Links uitvullen en Rechts uitgevuld toestaat.
De manier waarop InDesigns kolom- en rijscheidingstekens hanteren, is weer veel beter dan de basisopties van het tabelmodel Oasis. InDesign biedt vier celranden: randtype (effen of patroondikte), randdikte, randkleur, randtint, randtussenkleur en randtussenruimtetint. Deze moeten allemaal worden toegewezen aan de randen rechts en onder aan elke cel (entry-element), waarbij de enige opties 0 of 1 zijn: de rand verbergen of de rand tonen.
De grens in InDesign kan op de volgende niveaus worden toegepast:
- Tabelstijlen
- Celstijlen
- Lokale overschrijvingen op elke cel
Het InDesign naar DITA-omzettingsproces past de grensregeling als volgt toe:
- Tabelstijlen worden toegewezen aan de
colspec/@colsep
kenmerk voor verticale regels. Horizontale regels worden toegewezen aan derow/@rowsep
kenmerk. In beide gevallen wordt het kenmerk niet gemaakt als de rand niet is gedefinieerd. - Celstijlen worden toegewezen aan de
entry/@colsep
enentry/@rowsep
kenmerken. Deze waarden zullen om het even welke van de Stijl van de Lijst afgeleide grensheerser met voeten treden. - Bij lokale overschrijvingen wordt de opmaak rechtstreeks op de cel toegepast en worden de tabelstijlen en celstijlen genegeerd.
Wisselende patronen
Met Tabelstijlen voor InDesigns kunnen de kolom- en cellijnen een wisselend patroon volgen. Hoewel deze functie wordt ondersteund voor conversie, zijn de resultaten alleen duidelijk wanneer een patroongroep de regel (1) weergeeft en de andere patroongroep de toewijzingen (0) verbergt.
Het toewijzingsbestand voorbereiden voor InDesign naar DITA-migratie id194AF0003HT
Voor de juiste DITA-conversie is een toewijzingsbestand vereist dat overeenkomt met de inhoud van het brondocument. Voor documenten met ongestructureerde InDesigns betekent dit dat alle beschikbare alineastijlen en tekenstijlen moeten worden toegewezen. Voor documenten van het gestructureerde InDesign van XML moeten alle elementen in zijn bijbehorende DTD in kaart worden gebracht.
De toewijzingsbestanden voor ongestructureerde en gestructureerde documenten van InDesigns zijn verschillend. Dit is toe te schrijven aan de complexere verwerkingsvereisten voor het omzetten van ongestructureerde broninhoud in DITA.
Hieronder volgt een voorbeeld van het toewijzingsbestand:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE styleMap SYSTEM "mapStyle.dtd">
<styleMap xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="mapStyle.xsd" >
<doctypes>
<mapDoctypeParaRule root="itpx:stories" mapToDoctype="map">
<attributeRules createID="true">
<addNew name="outputclass" value="map"/>
</attributeRules>
</mapDoctypeParaRule>
<doctypeParaRule style="Heading 1" local="0" mapToDoctype="concept">
<attributeRules createID="true"/>
</doctypeParaRule>
<doctypeParaRule style="Heading A" local="0" mapToDoctype="topic">
<attributeRules createID="true"/>
</doctypeParaRule>
</doctypes>
<wrappingRules>
<wrap elements="li+" context="number" wrapper="ol">
<attributeRules createID="true"/>
</wrap>
<wrap elements="li+" context="bullet" wrapper="ul">
<attributeRules createID="true"/>
</wrap>
</wrappingRules>
<paragraphStyleRules>
<paraRule style="Heading 2" local="0" mapTo="p">
<attributeRules createID="true"/>
</paraRule>
<paraRule style="Heading 3" local="0" mapTo="p">
<attributeRules createID="true"/>
</paraRule>
<paraRule style="List Paragraph" local="p[-|-|-|-|-|b|-|-]" context="bullet" mapTo="li">
<attributeRules createID="true"/>
</paraRule>
<paraRule style="List Paragraph" local="p[-|-|-|-|-|n|-|-]" context="number" mapTo="li">
<attributeRules createID="true"/>
</paraRule>
<paraRule style="List Paragraph" local="0" context="bullet" mapTo="li">
<attributeRules createID="true"/>
</paraRule>
<paraRule style="Normal" local="0" mapTo="p">
<attributeRules createID="true"/>
</paraRule>
<paraRule style="Normal" local="p[-|-|-|-|-|b|-|-]" context="bullet" mapTo="li">
<attributeRules createID="true"/>
</paraRule>
<paraRule style="Title" local="0" mapTo="p">
<attributeRules createID="true"/>
</paraRule>
</paragraphStyleRules>
<characterStyleRules>
<charRule style="Bold" local="0" mapTo="b">
<attributeRules createID="false"/>
</charRule>
<charRule style="Code" local="0" mapTo="codeph">
<attributeRules createID="false"/>
</charRule>
<charRule style="[No character style]" local="c[Bold|-|-|-|-|-|-|-]" mapTo="b">
<attributeRules createID="false"/>
</charRule>
<charRule style="[No character style]" local="c[Italic|-|-|-|-|-|-|-]" mapTo="i">
<attributeRules createID="false"/>
</charRule>
</characterStyleRules>
</styleMap>
Het toewijzingsbestand is een XML-bestand met een eenvoudige structuur waarin alle bronalineastijlen en tekenstijlcodes worden vermeld. De bestandsinhoud wordt hieronder uitgelegd:
Stijltoewijzing
In de styleMap
-element, kunt u twee optionele kenmerken opgeven - @map_date
en @map_version
voor het opnemen van de versie van het toewijzingsbestand.
Documenttype
De doctypes
Het element maakt een lijst van de gesteunde kaart DITA en onderwerpafbeeldingen.
Alinealijnen voor documenttype toewijzen
De mapDoctypeParaRule
element is verplicht. De attributen van dit element moeten niet worden uitgegeven omdat het de wortelelement van bronXML altijd aan de wortel van de kaart DITA in kaart wordt gebracht map
element.
Alinealijn voor documenttype
De doctypeParaRule
element is verplicht. Dit geeft het omzettingsproces een manier om het begin van een nieuw onderwerp te identificeren. Normaal gesproken worden de @style
kenmerk wordt op zichzelf gebruikt met de @local
kenmerk ingesteld op 0. Als er echter altijd lokale opmaakoverschrijvingen op de gekozen stijl staan, moet u een regel toevoegen voor elke stijl plus de lokale overschrijvingen. Dit is eenvoudig te herkennen in het gegenereerde toewijzingsbestand waar dit of een vergelijkbaar bestand kan worden gevonden:
<paraRule style="Heading 1" local="0" mapTo="p">
<attributeRules createID="true"/>
</paraRule>
<paraRule style="Heading 1" local="p[Italic|-|-|-|-|-|-|-]" mapTo="p">
<attributeRules createID="true"/>
</paraRule>
In het bovenstaande voorbeeld zijn er twee paraRule
elementen voor @style
= "Kop1". Eenvoudig, creeer een gelijkwaardig doctypeParaRule
elementen met de @mapToDoctype
naar wens ingestelde kenmerk.
De kenmerken die worden gebruikt in de doctypeParaRule
worden hieronder toegelicht:
@style
: De naam van een stijl in het document van het bronInDesign.@local
: Zie #id194CG0V005Z.@mapToDoctype
: De naam van een DITA onderwerptype van een opgesomde lijst van alle geldigdoctypes
.
Regels voor het verpakken van elementen
De elementomsluitende regels bepalen de manieren om elementen in het binnenkomende document om te zetten in een vooraf gedefinieerd element volgens een reeks kenmerkwaarden.
wrap
element
Dit is een optioneel element. De wrap
het element maakt een lijst van de elementen die zullen worden verpakt of worden bewogen. Wrapping wordt doorgaans gebruikt wanneer een reeks elementen een gemeenschappelijk bovenliggend element moet krijgen. Bijvoorbeeld meerdere li
elementen die in een ol
element. Daarnaast wrap
kan worden gebruikt voor het verplaatsen van elementen, zoals titels voor figuren en tabellen.
De kenmerken die worden gebruikt in de wrap
worden hieronder toegelicht:
-
@element
: Een plusteken na een elementnaam geeft aan dat alle aangrenzende elementen met dezelfde naam worden opgenomen in het element dat in het dialoogvenster@wrapper
kenmerk. -
@wrapper
: De naam van het element dat de omloop bevat. -
@context
: Biedt een manier om verder te verfijnen hoe een bepaald element is omlopen. In het volgende voorbeeld wordt een manier getoond om een reeksli
elementen in een geordende lijstol
of een ongeordende lijstul
volgens de@context
waarde (de context wordt gedefinieerd op het tabbladparaRule
element):code language-xml <wrap elements="li+" context="number" wrapper="ol"> <attributeRules createID="true"/> </wrap> <wrap elements="li+" context="bullet" wrapper="ul"> <attributeRules createID="true"/> </wrap>
In het volgende voorbeeld wordt getoond hoe u een fig
element van een title
en image
element:
-
@elements
: De elementen die worden vermeld en gescheiden door een komma, worden opgenomen in het element dat wordt genoemd in het dialoogvenster@wrapper
kenmerk. Omdat het gebruikelijk is om figuurtitels onder de afbeelding op te nemen, wordt de titeltitle
element onmiddellijk na deimage
.De volgende omloopregel:
code language-xml <wrap elements="title, image" context="FigTitle" wrapper="fig"> <attributeRules createID="true"/> </wrap>
Hiermee wordt de volgende tussenliggende XML geconverteerd:
code language-xml <image href="Links/myImage.png" scale="59"> <title>IDML2DITA workflow</title>
In de volgende geldige DITA figuurstructuur:
code language-xml <fig id="id397504"> <title>IDML2DITA workflow</title> <image href="Links/myImage.png" scale="59"> </fig>
-
@wrapper
: De naam van het element dat de omloop bevat. -
@context
: Biedt een manier om verder te verfijnen hoe een bepaald element omlopen is (de context wordt gedefinieerd op het tabbladparaRule
element).
In het volgende voorbeeld wordt getoond hoe u een title
in een table
:
-
@elements
: Detitle
element dat vlak voor of onmiddellijk na eentable
wordt opgenomen in het element dat in het dialoogvenster@wrapper
kenmerk. Een voorspelling in XPath-stijl kan de positie van het titelelement identificeren als[before]
of[after]
.Voorbeeld: de volgende omloopregel:
code language-xml <wrap elements="title[before]" context="TableTitle" wrapper="table"> <attributeRules createID="true"/> </wrap>
Hiermee wordt de volgende tussenliggende XML geconverteerd:
code language-xml <title>IDML2DITA workflow</title> <table id="id289742" outputclass="BasicTable"> <tgroup cols="2"> <colspec colname="0" colwidth="0.7*"> <colspec colname="1" colwidth="0.3*">
In deze geldige DITA-figuurstructuur:
code language-xml <table id="id289742" outputclass="BasicTable"> <title>IDML2DITA workflow</title> <tgroup cols="2"> <colspec colname="0" colwidth="0.7*"> <colspec colname="1" colwidth="0.3*">
-
@wrapper
: De naam van het element dat de omloop bevat. -
@context
: Biedt een manier om verder te verfijnen hoe een bepaald element omlopen is (de context wordt gedefinieerd op het tabbladparaRule
element).
Regels voor alineastijlen
De <paragraphStyleRule>
de elementen worden hieronder beschreven :
paraRule
element
De paraRule
element is verplicht. Hiermee geeft u de toewijzingsregels voor alle alineastijlen op. In een document van het InDesign, is al tekst bevat binnen substructuur van de Stijlen van de Paragraaf, zelfs de paragrafen zonder enige stijl worden genoemd [No paragraph style]
. De vierkante haakjes geven een ingebouwde stijlnaam voor een InDesign aan.
De kenmerken die worden gebruikt in de paraRule
worden hieronder toegelicht:
-
@style
: De naam van een stijl in het document van het bronInDesign. -
@local
: Zie #id194CG0V005Z. -
@mapTo
: De naam van een DITA-doelelement. -
@context
: Dit kenmerk wordt gebruikt voor een koppeling naar een specifieke wrap regel wanneer meer dan één omslagkeuze beschikbaar is. Voorbeeld:li
element kan in of eenol
of eenul
element. U kunt een specifieke stijlnaam of de@local
kenmerk dat het volgende kan weergeven:local="p[-|-|-|-|-|b|-|-]"
Waar de 'b
' in veld 6 verwijst naar een lijstitem met opsommingstekens. In dit geval instellen@context
aan 'bullet
".local="p[-|-|-|-|-|n|-|-]"
Waar de 'n
' in veld 6 verwijst naar een genummerd lijstitem. In dit geval instellen@context
aan 'number
".
-
@commentOut
: Dit kenmerk schakelt de tekstomloop van het doelelement in XML-opmerkingen in, zodat de informatie niet verloren gaat, maar handmatig door de gebruiker kan worden verwerkt. Dit is nuttig als de broninhoud niet kan worden gedwongen om aan de DITA-structuurregels te voldoen. -
@refactor
: Dit optionele kenmerk kan uit twee waarden bestaan: -
unwrap
: Het overeenkomende element wordt verwijderd terwijl de inhoud behouden blijft. -
drop
: Het overeenkomende element en de inhoud ervan worden verwijderd.
Regels voor tekenstijl
De charRule
de elementen worden hieronder beschreven :
[No character style]
wanneer local="0"
, omdat deze tijdens de voorbehandeling worden verwijderd.charRule
element
Dit is een optioneel element.
Dit zijn de toewijzingsregels voor alle tekenstijlen. In een document van het InDesign, is al tekst bevat binnen kindelementen van de Stijlen van het Karakter.
De kenmerken die worden gebruikt in de charRule
worden hieronder toegelicht:
-
@style
: De naam van een stijl in het document van het bronInDesign. -
@local
: Zie #id194CG0V005Z. -
@mapTo
: De naam van een DITA-doelelement. -
@refactor
: Dit optionele kenmerk kan uit twee waarden bestaan:-
unwrap
: Het overeenkomende element wordt verwijderd terwijl de inhoud behouden blijft. -
drop
: Het overeenkomende element en de inhoud ervan worden verwijderd.
-
Kenmerkregels
Dit element kan een onderliggend element zijn van de volgende elementcontexten:
mapDoctypeParaRule
mapDoctypeElemRule
doctypeParaRule
doctypeElemRule
paraRule
charRule
elementRule
Het doel van kenmerkregels is het beheren van de kenmerken voor de overeenkomende elementen.
Afhankelijk van de context zijn de volgende kenmerken beschikbaar in het dialoogvenster attributeRules
element:
@createID
: genereert een unieke id voor de overeenkomende elementen. Toegestane waardentrue
offalse
. Beschikbaar in alle contexten.@copyAll
: Hiermee kopieert u alle kenmerken van de XML-broninhoud alleen voor gestructureerde bronbestanden. Toegestane waarden zijntrue
offalse
. Beschikbaar voor contextenmapDoctypeParaRule
,mapDoctypeElemRule
,doctypeElemRule
enelementRule
.
De kenmerken die worden gebruikt in de attributeRules
worden hieronder toegelicht:
-
addNew
: Voegt een nieuw kenmerk toe aan het overeenkomende element. Beschikbaar voor alle contexten. Het heeft twee attributen:@name
: Moet een geldige XML-naam zijn, bij voorkeur geldig voor de DITA-context.@value
: Kan letterlijke tekst of een eenvoudige XPath-expressie zijn.
-
copyAtt
: Kopieert één kenmerk naar het doel en wijzigt desgewenst de naam ervan in het proces. De waarde wordt niet gewijzigd. Beschikbaar voor contextenmapDoctypeParaRule
,mapDoctypeElemRule
,doctypeElemRule
enelementRule
. Wanneer dit element aanwezig is, wordt@copyAllAtts
waarde wordt verondersteldfalse
. Het heeft twee attributen:@name
: Moet de naam zijn van een kenmerk dat aanwezig is op het bron-XML-element.@mapTo
: Moet een geldige XML-naam zijn, bij voorkeur geldig voor de DITA-context.
Lokale opmaakcodes
In elk document van een InDesign kunnen alineastijlen en tekenstijlen honderden verschillende opmaakoverschrijvingen bevatten. De meeste van deze eigenschappen bieden geen nuttige rol in het conversieproces. We hebben echter een kernset opmaakfuncties geïdentificeerd die wel van invloed zijn op de semantiek van het document en die het conversieproces moeten beïnvloeden.
De @local
kenmerken worden weergegeven als een speciale indeling met scheidingstekens, waarbij acht velden worden opgegeven en een voorvoegsel wordt weergegeven waarmee het type opmaakoverschrijving wordt aangegeven. De velden met opmaakcodes worden hieronder weergegeven:
- Voorvoegsel p voor para-stijl lokale overschrijving of c voor tekenstijl lokale overschrijving.
- Lettertypestijl Dit is de familienaam en eigenschappen zoals "Vet, versmald en cursief".
- Fontgrootte in punten.
- Tekenpositie voor superscript of subscript.
- Onder voor onderstrepingsteken.
- Strike voor doorhaling.
- Lijstcode om lijsttype als bulleted of Genummerd te identificeren - niet altijd gebruikt door InDesign.
- Opsommingscode Hiermee geeft u alle gedefinieerde opsommingstekens in het document weer.
- Nummercode Hiermee geeft u alle gedefinieerde nummeringsstijlen in het document weer.
Wanneer u deze functie zorgvuldig gebruikt, kan verloren lokale opmaak de kwaliteit van een overdracht van gestileerde inhoud naar DITA verbeteren. Dit voorbeeld kan worden omgezet in cursieve, 16-pt tekst in een lijst met opsommingstekens: p[Italic|16|-|-|-|b|-|-]
.
Structuurtoewijzing
Het structuurtoewijzingsbestand lijkt op het stijltoewijzingsbestand met een eenvoudige structuur die alle bronelementen en relevante kenmerktypen opsomt. Twee kenmerken, @map_date
en @map_version
worden verstrekt voor het registreren van de versie van het te gebruiken toewijzingsbestand.
Documenttype
De doctypes
Het element maakt een lijst van de gesteunde kaart DITA en onderwerpafbeeldingen.
Elementregels voor documenttype toewijzen
De mapDoctypeElemRule
element is verplicht. De attributen van dit element moeten niet worden uitgegeven omdat het de wortelelement van bronXML altijd aan de wortel van de kaart DITA in kaart wordt gebracht map
element.
Regels voor het verpakken van elementen
elementRules
element Dit maakt een lijst van alle elementen.
elementRule
element De elementRule
element is verplicht. Dit zijn de toewijzingsregels voor alle bronelementen. Een InDesign-document bevat wel niet-gestructureerde stijlelementen, maar deze worden genegeerd voor gestructureerde inhoud, tenzij de syntaxis "hybride modus'-verwerking is ingeschakeld.
De kenmerken die worden gebruikt in de elementRule
worden hieronder toegelicht:
-
@elementName
: De naam van een InDesign in het document van het bronelement. -
@local
: Zie #id194CG0V005Z. (Alleen handig voor hybride documenten). -
@mapTo
: De naam van een DITA-doelelement. -
@refactor
: Dit optionele kenmerk kan uit twee waarden bestaan:-
unwrap
: Het overeenkomende element wordt verwijderd terwijl de inhoud behouden blijft. -
drop
: Het overeenkomende element en de inhoud ervan worden verwijderd.
-
-
@context
: Dit kenmerk wordt gebruikt om een koppeling te maken naar een specifieke omloopregel wanneer meer dan één keuze voor de omloop beschikbaar is. Voorbeeld:li
element kan in of eenol
of eenul
element. -
@commentOut
: Dit kenmerk schakelt de tekstomloop van het doelelement in XML-opmerkingen in, zodat de informatie niet verloren gaat, maar handmatig door de gebruiker kan worden verwerkt. Dit is nuttig als de broninhoud niet kan worden gedwongen om aan de DITA-structuurregels te voldoen.
Problemen AEM hulplijnen oplossen
Nadat u AEM hulplijnen hebt geïnstalleerd en geconfigureerd, kunt u de problemen oplossen.
Referenties valideren
U kunt de opgegeven scripts uitvoeren om de referenties te valideren. Deze scripts kunnen u helpen de verbroken verwijzingen te identificeren en deze vervolgens te repareren of te herstellen.
/bin/fmdita/validatebtree?operation=validate
- rapporten om het even welke gebroken inhoudsverwijzingen maar verhelpt hen niet./bin/fmdita/validatebtree?operation=patch
- geeft een overzicht van de verbroken inhoudsverwijzingen en patches of corrigeert deze.
Script valideren
Voer de volgende stappen uit om de verwijzingen te controleren, gebruikend het validate manuscript beschikbaar in het productpakket:
- Script voor validatie uitvoeren [
/bin/fmdita/validatebtree?operation=validate
] om te controleren of er nieuwe verbroken verwijzingen zijn. - Als het validate manuscript om het even welke fouten meldt, kunt u het herstellen gebruikend het flardmanuscript.
- Registreer de hieronder gegeven details en deel hen indien nodig met uw team van het klantensucces:
-
- Wordt afgedrukt door script voor validatie
- Pakket met "
/content/fmdita/references
" - Eventuele andere vereiste details, afhankelijk van het gerapporteerde scenario
Patchscript
Voer de volgende stappen uit om verbroken verwijzingen te repareren met behulp van het patchscript dat beschikbaar is in het productpakket:
-
Het patchscript uitvoeren
[/bin/fmdita/validatebtree?operation=patch]
om de verbroken verwijzingen te herstellen. De uitvoering van het script neemt een paar minuten in beslag en drukt de logbestanden af terwijl deze worden uitgevoerd. Wanneer de uitvoering is voltooid, wordt de afdruk "Done
" aan het einde.*Opmerking: Het wordt aanbevolen de logbestanden te kopiëren en op te slaan ter referentie.
-
Nadat het patchscript is uitgevoerd, kunt u de volgende controles uitvoeren:
-
- Een nieuw knooppunt controleren "
references_backup_<timestamp>"
is gemaakt op/content/fmdita
- Een nieuw knooppunt controleren "
- Controleer of de referenties zijn gecorrigeerd
Aanmelder
U kunt ook een afzonderlijk logger maken voor de uitvoering van dit script, zoals beschreven in de volgende details:
- Een logger toevoegen aan de klasse "
adobe.fmdita.common.BTreeReferenceValidator
" - Instellen op
DEBUG
In het gemaakte logbestand wordt alle informatie opgenomen die betrekking heeft op de uitvoering van het script. Deze informatie is handig voor het geval de sessietime-outs van de browser worden uitgeschakeld en wordt het script geactiveerd vanuit de browser.