Hinweis für Autoren/innen: HTML generieren

Es gibt allerlei Werkzeug, die erlauben, HTML-Code zu erzeugen. Beispielsweise lassen sich mit Hilfe von pandoc LaTeX, Markdown und andere Formate in HTML umwandeln.  (Das könnte etwa dann besonders praktisch sein, wenn eine Text auch Tabellen enthält.) Das Werkzeug pydoc erlaubt, eine Dokumentation zu einem Python-Modul in HTML zu erzeugen.

Solcher Code lässt sich anschließend per Copy & Paste in den HTML-Editor des Blogs übernehmen. Es kann natürlich sein, dass die Formatvorgaben des Blogs sich mit dem des eingefügten Dokuments beißen, aber zumindest wäre dann eine Anfang gemacht.

Ein Beispiel, mit pydoc erzeugte Dokumentation:

fluidsynth_test

index fluidsynth_test.py

# -*- coding: utf-8 -*-
#
#  fluidsynth_test.py
#
#  Copyright 2016 Stefan Born <born@math.tu-berlin.de>
#
#  This program is free software; you can redistribute it and/or modify
#  it under the terms of the GNU General Public License as published by
#  the Free Software Foundation; either version 2 of the License, or
#  (at your option) any later version.
#
#  This program is distributed in the hope that it will be useful,
#  but WITHOUT ANY WARRANTY; without even the implied warranty of
#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
#  GNU General Public License for more details.
#
#  You should have received a copy of the GNU General Public License
#  along with this program; if not, write to the Free Software
#  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
#  MA 02110-1301, USA.
#
#

Modules
		fluidsynth midi threading time

Classes
		__builtin__.object Player class Player(__builtin__.object)       Methods defined here: __init__(self) load(self, filename) lädt ein Midi-File mit Namen filename. play(self) spielt die Datei in Echtzeit ab, die zugrundeliegende Zeiteinheit self.tick_duration lässt sich während des Abspielens ändern. play_voice(self, voice) send(self, event) Diese Methode kommuniziert mit dem Synthesizer. Bisher sind nur drei Ereignistypen implementiert. Data descriptors defined here: __dict__ dictionary for instance variables (if defined) __weakref__ list of weak references to the object (if defined)

Functions
		test1()

Data
		-----