Was this page helpful?
Caution
You're viewing documentation for an unstable version of ScyllaDB Sphinx Theme. Switch to the latest stable version.
This guide explains how to upgrade the version of the ScyllaDB Sphinx Theme.
The theme version is displayed in the footer of the project’s documentation site.
If your project theme’s version is >=1.5, follow this guide to get the latest version.
Here are the main breaking changes between the 1.5 and 1.6 versions.
Update the following Python dependencies in docs/pyproject.toml
:
sphinx-scylladb-theme = "~1.6.1" pyyaml = "6.0.1" Sphinx = "7.2.6" sphinx-multiversion-scylla = "~0.3.1" sphinx-sitemap = "2.5.1"
Open docs/Makefile
file and remove the following lines:
# Windows variables ifeq ($(OS),Windows_NT) POETRY = $(APPDATA)\Python\Scripts\poetry endifNote
If you are on Windows, ensure that Poetry is configured in your system’s PATH. For guidance on how to add Poetry to your PATH, refer to the Poetry documentation.
Build the docs locally:
cd docs make preview
Review and address any warnings that may arise in the terminal during the build process.
Was this page helpful?