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

Đang mở Phù hợp với người mới
  • Có gì không ổn?
#417 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
72/100
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
python
Lĩnh vực
internationalization, localization

Hướng nghiên cứu

Bắt đầu bằng cách kiểm tra các mục riêng theo từng nhánh trong .tx/config và các đường dẫn Doc/locales được liệt kê cho bản dịch 3.13, 3.14 và 3.15. Xóa các tệp library/*.po lỗi thời được chỉ định cùng các phần tài nguyên tương ứng, sau đó xác minh rằng mỗi nhánh vẫn giữ các tài nguyên builtins/*.po tương ứng và không còn tham chiếu đến các tài nguyên Transifex cũ.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

现象

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

Ngôn ngữ chính
Không có dữ liệu ngôn ngữ
Star
469
Fork
106
Không có pull request nào được merge trong 30 ngày

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của python/python-docs-zh-cn

Tất cả issue của python/python-docs-zh-cn

Issue tương tự

Thêm issue về Internationalization

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.