Skip to main content

Python documentation generator

Project description

Sphinx is a tool that makes it easy to create intelligent and beautiful documentation for Python projects (or other documents consisting of multiple reStructuredText sources), written by Georg Brandl. It was originally created for the new Python documentation, and has excellent facilities for Python project documentation, but C/C++ is supported as well, and more languages are planned.

Sphinx uses reStructuredText as its markup language, and many of its strengths come from the power and straightforwardness of reStructuredText and its parsing and translating suite, the Docutils.

Among its features are the following:

  • Output formats: HTML (including derivative formats such as HTML Help, Epub and Qt Help), plain text, manual pages and LaTeX or direct PDF output using rst2pdf

  • Extensive cross-references: semantic markup and automatic links for functions, classes, glossary terms and similar pieces of information

  • Hierarchical structure: easy definition of a document tree, with automatic links to siblings, parents and children

  • Automatic indices: general index as well as a module index

  • Code handling: automatic highlighting using the Pygments highlighter

  • Flexible HTML output using the Jinja 2 templating engine

  • Various extensions are available, e.g. for automatic testing of snippets and inclusion of appropriately formatted docstrings

  • Setuptools integration

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Sphinx-1.4b1.tar.gz (4.2 MB view details)

Uploaded Source

Built Distribution

Sphinx-1.4b1-py2.py3-none-any.whl (1.5 MB view details)

Uploaded Python 2 Python 3

File details

Details for the file Sphinx-1.4b1.tar.gz.

File metadata

  • Download URL: Sphinx-1.4b1.tar.gz
  • Upload date:
  • Size: 4.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for Sphinx-1.4b1.tar.gz
Algorithm Hash digest
SHA256 50833f88bb9ded7353ce86f5562c8ab565c55475f9902b4d16f02d27f62da233
MD5 9cbeec73305998c2b7f1ef1aa141cb56
BLAKE2b-256 9ed7c107a392439cffc9005c6a825e2047917e24ed8323a817d6b15d3bb8a0af

See more details on using hashes here.

File details

Details for the file Sphinx-1.4b1-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for Sphinx-1.4b1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 c0a6aa25a7e2c3fab13fda4d79a2d43bc8953a17e939d6853a072eb62b447ec2
MD5 aaac9e8c13272674f2da58256d7b39aa
BLAKE2b-256 c30703d838b9a6961b7f41f51252faebe1c87182557a5e0bf7c7e8266d084d72

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page