gh-139181: Allow translation of html_short_title in docs config

[Aniketsy]

#139181
This PR wraps the html_short_title string in conf.py with the Sphinx translation function _().

Please let me know if my approach or fix needs any improvements . I’m open to feedback and happy to make changes based on suggestions.
Thankyou !

---

📚 Documentation preview 📚: https://cpython-previews--139195.org.readthedocs.build/

[StanFromIreland]

Thank you, however there are several issue:

• The version number, which does not need to be translated, changes quite frequently. Just translating "Documentation" would be much easier, rather than translating every few months. e.g.:

  html_short_title = _('%(release)s Documentation') % {'release': release}
  

• Testing locally I see that the string is not extracted by the gettext builder, it's also not particularly clear what catalogue it's using? I tried putting it into the sphinx domain but that didn't work.
• This also breaks epub builds.
• There are also other strings that can be translated, e.g. "Python Documentation Authors".

[Aniketsy]

Thank you for the feedback! I’ll look into these issues and see if I can fix them. Any guidance you can provide would be greatly appreciated.

[zware]

• The version number, which does not need to be translated, changes quite frequently. Just translating "Documentation" would be much easier, rather than translating every few months.

The trouble with translating just part of the string is that for some languages 3.13.7 Documentation might be better translated as Documentation for 3.13.7 or For 3.13.7, Documentation, etc. Ideally the template would be translated before formatting.

[StanFromIreland]

I was thinking:

html_short_title = _('%(release)s Documentation') % {'release': release}

translators are used to named placeholders.

[hugovk]

The CI is failing with:

WARNING: The config value `epub_author' has type `_TranslationProxy'; expected `str'.
WARNING: The config value `epub_publisher' has type `_TranslationProxy'; expected `str'.

Does Sphinx need an update for this?

[Aniketsy]

I’m not entirely sure about this. I added the changes based on a suggestion, but if they’re not required, I can remove them.
@StanFromIreland Could you please confirm whether these changes are actually needed ?

[StanFromIreland]

You may find people's workarounds (Sphinx provides no native support) here helpful: sphinx-doc/sphinx#1260

[AA-Turner]

This appears to be something that needs fixing in Sphinx first, so I'll close this PR for now.

A