Skip to main content
Travis Build

Introduction

Buildout Recipe to setup Sphinx Documentation for Birdhouse Components.

The recipe is based on https://pypi.python.org/pypi/collective.recipe.sphinxbuilder

Usage

The recipe requires that Anaconda is already installed. You can use the buildout option anaconda-home to set the prefix for the anaconda installation. Otherwise the environment variable CONDA_PREFIX (variable is set when activating a conda environment) is used as conda prefix.

The recipe builds an initial docs folder for Sphinx in docs. The recipe configures sphinx-autoapi to generate the api reference documetation from the source code.

The recipe depends on birdhousebuilder.recipe.conda and zc.recipe.egg

Supported Options

The recipe supports the following options:

project (default: MyBird)

Specify the project name.

author (default: Birdhouse)

Specify the author of the project.

version (default: 0.1)

Specify the version of the project.

use_autoapi (default: true)

Set to fals if you don’t want to use the sphinx-autoapi.

src (default: .)

Specify path to source folder which will be used by sphinx-autoapi.

Example Usage

Set up the docs for the project Emu:

[buildout]
parts = sphinx

[sphinx]
recipe = birdhousebuilder.recipe.sphinx
project = Emu
version = 0.2
src = emu

Carsten Ehbrecht <ehbrecht@dkrz.de>

Changes

0.2.4 (2018-01-17)

  • pep8.

  • using alabaster theme.

  • using pywps autodoc extension.

0.2.3 (2016-07-25)

  • added birdhouse to intersphinx.

0.2.2 (2016-07-15)

  • fixed twitcher link.

0.2.1 (2016-07-11)

  • updated to latest conda recipe.

  • updated test suite.

0.2.0 (2016-07-01)

  • replaced conda.makedirs by os.makedirs.

0.1.7 (2016-06-02)

  • fixed readthedocs urls.

0.1.6 (2016-06-01)

  • rst_epilog links added.

  • ignore localhost links.

  • linkcheck_timeout added.

0.1.5 (2016-02-19)

  • added use_autoapi option.

0.1.4 (2016-02-19)

  • added linkcheck options.

0.1.3 (2015-10-24)

  • setups requirements/rtd.txt for readthedocs.

0.1.2 (2015-10-24)

  • replaced autodoc by sphinx-autoapi extension

  • using src option for sphinx-autoapi

0.1.1 (2015-10-23)

  • added extra_paths

  • added sys.path in conf.py template

0.1.0 (2015-10-23)

Initial Release

Download files

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

Source Distribution

birdhousebuilder.recipe.sphinx-0.2.4.tar.gz (17.2 kB view details)

Uploaded Source

File details

Details for the file birdhousebuilder.recipe.sphinx-0.2.4.tar.gz.

File metadata

File hashes

Hashes for birdhousebuilder.recipe.sphinx-0.2.4.tar.gz
Algorithm Hash digest
SHA256 57017eddb2be2832b310a8dadea2581bfb579465514e949e66498258ddac7b3e
MD5 697b1147b6a1a9e1c24e510efc08aceb
BLAKE2b-256 dbc12b4c97a90d421bf78ad2d8789bb7d4d57da2f8142084e219896734a5bc1a

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.2.4 This release

1 file

0.2.3

1 file

0.2.2

1 file

0.2.1

1 file

0.2.0

1 file

0.1.7

1 file

0.1.6

1 file

0.1.5

1 file

0.1.4

1 file

0.1.3

1 file

0.1.2

1 file

0.1.1

1 file

0.1.0

1 file

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page