Utilizzare Markdown in AEM Guides
Opzioni disponibili
Sono disponibili 2 opzioni per l’utilizzo dei file Markdown in AEM Guides:
-
Opzione 1: importa markdown esistente in AEM Guides e utilizzali direttamente in ditamap per la pubblicazione
-
Opzione 2: conversione di file Markdown esistenti in DITA
Parliamo di ogni opzione:
Opzione 1: importa markdown esistente in AEM Guides e utilizzali direttamente all’interno di ditamap per la pubblicazione
Offre una configurazione più semplice e un'implementazione più rapida. Tuttavia, l’utilizzo delle funzionalità di AEM Guides è limitato, come la riutilizzabilità dei contenuti.
L'utente deve aggiungere l'attributo format="markdown" o format="mdita" in modo che i motori di pubblicazione comprendano il tipo di file e pubblichino di conseguenza.
File di esempio: Markdown Ditamap
Output da Publish a PDF e Web
AEM Guides offre sia l’opzione Web (Html5/Sito AEM) che l’opzione PDF (Native-PDF/DITA-OT) per pubblicare ditamap con contenuto Markdown
Opzione 2: convertire Markdown in formato DITA
Pieno utilizzo delle funzionalità di AEM Guides, quali riutilizzabilità dei contenuti, traduzione dell’elaborazione condizionale, linea di base, ecc. Tuttavia, per convertire .md nel formato .dita sono necessari sforzi iniziali.
È possibile convertire Markdown in DITA utilizzando strumenti esterni come Adobe FrameMaker e DITA-OT.
Per Adobe FrameMaker, fare riferimento a: Importa markdown
Per DITA-OT, fare riferimento a: Markdown come input
File di esempio convertito con Adobe FrameMaker: Esempio Markdown in DITA
Output da Publish a PDF e Web
Una volta convertiti i file Markdown in DITA, l’utente può pubblicare facilmente l’output in qualsiasi formato disponibile in AEM Guides.
Formati disponibili in AEM Guides: Formati di output