From 4def5a71b4367d32ebfea6c498832d8e24a5fb06 Mon Sep 17 00:00:00 2001 From: Josh Date: Wed, 10 Sep 2025 10:45:22 -0400 Subject: [PATCH 1/3] chore(admin): add canonical link to `stable` branch Signed-off-by: Josh --- admin_manual/conf.py | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/admin_manual/conf.py b/admin_manual/conf.py index 6f4e59a30..cb8ee9129 100644 --- a/admin_manual/conf.py +++ b/admin_manual/conf.py @@ -56,6 +56,12 @@ html_short_title = "Server Admin Manual" # disable "Created using Sphinx" in the HTML footer (default is True) html_show_sphinx = False +# Add canonical link in all generated pages linking to their respective equivalent +# in `stable` (regardless of which version of the docs someone lands in). +# Note, there is an argument to be made for having this link to `latest` instead, +# but this is likely good enough and the most conservative for now. +html_baseurl = "https://docs.nextcloud.com/server/stable/admin_manual/" + # -- Options for HTML help output -------------------------------------------- # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-help-output From 610f02ff44cdba43a03ee61662a25c13cb767566 Mon Sep 17 00:00:00 2001 From: Josh Date: Wed, 10 Sep 2025 10:49:40 -0400 Subject: [PATCH 2/3] chore(developer): add canonical link to `stable` branch Add canonical link to stable version of developer manual Signed-off-by: Josh --- developer_manual/conf.py | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/developer_manual/conf.py b/developer_manual/conf.py index 3ad871a30..2fd09d257 100644 --- a/developer_manual/conf.py +++ b/developer_manual/conf.py @@ -63,6 +63,12 @@ html_short_title = "Developer Manual" # disable "Created using Sphinx" in the HTML footer (default is True) html_show_sphinx = False +# Add canonical link in all generated pages linking to their respective equivalent +# in `stable` (regardless of which version of the docs someone lands in). +# Note, there is an argument to be made for having this link to `latest` instead, +# but this is likely good enough and the most conservative for now. +html_baseurl = "https://docs.nextcloud.com/server/stable/developer_manual/" + html_last_updated_fmt = "%b %d, %Y" # -- Options for HTML help output -------------------------------------------- From 753fbb66caa4a2da5af417f885cce28d5ab54867 Mon Sep 17 00:00:00 2001 From: Josh Date: Wed, 10 Sep 2025 10:50:46 -0400 Subject: [PATCH 3/3] chore(user): add canonical link to `stable` branch Add canonical link for stable version in documentation. Signed-off-by: Josh --- user_manual/conf.py | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/user_manual/conf.py b/user_manual/conf.py index aafb8687c..fb397678a 100644 --- a/user_manual/conf.py +++ b/user_manual/conf.py @@ -67,6 +67,13 @@ html_static_path = ['../_shared_assets/static'] html_short_title = "User Manual" # disable "Created using Sphinx" in the HTML footer (default is True) html_show_sphinx = False + +# Add canonical link in all generated pages linking to their respective equivalent +# in `stable` (regardless of which version of the docs someone lands in). +# Note, there is an argument to be made for having this link to `latest` instead, +# but this is likely good enough and the most conservative for now. +html_baseurl = "https://docs.nextcloud.com/server/stable/user_manual/" + # disable including the reST sources in the HTML build as _sources/name (default is True) html_copy_source = False