summaryrefslogtreecommitdiff
path: root/README.rst
blob: 94c7aa84303c10a5c77146ab5efe38be7ce224ca (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
scipy-sphinx-theme
==================

`Sphinx <http://sphinx-doc.org>`__ theme for `Scipy <http://scipy.org>`__.


Theme options
-------------

The theme takes the following options in the `html_options`
configuration variable:

- ``edit_link``

  ``True`` or ``False``. Determines if an "edit this page" link is displayed
  in the left sidebar.

- ``rootlinks``

  List of tuples ``(url, link_name)`` to show in the beginning of the
  breadcrumb list on the top left. You can override it by defining an
  `edit_link` block in ``searchbox.html``.

- ``sidebar``

  One of ``"left"``, ``"right"``, ``"none"``.  Defines where the sidebar
  should appear.

- ``scipy_org_logo``

  ``True`` or ``False``. Whether to plaster the scipy.org logo on top.

  You can use your own logo by overriding the :attr:`layout.html:header`
  block.

- ``navigation_links``

  ``True`` or ``False``. Whether to display "next", "prev", "index", etc.
  links.

The following blocks are defined:

- ``layout.html:header``
   
  Block at the top of the page, for logo etc.

- ``searchbox.html:edit_link``

  Edit link HTML code to paste in the left sidebar, if `edit_link` is enabled.