bazel-contrib / bazel-contrib/rules_python

sphinxdocs: i18n support

未关闭
#3,848 1 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看
sphinxdocs type: feature request
主要语言
Starlark
星标
688
派生
721
平均合并
15 小时 7 分钟
30 天内合并 PR
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 摘要。