Sphinx multi-page HTMLZip

Use the same output from StandaloneHTMLBuilder to generate a zipped version of it. Expose the .zip file as downloadable content.

Read the Docs .readthedocs.yaml configuration file used to build this docs.

 1version: 2
 2
 3build:
 4  os: ubuntu-22.04
 5  tools:
 6    python: "3"
 7  jobs:
 8    post_build:
 9      - mkdir --parents _readthedocs/htmlzip
10      - cp --recursive _readthedocs/html _readthedocs/$READTHEDOCS_PROJECT
11      - cd _readthedocs ; zip --recurse-path --symlinks htmlzip/$READTHEDOCS_PROJECT.zip $READTHEDOCS_PROJECT
12
13sphinx:
14  configuration: docs/conf.py
15
16python:
17  install:
18    - 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]
 8
 9latex_engine = 'xelatex'  # allow us to build Unicode chars
10
11
12# Include all your settings here
13html_theme = 'sphinx_rtd_theme'
14
15
16
17

>>> # Build at
>>> import datetime
>>> datetime.datetime.utcnow()  # UTC
datetime.datetime(2023, 1, 31, 13, 9, 59, 41415)