DocumentazioneAEM GuidesDocumentazione di AEM Guides

Migrare contenuti non DITA id181AH0R02HT

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Esperto
  • Amministratore

In questa sezione viene illustrato il processo di migrazione dei documenti non DITA in formato DITA. AEM Guides fornisce la migrazione dalle seguenti origini:

Migrazione di documenti di Microsoft Word id1949B040Z5Z

AEM Guides consente di migrare i documenti Word esistenti (.docx) nei documenti di tipo argomento DITA. È necessario specificare i percorsi delle cartelle di input e di output insieme ad altri parametri e il documento viene convertito in documento DITA. A seconda del contenuto, è possibile disporre di un file .dita e di un file .ditamap.

Per convertire un documento di Word in modo corretto, è necessario che il documento sia ben strutturato. Ad esempio, il documento deve avere un Titolo, seguito da Titolo 1, Titolo 2 e così via. Ciascuna intestazione deve avere un certo contenuto. Se il documento non è ben strutturato, il processo potrebbe non funzionare come previsto.

Per impostazione predefinita, AEM Guides utilizza il framework di trasformazione da Word a DITA (Word2DITA). Questa trasformazione dipende dal file di configurazione mapping stile-tag. Per poter utilizzare correttamente la trasformazione Word2DITA, è necessario prendere in considerazione le seguenti linee guida per la preparazione del documento di Word per la conversione:

NOTE
Se si apportano modifiche al file di configurazione della mappatura stile-tag predefinito, è necessario aggiornare e utilizzare le linee guida di conferma per la mappatura stile aggiornata.

  • Assicurarsi che il documento inizi con un Titolo, che deve essere mappato al titolo della mappa DITA. Inoltre, il Titolo deve essere seguito da alcuni contenuti regolari.

  • Dopo il titolo, dovrebbero essere presenti titolo 1, titolo 2 e così via. Ogni intestazione deve contenere del contenuto. Le intestazioni vengono convertite in nuovi argomenti di tipo Concetto. La gerarchia degli argomenti generati corrisponde ai livelli Titolo nel documento. Ad esempio, Titolo 1 precede Titolo 2 e Titolo 2 precede Titolo 3.

  • Il documento deve avere almeno un contenuto di tipo Titolo.

  • Verificare di non disporre di immagini raggruppate. Se nel documento sono presenti immagini raggruppate, separarle.

  • Rimuovere tutte le intestazioni e i piè di pagina.

  • Gli stili in linea come grassetto, corsivo e sottolineato vengono convertiti in b, i e u elementi.

  • Tutti gli elenchi ordinati e non ordinati vengono convertiti in ol e ul elementi. Questo vale anche per elenchi nidificati, elenchi all’interno di tabelle, note o note a piè di pagina.

  • Tutti i collegamenti ipertestuali vengono convertiti in xref.

  • Il nome del file convertito si basa sul testo dell'intestazione seguito da un numero di file. Il numero di file è un numero sequenziale basato sulla posizione del testo dell'intestazione nel documento. Ad esempio, se il testo di un titolo è "Titolo di esempio" ed è il decimo titolo del documento, il nome file risultante per questo argomento sarà simile a Sample_Heading_10.dita.

Per convertire i documenti di Word esistenti in documenti di tipo argomento DITA, effettuare le seguenti operazioni:

  1. Utilizza Gestione pacchetti per scaricare il file /libs/fmdita/config/w2d_io.xml.

  2. Personalizzare il file w2d_io.xml scaricato.

  3. Aggiungi il file nella seguente posizione nell’archivio Git di Cloud Manager:

    /apps/fmdita/config/w2d_io.xml

    Il file w2d_io.xml contiene i seguenti parametri configurabili:

    • Nell'elemento inputDir specificare il percorso della cartella di input in cui sono disponibili i documenti di Word di origine. Se ad esempio i documenti di Word sono archiviati in una cartella denominata wordtodita nella cartella projects, specificare il percorso come: /content/dam/projects/wordtodita/

    • Nell'elemento outputDir specificare il percorso della cartella di output oppure mantenere il percorso di output predefinito per salvare il documento DITA convertito. Se la cartella di output specificata non esiste in DAM, il flusso di lavoro di conversione crea la cartella di output.

    • Per l'elemento createRev, specificare se creare una nuova versione dell'argomento DITA convertito (true) o meno (false).

    • Nell'elemento s2tMap specificare la posizione del file di mapping contenente i mapping degli stili di documento di Word agli elementi DITA. La mappatura predefinita viene memorizzata nel file che si trova in:

      code language-none 
      /libs/fmdita/word2dita/word-builtin-styles-style2tagmap.xml
      note note
      NOTE
      Per ulteriori informazioni sulla struttura del file word-builtin-styles-style2tagmap.xml e su come personalizzarlo, vedere Style to Tag Mapping nella Guida utente di DITA For Publishers.

    • Nell'elemento props2Propagate specificare le proprietà da passare alla mappa DITA. Questa proprietà è necessaria per passare i metadati predefiniti come dc:title,dc:subject,dam:keywords,dam:category dai metadati del documento alle risorse DITA convertite.

  4. Esegui la pipeline Cloud Manager per distribuire la configurazione aggiornata.

  5. Dopo aver configurato i parametri richiesti nel file w2d_io.xml, accedere all'AEM e aprire l'interfaccia utente di Assets.

  6. Passare alla cartella di input (wordtodita).

  7. Caricare i documenti Word di origine in questa cartella. Per informazioni sul caricamento di contenuto in DAM, vedere Caricare contenuto DITA esistente.

