sphinx-multiversion

Fork of https://github.com/Holzhaus/sphinx-multiversion for the ScyllaDB Project.

Sphinx extension for building self-hosted versioned docs.

Original documentation can be found at: https://holzhaus.github.io/sphinx-multiversion/

Fork additions

Prebuild and postbuild commands

The fork introduces the possibility to run custom commands before and after building the docs with the option --pre-build and --post-build.

This could be useful to prepare the docs repository before running sphinx-build, debug the execution, or even generate versioned documentation using other builders.

For example, imagine that you want to build versioned docs written in Sphinx, but the API reference is generated with JavaDoc. This option enables the generation of both versioned docs to host them under the same folder using GitHub Pages.

Here's an example showing the directory where the build command is running:

sphinx-multiversion docs build/html --pre-build pw

You can pass multiple commands by adding extra --pre-build or --post-build options. The commands run in order, from left to right:

sphinx-multiversion docs build/html --pre-build pwd --pre-build ls --post-build "cat file.txt"

Rename latest version URL

The smv_latest_version setting determines which is the latest version. Setting this option could be useful to show a warning when users are not reading the latest version.

You can override the latest version output directory with smv_rename_latest_version.

Here's an example:

smv_latest_version = 'x.y.z'         # Use the branch/tag name
smv_rename_latest_version = 'latest' # Use the commit hash

Sphinx 9 compatibility

Updated Config.read() calls to use keyword-only arguments (overrides=, tags=) as required by Sphinx 9.

Version specific overrides

The following properties can be defined on a per-version basis.

rst_prolog
myst_substitutions: Introduced in 0.3.3
exclude_patterns: Introduced in 0.3.2

License

BSD 2-Clause License

Modifications (see "Fork Additions") 2020, David Garcia hi@davidgarcia.dev

Release files for sphinx-multiversion-scylla 0.3.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sphinx-multiversion-scylla 0.3.8
File	Size	Uploaded
sphinx_multiversion_scylla-0.3.8.tar.gz	12.7 kB	Apr 13, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for sphinx-multiversion-scylla 0.3.8
File	Interpreter	ABI	Platform	Reset
sphinx_multiversion_scylla-0.3.8-py3-none-any.whl 12.7 kB Apr 13, 2026	Python 3	none	any	Details

Total release size: 25.4 kB

Release files / sphinx_multiversion_scylla-0.3.8.tar.gz

Download URL	sphinx_multiversion_scylla-0.3.8.tar.gz
Size	12.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`418b563afd3c75c40f096b614cb4c595928692fb0b340762e5fd19c876567040`
BLAKE2b-256 checksum How to use checksums	`83b7ca070ac96cbca8b91c499827790ca4816a259b9259a961108a3fd9fa470c`
Upload date	Apr 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.9`

Release files / sphinx_multiversion_scylla-0.3.8-py3-none-any.whl

Download URL	sphinx_multiversion_scylla-0.3.8-py3-none-any.whl
Size	12.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a3a16724eb5ec76563f12dd66efb2e7c5d9aa2ddf5e8bb755e817f9973b44ffd`
BLAKE2b-256 checksum How to use checksums	`671dc4dea80220e2cab5dc326da2369ecac60b5fc71cb0643df698ef76bb14bb`
Upload date	Apr 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.9`