DocumentazioneAEM GuidesDocumentazione di AEM Guides

Migrare contenuti non DITA id181AH0R02HT

Last update: Wed Feb 11 2026 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 ad 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 eseguendo 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) di InDesign Markup Language è decompresso in una directory di lavoro.
  • Il file designmap.xml viene letto per individuare le singole storie di 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 ad AEM e apri la modalità CRXDE Lite.

  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 per gli 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 ad 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 li di class 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 HTML o AEM Site da questi file DITA, gli attributi outputclass possono essere utilizzati per applicare la classe di stile sul sito HTML o 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 ad 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 FrameMaker non strutturati id1949B050VUI

Per convertire i contenuti Adobe FrameMaker non strutturati (con estensione fm e book) in DITA strutturata, è possibile utilizzare il meccanismo di tabella di conversione di FrameMaker. Il processo si concentra sulla valutazione del contenuto esistente, utilizzando un approccio basato su modelli, e sulla mappatura degli stili di FrameMaker a DITA tramite tabelle di conversione. Per ulteriori dettagli, visualizzare Migrazione della documentazione tecnica da non strutturata a DITA in Adobe FrameMaker.

Dopo la conversione, è possibile migrare il contenuto strutturato in AEM Guides. Per ulteriori dettagli, visualizzare Carica contenuto DITA esistente.

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