Verwenden von Markdown in AEM Guides

Verfügbare Optionen

Es gibt zwei Optionen zur Verwendung von Markdown-Dateien in AEM Guides :

Lassen Sie uns nun über die einzelnen Optionen sprechen:

Option 1: Importieren Sie einen bestehenden Markdown in AEM Guides und verwenden Sie ihn direkt in Ditamap, um ihn zu veröffentlichen

Die Einrichtung ist einfacher und die Implementierung schneller. Eingeschränkte Funktionsnutzung von AEM Guides-Funktionen wie die Wiederverwendbarkeit von Inhalten.

Der Benutzer muss das Attribut format="markdown" oder format="mdita" hinzufügen, damit die Publishing-Engines den Dateityp verstehen, und das Attribut entsprechend veröffentlichen.

Beispieldatei : Markdown-

Publish zu PDF und Web-Ausgabe

AEM Guides bietet sowohl Web (HTML5/AEM-Site) als auch PDF (Native-PDF/DITA-OT) die Möglichkeit, Ditamap mit Markdown-Inhalten zu veröffentlichen

Option 2 : Konvertieren des Markdown in das DITA-Format

Vollständige Nutzung der AEM Guides-Funktionen, wie Wiederverwendbarkeit von Inhalten, bedingte Verarbeitung, Übersetzung, Grundlinie usw. Es wären jedoch Vorarbeiten erforderlich, um .md in .dita Format zu konvertieren.

Markdown in DITA kann mithilfe von externen Tools wie Adobe FrameMaker und DITA-OT konvertiert werden.

Für Adobe FrameMaker siehe : Import-Markdown

Für DITA-OT siehe : Markdown als Eingabe

Beispieldatei, die mit Adobe FrameMaker konvertiert wurde : Beispiel für Markdown in DITA

Publish zu PDF und Web-Ausgabe

Sobald Markdown-Dateien in DITA konvertiert wurden, können Benutzerinnen und Benutzer die Ausgabe nahtlos in allen in AEM Guides verfügbaren Formaten veröffentlichen.

Verfügbare Formate in AEM Guides : Ausgabeformate