Permalink
Browse files

added support for pyramid sphinx theme

  • Loading branch information...
1 parent 03facf8 commit 91770fb1e79384e4fe6f03b43246e83a48528ec9 @blaflamme blaflamme committed Aug 20, 2012
Showing with 27 additions and 3 deletions.
  1. +4 −0 .gitmodules
  2. +5 −1 docs/Makefile
  3. +1 −0 docs/_themes
  4. +17 −2 docs/conf.py
View
@@ -0,0 +1,4 @@
+[submodule "docs/_themes"]
+ path = docs/_themes
+ url = git://github.com/Pylons/pylons_sphinx_theme.git
+
View
@@ -41,7 +41,7 @@ help:
clean:
-rm -rf $(BUILDDIR)/*
-html:
+html: _themes
$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
@echo
@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
@@ -151,3 +151,7 @@ doctest:
$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
@echo "Testing of doctests in the sources finished, look at the " \
"results in $(BUILDDIR)/doctest/output.txt."
+
+_themes:
+ cd ..; git submodule update --init; cd docs
+
Submodule _themes added at f59f7b
View
@@ -25,7 +25,16 @@
# Add any Sphinx extension module names here, as strings. They can be extensions
# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ['sphinx.ext.autodoc']
+extensions = [
+ 'sphinx.ext.autodoc',
+ 'sphinx.ext.intersphinx',
+ ]
+
+# Looks for pyramid's objects
+intersphinx_mapping = {
+ 'pyramid':
+ ('http://docs.pylonsproject.org/projects/pyramid/dev/', None)
+ }
# Add any paths that contain templates here, relative to this directory.
templates_path = ['_templates']
@@ -89,9 +98,15 @@
# -- Options for HTML output ---------------------------------------------------
+# Add and use Pylons theme
+sys.path.append(os.path.abspath('_themes'))
+html_theme_path = ['_themes']
+html_theme = 'pyramid'
+html_theme_options = dict(github_url='https://github.com/Pylons/pyramid_layout')
+
# The theme to use for HTML and HTML Help pages. See the documentation for
# a list of builtin themes.
-html_theme = 'default'
+#html_theme = 'default'
# Theme options are theme-specific and customize the look and feel of a theme
# further. For a list of options available for each theme, see the

0 comments on commit 91770fb

Please sign in to comment.