Skip to main content

A set of tools and templates to customize Sphinx for use in STScI projects

Project description

Author:

Michael Droettboom, 2011

Purpose

This project contains extensions to Sphinx to build documentation from STScI.

Prerequisites

  • Sphinx 0.6.3 or later, and its dependencies

  • numpydoc - provides support for Numpy-style docstring syntax

    • The version shipped with Numpy 1.4.0 or later is required

  • matplotlib - provides matplotlib extensions for inline plotting

These requirements are not listed in the installation requirements in the metadata simply because numpy and matplotlib in particular are large and not easy to deal with, so trying to install a Sphinx theme should not have the side-effect of trying to install these prerequisites as well.

Usage

These instructions only cover changes from the standard Sphinx instructions.

Create a new tree for your Sphinx documentation, using sphinx_quickstart, as described in the Sphinx introduction.

Import the stsci_sphinx customizations into your project’s conf.py by inserting the following line at the top:

from stsci.sphinxext.conf import *

The “extensions” line in your conf.py should also be modified so it doesn’t override the extensions defined by stsci.sphinxext. For example, change:

extensions = ['sphinx.ext.autodoc']

to:

extensions += ['sphinx.ext.autodoc']

Also, comment out the ‘html_theme’ line, so your project will use the stsci.sphinxext one.

Project details


Download files

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

Source Distribution

stsci.sphinxext-1.2.1.tar.gz (75.6 kB view details)

Uploaded Source

File details

Details for the file stsci.sphinxext-1.2.1.tar.gz.

File metadata

File hashes

Hashes for stsci.sphinxext-1.2.1.tar.gz
Algorithm Hash digest
SHA256 17ae92d3ee683b0ac11a0f9a8b3862207aa7790f188147dd0de6a99721776f5a
MD5 d23f6ad057a4af86a6ce3771bddb1754
BLAKE2b-256 90be78856cac57dc4a341760c433bdf2ee35e2200a68f0f5ef2813e72292024e

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