DOC: Fix building of a single API document (#24506)

Author: datapythonista

doc/make.py

@@ -50,7 +50,7 @@ def __init__(self, num_jobs=0, include_api=True, single_doc=None,
         if single_doc and single_doc.endswith('.rst'):
             self.single_doc_html = os.path.splitext(single_doc)[0] + '.html'
         elif single_doc:
-            self.single_doc_html = 'generated/pandas.{}.html'.format(
+            self.single_doc_html = 'api/generated/pandas.{}.html'.format(
                 single_doc)
 
     def _process_single_doc(self, single_doc):

doc/source/conf.py

@@ -98,8 +98,7 @@
                 if (fname == 'index.rst'
                         and os.path.abspath(dirname) == source_path):
                     continue
-                elif (pattern == '-api'
-                        and (fname == 'api.rst' or dirname == 'generated')):
+                elif pattern == '-api' and dirname == 'api':
                     exclude_patterns.append(fname)
                 elif fname != pattern:
                     exclude_patterns.append(fname)

doc/source/index.rst.template

@@ -113,7 +113,7 @@ See the package overview for more detail about what's in the library.
     {{ single_doc[:-4] }}
 {% elif single_doc %}
 .. autosummary::
-    :toctree: generated/
+    :toctree: api/generated/
 
     {{ single_doc }}
 {% else -%}