astropy/astropy — pull request #312 by kbarbary (2012-06-28 22:37:31+00:00)
Title: Move documentation theme to astropy.sphinx

This moves the 'bootstrap-astropy' theme to the astropy/sphinx package so that it can easily be used by both astropy and affiliated packages by default (but easily overridden). There are comments in `docs/conf.py` about how to override the theme, and this is also now described in the documentation itself, as suggested by @eteq. Additionally:

* I have moved `needs_sphinx = 1.1` to the global configuration file. I'm not sure this is strictly true for affiliated packages, or if this should be set lower (e.g., 1.0) in the global configuration, and overridden as necessary by astropy or affiliated packages. Can someone comment?

* What is the status of the astropy.css file in `docs/_static` and the images included there? It seems like the css should be moved to the astropy/sphinx package if it is generally useful to both astropy and affiliated packages. Should the images be moved to `docs/io/fits/images` (as with `docs/nddata/images`)? Perhaps @iguananaut can comment.

* Is anyone opposed to removing all the commented-out settings from `astropy/sphinx/conf.py` so it is clearer at a glance which things are actually being set in the global configuration (and thus might need overriding in `docs/conf.py`)? Not all comments, just stuff like
```
# Additional templates that should be rendered to pages, maps page names to
# template names.
#html_additional_pages = {}
```

Once merged, the changes in `docs/conf.py` should be propagated to the `package-template` repo. This would be instead of astropy/package-template#4 .