From aeaefee94d7ec24f685aea4f3f157da3dc93358f Mon Sep 17 00:00:00 2001 From: Andy McKay <74699+andymckay@users.noreply.github.com> Date: Mon, 20 Jul 2026 09:36:07 -0700 Subject: [PATCH 1/6] Update settings documentation with note on list pagesing Added note about preventing list page generation. --- docs/settings.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/settings.rst b/docs/settings.rst index 3fac5f18..13ef0543 100644 --- a/docs/settings.rst +++ b/docs/settings.rst @@ -687,6 +687,10 @@ template. The location to save the list of all articles. The default is ``"index.html"``. +Note + +If you do not want one or more of the list pages to be created (e.g., you are the only author on your site and thus do not need a listing of Authors), set the corresponding *_SAVE_AS setting to "" to prevent the relevant page from being generated. + URLs for direct template pages are theme-dependent. Some themes use corresponding ``*_URL`` setting as string, while others hard-code them: ``"archives.html"``, ``"authors.html"``, ``"categories.html"``, From 9e6977280cf2303c1a99db3e46944d8fe1d47c58 Mon Sep 17 00:00:00 2001 From: Andy McKay <74699+andymckay@users.noreply.github.com> Date: Mon, 20 Jul 2026 09:42:52 -0700 Subject: [PATCH 2/6] Update RELEASE.md for documentation clarity Minor documentation improvement to clarify how to prevent listing pages from being generated. --- RELEASE.md | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 RELEASE.md diff --git a/RELEASE.md b/RELEASE.md new file mode 100644 index 00000000..1d9f9044 --- /dev/null +++ b/RELEASE.md @@ -0,0 +1,3 @@ +Release type: patch + +- Minor documentation improvement to clarify how to prevent listing pages from being generated. From b5ca232dc57deda848341c9402004da598d10ff2 Mon Sep 17 00:00:00 2001 From: Andy McKay <74699+andymckay@users.noreply.github.com> Date: Mon, 20 Jul 2026 09:49:13 -0700 Subject: [PATCH 3/6] Improve note formatting in settings.rst --- docs/settings.rst | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/settings.rst b/docs/settings.rst index 13ef0543..0354ed31 100644 --- a/docs/settings.rst +++ b/docs/settings.rst @@ -687,9 +687,12 @@ template. The location to save the list of all articles. The default is ``"index.html"``. -Note +.. note:: -If you do not want one or more of the list pages to be created (e.g., you are the only author on your site and thus do not need a listing of Authors), set the corresponding *_SAVE_AS setting to "" to prevent the relevant page from being generated. + If you do not want one or more of the list pages to be created (e.g., + you are the only author on your site and thus do not need a listing of + Authors), set the corresponding *_SAVE_AS setting to "" to prevent the + relevant page from being generated. URLs for direct template pages are theme-dependent. Some themes use corresponding ``*_URL`` setting as string, while others hard-code them: From 0ff20e8652679e05742cc4ad5c2f4b6fb1e327cd Mon Sep 17 00:00:00 2001 From: Andy McKay <74699+andymckay@users.noreply.github.com> Date: Sun, 26 Jul 2026 12:41:18 -0700 Subject: [PATCH 4/6] Update note a little after looking at the screenshot --- docs/settings.rst | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/docs/settings.rst b/docs/settings.rst index 0354ed31..d8308631 100644 --- a/docs/settings.rst +++ b/docs/settings.rst @@ -683,17 +683,18 @@ template. The location to save the tag list. The default is ``"tags.html"``. -.. data:: INDEX_SAVE_AS - - The location to save the list of all articles. The default is ``"index.html"``. - .. note:: If you do not want one or more of the list pages to be created (e.g., you are the only author on your site and thus do not need a listing of - Authors), set the corresponding *_SAVE_AS setting to "" to prevent the + Authors), set the corresponding `*S_SAVE_AS` setting to `""` to prevent the relevant page from being generated. +.. data:: INDEX_SAVE_AS + + The location to save the list of all articles. The default is ``"index.html"``. + + URLs for direct template pages are theme-dependent. Some themes use corresponding ``*_URL`` setting as string, while others hard-code them: ``"archives.html"``, ``"authors.html"``, ``"categories.html"``, From d15ade408fa4dbd228073651d7e894061f97a771 Mon Sep 17 00:00:00 2001 From: Andy McKay <74699+andymckay@users.noreply.github.com> Date: Sun, 26 Jul 2026 12:41:42 -0700 Subject: [PATCH 5/6] Remove extra newline in settings documentation --- docs/settings.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/settings.rst b/docs/settings.rst index d8308631..33c1b0ac 100644 --- a/docs/settings.rst +++ b/docs/settings.rst @@ -694,7 +694,6 @@ template. The location to save the list of all articles. The default is ``"index.html"``. - URLs for direct template pages are theme-dependent. Some themes use corresponding ``*_URL`` setting as string, while others hard-code them: ``"archives.html"``, ``"authors.html"``, ``"categories.html"``, From 5471134d9e97993c12142b7b5b970f654b275d31 Mon Sep 17 00:00:00 2001 From: Andy McKay <74699+andymckay@users.noreply.github.com> Date: Sun, 26 Jul 2026 12:44:55 -0700 Subject: [PATCH 6/6] Fix formatting of code block in settings.rst --- docs/settings.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/settings.rst b/docs/settings.rst index 33c1b0ac..7ba22e3d 100644 --- a/docs/settings.rst +++ b/docs/settings.rst @@ -687,7 +687,7 @@ template. If you do not want one or more of the list pages to be created (e.g., you are the only author on your site and thus do not need a listing of - Authors), set the corresponding `*S_SAVE_AS` setting to `""` to prevent the + Authors), set the corresponding ``*S_SAVE_AS`` setting to ``""`` to prevent the relevant page from being generated. .. data:: INDEX_SAVE_AS