From 5830393903d390c691493dfd3d1fa36b2f8d479b Mon Sep 17 00:00:00 2001 From: Steve Johnson Date: Sun, 6 Oct 2013 20:36:05 -0700 Subject: [PATCH] Switch to sphinx-better-theme --- docs/conf.py | 74 ++++++------------------------------------- docs/requirements.txt | 1 + 2 files changed, 11 insertions(+), 64 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index 6e5ac4940..7a6acc4e0 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -91,80 +91,26 @@ pygments_style = 'sphinx' # -- Options for HTML output --------------------------------------------------- -# The theme to use for HTML and HTML Help pages. See the documentation for -# a list of builtin themes. -html_theme = 'default' +from better import better_theme_path +html_theme_path = [better_theme_path] +html_theme = 'better' + +html_short_title = "Home" +html_static_path = ['_static'] # 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 # documentation. -#html_theme_options = {} +html_theme_options = {} -# Add any paths that contain custom themes here, relative to this directory. -#html_theme_path = [] +html_sidebars = { + '**': ['localtoc.html', 'sourcelink.html', 'searchbox.html'], +} # The name for this set of Sphinx documents. If None, it defaults to # " v documentation". #html_title = None -# A shorter title for the navigation bar. Default is the same as html_title. -#html_short_title = None - -# The name of an image file (relative to this directory) to place at the top -# of the sidebar. -#html_logo = None - -# The name of an image file (within the static path) to use as favicon of the -# docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 -# pixels large. -#html_favicon = None - -# Add any paths that contain custom static files (such as style sheets) here, -# relative to this directory. They are copied after the builtin static files, -# so a file named "default.css" will overwrite the builtin "default.css". -html_static_path = ['_static'] - -# If not '', a 'Last updated on:' timestamp is inserted at every page bottom, -# using the given strftime format. -#html_last_updated_fmt = '%b %d, %Y' - -# If true, SmartyPants will be used to convert quotes and dashes to -# typographically correct entities. -#html_use_smartypants = True - -# Custom sidebar templates, maps document names to template names. -#html_sidebars = {} - -# Additional templates that should be rendered to pages, maps page names to -# template names. -#html_additional_pages = {} - -# If false, no module index is generated. -#html_domain_indices = True - -# If false, no index is generated. -#html_use_index = True - -# If true, the index is split into individual pages for each letter. -#html_split_index = False - -# If true, links to the reST sources are added to the pages. -#html_show_sourcelink = True - -# If true, "Created using Sphinx" is shown in the HTML footer. Default is True. -#html_show_sphinx = True - -# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True. -#html_show_copyright = True - -# If true, an OpenSearch description file will be output, and all pages will -# contain a tag referring to it. The value of this option must be the -# base URL from which the finished HTML is served. -#html_use_opensearch = '' - -# This is the file name suffix for HTML files (e.g. ".xhtml"). -#html_file_suffix = None - # Output file base name for HTML help builder. htmlhelp_basename = 'PillowPILforkdoc' diff --git a/docs/requirements.txt b/docs/requirements.txt index 2359d711e..af38b4b69 100644 --- a/docs/requirements.txt +++ b/docs/requirements.txt @@ -10,6 +10,7 @@ Sphinx==1.1.3 docopt==0.6.1 docutils==0.11 wsgiref==0.1.2 +sphinx-better-theme==0.1.5 # livereload not strictly necessary but really useful (make livehtml) tornado==3.1.1