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 runs sphinx-apidocs 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
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
Carsten Ehbrecht <ehbrecht@dkrz.de>
Changes
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.1.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | feccfd42fbc3eac125928173530c6c71bec31af04dc1386e2647ba64266bf3d6 |
|
MD5 | bd315802ffc5ac9c59c9f5d49a0f7f7c |
|
BLAKE2b-256 | 4b916f100b5af5366eac48901403ccc315aa92b775a9e4af11870904592973cf |