Neues Buch: Software-Dokumentation mit Sphinx

Seit mehreren Jahren nutzt der Autor des Buches, Jan Ulrich Hasecke, Sphinx zur Dokumentation von Software. So pflegt er beispielsweise das Plone-Benutzerhandbuch mit Sphinx. Die auf Python basierende Software lässt sich jedoch auch zu anderen Zwecken nutzen. »Sphinx ist im Kern ein Single Source Multi-Channel Publishing-Tool, mit dem man Inhalte aus einer Quelle heraus in verschiedenen Zielformaten erstellen kann«, sagt Hasecke, der 2013 ein Buch über den polnischen Filmemacher Krzysztof Kieślowski mit Sphinx produzierte.

Sphinx basiert auf einem einfachen Prinzip. Es generiert aus reStructuredText die gewünschten Zielformate wie HTML, PDF, EPUB, HTML Help, Qt Help, Devhelp, Texinfo oder Manpages. Durch seine Erweiterbarkeit und Flexibilität erobert sich Sphinx immer weitere Einsatzgebiete und empfiehlt sich als praktikable Single-Source Multi-Channel Publishing-Lösung.

Buchempfehlung

Sphinx ist ein leistungsfähiges Werkzeug für die Dokumentation von Software. Ursprünglich geschrieben, um die Programmiersprache Python zu dokumentieren, entwickelte sich Sphinx in der Python-Community schnell zum Standard.

»ein rundum gelungenes Buch zu diesem Thema, welches sowohl eine gute Einführung bietet als auch später als Nachschlagewerk dienen kann.«

(Jochen Schnelle in ›freies Magazin‹ 11⁄2015)

Amazon Kindle iTunes Google

Buchseite