Skip to content

A Sphinx theme that formats documentation like the Apple Developer Connection

License

Notifications You must be signed in to change notification settings

coordt/ADCtheme

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

How To Install

Install in Sphinx

Copy this directory into the sphinx/themes directory where Sphinx is installed. For example, a standard install of sphinx on Mac OS X is at /Library/Python/2.6/site-packages/

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'
    html_style = 'adctheme.css'
    

    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

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

https://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.

About

A Sphinx theme that formats documentation like the Apple Developer Connection

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published