DocumentaçãoAEM GuidesDocumentação do AEM Guides

Migrar conteúdo não DITA id181AH0R02HT

Last update: Fri Jul 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • undefined
  • undefined

Esta seção orienta você durante o processo de migração para migrar documentos não-DITA para o formato DITA. O AEM Guides fornece a migração das seguintes fontes:

Migrar documentos do Microsoft Word id1949B040Z5Z

O AEM Guides permite migrar seus documentos existentes do Word (.docx) para documentos do tipo de tópico DITA. Você precisa especificar os locais das pastas de entrada e saída juntamente com outros parâmetros e o documento é convertido em documento DITA. Dependendo do conteúdo, você pode ter um arquivo .dita e um arquivo .ditamap.

Para converter um documento do Word com êxito, o documento deve estar bem estruturado. Por exemplo, seu documento deve ter um Título, seguido de Título 1, Título 2, e assim por diante. Cada um dos cabeçalhos deve ter algum conteúdo. Se o documento não estiver bem estruturado, o processo poderá não funcionar conforme esperado.

Por padrão, o AEM Guides usa a estrutura de transformação Word para DITA (Word2DITA). Esta transformação depende do arquivo de configuração mapeamento de estilo para marca. Para usar a transformação do Word2DITA com sucesso, você deve considerar as seguintes diretrizes para preparar seu documento do Word para conversão:

NOTE
Se você fizer alterações no arquivo de configuração do mapeamento de estilo para tag padrão, será necessário atualizar e usar as diretrizes que confirmam o mapeamento de estilo atualizado.

  • Verifique se o documento começa com um Título; esse Título é mapeado para o título do mapa DITA. Além disso, o Título deve ser seguido de algum conteúdo regular.

  • Depois do Título, deve haver Cabeçalho 1, Cabeçalho 2 e assim por diante. Cada cabeçalho deve conter conteúdo. Os Títulos são convertidos em novos tópicos do tipo Conceito. A hierarquia dos tópicos gerados é de acordo com os níveis de Cabeçalho no documento, por exemplo, o Cabeçalho 1 precederá o Cabeçalho 2 e o Cabeçalho 2 precederá o conteúdo do Cabeçalho 3.

  • O documento deve ter pelo menos um conteúdo do tipo Cabeçalho.

  • Certifique-se de que você não tenha imagens agrupadas. Caso tenha agrupado imagens no documento, desagrupe todas essas imagens.

  • Remova todos os cabeçalhos e rodapés.

  • Estilos embutidos como negrito, itálico e sublinhado são convertidos em elementos b, i e u.

  • Todas as listas ordenadas e não ordenadas são convertidas em elementos ol e ul. Isso também se aplica a listas aninhadas, listas em tabelas, notas ou notas de rodapé.

  • Todos os hiperlinks foram convertidos em xref.

  • O nome de arquivo dos arquivos convertidos é baseado no texto do cabeçalho seguido por um número de arquivo. O número do arquivo é um número sequencial baseado na posição do texto do cabeçalho no documento. Por exemplo, se um texto de cabeçalho for "Exemplo de cabeçalho" e estiver no décimo cabeçalho do documento, o nome de arquivo resultante para esse tópico será semelhante a Sample_Heading_10.dita.

