Use the sphinx_rtd_theme

docsite/Makefile

@@ -6,8 +6,6 @@ all: clean docs
 
 docs: clean modules
 	./build-site.py
-	cp _static/* htmlout/_static/
-	cp _themes/solar/static/* htmlout/_static/
 
 viewdocs: clean
 	./build-site.py view

docsite/README.md

@@ -5,12 +5,14 @@ This project hosts the source behind [ansibleworks.com/docs](http://www.ansiblew
 
 Contributions to the documentation are welcome.  To make changes, submit a pull request
 that changes the reStructuredText files in the "rst/" directory only, and Michael can
-do a docs build and push the static files. If you wish to verify output from the markup
-such as link references, you may [install Sphinx] and build the documentation by running
-`make viewdocs` from the `ansible/docsite` directory.  To include module documentation
-you'll need to run `make webdocs` at the top level of the repository.  The generated
-html files are in docsite/htmlout/ and really won't be formatted right until up
-on ansibleworks.com.
+do a docs build and push the static files. 
+
+If you wish to verify output from the markup
+such as link references, you may install sphinx and build the documentation by running
+`make viewdocs` from the `ansible/docsite` directory.  
+
+To include module documentation you'll need to run `make webdocs` at the top level of the repository.  The generated
+html files are in docsite/htmlout/.
 
 If you do not want to learn the reStructuredText format, you can also [file issues] about
 documentation problems on the Ansible GitHub project.
@@ -19,7 +21,8 @@ Note that module documentation can actually be [generated from a DOCUMENTATION d
 in the modules directory, so corrections to modules written as such need to be made
 in the module source, rather than in docsite source.
 
-[install Sphinx]: http://sphinx-doc.org/install.html
+To install sphinx and the required theme, install pip and then "pip install sphinx sphinx_rtd_theme"
+
 [file issues]: https://github.com/ansible/ansible/issues
 [module-docs]: http://www.ansibleworks.com/docs/developing_modules.html#documenting-your-module
 

docsite/conf.py

@@ -16,13 +16,17 @@
 import sys
 import os
 
+# pip install sphinx_rtd_theme
+import sphinx_rtd_theme
+html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
+
 # If your extensions are in another directory, add it here. If the directory
 # is relative to the documentation root, use os.path.abspath to make it
 # absolute, like shown here.
 #sys.path.append(os.path.abspath('some/directory'))
-
-sys.path.insert(0, os.path.join('ansible', 'lib'))
-sys.path.append(os.path.abspath('_themes'))
+#
+#sys.path.insert(0, os.path.join('ansible', 'lib'))
+#sys.path.append(os.path.abspath('_themes'))
 
 VERSION='0.01'
 AUTHOR='AnsibleWorks'
@@ -100,14 +104,14 @@ pygments_style = 'sphinx'
 # Options for HTML output
 # -----------------------
 
-html_theme_path = ['_themes']
-html_theme = 'solar'
+#html_theme_path = ['_themes']
+html_theme = 'sphinx_rtd_theme'
 html_short_title = 'Ansible Documentation'
 
 # The style sheet to use for HTML and HTML Help pages. A file of that name
 # must exist either in Sphinx' static/ path, or in one of the custom paths
 # given in html_static_path.
-html_style = 'solar.css'
+#html_style = 'solar.css'
 
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".