custom-404-page

This version uses the sphinx-notfound-page extension: https://github.com/humitos/sphinx-notfound-page

Once built, 404.html page should show

  • all the CSS and Javascript properly,

  • all the internal URLs should be absolute,

  • page style should not visually break,

  • all external resources with abasolute URLs (no modified),

  • internal URLs must be pre-pended by /en/latest/ which are the default language and default version

Issue on Read the Docs that deal with this topic.

Warning

Until Read the Docs does not implement the check for custom 404 pages on the repository, this branch won’t shows 404 automatically on all 404 pages.


Sphinx configuration file to build this docs (see full file),

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
# -*- coding: utf-8 -*-

# Default settings
project = 'Test Builds'
extensions = [
    'sphinx_autorun',
    'notfound.extension',
]

# Include all your settings here
html_theme = 'sphinx_rtd_theme'






>>> # Build at
>>> import datetime
>>> datetime.datetime.utcnow()  # UTC
datetime.datetime(2019, 3, 29, 16, 19, 11, 627733)