Utilizzando il blocco config /config, puoi definire uno o più blocchi di configurazioni per la conversione. Il flusso di lavoro di conversione viene eseguito e l'output finale sotto forma di argomento DITA viene salvato nella posizione specificata nell'elemento outputDir.

Aggiornamenti di personalizzazione per gli utenti esistenti

Se sei un utente esistente per AEM Guides as a Cloud Service e stai effettuando l’aggiornamento dalla versione di agosto 2021 alle versioni di gennaio 2022 o successive, aggiorna le proprietà specificate non appena vengono spostati pochi file.

NOTE
Questo aggiornamento è applicabile solo se si sta già utilizzando il flusso di lavoro di conversione da Microsoft Word a DITA.
  • Percorso file: /apps/fmdita/config/w2d_io.xml
  • Cambia il valore di <s2tMap> da /apps/dxml/word2dita/word-builtin-styles-style2tagmap.xml a /libs/fmdita/word2dita/word-builtin-styles-style2tagmap.xml
  • Apporta le modifiche necessarie nell’archivio Git di Cloud Manager, in quanto per il servizio cloud tutti i file in /apps vengono sovrapposti tramite Cloud Manager Git.

Migrazione di documenti Adobe InDesign id195AD0B0K5Z

AEM Guides consente di convertire i documenti InDesign. Analogamente a FrameMaker, InDesign consente anche di creare documenti non strutturati e strutturati. I documenti non strutturati utilizzano gli stili di paragrafo e di carattere per formattare il contenuto. Il documento strutturato utilizza gli elementi e gli attributi corrispondenti.

Il processo di conversione richiede la mappatura dei formati di paragrafo e stile di carattere agli elementi DITA pertinenti. Analogamente, in caso di documenti strutturati, il file di mappatura conterrà la mappatura uno-a-uno di elementi e attributi InDesign con elementi e attributi DITA.

Il processo di conversione prevede le seguenti azioni nel back-end:

  • Il file IDML\ (InDesign Markup Language) è stato decompresso in una directory di lavoro.
  • Il file designmap.xml viene letto per individuare i singoli brani InDesign.
  • Tutti i brani vengono uniti in un'unica istanza XML. I brani "vuoti" vengono eliminati.
  • Tutti gli elementi grafici incorporati vengono esportati.
  • Preconversione di strutture standard quali tabelle e immagini in formato DITA.
  • Mappatura di stili o strutture all’output finale in base al file di mappatura.
  • Creazione e convalida di singoli argomenti e file di mappe DITA.
  • Eliminazione dei file temporanei.

In generale, il processo di conversione richiede di preparare i file InDesign per la conversione appendix.md#id195DBF0045Z e preparare il file di mappatura per la migrazione da InDesign a DITA appendix.md#id194AF0003HT, quindi è necessario seguire la procedura specificata per l'esecuzione del processo di conversione.

