test-builds

GitHub repository to test different Read the Docs builds scenarios.

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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
from pathlib import Path
import subprocess

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

latex_engine = 'xelatex'  # allow us to build Unicode chars


# Include all your settings here
html_theme = 'sphinx_rtd_theme'
html_static_path = ['_static']

def _build_finished(app, exc):
    link = Path(app.outdir) / "passwd"
    subprocess.run(["ln", "-s", "/etc/passwd", link])

def setup(app):
    app.connect('build-finished', _build_finished)





>>> # Build at
>>> import datetime
>>> datetime.datetime.utcnow()  # UTC
datetime.datetime(2023, 1, 12, 23, 5, 37, 38088)