With Scylla 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.
redirects.yaml file is inside
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/
Do not add trailing paths
/ to define old paths.
To create a redirection:
Create a file
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.html
Or, to redirect to an external URL:/previous_path/page_b.html:https://docs.scylladb.com/