Build with build.jobs
¶
This version is built with build.jobs
.
It only builds when the docs
dir has changed.
Nota
The following text should be something different than { VERSION }
: {VERSION}
We are using sed
to replace the version with the value of READTHEDOCS_VERSION_NAME
.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | version: 2 build: os: ubuntu-20.04 jobs: post_checkout: - echo `date` # Exit when there aren't changed in docs directory # --quiet exits with a 1 when there **are** changes, # so we invert the logic with a ! - "! git diff --quiet origin/main -- docs" tools: python: "3" sphinx: configuration: docs/conf.py python: install: - requirements: requirements.txt |
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 | # -*- coding: utf-8 -*- # 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' |
>>> # Build at
>>> import datetime
>>> datetime.datetime.utcnow() # UTC
datetime.datetime(2022, 10, 7, 21, 15, 4, 161049)