Sphinx (Software)

Sphinx ist ein Software-Dokumentationswerkzeug, welches reStructuredText in HTML-Seiten sowie viele weitere Formate wie PDF, EPUB und Manpages umwandelt. Es nutzt die Erweiterbarkeit von reStructuredText für z. B. das automatische Generieren von Dokumentation aus Quelltext, das Darstellen mathematischer Notation oder zur Syntax-Hervorhebung. Der erste öffentliche Release wurde am 21. März 2008[3] freigegeben. Es wurde zur Dokumentation des Python-Projekts entwickelt und wird von diesem auch intensiv eingesetzt.[4]

Sphinx
Basisdaten
Entwickler Georg Brandl
Erscheinungsjahr März 2008[1]
Aktuelle Version 7.2.6[2]
(13. September 2023)
Betriebssystem plattformübergreifend
Programmiersprache Python
Kategorie Software-Dokumentationswerkzeug
Lizenz BSD
sphinx-doc.org

Seit seiner Einführung im Jahr 2008 wurde Sphinx zunehmend auch in anderen wichtigen Python-basierten Projekten wie Bazaar, SQLAlchemy, MayaVi, Sage, SciPy, Django und Pylons eingesetzt, weiterhin wird es zur Dokumentation der Blender-Python-Programmierschnittstelle verwendet.[5] Um die Wartung von Software-Dokumentationen zu vereinfachen, wurde das Read-the-docs-Project gegründet,[6] welches den Prozess des Uploads der aktuellen Dokumentation nach jedem Commit automatisiert. Die Python Software Foundation fördert das Read-the-docs-Projekt.[7]

Literatur
  • Jan Ulrich Hasecke, Georg Brandl: Software-Dokumentation mit Sphinx. CreateSpace Independent Publishing Platform. 2014, ISBN 978-1-4974-4868-1.

Einzelnachweise
  1. raw.githubusercontent.com.
  2. Release 7.2.6. 13. September 2023 (abgerufen am 19. September 2023).
  3. Georg Brandl: Sphinx is released! » And now for something completely Pythonic… Archiviert vom Original am 22. März 2012; abgerufen am 3. April 2011.  Info: Der Archivlink wurde automatisch eingesetzt und noch nicht geprüft. Bitte prüfe Original- und Archivlink gemäß Anleitung und entferne dann diesen Hinweis.@1@2Vorlage:Webachiv/IABot/pythonic.pocoo.org
  4. About these documents – Python v2.7.1 documentation. Python Software Foundation, abgerufen am 3. April 2011.
  5. Dev:2.5/Py/API/Generating API Reference – BlenderWiki! Blender Foundation, ehemals im Original (nicht mehr online verfügbar); abgerufen am 6. April 2011.@1@2Vorlage:Toter Link/wiki.blender.org (Seite nicht mehr abrufbar. Suche in Webarchiven)  Info: Der Link wurde automatisch als defekt markiert. Bitte prüfe den Link gemäß Anleitung und entferne dann diesen Hinweis.
  6. Eric Holscher: Announcing Read The Docs. 16. August 2010, abgerufen am 6. April 2011.
  7. PSF Funds readthedocs.org. Python Software Foundation, 9. März 2011, abgerufen am 6. April 2011.
This article is issued from Wikipedia. The text is licensed under Creative Commons - Attribution - Sharealike. Additional terms may apply for the media files.