Per convertire i documenti InDesign esistenti in documenti di tipo argomento DITA, effettuare le seguenti operazioni:

  1. Accedi all’AEM e apri la modalità CRXDE Liti.

  2. Passare al file di configurazione predefinito disponibile nella posizione seguente:

    /libs/fmdita/config/idml2dita_io.xml

  3. Per creare una configurazione personalizzata in base alle tue esigenze, crea un nodo di sovrapposizione della cartella config all'interno del nodo apps.

  4. Copiare i file o le cartelle seguenti dalla cartella libs nella cartella delle app:

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

  5. Passare al file di configurazione disponibile nel nodo apps:

    /apps/fmdita/config/idml2dita_io.xml

  6. Aggiungere la mappatura delle configurazioni presenti nella cartella idml12dita all'interno del file idml2dita_io.xml.

  7. Aggiungi le seguenti proprietà nel file idml2dita_io.xml:

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

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

  8. Creare un nodo di sovrapposizione della cartella config all'interno del nodo apps.

    Configura i seguenti parametri nel file idml2dita_io.xml:

    • Nell'elemento inputDir specificare il percorso della cartella di input in cui sono disponibili i documenti InDesign di origine. Se ad esempio i documenti InDesign sono archiviati in una cartella denominata indesigntodita nella cartella projects, specificare il percorso come: /content/dam/idmlfiles/indesigntodita/

    • Nell'elemento outputDir specificare il percorso della cartella di output oppure mantenere il percorso di output predefinito per salvare il documento DITA convertito. Se la cartella di output specificata non esiste in DAM, il flusso di lavoro di conversione crea la cartella di output.

    • Nell'elemento mapStyle specificare la posizione del file di mapping che contiene i mapping degli stili di documento InDesign agli elementi DITA. La mappatura predefinita viene memorizzata nel file che si trova in:

      code language-none 
      /stmap.adobeidml.xml
      note note
      NOTE
      Per ulteriori informazioni sulla struttura del file stmap.adobeidml.xml e su come personalizzarlo, vedere la sezione appendix.md#id194AF0003HT in Appendice.

  9. Salva il file idml2dita_io.xml.

  10. Dopo aver configurato i parametri richiesti nel file idml2dita_io.xml, accedere all'AEM e aprire l'interfaccia utente di Assets.

  11. Passare alla cartella di input (indesigntodita).

  12. Carica i documenti InDesign di origine in questa cartella. Per informazioni sul caricamento di contenuto in DAM, vedere Caricare contenuto DITA esistente.

Migrazione di documenti XHTML id1949B04L0Y4

AEM Guides consente di convertire i documenti XHTML esistenti in documenti di tipo argomento DITA. È necessario specificare i percorsi delle cartelle di input e di output insieme ad altri parametri e i documenti vengono convertiti in formato DITA. Per convertire i documenti HTML strutturati è possibile utilizzare due metodi:

  • Carica tutti i documenti nella cartella di input oppure
  • Crea un file ZIP di tutti i documenti insieme ai file multimediali e caricalo nella cartella di input. Questo approccio viene generalmente utilizzato per un set di file HTML collegati tra loro ed è disponibile un sommario (index.html). Il file index.html contiene collegamenti a tutti i file HTML del set.

Sia che si caricino tutti i file singolarmente che in un pacchetto ZIP, il processo di conversione crea una mappatura uno-a-uno tra i file HTML e i file DITA risultanti. Ciò significa essenzialmente che è presente un file .dita creato per ciascun file .html nella cartella di input.

Per caricare i documenti in un file ZIP, è necessario considerare i seguenti punti:

  • Tutti gli argomenti a cui si fa riferimento devono trovarsi all'interno del file ZIP.

  • Tutti i file multimediali a cui si fa riferimento devono essere inclusi nei file di argomento utilizzando il collegamento relativo.

  • Crea un file index.html e aggiungi i collegamenti agli argomenti che desideri aggiungere nel sommario. Questo file index.html viene utilizzato per creare il file di mapping DITA. Nel file index.html è inoltre possibile creare un elenco di argomenti nidificati, come illustrato nell'esempio di codice seguente:

    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>

    Ogni tag ul deve avere l'attributo class impostato su book. Analogamente, ogni tag class di li deve essere impostato su topicref.

  • Se utilizzi gli stili in linea, converti gli stili in linea in classi di stile basate su CSS nel file XHTML. Utilizzare quindi la mappatura degli attributi di stile per convertire gli stili basati su classi in attributi DITA outputclass nel file DITA convertito.

    Durante la generazione dell'output di HTML o del sito AEM da questi file DITA, è possibile utilizzare gli attributi outputclass per applicare la classe di stile su HTML o sito AEM generato in modo che corrisponda al contenuto HTML di origine.

Oltre alle considerazioni per la creazione del file ZIP, il documento XHTML deve anche essere ben strutturato. Ad esempio, il documento deve avere un Titolo, seguito da Intestazione 1, Intestazione 2 e così via. Ciascuna intestazione deve avere un certo contenuto. Se il documento non è ben strutturato, il processo di migrazione potrebbe non funzionare come previsto.