Execute as seguintes etapas para converter documentos existentes do Word em documento do tipo de tópico DITA:

  1. Faça logon no AEM e abra o modo CRXDE Lite.

  2. Navegue até o arquivo de configuração padrão disponível no seguinte local:

    /libs/fmdita/config/w2d_io.xml

  3. Crie um nó de sobreposição da pasta config no nó apps.

  4. Navegue até o arquivo de configuração disponível no nó apps:

    /apps/fmdita/config/w2d_io.xml

    O arquivo w2d_io.xml contém os seguintes parâmetros configuráveis:

    • No elemento inputDir, especifique o local da pasta de entrada em que os documentos do Word de origem estão disponíveis. Por exemplo, se seus documentos do Word estiverem armazenados em uma pasta chamada wordtodita na pasta projects, especifique o local como: /content/dam/projects/wordtodita/

    • No elemento outputDir, especifique o local da pasta de saída ou mantenha o local de saída padrão para salvar o documento DITA convertido. Se a pasta de saída especificada não existir no DAM, o fluxo de trabalho de conversão criará a pasta de saída.

    • Para o elemento createRev, especifique se uma nova versão do tópico DITA convertido deve ser criada (true) ou não (false).

    • No elemento s2tMap, especifique o local do arquivo de mapa que contém mapeamentos para estilos de documento do Word para elementos DITA. O mapeamento padrão é armazenado no arquivo localizado em:

      code language-xml 
      /libs/fmdita/word2dita/word-builtin-styles-style2tagmap.xml
      note note
      NOTE
      Para obter mais informações sobre a estrutura do arquivo word-builtin-styles-style2tagmap.xml e como personalizá-lo, consulte Style to Tag Mapping no Guia do Usuário do DITA For Publishers.

    • No elemento props2Propagate, especifique as propriedades que devem ser passadas para o mapa DITA. Essa propriedade é necessária para transmitir os metadados padrão, como dc:title,dc:subject,dam:keywords,dam:category dos metadados do documento para ativos DITA convertidos.

  5. Salve o arquivo w2d_io.xml.

  6. Depois de configurar os parâmetros necessários no arquivo w2d_io.xml, faça logon no AEM e abra a interface do usuário do Assets.

  7. Navegue até o local da pasta de entrada (wordtodita).

  8. Faça upload dos documentos de origem do Word para esta pasta. Para obter informações sobre como carregar conteúdo no DAM, consulte Carregar conteúdo DITA existente.

Usando o bloco config /config, você pode definir um ou vários blocos de configurações para conversão. O fluxo de trabalho de conversão é executado e a saída final na forma de um tópico DITA é salva no local especificado no elemento outputDir.

Migrar documentos do Adobe InDesign id195AD0B0K5Z

O AEM Guides permite converter documentos do InDesign. Semelhante ao FrameMaker, o InDesign também permite criar documentos não estruturados e estruturados. Os documentos não estruturados usam os estilos de parágrafo e caractere para formatar o conteúdo. O documento estruturado usa elementos e seus atributos correspondentes.

O processo de conversão requer o mapeamento dos formatos de estilo de parágrafo e caractere para elementos DITA relevantes. Da mesma forma, no caso de documentos estruturados, o arquivo de mapeamento conterá mapeamento de um para um de elementos e atributos de InDesign com elementos e atributos DITA.

O processo de conversão envolve as seguintes ações no back-end:

  • O arquivo InDesign Markup Language (IDML) está desempacotado em um diretório de trabalho.
  • O arquivo designmap.xml é lido para localizar as matérias de InDesign individuais.
  • Todas as histórias são mescladas em uma única instância XML, as histórias "vazias" são descartadas.
  • Todos os gráficos incorporados são exportados.
  • Pré-conversão de estruturas padrão, como tabelas e gráficos, no formato DITA.
  • Mapeamento de estilo ou estrutura para saída final com base no arquivo de mapeamento.
  • Criação e validação de tópicos e arquivos de mapa DITA individuais.
  • Exclusão de arquivos temporários.

De maneira geral, o processo de conversão requer que você Prepare arquivos de InDesign para conversão e Prepare o arquivo de mapeamento para migração do InDesign para o DITA. Em seguida, você precisa seguir o procedimento fornecido para executar o processo de conversão.

