sphinx-doc/sphinx

Built-in extension: informing about translation progress

Open

#11,537 opened on 2023年7月30日

GitHub で見る
 (1 comment) (5 reactions) (0 assignees)Python (1,985 forks)batch import
extensionsgood first issueinternals:internationalisationtype:enhancement

Repository metrics

Stars
 (5,625 stars)
PR merge metrics
 (平均マージ 10d 11h) (30d で 11 merged PRs)

説明

Is your feature request related to a problem? Please describe. Sphinx projects which are being translated into multiple languages using Gettext, when a translation is still in progress, display original paragraphs as a fallback to missing translations of paragraphs. That could be unexpected for a reader looking at a project in some language (which for example can be translated in a majority of content).

Describe the solution you'd like Built-in extension to enable displaying a note paragraph at the top of every article that is not fully translated, informing a reader about the progress of the translation in the article.

Would such an extension be accepted as a built-in?

Describe alternatives you've considered

  • third party extension – in my opinion the described functionality being accessible as batteries-included inside Sphinx would be beneficial to many projects around, as publishing the in progress translations seems to be a quite common case for projects using intl

Additional context

コントリビューターガイド