We are currently solving the following issue within our repository. Here is the issue text:
--- BEGIN ISSUE ---
Thumbnails missing/broken on plasmapy documentation webpage home
As the title suggests, and can be seen on the screenshot, two of the three thumbnails
are missing from the PlasmaPy documentation front page at https://docs.plasmapy.org/en/latest/
<img width="598" alt="Untitled" src="https://user-images.githubusercontent.com/7075058/88436433-2b75b680-cdb9-11ea-92a0-83ebd8d67880.png">

Thumbnails missing/broken on plasmapy documentation webpage home
As the title suggests, and can be seen on the screenshot, two of the three thumbnails
are missing from the PlasmaPy documentation front page at https://docs.plasmapy.org/en/latest/
<img width="598" alt="Untitled" src="https://user-images.githubusercontent.com/7075058/88436433-2b75b680-cdb9-11ea-92a0-83ebd8d67880.png">

Thumbnails missing/broken on plasmapy documentation webpage home
As the title suggests, and can be seen on the screenshot, two of the three thumbnails
are missing from the PlasmaPy documentation front page at https://docs.plasmapy.org/en/latest/
<img width="598" alt="Untitled" src="https://user-images.githubusercontent.com/7075058/88436433-2b75b680-cdb9-11ea-92a0-83ebd8d67880.png">


