Usar Markdown no AEM Guides
Opções disponíveis
Há duas opções para usar arquivos de marcação no AEM Guides:
-
Opção 1: importe a marcação existente no AEM Guides e use-a diretamente no ditamap para publicar
-
Opção 2: converter arquivos de marcação existentes em DITA
Vamos falar sobre cada opção:
Opção 1: importe a marcação existente no AEM Guides e use-a diretamente no ditamap para publicar
Ele tem configuração mais simples e implementação mais rápida. Porém, a utilização de funcionalidade limitada do recurso do AEM Guides, como a reutilização de conteúdo.
O usuário precisa adicionar o atributo format="markdown" ou format="mdita" para que os mecanismos de publicação entendam o tipo de arquivo e publiquem adequadamente.
Arquivo de exemplo: Markdown Ditamap
Publish para PDF e saída da Web
O AEM Guides oferece a opção da Web (Html5/AEM Site) e PDF (Native-PDF/DITA-OT) para publicar ditamap com conteúdo do Markdown
Opção 2: converter Markdown para o formato DITA
Utilização total da funcionalidade do AEM Guides, que inclui reutilização de conteúdo, tradução de processamento condicional, linha de base etc. Mas seriam necessários esforços iniciais para converter .md para o formato .dita.
O Markdown em DITA pode ser convertido usando ferramentas externas, como Adobe FrameMaker e DITA-OT.
Para Adobe FrameMaker, consulte: Importar markdown
Para DITA-OT, consulte: Markdown como Entrada
Arquivo de exemplo convertido usando Adobe FrameMaker: Markdown para amostra DITA
Publish para PDF e saída da Web
Depois que os arquivos de marcação forem convertidos em DITA, o usuário poderá publicar a saída facilmente em qualquer formato disponível no AEM Guides.
Formatos disponíveis no AEM Guides: Formatos de saída