mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2025-02-25 18:55:22 -06:00
Closes #3829: add `html_sidebars
` default to sphinx-quickstart
This commit is contained in:
parent
ee13085258
commit
075a8cfb8f
1
CHANGES
1
CHANGES
@ -17,6 +17,7 @@ Bugs fixed
|
|||||||
----------
|
----------
|
||||||
|
|
||||||
* #3821: Failed to import sphinx.util.compat with docutils-0.14rc1
|
* #3821: Failed to import sphinx.util.compat with docutils-0.14rc1
|
||||||
|
* #3829: sphinx-quickstart template is incomplete regarding use of alabaster
|
||||||
|
|
||||||
Testing
|
Testing
|
||||||
--------
|
--------
|
||||||
|
@ -119,10 +119,12 @@ These themes are:
|
|||||||
|
|
||||||
* **alabaster** -- `Alabaster theme`_ is a modified "Kr" Sphinx theme from @kennethreitz
|
* **alabaster** -- `Alabaster theme`_ is a modified "Kr" Sphinx theme from @kennethreitz
|
||||||
(especially as used in his Requests project), which was itself originally based on
|
(especially as used in his Requests project), which was itself originally based on
|
||||||
@mitsuhiko's theme used for Flask & related projects. You can get options information
|
@mitsuhiko's theme used for Flask & related projects.
|
||||||
at `Alabaster theme`_ page.
|
Check out at its `installation page`_ how to set up properly
|
||||||
|
:confval:`html_sidebars` for its use.
|
||||||
|
|
||||||
.. _Alabaster theme: https://pypi.python.org/pypi/alabaster
|
.. _Alabaster theme: https://pypi.python.org/pypi/alabaster
|
||||||
|
.. _installation page: http://alabaster.readthedocs.io/en/latest/installation.html
|
||||||
|
|
||||||
* **classic** -- This is the classic theme, which looks like `the Python 2
|
* **classic** -- This is the classic theme, which looks like `the Python 2
|
||||||
documentation <https://docs.python.org/2/>`_. It can be customized via
|
documentation <https://docs.python.org/2/>`_. It can be customized via
|
||||||
|
@ -96,6 +96,18 @@ todo_include_todos = {{ ext_todo }}
|
|||||||
#
|
#
|
||||||
html_theme = 'alabaster'
|
html_theme = 'alabaster'
|
||||||
|
|
||||||
|
# refs: http://alabaster.readthedocs.io/en/latest/installation.html#sidebars
|
||||||
|
html_sidebars = {
|
||||||
|
'**': [
|
||||||
|
'about.html',
|
||||||
|
'navigation.html',
|
||||||
|
# 'relations.html', # hidden by alabaster css anyway
|
||||||
|
'searchbox.html',
|
||||||
|
# 'donate.html',
|
||||||
|
]
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
# Theme options are theme-specific and customize the look and feel of a theme
|
# 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
|
# further. For a list of options available for each theme, see the
|
||||||
# documentation.
|
# documentation.
|
||||||
|
Loading…
Reference in New Issue
Block a user