bazel-contrib / bazel-contrib/rules_python

sphinxdocs: i18n support

オープン
#3,848 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る
sphinxdocs type: feature request
主要言語
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

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。