--- 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 #!/usr/bin/env python3.6
2 # -*- coding: utf-8 -*-
3 #
4 # PlasmaPy documentation build configuration file, created by
5 # sphinx-quickstart on Wed May 31 18:16:46 2017.
6 #
7 # This file is execfile()d with the current directory set to its
8 # containing dir.
9 #
10 # Note that not all possible configuration values are present in this
11 # autogenerated file.
12 #
13 # All configuration values have a default; values that are commented out
14 # serve to show the default.
15 
16 # If extensions (or modules to document with autodoc) are in another directory,
17 # add these directories to sys.path here. If the directory is relative to the
18 # documentation root, use os.path.abspath to make it absolute, like shown here.
19 #
20 
21 import os
22 import sys
23 
24 from pkg_resources import parse_version
25 from sphinx.application import Sphinx
26 
27 sys.path.insert(0, os.path.abspath(".."))
28 
29 from plasmapy import __version__ as release
30 
31 
32 # -- General configuration ------------------------------------------------
33 
34 # If your documentation needs a minimal Sphinx version, state it here.
35 #
36 # needs_sphinx = '1.0'
37 
38 # Add any Sphinx extension module names here, as strings. They can be
39 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
40 # ones.
41 extensions = [
42     "sphinx.ext.autodoc",
43     "sphinx.ext.intersphinx",
44     "sphinx.ext.graphviz",
45     "sphinx.ext.mathjax",
46     "sphinx.ext.napoleon",
47     "sphinx_automodapi.automodapi",
48     "sphinx_automodapi.smart_resolver",
49     "nbsphinx",
50     "sphinx_copybutton",
51     "sphinx_gallery.load_style",
52 ]
53 
54 intersphinx_mapping = {
55     "python": ("https://docs.python.org/3", None),
56     "numpy": ("https://numpy.org/doc/stable/", None),
57     "scipy": ("https://docs.scipy.org/doc/scipy/reference/", None),
58     "pandas": ("http://pandas.pydata.org/pandas-docs/stable/", None),
59     "astropy": ("http://docs.astropy.org/en/stable/", None),
60 }
61 # Add any paths that contain templates here, relative to this directory.
62 templates_path = ["_templates"]
63 
64 # The suffix(es) of source filenames.
65 # You can specify multiple suffix as a list of string:
66 #
67 # source_suffix = ['.rst', '.md']
68 source_suffix = ".rst"
69 
70 # The master toctree document.
71 master_doc = "index"
72 
73 # General information about the project.
74 project = "PlasmaPy"
75 copyright = "2015-2020, PlasmaPy Community"
76 author = "PlasmaPy Community"
77 
78 
79 # The version info for the project you're documenting, acts as replacement for
80 # |version| and |release|, also used in various other places throughout the
81 # built documents.
82 #
83 # The full version, including alpha/beta/rc tags.
84 #  Note: If plasmapy.__version__ can not be defined then it is set to 'unknown'.
85 #        However, release needs to be a semantic style version number, so set
86 #        the 'unknown' case to ''.
87 release = "" if release == "unknown" else release
88 if release == "unknown":
89     release = version = revision = ""
90 else:
91     pv = parse_version(release)
92     release = pv.public
93     version = ".".join(release.split(".")[:2])  # short X.Y version
94     if pv.local is not None:
95         revision = pv.local[1:]  # revision number w/o the leading g
96     else:
97         revision = ""
98 
99 
100 # The language for content autogenerated by Sphinx. Refer to documentation
101 # for a list of supported languages.
102 #
103 # This is also used if you do content translation via gettext catalogs.
104 # Usually you set "language" from the command line for these cases.
105 language = None
106 
107 # List of patterns, relative to source directory, that match files and
108 # directories to ignore when looking for source files.
109 # This patterns also effect to html_static_path and html_extra_path
110 exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
111 
112 # The name of the Pygments (syntax highlighting) style to use.
113 pygments_style = "sphinx"
114 
115 # If true, `todo` and `todoList` produce output, else they produce nothing.
116 todo_include_todos = False
117 
118 default_role = "obj"
119 
120 # -- Options for HTML output ----------------------------------------------
121 
122 # The theme to use for HTML and HTML Help pages.  See the documentation for
123 # a list of builtin themes.
124 #
125 # html_theme = 'alabaster'
126 # html_theme = 'traditional'
127 # html_theme = 'agogo'
128 html_theme = "sphinx_rtd_theme"
129 
130 # Theme options are theme-specific and customize the look and feel of a theme
131 # further.  For a list of options available for each theme, see the
132 # documentation.
133 #
134 # html_theme_options = {}
135 
136 # Add any paths that contain custom static files (such as style sheets) here,
137 # relative to this directory. They are copied after the builtin static files,
138 # so a file named "default.css" will overwrite the builtin "default.css".
139 # html_static_path = ['_static']
140 
141 
142 # -- Options for HTMLHelp output ------------------------------------------
143 
144 # Output file base name for HTML help builder.
145 htmlhelp_basename = "PlasmaPydoc"
146 
147 
148 # -- Options for LaTeX output ---------------------------------------------
149 
150 latex_elements = {
151     # The paper size ('letterpaper' or 'a4paper').
152     # 'papersize': 'letterpaper',
153     #
154     # The font size ('10pt', '11pt' or '12pt').
155     # 'pointsize': '10pt',
156     #
157     # Additional stuff for the LaTeX preamble.
158     # 'preamble': '',
159     #
160     # Latex figure (float) alignment
161     # 'figure_align': 'htbp',
162 }
163 
164 # Grouping the document tree into LaTeX files. List of tuples
165 # (source start file, target name, title,
166 #  author, documentclass [howto, manual, or own class]).
167 latex_documents = [
168     (
169         master_doc,
170         "PlasmaPy.tex",
171         "PlasmaPy Documentation",
172         "PlasmaPy Community",
173         "manual",
174     )
175 ]
176 
177 
178 # -- Options for manual page output ---------------------------------------
179 
180 # One entry per manual page. List of tuples
181 # (source start file, name, description, authors, manual section).
182 man_pages = [(master_doc, "plasmapy", "PlasmaPy Documentation", [author], 1)]
183 
184 
185 # -- Options for Texinfo output -------------------------------------------
186 
187 # Grouping the document tree into Texinfo files. List of tuples
188 # (source start file, target name, title, author,
189 #  dir menu entry, description, category)
190 texinfo_documents = [
191     (
192         master_doc,
193         "PlasmaPy",
194         "PlasmaPy Documentation",
195         author,
196         "PlasmaPy",
197         "Python package for plasma physics",
198         "Miscellaneous",
199     )
200 ]
201 
202 html_favicon = "./_static/icon.ico"
203 
204 
205 # -- NBSphinx options
206 
207 nbsphinx_thumbnails = {"notebooks/*": "_images/graphic-circular.png"}
208 
209 # adapted from https://github.com/spatialaudio/nbsphinx/blob/58b8034dd9d7349c1b4ac3e7a7d6baa87ab2a6a9/doc/conf.py
210 
211 # This is processed by Jinja2 and inserted before each notebook
212 nbsphinx_prolog = r"""
213 {% set docname = 'docs/' + env.doc2path(env.docname, base=None) %}
214 {% set nb_base = 'tree' if env.config.revision else 'blob' %}
215 {% set nb_where = env.config.revision if env.config.revision else 'master' %}
216 
217 .. raw:: html
218 
219     <div class="admonition note">
220       <p style="margin-bottom:0px">
221         This page was generated by
222         <a href="https://nbsphinx.readthedocs.io/">nbsphinx</a> from
223         <a class="reference external" href="https://github.com/PlasmaPy/PlasmaPy/{{ nb_base|e }}/{{ nb_where|e }}/{{ docname|e }}">{{ docname|e }}</a>.
224         <br>
225         Interactive online version:
226         <a href="https://mybinder.org/v2/gh/PlasmaPy/PlasmaPy/{{ nb_where|e }}/?filepath={{ docname|e }}"><img alt="Binder badge" src="https://mybinder.org/badge_logo.svg" style="vertical-align:text-bottom"></a>.
227       </p>
228     </div>
229 
230 .. raw:: latex
231 
232     \nbsphinxstartnotebook{\scriptsize\noindent\strut
233     \textcolor{gray}{The following section was generated from
234     \sphinxcode{\sphinxupquote{\strut {{ docname | escape_latex }}}} \dotfill}}
235 """
236 
237 
238 def setup(app: Sphinx) -> None:
239     app.add_config_value("revision", "", True)
240
```
--- 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
@@ -21,6 +21,7 @@
 import os
 import sys
 
+from datetime import datetime
 from pkg_resources import parse_version
 from sphinx.application import Sphinx
 
@@ -72,8 +73,8 @@
 
 # General information about the project.
 project = "PlasmaPy"
-copyright = "2015-2020, PlasmaPy Community"
 author = "PlasmaPy Community"
+copyright = f"2015-{datetime.utcnow().year}, {author}"
 
 
 # The version info for the project you're documenting, acts as replacement for
@@ -131,13 +132,24 @@
 # further.  For a list of options available for each theme, see the
 # documentation.
 #
-# html_theme_options = {}
+html_logo = "./_static/with-text-light-190px.png"
+html_theme_options = {
+    "logo_only": True,
+    #
+    # TOC options
+    #   https://sphinx-rtd-theme.readthedocs.io/en/stable/configuring.html#theme-options
+    "includehidden": False,
+}
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-# html_static_path = ['_static']
+html_static_path = ["_static"]
 
+# A list of prefixes that are ignored for sorting the Python module
+# index (e.g., if this is set to ['foo.'], then foo.bar is shown under
+# B, not F).
+modindex_common_prefix = ["plasmapy."]
 
 # -- Options for HTMLHelp output ------------------------------------------
 
@@ -237,3 +249,4 @@
 
 def setup(app: Sphinx) -> None:
     app.add_config_value("revision", "", True)
+    app.add_stylesheet("rtd_theme_overrides.css")

{"golden_diff": "diff --git a/docs/conf.py b/docs/conf.py\n--- a/docs/conf.py\n+++ b/docs/conf.py\n@@ -21,6 +21,7 @@\n import os\n import sys\n \n+from datetime import datetime\n from pkg_resources import parse_version\n from sphinx.application import Sphinx\n \n@@ -72,8 +73,8 @@\n \n # General information about the project.\n project = \"PlasmaPy\"\n-copyright = \"2015-2020, PlasmaPy Community\"\n author = \"PlasmaPy Community\"\n+copyright = f\"2015-{datetime.utcnow().year}, {author}\"\n \n \n # The version info for the project you're documenting, acts as replacement for\n@@ -131,13 +132,24 @@\n # further.  For a list of options available for each theme, see the\n # documentation.\n #\n-# html_theme_options = {}\n+html_logo = \"./_static/with-text-light-190px.png\"\n+html_theme_options = {\n+    \"logo_only\": True,\n+    #\n+    # TOC options\n+    #   https://sphinx-rtd-theme.readthedocs.io/en/stable/configuring.html#theme-options\n+    \"includehidden\": False,\n+}\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\".\n-# html_static_path = ['_static']\n+html_static_path = [\"_static\"]\n \n+# A list of prefixes that are ignored for sorting the Python module\n+# index (e.g., if this is set to ['foo.'], then foo.bar is shown under\n+# B, not F).\n+modindex_common_prefix = [\"plasmapy.\"]\n \n # -- Options for HTMLHelp output ------------------------------------------\n \n@@ -237,3 +249,4 @@\n \n def setup(app: Sphinx) -> None:\n     app.add_config_value(\"revision\", \"\", True)\n+    app.add_stylesheet(\"rtd_theme_overrides.css\")\n", "issue": "Thumbnails missing/broken on plasmapy documentation webpage home\nAs the title suggests, and can be seen on the screenshot, two of the three thumbnails\r\nare missing from the PlasmaPy documentation front page at https://docs.plasmapy.org/en/latest/\r\n<img width=\"598\" alt=\"Untitled\" src=\"https://user-images.githubusercontent.com/7075058/88436433-2b75b680-cdb9-11ea-92a0-83ebd8d67880.png\">\r\n\nThumbnails missing/broken on plasmapy documentation webpage home\nAs the title suggests, and can be seen on the screenshot, two of the three thumbnails\r\nare missing from the PlasmaPy documentation front page at https://docs.plasmapy.org/en/latest/\r\n<img width=\"598\" alt=\"Untitled\" src=\"https://user-images.githubusercontent.com/7075058/88436433-2b75b680-cdb9-11ea-92a0-83ebd8d67880.png\">\r\n\nThumbnails missing/broken on plasmapy documentation webpage home\nAs the title suggests, and can be seen on the screenshot, two of the three thumbnails\r\nare missing from the PlasmaPy documentation front page at https://docs.plasmapy.org/en/latest/\r\n<img width=\"598\" alt=\"Untitled\" src=\"https://user-images.githubusercontent.com/7075058/88436433-2b75b680-cdb9-11ea-92a0-83ebd8d67880.png\">\r\n\n", "before_files": [{"content": "#!/usr/bin/env python3.6\n# -*- coding: utf-8 -*-\n#\n# PlasmaPy documentation build configuration file, created by\n# sphinx-quickstart on Wed May 31 18:16:46 2017.\n#\n# This file is execfile()d with the current directory set to its\n# containing dir.\n#\n# Note that not all possible configuration values are present in this\n# autogenerated file.\n#\n# All configuration values have a default; values that are commented out\n# serve to show the default.\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#\n\nimport os\nimport sys\n\nfrom pkg_resources import parse_version\nfrom sphinx.application import Sphinx\n\nsys.path.insert(0, os.path.abspath(\"..\"))\n\nfrom plasmapy import __version__ as release\n\n\n# -- General configuration ------------------------------------------------\n\n# If your documentation needs a minimal Sphinx version, state it here.\n#\n# needs_sphinx = '1.0'\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.autodoc\",\n    \"sphinx.ext.intersphinx\",\n    \"sphinx.ext.graphviz\",\n    \"sphinx.ext.mathjax\",\n    \"sphinx.ext.napoleon\",\n    \"sphinx_automodapi.automodapi\",\n    \"sphinx_automodapi.smart_resolver\",\n    \"nbsphinx\",\n    \"sphinx_copybutton\",\n    \"sphinx_gallery.load_style\",\n]\n\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    \"pandas\": (\"http://pandas.pydata.org/pandas-docs/stable/\", None),\n    \"astropy\": (\"http://docs.astropy.org/en/stable/\", None),\n}\n# Add any paths that contain templates here, relative to this directory.\ntemplates_path = [\"_templates\"]\n\n# The suffix(es) of source filenames.\n# You can specify multiple suffix as a list of string:\n#\n# source_suffix = ['.rst', '.md']\nsource_suffix = \".rst\"\n\n# The master toctree document.\nmaster_doc = \"index\"\n\n# General information about the project.\nproject = \"PlasmaPy\"\ncopyright = \"2015-2020, PlasmaPy Community\"\nauthor = \"PlasmaPy Community\"\n\n\n# The version info for the project you're documenting, acts as replacement for\n# |version| and |release|, also used in various other places throughout the\n# built documents.\n#\n# The full version, including alpha/beta/rc tags.\n#  Note: If plasmapy.__version__ can not be defined then it is set to 'unknown'.\n#        However, release needs to be a semantic style version number, so set\n#        the 'unknown' case to ''.\nrelease = \"\" if release == \"unknown\" else release\nif release == \"unknown\":\n    release = version = revision = \"\"\nelse:\n    pv = parse_version(release)\n    release = pv.public\n    version = \".\".join(release.split(\".\")[:2])  # short X.Y version\n    if pv.local is not None:\n        revision = pv.local[1:]  # revision number w/o the leading g\n    else:\n        revision = \"\"\n\n\n# The language for content autogenerated by Sphinx. Refer to documentation\n# for a list of supported languages.\n#\n# This is also used if you do content translation via gettext catalogs.\n# Usually you set \"language\" from the command line for these cases.\nlanguage = None\n\n# List of patterns, relative to source directory, that match files and\n# directories to ignore when looking for source files.\n# This patterns also effect to html_static_path and html_extra_path\nexclude_patterns = [\"_build\", \"Thumbs.db\", \".DS_Store\"]\n\n# The name of the Pygments (syntax highlighting) style to use.\npygments_style = \"sphinx\"\n\n# If true, `todo` and `todoList` produce output, else they produce nothing.\ntodo_include_todos = False\n\ndefault_role = \"obj\"\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#\n# html_theme = 'alabaster'\n# html_theme = 'traditional'\n# html_theme = 'agogo'\nhtml_theme = \"sphinx_rtd_theme\"\n\n# Theme options are theme-specific and customize the look and feel of a theme\n# further.  For a list of options available for each theme, see the\n# documentation.\n#\n# html_theme_options = {}\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\".\n# html_static_path = ['_static']\n\n\n# -- Options for HTMLHelp output ------------------------------------------\n\n# Output file base name for HTML help builder.\nhtmlhelp_basename = \"PlasmaPydoc\"\n\n\n# -- Options for LaTeX output ---------------------------------------------\n\nlatex_elements = {\n    # The paper size ('letterpaper' or 'a4paper').\n    # 'papersize': 'letterpaper',\n    #\n    # The font size ('10pt', '11pt' or '12pt').\n    # 'pointsize': '10pt',\n    #\n    # Additional stuff for the LaTeX preamble.\n    # 'preamble': '',\n    #\n    # Latex figure (float) alignment\n    # 'figure_align': 'htbp',\n}\n\n# Grouping the document tree into LaTeX files. List of tuples\n# (source start file, target name, title,\n#  author, documentclass [howto, manual, or own class]).\nlatex_documents = [\n    (\n        master_doc,\n        \"PlasmaPy.tex\",\n        \"PlasmaPy Documentation\",\n        \"PlasmaPy Community\",\n        \"manual\",\n    )\n]\n\n\n# -- Options for manual page output ---------------------------------------\n\n# One entry per manual page. List of tuples\n# (source start file, name, description, authors, manual section).\nman_pages = [(master_doc, \"plasmapy\", \"PlasmaPy Documentation\", [author], 1)]\n\n\n# -- Options for Texinfo output -------------------------------------------\n\n# Grouping the document tree into Texinfo files. List of tuples\n# (source start file, target name, title, author,\n#  dir menu entry, description, category)\ntexinfo_documents = [\n    (\n        master_doc,\n        \"PlasmaPy\",\n        \"PlasmaPy Documentation\",\n        author,\n        \"PlasmaPy\",\n        \"Python package for plasma physics\",\n        \"Miscellaneous\",\n    )\n]\n\nhtml_favicon = \"./_static/icon.ico\"\n\n\n# -- NBSphinx options\n\nnbsphinx_thumbnails = {\"notebooks/*\": \"_images/graphic-circular.png\"}\n\n# adapted from https://github.com/spatialaudio/nbsphinx/blob/58b8034dd9d7349c1b4ac3e7a7d6baa87ab2a6a9/doc/conf.py\n\n# This is processed by Jinja2 and inserted before each notebook\nnbsphinx_prolog = r\"\"\"\n{% set docname = 'docs/' + env.doc2path(env.docname, base=None) %}\n{% set nb_base = 'tree' if env.config.revision else 'blob' %}\n{% set nb_where = env.config.revision if env.config.revision else 'master' %}\n\n.. raw:: html\n\n    <div class=\"admonition note\">\n      <p style=\"margin-bottom:0px\">\n        This page was generated by\n        <a href=\"https://nbsphinx.readthedocs.io/\">nbsphinx</a> from\n        <a class=\"reference external\" href=\"https://github.com/PlasmaPy/PlasmaPy/{{ nb_base|e }}/{{ nb_where|e }}/{{ docname|e }}\">{{ docname|e }}</a>.\n        <br>\n        Interactive online version:\n        <a href=\"https://mybinder.org/v2/gh/PlasmaPy/PlasmaPy/{{ nb_where|e }}/?filepath={{ docname|e }}\"><img alt=\"Binder badge\" src=\"https://mybinder.org/badge_logo.svg\" style=\"vertical-align:text-bottom\"></a>.\n      </p>\n    </div>\n\n.. raw:: latex\n\n    \\nbsphinxstartnotebook{\\scriptsize\\noindent\\strut\n    \\textcolor{gray}{The following section was generated from\n    \\sphinxcode{\\sphinxupquote{\\strut {{ docname | escape_latex }}}} \\dotfill}}\n\"\"\"\n\n\ndef setup(app: Sphinx) -> None:\n    app.add_config_value(\"revision\", \"\", True)\n", "path": "docs/conf.py"}], "after_files": [{"content": "#!/usr/bin/env python3.6\n# -*- coding: utf-8 -*-\n#\n# PlasmaPy documentation build configuration file, created by\n# sphinx-quickstart on Wed May 31 18:16:46 2017.\n#\n# This file is execfile()d with the current directory set to its\n# containing dir.\n#\n# Note that not all possible configuration values are present in this\n# autogenerated file.\n#\n# All configuration values have a default; values that are commented out\n# serve to show the default.\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#\n\nimport os\nimport sys\n\nfrom datetime import datetime\nfrom pkg_resources import parse_version\nfrom sphinx.application import Sphinx\n\nsys.path.insert(0, os.path.abspath(\"..\"))\n\nfrom plasmapy import __version__ as release\n\n\n# -- General configuration ------------------------------------------------\n\n# If your documentation needs a minimal Sphinx version, state it here.\n#\n# needs_sphinx = '1.0'\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.autodoc\",\n    \"sphinx.ext.intersphinx\",\n    \"sphinx.ext.graphviz\",\n    \"sphinx.ext.mathjax\",\n    \"sphinx.ext.napoleon\",\n    \"sphinx_automodapi.automodapi\",\n    \"sphinx_automodapi.smart_resolver\",\n    \"nbsphinx\",\n    \"sphinx_copybutton\",\n    \"sphinx_gallery.load_style\",\n]\n\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    \"pandas\": (\"http://pandas.pydata.org/pandas-docs/stable/\", None),\n    \"astropy\": (\"http://docs.astropy.org/en/stable/\", None),\n}\n# Add any paths that contain templates here, relative to this directory.\ntemplates_path = [\"_templates\"]\n\n# The suffix(es) of source filenames.\n# You can specify multiple suffix as a list of string:\n#\n# source_suffix = ['.rst', '.md']\nsource_suffix = \".rst\"\n\n# The master toctree document.\nmaster_doc = \"index\"\n\n# General information about the project.\nproject = \"PlasmaPy\"\nauthor = \"PlasmaPy Community\"\ncopyright = f\"2015-{datetime.utcnow().year}, {author}\"\n\n\n# The version info for the project you're documenting, acts as replacement for\n# |version| and |release|, also used in various other places throughout the\n# built documents.\n#\n# The full version, including alpha/beta/rc tags.\n#  Note: If plasmapy.__version__ can not be defined then it is set to 'unknown'.\n#        However, release needs to be a semantic style version number, so set\n#        the 'unknown' case to ''.\nrelease = \"\" if release == \"unknown\" else release\nif release == \"unknown\":\n    release = version = revision = \"\"\nelse:\n    pv = parse_version(release)\n    release = pv.public\n    version = \".\".join(release.split(\".\")[:2])  # short X.Y version\n    if pv.local is not None:\n        revision = pv.local[1:]  # revision number w/o the leading g\n    else:\n        revision = \"\"\n\n\n# The language for content autogenerated by Sphinx. Refer to documentation\n# for a list of supported languages.\n#\n# This is also used if you do content translation via gettext catalogs.\n# Usually you set \"language\" from the command line for these cases.\nlanguage = None\n\n# List of patterns, relative to source directory, that match files and\n# directories to ignore when looking for source files.\n# This patterns also effect to html_static_path and html_extra_path\nexclude_patterns = [\"_build\", \"Thumbs.db\", \".DS_Store\"]\n\n# The name of the Pygments (syntax highlighting) style to use.\npygments_style = \"sphinx\"\n\n# If true, `todo` and `todoList` produce output, else they produce nothing.\ntodo_include_todos = False\n\ndefault_role = \"obj\"\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#\n# html_theme = 'alabaster'\n# html_theme = 'traditional'\n# html_theme = 'agogo'\nhtml_theme = \"sphinx_rtd_theme\"\n\n# Theme options are theme-specific and customize the look and feel of a theme\n# further.  For a list of options available for each theme, see the\n# documentation.\n#\nhtml_logo = \"./_static/with-text-light-190px.png\"\nhtml_theme_options = {\n    \"logo_only\": True,\n    #\n    # TOC options\n    #   https://sphinx-rtd-theme.readthedocs.io/en/stable/configuring.html#theme-options\n    \"includehidden\": False,\n}\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# A list of prefixes that are ignored for sorting the Python module\n# index (e.g., if this is set to ['foo.'], then foo.bar is shown under\n# B, not F).\nmodindex_common_prefix = [\"plasmapy.\"]\n\n# -- Options for HTMLHelp output ------------------------------------------\n\n# Output file base name for HTML help builder.\nhtmlhelp_basename = \"PlasmaPydoc\"\n\n\n# -- Options for LaTeX output ---------------------------------------------\n\nlatex_elements = {\n    # The paper size ('letterpaper' or 'a4paper').\n    # 'papersize': 'letterpaper',\n    #\n    # The font size ('10pt', '11pt' or '12pt').\n    # 'pointsize': '10pt',\n    #\n    # Additional stuff for the LaTeX preamble.\n    # 'preamble': '',\n    #\n    # Latex figure (float) alignment\n    # 'figure_align': 'htbp',\n}\n\n# Grouping the document tree into LaTeX files. List of tuples\n# (source start file, target name, title,\n#  author, documentclass [howto, manual, or own class]).\nlatex_documents = [\n    (\n        master_doc,\n        \"PlasmaPy.tex\",\n        \"PlasmaPy Documentation\",\n        \"PlasmaPy Community\",\n        \"manual\",\n    )\n]\n\n\n# -- Options for manual page output ---------------------------------------\n\n# One entry per manual page. List of tuples\n# (source start file, name, description, authors, manual section).\nman_pages = [(master_doc, \"plasmapy\", \"PlasmaPy Documentation\", [author], 1)]\n\n\n# -- Options for Texinfo output -------------------------------------------\n\n# Grouping the document tree into Texinfo files. List of tuples\n# (source start file, target name, title, author,\n#  dir menu entry, description, category)\ntexinfo_documents = [\n    (\n        master_doc,\n        \"PlasmaPy\",\n        \"PlasmaPy Documentation\",\n        author,\n        \"PlasmaPy\",\n        \"Python package for plasma physics\",\n        \"Miscellaneous\",\n    )\n]\n\nhtml_favicon = \"./_static/icon.ico\"\n\n\n# -- NBSphinx options\n\nnbsphinx_thumbnails = {\"notebooks/*\": \"_images/graphic-circular.png\"}\n\n# adapted from https://github.com/spatialaudio/nbsphinx/blob/58b8034dd9d7349c1b4ac3e7a7d6baa87ab2a6a9/doc/conf.py\n\n# This is processed by Jinja2 and inserted before each notebook\nnbsphinx_prolog = r\"\"\"\n{% set docname = 'docs/' + env.doc2path(env.docname, base=None) %}\n{% set nb_base = 'tree' if env.config.revision else 'blob' %}\n{% set nb_where = env.config.revision if env.config.revision else 'master' %}\n\n.. raw:: html\n\n    <div class=\"admonition note\">\n      <p style=\"margin-bottom:0px\">\n        This page was generated by\n        <a href=\"https://nbsphinx.readthedocs.io/\">nbsphinx</a> from\n        <a class=\"reference external\" href=\"https://github.com/PlasmaPy/PlasmaPy/{{ nb_base|e }}/{{ nb_where|e }}/{{ docname|e }}\">{{ docname|e }}</a>.\n        <br>\n        Interactive online version:\n        <a href=\"https://mybinder.org/v2/gh/PlasmaPy/PlasmaPy/{{ nb_where|e }}/?filepath={{ docname|e }}\"><img alt=\"Binder badge\" src=\"https://mybinder.org/badge_logo.svg\" style=\"vertical-align:text-bottom\"></a>.\n      </p>\n    </div>\n\n.. raw:: latex\n\n    \\nbsphinxstartnotebook{\\scriptsize\\noindent\\strut\n    \\textcolor{gray}{The following section was generated from\n    \\sphinxcode{\\sphinxupquote{\\strut {{ docname | escape_latex }}}} \\dotfill}}\n\"\"\"\n\n\ndef setup(app: Sphinx) -> None:\n    app.add_config_value(\"revision\", \"\", True)\n    app.add_stylesheet(\"rtd_theme_overrides.css\")\n", "path": "docs/conf.py"}]}