sphinx-doc/sphinx

allow to specify translation context

Open

#8.251 geöffnet am 28. Sept. 2020

Auf GitHub ansehen
 (0 Kommentare) (1 Reaktion) (0 zugewiesene Personen)Python (1.985 Forks)batch import
help wantedinternals:internationalisationtype:enhancement

Repository-Metriken

Stars
 (5.625 Stars)
PR-Merge-Metriken
 (Durchschn. Merge 10T 11h) (11 gemergte PRs in 30 T)

Beschreibung

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

Contributor Guide

Research-Richtung
Das Issue fordert die Hinzufügung von Übersetzungskontext (msgctxt) zur gettext basierten Internationalisierung von Sphinx. Beginnen Sie mit der Untersuchung der aktuellen i18n Implementierung in sphinx/locale/ und der gettext Verarbeitung in sphinx/util/i18n.py. Verstehen Sie, wie Nachrichten extrahiert und übersetzt werden. Die Lösung würde die Hinzufügung von Kontextunterstützung für die Nachrichtenextraktion und Übersetzungssuche erfordern, möglicherweise pro Zeichenkette oder pro Dokument. Sehen Sie sich an, wie andere Tools (z. B. Babel) Kontexte handhaben. Keine bestehenden PRs oder Kommentare bieten Anleitung, daher ist der Entwurf für Vorschläge offen.
Tech Stack
python
Domain
documentationinternationalization
Issue Type
Funktion
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
2
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
1-3 Stunden
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
Aktiv
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
Klar
Voraussetzungen
Pythongettext
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
60