Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Show source of translated content #13301

Open
StanFromIreland opened this issue Feb 5, 2025 · 1 comment
Open

Show source of translated content #13301

StanFromIreland opened this issue Feb 5, 2025 · 1 comment
Labels
type:proposal a feature suggestion

Comments

@StanFromIreland
Copy link

From a discussion in python-docs-pl

Suggestion by m-aciek

I envision this as a second link next to "Show source" titled "Show translation source".

Suggestion by rffrontelle

The best would be to show a translated reST file combining both documents, but last time I checked, this is not possible.

Suggestion by StanFromIreland

Would it be better to redirect to translation .po files [when a user in a /lang/ click on "Show Source"]?

@m-aciek
Copy link
Contributor

m-aciek commented Feb 7, 2025

Current “Show source” with a link to GitHub in CPython docs is a customisation. Following this pattern “Show translation source” could also be a customisation.

Default Sphinx behaviour for the “Show source” is displaying a copy of the source document (see Page source at the bottom of Alabaster's docs).

For what it's worth the config toggles for “Show source” are html_copy_source and html_show_sourcelink.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
type:proposal a feature suggestion
Projects
None yet
Development

No branches or pull requests

2 participants