Clarify documentation for *S_SAVE_AS vs *_SAVE_AS

[andymckay]

When generating a simple static site, I wanted to not have the listings page, such as authors.html not be generated. I read through the docs and noted that AUTHOR_SAVE_AS would not generate an Authors page, but I couldn't stop authors.html from being generated. I didn't spot the difference between AUTHOR_SAVE_AS="" and AUTHORS_SAVE_AS="".

AUTHORS_SAVE_AS="" is needed to stop the authors.html page from being generated. I couldn't spot a matching note in the docs about this, so this added in note hopefully clarifies it a bit.

[minchinweb]

I'm not sure I understand from your note what you are trying to clarify here. Personally, I like code samples I can copy; consider adding/replacing/extending your notes with some of what you're written here, perhaps like:

If you want to do <generate a single author page, but not the all author listing page>, set your settings thus:

# pelicanconf.py

AUTHORS_SAVE_AS = ""
AUTHOR_SAVE_AS = "authors.html"

This assumes you have a single author, and will break (because Pelican will try and overwrite the page) if you have multiple authors.

Adjust to taste and fix my code if I got it wrong...

[andymckay]

I was trying to duplicate the note underneath the *_SAVE_AS settings. Which already exists in the docs, you can see that here 👇🏾

https://pelican--3612.org.readthedocs.build/en/3612/settings.html

So this new note is kinda similar 👇🏾

I'm not sure a note that combines multiple settings as an example makes sense. I'm a little confused about would break though? I would have to try and test what you might be talking about if you have those settings.