ScyllaDB University Live | Free Virtual Training Event
Learn more
ScyllaDB Documentation Logo Documentation
  • Server
  • Cloud
  • Tools
    • ScyllaDB Manager
    • ScyllaDB Monitoring Stack
    • ScyllaDB Operator
  • Drivers
    • CQL Drivers
    • DynamoDB Drivers
  • Resources
    • ScyllaDB University
    • Community Forum
    • Tutorials
Download
ScyllaDB Docs ScyllaDB Sphinx Theme Upgrade guides Migrating from 1.5 to 1.6

Caution

You're viewing documentation for a previous version of ScyllaDB Sphinx Theme. Switch to the latest stable version.

Migrating from 1.5 to 1.6¶

This guide explains how to upgrade the version of the ScyllaDB Sphinx Theme.

How to check your current theme version¶

The theme version is displayed in the footer of the project’s documentation site.

../_images/version.png

If your project theme’s version is >=1.5, follow this guide to get the latest version.

Upgrade to version 1.6¶

Here are the main breaking changes between the 1.5 and 1.6 versions.

  1. 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"
    
  2. Open docs/Makefile file and remove the following lines:

    # Windows variables
    ifeq ($(OS),Windows_NT)
        POETRY = $(APPDATA)\Python\Scripts\poetry
    endif
    

    Note

    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.

  3. Build the docs locally:

    cd docs
    make preview
    
  4. Review and address any warnings that may arise in the terminal during the build process.

Was this page helpful?

PREVIOUS
Upgrade guides
NEXT
Migrating from 1.4 to 1.5
  • Create an issue
  • Edit this page

On this page

  • Migrating from 1.5 to 1.6
    • How to check your current theme version
    • Upgrade to version 1.6
ScyllaDB Sphinx Theme
  • 1.6
    • 1.8
    • 1.7
    • 1.6
    • 1.5
    • 1.4
    • 1.3
    • 1.2
    • 1.1
  • Getting started
    • Toolchain
    • Installation
    • Quickstart
  • Configuration
    • Template options
    • Page options
    • Multiversion options
    • Markdown support
    • Redirects support
    • Search support
  • Commands
  • Deployment
    • Production deployment
    • Pull requests previews
  • Examples
    • Admonitions
    • Collapse
    • Code blocks
    • Glossary
    • Headings
    • Hero box
    • Includes
    • Images
    • Labels
    • Links
    • Lists
    • Panel box
    • Substitutions
    • Tables
    • Tabs
    • Text
    • TOC
    • Topic box
    • Versions
  • Upgrade guides
    • Migrating from 1.5 to 1.6
    • Migrating from 1.4 to 1.5
    • Migrating from 1.3 to 1.4
    • Migrating from 1.2 to 1.3
    • Migrating from 1.1 to 1.2
    • Migrating from 1.0 to 1.1
    • Migrating from 0.x to 1.0
    • Changelog
  • Contribute
    • Contribute to the documentation
    • Contribute to the theme
    • Source Code
Docs Tutorials University Contact Us About Us
© 2025 ScyllaDB | Terms of Service | Privacy Policy | ScyllaDB, and ScyllaDB Cloud, are registered trademarks of ScyllaDB, Inc.
Last updated on 01 Apr 2025.
Powered by Sphinx 7.4.7 & ScyllaDB Theme 1.8.6
Ask AI