Per convertire un documento XHTML esistente in argomento DITA, effettuare le seguenti operazioni:

  1. Utilizza Gestione pacchetti per scaricare il file /libs/fmdita/config/h2d_io.xml.

  2. Personalizzare il file h2d_io.xml scaricato.

  3. Aggiungi il file nella seguente posizione nell’archivio Git di Cloud Manager:

    /apps/fmdita/config/h2d_io.xml

    Il file h2d_io.xml contiene i seguenti parametri configurabili:

    • Nell'elemento inputDir specificare il percorso della cartella di input in cui sono disponibili i documenti XHTML di origine. Ad esempio, se i documenti XHTML sono archiviati in una cartella denominata xhtmltodita nella cartella projects, specificare il percorso come: /content/dam/projects/xhtmltodita/

    • Nell'elemento outputDir, specificare il percorso della cartella di output o mantenere il percorso di output predefinito. Se la cartella di output specificata non esiste in DAM, il flusso di lavoro di conversione crea la cartella di output.

    • Per l'elemento createRev, specificare se creare una nuova versione dell'argomento DITA convertito (true) o meno (false).

  4. Esegui la pipeline Cloud Manager per distribuire la configurazione aggiornata.

  5. Dopo aver configurato i parametri richiesti nel file w2d_io.xml, accedere all'AEM e aprire l'interfaccia utente di Assets.

  6. (Facoltativo) È inoltre possibile aggiungere la sezione dei collegamenti correlati ai documenti convertiti. Per abilitare questa funzione, effettua le seguenti operazioni:

    note note
    NOTE
    Per impostazione predefinita, la sezione dei collegamenti correlati non viene creata nei documenti convertiti.

    1. Utilizza Gestione pacchetti per scaricare il file /libs/fmdita/html2dita/h2d.xsl.

    2. Cerca il seguente parametro:

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

    3. Impostare il valore del parametro precedente su true().

    4. Esegui il commit del file aggiornato nella seguente posizione nell’archivio Git di Cloud Manager:

      /libs/fmdita/html2dita/

    5. Esegui la pipeline Cloud Manager per distribuire la configurazione aggiornata.

  7. Passare alla cartella di input (xhtmltodita).

  8. Carica i documenti XHTML di origine in questa cartella. Per informazioni sul caricamento di contenuto in DAM, vedere Caricare contenuto DITA esistente.

Utilizzando il blocco <config> </config>, puoi definire uno o più blocchi di configurazioni per la conversione. Il flusso di lavoro di conversione viene eseguito e l'output finale sotto forma di argomento DITA viene salvato nella posizione specificata nell'elemento outputDir.

Migrazione di documenti di FrameMaker non strutturati id1949B050VUI

AEM Guides consente di convertire i documenti di FrameMaker non strutturati esistenti (.fm e .book) in documenti DITA. Il primo passo è quello di creare mappature di stile utilizzando il FrameMaker e salvare tali impostazioni in un file con estensione sts. Quindi, se si utilizza DITA personalizzato, è possibile associare gli elementi personalizzati ai formati del FrameMaker di origine nel file ditaElems.xml. Ad esempio, se hai creato un elemento personalizzato denominato impnote per gestire tutte le note importanti, puoi definire tale elemento personalizzato nel file ditaElems.xml. Una volta definito questo elemento personalizzato, AEM Guides non genererà un errore durante la conversione del documento di FrameMaker contenente l'elemento impnote.

Inoltre, se si desidera specificare alcuni attributi aggiuntivi con l'elemento DITA personalizzato o valido, è possibile definirli nel file style2attrMap.xml. È ad esempio possibile specificare l'attributo type con il valore di important da passare con l'elemento impnote. Queste informazioni aggiuntive possono essere specificate nel file style2attrMap.xml.

Oltre a specificare

