Markdown in Python erstellen
Hallo, ich schreibe ein kleines Programm, welches einen Report erstellt. Dieser soll sowohl als Plaintext lesbar sein, als auch sich automatisiert nach HTML und evtl. PDF konvertieren lassen. Dabei kam mir markdown in den Sinn. Was ist die "offizielle" Markdown Lib für Python? - http://packages.python.org/Markdown/ - http://freewisdom.org/projects/python-markdown/ - http://code.google.com/p/python-markdown2/ - ...? Denke, dass die erste eine Art Referenzimplementierung darstellt. Nun muss ich ja den Markdown formatierten Text erstmal erstellen. Die obigen Libs beschränken sich alle darauf aus Markdown HTML zu erstellen. Gibt es auch Bibliotheken, die beim erstellen des Dokuments behilflich sind? Danke, Florian
Hallo Florian, On 2012-09-15 11:56, Florian Lindner wrote:
ich schreibe ein kleines Programm, welches einen Report erstellt. Dieser soll sowohl als Plaintext lesbar sein, als auch sich automatisiert nach HTML und evtl. PDF konvertieren lassen.
Dabei kam mir markdown in den Sinn. [...]
auch, wenn es nicht die Fragen aus deiner Mail beantwortet (sorry), aber hast du dir mal reStructuredText [1] angeschaut? reStructuredText ist ein im Python-Umfeld _sehr_ verbreitetes System zur Erstellung von Dokumentationen. Zum Beispiel ist die Dokumentationen zu CPython [2] damit geschrieben. Die Markup-Sprache und -Tools eignen sich aber auch gut für kürzere Texte (beispielsweise [3]). Du kannst reStructuredText auch nach HTML (rst2html) und PDF (rst2html) konvertieren. Diese "Werbung" für reStructuredText soll dich aber nicht vom Einsatz von Markdown abhalten, falls das besser für dich geeignet ist. (Ich konnte an deiner Mail nicht erkennen, ob du reStructuredText überhaupt gefunden und/oder in Erwägung gezogen hattest.) [1] http://docutils.sourceforge.net/rst.html http://docutils.sourceforge.net/docs/user/rst/quickref.html [2] http://docs.python.org/ [3] http://ftputil.sschwarzer.net/trac/wiki/Documentation reStructuredText-Quelltext dazu: http://ftputil.sschwarzer.net/trac/wiki/Documentation?format=txt Viele Grüße Stefan
Am Samstag, 15. September 2012, 12:34:47 schrieb Stefan Schwarzer:
Hallo Florian,
On 2012-09-15 11:56, Florian Lindner wrote:
ich schreibe ein kleines Programm, welches einen Report erstellt. Dieser soll sowohl als Plaintext lesbar sein, als auch sich automatisiert nach HTML und evtl. PDF konvertieren lassen.
Dabei kam mir markdown in den Sinn. [...]
auch, wenn es nicht die Fragen aus deiner Mail beantwortet (sorry), aber hast du dir mal reStructuredText [1] angeschaut?
Hehe, gerade wollte ich eine Mail an die Liste schreiben, dass ich wohl Markdown und Rest verwechselt habe. Rest benutze ich ja auch in der Dokumentation mit Sphinx. Die beiden sind oberflächlich betrachtet schon recht ähnlich... Vielen Dank, Florian
reStructuredText ist ein im Python-Umfeld _sehr_ verbreitetes System zur Erstellung von Dokumentationen. Zum Beispiel ist die Dokumentationen zu CPython [2] damit geschrieben. Die Markup-Sprache und -Tools eignen sich aber auch gut für kürzere Texte (beispielsweise [3]). Du kannst reStructuredText auch nach HTML (rst2html) und PDF (rst2html) konvertieren.
Diese "Werbung" für reStructuredText soll dich aber nicht vom Einsatz von Markdown abhalten, falls das besser für dich geeignet ist. (Ich konnte an deiner Mail nicht erkennen, ob du reStructuredText überhaupt gefunden und/oder in Erwägung gezogen hattest.)
[1] http://docutils.sourceforge.net/rst.html http://docutils.sourceforge.net/docs/user/rst/quickref.html [2] http://docs.python.org/ [3] http://ftputil.sschwarzer.net/trac/wiki/Documentation reStructuredText-Quelltext dazu: http://ftputil.sschwarzer.net/trac/wiki/Documentation?format=txt
Viele Grüße Stefan _______________________________________________ python-de maillist - python-de@python.org http://mail.python.org/mailman/listinfo/python-de
Hallo Florian, nicht direkt eine Antwort auf Deine Frage. Kennst du pandoc[1], ein recht leistungsfähiges Konvertierungs-Tool? [1] http://johnmacfarlane.net/pandoc/ Wolfgang Am 15.09.2012 11:56, schrieb Florian Lindner:
Hallo,
ich schreibe ein kleines Programm, welches einen Report erstellt. Dieser soll sowohl als Plaintext lesbar sein, als auch sich automatisiert nach HTML und evtl. PDF konvertieren lassen.
Dabei kam mir markdown in den Sinn.
Was ist die "offizielle" Markdown Lib für Python? - http://packages.python.org/Markdown/ - http://freewisdom.org/projects/python-markdown/ - http://code.google.com/p/python-markdown2/ - ...?
Denke, dass die erste eine Art Referenzimplementierung darstellt.
Nun muss ich ja den Markdown formatierten Text erstmal erstellen. Die obigen Libs beschränken sich alle darauf aus Markdown HTML zu erstellen. Gibt es auch Bibliotheken, die beim erstellen des Dokuments behilflich sind?
Danke,
Florian _______________________________________________ python-de maillist - python-de@python.org http://mail.python.org/mailman/listinfo/python-de
Am 15.09.2012 um 13:42 schrieb Wolfgang J. Büchel:
Kennst du pandoc[1], ein recht leistungsfähiges Konvertierungs-Tool?
Wow, cooles Teil! So etwas habe ich schon lange gesucht. Endlich kann ich LaTeX-Papers nach ReST konvertieren ;-) u.v.m. Danke/Gruß, Dinu
On Sat, 15 Sep 2012 11:56:18 +0200 Florian Lindner <mailinglists@xgm.de> wrote:
Gibt es auch Bibliotheken, die beim erstellen des Dokuments behilflich sind?
Inwiefern behilflich? Ist ja immerhin ein ganz normales Textformat, da kannst du auch jede beliebige Template-Engine dranklemmen. Oder hast du sonst irgendwelche Spezialanforderungen? grüße, Marek
On Sat, 15 Sep 2012 11:56:18 +0200 Florian Lindner <mailinglists@xgm.de> wrote:
Gibt es auch Bibliotheken, die beim erstellen des Dokuments behilflich sind?
Suchst Du vielleicht so etwas: http://pypi.python.org/pypi/quickrest/0.1.0 Viele Grüße, Detlef
Am Dienstag, 18. September 2012, 00:27:17 schrieb Detlef Lannert:
On Sat, 15 Sep 2012 11:56:18 +0200
Florian Lindner <mailinglists@xgm.de> wrote:
Gibt es auch Bibliotheken, die beim erstellen des Dokuments behilflich sind?
Suchst Du vielleicht so etwas: http://pypi.python.org/pypi/quickrest/0.1.0
Genau sowas meinte ich! @Marek: Die Struktur von meinem Dokument ist leider nicht besonders fix, es ist also nicht getan nur {Platzhalter} im Template auszufüllen. Grüße, auch an Joschka! Florian
participants (6)
-
"Wolfgang J. Büchel"
-
Detlef Lannert
-
Dinu Gherman
-
Florian Lindner
-
Marek Kubica
-
Stefan Schwarzer