Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Translate Sphinx's version labels ("Added in version") through our own sphinx.pot

Abierto Apto para principiantes
  • ¿Algo no está bien?
#15,812 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
83/100
Tipo de issue
Nueva funcionalidad
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
python
Área
documentation, internationalization

Línea de trabajo

Empieza por _templates/versions.html y la configuración de gettext que utiliza make gettext; el issue propone enumerar cuatro etiquetas de versión de Sphinx en esa plantilla examinada para que lleguen a sphinx.pot. Comprueba el catálogo generado para confirmar que se extraen las cuatro cadenas y, después, verifica que la compilación de la documentación siga usando las traducciones integradas de Sphinx cuando falte una traducción del proyecto.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

0. needs triage

Found this as part of my effort to translate the documentation.

The label that Sphinx puts in front of every .. versionadded:: block is shown in English in most translated manuals, for example "Added in version 5.7: Nextcloud 32 or later" on the Danish desktop pages (40 places in the Danish user manual).

The label comes from Sphinx's own message catalog, not from ours. Sphinx renamed it from "New in version %s" to "Added in version %s" in 7.3, and in Sphinx 8.1.3, which requirements.txt pins, the new string is untranslated for 29 of the user manual's 40 languages:

ar, cs, da, de_DE, el, es, fi_FI, gl, hu_HU, id, it, ja_JP, ko, lt, nb_NO, nl, pl, pt_PT, ro, si, sk_SK, sr, sv, ta, tr, uk_UA, vi, zh_CN, zh_HK

Six more (br, ga, lo, mn, nn, uz) have no Sphinx catalog at all. Only ca, fr, pt_BR, ru and zh_TW have it.

Proposal: let the labels go through our own sphinx.pot, which Transifex already handles. Our project catalog for the sphinx domain is loaded before Sphinx's built-in one, which is why "Search docs", "Languages" and "Versions" already appear translated. If the gettext build also extracted the four version labels, every language team could translate them in the "Nextcloud user documentation" project, and they would show on the next build.

One way to get them extracted is a line in a template that make gettext already scans, e.g. _templates/versions.html:

{#- Sphinx's own version labels, listed here so they reach sphinx.pot and Transifex -#}
{%- set _version_labels = [_('Added in version %s'), _('Changed in version %s'), _('Deprecated since version %s'), _('Removed in version %s')] -%}

Strings left untranslated in our catalog fall back to Sphinx's built-in translation, so languages that already have them lose nothing.

The alternative is to wait for the labels to be translated upstream (Danish was added to Sphinx's Transifex project today) and then upgrade Sphinx, which only helps the languages someone translates there.

AI

Used Claude Opus 5.5 to assist with the analysis and this write-up.

Lenguaje dominante
JavaScript
Estrellas
633
Forks
2.6k
Merge medio
16 h 42 min
PR fusionados (30 d)
121

Preparar el entorno

Abrir en Codespaces

Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de nextcloud/documentation

Todos los issues de nextcloud/documentation

Issues similares

Más issues de JavaScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.