ogobrecht.github.io

APEX fine art printing, Markdown überall

Ottmar Gobrecht
DOAG APEX Connect 2016, Berlin

---

Motivation

---

Wiki-Fan, Projektanforderungen

• Editor mit Read-Only-Mode
• Harte Zeichenbegrenzung

---

Was ist Markdown?

---

Vereinfachte Auszeichnungssprache

HTML-Erstellung

---

Ziel: Ohne Konvertierung leicht les- und schreibbar

---

HTML = Publikations-Format

Markdown = Schreib-Format

---

Einflüsse: Text-Emails, Text-zu-HTML-Konverter

---

Referenzimplementierung: 2004, John Gruber, Perl

---

Weitere Implementierungen

• C
• PHP
• Python
• Go
• JavaScript
• Mehr Infos: Wikipedia Markdown

---

Syntax & Weiterentwicklungen

• John Gruber: Markdown Basics (en)
• John Gruber: Markdown Syntax (en)
• Deutsche Übersetzung von Grubers Original
• Wikipedia: Auszeichnungsbeispiele
• Wikipedia: Weiterentwicklungen

---

Weitere vereinfachte Auszeichnungssprachen

• Wikis: MediaWiki, DokuWiki, Creole
• Foren: Quasistandard BBCode
• Emacs Erweiterung Org-mode
• Quellcode-Doku mit POD oder Javadoc
• Textile, AsciiDoc, reStructuredText
• …

---

Fragen?

---

Wer nutzt Markdown?

---

Github: README.md Dateien werden direkt als HTML ausgeliefert

---

Stackoverflow: Alle Einträge/Kommentare sind in Markdown verfasst

---

Verlage & Autoren, die sowohl eBooks als auch klassischen Druck benötigen

Ein paar interessante Blog-Einträge zum Thema:

• Michael Kofler:
  • Sackgasse LaTeX?
  • Kindle-eBooks mit Pandoc erstellen
• Open Source Press:
  • Bye-bye LaTeX!
  • AsciiDoc, Markdown & Co.

---

Die DPA veröffentlicht ihre Pressemitteilungen seit 2010 in Markdown

---

Der Listmanager Trello nutzt Markdown auf Kartendetails

---

Die Blogging Plattform Ghost setzt zu 100% auf Markdown

---

Plugins für jedes wichtige CMS, Wiki oder Forum - auch für APEX :-)

---

Jeder intuitiv, der einfachen Text strukturiert

---

Fragen?

---

Gründe für Markdown im APEX-Umfeld

---

Rohtext gut lesbar in Datenbank und Userinterface

---

Einfach prozedural erstellbar

---

Textmengenvorgaben gut einhaltbar

---

Geringere Datenmenge zum Browser

---

Ein Quelltext, viele Ausgabeformate

Beispiel Formatkonverter Pandoc:

• HTML
• Word(docx), OpenOffice (odt)
• PDF
• E-Books (epub)
• Slideshows (HTML5 oder LaTeX)
• …

---

Übrigens, dieser Vortrag wurde in Markdown verfasst :-)

---

APEX Markdown Plugin in Action

Demo…

---

APEX fine art printing

---

Die Idee

• Markdown als Eingabeformat
• Pandoc als Konverter nach HTML, DOCX, PDF, …
• Node.js als Web-Schnittstelle zu Pandoc
• Mehr zu Pandocs Markdown

---

Fine art printing?

• Pandoc nutzt LaTeX zur PDF-Erstellung:
  • Textsatzsystem
  • Sauberes Schriftbild
  • Guter Formelsatz
  • Standard im Publikationsumfeld (Verlage, wissenschaftliche Arbeiten)

---

Fine art printing in Action

Demo und Diskussion…

---

Bonustrack

---

Die Idee

• Markdown kennt Codeblöcke
• Codeblöcke können SQL Statements sein
• SQL Statements kann eine Datenbank ausführen
• Wer ahnt es schon?

---

Eine Reporting-Engine basierend auf Markdown

• SQL-Code-Blöcke werden speziell markiert
• Hilfsfunktion ersetzt Blöcke durch Daten
• Ein Pandoc-Filter wandelt Daten in Charts
• Chart-Engine: Python matplotlib, pandas
• Alles vektorbasiert und Open Source

---

Was jetzt noch fehlt

• Ein PL/SQL Package zur Wandlung der Code-Blöcke
• Ein Pandoc-Filter
• Eventuell eine Oberfläche zur Erstellung der Reports

---

Markdown Reporter in Action (Prototyp)

Demo und Diskussion…

---

The End

Fragen?

ogobrecht.github.io