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.

Read the Docs configuration file used to build this docs:

 1version: 2
 2
 3build:
 4  os: ubuntu-22.04
 5  tools:
 6    python: "3"
 7  apt_packages:
 8    - tree
 9
10sphinx:
11  configuration: docs/conf.py
12
13python:
14  install:
15    - requirements: requirements.txt

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

 1# -*- coding: utf-8 -*-
 2
 3# Default settings
 4project = 'Test Builds'
 5extensions = [
 6    'sphinx_autorun',
 7    'notfound.extension',
 8]
 9
10latex_engine = 'xelatex'  # allow us to build Unicode chars
11
12
13# Include all your settings here
14html_theme = 'sphinx_rtd_theme'
15
16
17
18

>>> # Build at
>>> import datetime
>>> datetime.datetime.utcnow()  # UTC
datetime.datetime(2023, 9, 19, 18, 3, 57, 730336)