We are currently solving the following issue within our repository. Here is the issue text:
--- BEGIN ISSUE ---
Broken equations in docs
See for example the unredered tex in https://www.netket.org/docs/sr.html 

--- END ISSUE ---

Below are some code segments, each from a relevant file. One or more of these files may contain bugs.
--- BEGIN FILES ---
Path: `docs/conf.py`
Content:
```
1 import sphinx_bootstrap_theme
2 
3 # -- Project information -----------------------------------------------------
4 
5 project = "netket"
6 copyright = "2019-2021, The Netket authors - All rights reserved"
7 author = "Giuseppe Carleo et al."
8 
9 # The full version, including alpha/beta/rc tags
10 release = "v3.0"
11 
12 
13 # -- General configuration ---------------------------------------------------
14 
15 # Add any Sphinx extension module names here, as strings. They can be
16 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
17 # ones.
18 extensions = [
19     "sphinx.ext.napoleon",
20     "sphinx.ext.autodoc",
21     "sphinx_autodoc_typehints",
22     "sphinx.ext.autosummary",
23     "sphinx.ext.doctest",
24     "sphinx.ext.intersphinx",
25     "sphinx.ext.mathjax",
26     "sphinx.ext.viewcode",
27     "sphinx.ext.autosectionlabel",
28     "sphinx_reredirects",
29     "sphinx_panels",
30     "nbsphinx",
31     "myst_parser",
32 ]
33 
34 # Napoleon settings
35 autodoc_docstring_signature = True
36 autodoc_inherit_docstrings = True
37 allow_inherited = True
38 autosummary_generate = True
39 napoleon_preprocess_types = True
40 
41 panels_add_bootstrap_css = False
42 
43 master_doc = "index"
44 
45 autoclass_content = "class"
46 autodoc_class_signature = "separated"
47 autodoc_typehints = "description"
48 
49 # Add any paths that contain templates here, relative to this directory.
50 templates_path = ["_templates", "_templates/autosummary"]
51 
52 # List of patterns, relative to source directory, that match files and
53 # directories to ignore when looking for source files.
54 # This pattern also affects html_static_path and html_extra_path.
55 exclude_patterns = ["_build", "**.ipynb_checkpoints"]
56 
57 # The suffix(es) of source filenames.
58 # Note: important to list ipynb before md here: we have both md and ipynb
59 # copies of each notebook, and myst will choose which to convert based on
60 # the order in the source_suffix list. Notebooks which are not executed have
61 # outputs stored in ipynb but not in md, so we must convert the ipynb.
62 source_suffix = [".rst", ".ipynb", ".md"]
63 
64 # Markdown parser latex support
65 myst_enable_extensions = ["dollarmath", "amsmath"]
66 
67 mathjax_path = "https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"
68 
69 
70 # -- Options for HTML output -------------------------------------------------
71 
72 html_theme = "bootstrap"
73 html_theme_path = sphinx_bootstrap_theme.get_html_theme_path()
74 
75 # Add any paths that contain custom static files (such as style sheets) here,
76 # relative to this directory. They are copied after the builtin static files,
77 # so a file named "default.css" will overwrite the builtin "default.css".
78 html_static_path = ["_static"]
79 
80 # html_js_files = ["https://kit.fontawesome.com/7c145f31db.js"]
81 html_css_files = [
82     "jumbo-style.css",
83     "css/all.min.css",
84     "css/custom.css",
85     "css/rtd_theme.css",
86 ]
87 
88 html_js_files = [
89     "js/rtd_theme.js",
90 ]
91 
92 # Example configuration for intersphinx: refer to the Python standard library.
93 intersphinx_mapping = {
94     "python": ("https://docs.python.org/3/", None),
95     "numpy": ("https://numpy.org/doc/stable/", None),
96     "scipy": ("https://docs.scipy.org/doc/scipy/reference/", None),
97     "jax": ("https://jax.readthedocs.io/en/latest/", None),
98     "flax": ("https://flax.readthedocs.io/en/latest/", None),
99     # "networkx": ("https://networkx.org/doc/reference/", None),
100 }
101 
102 # (Optional) Logo. Should be small enough to fit the navbar (ideally 24x24).
103 # Path should be relative to the ``_static`` files directory.
104 html_logo = "_static/logonav.png"
105 
106 # Theme options are theme-specific and customize the look and feel of a
107 # theme further.
108 html_theme_options = {
109     # Navigation bar title. (Default: ``project`` value)
110     "navbar_title": "NetKet",
111     # Tab name for entire site. (Default: "Site")
112     "navbar_site_name": "Site",
113     # A list of tuples containing pages or urls to link to.
114     # Valid tuples should be in the following forms:
115     #    (name, page)                 # a link to a page
116     #    (name, "/aa/bb", 1)          # a link to an arbitrary relative url
117     #    (name, "http://example.com", True) # arbitrary absolute url
118     # Note the "1" or "True" value above as the third argument to indicate
119     # an arbitrary url.
120     "navbar_links": [
121         ("Get Started", "getting_started"),
122         ("Documentation", "docs/getting_started"),
123         ("Tutorials", "tutorials"),
124         ("Citing NetKet", "citing"),
125         ("About", "about"),
126         (
127             '<i class="fab fa-github" aria-hidden="true"></i>',
128             "https://github.com/netket/netket",
129             True,
130         ),
131         (
132             '<i class="fab fa-twitter" aria-hidden="true"></i>',
133             "https://twitter.com/NetKetOrg",
134             True,
135         ),
136     ],
137     # Render the next and previous page links in navbar. (Default: true)
138     "navbar_sidebarrel": False,
139     # Render the current pages TOC in the navbar. (Default: true)
140     "navbar_pagenav": False,
141     # Tab name for the current pages TOC. (Default: "Page")
142     "navbar_pagenav_name": "Page",
143     # Global TOC depth for "site" navbar tab. (Default: 1)
144     # Switching to -1 shows all levels.
145     "globaltoc_depth": 10,
146     # Include hidden TOCs in Site navbar?
147     #
148     # Note: If this is "false", you cannot have mixed ``:hidden:`` and
149     # non-hidden ``toctree`` directives in the same page, or else the build
150     # will break.
151     #
152     # Values: "true" (default) or "false"
153     "globaltoc_includehidden": "false",
154     # HTML navbar class (Default: "navbar") to attach to <div> element.
155     # For black navbar, do "navbar navbar-inverse"
156     "navbar_class": "navbar",
157     # Fix navigation bar to top of page?
158     # Values: "true" (default) or "false"
159     "navbar_fixed_top": "true",
160     # Location of link to source.
161     # Options are "nav" (default), "footer" or anything else to exclude.
162     "source_link_position": "none",
163     # Bootswatch (http://bootswatch.com/) theme.
164     #
165     # Options are nothing (default) or the name of a valid theme
166     # such as "cosmo" or "sandstone".
167     #
168     # The set of valid themes depend on the version of Bootstrap
169     # that's used (the next config option).
170     #
171     # Currently, the supported themes are:
172     # - Bootstrap 2: https://bootswatch.com/2
173     # - Bootstrap 3: https://bootswatch.com/3
174     "bootswatch_theme": "flatly",
175     # Choose Bootstrap version.
176     # Values: "3" (default) or "2" (in quotes)
177     "bootstrap_version": "3",
178 }
179 
180 html_sidebars = {
181     "docs/*": ["custom_localtoc.html"],
182     "docs/_generated/**/*": ["custom_localtoc.html"],
183     "modules/*": ["custom_localtoc.html"],
184 }
185 
186 ## redirects
187 redirects = {
188     "documentation": "docs/getting_started.html",
189 }
190 
191 
192 # do not show __init__ if it does not have a docstring
193 def autodoc_skip_member(app, what, name, obj, skip, options):
194     # Ref: https://stackoverflow.com/a/21449475/
195     exclusions = (
196         "__weakref__",  # special-members
197         "__doc__",
198         "__module__",
199         "__dict__",  # undoc-members
200     )
201     exclude = name in exclusions
202     if name == "__init__":
203         exclude = True if obj.__doc__ is None else False
204     return True if (skip or exclude) else None
205 
206 
207 ## bug in sphinx: take docstring
208 # def warn_undocumented_members(app, what, name, obj, options, lines):
209 #    if name.startswith("netket"):
210 #        print(f"Autodoc dostuff: {what}, {name}, {obj}, {lines}, {options}")
211 #        print(f"the type is {type(obj)}")
212 #        if obj.__doc__ == None:
213 #
214 #    else:
215 #        print(f"Autodoc cacca: {what}, {name}, {obj}, {lines}, {options}")
216 
217 
218 def setup(app):
219     app.connect("autodoc-skip-member", autodoc_skip_member)
220     # app.connect('autodoc-process-docstring', warn_undocumented_members);
221
```
--- END FILES ---

Please first localize the bug based on the issue statement, and then generate a patch according to the `git diff` format fenced by three backticks.

Here is an example:

```diff
diff --git a/examples/server_async.py b/examples/server_async.py
--- a/examples/server_async.py
+++ b/examples/server_async.py
@@ -313,4 +313,4 @@
 
 
 if __name__ == "__main__":
-    asyncio.run(run_async_server("."), debug=True)
+    asyncio.run(run_async_server(), debug=True)
diff --git a/examples/server_sync.py b/examples/server_sync.py
--- a/examples/server_sync.py
+++ b/examples/server_sync.py
@@ -313,5 +313,5 @@
 
 
 if __name__ == "__main__":
-    server = run_sync_server(".")
+    server = run_sync_server()
     server.shutdown()

```

diff --git a/docs/conf.py b/docs/conf.py
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -62,11 +62,10 @@
 source_suffix = [".rst", ".ipynb", ".md"]
 
 # Markdown parser latex support
-myst_enable_extensions = ["dollarmath", "amsmath"]
-
+myst_enable_extensions = ["dollarmath", "amsmath", "braket"]
+myst_update_mathjax = False
 mathjax_path = "https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"
 
-
 # -- Options for HTML output -------------------------------------------------
 
 html_theme = "bootstrap"

