We are currently solving the following issue within our repository. Here is the issue text:
--- BEGIN ISSUE ---
Tests are failing in "Build Docs", possibly due to new Sphinx theme
              Is pydata_sphinx_theme broken, perhaps? It had a 0.13 release 12 hours ago.

_Originally posted by @henryiii in https://github.com/scikit-hep/awkward/issues/2268#issuecomment-1448934363_

For example, https://github.com/scikit-hep/awkward/actions/runs/4297198800/jobs/7489883737

This open issue, https://github.com/pydata/pydata-sphinx-theme/issues/1149, has the same error message and they say

> I think it ought to be possible to run our basic dev commands (test, docs, docs-live) in the dev environment we recommend contributors to use

which sounds like something we do.

--- 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 # Configuration file for the Sphinx documentation builder.
2 #
3 # This file only contains a selection of the most common options. For a full
4 # list see the documentation:
5 # https://www.sphinx-doc.org/en/master/usage/configuration.html
6 
7 # -- Path setup --------------------------------------------------------------
8 
9 # If extensions (or modules to document with autodoc) are in another directory,
10 # add these directories to sys.path here. If the directory is relative to the
11 # documentation root, use os.path.abspath to make it absolute, like shown here.
12 #
13 import awkward
14 import datetime
15 import os
16 import runpy
17 import pathlib
18 
19 # -- Project information -----------------------------------------------------
20 
21 project = "Awkward Array"
22 copyright = f"{datetime.datetime.now().year}, Awkward Array development team"
23 author = "Jim Pivarski"
24 
25 parts = awkward.__version__.split(".")
26 version = ".".join(parts[:2])
27 release = ".".join(parts)
28 
29 # -- General configuration ---------------------------------------------------
30 
31 # Add any Sphinx extension module names here, as strings. They can be
32 # extensions coming with Sphinx (named "sphinx.ext.*") or your custom
33 # ones.
34 extensions = [
35     "sphinx_copybutton",
36     "sphinx_design",
37     "sphinx_external_toc",
38     "sphinx.ext.intersphinx",
39     "myst_nb",
40     # Preserve old links
41     "jupyterlite_sphinx",
42     "IPython.sphinxext.ipython_console_highlighting",
43     "IPython.sphinxext.ipython_directive",
44 ]
45 
46 # Allow the CI to set version_match="main"
47 if "DOCS_VERSION" in os.environ:
48     version_match = os.environ["DOCS_VERSION"]
49 else:
50     version_match = version
51 
52 
53 # Specify a canonical version
54 if "DOCS_CANONICAL_VERSION" in os.environ:
55     canonical_version = os.environ["DOCS_CANONICAL_VERSION"]
56     html_baseurl = f"https://awkward-array.org/doc/{canonical_version}/"
57 
58     # Build sitemap on main
59     if version_match == canonical_version:
60         extensions.append("sphinx_sitemap")
61         # Sitemap URLs are relative to `html_baseurl`
62         sitemap_url_scheme = "{link}"
63 
64 # Add any paths that contain templates here, relative to this directory.
65 templates_path = ["_templates"]
66 
67 # List of patterns, relative to source directory, that match files and
68 # directories to ignore when looking for source files.
69 # This pattern also affects html_static_path and html_extra_path.
70 exclude_patterns = ["_build", "_templates", "Thumbs.db", "jupyter_execute", ".*"]
71 
72 # -- Options for HTML output -------------------------------------------------
73 
74 # The theme to use for HTML and HTML Help pages.  See the documentation for
75 # a list of builtin themes.
76 
77 html_context = {
78     "github_user": "scikit-hep",
79     "github_repo": "awkward",
80     "github_version": "main",
81     "doc_path": "docs",
82 }
83 html_theme = "pydata_sphinx_theme"
84 html_show_sourcelink = True
85 html_theme_options = {
86     "logo": {
87         "image_light": "image/logo-300px.png",
88         "image_dark": "image/logo-300px-white.png",
89     },
90     "github_url": "https://github.com/scikit-hep/awkward",
91     # Add light/dark mode and documentation version switcher:
92     "navbar_end": ["theme-switcher", "navbar-icon-links"],
93     "footer_items": ["copyright", "sphinx-version", "funding"],
94     "icon_links": [
95         {
96             "name": "PyPI",
97             "url": "https://pypi.org/project/awkward",
98             "icon": "fab fa-python",
99         }
100     ],
101     "use_edit_page_button": True,
102     "external_links": [
103         {
104             "name": "Contributor guide",
105             "url": "https://github.com/scikit-hep/awkward/blob/main/CONTRIBUTING.md",
106         },
107         {
108             "name": "Release history",
109             "url": "https://github.com/scikit-hep/awkward/releases",
110         },
111     ],
112 }
113 
114 # Disable analytics for previews
115 if "DOCS_REPORT_ANALYTICS" in os.environ:
116     html_theme_options["analytics"] = {
117         "plausible_analytics_domain": "awkward-array.org",
118         "plausible_analytics_url": "https://views.scientific-python.org/js/plausible.js",
119     }
120 
121 # Don't show version for offline builds by default
122 if "DOCS_SHOW_VERSION" in os.environ:
123     html_theme_options["switcher"] = {
124         "json_url": "https://awkward-array.org/doc/switcher.json",
125         "version_match": version_match,
126     }
127     html_theme_options["navbar_start"] = ["navbar-logo", "version-switcher"]
128 
129 # Add any paths that contain custom static files (such as style sheets) here,
130 # relative to this directory. They are copied after the builtin static files,
131 # so a file named "default.css" will overwrite the builtin "default.css".
132 html_static_path = ["_static"]
133 html_css_files = ["css/awkward.css"]
134 
135 # MyST settings
136 myst_enable_extensions = ["colon_fence"]
137 
138 nb_execution_mode = "cache"
139 nb_execution_raise_on_error = True
140 # unpkg is currently _very_ slow
141 nb_ipywidgets_js = {
142     # Load RequireJS, used by the IPywidgets for dependency management
143     "https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js": {
144         "integrity": "sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=",
145         "crossorigin": "anonymous",
146     },
147     # Load IPywidgets bundle for embedding.
148     "https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@0.20.0/dist/embed-amd.js": {
149         "data-jupyter-widgets-cdn": "https://cdn.jsdelivr.net/npm/",
150         "crossorigin": "anonymous",
151     },
152 }
153 nb_execution_show_tb = True
154 
155 # Additional stuff
156 master_doc = "index"
157 
158 # Cross-reference existing Python objects
159 intersphinx_mapping = {
160     "python": ("https://docs.python.org/3/", None),
161     "pandas": ("https://pandas.pydata.org/pandas-docs/stable", None),
162     "numpy": ("https://numpy.org/doc/stable", None),
163     "scipy": ("https://docs.scipy.org/doc/scipy", None),
164     "numba": ("https://numba.pydata.org/numba-doc/latest", None),
165     "arrow": ("https://arrow.apache.org/docs/", None),
166     "jax": ("https://jax.readthedocs.io/en/latest", None),
167 }
168 
169 
170 # JupyterLite configuration
171 jupyterlite_dir = "./lite"
172 # Don't override ipynb format
173 jupyterlite_bind_ipynb_suffix = False
174 # We've disabled localstorage, so we must provide the contents explicitly
175 jupyterlite_contents = ["getting-started/demo/*"]
176 
177 linkcheck_ignore = [
178     r"^https?:\/\/github\.com\/.*$",
179     r"^getting-started\/try-awkward-array\.html$",  # Relative link won't resolve
180     r"^https?:\/\/$",  # Bare https:// allowed
181 ]
182 # Eventually we need to revisit these
183 if (datetime.date.today() - datetime.date(2022, 12, 13)) < datetime.timedelta(days=30):
184     linkcheck_ignore.extend(
185         [
186             r"^https:\/\/doi.org\/10\.1051\/epjconf\/202024505023$",
187             r"^https:\/\/doi.org\/10\.1051\/epjconf\/202125103002$",
188         ]
189     )
190 
191 # Generate Python docstrings
192 HERE = pathlib.Path(__file__).parent
193 runpy.run_path(HERE / "prepare_docstrings.py", run_name="__main__")
194 
195 
196 # Sphinx doesn't usually want content to fit the screen, so we hack the styles for this page
197 def install_jupyterlite_styles(app, pagename, templatename, context, event_arg) -> None:
198     if pagename != "getting-started/try-awkward-array":
199         return
200 
201     app.add_css_file("css/try-awkward-array.css")
202 
203 
204 def setup(app):
205     app.connect("html-page-context", install_jupyterlite_styles)
206
```
--- 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
@@ -84,13 +84,13 @@
 html_show_sourcelink = True
 html_theme_options = {
     "logo": {
-        "image_light": "image/logo-300px.png",
-        "image_dark": "image/logo-300px-white.png",
+        "image_light": "_static/image/logo-300px.png",
+        "image_dark": "_static/image/logo-300px-white.png",
     },
     "github_url": "https://github.com/scikit-hep/awkward",
     # Add light/dark mode and documentation version switcher:
     "navbar_end": ["theme-switcher", "navbar-icon-links"],
-    "footer_items": ["copyright", "sphinx-version", "funding"],
+    "footer_start": ["copyright", "sphinx-version", "funding"],
     "icon_links": [
         {
             "name": "PyPI",

{"golden_diff": "diff --git a/docs/conf.py b/docs/conf.py\n--- a/docs/conf.py\n+++ b/docs/conf.py\n@@ -84,13 +84,13 @@\n html_show_sourcelink = True\n html_theme_options = {\n     \"logo\": {\n-        \"image_light\": \"image/logo-300px.png\",\n-        \"image_dark\": \"image/logo-300px-white.png\",\n+        \"image_light\": \"_static/image/logo-300px.png\",\n+        \"image_dark\": \"_static/image/logo-300px-white.png\",\n     },\n     \"github_url\": \"https://github.com/scikit-hep/awkward\",\n     # Add light/dark mode and documentation version switcher:\n     \"navbar_end\": [\"theme-switcher\", \"navbar-icon-links\"],\n-    \"footer_items\": [\"copyright\", \"sphinx-version\", \"funding\"],\n+    \"footer_start\": [\"copyright\", \"sphinx-version\", \"funding\"],\n     \"icon_links\": [\n         {\n             \"name\": \"PyPI\",\n", "issue": "Tests are failing in \"Build Docs\", possibly due to new Sphinx theme\n              Is pydata_sphinx_theme broken, perhaps? It had a 0.13 release 12 hours ago.\r\n\r\n_Originally posted by @henryiii in https://github.com/scikit-hep/awkward/issues/2268#issuecomment-1448934363_\r\n\r\nFor example, https://github.com/scikit-hep/awkward/actions/runs/4297198800/jobs/7489883737\r\n\r\nThis open issue, https://github.com/pydata/pydata-sphinx-theme/issues/1149, has the same error message and they say\r\n\r\n> I think it ought to be possible to run our basic dev commands (test, docs, docs-live) in the dev environment we recommend contributors to use\r\n\r\nwhich sounds like something we do.\n", "before_files": [{"content": "# Configuration file for the Sphinx documentation builder.\n#\n# This file only contains a selection of the most common options. For a full\n# list see the documentation:\n# https://www.sphinx-doc.org/en/master/usage/configuration.html\n\n# -- Path setup --------------------------------------------------------------\n\n# If extensions (or modules to document with autodoc) are in another directory,\n# add these directories to sys.path here. If the directory is relative to the\n# documentation root, use os.path.abspath to make it absolute, like shown here.\n#\nimport awkward\nimport datetime\nimport os\nimport runpy\nimport pathlib\n\n# -- Project information -----------------------------------------------------\n\nproject = \"Awkward Array\"\ncopyright = f\"{datetime.datetime.now().year}, Awkward Array development team\"\nauthor = \"Jim Pivarski\"\n\nparts = awkward.__version__.split(\".\")\nversion = \".\".join(parts[:2])\nrelease = \".\".join(parts)\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_copybutton\",\n    \"sphinx_design\",\n    \"sphinx_external_toc\",\n    \"sphinx.ext.intersphinx\",\n    \"myst_nb\",\n    # Preserve old links\n    \"jupyterlite_sphinx\",\n    \"IPython.sphinxext.ipython_console_highlighting\",\n    \"IPython.sphinxext.ipython_directive\",\n]\n\n# Allow the CI to set version_match=\"main\"\nif \"DOCS_VERSION\" in os.environ:\n    version_match = os.environ[\"DOCS_VERSION\"]\nelse:\n    version_match = version\n\n\n# Specify a canonical version\nif \"DOCS_CANONICAL_VERSION\" in os.environ:\n    canonical_version = os.environ[\"DOCS_CANONICAL_VERSION\"]\n    html_baseurl = f\"https://awkward-array.org/doc/{canonical_version}/\"\n\n    # Build sitemap on main\n    if version_match == canonical_version:\n        extensions.append(\"sphinx_sitemap\")\n        # Sitemap URLs are relative to `html_baseurl`\n        sitemap_url_scheme = \"{link}\"\n\n# Add any paths that contain templates here, relative to this directory.\ntemplates_path = [\"_templates\"]\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\", \"_templates\", \"Thumbs.db\", \"jupyter_execute\", \".*\"]\n\n# -- Options for HTML output -------------------------------------------------\n\n# The theme to use for HTML and HTML Help pages.  See the documentation for\n# a list of builtin themes.\n\nhtml_context = {\n    \"github_user\": \"scikit-hep\",\n    \"github_repo\": \"awkward\",\n    \"github_version\": \"main\",\n    \"doc_path\": \"docs\",\n}\nhtml_theme = \"pydata_sphinx_theme\"\nhtml_show_sourcelink = True\nhtml_theme_options = {\n    \"logo\": {\n        \"image_light\": \"image/logo-300px.png\",\n        \"image_dark\": \"image/logo-300px-white.png\",\n    },\n    \"github_url\": \"https://github.com/scikit-hep/awkward\",\n    # Add light/dark mode and documentation version switcher:\n    \"navbar_end\": [\"theme-switcher\", \"navbar-icon-links\"],\n    \"footer_items\": [\"copyright\", \"sphinx-version\", \"funding\"],\n    \"icon_links\": [\n        {\n            \"name\": \"PyPI\",\n            \"url\": \"https://pypi.org/project/awkward\",\n            \"icon\": \"fab fa-python\",\n        }\n    ],\n    \"use_edit_page_button\": True,\n    \"external_links\": [\n        {\n            \"name\": \"Contributor guide\",\n            \"url\": \"https://github.com/scikit-hep/awkward/blob/main/CONTRIBUTING.md\",\n        },\n        {\n            \"name\": \"Release history\",\n            \"url\": \"https://github.com/scikit-hep/awkward/releases\",\n        },\n    ],\n}\n\n# Disable analytics for previews\nif \"DOCS_REPORT_ANALYTICS\" in os.environ:\n    html_theme_options[\"analytics\"] = {\n        \"plausible_analytics_domain\": \"awkward-array.org\",\n        \"plausible_analytics_url\": \"https://views.scientific-python.org/js/plausible.js\",\n    }\n\n# Don't show version for offline builds by default\nif \"DOCS_SHOW_VERSION\" in os.environ:\n    html_theme_options[\"switcher\"] = {\n        \"json_url\": \"https://awkward-array.org/doc/switcher.json\",\n        \"version_match\": version_match,\n    }\n    html_theme_options[\"navbar_start\"] = [\"navbar-logo\", \"version-switcher\"]\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\"]\nhtml_css_files = [\"css/awkward.css\"]\n\n# MyST settings\nmyst_enable_extensions = [\"colon_fence\"]\n\nnb_execution_mode = \"cache\"\nnb_execution_raise_on_error = True\n# unpkg is currently _very_ slow\nnb_ipywidgets_js = {\n    # Load RequireJS, used by the IPywidgets for dependency management\n    \"https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js\": {\n        \"integrity\": \"sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=\",\n        \"crossorigin\": \"anonymous\",\n    },\n    # Load IPywidgets bundle for embedding.\n    \"https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@0.20.0/dist/embed-amd.js\": {\n        \"data-jupyter-widgets-cdn\": \"https://cdn.jsdelivr.net/npm/\",\n        \"crossorigin\": \"anonymous\",\n    },\n}\nnb_execution_show_tb = True\n\n# Additional stuff\nmaster_doc = \"index\"\n\n# Cross-reference existing Python objects\nintersphinx_mapping = {\n    \"python\": (\"https://docs.python.org/3/\", None),\n    \"pandas\": (\"https://pandas.pydata.org/pandas-docs/stable\", None),\n    \"numpy\": (\"https://numpy.org/doc/stable\", None),\n    \"scipy\": (\"https://docs.scipy.org/doc/scipy\", None),\n    \"numba\": (\"https://numba.pydata.org/numba-doc/latest\", None),\n    \"arrow\": (\"https://arrow.apache.org/docs/\", None),\n    \"jax\": (\"https://jax.readthedocs.io/en/latest\", None),\n}\n\n\n# JupyterLite configuration\njupyterlite_dir = \"./lite\"\n# Don't override ipynb format\njupyterlite_bind_ipynb_suffix = False\n# We've disabled localstorage, so we must provide the contents explicitly\njupyterlite_contents = [\"getting-started/demo/*\"]\n\nlinkcheck_ignore = [\n    r\"^https?:\\/\\/github\\.com\\/.*$\",\n    r\"^getting-started\\/try-awkward-array\\.html$\",  # Relative link won't resolve\n    r\"^https?:\\/\\/$\",  # Bare https:// allowed\n]\n# Eventually we need to revisit these\nif (datetime.date.today() - datetime.date(2022, 12, 13)) < datetime.timedelta(days=30):\n    linkcheck_ignore.extend(\n        [\n            r\"^https:\\/\\/doi.org\\/10\\.1051\\/epjconf\\/202024505023$\",\n            r\"^https:\\/\\/doi.org\\/10\\.1051\\/epjconf\\/202125103002$\",\n        ]\n    )\n\n# Generate Python docstrings\nHERE = pathlib.Path(__file__).parent\nrunpy.run_path(HERE / \"prepare_docstrings.py\", run_name=\"__main__\")\n\n\n# Sphinx doesn't usually want content to fit the screen, so we hack the styles for this page\ndef install_jupyterlite_styles(app, pagename, templatename, context, event_arg) -> None:\n    if pagename != \"getting-started/try-awkward-array\":\n        return\n\n    app.add_css_file(\"css/try-awkward-array.css\")\n\n\ndef setup(app):\n    app.connect(\"html-page-context\", install_jupyterlite_styles)\n", "path": "docs/conf.py"}], "after_files": [{"content": "# Configuration file for the Sphinx documentation builder.\n#\n# This file only contains a selection of the most common options. For a full\n# list see the documentation:\n# https://www.sphinx-doc.org/en/master/usage/configuration.html\n\n# -- Path setup --------------------------------------------------------------\n\n# If extensions (or modules to document with autodoc) are in another directory,\n# add these directories to sys.path here. If the directory is relative to the\n# documentation root, use os.path.abspath to make it absolute, like shown here.\n#\nimport awkward\nimport datetime\nimport os\nimport runpy\nimport pathlib\n\n# -- Project information -----------------------------------------------------\n\nproject = \"Awkward Array\"\ncopyright = f\"{datetime.datetime.now().year}, Awkward Array development team\"\nauthor = \"Jim Pivarski\"\n\nparts = awkward.__version__.split(\".\")\nversion = \".\".join(parts[:2])\nrelease = \".\".join(parts)\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_copybutton\",\n    \"sphinx_design\",\n    \"sphinx_external_toc\",\n    \"sphinx.ext.intersphinx\",\n    \"myst_nb\",\n    # Preserve old links\n    \"jupyterlite_sphinx\",\n    \"IPython.sphinxext.ipython_console_highlighting\",\n    \"IPython.sphinxext.ipython_directive\",\n]\n\n# Allow the CI to set version_match=\"main\"\nif \"DOCS_VERSION\" in os.environ:\n    version_match = os.environ[\"DOCS_VERSION\"]\nelse:\n    version_match = version\n\n\n# Specify a canonical version\nif \"DOCS_CANONICAL_VERSION\" in os.environ:\n    canonical_version = os.environ[\"DOCS_CANONICAL_VERSION\"]\n    html_baseurl = f\"https://awkward-array.org/doc/{canonical_version}/\"\n\n    # Build sitemap on main\n    if version_match == canonical_version:\n        extensions.append(\"sphinx_sitemap\")\n        # Sitemap URLs are relative to `html_baseurl`\n        sitemap_url_scheme = \"{link}\"\n\n# Add any paths that contain templates here, relative to this directory.\ntemplates_path = [\"_templates\"]\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\", \"_templates\", \"Thumbs.db\", \"jupyter_execute\", \".*\"]\n\n# -- Options for HTML output -------------------------------------------------\n\n# The theme to use for HTML and HTML Help pages.  See the documentation for\n# a list of builtin themes.\n\nhtml_context = {\n    \"github_user\": \"scikit-hep\",\n    \"github_repo\": \"awkward\",\n    \"github_version\": \"main\",\n    \"doc_path\": \"docs\",\n}\nhtml_theme = \"pydata_sphinx_theme\"\nhtml_show_sourcelink = True\nhtml_theme_options = {\n    \"logo\": {\n        \"image_light\": \"_static/image/logo-300px.png\",\n        \"image_dark\": \"_static/image/logo-300px-white.png\",\n    },\n    \"github_url\": \"https://github.com/scikit-hep/awkward\",\n    # Add light/dark mode and documentation version switcher:\n    \"navbar_end\": [\"theme-switcher\", \"navbar-icon-links\"],\n    \"footer_start\": [\"copyright\", \"sphinx-version\", \"funding\"],\n    \"icon_links\": [\n        {\n            \"name\": \"PyPI\",\n            \"url\": \"https://pypi.org/project/awkward\",\n            \"icon\": \"fab fa-python\",\n        }\n    ],\n    \"use_edit_page_button\": True,\n    \"external_links\": [\n        {\n            \"name\": \"Contributor guide\",\n            \"url\": \"https://github.com/scikit-hep/awkward/blob/main/CONTRIBUTING.md\",\n        },\n        {\n            \"name\": \"Release history\",\n            \"url\": \"https://github.com/scikit-hep/awkward/releases\",\n        },\n    ],\n}\n\n# Disable analytics for previews\nif \"DOCS_REPORT_ANALYTICS\" in os.environ:\n    html_theme_options[\"analytics\"] = {\n        \"plausible_analytics_domain\": \"awkward-array.org\",\n        \"plausible_analytics_url\": \"https://views.scientific-python.org/js/plausible.js\",\n    }\n\n# Don't show version for offline builds by default\nif \"DOCS_SHOW_VERSION\" in os.environ:\n    html_theme_options[\"switcher\"] = {\n        \"json_url\": \"https://awkward-array.org/doc/switcher.json\",\n        \"version_match\": version_match,\n    }\n    html_theme_options[\"navbar_start\"] = [\"navbar-logo\", \"version-switcher\"]\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\"]\nhtml_css_files = [\"css/awkward.css\"]\n\n# MyST settings\nmyst_enable_extensions = [\"colon_fence\"]\n\nnb_execution_mode = \"cache\"\nnb_execution_raise_on_error = True\n# unpkg is currently _very_ slow\nnb_ipywidgets_js = {\n    # Load RequireJS, used by the IPywidgets for dependency management\n    \"https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js\": {\n        \"integrity\": \"sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=\",\n        \"crossorigin\": \"anonymous\",\n    },\n    # Load IPywidgets bundle for embedding.\n    \"https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@0.20.0/dist/embed-amd.js\": {\n        \"data-jupyter-widgets-cdn\": \"https://cdn.jsdelivr.net/npm/\",\n        \"crossorigin\": \"anonymous\",\n    },\n}\nnb_execution_show_tb = True\n\n# Additional stuff\nmaster_doc = \"index\"\n\n# Cross-reference existing Python objects\nintersphinx_mapping = {\n    \"python\": (\"https://docs.python.org/3/\", None),\n    \"pandas\": (\"https://pandas.pydata.org/pandas-docs/stable\", None),\n    \"numpy\": (\"https://numpy.org/doc/stable\", None),\n    \"scipy\": (\"https://docs.scipy.org/doc/scipy\", None),\n    \"numba\": (\"https://numba.pydata.org/numba-doc/latest\", None),\n    \"arrow\": (\"https://arrow.apache.org/docs/\", None),\n    \"jax\": (\"https://jax.readthedocs.io/en/latest\", None),\n}\n\n\n# JupyterLite configuration\njupyterlite_dir = \"./lite\"\n# Don't override ipynb format\njupyterlite_bind_ipynb_suffix = False\n# We've disabled localstorage, so we must provide the contents explicitly\njupyterlite_contents = [\"getting-started/demo/*\"]\n\nlinkcheck_ignore = [\n    r\"^https?:\\/\\/github\\.com\\/.*$\",\n    r\"^getting-started\\/try-awkward-array\\.html$\",  # Relative link won't resolve\n    r\"^https?:\\/\\/$\",  # Bare https:// allowed\n]\n# Eventually we need to revisit these\nif (datetime.date.today() - datetime.date(2022, 12, 13)) < datetime.timedelta(days=30):\n    linkcheck_ignore.extend(\n        [\n            r\"^https:\\/\\/doi.org\\/10\\.1051\\/epjconf\\/202024505023$\",\n            r\"^https:\\/\\/doi.org\\/10\\.1051\\/epjconf\\/202125103002$\",\n        ]\n    )\n\n# Generate Python docstrings\nHERE = pathlib.Path(__file__).parent\nrunpy.run_path(HERE / \"prepare_docstrings.py\", run_name=\"__main__\")\n\n\n# Sphinx doesn't usually want content to fit the screen, so we hack the styles for this page\ndef install_jupyterlite_styles(app, pagename, templatename, context, event_arg) -> None:\n    if pagename != \"getting-started/try-awkward-array\":\n        return\n\n    app.add_css_file(\"css/try-awkward-array.css\")\n\n\ndef setup(app):\n    app.connect(\"html-page-context\", install_jupyterlite_styles)\n", "path": "docs/conf.py"}]}