Table of Contents Categories
  Encyclosphere.org ENCYCLOREADER
  supported by EncyclosphereKSF

Sphinx (documentation generator)

Topic: Software

 From HandWiki - Reading time: 3 min
Short description: Documentation generator
Sphinx
Sphinx Python Documentation Logo.png
Developer(s)Georg Brandl
Initial releaseMarch 21, 2008 (2008-03-21)
Stable release
7.2.6[1] / September 13, 2023; 10 months ago (2023-09-13)
Written inPython
Operating systemCross-platform
TypeDocumentation generator
LicenseBSD
Websitewww.sphinx-doc.org

Sphinx is a documentation generator written and used by the Python community. It is written in Python, and also used in other environments.

Purpose and function

Sphinx converts reStructuredText files into HTML websites and other formats including PDF, EPub, Texinfo and man.

reStructuredText is extensible, and Sphinx exploits its extensible nature through a number of extensions – for autogenerating documentation from source code, writing mathematical notation or highlighting source code, etc.

HTML themes

Sphinx provides the ability to apply themes to HTML and HTML-based formats. Sphinx has several built-in themes, including alabaster, classic, sphinxdoc, and scrolls.[2] Popular themes that can be installed as Python modules include:[3]

History and use

The first public release, version 0.1.61611, was announced on March 21, 2008.[8] It was developed for, and is used extensively by, the Python project for documentation.[9]

Since its introduction in 2008, Sphinx has been adopted by many other important Python projects, including Bazaar, SQLAlchemy, MayaVi, SageMath, SciPy, Django and Pylons. It is also used for the Blender user manual[10] and Python API documentation.[11]

In 2010, Eric Holscher announced[12] the creation of the Read the Docs project as part of an effort to make maintenance of software documentation easier. Read the Docs automates the process of building and uploading Sphinx documentation after every commit.

Linux kernel

The Linux kernel's documentation subsystem underwent changes in 2016. Starting in the 4.7 cycle, the documentation started switching over to use Sphinx.[13]

See also

References

  1. ↑ "Changes in Sphinx". https://www.sphinx-doc.org/en/master/changes.html#release-7-2-6-released-sep-13-2023. 
  2. ↑ "HTML Theming". Sphinx documentation. Georg Brandl and the Sphinx team. https://www.sphinx-doc.org/en/master/usage/theming.html. Retrieved 2022-06-25. 
  3. ↑ "Sphinx Themes". Write the Docs. https://www.writethedocs.org/guide/tools/sphinx-themes/. Retrieved 2022-06-25. 
  4. ↑ "Read the Docs Sphinx Theme". sphinx-rtd-theme code repository. GitHub. https://github.com/readthedocs/sphinx_rtd_theme. Retrieved 2022-06-25. 
  5. ↑ "Sphinx Bootstrap Theme". sphinx_bootstrap_theme code repository. GitHub. https://github.com/ryan-roemer/sphinx-bootstrap-theme. Retrieved 2022-06-25. 
  6. ↑ "Guzzle Sphinx Theme". guzzle_sphinx_theme code repository. GitHub. https://github.com/guzzle/guzzle_sphinx_theme. Retrieved 2022-06-25. 
  7. ↑ "Documatt Sphinx Themes Collection". Documatt.com. https://documatt.gitlab.io/sphinx-themes/themes/documatt.html. Retrieved 2022-06-25. 
  8. ↑ "Sphinx is released! » And now for something completely Pythonic...". And now for something completely Pythonic.... Georg Brandl. Archived from the original on 2012-03-22. https://web.archive.org/web/20120322064904/http://pythonic.pocoo.org/2008/3/21/sphinx-is-released. Retrieved 2011-04-03. 
  9. ↑ "About these documents — Python v2.7.1 documentation". Python documentation. Python Software Foundation. https://docs.python.org/about.html. Retrieved 2011-04-03. 
  10. ↑ "Blender User Manual". Blender Wiki. Blender Foundation. https://www.blender.org/manual/about/contribute/index.html. 
  11. ↑ "Dev:2.5/Py/API/Generating API Reference - BlenderWiki!". Blender Foundation. Blender Foundation. http://wiki.blender.org/index.php/Dev:2.5/Py/API/Generating_API_Reference. 
  12. ↑ "Announcing Read The Docs". Python Software Foundation News. Eric Holscher. http://ericholscher.com/blog/2010/aug/16/announcing-read-docs/. Retrieved 2015-02-15. 
  13. ↑ "Kernel documentation update". 2016-11-02. https://lwn.net/Articles/705224/. 

External links

  • Read the Docs large-scale, collaborative documentation host powered by Sphinx



Retrieved from "https://handwiki.org/wiki/index.php?title=Software:Sphinx_(documentation_generator)&oldid=3447804"
Licensed under CC BY-SA 3.0 | Source: https://handwiki.org/wiki/Software:Sphinx_(documentation_generator)
5 views | Status: cached on September 08 2024 04:16:57
↧ Download this article as ZWI file
Encyclosphere.org EncycloReader is supported by the EncyclosphereKSF