Bijlage id195AD0L60Y4

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.

Script valideren

Voer de volgende stappen uit om de verwijzingen te controleren, gebruikend het validate manuscript beschikbaar in het productpakket:

Patchscript

Voer de volgende stappen uit om verbroken verwijzingen te repareren met behulp van het patchscript dat beschikbaar is in het productpakket:

Aanmelder

U kunt ook een afzonderlijk logger maken voor de uitvoering van dit script, zoals beschreven in de volgende details:

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.

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:

Het InDesign naar DITA-omzettingsproces past de grensregeling als volgt toe:

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:

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.

wrapelement

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:

In het volgende voorbeeld wordt getoond hoe u een fig element van een title en image element:

In het volgende voorbeeld wordt getoond hoe u een title in een table:

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:

Regels voor tekenstijl

De charRule de elementen worden hieronder beschreven :

charRuleelement

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:

Kenmerkregels

Dit element kan een onderliggend element zijn van de volgende elementcontexten:

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:

De kenmerken die worden gebruikt in de attributeRules worden hieronder toegelicht:

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:

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

Zie #id194CG600NY4.

elementRuleselement

In dit overzicht worden alle #id194CGC00SHSelementen.

elementRuleelement

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: