Appendice id195AD0L60Y4

Prepara i file InDesign per la conversione id195DBF0045Z

L'InDesign offre agli autori un set completo di funzioni per la creazione di documenti attraenti e complessi. Spesso ciò significa che le varie parti di un documento vengono posizionate sulla pagina visivamente, ma senza alcun tentativo di fornire un flusso tra tali cornici di testo. Se l'ordine di lettura '1}' delle cornici di testo non è definito, il file IDML conterrà brani che potrebbero non seguire alcun ordine significativo. Il risultato finale sarà uno o più argomenti DITA con paragrafi, tabelle e immagini in ordine casuale.

Anche se è possibile modificare il contenuto DITA in un ordine ragionevole in un editor DITA, è molto più semplice correggere il file InDesign prima di creare il file IDML. Questa operazione può essere eseguita senza modificare l'aspetto del documento di origine. Ha anche il vantaggio di rendere accessibile il documento di origine definendo correttamente l'ordine di lettura.

Threading cornici di testo

L'InDesign utilizza il termine 'threading' per il processo di collegamento di un frame a un altro. Per ulteriori dettagli sulle cornici di testo di threading, vedi l'argomento Threading text nella documentazione di InDesign.

Frame sovrapposti

Alcuni documenti InDesign utilizzano fotogrammi sovrapposti non filettati per motivi di layout. Potrebbe essere molto difficile unire questo contenuto al thread principale. L'opzione migliore potrebbe essere quella di modificare il risultato nell'ambiente DITA.

Storie InDesign

Ogni flusso concatenato di contenuto in un documento InDesign è denominato "brano". Per ottenere i migliori risultati, si consiglia di mantenere limitato il numero di storie. Tuttavia, alcune parti del documento potrebbero non essere necessarie nell'output DITA. Ad esempio, i piè di pagina sono raramente necessari, ma possono essere visualizzati nel mezzo di un argomento se non vengono gestiti con attenzione.

Il modo più semplice per escludere il testo non richiesto nel documento è quello di assegnargli un Tag paragrafo speciale che viene utilizzato solo per il contenuto indesiderato. Ad esempio, invece di riutilizzare un [Paragrafo base] per il piè di pagina, crea un tag Piè di pagina dedicato. Quindi nel file MapStyle imposta semplicemente i paragrafi Piè di pagina da eliminare in questo modo:

<paraRule style="Footer" local="0" refactor="drop">
   <attributeRules createID="false"/>
</paraRule>

Mappatura ai doctype DITA

È essenziale che il documento di origine disponga di almeno uno stile di paragrafo o un elemento che possa contrassegnare l'inizio di un argomento. Nei documenti viene in genere utilizzato Titolo1 come nome dei titoli di primo livello del documento. È quindi possibile creare una mappatura da tale stile a un doctype DITA specifico. Se il documento è ben organizzato e l'utilizzo di Intestazione1 è costante, si otterranno buoni risultati.

Più tipi di documenti DITA

Se alcuni dei paragrafi Heading1 devono essere convertiti in doctype DITA diversi, duplicare lo stile di paragrafo in InDesign. Assegna a questi stili un nome facile da riconoscere, ad esempio Intestazione1_genAttività o Intestazione1_risoluzione dei problemi, a seconda delle necessità. Quindi, impostate il file mapStyle come mostrato di seguito:

<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>

Documenti InDesign strutturati

L'InDesign ha una relazione debole con XML. Sebbene un documento possa includere una DTD XML e il brano principale possa essere valido rispetto a tale DTD, è anche possibile creare documenti ibridi in cui parte del contenuto è XML, ma non è inclusa alcuna DTD. Questi sono i casi indesiderati per una conversione riuscita in DITA. Se un documento contiene parti XML, provare a salvare l'output in formato XML e verificare se i risultati sono accettabili. In caso contrario, il contenuto DITA includerà anche contenuto non valido o potrebbe non riuscire completamente.

Formattazione tabella

La conversione dalle regole di formattazione della tabella InDesign alla formattazione della tabella equivalente in DITA è un processo complesso. Ciò è dovuto alle funzioni di formattazione avanzate disponibili nei file di origine rispetto alle opzioni di base fornite dal modello di tabella Oasis (CALS) utilizzato in DITA. Viene fornito l'allineamento verticale e orizzontale del testo e fornisce risultati simili, anche se il testo giustificato è sempre giustificato in base alla direzione del testo, mentre l'InDesign consente l'allineamento giustificato a sinistra e a destra.

Anche in questo caso, la gestione InDesign dei separatori di colonna e di riga è molto più efficiente delle opzioni di base del modello di tabella Oasis. InDesign fornisce quattro bordi di cella: tipo di bordo (solido o motivo), spessore del bordo, colore del bordo, tinta del bordo, colore di distanza del bordo e tinta di distanza del bordo. È necessario eseguire il mapping di tutti questi elementi ai bordi destro e inferiore di ogni cella (elemento di immissione) in cui le uniche opzioni disponibili sono 0 o 1: nascondere il bordo o visualizzarlo.

Le regole di confine in InDesign possono essere applicate ai seguenti livelli:

Il processo di conversione da InDesign a DITA applica la regola del bordo nel modo seguente:

Modelli alternativi

Gli stili di tabella InDesign consentono di alternare le regolazioni di colonne e celle. Anche se questa funzione è supportata per la conversione, i risultati saranno evidenti solo quando un gruppo di pattern è mappato per mostrare la regola (1) e l'altro gruppo di pattern è mappato per nascondere la regola (0).

Preparare il file di mappatura per la migrazione da InDesign a DITA id194AF0003HT

La conversione DITA corretta richiede un file di mapping corrispondente al contenuto del documento di origine. Per i documenti InDesign non strutturati, è necessario mappare tutti gli stili di paragrafo e di carattere disponibili. Per i documenti InDesign strutturati XML è necessario mappare tutti gli elementi della DTD associata.

I file di mappatura per i documenti InDesign non strutturati e strutturati sono diversi. Ciò è dovuto ai requisiti di elaborazione più complessi per la conversione del contenuto sorgente non strutturato in DITA.

Di seguito è riportato un esempio di file di mappatura:

<?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>

Il file di mapping è un file XML con una struttura semplice che elenca tutti gli stili di paragrafo di origine e i codici di stile dei caratteri. Di seguito sono illustrati i contenuti del file:

Mappatura stili

Nell'elemento styleMap è possibile specificare due attributi facoltativi: @map_date e @map_version per la registrazione della versione del file di mapping.

Tipo di documento

L'elemento doctypes elenca le mappature di argomenti e mappe DITA supportate.

Mappa le regole di paragrafo del tipo di documento

Elemento mapDoctypeParaRule obbligatorio. Gli attributi di questo elemento non devono essere modificati perché l'elemento radice dell'XML di origine è sempre mappato all'elemento radice map della mappa DITA.

Regola paragrafo tipo documento

Elemento doctypeParaRule obbligatorio. Questo offre al processo di conversione un modo per identificare l’inizio di un nuovo argomento. Normalmente l'attributo @style viene utilizzato da solo con l'attributo @local impostato su 0. Tuttavia, se sono sempre presenti sostituzioni di formattazione locali per lo stile scelto, dovrai aggiungere una regola per ogni stile e le relative sostituzioni locali. Questo è semplice da riconoscere nel file di mappatura generato dove sarebbe possibile trovarlo o simile:

<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>

Nell'esempio precedente sono presenti due elementi paraRule per @style = "Heading1". È sufficiente creare un elemento doctypeParaRule equivalente con l'attributo @mapToDoctype impostato come richiesto.

Gli attributi utilizzati in doctypeParaRule sono illustrati di seguito:

Regole di wrapping degli elementi

Le regole di ritorno a capo degli elementi definiscono i modi in cui gli elementi del documento in ingresso vengono racchiusi o spostati in un elemento predefinito in base a un insieme di valori di attributo.

wrapelemento

Questo è un elemento facoltativo. L'elemento wrap elenca gli elementi che verranno racchiusi o spostati. Il wrapping viene in genere utilizzato quando a una serie di elementi deve essere assegnato un elemento padre comune. Ad esempio, più elementi li sono racchiusi in un elemento ol. Inoltre, wrap può essere utilizzato per spostare elementi quali titoli per figure e tabelle.

Gli attributi utilizzati in wrap sono illustrati di seguito:

Nell'esempio seguente viene illustrato come creare un elemento fig da un elemento title e un elemento image:

Nell'esempio seguente viene illustrato come spostare title in table:

Regole di stile paragrafo

Gli elementi <paragraphStyleRule> sono descritti di seguito:

paraRuleelemento

Elemento paraRule obbligatorio. Specifica le regole di mapping per tutti gli stili di paragrafo. In un documento InDesign, tutto il testo è contenuto all'interno di una sottostruttura di Stili di paragrafo, anche i paragrafi senza alcuno stile sono denominati [No paragraph style]. Le parentesi quadre indicano un nome di stile InDesign incorporato.

Gli attributi utilizzati in paraRule sono illustrati di seguito:

Regole stile carattere

Gli elementi charRule sono descritti di seguito:

charRuleelemento

Questo è un elemento facoltativo.

Regole di mappatura per tutti gli stili di carattere. In un documento InDesign tutto il testo è contenuto all'interno di elementi figlio di Stili di carattere.

Gli attributi utilizzati in charRule sono illustrati di seguito:

Regole attributo

Questo elemento può essere figlio dei contesti di elemento seguenti:

Lo scopo delle regole di attributo è quello di gestire gli attributi per gli elementi corrispondenti.

A seconda del contesto, nell'elemento attributeRules sono disponibili i seguenti attributi:

Gli attributi utilizzati in attributeRules sono illustrati di seguito:

Codici di formattazione locali

In qualsiasi documento InDesign, gli stili di paragrafo e di carattere possono avere diverse centinaia di sostituzioni di formattazione. La maggior parte di queste proprietà non fornisce alcun ruolo utile nel processo di conversione. Tuttavia, abbiamo identificato un set principale di funzioni di formattazione che influiscono sulla semantica del documento e devono influenzare il processo di conversione.

Gli attributi @local vengono presentati come un formato delimitato speciale in cui otto campi vengono forniti insieme a un prefisso per mostrare il tipo di sostituzione della formattazione. I campi dei codici di formattazione sono elencati di seguito:

L'uso attento di questa funzione consente di perdere la formattazione locale e può contribuire a migliorare la qualità di un trasferimento da contenuti formattati a DITA. Questo esempio può essere risolto in corsivo, testo 16 pt in un elenco puntato: p[Italic|16|-|-|-|b|-|-].

Mappatura struttura

Il file di mapping della struttura è simile al file di mapping degli stili con una struttura semplice che elenca tutti gli elementi di origine e i tipi di attributi rilevanti. Per la registrazione della versione del file di mapping da utilizzare vengono forniti due attributi, @map_date e @map_version.

Tipo di documento

L'elemento doctypes elenca le mappature di argomenti e mappe DITA supportate.

Mappa le regole degli elementi di tipo documento

Elemento mapDoctypeElemRule obbligatorio. Gli attributi di questo elemento non devono essere modificati perché l'elemento radice dell'XML di origine è sempre mappato all'elemento radice map della mappa DITA.

Regole di wrapping degli elementi

elementRuleselemento Elenca tutti gli elementi.

elementRuleelemento L'elemento elementRule è obbligatorio. Si tratta delle regole di mappatura per tutti gli elementi sorgente. Sebbene un documento InDesign contenga elementi di stile non strutturati, questi vengono ignorati per i contenuti strutturati a meno che l'elaborazione 'modalità ibrida' non sia abilitata.

Gli attributi utilizzati in elementRule sono illustrati di seguito:

Risoluzione dei problemi di AEM Guides

Dopo aver installato e configurato AEM Guides, puoi risolvere i problemi.

Convalida riferimenti

Puoi eseguire gli script forniti per convalidare i riferimenti. Questi script possono essere utili per identificare i riferimenti interrotti e quindi applicarvi patch o correggerli.

Convalida script

Per controllare i riferimenti, esegui i seguenti passaggi utilizzando lo script di convalida disponibile nel pacchetto di prodotto:

Script patch

Per applicare la patch ai riferimenti interrotti, esegui i passaggi seguenti utilizzando lo script di patch disponibile nel pacchetto del prodotto:

Logger

Puoi anche creare un logger separato per questa esecuzione dello script, in base ai dettagli riportati di seguito:

Il file di registro creato registra tutte le informazioni relative all’esecuzione dello script ed è utile nel caso in cui si verifichino timeout nella sessione del browser, durante l’attivazione dello script dal browser.