From 627b4a4fd3f30753d03ec0affe76b2d965e8e1c3 Mon Sep 17 00:00:00 2001 From: Josh Date: Wed, 17 Sep 2025 10:59:59 -0400 Subject: [PATCH 1/2] fix: Disable unnecessary RST source inclusion in HTML builds Disable inclusion of RST sources in HTML builds. This would normally be used if we we had the links for readers to view the RST source code. We don't and there's no point in doing so. - Already the case for the User Manual, but not the others; this makes it global across all manuals - No need to include RST source since we're not linking to it (i.e. we're not using `html_show_sourcelink` anywhere). Signed-off-by: Josh --- conf.py | 3 +++ 1 file changed, 3 insertions(+) diff --git a/conf.py b/conf.py index 921c68628..5b3343a9e 100644 --- a/conf.py +++ b/conf.py @@ -41,6 +41,9 @@ html_theme_options = { # relative path to subdirectories html_logo = "../_shared_assets/static/logo-white.png" +# disable including the reST sources in HTML builds (in _sources/) (default is True) +html_copy_source = False + # substitutions go here rst_epilog = '.. |version| replace:: %s' % version From 537c255a5114633a8c023322dc33bd1144ff2a0b Mon Sep 17 00:00:00 2001 From: Josh Date: Wed, 17 Sep 2025 11:01:58 -0400 Subject: [PATCH 2/2] chore: Remove html_copy_source option from user conf.py Removed option to disable including RST sources in HTML build at the User Manual config level, since we can do it at the global conf level for all manuals. Signed-off-by: Josh --- user_manual/conf.py | 3 --- 1 file changed, 3 deletions(-) diff --git a/user_manual/conf.py b/user_manual/conf.py index fb397678a..405381938 100644 --- a/user_manual/conf.py +++ b/user_manual/conf.py @@ -74,9 +74,6 @@ html_show_sphinx = False # 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 - # -- Options for HTML help output -------------------------------------------- # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-help-output