Execute as seguintes etapas para converter seus documentos do InDesign existentes em documento do tipo de tópico DITA:

  1. Faça logon no AEM e abra o modo CRXDE Lite.

  2. Navegue até o arquivo de configuração padrão disponível no seguinte local:

    /libs/fmdita/config/idml2dita_io.xml

  3. Crie um nó de sobreposição da pasta config no nó apps.

  4. Navegue até o arquivo de configuração disponível no nó apps:

    /apps/fmdita/config/idml2dita_io.xml

    Configure os seguintes parâmetros no arquivo idml2dita_io.xml:

    • No elemento inputDir, especifique o local da pasta de entrada em que seus documentos de InDesign de origem estão disponíveis. Por exemplo, se os documentos do InDesign estiverem armazenados em uma pasta chamada indesigntodita na pasta projects, especifique o local como: /content/dam/idmlfiles/indesigntodita/

    • No elemento outputDir, especifique o local da pasta de saída ou mantenha o local de saída padrão para salvar o documento DITA convertido. Se a pasta de saída especificada não existir no DAM, o fluxo de trabalho de conversão criará a pasta de saída.

    • No elemento mapStyle, especifique o local do arquivo de mapa que contém mapeamentos para estilos de documento do InDesign para elementos DITA. O mapeamento padrão é armazenado no arquivo localizado em:

      code language-xml 
      /stmap.adobeidml.xml
      note note
      NOTE
      Para obter mais informações sobre a estrutura do arquivo stmap.adobeidml.xml e como personalizá-la, consulte a seção Preparar o arquivo de mapeamento para a migração do InDesign para o DITA no Apêndice.

  5. Salve o arquivo idml2dita_io.xml.

  6. Depois de configurar os parâmetros necessários no arquivo idml2dita_io.xml, faça logon no AEM e abra a interface do usuário do Assets.

  7. Navegue até o local da pasta de entrada (indesigntodita).

  8. Faça upload dos documentos do InDesign de origem para esta pasta. Para obter informações sobre como carregar conteúdo no DAM, consulte Carregar conteúdo DITA existente.

Migrar documentos XHTML id1949B04L0Y4

O AEM Guides permite converter documentos XHTML existentes em documentos do tipo de tópico DITA. Você precisa especificar os locais das pastas de entrada e saída juntamente com outros parâmetros e os documentos são convertidos no formato DITA. Há dois métodos que você pode usar para converter seus documentos HTML estruturados:

  • Fazer upload de todos os documentos para a pasta de entrada, ou
  • Crie um ZIP de todos os documentos junto com os arquivos de mídia e faça upload deles para a pasta de entrada. Essa abordagem geralmente é usada para um conjunto de arquivos HTML que estão vinculados entre si e há um índice (index.html). O arquivo index.html contém links para todos os arquivos HTML no conjunto.

Quer você carregue todos os arquivos individualmente ou em um ZIP, o processo de conversão cria um mapeamento um para um entre os arquivos HTML e os arquivos DITA resultantes. Isso significa essencialmente que há um arquivo .dita criado para cada arquivo .html na pasta de entrada.

Os seguintes pontos devem ser considerados para fazer upload de documentos em um arquivo ZIP:

  • Todos os tópicos referenciados devem ser colocados no arquivo ZIP.

  • Todos os arquivos de mídia referenciados devem ser referenciados nos arquivos de tópico usando o link relativo.

  • Crie um arquivo index.html e adicione links para os tópicos que deseja adicionar ao índice. Esse arquivo index.html é usado para criar o arquivo de mapa DITA. No arquivo index.html, você também pode criar listagens de tópicos aninhados como mostrado na seguinte amostra de código:

    code language-xml 
    <?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>

    Observe que toda marca ul deve ter o atributo class definido como book. Da mesma forma, cada class de tag de li deve ser definido como topicref.

  • Se você usar estilos em linha, converta os estilos em linha em classes de estilo baseadas em CSS no arquivo XHTML. Em seguida, use o mapeamento style-attribute para converter esses estilos baseados em classes para o atributo DITA outputclass no arquivo DITA convertido.

    Ao gerar saída de HTML ou site AEM desses arquivos DITA, os atributos outputclass podem ser usados para aplicar a classe de estilo no HTML ou site AEM gerado para corresponder ao conteúdo HTML de origem.

Além das considerações para a criação do arquivo ZIP, o documento XHTML também deve ser bem estruturado. Por exemplo, seu documento deve ter um Título, seguido por Cabeçalho 1, Cabeçalho 2 e assim por diante. Cada um dos cabeçalhos deve ter algum conteúdo. Se o documento não estiver bem estruturado, o processo de migração poderá não funcionar conforme esperado.

