Add sphinx-notfound-page and sphinx-rediraffe for 404 and redirect handling (xarray-contrib#87)

* add sphinx-not-found 404 page
* add extensions to env, add redirect

Author: scottyhq

_config.yml

@@ -57,6 +57,21 @@ repository:
 # Bibliography
 bibtex_bibfiles:
   - reference/references.bib
+
+# Advanced configuration
 sphinx:
+  extra_extensions:
+    # 404 not found page
+    - notfound.extension
+    # maintain old paths and redirect them (so google results dont go to 404)
+    # https://github.com/wpilibsuite/sphinxext-rediraffe
+    - sphinxext.rediraffe
   config:
+    notfound_context:
+      body: "<h1>Whoops! 404 Page Not Found</h1>\n\n<p>Sorry, this page doesn't exist. Many sections of this book have been updated recently.</p><p> Try the search box 🔎 to find what you're looking for!</p>"
+    notfound_urls_prefix: /
+
+    rediraffe_redirects:
+      scipy-tutorial/00_overview.ipynb: overview/get-started.md
+
     bibtex_reference_style: author_year # or label, super, \supercite

_toc.yml

@@ -6,6 +6,7 @@ parts:
     chapters:
       - file: overview/get-started.md
       - file: overview/xarray-in-45-min
+
   - caption: Fundamentals
     chapters:
       - file: fundamentals/01_datastructures_and_io
@@ -22,6 +23,7 @@ parts:
     chapters:
       - file: intermediate/01-high-level-computation-patterns
       - file: intermediate/xarray_and_dask
+
   - caption: Advanced
     chapters:
       - file: advanced/parallelize-custom-functions
@@ -43,8 +45,6 @@ parts:
           - file: workshops/online-tutorial-series/03_computation
       - file: workshops/scipy2022/README
         sections:
-          - url: https://tutorial.xarray.dev/fundamentals/00_overview
-            title: Introduction
           - url: https://tutorial.xarray.dev/fundamentals/01_datastructures_and_io
             title: Data Structures
           - file: workshops/scipy2022/cleaning_real_data