builtins 拆册后 library/ 下 5 个旧 .po 未清理（Transifex 侧已改名，只剩仓库残留）

Ouverte Adaptée aux débutants
  • Quelque chose ne va pas ?
#417 1 commentaire 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

Difficulté
2/5
Temps estimé
1-3 heures
Accessibilité débutants
72/100
Type d'issue
Bug
Clarté
Clairement spécifiée
Activité
Active
Stack technique
python
Domaine
internationalization, localization

Piste de recherche

Commence par vérifier les entrées propres à chaque branche dans .tx/config et les chemins indiqués de Doc/locales pour les traductions de 3.13, 3.14 et 3.15. Supprime les fichiers obsolètes library/*.po spécifiés ainsi que leurs sections de ressources correspondantes, puis vérifie que chaque branche conserve les ressources builtins/*.po correspondantes et ne référence plus les anciennes ressources Transifex.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

现象

cpython 在 2026-09-13 把「内置函数 / 类型 / 异常」从 Doc/library/ 拆到 Doc/builtins/（python/cpython#156682，已 backport 到 3.13–3.15）。本仓库在 2026-10-22 的 [po] auto sync（3c0b4ea）里新增了 builtins/*.po，但旧文件没有移除，于是同一份内容在两个路径下并存：

分支 旧路径残留 builtins/ 新增
3.15 library/{functions,stdtypes,exceptions,constants,threadsafety}.po 7 个
3.14 同上 5 个 7 个
3.13 library/{exceptions,constants}.po 5 个

上游对应页面确实已删除：docs.python.org/3.14/library/functions.html、/3.14/library/threadsafety.html、/3.13/library/exceptions.html、/3.13/library/constants.html 全部 301 到 builtins/；Doc/library/functions.rst 等文件在 cpython 3.13–3.15 分支上也已不存在。也就是说这些 .po 已经无源文件可对照，属于孤儿资源。

Transifex 侧的实际状态（2026-11-05 核对）

按组织 python-doc 的每个版本项目逐个搜索资源：

项目 资源数 builtins--* library--functions
python-newest（3.15） 554 7 个，数据源最新 2026-11-03 找不到
python-313 515 exceptions / constants / index / stdtypes 等，2026-09-13 找不到
python-314 540 constants / index / time-complexity / threadsafety 等 找不到

library--stdtypes、library--exceptions、library--threadsafety 在 python-newest 里同样查不到。也就是说资源是改名（library--X → builtins--X）而不是复制，译文跟着资源走了：builtins--exceptions 的 Chinese (China) 显示 97.09% 已翻译。

因此：旧资源在 Transifex 上已经不存在，tx pull 不会再把 library/*.po 写回来。这些文件只是 2026-10-22 那次同步留下的仓库残留。

影响

  1. 仓库里保留 5 份（3.13 是 2 份）以后不会再被读取的译文；
  2. .tx/config 里 5 条（3.13 为 2 条）r:library--* 条目指向已不存在的资源，tx pull 走到它们会报错或被忽略；
  3. 下游按 Doc/locales 路径匹配 Doc/*.rst 的构建脚本会忽略这些文件，但排错时容易被误导成「译文丢了」。

建议（纯仓库改动，不需要 Transifex 权限）

  • 删除 library/{functions,stdtypes,exceptions,constants,threadsafety}.po（3.15、3.14 各 5 个；3.13 为 exceptions、constants 2 个）；
  • 删除 .tx/config 中对应的 [o:python-doc:p:…:r:library--*] 段；
  • 顺带一提：这些新资源的 zh_CN 均为 0% 已复核（整个项目亦然），95% 只是「已翻译」。

（发现方式：在下游用 Doc/locales 构建分册 PDF 时，把 .po 路径与 Doc/*.rst 逐一对照发现的。）

Langage dominant
Aucune donnée de langage
Étoiles
469
Forks
106
Aucune PR mergée en 30 j

Préparer son environnement

Ce projet ne fournit ni conteneur de développement, ni Dockerfile, ni guide de contribution : l'installation est à votre charge. Commencez par son README, et consultez notre guide de la première contribution pour les étapes générales.

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de python/python-docs-zh-cn

Toutes les issues de python/python-docs-zh-cn

Issues similaires

Plus d'issues Internationalization

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.