sphinx-doc/sphinx

Built-in extension: informing about translation progress

Open

#11.537 aperta il 30 lug 2023

Vedi su GitHub
 (1 commento) (5 reazioni) (0 assegnatari)Python (1985 fork)batch import
extensionsgood first issueinternals:internationalisationtype:enhancement

Metriche repository

Star
 (5625 star)
Metriche merge PR
 (Merge medio 10g 11h) (11 PR mergiate in 30 g)

Descrizione

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

Guida contributor