Several "inconsistent references in translated message" when building translated docs

[Rafael Fontenelle]

Hi all,

I translate Sphinx docs to Brazilian Portuguese (pt_BR), and when building the pt_BR translation, I came across several warnings which I was unable to figure out why. It doesn't seem to be a translation error, though.

For instance, the build warning:

changes/6.0.rst:45: WARNING: inconsistent references in translated message. original: ['`the Sphinx repository`_'], translated: ['`repositório Sphinx`_'] [i18n.inconsistent_references]

and the translation file has:

#: ../../sphinx/doc/changes/6.0.rst:45
msgid ""
"The second option is to manually ensure that the frameworks are present. To "
"re-add jQuery and underscore.js, you will need to copy ``jquery.js`` and "
"``underscore.js`` from `the Sphinx repository`_ to your ``static`` "
"directory, and add the following to your ``layout.html``:"
msgstr ""
"A segunda opção é garantir manualmente que os frameworks estejam presentes. "
"Para adicionar novamente jQuery e underscore.js, você precisará copiar "
"``jquery.js`` e ``underscore.js`` do `repositório Sphinx`_ para seu "
"diretório ``static`` e adicionar o seguinte ao seu ``layout.html``:"

The source text is:

  The second option is to manually ensure that the frameworks are present.
  To re-add jQuery and underscore.js, you will need to copy ``jquery.js`` and
  ``underscore.js`` from `the Sphinx repository`_ to your ``static`` directory,
  and add the following to your ``layout.html``:

  .. _the Sphinx repository: https://github.com/sphinx-doc/sphinx/tree/v5.3.0/sphinx/themes/basic/static

Much more warnings at https://github.com/sphinx-doc/sphinx-doc-translations/actions/runs/19833972462/job/56826678192

Any idea what is causing this?

Thanks in advance

Best regards,

Rafael Fontenelle