With ScyllaDB Sphinx Theme, you can define 301 redirects when moving or deleting a document.
By doing so, you will avoid broken links in other sites pointing to your documentation.
The redirects.yaml file is inside docs/_utils.
The redirects file has this structure:
# old_path: new_path
# redirection to internal link
/previous_path/page_a.html:/new_path/page_a.html
# 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 redirects.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.html:/new_path/page_a.htmlOr, to redirect to an external URL:
/previous_path/page_b.html:https://docs.scylladb.com/