sphinx-doc/sphinx

allow to specify translation context

Open

#8 251 ouverte le 28 sept. 2020

Voir sur GitHub
 (0 commentaires) (1 réaction) (0 assignés)Python (1 985 forks)batch import
help wantedinternals:internationalisationtype:enhancement

Métriques du dépôt

Stars
 (5 625 stars)
Métriques de merge PR
 (Merge moyen 10j 11h) (11 PRs mergées en 30 j)

Description

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

Guide contributeur

Direction de recherche
Cette demande propose d'ajouter un contexte de traduction (msgctxt) à l'internationalisation basée sur gettext de Sphinx. Commencez par examiner l'implémentation i18n actuelle dans sphinx/locale/ et la gestion de gettext dans sphinx/util/i18n.py. Comprenez comment les messages sont extraits et traduits. La solution impliquerait d'ajouter la prise en charge du contexte pour l'extraction des messages et la recherche de traduction, éventuellement par chaîne ou par document. Regardez comment d'autres outils (par ex. Babel) gèrent les contextes. Aucune PR ou commentaire existant ne fournit de conseils, la conception est donc ouverte aux propositions.
Stack technique
python
Domaine
documentationinternationalization
Type d'issue
Fonctionnalité
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
2
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
1-3 heures
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Active
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
Pythongettext
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
60