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

Aberta Para iniciantes
  • Algo errado?
#417 1 comentário 0 reações 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
2/5
Tempo estimado
1-3 horas
Facilidade para iniciantes
72/100
Tipo de issue
Bug
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
python
Domínio
internationalization, localization

Direção de pesquisa

Comece verificando as entradas específicas de cada branch em .tx/config e os caminhos listados em Doc/locales para as traduções 3.13, 3.14 e 3.15. Remova os arquivos obsoletos library/*.po especificados e as seções de recursos correspondentes; em seguida, verifique se cada branch mantém os recursos builtins/*.po correspondentes e não faz mais referência aos recursos antigos do Transifex.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

现象

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 逐一对照发现的。）

Linguagem predominante
Sem dados de linguagem
Estrelas
469
Forks
106
Nenhum PR com merge em 30d

Preparar o ambiente

Este projeto não oferece contêiner de desenvolvimento, Dockerfile nem guia de contribuição, então a configuração fica por sua conta: comece pelo README e veja nosso guia da primeira contribuição para os passos gerais.

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de python/python-docs-zh-cn

Todas as issues de python/python-docs-zh-cn

Issues semelhantes

Mais issues de Internationalization

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.