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

Abierto Apto para principiantes
  • ¿Algo no está bien?
#417 1 comentario 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
72/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
python
Área
internationalization, localization

Línea de trabajo

Empieza revisando las entradas específicas de cada rama en .tx/config y las rutas indicadas de Doc/locales para las traducciones de 3.13, 3.14 y 3.15. Elimina los archivos obsoletos library/*.po especificados y sus secciones de recursos correspondientes; después, verifica que cada rama conserve los recursos builtins/*.po correspondientes y que ya no haga referencia a los recursos antiguos de Transifex.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

现象

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

Lenguaje dominante
Sin datos de lenguaje
Estrellas
469
Forks
106
Sin PR fusionados en 30 d

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de python/python-docs-zh-cn

Todos los issues de python/python-docs-zh-cn

Issues similares

Más issues de Internationalization

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.