diff --git a/doc/source/conf.py b/doc/source/conf.py
index 951a6d40437868..7f7309bae7031a 100644
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -68,7 +68,12 @@
"contributors", # custom pandas extension
]
-exclude_patterns = ["**.ipynb_checkpoints"]
+exclude_patterns = [
+ "**.ipynb_checkpoints",
+ # to ensure that include files (partial pages) aren't built, exclude them
+ # https://github.com/sphinx-doc/sphinx/issues/1965#issuecomment-124732907
+ "**/includes/**",
+]
try:
import nbconvert
except ImportError:
diff --git a/doc/source/getting_started/intro_tutorials/02_read_write.rst b/doc/source/getting_started/intro_tutorials/02_read_write.rst
index 3457ed142510b7..d69a48def02876 100644
--- a/doc/source/getting_started/intro_tutorials/02_read_write.rst
+++ b/doc/source/getting_started/intro_tutorials/02_read_write.rst
@@ -17,7 +17,7 @@
-
-.. include:: titanic.rst
+.. include:: includes/titanic.rst
.. raw:: html
diff --git a/doc/source/getting_started/intro_tutorials/03_subset_data.rst b/doc/source/getting_started/intro_tutorials/03_subset_data.rst
index 083e4f9d8373ee..fe3eae6c429596 100644
--- a/doc/source/getting_started/intro_tutorials/03_subset_data.rst
+++ b/doc/source/getting_started/intro_tutorials/03_subset_data.rst
@@ -17,7 +17,7 @@
-
-.. include:: titanic.rst
+.. include:: includes/titanic.rst
.. ipython:: python
diff --git a/doc/source/getting_started/intro_tutorials/04_plotting.rst b/doc/source/getting_started/intro_tutorials/04_plotting.rst
index ef0e5592f6f934..615b944fd395f6 100644
--- a/doc/source/getting_started/intro_tutorials/04_plotting.rst
+++ b/doc/source/getting_started/intro_tutorials/04_plotting.rst
@@ -18,7 +18,7 @@
-
-. include:: air_quality_no2.rst
+.. include:: includes/air_quality_no2.rst
.. ipython:: python
diff --git a/doc/source/getting_started/intro_tutorials/05_add_columns.rst b/doc/source/getting_started/intro_tutorials/05_add_columns.rst
index fc7dfc7dcc29dd..dc18be935b9730 100644
--- a/doc/source/getting_started/intro_tutorials/05_add_columns.rst
+++ b/doc/source/getting_started/intro_tutorials/05_add_columns.rst
@@ -17,7 +17,7 @@
-
-. include:: air_quality_no2.rst
+.. include:: includes/air_quality_no2.rst
.. ipython:: python
diff --git a/doc/source/getting_started/intro_tutorials/06_calculate_statistics.rst b/doc/source/getting_started/intro_tutorials/06_calculate_statistics.rst
index 2420544c28bef3..fcf754e340ab20 100644
--- a/doc/source/getting_started/intro_tutorials/06_calculate_statistics.rst
+++ b/doc/source/getting_started/intro_tutorials/06_calculate_statistics.rst
@@ -17,7 +17,7 @@
-
-.. include:: titanic.rst
+.. include:: includes/titanic.rst
.. ipython:: python
diff --git a/doc/source/getting_started/intro_tutorials/07_reshape_table_layout.rst b/doc/source/getting_started/intro_tutorials/07_reshape_table_layout.rst
index 0f550cbeb21542..bd4a617fe753bf 100644
--- a/doc/source/getting_started/intro_tutorials/07_reshape_table_layout.rst
+++ b/doc/source/getting_started/intro_tutorials/07_reshape_table_layout.rst
@@ -17,7 +17,7 @@
-
-.. include:: titanic.rst
+.. include:: includes/titanic.rst
.. ipython:: python
diff --git a/doc/source/getting_started/intro_tutorials/10_text_data.rst b/doc/source/getting_started/intro_tutorials/10_text_data.rst
index 2df8b1cb297704..63db920164ac3f 100644
--- a/doc/source/getting_started/intro_tutorials/10_text_data.rst
+++ b/doc/source/getting_started/intro_tutorials/10_text_data.rst
@@ -16,7 +16,7 @@
-
-.. include:: titanic.rst
+.. include:: includes/titanic.rst
.. ipython:: python
diff --git a/doc/source/getting_started/intro_tutorials/air_quality_no2.rst b/doc/source/getting_started/intro_tutorials/includes/air_quality_no2.rst
similarity index 98%
rename from doc/source/getting_started/intro_tutorials/air_quality_no2.rst
rename to doc/source/getting_started/intro_tutorials/includes/air_quality_no2.rst
index 7515e004a41777..a5a5442330e43f 100644
--- a/doc/source/getting_started/intro_tutorials/air_quality_no2.rst
+++ b/doc/source/getting_started/intro_tutorials/includes/air_quality_no2.rst
@@ -1,5 +1,3 @@
-:orphan:
-
.. raw:: html
diff --git a/doc/source/getting_started/intro_tutorials/titanic.rst b/doc/source/getting_started/intro_tutorials/includes/titanic.rst
similarity index 99%
rename from doc/source/getting_started/intro_tutorials/titanic.rst
rename to doc/source/getting_started/intro_tutorials/includes/titanic.rst
index e73f18a6f26693..7032b70b3f1cf1 100644
--- a/doc/source/getting_started/intro_tutorials/titanic.rst
+++ b/doc/source/getting_started/intro_tutorials/includes/titanic.rst
@@ -1,5 +1,3 @@
-:orphan:
-
.. raw:: html