bazel-contrib / bazel-contrib/rules_python

sphinxdocs: i18n support

Open
#3,848 1 comment 0 reactions 0 assignees View on GitHub
sphinxdocs type: feature request
Dominant language
Starlark
Stars
688
Forks
721
Avg merge
14h 49m
Merged PRs (30d)
81

Description

# 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

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.