We are currently solving the following issue within our repository. Here is the issue text:
--- BEGIN ISSUE ---
DOC: ReadTheDocs failure due to timeout
RTD does not seem to be happy about the switch to `nbsphinx` examples - https://readthedocs.org/projects/geopandas/builds/13052287/. 

Not sure why exactly, I can think of two reasons (it may actually be a combination of both).

1) I have removed pins from versions to get the recent version, that may take more time to resolve. I'll pin again to current versions tested locally.
2) We have more examples now, some may actually cause trouble/take time. Will explore.



--- END ISSUE ---

Below are some code segments, each from a relevant file. One or more of these files may contain bugs.
--- BEGIN FILES ---
Path: `doc/source/conf.py`
Content:
```
1 # -*- coding: utf-8 -*-
2 #
3 # GeoPandas documentation build configuration file, created by
4 # sphinx-quickstart on Tue Oct 15 08:08:14 2013.
5 #
6 # This file is execfile()d with the current directory set to its containing dir.
7 #
8 # Note that not all possible configuration values are present in this
9 # autogenerated file.
10 #
11 # All configuration values have a default; values that are commented out
12 # serve to show the default.
13 
14 import sys, os
15 import warnings
16 
17 # If extensions (or modules to document with autodoc) are in another directory,
18 # add these directories to sys.path here. If the directory is relative to the
19 # documentation root, use os.path.abspath to make it absolute, like shown here.
20 # sys.path.insert(0, os.path.abspath('.'))
21 
22 # -- General configuration -----------------------------------------------------
23 
24 # If your documentation needs a minimal Sphinx version, state it here.
25 # needs_sphinx = '1.0'
26 
27 # Add any Sphinx extension module names here, as strings. They can be extensions
28 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
29 extensions = [
30     "IPython.sphinxext.ipython_console_highlighting",
31     "IPython.sphinxext.ipython_directive",
32     "sphinx_gallery.load_style",
33     "sphinx.ext.autosummary",
34     "sphinx.ext.intersphinx",
35     "sphinx.ext.autodoc",
36     "myst_parser",
37     "nbsphinx",
38     "numpydoc",
39     'sphinx_toggleprompt',
40     "matplotlib.sphinxext.plot_directive"
41 ]
42 
43 # continue doc build and only print warnings/errors in examples
44 ipython_warning_is_error = False
45 ipython_exec_lines = [
46     # ensure that dataframes are not truncated in the IPython code blocks
47     "import pandas as _pd",
48     '_pd.set_option("display.max_columns", 20)',
49     '_pd.set_option("display.width", 100)',
50 ]
51 
52 # Fix issue with warnings from numpydoc (see discussion in PR #534)
53 numpydoc_show_class_members = False
54 
55 
56 def setup(app):
57     app.add_stylesheet("custom.css")  # may also be an URL
58 
59 
60 # Add any paths that contain templates here, relative to this directory.
61 
62 templates_path = ["_templates"]
63 
64 autosummary_generate = True
65 
66 nbsphinx_execute = "always"
67 nbsphinx_kernel_name = "geopandas_docs"
68 nbsphinx_allow_errors = True
69 
70 # connect docs in other projects
71 intersphinx_mapping = {"pyproj": ("http://pyproj4.github.io/pyproj/stable/", None)}
72 # suppress matplotlib warning in examples
73 warnings.filterwarnings(
74     "ignore",
75     category=UserWarning,
76     message="Matplotlib is currently using agg, which is a"
77     " non-GUI backend, so cannot show the figure.",
78 )
79 
80 # The suffix of source filenames.
81 source_suffix = [".rst", ".md"]
82 
83 # The encoding of source files.
84 # source_encoding = 'utf-8-sig'
85 
86 # The master toctree document.
87 master_doc = "index"
88 
89 # General information about the project.
90 project = u"GeoPandas"
91 copyright = u"2013–2021, GeoPandas developers"
92 
93 # The version info for the project you're documenting, acts as replacement for
94 # |version| and |release|, also used in various other places throughout the
95 # built documents.
96 import geopandas
97 
98 version = release = geopandas.__version__
99 
100 # The language for content autogenerated by Sphinx. Refer to documentation
101 # for a list of supported languages.
102 # language = None
103 
104 # There are two options for replacing |today|: either, you set today to some
105 # non-false value, then it is used:
106 # today = ''
107 # Else, today_fmt is used as the format for a strftime call.
108 # today_fmt = '%B %d, %Y'
109 
110 # List of patterns, relative to source directory, that match files and
111 # directories to ignore when looking for source files.
112 exclude_patterns = []
113 
114 # The reST default role (used for this markup: `text`) to use for all documents.
115 # default_role = None
116 
117 # If true, '()' will be appended to :func: etc. cross-reference text.
118 # add_function_parentheses = True
119 
120 # If true, the current module name will be prepended to all description
121 # unit titles (such as .. function::).
122 # add_module_names = True
123 
124 # If true, sectionauthor and moduleauthor directives will be shown in the
125 # output. They are ignored by default.
126 # show_authors = False
127 
128 # The name of the Pygments (syntax highlighting) style to use.
129 pygments_style = "sphinx"
130 
131 # A list of ignored prefixes for module index sorting.
132 # modindex_common_prefix = []
133 
134 
135 # -- Options for HTML output ---------------------------------------------------
136 
137 # The theme to use for HTML and HTML Help pages.  See the documentation for
138 # a list of builtin themes.
139 html_theme = "pydata_sphinx_theme"
140 
141 # Theme options are theme-specific and customize the look and feel of a theme
142 # further.  For a list of options available for each theme, see the
143 # documentation.
144 html_theme_options = {
145     "search_bar_position": "sidebar",
146     "github_url": "https://github.com/geopandas/geopandas",
147     "twitter_url": "https://twitter.com/geopandas",
148 }
149 
150 # Add any paths that contain custom themes here, relative to this directory.
151 # html_theme_path = []
152 
153 # The name for this set of Sphinx documents.  If None, it defaults to
154 # "<project> v<release> documentation".
155 # html_title = None
156 
157 # A shorter title for the navigation bar.  Default is the same as html_title.
158 # html_short_title = None
159 
160 # The name of an image file (relative to this directory) to place at the top
161 # of the sidebar.
162 html_logo = "_static/logo/geopandas_logo_web.svg"
163 
164 # The name of an image file (within the static path) to use as favicon of the
165 # docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
166 # pixels large.
167 html_favicon = "_static/logo/favicon.png"
168 
169 # Add any paths that contain custom static files (such as style sheets) here,
170 # relative to this directory. They are copied after the builtin static files,
171 # so a file named "default.css" will overwrite the builtin "default.css".
172 html_static_path = ["_static"]
173 
174 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
175 # using the given strftime format.
176 # html_last_updated_fmt = '%b %d, %Y'
177 
178 # If true, SmartyPants will be used to convert quotes and dashes to
179 # typographically correct entities.
180 # html_use_smartypants = True
181 
182 # Custom sidebar templates, maps document names to template names.
183 # html_sidebars = {}
184 
185 # Additional templates that should be rendered to pages, maps page names to
186 # template names.
187 # html_additional_pages = {}
188 
189 # Add redirect for previously existing pages, each item is like `(from_old, to_new)`
190 
191 moved_pages = [
192     # user guide
193     ("aggregation_with_dissolve", "docs/user_guide/aggregation_with_dissolve"),
194     ("data_structures", "docs/user_guide/data_structures"),
195     ("geocoding", "docs/user_guide/geocoding"),
196     ("geometric_manipulations", "docs/user_guide/geometric_manipulations"),
197     ("indexing", "docs/user_guide/indexing"),
198     ("io", "docs/user_guide/io"),
199     ("mapping", "docs/user_guide/mapping"),
200     ("mergingdata", "docs/user_guide/mergingdata"),
201     ("missing_empty", "docs/user_guide/missing_empty"),
202     ("projections", "docs/user_guide/projections"),
203     ("set_operations", "docs/user_guide/set_operations"),
204     # other
205     ("install", "getting_started/install"),
206     ("reference", "docs/reference"),
207     ("changelog", "docs/changelog"),
208     ("code_of_conduct", "community/code_of_conduct"),
209     ("contributing", "community/contributing"),
210 ]
211 
212 html_additional_pages = {page[0]: "redirect.html" for page in moved_pages}
213 
214 html_context = {"redirects": {old: new for old, new in moved_pages}}
215 
216 # If false, no module index is generated.
217 # html_domain_indices = True
218 
219 # If false, no index is generated.
220 # html_use_index = True
221 
222 # If true, the index is split into individual pages for each letter.
223 # html_split_index = False
224 
225 # If true, links to the reST sources are added to the pages.
226 # html_show_sourcelink = True
227 
228 # If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
229 # html_show_sphinx = True
230 
231 # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
232 # html_show_copyright = True
233 
234 # If true, an OpenSearch description file will be output, and all pages will
235 # contain a <link> tag referring to it.  The value of this option must be the
236 # base URL from which the finished HTML is served.
237 # html_use_opensearch = ''
238 
239 # This is the file name suffix for HTML files (e.g. ".xhtml").
240 # html_file_suffix = None
241 
242 # Output file base name for HTML help builder.
243 htmlhelp_basename = "GeoPandasdoc"
244 
245 
246 # -- Options for LaTeX output --------------------------------------------------
247 
248 latex_elements = {
249     # The paper size ('letterpaper' or 'a4paper').
250     #'papersize': 'letterpaper',
251     # The font size ('10pt', '11pt' or '12pt').
252     #'pointsize': '10pt',
253     # Additional stuff for the LaTeX preamble.
254     #'preamble': '',
255 }
256 
257 # Grouping the document tree into LaTeX files. List of tuples
258 # (source start file, target name, title, author, documentclass [howto/manual]).
259 latex_documents = [
260     ("index", "GeoPandas.tex", u"GeoPandas Documentation", u"Kelsey Jordahl", "manual")
261 ]
262 
263 # The name of an image file (relative to this directory) to place at the top of
264 # the title page.
265 # latex_logo = None
266 
267 # For "manual" documents, if this is true, then toplevel headings are parts,
268 # not chapters.
269 # latex_use_parts = False
270 
271 # If true, show page references after internal links.
272 # latex_show_pagerefs = False
273 
274 # If true, show URL addresses after external links.
275 # latex_show_urls = False
276 
277 # Documents to append as an appendix to all manuals.
278 # latex_appendices = []
279 
280 # If false, no module index is generated.
281 # latex_domain_indices = True
282 
283 
284 # -- Options for manual page output --------------------------------------------
285 
286 # One entry per manual page. List of tuples
287 # (source start file, name, description, authors, manual section).
288 man_pages = [("index", "geopandas", u"GeoPandas Documentation", [u"Kelsey Jordahl"], 1)]
289 
290 # If true, show URL addresses after external links.
291 # man_show_urls = False
292 
293 
294 # -- Options for Texinfo output ------------------------------------------------
295 
296 # Grouping the document tree into Texinfo files. List of tuples
297 # (source start file, target name, title, author,
298 #  dir menu entry, description, category)
299 texinfo_documents = [
300     (
301         "index",
302         "GeoPandas",
303         u"GeoPandas Documentation",
304         u"Kelsey Jordahl",
305         "GeoPandas",
306         "One line description of project.",
307         "Miscellaneous",
308     )
309 ]
310 
311 # Documents to append as an appendix to all manuals.
312 # texinfo_appendices = []
313 
314 # If false, no module index is generated.
315 # texinfo_domain_indices = True
316 
317 # How to display URL addresses: 'footnote', 'no', or 'inline'.
318 # texinfo_show_urls = 'footnote'
319 
320 nbsphinx_prolog = r"""
321 {% set docname = env.doc2path(env.docname, base=None) %}
322 
323 .. only:: html
324 
325     .. role:: raw-html(raw)
326         :format: html
327 
328     .. note::
329 
330         | This page was generated from `{{ docname }}`__.
331         | Interactive online version: :raw-html:`<a href="https://mybinder.org/v2/gh/geopandas/geopandas/master?urlpath=lab/tree/doc/source/{{ docname }}"><img alt="Binder badge" src="https://mybinder.org/badge_logo.svg" style="vertical-align:text-bottom"></a>`
332 
333         __ https://github.com/geopandas/geopandas/blob/master/doc/source/{{ docname }}
334 """
335
```
--- 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/doc/source/conf.py b/doc/source/conf.py
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -64,7 +64,6 @@
 autosummary_generate = True
 
 nbsphinx_execute = "always"
