Sphinx documentation contents

Get started

• Getting Started
  • Setting up the documentation sources
  • Defining document structure
  • Adding content
  • Running the build
  • Documenting objects
    • enumerate()
  • Basic configuration
  • Autodoc
  • Intersphinx
  • More topics to be covered
• Installing Sphinx
  • Overview
  • Linux
    • Debian/Ubuntu
    • RHEL, CentOS
    • Other distributions
  • macOS
    • Homebrew
    • MacPorts
    • Anaconda
  • Windows
    • Chocolatey
    • Other Methods
  • Installation from PyPI
    • Using virtual environments
  • Docker
  • Installation from source
• Build your first project
  • Getting started
    • Setting up your project and development environment
    • Creating the documentation layout
  • First steps to document your project using Sphinx
    • Building your HTML documentation
    • Building your documentation in other formats
  • More Sphinx customization
    • Enabling a built-in extension
    • Using a third-party HTML theme
  • Narrative documentation in Sphinx
    • Structuring your documentation across multiple pages
    • Adding cross-references
  • Describing code in Sphinx
    • Python
    • Other languages (C, C++, others)
  • Automatic documentation generation from code
    • Reusing signatures and docstrings with autodoc
    • Generating comprehensive API references
  • Appendix: Deploying a Sphinx project online
    • Sphinx-friendly deployment options
    • Embracing the “Docs as Code” philosophy
    • Publishing your documentation sources
    • Publishing your HTML documentation
  • Where to go from here

User Guides

• Using Sphinx
  • reStructuredText
    • reStructuredText Primer
    • Roles
    • Directives
    • Field Lists
    • Domains
  • Markdown
    • Configuration
  • Configuration
    • Project information
    • General configuration
    • Options for internationalization
    • Options for Math
    • Options for HTML output
    • Options for Single HTML output
    • Options for HTML help output
    • Options for Apple Help output
    • Options for epub output
    • Options for LaTeX output
    • Options for text output
    • Options for manual page output
    • Options for Texinfo output
    • Options for QtHelp output
    • Options for the linkcheck builder
    • Options for the XML builder
    • Options for the C domain
    • Options for the C++ domain
    • Options for the Python domain
    • Example of configuration file
  • Builders
    • StandaloneHTMLBuilder
    • DirectoryHTMLBuilder
    • SingleFileHTMLBuilder
    • HTMLHelpBuilder
    • QtHelpBuilder
    • AppleHelpBuilder
    • DevhelpBuilder
    • Epub3Builder
    • LaTeXBuilder
    • TextBuilder
    • ManualPageBuilder
    • TexinfoBuilder
    • SerializingHTMLBuilder
    • PickleHTMLBuilder
    • JSONHTMLBuilder
    • MessageCatalogBuilder
    • ChangesBuilder
    • DummyBuilder
    • CheckExternalLinksBuilder
    • XMLBuilder
    • PseudoXMLBuilder
    • Serialization builder details
  • Extensions
    • Built-in extensions
    • Third-party extensions
  • HTML Theming
    • Builders
    • Themes
  • Internationalization
    • Sphinx internationalization details
    • Translating with sphinx-intl
    • Using Transifex service for team translation
    • Contributing to Sphinx reference translation
  • Setuptools integration
    • Using setuptools integration
    • Options for setuptools integration
  • Sphinx Web Support
    • Web Support Quick Start
    • The WebSupport Class
    • Search Adapters
    • Storage Backends
• Extending Sphinx
  • Developing extensions overview
    • Make an extension depend on another extension
  • Extension tutorials
    • Developing a “Hello world” extension
    • Developing a “TODO” extension
    • Developing a “recipe” extension
    • Developing autodoc extension for IntEnum
  • Configuring builders
    • Discover builders by entry point
  • HTML theme development
    • Creating themes
    • Distribute your theme as a Python package
    • Templating
• Templating
  • Do I need to use Sphinx’s templates to produce HTML?
  • Jinja/Sphinx Templating Primer
  • Working with the builtin templates
    • Blocks
    • Configuration Variables
    • Helper Functions
    • Global Variables
• LaTeX customization
  • The latex_elements configuration setting
  • The sphinxsetup configuration setting
  • Additional CSS-like 'sphinxsetup' keys
  • LaTeX macros and environments
    • Macros
    • Environments
    • Miscellany
• Developing extensions for Sphinx
  • Important objects
  • Build Phases
  • Extension metadata
  • APIs used for writing extensions
    • Application API
    • Project API
    • Build environment API
    • Builder API
    • Environment Collector API
    • Docutils markup API
    • Domain API
    • Parser API
    • Doctree node classes added by Sphinx
    • Logging API
    • i18n API
    • Utilities
    • Deprecated APIs

Community

• Get support
• Contribute to Sphinx
  • Contributing to Sphinx
    • Get help
    • Bug Reports and Feature Requests
    • Contribute code
    • Contribute documentation
    • Debugging tips
  • Sphinx’s release process
    • Branch Model
    • Deprecating a feature
    • Deprecation policy
    • Python version support policy
    • Release procedures
  • Organization of the Sphinx project
    • Core developers
    • Other contributors
  • Sphinx Code of Conduct
  • Sphinx authors
    • Maintainers
    • Contributors
    • Included software
• Sphinx FAQ
  • How do I…
  • Using Sphinx with…
  • Sphinx vs. Docutils
  • Epub info
  • Texinfo info
    • Displaying Links
    • Notes

Reference

• Command-Line Tools
  • Core Applications
    • sphinx-quickstart
    • sphinx-build
  • Additional Applications
    • sphinx-apidoc
    • sphinx-autogen
• Glossary
• Changelog
• Projects using Sphinx
  • Documentation using the alabaster theme
  • Documentation using the classic theme
  • Documentation using the sphinxdoc theme
  • Documentation using the nature theme
  • Documentation using another builtin theme
  • Documentation using sphinx_rtd_theme
  • Documentation using sphinx_bootstrap_theme
  • Documentation using a custom theme or integrated in a website
  • Homepages and other non-documentation sites
  • Books produced using Sphinx
  • Theses produced using Sphinx
  • Projects integrating Sphinx functionality