Added missed redirects manually and updated comments on conf.py

This commit is contained in:
alwasega
2023-01-31 17:01:38 +03:00
parent da5183a6f8
commit bea35a60df
2 changed files with 33 additions and 3 deletions

View File

@@ -214,10 +214,27 @@ ogp_use_first_image = True
# -- Options for the rediraffe extension -------------------------------------
# ref: https://github.com/wpilibsuite/sphinxext-rediraffe#readme
#
# This extensions help us relocated content without breaking links. If a
# document is moved internally, a redirect like should be configured below to
# This extension helps us relocate content without breaking links. If a
# document is moved internally, a redirect link should be configured as below to
# help us not break links.
#
# The workflow for adding redirects can be as follows:
# 1. Change "rediraffe_branch" below to point to the commit/ branch you
# want to make the changes based off.
# 2. Option 1: run "make rediraffecheckdiff"
# a. Analyze the output of this command
# b. Manually add the redirect entries to the "redirects.txt" file.
# Option 2: run "rediraffewritediff"
# a. rediraffe will then automatically add the obvious redirects to redirects.txt
# b. Analyze the output of the command for broken links.
# c. Check the "redirects.txt" file for any files that were moved/ renamed but are not listed.
# d. Manually add the redirects that havebeen mised by the automatic builder to "redirects.txt"
# Option 3: Do not use the commands above and, instead, do everything manually - by taking
# note of of the files you have moved or renamed and adding them to the "redirects.txt" file.
#
# If you are basing changes off another branch/ commit, always change back
# rediraffe_branch to main before pushing your changes upstream.
#
rediraffe_branch = "main"
rediraffe_redirects = "redirects.txt"
# rediraffe_redirects = {

View File

@@ -6,3 +6,16 @@
"reference/proxy.md" "howto/proxy.md"
"reference/templates.md" "howto/templates.md"
"quickstart-docker.md" "tutorial/installation/quickstart-docker.md"
"reference/config-examples.md" "howto/index.md"
"getting-started/institutional-faq.md" "faq/institutional-faq.md"
"troubleshooting.md" "faq/troubleshooting.md"
"reference/config-sudo.md" "howto/configuration/config-sudo.md"
"reference/config-user-env.md" "howto/configuration/config-user-env.md"
"reference/rest.md" "howto/rest.md"
"reference/separate-proxy.md" "howto/separate-proxy.md"
"admin/upgrading.md" "howto/upgrading.md"
"installation-basics.md" "tutorial/installation/installation-basics.md"
"quickstart.md" "tutorial/installation/quickstart.md"