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 Configuration Troubleshooting

Caution

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

Troubleshooting¶

Installation¶

How to use the toolchain in Windows¶

To run the toolchain on Windows:

  1. Make sure you have Make installed.

    The easiest way to install it is using Chocolatey. First, you need to install this package manager. Then, install Make with the command choco install make.

    Tip

    If you get an error when installing make, try to run the command in a console prompt with elevated permissions.

  2. You must run make commands from a Unix-based terminal such as Git Bash.

Multiversion¶

How to preview latest local changes with multiversion¶

By default, the command builds the documentation that is available on GitHub (remote repository).

To build multiversion docs for the local branches:

  1. In conf.py, set smv_remote_whitelist to None:

smv_remote_whitelist = None
  1. Follow Syncing a Fork for every branch not updated in your fork.

  2. Run make multiversionpreview again.

How to preview locally the documentation published in production¶

  1. Follow these steps to configure a remote that points to the upstream repository in Git.

  2. Download the latest tags and branches from upstream:

git fetch --all
  1. Edit the setting smv_remote_whitelist in the file conf.py to build the docs from upstream as follows:

smv_remote_whitelist = r"^upstream$"
  1. Run the command make multiversionpreview again.

How to fix the error “No matching refs found!”¶

If the console raises the error “No matching refs found!”, most likely your fork is not updated with the upstream repository.

In this case, you can:

  • Build multiversion docs for the upstream repository. See Preview documentation published in production (recommended).

  • Sync the fork with the upstream repository. See Preview latest local changes.

Another frequent mistake that raises the error message is to have typos in the configuration file. Make sure that the version names listed in TAGS and BRANCHES settings from conf.py match the repository’s branch and tags names on Git.

Was this page helpful?

PREVIOUS
Search support
NEXT
Commands
  • Create an issue
  • Edit this page

On this page

  • Troubleshooting
    • Installation
      • How to use the toolchain in Windows
    • Multiversion
      • How to preview latest local changes with multiversion
      • How to preview locally the documentation published in production
      • How to fix the error “No matching refs found!”
ScyllaDB Sphinx Theme
  • 1.5
    • 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
    • Troubleshooting
  • 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.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