Add 'Show translation source' to docs sidebar

[StanFromIreland]

Discussion sphinx-doc/sphinx#13301

---

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

[m-aciek]

I suggest to change the PR title to make it clear it's about the docs.

[AA-Turner]

I'm -1 on this. .po files are not very friendly for reading by people, and are designed as a translation format mapping source to translated strings. I similarly see little value in 'show source', as the reStructuredText source is so unlikely to be useful (some themes have replaced this with a link to the source on GitHub, but I'm still unconvinced).

A

[hugovk]

I often use "show source" when I want to check, well, the source, for example if there's something amiss.

If there's a translation that's missing or fixing, is the .po file the file that needs editing? If so, this would make it easy to click through and make a quick PR.

[StanFromIreland]

Hugo already mentioned the main point.

Another thing is the current „show source” button is useless in the translations as it is the English source.

This will contributions as it is easy to find where the files are as the repo is not linked anywhere else in the docs!

And also, Adam, you don’t have to worry about seeing it :-)

[m-aciek]

I personally use "Show source" very rarely. But I think "Show translation source" would be as useful as "Show source" is, for translated content.

[StanFromIreland]

Is there anything else left to do here @hugovk ?

[StanFromIreland]

Friendly ping, so that we can get this in.

[hugovk]

Adam is -1, let me check in with him. We're not in a rush to get this in before the beta feature freeze, it can also go in after and be backported.

[m-aciek]

If there's a translation that's missing or fixing, is the .po file the file that needs editing? If so, this would make it easy to click through and make a quick PR.

That question wasn’t answered directly (assuming it wasn’t just rhetorical). Yes, the .po file should be edited in case of a missing or incorrect translation. That’s a good point—using PR-based translation workflows, this should be a convenient change.

[m-aciek]

We could use Plausible custom events to track the usage of the show source link. Though it looks like it would require changes in both theme and the show source customization in the CPython's repo.

[StanFromIreland]

Friendly ping, it would be nice to get this going again @hugovk / @AA-Turner :-)

[willingc]

@StanFromIreland What would the "Show Translation Source" display?

[hugovk]

@StanFromIreland What would the "Show Translation Source" display?

It would show that text, but in the language of the translation you're looking at.

And with a link to the .po file in the relevant translation repo.

[hugovk]

Let's try this.

[miss-islington-app]

Thanks @StanFromIreland for the PR, and @hugovk for merging it 🌮🎉.. I'm working now to backport this PR to: 3.13, 3.14.
🐍🍒⛏🤖

[bedevere-app]

GH-142686 is a backport of this pull request to the 3.14 branch.

[bedevere-app]

GH-142687 is a backport of this pull request to the 3.13 branch.