Closed
Description
These whitespaces in the dummy.html become an issue when it comes to translating them.
- If the translator forgets to add a leading or a trailing space, it mostly results in phrases being concatenated without spaces in the HTML.
- Also linters like
sphinx-lint
complain a lot about these whitespaces. - And some translation file editors (po editors) tend to trim these whitespaces even if the translator did not forget to add them.
Here are some examples from the Turkish translation (scenario of a translator who forgot to add an extra space at the end):
How it looks in the English Doc (no problems):
We could remove the trailing whitespace from "Part of the" and insert a leading whitespace to "Stable ABI", but that would only please the linters. So, I propose removing all the whitespaces (leading and trailing) in the template file and let c_annotations.py to handle the spacing.
These strings about the API and the ABI were made translatable in #107680, which also introduced the whitespaces.
Linked PRs
- gh-113637: Let c_annotations.py to handle the spacing of Limited/Unstable API & Stable ABI translation strings #113638
- [3.12] gh-113637: Let c_annotations.py to handle the spacing of Limited/Unstable API & Stable ABI translation strings (GH-113638) #113676
- [3.11] gh-113637: Let c_annotations.py to handle the spacing of Limited/Unstable API & Stable ABI translation strings (#113638) #113679