Message408889
The following string can be found in What's New in Python 3.10 source file (Doc/whatsnew/3.10.rst):
> For major changes, see `New Features Related to Type Hints`_.
where "`New Features Related to Type Hints`_" is a link to a section in the very same page with this name.
The issue with this link text is that translators should translate it (in python-doc organization in Transifex) but warning as errors will pop up if translated. For example, in Portuguese:
> Para mais alterações, veja `Novos recrusos relacionados a dicas de tipo`_
or to
> Para mais alterações, veja `Novos recrusos relacionados a dicas de tipo <New Features Related to Type Hints>`_
Sphinx would complain with:
Doc/whatsnew/3.10.rst:1432: WARNING: inconsistent references in translated message. original: ['`New Features Related to Type Hints`_'], translated: []
To solve this issue, I see two solutions:
1- Create an anchor for "New Features Related to Type Hints" section in this page (let's say, "new-feat-related-type-hints") and then call it like :ref:`new-feat-related-type-hints` so that it gets the section title name automatically. Translators won't need to edit it in order to get translated title name. (recommended)
2- Rewrite the source string adding the internal link to the paragraph using `New Features Related to Type Hints <#new-features-related-to-type-hints>`_, so that it can be translated without popping up the warning message. |
|
Date |
User |
Action |
Args |
2021-12-19 10:22:01 | rffontenelle | set | recipients:
+ rffontenelle, docs@python |
2021-12-19 10:22:01 | rffontenelle | set | messageid: <1639909321.54.0.519282001136.issue46130@roundup.psfhosted.org> |
2021-12-19 10:22:01 | rffontenelle | link | issue46130 messages |
2021-12-19 10:22:01 | rffontenelle | create | |
|