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 Redirections support

Caution

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

Redirections support¶

With Scylla Sphinx Theme, you can define 301 redirections when moving or deleting a document.

By doing so, you will avoid broken links in other sites pointing to your documentation.

Note

When multi version is enabled, the extension only creates redirections for the latest version of the documentation.

Redirections file¶

The redirections.yaml file is inside docs/_utils.

File structure¶

The redirections file has this structure:

# old_path: new_path

# redirection to internal link
/previous_path/page_a:/new_path/page_a

# redirection to external link
/previous_path/page_b:https://docs.scylladb.com/

Note

Do not add trailing paths / to define old paths.

Create a redirection¶

To create a redirection:

  1. Create a file redirections.yaml in docs/_utils if it does not exist.

  2. Add a new entry to the YAML file, assigning the old path in the left site operator and the new path on the right side.

    For example, to redirect to another internal page:

    /previous_path/page_a:/new_path/page_a
    

    Or, to redirect to an external URL:

    /previous_path/page_b:https://docs.scylladb.com/
    

Was this page helpful?

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

On this page

  • Redirections support
    • Redirections file
    • File structure
    • Create a redirection
ScyllaDB Sphinx Theme
  • 1.2
    • 1.8
    • 1.7
    • 1.6
    • 1.5
    • 1.4
    • 1.3
    • 1.2
    • 1.1
  • Getting started
    • Toolchain
    • Installation
  • Configuration
    • Template options
    • Page options
    • Multiversion options
    • Markdown support
    • Redirections support
    • Search support
    • Troubleshooting
  • Commands
  • Deployment
    • Production deployment
    • Pull requests previews
  • Examples
    • Admonitions
    • Collapse
    • Code blocks
    • Glossary
    • Headings
    • Hero box
    • Includes
    • Images
    • Links
    • Lists
    • Panel box
    • Substitutions
    • Tables
    • Tabs
    • Text
    • TOC
    • Topic box
    • Versions
  • Upgrade guides
    • 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