Issue URL on translated Python docs site is always pointed to English version · Issue #235 · python/python-docs-theme · GitHub

BPO	38427
Nosy	@JulienPalard, @zhsj, @tirkarthi

Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.

Show more details

GitHub fields:

assignee = None
closed_at = None
created_at = <Date 2019-10-10.06:00:23.007>
labels = ['3.8', 'docs']
title = 'Issue URL on translated Python docs site is always pointed to English version'
updated_at = <Date 2019-10-10.07:18:07.283>
user = 'https://github.com/zhsj'

bugs.python.org fields:

activity = <Date 2019-10-10.07:18:07.283>
actor = 'zhsj'
assignee = 'docs@python'
closed = False
closed_date = None
closer = None
components = ['Documentation']
creation = <Date 2019-10-10.06:00:23.007>
creator = 'zhsj'
dependencies = []
files = []
hgrepos = []
issue_num = 38427
keywords = []
message_count = 3.0
messages = ['354314', '354316', '354317']
nosy_count = 4.0
nosy_names = ['docs@python', 'mdk', 'zhsj', 'xtreak']
pr_nums = []
priority = 'normal'
resolution = None
stage = None
status = 'open'
superseder = None
type = None
url = 'https://bugs.python.org/issue38427'
versions = ['Python 3.8']

On footer of https://docs.python.org/fr/3.8, "Found a bug?" links to https://docs.python.org/3/bugs.html

It should be https://docs.python.org/fr/3.8/bugs.html as 3.7 version.

There are occasional reports of typo in translations that are opened in bugs.python.org and it would make sense to redirect to respective GitHub repos for the translations.

On https://docs.python.org/zh-cn/3/bugs.html we emphasis that translation bugs should be reported at GitHub. So that's why I want the footer link same as previous (link to translated bugs.html).

This needs to be moved to python-docs-theme. Localization is ongoing there. cc @rffontenelle

This is still reproducible in the current Python 3.14 documentation.

On https://docs.python.org/fr/3.14/, the footer link Un bogue ? has href="/bugs.html". It therefore leaves the translated documentation and redirects to the English page at https://docs.python.org/3/bugs.html. The expected target is https://docs.python.org/fr/3.14/bugs.html, preserving both the current language and version.

The source of the absolute link spans two repositories:

CPython configures issues_url as "/bugs.html".
The theme writes theme_issues_url directly to href.

For comparison, the Report a bug link in the page sidebar already stays within the translated documentation because CPython renders it with pathto("bugs").

A fix will likely need coordinated changes so the local bugs target is resolved relative to the current page (for example through Sphinx pathto), while preserving support for an external URL configured by other theme users.

Issue URL on translated Python docs site is always pointed to English version · Issue #235 · python/python-docs-theme · GitHub

Repository navigation

Issue URL on translated Python docs site is always pointed to English version #235

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue URL on translated Python docs site is always pointed to English version · Issue #235 · python/python-docs-theme · GitHub

Repository navigation

Issue URL on translated Python docs site is always pointed to English version #235

Description

Activity

zhsj commented on Oct 10, 2019

tirkarthi commented on Oct 10, 2019

zhsj commented on Oct 10, 2019

StanFromIreland commented on Apr 19, 2025

m-aciek commented on Aug 24, 2026

Metadata

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue actions