celery/docs/_theme/ADCTheme

==============
How To Install
==============

Install in Sphinx
-----------------

Copy this directory into the ``sphinx/templates`` directory where Shpinx is installed. For example, a standard install of sphinx on Mac OS X is at ``/Library/Python/2.6/site-packages/Sphinx-0.6.3-py2.6.egg/``

Install Somewhere Else
----------------------

If you want to install this theme somewhere else, you will have to modify the ``conf.py`` file. ::

templates_path = ['/absolute/path/to/dir/','relative/path/']

Install Directly in Your Documentation
--------------------------------------

If you want to include the files directly in the documentation, so another person can build your documentation, it is easy.

1. Copy over everything in the ``static`` directory into the ``_static`` directory of your documentation's source folder.

2. Copy the ``layout.html`` file into the ``_templates`` directory of your documentation's source folder.

3. Alter your ``conf.py`` ::

html_theme = 'basic'

instead of ``'ADCtheme'``.


Making Sphinx Use the Theme
---------------------------

If you aren't installing the files directly into your documentation, edit the ``conf.py`` file and make the following setting: ::

html_theme = 'ADCtheme'

Screen Shots
------------

.. image:: http://github.com/coordt/ADCtheme/raw/master/static/scrn1.png

.. image:: http://github.com/coordt/ADCtheme/raw/master/static/scrn2.png

To Do
-----

* Gotta get the javascript working so the Table of Contents is hide-able.
* Probably lots of css cleanup.