{"golden_diff": "diff --git a/docs/conf.py b/docs/conf.py\n--- a/docs/conf.py\n+++ b/docs/conf.py\n@@ -62,11 +62,10 @@\n source_suffix = [\".rst\", \".ipynb\", \".md\"]\n \n # Markdown parser latex support\n-myst_enable_extensions = [\"dollarmath\", \"amsmath\"]\n-\n+myst_enable_extensions = [\"dollarmath\", \"amsmath\", \"braket\"]\n+myst_update_mathjax = False\n mathjax_path = \"https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js\"\n \n-\n # -- Options for HTML output -------------------------------------------------\n \n html_theme = \"bootstrap\"\n", "issue": "Broken equations in docs\nSee for example the unredered tex in https://www.netket.org/docs/sr.html \n", "before_files": [{"content": "import sphinx_bootstrap_theme\n\n# -- Project information -----------------------------------------------------\n\nproject = \"netket\"\ncopyright = \"2019-2021, The Netket authors - All rights reserved\"\nauthor = \"Giuseppe Carleo et al.\"\n\n# The full version, including alpha/beta/rc tags\nrelease = \"v3.0\"\n\n\n# -- General configuration ---------------------------------------------------\n\n# Add any Sphinx extension module names here, as strings. They can be\n# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom\n# ones.\nextensions = [\n    \"sphinx.ext.napoleon\",\n    \"sphinx.ext.autodoc\",\n    \"sphinx_autodoc_typehints\",\n    \"sphinx.ext.autosummary\",\n    \"sphinx.ext.doctest\",\n    \"sphinx.ext.intersphinx\",\n    \"sphinx.ext.mathjax\",\n    \"sphinx.ext.viewcode\",\n    \"sphinx.ext.autosectionlabel\",\n    \"sphinx_reredirects\",\n    \"sphinx_panels\",\n    \"nbsphinx\",\n    \"myst_parser\",\n]\n\n# Napoleon settings\nautodoc_docstring_signature = True\nautodoc_inherit_docstrings = True\nallow_inherited = True\nautosummary_generate = True\nnapoleon_preprocess_types = True\n\npanels_add_bootstrap_css = False\n\nmaster_doc = \"index\"\n\nautoclass_content = \"class\"\nautodoc_class_signature = \"separated\"\nautodoc_typehints = \"description\"\n\n# Add any paths that contain templates here, relative to this directory.\ntemplates_path = [\"_templates\", \"_templates/autosummary\"]\n\n# List of patterns, relative to source directory, that match files and\n# directories to ignore when looking for source files.\n# This pattern also affects html_static_path and html_extra_path.\nexclude_patterns = [\"_build\", \"**.ipynb_checkpoints\"]\n\n# The suffix(es) of source filenames.\n# Note: important to list ipynb before md here: we have both md and ipynb\n# copies of each notebook, and myst will choose which to convert based on\n# the order in the source_suffix list. Notebooks which are not executed have\n# outputs stored in ipynb but not in md, so we must convert the ipynb.\nsource_suffix = [\".rst\", \".ipynb\", \".md\"]\n\n# Markdown parser latex support\nmyst_enable_extensions = [\"dollarmath\", \"amsmath\"]\n\nmathjax_path = \"https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js\"\n\n\n# -- Options for HTML output -------------------------------------------------\n\nhtml_theme = \"bootstrap\"\nhtml_theme_path = sphinx_bootstrap_theme.get_html_theme_path()\n\n# Add any paths that contain custom static files (such as style sheets) here,\n# relative to this directory. They are copied after the builtin static files,\n# so a file named \"default.css\" will overwrite the builtin \"default.css\".\nhtml_static_path = [\"_static\"]\n\n# html_js_files = [\"https://kit.fontawesome.com/7c145f31db.js\"]\nhtml_css_files = [\n    \"jumbo-style.css\",\n    \"css/all.min.css\",\n    \"css/custom.css\",\n    \"css/rtd_theme.css\",\n]\n\nhtml_js_files = [\n    \"js/rtd_theme.js\",\n]\n\n# Example configuration for intersphinx: refer to the Python standard library.\nintersphinx_mapping = {\n    \"python\": (\"https://docs.python.org/3/\", None),\n    \"numpy\": (\"https://numpy.org/doc/stable/\", None),\n    \"scipy\": (\"https://docs.scipy.org/doc/scipy/reference/\", None),\n    \"jax\": (\"https://jax.readthedocs.io/en/latest/\", None),\n    \"flax\": (\"https://flax.readthedocs.io/en/latest/\", None),\n    # \"networkx\": (\"https://networkx.org/doc/reference/\", None),\n}\n\n# (Optional) Logo. Should be small enough to fit the navbar (ideally 24x24).\n# Path should be relative to the ``_static`` files directory.\nhtml_logo = \"_static/logonav.png\"\n\n# Theme options are theme-specific and customize the look and feel of a\n# theme further.\nhtml_theme_options = {\n    # Navigation bar title. (Default: ``project`` value)\n    \"navbar_title\": \"NetKet\",\n    # Tab name for entire site. (Default: \"Site\")\n    \"navbar_site_name\": \"Site\",\n    # A list of tuples containing pages or urls to link to.\n    # Valid tuples should be in the following forms:\n    #    (name, page)                 # a link to a page\n    #    (name, \"/aa/bb\", 1)          # a link to an arbitrary relative url\n    #    (name, \"http://example.com\", True) # arbitrary absolute url\n    # Note the \"1\" or \"True\" value above as the third argument to indicate\n    # an arbitrary url.\n    \"navbar_links\": [\n        (\"Get Started\", \"getting_started\"),\n        (\"Documentation\", \"docs/getting_started\"),\n        (\"Tutorials\", \"tutorials\"),\n        (\"Citing NetKet\", \"citing\"),\n        (\"About\", \"about\"),\n        (\n            '<i class=\"fab fa-github\" aria-hidden=\"true\"></i>',\n            \"https://github.com/netket/netket\",\n            True,\n        ),\n        (\n            '<i class=\"fab fa-twitter\" aria-hidden=\"true\"></i>',\n            \"https://twitter.com/NetKetOrg\",\n            True,\n        ),\n    ],\n    # Render the next and previous page links in navbar. (Default: true)\n    \"navbar_sidebarrel\": False,\n    # Render the current pages TOC in the navbar. (Default: true)\n    \"navbar_pagenav\": False,\n    # Tab name for the current pages TOC. (Default: \"Page\")\n    \"navbar_pagenav_name\": \"Page\",\n    # Global TOC depth for \"site\" navbar tab. (Default: 1)\n    # Switching to -1 shows all levels.\n    \"globaltoc_depth\": 10,\n    # Include hidden TOCs in Site navbar?\n    #\n    # Note: If this is \"false\", you cannot have mixed ``:hidden:`` and\n    # non-hidden ``toctree`` directives in the same page, or else the build\n    # will break.\n    #\n    # Values: \"true\" (default) or \"false\"\n    \"globaltoc_includehidden\": \"false\",\n    # HTML navbar class (Default: \"navbar\") to attach to <div> element.\n    # For black navbar, do \"navbar navbar-inverse\"\n    \"navbar_class\": \"navbar\",\n    # Fix navigation bar to top of page?\n    # Values: \"true\" (default) or \"false\"\n    \"navbar_fixed_top\": \"true\",\n    # Location of link to source.\n    # Options are \"nav\" (default), \"footer\" or anything else to exclude.\n    \"source_link_position\": \"none\",\n    # Bootswatch (http://bootswatch.com/) theme.\n    #\n    # Options are nothing (default) or the name of a valid theme\n    # such as \"cosmo\" or \"sandstone\".\n    #\n    # The set of valid themes depend on the version of Bootstrap\n    # that's used (the next config option).\n    #\n    # Currently, the supported themes are:\n    # - Bootstrap 2: https://bootswatch.com/2\n    # - Bootstrap 3: https://bootswatch.com/3\n    \"bootswatch_theme\": \"flatly\",\n    # Choose Bootstrap version.\n    # Values: \"3\" (default) or \"2\" (in quotes)\n    \"bootstrap_version\": \"3\",\n}\n\nhtml_sidebars = {\n    \"docs/*\": [\"custom_localtoc.html\"],\n    \"docs/_generated/**/*\": [\"custom_localtoc.html\"],\n    \"modules/*\": [\"custom_localtoc.html\"],\n}\n\n## redirects\nredirects = {\n    \"documentation\": \"docs/getting_started.html\",\n}\n\n\n# do not show __init__ if it does not have a docstring\ndef autodoc_skip_member(app, what, name, obj, skip, options):\n    # Ref: https://stackoverflow.com/a/21449475/\n    exclusions = (\n        \"__weakref__\",  # special-members\n        \"__doc__\",\n        \"__module__\",\n        \"__dict__\",  # undoc-members\n    )\n    exclude = name in exclusions\n    if name == \"__init__\":\n        exclude = True if obj.__doc__ is None else False\n    return True if (skip or exclude) else None\n\n\n## bug in sphinx: take docstring\n# def warn_undocumented_members(app, what, name, obj, options, lines):\n#    if name.startswith(\"netket\"):\n#        print(f\"Autodoc dostuff: {what}, {name}, {obj}, {lines}, {options}\")\n#        print(f\"the type is {type(obj)}\")\n#        if obj.__doc__ == None:\n#\n#    else:\n#        print(f\"Autodoc cacca: {what}, {name}, {obj}, {lines}, {options}\")\n\n\ndef setup(app):\n    app.connect(\"autodoc-skip-member\", autodoc_skip_member)\n    # app.connect('autodoc-process-docstring', warn_undocumented_members);\n", "path": "docs/conf.py"}], "after_files": [{"content": "import sphinx_bootstrap_theme\n\n# -- Project information -----------------------------------------------------\n\nproject = \"netket\"\ncopyright = \"2019-2021, The Netket authors - All rights reserved\"\nauthor = \"Giuseppe Carleo et al.\"\n\n# The full version, including alpha/beta/rc tags\nrelease = \"v3.0\"\n\n\n# -- General configuration ---------------------------------------------------\n\n# Add any Sphinx extension module names here, as strings. They can be\n# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom\n# ones.\nextensions = [\n    \"sphinx.ext.napoleon\",\n    \"sphinx.ext.autodoc\",\n    \"sphinx_autodoc_typehints\",\n    \"sphinx.ext.autosummary\",\n    \"sphinx.ext.doctest\",\n    \"sphinx.ext.intersphinx\",\n    \"sphinx.ext.mathjax\",\n    \"sphinx.ext.viewcode\",\n    \"sphinx.ext.autosectionlabel\",\n    \"sphinx_reredirects\",\n    \"sphinx_panels\",\n    \"nbsphinx\",\n    \"myst_parser\",\n]\n\n# Napoleon settings\nautodoc_docstring_signature = True\nautodoc_inherit_docstrings = True\nallow_inherited = True\nautosummary_generate = True\nnapoleon_preprocess_types = True\n\npanels_add_bootstrap_css = False\n\nmaster_doc = \"index\"\n\nautoclass_content = \"class\"\nautodoc_class_signature = \"separated\"\nautodoc_typehints = \"description\"\n\n# Add any paths that contain templates here, relative to this directory.\ntemplates_path = [\"_templates\", \"_templates/autosummary\"]\n\n# List of patterns, relative to source directory, that match files and\n# directories to ignore when looking for source files.\n# This pattern also affects html_static_path and html_extra_path.\nexclude_patterns = [\"_build\", \"**.ipynb_checkpoints\"]\n\n# The suffix(es) of source filenames.\n# Note: important to list ipynb before md here: we have both md and ipynb\n# copies of each notebook, and myst will choose which to convert based on\n# the order in the source_suffix list. Notebooks which are not executed have\n# outputs stored in ipynb but not in md, so we must convert the ipynb.\nsource_suffix = [\".rst\", \".ipynb\", \".md\"]\n\n# Markdown parser latex support\nmyst_enable_extensions = [\"dollarmath\", \"amsmath\", \"braket\"]\nmyst_update_mathjax = False\nmathjax_path = \"https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js\"\n\n# -- Options for HTML output -------------------------------------------------\n\nhtml_theme = \"bootstrap\"\nhtml_theme_path = sphinx_bootstrap_theme.get_html_theme_path()\n\n# Add any paths that contain custom static files (such as style sheets) here,\n# relative to this directory. They are copied after the builtin static files,\n# so a file named \"default.css\" will overwrite the builtin \"default.css\".\nhtml_static_path = [\"_static\"]\n\n# html_js_files = [\"https://kit.fontawesome.com/7c145f31db.js\"]\nhtml_css_files = [\n    \"jumbo-style.css\",\n    \"css/all.min.css\",\n    \"css/custom.css\",\n    \"css/rtd_theme.css\",\n]\n\nhtml_js_files = [\n    \"js/rtd_theme.js\",\n]\n\n# Example configuration for intersphinx: refer to the Python standard library.\nintersphinx_mapping = {\n    \"python\": (\"https://docs.python.org/3/\", None),\n    \"numpy\": (\"https://numpy.org/doc/stable/\", None),\n    \"scipy\": (\"https://docs.scipy.org/doc/scipy/reference/\", None),\n    \"jax\": (\"https://jax.readthedocs.io/en/latest/\", None),\n    \"flax\": (\"https://flax.readthedocs.io/en/latest/\", None),\n    # \"networkx\": (\"https://networkx.org/doc/reference/\", None),\n}\n\n# (Optional) Logo. Should be small enough to fit the navbar (ideally 24x24).\n# Path should be relative to the ``_static`` files directory.\nhtml_logo = \"_static/logonav.png\"\n\n# Theme options are theme-specific and customize the look and feel of a\n# theme further.\nhtml_theme_options = {\n    # Navigation bar title. (Default: ``project`` value)\n    \"navbar_title\": \"NetKet\",\n    # Tab name for entire site. (Default: \"Site\")\n    \"navbar_site_name\": \"Site\",\n    # A list of tuples containing pages or urls to link to.\n    # Valid tuples should be in the following forms:\n    #    (name, page)                 # a link to a page\n    #    (name, \"/aa/bb\", 1)          # a link to an arbitrary relative url\n    #    (name, \"http://example.com\", True) # arbitrary absolute url\n    # Note the \"1\" or \"True\" value above as the third argument to indicate\n    # an arbitrary url.\n    \"navbar_links\": [\n        (\"Get Started\", \"getting_started\"),\n        (\"Documentation\", \"docs/getting_started\"),\n        (\"Tutorials\", \"tutorials\"),\n        (\"Citing NetKet\", \"citing\"),\n        (\"About\", \"about\"),\n        (\n            '<i class=\"fab fa-github\" aria-hidden=\"true\"></i>',\n            \"https://github.com/netket/netket\",\n            True,\n        ),\n        (\n            '<i class=\"fab fa-twitter\" aria-hidden=\"true\"></i>',\n            \"https://twitter.com/NetKetOrg\",\n            True,\n        ),\n    ],\n    # Render the next and previous page links in navbar. (Default: true)\n    \"navbar_sidebarrel\": False,\n    # Render the current pages TOC in the navbar. (Default: true)\n    \"navbar_pagenav\": False,\n    # Tab name for the current pages TOC. (Default: \"Page\")\n    \"navbar_pagenav_name\": \"Page\",\n    # Global TOC depth for \"site\" navbar tab. (Default: 1)\n    # Switching to -1 shows all levels.\n    \"globaltoc_depth\": 10,\n    # Include hidden TOCs in Site navbar?\n    #\n    # Note: If this is \"false\", you cannot have mixed ``:hidden:`` and\n    # non-hidden ``toctree`` directives in the same page, or else the build\n    # will break.\n    #\n    # Values: \"true\" (default) or \"false\"\n    \"globaltoc_includehidden\": \"false\",\n    # HTML navbar class (Default: \"navbar\") to attach to <div> element.\n    # For black navbar, do \"navbar navbar-inverse\"\n    \"navbar_class\": \"navbar\",\n    # Fix navigation bar to top of page?\n    # Values: \"true\" (default) or \"false\"\n    \"navbar_fixed_top\": \"true\",\n    # Location of link to source.\n    # Options are \"nav\" (default), \"footer\" or anything else to exclude.\n    \"source_link_position\": \"none\",\n    # Bootswatch (http://bootswatch.com/) theme.\n    #\n    # Options are nothing (default) or the name of a valid theme\n    # such as \"cosmo\" or \"sandstone\".\n    #\n    # The set of valid themes depend on the version of Bootstrap\n    # that's used (the next config option).\n    #\n    # Currently, the supported themes are:\n    # - Bootstrap 2: https://bootswatch.com/2\n    # - Bootstrap 3: https://bootswatch.com/3\n    \"bootswatch_theme\": \"flatly\",\n    # Choose Bootstrap version.\n    # Values: \"3\" (default) or \"2\" (in quotes)\n    \"bootstrap_version\": \"3\",\n}\n\nhtml_sidebars = {\n    \"docs/*\": [\"custom_localtoc.html\"],\n    \"docs/_generated/**/*\": [\"custom_localtoc.html\"],\n    \"modules/*\": [\"custom_localtoc.html\"],\n}\n\n## redirects\nredirects = {\n    \"documentation\": \"docs/getting_started.html\",\n}\n\n\n# do not show __init__ if it does not have a docstring\ndef autodoc_skip_member(app, what, name, obj, skip, options):\n    # Ref: https://stackoverflow.com/a/21449475/\n    exclusions = (\n        \"__weakref__\",  # special-members\n        \"__doc__\",\n        \"__module__\",\n        \"__dict__\",  # undoc-members\n    )\n    exclude = name in exclusions\n    if name == \"__init__\":\n        exclude = True if obj.__doc__ is None else False\n    return True if (skip or exclude) else None\n\n\n## bug in sphinx: take docstring\n# def warn_undocumented_members(app, what, name, obj, options, lines):\n#    if name.startswith(\"netket\"):\n#        print(f\"Autodoc dostuff: {what}, {name}, {obj}, {lines}, {options}\")\n#        print(f\"the type is {type(obj)}\")\n#        if obj.__doc__ == None:\n#\n#    else:\n#        print(f\"Autodoc cacca: {what}, {name}, {obj}, {lines}, {options}\")\n\n\ndef setup(app):\n    app.connect(\"autodoc-skip-member\", autodoc_skip_member)\n    # app.connect('autodoc-process-docstring', warn_undocumented_members);\n", "path": "docs/conf.py"}]}