Was this page helpful?
Caution
You're viewing documentation for a previous version of ScyllaDB Sphinx Theme. Switch to the latest stable version.
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.
The redirections.yaml file is inside docs/_utils.
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.
To create a redirection:
Create a file redirections.yaml in docs/_utils if it does not exist.
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_aOr, to redirect to an external URL:
/previous_path/page_b:https://docs.scylladb.com/
Was this page helpful?