bazel-contrib / bazel-contrib/rules_python
sphinxdocs: i18n support
- 主要言語
- Starlark
- スター
- 688
- フォーク
- 721
- 平均マージ
- 15時間 7分
- マージ済み PR(30日)
- 76
説明
# 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
コントリビューションガイド
調査の方向性
まず、`//sphinxdocs/sphinxdocs/sphinx.bzl` の `sphinx_docs` ルールと、リンクされている Sphinx の国際化ワークフローを読んでください。ルールが `lang` 配列を受け入れ、必要に応じて翻訳ファイルを生成し、指定されたすべての言語のドキュメントを生成できれば完了です。
索引モデルが issue の本文から書いたものです。
評価
- 領域
- build-system, documentation
- issue の種類
- 機能追加
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 活発さ
- 静か
- 明瞭さ
- おおむね明確
- 初心者へのやさしさ
- 48/100