docs: fix build (#426)

Author: henryiii

docs/requirements.txt

@@ -2,5 +2,5 @@ nbsphinx
 numpy
 recommonmark>=0.5.0
 Sphinx>=2.0.0
-sphinx-book-theme
+sphinx-book-theme==0.0.30
 sphinx_copybutton

docs/usage/axes.rst

@@ -19,6 +19,7 @@ Regular axis
    :align: center
 
 .. py:function:: bh.axis.Regular(bins, start, stop, *, metadata="", underflow=True, overflow=True, circular=False, growth=False, transform=None)
+   :noindex:
 
 The regular axis can have overflow and/or underflow bins (enabled by default). It can also grow if ``growth=True`` is given. In general, you should not mix options, as growing axis will already have the correct flow bin settings. The exception is ``underflow=False, overflow=False``, which is quite useful together to make an axis with no flow bins at all.
 
@@ -29,6 +30,7 @@ There are some other useful axis types based on regular axis:
    :align: center
 
 .. py:function:: bh.axis.Regular(..., circular=True)
+   :noindex:
 
    This wraps around, so that out-of-range values map back into the valid range circularly.
 
@@ -48,14 +50,17 @@ functions, you can keep the high performance you would expect from a Regular axi
 precompiled transforms:
 
 .. py:function:: bh.axis.Regular(..., transform=bh.axis.transform.sqrt)
+   :noindex:
 
    This is an axis with bins transformed by a sqrt.
 
 .. py:function:: bh.axis.Regular(..., transform=bh.axis.transform.log)
+   :noindex:
 
    Transformed by log.
 
 .. py:function:: bh.axis.Regular(..., transform=bh.axis.transform.Power(v))
+   :noindex:
 
    Transformed by a power (the argument is the power).
 
@@ -68,6 +73,7 @@ Variable axis
    :align: center
 
 .. py:function:: bh.axis.Variable([edge1, ...], *, metadata="", underflow=True, overflow=True, circular=False, growth=False)
+   :noindex:
 
    You can set the bin edges explicitly with a variable axis. The options are mostly the same as the Regular axis.
 
@@ -79,6 +85,7 @@ Integer axis
    :align: center
 
 .. py:function:: bh.axis.Integer(start, stop, *, metadata="", underflow=True, overflow=True, circular=False, growth=False)
+   :noindex:
 
    This could be mimicked with a regular axis, but is simpler and slightly faster. Bins are whole integers only,
    so there is no need to specify the number of bins.
@@ -88,6 +95,7 @@ One common use for an integer axis could be a true/false axis:
 .. code:: python3
 
    bool_axis = bh.axis.Integer(0, 2, underflow=False, overflow=False)
+   :noindex:
 
 Another could be for an IntEnum (Python 3 or backport) if the values are contiguous.
 
@@ -99,6 +107,7 @@ Category axis
    :align: center
 
 .. py:function:: bh.axis.IntCategory([value1, ...], metadata="", grow=False)
+   :noindex:
 
    You should put integers in a category axis; but unlike an integer axis, the integers do not need to be adjacent.
 
@@ -113,9 +122,11 @@ One use for an IntCategory axis is for an IntEnum (Python 3):
         b = 5
 
     my_enum_axis = bh.axis.IntEnum(list(MyEnum), underflow=False, overflow=False)
+   :noindex:
 
 
 .. py:function:: bh.axis.StrCategory([str1, ...], metadata="", grow=False)
+   :noindex:
 
    You can put strings in a category axis as well. The fill method supports lists or arrays of strings
    to allow this to be filled.

setup.py

@@ -98,7 +98,7 @@ def build_extensions(self):
     "docs": [
         "Sphinx>=2.0.0",
         "recommonmark>=0.5.0",
-        "sphinx_rtd_theme",
+        "sphinx_book_theme==0.30.0",
         "nbsphinx",
         "sphinx_copybutton",
     ],