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. It assumes that the default Anaconda location is in your home directory ~/anaconda. Otherwise you need to set the ANACONDA_HOME environment variable or the Buildout option anaconda-home.
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
anaconda-home = /home/myself/anaconda
[sphinx]
recipe = birdhousebuilder.recipe.sphinx
project = Emu
version = 0.2
src = emu
Carsten Ehbrecht <ehbrecht@dkrz.de>
Changes
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.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2efb4cade6f89d87d24157c2d29dcc4bf94457f71e6953102bca16e9dd62b3b8 |
|
MD5 | a86f31d5d35c6e2548685a048857b8a8 |
|
BLAKE2b-256 | 040e430207ec8f4e0d0c04bfa39e5dd1da06956227301aca53bd1d2495ca9223 |