We are currently solving the following issue within our repository. Here is the issue text:
--- BEGIN ISSUE ---
DOC: add links to relevant API to the user guide 
We should ensure that when referring documented objects/methods in the user guide, we link to the relevant API pages using for example `:py:class:`GeoSeries` and intersphinx mapping to link pandas, pyproj, matplotlib et al. 

See the first step done in #1926 done by @raybellwaves for an illustration.

--- 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_allow_errors = True
68 
69 # connect docs in other projects
70 intersphinx_mapping = {"pyproj": ("http://pyproj4.github.io/pyproj/stable/", None)}
71 # suppress matplotlib warning in examples
72 warnings.filterwarnings(
73     "ignore",
74     category=UserWarning,
75     message="Matplotlib is currently using agg, which is a"
76     " non-GUI backend, so cannot show the figure.",
77 )
78 
79 # The suffix of source filenames.
80 source_suffix = [".rst", ".md"]
81 
82 # The encoding of source files.
83 # source_encoding = 'utf-8-sig'
84 
85 # The master toctree document.
86 master_doc = "index"
87 
88 # General information about the project.
89 project = u"GeoPandas"
90 copyright = u"2013–2021, GeoPandas developers"
91 
92 # The version info for the project you're documenting, acts as replacement for
93 # |version| and |release|, also used in various other places throughout the
94 # built documents.
95 import geopandas
96 
97 version = release = geopandas.__version__
98 
99 # The language for content autogenerated by Sphinx. Refer to documentation
100 # for a list of supported languages.
101 # language = None
102 
103 # There are two options for replacing |today|: either, you set today to some
104 # non-false value, then it is used:
105 # today = ''
106 # Else, today_fmt is used as the format for a strftime call.
107 # today_fmt = '%B %d, %Y'
108 
109 # List of patterns, relative to source directory, that match files and
110 # directories to ignore when looking for source files.
111 exclude_patterns = []
112 
113 # The reST default role (used for this markup: `text`) to use for all documents.
114 # default_role = None
115 
116 # If true, '()' will be appended to :func: etc. cross-reference text.
117 # add_function_parentheses = True
118 
119 # If true, the current module name will be prepended to all description
120 # unit titles (such as .. function::).
121 # add_module_names = True
122 
123 # If true, sectionauthor and moduleauthor directives will be shown in the
124 # output. They are ignored by default.
125 # show_authors = False
126 
127 # The name of the Pygments (syntax highlighting) style to use.
128 pygments_style = "sphinx"
129 
130 # A list of ignored prefixes for module index sorting.
131 # modindex_common_prefix = []
132 
133 
134 # -- Options for HTML output ---------------------------------------------------
135 
136 # The theme to use for HTML and HTML Help pages.  See the documentation for
137 # a list of builtin themes.
138 html_theme = "pydata_sphinx_theme"
139 
140 # Theme options are theme-specific and customize the look and feel of a theme
141 # further.  For a list of options available for each theme, see the
142 # documentation.
143 html_theme_options = {
144     "search_bar_position": "sidebar",
145     "github_url": "https://github.com/geopandas/geopandas",
146     "twitter_url": "https://twitter.com/geopandas",
147 }
148 
149 # Add any paths that contain custom themes here, relative to this directory.
150 # html_theme_path = []
151 
152 # The name for this set of Sphinx documents.  If None, it defaults to
153 # "<project> v<release> documentation".
154 # html_title = None
155 
156 # A shorter title for the navigation bar.  Default is the same as html_title.
157 # html_short_title = None
158 
159 # The name of an image file (relative to this directory) to place at the top
160 # of the sidebar.
161 html_logo = "_static/logo/geopandas_logo_web.svg"
162 
163 # The name of an image file (within the static path) to use as favicon of the
164 # docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
165 # pixels large.
166 html_favicon = "_static/logo/favicon.png"
167 
168 # Add any paths that contain custom static files (such as style sheets) here,
169 # relative to this directory. They are copied after the builtin static files,
170 # so a file named "default.css" will overwrite the builtin "default.css".
171 html_static_path = ["_static"]
172 
173 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
174 # using the given strftime format.
175 # html_last_updated_fmt = '%b %d, %Y'
176 
177 # If true, SmartyPants will be used to convert quotes and dashes to
178 # typographically correct entities.
179 # html_use_smartypants = True
180 
181 # Custom sidebar templates, maps document names to template names.
182 # html_sidebars = {}
183 
184 # Additional templates that should be rendered to pages, maps page names to
185 # template names.
186 # html_additional_pages = {}
187 
188 # Add redirect for previously existing pages, each item is like `(from_old, to_new)`
189 
190 moved_pages = [
191     # user guide
192     ("aggregation_with_dissolve", "docs/user_guide/aggregation_with_dissolve"),
193     ("data_structures", "docs/user_guide/data_structures"),
194     ("geocoding", "docs/user_guide/geocoding"),
195     ("geometric_manipulations", "docs/user_guide/geometric_manipulations"),
196     ("indexing", "docs/user_guide/indexing"),
197     ("io", "docs/user_guide/io"),
198     ("mapping", "docs/user_guide/mapping"),
199     ("mergingdata", "docs/user_guide/mergingdata"),
200     ("missing_empty", "docs/user_guide/missing_empty"),
201     ("projections", "docs/user_guide/projections"),
202     ("set_operations", "docs/user_guide/set_operations"),
203     # other
204     ("install", "getting_started/install"),
205     ("reference", "docs/reference"),
206     ("changelog", "docs/changelog"),
207     ("code_of_conduct", "community/code_of_conduct"),
208     ("contributing", "community/contributing"),
209 ]
210 
211 html_additional_pages = {page[0]: "redirect.html" for page in moved_pages}
212 
213 html_context = {"redirects": {old: new for old, new in moved_pages}}
214 
215 # If false, no module index is generated.
216 # html_domain_indices = True
217 
218 # If false, no index is generated.
219 # html_use_index = True
220 
221 # If true, the index is split into individual pages for each letter.
222 # html_split_index = False
223 
224 # If true, links to the reST sources are added to the pages.
225 # html_show_sourcelink = True
226 
227 # If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
228 # html_show_sphinx = True
229 
230 # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
231 # html_show_copyright = True
232 
233 # If true, an OpenSearch description file will be output, and all pages will
234 # contain a <link> tag referring to it.  The value of this option must be the
235 # base URL from which the finished HTML is served.
236 # html_use_opensearch = ''
237 
238 # This is the file name suffix for HTML files (e.g. ".xhtml").
239 # html_file_suffix = None
240 
241 # Output file base name for HTML help builder.
242 htmlhelp_basename = "GeoPandasdoc"
243 
244 
245 # -- Options for LaTeX output --------------------------------------------------
246 
247 latex_elements = {
248     # The paper size ('letterpaper' or 'a4paper').
249     #'papersize': 'letterpaper',
250     # The font size ('10pt', '11pt' or '12pt').
251     #'pointsize': '10pt',
252     # Additional stuff for the LaTeX preamble.
253     #'preamble': '',
254 }
255 
256 # Grouping the document tree into LaTeX files. List of tuples
257 # (source start file, target name, title, author, documentclass [howto/manual]).
258 latex_documents = [
259     ("index", "GeoPandas.tex", u"GeoPandas Documentation", u"Kelsey Jordahl", "manual")
260 ]
261 
262 # The name of an image file (relative to this directory) to place at the top of
263 # the title page.
264 # latex_logo = None
265 
266 # For "manual" documents, if this is true, then toplevel headings are parts,
267 # not chapters.
268 # latex_use_parts = False
269 
270 # If true, show page references after internal links.
271 # latex_show_pagerefs = False
272 
273 # If true, show URL addresses after external links.
274 # latex_show_urls = False
275 
276 # Documents to append as an appendix to all manuals.
277 # latex_appendices = []
278 
279 # If false, no module index is generated.
280 # latex_domain_indices = True
281 
282 
283 # -- Options for manual page output --------------------------------------------
284 
285 # One entry per manual page. List of tuples
286 # (source start file, name, description, authors, manual section).
287 man_pages = [("index", "geopandas", u"GeoPandas Documentation", [u"Kelsey Jordahl"], 1)]
288 
289 # If true, show URL addresses after external links.
290 # man_show_urls = False
291 
292 
293 # -- Options for Texinfo output ------------------------------------------------
294 
295 # Grouping the document tree into Texinfo files. List of tuples
296 # (source start file, target name, title, author,
297 #  dir menu entry, description, category)
298 texinfo_documents = [
299     (
300         "index",
301         "GeoPandas",
302         u"GeoPandas Documentation",
303         u"Kelsey Jordahl",
304         "GeoPandas",
305         "One line description of project.",
306         "Miscellaneous",
307     )
308 ]
309 
310 # Documents to append as an appendix to all manuals.
311 # texinfo_appendices = []
312 
313 # If false, no module index is generated.
314 # texinfo_domain_indices = True
315 
316 # How to display URL addresses: 'footnote', 'no', or 'inline'.
317 # texinfo_show_urls = 'footnote'
318 
319 nbsphinx_prolog = r"""
320 {% set docname = env.doc2path(env.docname, base=None) %}
321 
322 .. only:: html
323 
324     .. role:: raw-html(raw)
325         :format: html
326 
327     .. note::
328 
329         | This page was generated from `{{ docname }}`__.
330         | 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>`
331 
332         __ https://github.com/geopandas/geopandas/blob/master/doc/source/{{ docname }}
333 """
334 
335 #  --Options for sphinx extensions -----------------------------------------------
336 
337 intersphinx_mapping = {
338     "pandas": (
339         "https://pandas.pydata.org/pandas-docs/stable/",
340         "https://pandas.pydata.org/pandas-docs/stable/objects.inv",
341     ),
342 }
```
--- 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
@@ -66,8 +66,6 @@
 nbsphinx_execute = "always"
 nbsphinx_allow_errors = True
 
-# connect docs in other projects
-intersphinx_mapping = {"pyproj": ("http://pyproj4.github.io/pyproj/stable/", None)}
 # suppress matplotlib warning in examples
 warnings.filterwarnings(
     "ignore",
@@ -334,9 +332,74 @@
 
 #  --Options for sphinx extensions -----------------------------------------------
 
+# connect docs in other projects
 intersphinx_mapping = {
+    "pyproj": (
+        "https://pyproj4.github.io/pyproj/stable/",
+        "https://pyproj4.github.io/pyproj/stable/objects.inv",
+    ),
     "pandas": (
         "https://pandas.pydata.org/pandas-docs/stable/",
         "https://pandas.pydata.org/pandas-docs/stable/objects.inv",
     ),
-}
\ No newline at end of file
+    "shapely": (
+        "https://shapely.readthedocs.io/en/stable/",
+        "https://shapely.readthedocs.io/en/stable/objects.inv",
+    ),
+    "fiona": (
+        "https://fiona.readthedocs.io/en/stable/",
+        "https://fiona.readthedocs.io/en/stable/objects.inv",
+    ),
+    "pygeos": (
+        "https://pygeos.readthedocs.io/en/latest/",
+        "https://pygeos.readthedocs.io/en/latest/objects.inv",
+    ),
+    "rtree": (
+      "https://rtree.readthedocs.io/en/stable/",
+      "https://rtree.readthedocs.io/en/stable/objects.inv",
+    ),
+    "mapclassify": (
+        "https://pysal.org/mapclassify/",
+        "https://pysal.org/mapclassify/objects.inv"
+    ),
+    "libpysal": (
+        "https://pysal.org/libpysal/",
+        "https://pysal.org/libpysal/objects.inv"
+    ),
+    "matplotlib": (
+        "https://matplotlib.org/stable/",
+        "https://matplotlib.org/stable/objects.inv",
+    ),
+    "geopy": (
+        "https://geopy.readthedocs.io/en/stable/",
+        "https://geopy.readthedocs.io/en/stable/objects.inv",
+    ),
+    "cartopy": (
+        "https://scitools.org.uk/cartopy/docs/latest/",
+        "https://scitools.org.uk/cartopy/docs/latest/objects.inv"
+    ),
+    "pyepsg": (
+        "https://pyepsg.readthedocs.io/en/stable/",
+        "https://pyepsg.readthedocs.io/en/stable/objects.inv"
+    ),
+    "contextily": (
+        "https://contextily.readthedocs.io/en/stable/",
+        "https://contextily.readthedocs.io/en/stable/objects.inv"
+    ),
+    "rasterio": (
+        "https://rasterio.readthedocs.io/en/stable/",
+        "https://rasterio.readthedocs.io/en/stable/objects.inv"
+    ),
+    "geoplot": (
+        "https://residentmario.github.io/geoplot/index.html",
+        "https://residentmario.github.io/geoplot/objects.inv"
+    ),
+    "folium": (
+        "https://python-visualization.github.io/folium/",
+        "https://python-visualization.github.io/folium/objects.inv"
+    ),
+    "python": (
+        "https://docs.python.org/3",
+        "https://docs.python.org/3/objects.inv"
+    )
+}

{"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@@ -66,8 +66,6 @@\n nbsphinx_execute = \"always\"\n nbsphinx_allow_errors = True\n \n-# connect docs in other projects\n-intersphinx_mapping = {\"pyproj\": (\"http://pyproj4.github.io/pyproj/stable/\", None)}\n # suppress matplotlib warning in examples\n warnings.filterwarnings(\n     \"ignore\",\n@@ -334,9 +332,74 @@\n \n #  --Options for sphinx extensions -----------------------------------------------\n \n+# connect docs in other projects\n intersphinx_mapping = {\n+    \"pyproj\": (\n+        \"https://pyproj4.github.io/pyproj/stable/\",\n+        \"https://pyproj4.github.io/pyproj/stable/objects.inv\",\n+    ),\n     \"pandas\": (\n         \"https://pandas.pydata.org/pandas-docs/stable/\",\n         \"https://pandas.pydata.org/pandas-docs/stable/objects.inv\",\n     ),\n-}\n\\ No newline at end of file\n+    \"shapely\": (\n+        \"https://shapely.readthedocs.io/en/stable/\",\n+        \"https://shapely.readthedocs.io/en/stable/objects.inv\",\n+    ),\n+    \"fiona\": (\n+        \"https://fiona.readthedocs.io/en/stable/\",\n+        \"https://fiona.readthedocs.io/en/stable/objects.inv\",\n+    ),\n+    \"pygeos\": (\n+        \"https://pygeos.readthedocs.io/en/latest/\",\n+        \"https://pygeos.readthedocs.io/en/latest/objects.inv\",\n+    ),\n+    \"rtree\": (\n+      \"https://rtree.readthedocs.io/en/stable/\",\n+      \"https://rtree.readthedocs.io/en/stable/objects.inv\",\n+    ),\n+    \"mapclassify\": (\n+        \"https://pysal.org/mapclassify/\",\n+        \"https://pysal.org/mapclassify/objects.inv\"\n+    ),\n+    \"libpysal\": (\n+        \"https://pysal.org/libpysal/\",\n+        \"https://pysal.org/libpysal/objects.inv\"\n+    ),\n+    \"matplotlib\": (\n+        \"https://matplotlib.org/stable/\",\n+        \"https://matplotlib.org/stable/objects.inv\",\n+    ),\n+    \"geopy\": (\n+        \"https://geopy.readthedocs.io/en/stable/\",\n+        \"https://geopy.readthedocs.io/en/stable/objects.inv\",\n+    ),\n+    \"cartopy\": (\n+        \"https://scitools.org.uk/cartopy/docs/latest/\",\n+        \"https://scitools.org.uk/cartopy/docs/latest/objects.inv\"\n+    ),\n+    \"pyepsg\": (\n+        \"https://pyepsg.readthedocs.io/en/stable/\",\n+        \"https://pyepsg.readthedocs.io/en/stable/objects.inv\"\n+    ),\n+    \"contextily\": (\n+        \"https://contextily.readthedocs.io/en/stable/\",\n+        \"https://contextily.readthedocs.io/en/stable/objects.inv\"\n+    ),\n+    \"rasterio\": (\n+        \"https://rasterio.readthedocs.io/en/stable/\",\n+        \"https://rasterio.readthedocs.io/en/stable/objects.inv\"\n+    ),\n+    \"geoplot\": (\n+        \"https://residentmario.github.io/geoplot/index.html\",\n+        \"https://residentmario.github.io/geoplot/objects.inv\"\n+    ),\n+    \"folium\": (\n+        \"https://python-visualization.github.io/folium/\",\n+        \"https://python-visualization.github.io/folium/objects.inv\"\n+    ),\n+    \"python\": (\n+        \"https://docs.python.org/3\",\n+        \"https://docs.python.org/3/objects.inv\"\n+    )\n+}\n", "issue": "DOC: add links to relevant API to the user guide \nWe should ensure that when referring documented objects/methods in the user guide, we link to the relevant API pages using for example `:py:class:`GeoSeries` and intersphinx mapping to link pandas, pyproj, matplotlib et al. \r\n\r\nSee the first step done in #1926 done by @raybellwaves for an illustration.\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_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\n#  --Options for sphinx extensions -----------------------------------------------\n\nintersphinx_mapping = {\n    \"pandas\": (\n        \"https://pandas.pydata.org/pandas-docs/stable/\",\n        \"https://pandas.pydata.org/pandas-docs/stable/objects.inv\",\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# 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\n#  --Options for sphinx extensions -----------------------------------------------\n\n# connect docs in other projects\nintersphinx_mapping = {\n    \"pyproj\": (\n        \"https://pyproj4.github.io/pyproj/stable/\",\n        \"https://pyproj4.github.io/pyproj/stable/objects.inv\",\n    ),\n    \"pandas\": (\n        \"https://pandas.pydata.org/pandas-docs/stable/\",\n        \"https://pandas.pydata.org/pandas-docs/stable/objects.inv\",\n    ),\n    \"shapely\": (\n        \"https://shapely.readthedocs.io/en/stable/\",\n        \"https://shapely.readthedocs.io/en/stable/objects.inv\",\n    ),\n    \"fiona\": (\n        \"https://fiona.readthedocs.io/en/stable/\",\n        \"https://fiona.readthedocs.io/en/stable/objects.inv\",\n    ),\n    \"pygeos\": (\n        \"https://pygeos.readthedocs.io/en/latest/\",\n        \"https://pygeos.readthedocs.io/en/latest/objects.inv\",\n    ),\n    \"rtree\": (\n      \"https://rtree.readthedocs.io/en/stable/\",\n      \"https://rtree.readthedocs.io/en/stable/objects.inv\",\n    ),\n    \"mapclassify\": (\n        \"https://pysal.org/mapclassify/\",\n        \"https://pysal.org/mapclassify/objects.inv\"\n    ),\n    \"libpysal\": (\n        \"https://pysal.org/libpysal/\",\n        \"https://pysal.org/libpysal/objects.inv\"\n    ),\n    \"matplotlib\": (\n        \"https://matplotlib.org/stable/\",\n        \"https://matplotlib.org/stable/objects.inv\",\n    ),\n    \"geopy\": (\n        \"https://geopy.readthedocs.io/en/stable/\",\n        \"https://geopy.readthedocs.io/en/stable/objects.inv\",\n    ),\n    \"cartopy\": (\n        \"https://scitools.org.uk/cartopy/docs/latest/\",\n        \"https://scitools.org.uk/cartopy/docs/latest/objects.inv\"\n    ),\n    \"pyepsg\": (\n        \"https://pyepsg.readthedocs.io/en/stable/\",\n        \"https://pyepsg.readthedocs.io/en/stable/objects.inv\"\n    ),\n    \"contextily\": (\n        \"https://contextily.readthedocs.io/en/stable/\",\n        \"https://contextily.readthedocs.io/en/stable/objects.inv\"\n    ),\n    \"rasterio\": (\n        \"https://rasterio.readthedocs.io/en/stable/\",\n        \"https://rasterio.readthedocs.io/en/stable/objects.inv\"\n    ),\n    \"geoplot\": (\n        \"https://residentmario.github.io/geoplot/index.html\",\n        \"https://residentmario.github.io/geoplot/objects.inv\"\n    ),\n    \"folium\": (\n        \"https://python-visualization.github.io/folium/\",\n        \"https://python-visualization.github.io/folium/objects.inv\"\n    ),\n    \"python\": (\n        \"https://docs.python.org/3\",\n        \"https://docs.python.org/3/objects.inv\"\n    )\n}\n", "path": "doc/source/conf.py"}]}