bazel-contrib / bazel-contrib/rules_python

sphinxdocs: i18n support

Đang mở
#3,848 1 bình luận 0 reaction 0 người được giao Xem trên GitHub
sphinxdocs type: feature request
Ngôn ngữ chính
Starlark
Star
688
Fork
721
Merge trung bình
15 giờ 7 phút
Pull request đã merge (30 ngày)
76

Mô tả

# sphinxdocs: i18n support

### Relevant Rules

`sphinx_docs` in `//sphinxdocs/sphinxdocs/sphinx.bzl`

### Description

`sphinx_docs` should accept a `lang` array of strings and produce docs for each specified language

### Describe the solution you'd like

per https://www.sphinx-doc.org/en/master/usage/advanced/intl.html I think it would have to run `sphinx-build gettext`, save the `.po` files somewhere within the repo (pretty sure that these are checked into the VCS), and then run `sphinx-build -Dlanguage=` for every specified lang

### Describe alternatives you've considered

`sphinx-intl` seems to be the common extension for i18n workflows but it doesn't seem strictly required https://www.sphinx-doc.org/en/master/usage/advanced/intl.html#translating-with-sphinx-intl

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Hướng nghiên cứu

Bắt đầu bằng cách đọc rule `sphinx_docs` trong `//sphinxdocs/sphinxdocs/sphinx.bzl` và workflow quốc tế hóa Sphinx được liên kết. Công việc được coi là hoàn thành khi rule chấp nhận một mảng `lang`, tạo các tệp bản dịch khi cần và tạo tài liệu cho mọi ngôn ngữ được chỉ định.

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

Đánh giá

Lĩnh vực
build-system, documentation
Loại issue
Tính năng
Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức độ hoạt động
Ít trao đổi
Độ rõ ràng
Khá rõ ràng
Mức phù hợp với người mới
48/100

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.