404: catch page not found error

docker/Dockerfile

@@ -32,6 +32,8 @@ RUN apt-get update && apt-get install -y \
 RUN pip3 install Sphinx
 RUN pip3 install sphinx-rtd-theme
 RUN pip3 install sphinx-autobuild
+RUN pip3 install sphinx-notfound-page
+
 
 # Cleanup
 RUN rm -rf /var/lib/apt/lists/*

docs/404.rst

@@ -0,0 +1,10 @@
+:orphan:
+
+Page Not Found
+==============
+
+Sorry, We could not find a page.
+Try using the search box or go to the release homepage:
+
+  * `1.2.x (crux) <https://docs.vyos.io/en/crux/>`_
+  * `rolling release (equuleus) <https://docs.vyos.io/en/latest/>`_

docs/conf.py

@@ -44,6 +44,7 @@ extensions = ['sphinx.ext.intersphinx',
               'sphinx.ext.todo',
               'sphinx.ext.ifconfig',
               'sphinx.ext.graphviz',
+              'notfound.extension',
               'vyos'
 ]
 

requirements.txt

@@ -1,4 +1,5 @@
 Sphinx>=1.4.3
 sphinx-rtd-theme
 setuptools
-docutils
+docutils
+sphinx-notfound-page