Para converter o documento XHTML existente em um tópico DITA, execute as seguintes etapas:

  1. Faça logon no AEM e abra o modo CRXDE Lite.

  2. Navegue até o arquivo de configuração padrão disponível no seguinte local:

    /libs/fmdita/config/h2d_io.xml

  3. Crie um nó de sobreposição da pasta config no nó apps.

  4. Navegue até o arquivo de configuração disponível no nó apps:

    /apps/fmdita/config/h2d_io.xml

    O arquivo h2d_io.xml contém os seguintes parâmetros configuráveis:

    • No elemento inputDir, especifique o local da pasta de entrada em que os documentos XHTML de origem estão disponíveis. Por exemplo, se seus documentos XHTML estiverem armazenados em uma pasta chamada xhtmltodita na pasta projects, especifique o local como: /content/dam/projects/xhtmltodita/

    • No elemento outputDir, especifique o local da pasta de saída ou mantenha o local de saída padrão. Se a pasta de saída especificada não existir no DAM, o fluxo de trabalho de conversão criará a pasta de saída.

    • Para o elemento createRev, especifique se uma nova versão do tópico DITA convertido deve ser criada (true) ou não (false).

  5. Salve o arquivo h2d_io.xml.

  6. Depois de configurar os parâmetros necessários no arquivo h2d_io.xml, faça logon no AEM e abra a interface do usuário do Assets.

  7. (Opcional) Você também pode adicionar a seção de links relacionados aos documentos convertidos. Execute as seguintes etapas para ativar esse recurso:

    note note
    NOTE
    Por padrão, a seção de links relacionados não é criada nos documentos convertidos.

    1. Navegue até o arquivo h2d.xsl no seguinte local:

      /libs/fmdita/html2dita/

    2. Procure o seguinte parâmetro:

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

    3. Defina o valor do parâmetro acima como true().

    4. Salvar e fechar o arquivo.

  8. Navegue até o local da pasta de entrada (xhtmltodita).

  9. Faça upload dos documentos XHTML de origem para esta pasta. Para obter informações sobre como carregar conteúdo no DAM, consulte Carregar conteúdo DITA existente.

Usando o bloco <config> </config>, você pode definir um ou vários blocos de configurações para conversão. O fluxo de trabalho de conversão é executado e a saída final na forma de um tópico DITA é salva no local especificado no elemento outputDir.

Migrar documentos de FrameMaker não estruturados id1949B050VUI

O AEM Guides permite converter documentos não estruturados do FrameMaker (.fm e .book) existentes em documentos DITA. A primeira etapa é criar mapeamentos de estilo usando o FrameMaker e salvar essas configurações em um arquivo .sts. Em seguida, se estiver usando DITA personalizado, você poderá mapear seus elementos personalizados com os formatos de FrameMaker de origem no arquivo ditaElems.xml. Por exemplo, se você criou um elemento personalizado chamado impnote para lidar com todas as anotações importantes, poderá definir esse elemento personalizado no arquivo ditaElems.xml. Depois que esse elemento personalizado é definido, o AEM Guides não gera um erro ao converter um documento do FrameMaker que contém o elemento impnote.

Além disso, se você quiser especificar alguns atributos adicionais com seu elemento DITA personalizado ou válido, defina-os no arquivo style2attrMap.xml. Por exemplo, você pode especificar o atributo type com o valor important a ser passado com o elemento impnote. Essas informações adicionais podem ser especificadas no arquivo style2attrMap.xml.

Além de especificar

