sphinx-doc/sphinx

allow to specify translation context

Open

#8251 aperta il 28 set 2020

Vedi su GitHub
 (0 commenti) (1 reazione) (0 assegnatari)Python (1985 fork)batch import
help wantedinternals: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. Sometimes you need to have separate translations for the same source strings.

Describe the solution you'd like This is accomplished by translation contexts, eg

#: src/gui/widgets/preferences.c:858
msgctxt "guilabel"
msgid "Plugins"
msgstr "プラグイン"

Here, the string "Plugins" is for the translation context "guilabel". There might be another string "Plugins" for another translation context, where the translation will be different.

There should be a way to optionally specify translation contexts, either, per-string, or per-document, or for the whole project that sphinx is translating.

Describe alternatives you've considered N/A

Additional context See Contexts in gettext manual: https://www.gnu.org/software/gettext/manual/html_node/Contexts.html

Guida contributor

Direzione di ricerca
La richiesta propone di aggiungere il contesto di traduzione (msgctxt) all'internazionalizzazione basata su gettext di Sphinx. Inizia esaminando l'implementazione i18n attuale in sphinx/locale/ e la gestione di gettext in sphinx/util/i18n.py. Comprendi come i messaggi vengono estratti e tradotti. La soluzione potrebbe comportare l'aggiunta del supporto al contesto per l'estrazione dei messaggi e la ricerca delle traduzioni, possibilmente per stringa o per documento. Osserva come altri strumenti (ad es. Babel) gestiscono i contesti. Nessuna PR o commento esistente fornisce indicazioni, quindi la progettazione è aperta a proposte.
Tech stack
python
Dominio
documentationinternationalization
Tipo issue
Funzionalità
DifficoltàQuanto dovrebbe essere impegnativa per un nuovo contributor.
2
Tempo stimatoTempo stimato per completare e verificare uno scope piccolo.
1-3 ore
Stato attivitàQuanto è probabile che la issue sia ancora attiva e reviewable.
Attiva
ChiarezzaQuanto chiaramente la issue descrive problema, scope e risultato atteso.
Chiara
Prerequisiti
Pythongettext
Adatta ai principiantiQuanto la issue è adatta a contributor alla prima esperienza.
60