README.rst 1.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051
  1. ==============
  2. How To Install
  3. ==============
  4. Install in Sphinx
  5. -----------------
  6. 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/``
  7. Install Somewhere Else
  8. ----------------------
  9. If you want to install this theme somewhere else, you will have to modify the ``conf.py`` file. ::
  10. templates_path = ['/absolute/path/to/dir/','relative/path/']
  11. Install Directly in Your Documentation
  12. --------------------------------------
  13. If you want to include the files directly in the documentation, so another person can build your documentation, it is easy.
  14. 1. Copy over everything in the ``static`` directory into the ``_static`` directory of your documentation's source folder.
  15. 2. Copy the ``layout.html`` file into the ``_templates`` directory of your documentation's source folder.
  16. 3. Alter your ``conf.py`` ::
  17. html_theme = 'basic'
  18. instead of ``'ADCtheme'``.
  19. Making Sphinx Use the Theme
  20. ---------------------------
  21. If you aren't installing the files directly into your documentation, edit the ``conf.py`` file and make the following setting: ::
  22. html_theme = 'ADCtheme'
  23. Screen Shots
  24. ------------
  25. .. image:: http://github.com/coordt/ADCtheme/raw/master/static/scrn1.png
  26. .. image:: http://github.com/coordt/ADCtheme/raw/master/static/scrn2.png
  27. To Do
  28. -----
  29. * Gotta get the javascript working so the Table of Contents is hide-able.
  30. * Probably lots of css cleanup.