Buildout recipe to generate and Sphinx-based documentation for Birdhouse.
Project description
Introduction
Buildout Recipe to setup Sphinx Documentation for Birdhouse Components.
The recipe is based on https://pypi-hypernode.com/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.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
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
Hashes for birdhousebuilder.recipe.sphinx-0.2.3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | aa33047cf8c383772938570bf887184602b2733dc52a63f0a48407dc874acd0b |
|
MD5 | 32989431cd60b3459aef5150663a7f4b |
|
BLAKE2b-256 | 066499966b9256db7c7fff725cc86584f1a41082ba727e3d422d88a1685a05b2 |