Per convertire i documenti di FrameMaker non strutturati esistenti in formato DITA, effettuare le seguenti operazioni:

  1. Creare le mappature di stile nel FrameMaker e salvare tali impostazioni in un file con estensione sts.

  2. Utilizza Gestione pacchetti per scaricare il file /libs/fmdita/config/ditaElems.xml.

  3. Se si dispone di elementi DITA personalizzati, definirli nel file ditaElems.xml disponibile nel percorso seguente:

    /libs/fmdita/config/ditaElems.xml

  4. Crea una copia del file ditaElems.xml nel percorso seguente nell’archivio Git di Cloud Manager:

    /apps/fmdita/config/ditaElems.xml

  5. Passare al file di configurazione disponibile nel nodo apps:

    /apps/fmdita/config/ditaElems.xml

    Il file ditaElems.xml contiene un singolo parametro configurabile:

    • Nel parametro elem specificare il nome dell'elemento personalizzato che si desidera utilizzare nei documenti DITA convertiti. Questo elemento viene trasmesso così come è nei documenti DITA generati.

  6. Se si desidera specificare attributi aggiuntivi, definirli nel file style2attrMap.xml disponibile nel percorso seguente:

    /libs/fmdita/config/style2attrMap.xml

  7. Creare un nodo di sovrapposizione della cartella config all'interno del nodo apps.

  8. Passare al file di configurazione disponibile nel nodo apps:

    /apps/fmdita/config/style2attrMap.xml

    Il file style2attrMap.xml contiene i seguenti parametri configurabili:

    • Nel parametro fmStyle specificare il formato di origine utilizzato nel documento di FrameMaker che si desidera mappare.

    • Nell'elemento ditaAttr specificare l'attributo DITA che si desidera mappare con il formato di origine.

    • Nell'elemento ditaVal specificare il valore per l'attributo mappato. Se non si dispone di alcun valore, è possibile lasciare vuota questa voce.

  9. Salva il file style2attrMap.xml.

  10. Dopo aver configurato i parametri richiesti nel file style2attrMap.xml, accedere all'AEM e aprire l'interfaccia utente di Assets.

  11. Passare al documento di FrameMaker che si desidera convertire e fare clic su di esso.

    Viene visualizzata la console Mappa DITA con l'elenco dei predefiniti di output disponibili per generare l'output.

  12. Selezionate il formato di output DITA e configurate i parametri richiesti.

    note note
    NOTE
    È necessario utilizzare lo stesso file di impostazioni (.sts) creato in FrameMaker. Inoltre, specifica il Nome impostazioni e il Percorso di destinazione.

  13. Fai clic sull'icona Genera per avviare il processo di generazione dell'output.

Utilizzando il blocco <attrMap> </attrMap>, puoi definire uno o più blocchi di configurazioni per la conversione. A seconda del contenuto, come file convertiti potrebbero essere presenti un file .dita e un file .ditamap.

Migrare qualsiasi altro documento strutturato id1949B0590YK

AEM Guides consente di convertire i documenti strutturati esistenti in documenti DITA validi. È necessario specificare i percorsi delle cartelle di input e di output, il percorso del file di trasformazione, l'estensione con cui viene salvato l'output finale e se è necessaria o meno una nuova versione del documento.

Per convertire i documenti strutturati esistenti in formato DITA, effettuare le seguenti operazioni:

  1. Utilizza Gestione pacchetti per scaricare il file /libs/fmdita/config/XSLConfig.xml.

  2. Crea una copia del file XSLConfig.xml nel percorso seguente nell’archivio Git di Cloud Manager:

    /apps/fmdita/config/XSLConfig.xml

    Il file XSLConfig.xml contiene i seguenti parametri configurabili:

    • Nell'elemento inputDir specificare il percorso della cartella di input in cui sono disponibili i documenti strutturati di origine. Ad esempio, se i documenti strutturati sono archiviati in una cartella denominata xsltodita nella cartella projects, specificare il percorso come: /content/dam/projects/xsltodita/

    • Nell'elemento outputDir, specificare il percorso della cartella di output o mantenere il percorso di output predefinito. Se la cartella di output specificata non esiste in DAM, il flusso di lavoro di conversione crea la cartella di output.

    • Nell'elemento xslFolder specificare il percorso della cartella in cui sono archiviati i file di trasformazione XSL.

    • Nell'elemento xslPath specificare il percorso del file XSL primario utilizzato per avviare il processo di conversione.

    • Nell'elemento outputExt specificare le estensioni del file di output finale creato dal flusso di trasformazione.

    • Per l'elemento createRev, specificare se creare una nuova versione dell'argomento DITA convertito (true) o meno (false).

  3. Salva il file XSLConfig.xml.

  4. Dopo aver configurato i parametri richiesti nel file XSLConfig.xml, accedere all'AEM e aprire l'interfaccia utente di Assets.

  5. Passare alla cartella di input (xsltodita).

  6. Carica i documenti strutturati di origine in questa cartella. Per informazioni sul caricamento di contenuto in DAM, vedere Caricare contenuto DITA esistente.

Utilizzando il blocco <config> </config>, puoi definire uno o più blocchi di configurazioni per la conversione. Il flusso di lavoro di conversione viene eseguito e l'output finale sotto forma di argomento DITA viene salvato nella posizione specificata nell'elemento outputDir.

Argomento padre: ​​ Esegui migrazione contenuto esistente

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