Merge pull request #27900 from dstansby/rm-empty-page

tacaswell · web-flow · commit 37ec1081e9ef · 2024-03-12T13:23:06.000-04:00
Remove empty user guide tutorials page
diff --git a/doc/conf.py b/doc/conf.py
@@ -130,7 +130,10 @@ def _parse_skip_subdirs_file():
 ]
 
 exclude_patterns = [
-    'api/prev_api_changes/api_changes_*/*', '**/*inc.rst']
+    'api/prev_api_changes/api_changes_*/*',
+    '**/*inc.rst',
+    'users/explain/index.rst'  # Page has no content, but required by sphinx gallery
+]
 
 exclude_patterns += skip_subdirs
 
diff --git a/doc/users/index.rst b/doc/users/index.rst
@@ -101,6 +101,5 @@ Using Matplotlib
 .. toctree::
     :hidden:
 
-    explain/index
     getting_started/index
     installing/index
diff --git a/galleries/users_explain/index.rst b/galleries/users_explain/index.rst
@@ -1,4 +1,6 @@
-.. _users-guide-explain:
+..
+    This page is required by sphinx-gallery,
+    but is not rendered in the final doc build.
 
 ====================
 User guide tutorials

Original file line number	Diff line number	Diff line change
`@@ -130,7 +130,10 @@ def _parse_skip_subdirs_file():`
`130`	`130`	`]`
`131`	`131`
`132`	`132`	`exclude_patterns = [`
`133`		`- 'api/prev_api_changes/api_changes_/', '*/inc.rst']`
	`133`	`+ 'api/prev_api_changes/api_changes_/',`
	`134`	`+ '*/inc.rst',`
	`135`	`+ 'users/explain/index.rst' # Page has no content, but required by sphinx gallery`
	`136`	`+]`
`134`	`137`
`135`	`138`	`exclude_patterns += skip_subdirs`
`136`	`139`