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, 4, 1, 445176)