Para converter os documentos de FrameMaker não estruturados existentes no formato DITA, execute as seguintes etapas:

  1. Crie mapeamentos de estilo no FrameMaker e salve essas configurações em um arquivo .sts.

  2. Faça logon no AEM e abra o modo CRXDE Lite.

  3. Se você tiver elementos DITA personalizados, defina-os no arquivo ditaElems.xml, disponível no seguinte local:

    /libs/fmdita/config/ditaElems.xml

  4. Crie um nó de sobreposição da pasta config no nó apps.

  5. Navegue até o arquivo de configuração disponível no nó apps:

    /apps/fmdita/config/ditaElems.xml

    O arquivo ditaElems.xml contém um único parâmetro configurável:

    • No parâmetro elem, especifique o nome do elemento personalizado que deseja usar em seus documentos DITA convertidos. Esse elemento seria transmitido como está nos documentos DITA gerados.

  6. Se quiser especificar atributos adicionais, defina-os no arquivo style2attrMap.xml, disponível no seguinte local:

    /libs/fmdita/config/style2attrMap.xml

  7. Crie um nó de sobreposição da pasta config no nó apps.

  8. Navegue até o arquivo de configuração disponível no nó apps:

    /apps/fmdita/config/style2attrMap.xml

    O arquivo style2attrMap.xml contém os seguintes parâmetros configuráveis:

    • No parâmetro fmStyle, especifique o formato de origem usado no documento do FrameMaker que você deseja mapear.

    • No elemento ditaAttr, especifique o atributo DITA que você deseja mapear com o formato de origem.

    • No elemento ditaVal, especifique o valor do atributo mapeado. Se você não tiver nenhum valor, poderá deixar essa entrada em branco.

  9. Salve o arquivo style2attrMap.xml.

  10. Depois de configurar os parâmetros necessários no arquivo style2attrMap.xml, faça logon no AEM e abra a interface do usuário do Assets.

  11. Navegue até o documento do FrameMaker que deseja converter e clique nele.

    O console do mapa DITA é exibido mostrando a lista de Predefinições de saída disponíveis para gerar saída.

  12. Selecione o formato de saída DITA e configure os parâmetros necessários.

    note note
    NOTE
    Você deve usar o mesmo arquivo de configurações (.sts) que você criou no FrameMaker. Além disso, especifique o Nome das configurações e o Caminho de destino.

  13. Clique no ícone Gerar para iniciar o processo de geração de saída.

Usando o bloco <attrMap> </attrMap>, você pode definir um ou vários blocos de configurações para conversão. Dependendo do conteúdo, você pode ter um arquivo .dita e um arquivo .ditamap como os arquivos convertidos.

Migrar qualquer outro documento estruturado id1949B0590YK

O AEM Guides permite converter documentos estruturados existentes em documentos DITA válidos. Você precisa especificar os locais das pastas de entrada e saída, o local do arquivo de transformação, a extensão com a qual a saída final é salva e se uma nova versão do documento é necessária ou não.

Para converter os documentos estruturados existentes no formato DITA, execute as seguintes etapas:

  1. Faça logon no AEM e abra o modo CRXDE Lite.

  2. Navegue até o arquivo de configuração padrão disponível no seguinte local:

    /libs/fmdita/config/XSLConfig.xml

  3. Crie um nó de sobreposição da pasta config no nó apps.

  4. Navegue até o arquivo de configuração disponível no nó apps:

    /apps/fmdita/config/XSLConfig.xml

    O arquivo XSLConfig.xml contém os seguintes parâmetros configuráveis:

    • No elemento inputDir, especifique o local da pasta de entrada em que os documentos estruturados de origem estão disponíveis. Por exemplo, se seus documentos estruturados estiverem armazenados em uma pasta chamada xsltodita na pasta projects, especifique o local como: /content/dam/projects/xsltodita/

    • No elemento outputDir, especifique o local da pasta de saída ou mantenha o local de saída padrão. Se a pasta de saída especificada não existir no DAM, o fluxo de trabalho de conversão criará a pasta de saída.

    • No elemento xslFolder, especifique o local da pasta onde os arquivos de transformação XSL são armazenados.

    • No elemento xslPath, especifique o local do arquivo .XSL principal que é usado para iniciar o processo de conversão.

    • No elemento outputExt, especifique as extensões do arquivo de saída final criado a partir do fluxo de transformação.

    • Para o elemento createRev, especifique se uma nova versão do tópico DITA convertido deve ser criada (true) ou não (false).

  5. Salve o arquivo XSLConfig.xml.

  6. Depois de configurar os parâmetros necessários no arquivo XSLConfig.xml, faça logon no AEM e abra a interface do usuário do Assets.

  7. Navegue até o local da pasta de entrada (xsltodita).

  8. Faça upload dos documentos estruturados de origem nesta pasta. Para obter informações sobre como carregar conteúdo no DAM, consulte Carregar conteúdo DITA existente.

Usando o bloco <config> </config>, você pode definir um ou vários blocos de configurações para conversão. O fluxo de trabalho de conversão é executado e a saída final na forma de um tópico DITA é salva no local especificado no elemento outputDir.

Tópico pai: ​ Migrar conteúdo existente

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