sphinx-doc/sphinx

allow to specify translation context

Open

#8.251 aberto em 28 de set. de 2020

Ver no GitHub
 (0 comments) (1 reaction) (0 assignees)Python (1.985 forks)batch import
help wantedinternals:internationalisationtype:enhancement

Métricas do repositório

Stars
 (5.625 stars)
Métricas de merge de PR
 (Mesclagem média 10d 11h) (11 fundiu PRs em 30d)

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

Guia do colaborador

Direção de pesquisa
A issue solicita a adição de contexto de tradução (msgctxt) à internacionalização baseada em gettext do Sphinx. Comece examinando a implementação atual de i18n em sphinx/locale/ e o tratamento de gettext em sphinx/util/i18n.py. Entenda como as mensagens são extraídas e traduzidas. A solução envolveria adicionar suporte a contexto na extração de mensagens e na busca de traduções, possivelmente por string ou por documento. Veja como outras ferramentas (ex.: Babel) lidam com contextos. Nenhum PR ou comentário existente fornece orientação, então o design está aberto para proposta.
Pilha de tecnologia
python
Domain
documentationinternationalization
Tipo Issue
Funcionalidade
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
2
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-3 horas
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
Pythongettext
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
60