-nbsphinx_kernel_name = "geopandas_docs"
 nbsphinx_allow_errors = True
 
 # connect docs in other projects

{"golden_diff": "diff --git a/doc/source/conf.py b/doc/source/conf.py\n--- a/doc/source/conf.py\n+++ b/doc/source/conf.py\n@@ -64,7 +64,6 @@\n autosummary_generate = True\n \n nbsphinx_execute = \"always\"\n-nbsphinx_kernel_name = \"geopandas_docs\"\n nbsphinx_allow_errors = True\n \n # connect docs in other projects\n", "issue": "DOC: ReadTheDocs failure due to timeout\nRTD does not seem to be happy about the switch to `nbsphinx` examples - https://readthedocs.org/projects/geopandas/builds/13052287/. \r\n\r\nNot sure why exactly, I can think of two reasons (it may actually be a combination of both).\r\n\r\n1) I have removed pins from versions to get the recent version, that may take more time to resolve. I'll pin again to current versions tested locally.\r\n2) We have more examples now, some may actually cause trouble/take time. Will explore.\r\n\r\n\n", "before_files": [{"content": "# -*- coding: utf-8 -*-\n#\n# GeoPandas documentation build configuration file, created by\n# sphinx-quickstart on Tue Oct 15 08:08:14 2013.\n#\n# This file is execfile()d with the current directory set to its 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\nimport sys, os\nimport warnings\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# sys.path.insert(0, os.path.abspath('.'))\n\n# -- General configuration -----------------------------------------------------\n\n# If your documentation needs a minimal Sphinx version, state it here.\n# needs_sphinx = '1.0'\n\n# Add any Sphinx extension module names here, as strings. They can be extensions\n# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.\nextensions = [\n    \"IPython.sphinxext.ipython_console_highlighting\",\n    \"IPython.sphinxext.ipython_directive\",\n    \"sphinx_gallery.load_style\",\n    \"sphinx.ext.autosummary\",\n    \"sphinx.ext.intersphinx\",\n    \"sphinx.ext.autodoc\",\n    \"myst_parser\",\n    \"nbsphinx\",\n    \"numpydoc\",\n    'sphinx_toggleprompt',\n    \"matplotlib.sphinxext.plot_directive\"\n]\n\n# continue doc build and only print warnings/errors in examples\nipython_warning_is_error = False\nipython_exec_lines = [\n    # ensure that dataframes are not truncated in the IPython code blocks\n    \"import pandas as _pd\",\n    '_pd.set_option(\"display.max_columns\", 20)',\n    '_pd.set_option(\"display.width\", 100)',\n]\n\n# Fix issue with warnings from numpydoc (see discussion in PR #534)\nnumpydoc_show_class_members = False\n\n\ndef setup(app):\n    app.add_stylesheet(\"custom.css\")  # may also be an URL\n\n\n# Add any paths that contain templates here, relative to this directory.\n\ntemplates_path = [\"_templates\"]\n\nautosummary_generate = True\n\nnbsphinx_execute = \"always\"\nnbsphinx_kernel_name = \"geopandas_docs\"\nnbsphinx_allow_errors = True\n\n# connect docs in other projects\nintersphinx_mapping = {\"pyproj\": (\"http://pyproj4.github.io/pyproj/stable/\", None)}\n# suppress matplotlib warning in examples\nwarnings.filterwarnings(\n    \"ignore\",\n    category=UserWarning,\n    message=\"Matplotlib is currently using agg, which is a\"\n    \" non-GUI backend, so cannot show the figure.\",\n)\n\n# The suffix of source filenames.\nsource_suffix = [\".rst\", \".md\"]\n\n# The encoding of source files.\n# source_encoding = 'utf-8-sig'\n\n# The master toctree document.\nmaster_doc = \"index\"\n\n# General information about the project.\nproject = u\"GeoPandas\"\ncopyright = u\"2013\u20132021, GeoPandas developers\"\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.\nimport geopandas\n\nversion = release = geopandas.__version__\n\n# The language for content autogenerated by Sphinx. Refer to documentation\n# for a list of supported languages.\n# language = None\n\n# There are two options for replacing |today|: either, you set today to some\n# non-false value, then it is used:\n# today = ''\n# Else, today_fmt is used as the format for a strftime call.\n# today_fmt = '%B %d, %Y'\n\n# List of patterns, relative to source directory, that match files and\n# directories to ignore when looking for source files.\nexclude_patterns = []\n\n# The reST default role (used for this markup: `text`) to use for all documents.\n# default_role = None\n\n# If true, '()' will be appended to :func: etc. cross-reference text.\n# add_function_parentheses = True\n\n# If true, the current module name will be prepended to all description\n# unit titles (such as .. function::).\n# add_module_names = True\n\n# If true, sectionauthor and moduleauthor directives will be shown in the\n# output. They are ignored by default.\n# show_authors = False\n\n# The name of the Pygments (syntax highlighting) style to use.\npygments_style = \"sphinx\"\n\n# A list of ignored prefixes for module index sorting.\n# modindex_common_prefix = []\n\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.\nhtml_theme = \"pydata_sphinx_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.\nhtml_theme_options = {\n    \"search_bar_position\": \"sidebar\",\n    \"github_url\": \"https://github.com/geopandas/geopandas\",\n    \"twitter_url\": \"https://twitter.com/geopandas\",\n}\n\n# Add any paths that contain custom themes here, relative to this directory.\n# html_theme_path = []\n\n# The name for this set of Sphinx documents.  If None, it defaults to\n# \"<project> v<release> documentation\".\n# html_title = None\n\n# A shorter title for the navigation bar.  Default is the same as html_title.\n# html_short_title = None\n\n# The name of an image file (relative to this directory) to place at the top\n# of the sidebar.\nhtml_logo = \"_static/logo/geopandas_logo_web.svg\"\n\n# The name of an image file (within the static path) to use as favicon of the\n# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32\n# pixels large.\nhtml_favicon = \"_static/logo/favicon.png\"\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# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,\n# using the given strftime format.\n# html_last_updated_fmt = '%b %d, %Y'\n\n# If true, SmartyPants will be used to convert quotes and dashes to\n# typographically correct entities.\n# html_use_smartypants = True\n\n# Custom sidebar templates, maps document names to template names.\n# html_sidebars = {}\n\n# Additional templates that should be rendered to pages, maps page names to\n# template names.\n# html_additional_pages = {}\n\n# Add redirect for previously existing pages, each item is like `(from_old, to_new)`\n\nmoved_pages = [\n    # user guide\n    (\"aggregation_with_dissolve\", \"docs/user_guide/aggregation_with_dissolve\"),\n    (\"data_structures\", \"docs/user_guide/data_structures\"),\n    (\"geocoding\", \"docs/user_guide/geocoding\"),\n    (\"geometric_manipulations\", \"docs/user_guide/geometric_manipulations\"),\n    (\"indexing\", \"docs/user_guide/indexing\"),\n    (\"io\", \"docs/user_guide/io\"),\n    (\"mapping\", \"docs/user_guide/mapping\"),\n    (\"mergingdata\", \"docs/user_guide/mergingdata\"),\n    (\"missing_empty\", \"docs/user_guide/missing_empty\"),\n    (\"projections\", \"docs/user_guide/projections\"),\n    (\"set_operations\", \"docs/user_guide/set_operations\"),\n    # other\n    (\"install\", \"getting_started/install\"),\n    (\"reference\", \"docs/reference\"),\n    (\"changelog\", \"docs/changelog\"),\n    (\"code_of_conduct\", \"community/code_of_conduct\"),\n    (\"contributing\", \"community/contributing\"),\n]\n\nhtml_additional_pages = {page[0]: \"redirect.html\" for page in moved_pages}\n\nhtml_context = {\"redirects\": {old: new for old, new in moved_pages}}\n\n# If false, no module index is generated.\n# html_domain_indices = True\n\n# If false, no index is generated.\n# html_use_index = True\n\n# If true, the index is split into individual pages for each letter.\n# html_split_index = False\n\n# If true, links to the reST sources are added to the pages.\n# html_show_sourcelink = True\n\n# If true, \"Created using Sphinx\" is shown in the HTML footer. Default is True.\n# html_show_sphinx = True\n\n# If true, \"(C) Copyright ...\" is shown in the HTML footer. Default is True.\n# html_show_copyright = True\n\n# If true, an OpenSearch description file will be output, and all pages will\n# contain a <link> tag referring to it.  The value of this option must be the\n# base URL from which the finished HTML is served.\n# html_use_opensearch = ''\n\n# This is the file name suffix for HTML files (e.g. \".xhtml\").\n# html_file_suffix = None\n\n# Output file base name for HTML help builder.\nhtmlhelp_basename = \"GeoPandasdoc\"\n\n\n# -- Options for LaTeX output --------------------------------------------------\n\nlatex_elements = {\n    # The paper size ('letterpaper' or 'a4paper').\n    #'papersize': 'letterpaper',\n    # The font size ('10pt', '11pt' or '12pt').\n    #'pointsize': '10pt',\n    # Additional stuff for the LaTeX preamble.\n    #'preamble': '',\n}\n\n# Grouping the document tree into LaTeX files. List of tuples\n# (source start file, target name, title, author, documentclass [howto/manual]).\nlatex_documents = [\n    (\"index\", \"GeoPandas.tex\", u\"GeoPandas Documentation\", u\"Kelsey Jordahl\", \"manual\")\n]\n\n# The name of an image file (relative to this directory) to place at the top of\n# the title page.\n# latex_logo = None\n\n# For \"manual\" documents, if this is true, then toplevel headings are parts,\n# not chapters.\n# latex_use_parts = False\n\n# If true, show page references after internal links.\n# latex_show_pagerefs = False\n\n# If true, show URL addresses after external links.\n# latex_show_urls = False\n\n# Documents to append as an appendix to all manuals.\n# latex_appendices = []\n\n# If false, no module index is generated.\n# latex_domain_indices = True\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 = [(\"index\", \"geopandas\", u\"GeoPandas Documentation\", [u\"Kelsey Jordahl\"], 1)]\n\n# If true, show URL addresses after external links.\n# man_show_urls = False\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        \"index\",\n        \"GeoPandas\",\n        u\"GeoPandas Documentation\",\n        u\"Kelsey Jordahl\",\n        \"GeoPandas\",\n        \"One line description of project.\",\n        \"Miscellaneous\",\n    )\n]\n\n# Documents to append as an appendix to all manuals.\n# texinfo_appendices = []\n\n# If false, no module index is generated.\n# texinfo_domain_indices = True\n\n# How to display URL addresses: 'footnote', 'no', or 'inline'.\n# texinfo_show_urls = 'footnote'\n\nnbsphinx_prolog = r\"\"\"\n{% set docname = env.doc2path(env.docname, base=None) %}\n\n.. only:: html\n\n    .. role:: raw-html(raw)\n        :format: html\n\n    .. note::\n\n        | This page was generated from `{{ docname }}`__.\n        | Interactive online version: :raw-html:`<a href=\"https://mybinder.org/v2/gh/geopandas/geopandas/master?urlpath=lab/tree/doc/source/{{ docname }}\"><img alt=\"Binder badge\" src=\"https://mybinder.org/badge_logo.svg\" style=\"vertical-align:text-bottom\"></a>`\n\n        __ https://github.com/geopandas/geopandas/blob/master/doc/source/{{ docname }}\n\"\"\"\n", "path": "doc/source/conf.py"}], "after_files": [{"content": "# -*- coding: utf-8 -*-\n#\n# GeoPandas documentation build configuration file, created by\n# sphinx-quickstart on Tue Oct 15 08:08:14 2013.\n#\n# This file is execfile()d with the current directory set to its 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\nimport sys, os\nimport warnings\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# sys.path.insert(0, os.path.abspath('.'))\n\n# -- General configuration -----------------------------------------------------\n\n# If your documentation needs a minimal Sphinx version, state it here.\n# needs_sphinx = '1.0'\n\n# Add any Sphinx extension module names here, as strings. They can be extensions\n# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.\nextensions = [\n    \"IPython.sphinxext.ipython_console_highlighting\",\n    \"IPython.sphinxext.ipython_directive\",\n    \"sphinx_gallery.load_style\",\n    \"sphinx.ext.autosummary\",\n    \"sphinx.ext.intersphinx\",\n    \"sphinx.ext.autodoc\",\n    \"myst_parser\",\n    \"nbsphinx\",\n    \"numpydoc\",\n    'sphinx_toggleprompt',\n    \"matplotlib.sphinxext.plot_directive\"\n]\n\n# continue doc build and only print warnings/errors in examples\nipython_warning_is_error = False\nipython_exec_lines = [\n    # ensure that dataframes are not truncated in the IPython code blocks\n    \"import pandas as _pd\",\n    '_pd.set_option(\"display.max_columns\", 20)',\n    '_pd.set_option(\"display.width\", 100)',\n]\n\n# Fix issue with warnings from numpydoc (see discussion in PR #534)\nnumpydoc_show_class_members = False\n\n\ndef setup(app):\n    app.add_stylesheet(\"custom.css\")  # may also be an URL\n\n\n# Add any paths that contain templates here, relative to this directory.\n\ntemplates_path = [\"_templates\"]\n\nautosummary_generate = True\n\nnbsphinx_execute = \"always\"\nnbsphinx_allow_errors = True\n\n# connect docs in other projects\nintersphinx_mapping = {\"pyproj\": (\"http://pyproj4.github.io/pyproj/stable/\", None)}\n# suppress matplotlib warning in examples\nwarnings.filterwarnings(\n    \"ignore\",\n    category=UserWarning,\n    message=\"Matplotlib is currently using agg, which is a\"\n    \" non-GUI backend, so cannot show the figure.\",\n)\n\n# The suffix of source filenames.\nsource_suffix = [\".rst\", \".md\"]\n\n# The encoding of source files.\n# source_encoding = 'utf-8-sig'\n\n# The master toctree document.\nmaster_doc = \"index\"\n\n# General information about the project.\nproject = u\"GeoPandas\"\ncopyright = u\"2013\u20132021, GeoPandas developers\"\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.\nimport geopandas\n\nversion = release = geopandas.__version__\n\n# The language for content autogenerated by Sphinx. Refer to documentation\n# for a list of supported languages.\n# language = None\n\n# There are two options for replacing |today|: either, you set today to some\n# non-false value, then it is used:\n# today = ''\n# Else, today_fmt is used as the format for a strftime call.\n# today_fmt = '%B %d, %Y'\n\n# List of patterns, relative to source directory, that match files and\n# directories to ignore when looking for source files.\nexclude_patterns = []\n\n# The reST default role (used for this markup: `text`) to use for all documents.\n# default_role = None\n\n# If true, '()' will be appended to :func: etc. cross-reference text.\n# add_function_parentheses = True\n\n# If true, the current module name will be prepended to all description\n# unit titles (such as .. function::).\n# add_module_names = True\n\n# If true, sectionauthor and moduleauthor directives will be shown in the\n# output. They are ignored by default.\n# show_authors = False\n\n# The name of the Pygments (syntax highlighting) style to use.\npygments_style = \"sphinx\"\n\n# A list of ignored prefixes for module index sorting.\n# modindex_common_prefix = []\n\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.\nhtml_theme = \"pydata_sphinx_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.\nhtml_theme_options = {\n    \"search_bar_position\": \"sidebar\",\n    \"github_url\": \"https://github.com/geopandas/geopandas\",\n    \"twitter_url\": \"https://twitter.com/geopandas\",\n}\n\n# Add any paths that contain custom themes here, relative to this directory.\n# html_theme_path = []\n\n# The name for this set of Sphinx documents.  If None, it defaults to\n# \"<project> v<release> documentation\".\n# html_title = None\n\n# A shorter title for the navigation bar.  Default is the same as html_title.\n# html_short_title = None\n\n# The name of an image file (relative to this directory) to place at the top\n# of the sidebar.\nhtml_logo = \"_static/logo/geopandas_logo_web.svg\"\n\n# The name of an image file (within the static path) to use as favicon of the\n# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32\n# pixels large.\nhtml_favicon = \"_static/logo/favicon.png\"\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# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,\n# using the given strftime format.\n# html_last_updated_fmt = '%b %d, %Y'\n\n# If true, SmartyPants will be used to convert quotes and dashes to\n# typographically correct entities.\n# html_use_smartypants = True\n\n# Custom sidebar templates, maps document names to template names.\n# html_sidebars = {}\n\n# Additional templates that should be rendered to pages, maps page names to\n# template names.\n# html_additional_pages = {}\n\n# Add redirect for previously existing pages, each item is like `(from_old, to_new)`\n\nmoved_pages = [\n    # user guide\n    (\"aggregation_with_dissolve\", \"docs/user_guide/aggregation_with_dissolve\"),\n    (\"data_structures\", \"docs/user_guide/data_structures\"),\n    (\"geocoding\", \"docs/user_guide/geocoding\"),\n    (\"geometric_manipulations\", \"docs/user_guide/geometric_manipulations\"),\n    (\"indexing\", \"docs/user_guide/indexing\"),\n    (\"io\", \"docs/user_guide/io\"),\n    (\"mapping\", \"docs/user_guide/mapping\"),\n    (\"mergingdata\", \"docs/user_guide/mergingdata\"),\n    (\"missing_empty\", \"docs/user_guide/missing_empty\"),\n    (\"projections\", \"docs/user_guide/projections\"),\n    (\"set_operations\", \"docs/user_guide/set_operations\"),\n    # other\n    (\"install\", \"getting_started/install\"),\n    (\"reference\", \"docs/reference\"),\n    (\"changelog\", \"docs/changelog\"),\n    (\"code_of_conduct\", \"community/code_of_conduct\"),\n    (\"contributing\", \"community/contributing\"),\n]\n\nhtml_additional_pages = {page[0]: \"redirect.html\" for page in moved_pages}\n\nhtml_context = {\"redirects\": {old: new for old, new in moved_pages}}\n\n# If false, no module index is generated.\n# html_domain_indices = True\n\n# If false, no index is generated.\n# html_use_index = True\n\n# If true, the index is split into individual pages for each letter.\n# html_split_index = False\n\n# If true, links to the reST sources are added to the pages.\n# html_show_sourcelink = True\n\n# If true, \"Created using Sphinx\" is shown in the HTML footer. Default is True.\n# html_show_sphinx = True\n\n# If true, \"(C) Copyright ...\" is shown in the HTML footer. Default is True.\n# html_show_copyright = True\n\n# If true, an OpenSearch description file will be output, and all pages will\n# contain a <link> tag referring to it.  The value of this option must be the\n# base URL from which the finished HTML is served.\n# html_use_opensearch = ''\n\n# This is the file name suffix for HTML files (e.g. \".xhtml\").\n# html_file_suffix = None\n\n# Output file base name for HTML help builder.\nhtmlhelp_basename = \"GeoPandasdoc\"\n\n\n# -- Options for LaTeX output --------------------------------------------------\n\nlatex_elements = {\n    # The paper size ('letterpaper' or 'a4paper').\n    #'papersize': 'letterpaper',\n    # The font size ('10pt', '11pt' or '12pt').\n    #'pointsize': '10pt',\n    # Additional stuff for the LaTeX preamble.\n    #'preamble': '',\n}\n\n# Grouping the document tree into LaTeX files. List of tuples\n# (source start file, target name, title, author, documentclass [howto/manual]).\nlatex_documents = [\n    (\"index\", \"GeoPandas.tex\", u\"GeoPandas Documentation\", u\"Kelsey Jordahl\", \"manual\")\n]\n\n# The name of an image file (relative to this directory) to place at the top of\n# the title page.\n# latex_logo = None\n\n# For \"manual\" documents, if this is true, then toplevel headings are parts,\n# not chapters.\n# latex_use_parts = False\n\n# If true, show page references after internal links.\n# latex_show_pagerefs = False\n\n# If true, show URL addresses after external links.\n# latex_show_urls = False\n\n# Documents to append as an appendix to all manuals.\n# latex_appendices = []\n\n# If false, no module index is generated.\n# latex_domain_indices = True\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 = [(\"index\", \"geopandas\", u\"GeoPandas Documentation\", [u\"Kelsey Jordahl\"], 1)]\n\n# If true, show URL addresses after external links.\n# man_show_urls = False\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        \"index\",\n        \"GeoPandas\",\n        u\"GeoPandas Documentation\",\n        u\"Kelsey Jordahl\",\n        \"GeoPandas\",\n        \"One line description of project.\",\n        \"Miscellaneous\",\n    )\n]\n\n# Documents to append as an appendix to all manuals.\n# texinfo_appendices = []\n\n# If false, no module index is generated.\n# texinfo_domain_indices = True\n\n# How to display URL addresses: 'footnote', 'no', or 'inline'.\n# texinfo_show_urls = 'footnote'\n\nnbsphinx_prolog = r\"\"\"\n{% set docname = env.doc2path(env.docname, base=None) %}\n\n.. only:: html\n\n    .. role:: raw-html(raw)\n        :format: html\n\n    .. note::\n\n        | This page was generated from `{{ docname }}`__.\n        | Interactive online version: :raw-html:`<a href=\"https://mybinder.org/v2/gh/geopandas/geopandas/master?urlpath=lab/tree/doc/source/{{ docname }}\"><img alt=\"Binder badge\" src=\"https://mybinder.org/badge_logo.svg\" style=\"vertical-align:text-bottom\"></a>`\n\n        __ https://github.com/geopandas/geopandas/blob/master/doc/source/{{ docname }}\n\"\"\"\n", "path": "doc/source/conf.py"}]}