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 Commands

Commands¶

Use the command-line interface to run the following commands.

Note

Make sure you meet the necessary prerequisites before running these commands. For details, see Prerequisites.

Setup commands¶

setupenv¶

Installs system dependencies required to build the docs, such as Poetry.

make setupenv

setup¶

Installs the required Python dependencies to build the documentation.

make setup

Note

make setup is called automatically before running build commands.

update¶

Updates Python dependencies to the latest version.

make update

As a result, updates the poetry.lock file.

Build commands¶

preview¶

Builds a local instance of the docs site so you can view the rendering in a sandbox environment on your local browser.

To preview the docs:

  1. Build the docs.

    cd docs
    make preview
    
  2. Open http://127.0.0.1:5500/ with your preferred browser.

Tip

You can pass custom options to increase or decrease verbosity. For a list with all the available options, refer to the Sphinx documentation.

To increase verbosity, use the option -v:

make preview SPHINXOPTS=-v

To decrease verbosity, use the option -Q:

make preview SPHINXOPTS=-Q

Troubleshooting¶

Issue: pyproject.toml changed significantly since poetry.lock was last generated¶

Solution:

  1. Run the following command:

    poetry lock --no-update
    
  2. Run the make preview command again.

Issue: Keyring asks for a password¶

This issue is due to a known problem with Poetry that primarily affects GNOME users. For more details, see poetry/poetry#8761.

Solution:

  1. Edit docs/Makefile to add the POETRY variable as follows:

    POETRY = PYTHON_KEYRING_BACKEND=keyring.backends.null.Keyring poetry
    
  2. Run the make preview command again.

multiversionpreview¶

Generates a local instance of the docs site with all specified versions available for navigation. You can view the rendering in a sandbox environment on your local browser.

To preview multiple versions:

  1. Build the docs.

    cd docs
    make multiversionpreview
    
  2. Open http://0.0.0.0:5500/ with your preferred browser.

For further guidance on using the multiversionpreview command, see Multiversion configuration.

dirhtml¶

Generates the documentation in HTML format.

Note

The command make dirhtml is aimed to be used by GitHub Actions CI. While documenting new features, it is not advised to run make dirhtml, but make preview instead.

cd docs
make multiversion

Docs are generated under the docs/_build/dirhtml directory.

multiversion¶

Generates multiple versions of the docs with all specified versions available for navigation.

Note

The command make multiversion is aimed to be used by GitHub Actions CI. While documenting new features, it is not advised to run make multiversion, but make preview instead.

cd docs
make multiversion

Docs are generated under the docs/_build/dirhtml directory.

redirects¶

Generates HTML redirects from the _utils/redirects.yaml file.

Note

The command make multiversion is aimed to be used by GitHub Actions CI.

cd docs
make multiversion

Redirects are generated under the docs/_build/dirhtml directory.

Clean commands¶

clean¶

Before making changes to the docs, it’s helpful to clear the previous build by deleting the contents of the build directory. This ensures that the changes you make are reflected correctly.

cd docs
make clean

Test commands¶

linkcheck¶

Checks the documentation site for broken links.

cd docs
make dirhtml
make linkcheck

Was this page helpful?

PREVIOUS
Dependabot support
NEXT
Deployment
  • Create an issue
  • Edit this page

On this page

  • Commands
    • Setup commands
      • setupenv
      • setup
      • update
    • Build commands
      • preview
        • Troubleshooting
          • Issue: pyproject.toml changed significantly since poetry.lock was last generated
          • Issue: Keyring asks for a password
      • multiversionpreview
      • dirhtml
      • multiversion
      • redirects
    • Clean commands
      • clean
    • Test commands
      • linkcheck
ScyllaDB Sphinx Theme
  • 1.8
    • 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
    • AI chatbot support (beta)
    • Search support
    • Dependabot support
  • Commands
  • Deployment
    • Production deployment
    • Pull requests previews
    • Centralized publication
  • Examples
    • Admonitions
    • Alert
    • Collapse
    • Code blocks
    • Diagrams
    • Glossary
    • Headings
    • Hero box
    • Icons
    • Images
    • Includes
    • Labels
    • Links
    • Lists
    • Mascots
    • Panel box
    • Substitutions
    • Tables
    • Tabs
    • Text
    • TOC
    • Tooltips
    • Topic box
    • Versions
  • Upgrade guides
    • Upgrading from 1.7 to 1.8
    • Upgrading from 1.6 to 1.7
    • Upgrading from 1.5 to 1.6
    • Upgrading from 1.4 to 1.5
    • Upgrading from 1.3 to 1.4
    • Upgrading from 1.2 to 1.3
    • Upgrading from 1.1 to 1.2
    • Upgrading from 1.0 to 1.1
    • Upgrading 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