NOMBRE¶

po-debconf - Introducción

DESCRIPCIÓN¶

La meta de "debconf" es facilitar la configuración de paquetes. Para ello, es importante asegurar que la pregunta se planteará al usuario en su propio idioma. Los traductores necesitan un marco de trabajo para trabajar en las traducciones sin necesidad de seguir el desarrollo del paquete; "po-debconf" está diseñado para que pueda trabajar con herramientas estándar de "gettext" al traducir ficheros de plantillas de debconf.

AÑADIR CAPACIDAD DE I18N A FICHEROS DE PLANTILLAS DE DEBCONF¶

Si está añadiendo a su paquete la compatibilidad con debconf, es que ha creado un fichero de plantilla que contiene texto en inglés. Para añadir la capacidad de i18n a su paquete, tiene que:

- Crear debian/po/POTFILES.in

Este fichero contiene la lista de plantillas originales. Generalmente, contiene una sola línea:

  [type: gettext/rfc822deb] templates
    

Las rutas son relativas al directorio superior.

- Anteponga un guión bajo antes de los campos traducibles en cada plantilla

Habitualmente, se pueden traducir los campos "Description". "Choices" y "Default".

- Ejecute debconf-updatepo

Creará el fichero debian/po/templates.pot que los traductores traducirán a su idioma.

- Añada una dependencia sobre "po-debconf" en debian/control

ACTUALIZACIÓN DE PLANTILLAS¶

Para ayudar a los traductores, los ficheros PO en su paquete deberían estar siempre actualizados o, de no ser así, puede que pierdan el tiempo traduciendo cadenas en desuso. Para ello, invoque la siguiente orden sin argumentos:

  $ debconf-updatepo

Debería ejecutar esta orden cada vez que modifique las plantillas en inglés, pero también cuando reciba una traducción nueva o actualizada, ya que puede que los traductores hayan trabajado con un fichero PO obsoleto.

Si renombra, añade o elimina algunos ficheros de plantillas, recuerde también editar debian/po/POTFILES.in. En caso contrario, las cadenas en inglés se omiten en los ficheros PO, y se mostrarán a los usuarios incluso si los ficheros PO están totalmente traducidos.

El programa debconf-updatepo es idempotente, modifica ficheros PO sólo si el contenido se ha actualizado. Por ello, la mejor forma de ofrecer ficheros actualizados en su paquete fuente es invocar esta orden desde el objetivo "clean" del fichero debian/rules.

Tenga en cuenta que necesita ejecutar debconf-updatepo incluso si usa dh_installdebconf. El último invoca po2debconf, que solía invocar debconf-updatepo si se detectaban ficheros desactualizados, pero este ya no es el caso ya que no era una buena solución por dos motivos:

1.

po2debconf dependía de marcas de tiempo para detectar ficheros desactualizados, y puede provocar un fallo al usar "pbuilder" o si se ha guardado en el disco una traducción desactualizada después de modificar las marcas de tiempo.

2.

dh_installdebconf se invoca mucho después de generar el fichero ".diff.gz".

FUSIONAR LAS TRADUCCIONES Y EL ORIGINAL¶

Debe comprobar que se incluyan las traducciones en el paquete generado al compilar el paquete. Puede hacerlo manualmente, o automáticamente usando el script dh_installdebconf (compruebe que tiene una dependencia de construcción versionada sobre "debhelper (>= 4.1.16)").

Para hacerlo manualmente, tendrá que fusionar las plantillas y las traducciones en durante la compilación (y tiene que especificar una dependencia de construcción sobre "po-debconf") como puede ver a continuación:

  $ po2debconf debian/templates > debian/tmp/DEBIAN/templates

ADVERTENCIA: los dos ficheros llamados templates no son lo mismo. El primero sólo contiene el texto en inglés, con marcas que indican los campos a traducir, mientras que el segundo contiene todos los idiomas. Esto es, NO PUEDE guardar sólo las plantillas fusionadas, o no podrá tratar las traducciones a medida que las personas las envían.

NUEVAS PLANTILLAS ORIGINALES¶

El nuevo formato de fichero de plantilla fuente es casi idéntico a los ficheros de plantilla distribuidos, pero se antepone un guión bajo a los campos traducibles. Ejemplo:

  Template: debconf/frontend
  Type: select
  _Choices: Dialog, Readline, Gnome, Editor, Noninteractive
  Default: Dialog
  _Description: Interface to use for configuring packages:
   Packages that use debconf for configuration share a common look and
   feel.  You can select the type of user interface they use.
   .
   The dialog frontend is a full-screen, character based interface,
   while the readline frontend uses a more traditional plain text
   interface, and the gnome frontend is a modern X interface.  The
   editor frontend lets you configure things using your favorite text
   editor. The noninteractive frontend never asks you any questions.

  __Choices: Dialog, Readline, Gnome, Editor, Noninteractive

  $ cp debian/templates debian/foo

  Template: debconf/frontend
  Type: select
  _Choices: Dialog, Readline, Gnome, Kde, Editor, Noninteractive

  $ debconf-gettextize --merge --choices debian/foo

  Template: debconf/button-yes
  Type: text
  # Translators, this text will appear on a button, so KEEP IT SHORT
  _Description: Yes

DEPURACIÓN¶

Verá que debconf-loadtemplate no aceptará un fichero de plantillas con marcas de i18n. Sin embargo, aceptará un fichero fusionado, así que si ha estado depurando su configuración mediante debconf de la siguiente manera

  rm /tmp/{config,templates}.dat{,-old}
  debconf-loadtemplate debian/templates
  DEBIAN_PRIORITY=low debconf -freadline debian/config configure 28.0

ahora tendrá que hacer algo así:

  po2debconf debian/templates > debian/tmp/DEBIAN/templates
  rm /tmp/{config,templates}.dat{,-old}
  debconf-loadtemplate debian/tmp/DEBIAN/templates
  DEBIAN_PRIORITY=low debconf -freadline debian/config configure 28.0

ADVERTENCIAS¶

• "Debconf" 1.2.0 reconoce campos con la forma Nombre-idioma.codificación. Por ejemplo, "Description-de.ISO-8859-1" o "Choices-ru.KOI8-R". po2debconf escribe las plantillas en este nuevo formato de forma predefinida. Las versiones anteriores de "debconf" ignorarán estos campos, y se mostrará el texto en inglés. Para saber cómo cambiar la codificación y el formato de salida consulte po2debconf(1).
• Una cadena dada en inglés puede tener una única traducción a un idioma dado. Es imposible dar dos traducciones, dependiendo del contexto. Para resolver este problema, debe añadir marcas especiales en las diferentes apariciones de la cadena dada para así diferenciarlas. (Estas marcas sólos son visibles para el traductor, y se eliminarán de la cadena antes de mostrarse al usuario.)

  Tales marcas se deben añadir al principio de las cadenas a traducir, y deben comenzar con "[ " (un paréntesis izquierdo seguido de un espacio) y finalizar con "]" (un paréntesis derecho), y puede contener cualquier carácter a excepción de paréntesis y nuevas líneas. Por ejemplo, "[ blahblah]" es una marca válida, mientras que "[ bla[bla]bla]" no lo es. Para adictos a las expresiones regulares de Perl, las marcas se reconocen (y eliminan) con la siguiente regla:

    $msg =~ s/\[\s[^\[\]]*\]$//s;
      

• "po-debconf" y "debconf-utils" no tratan el espaciado de la misma forma; el segundo reformatea párrafos al actualizar y fusionar traducciones. "debconf-utils" es muy astuto, y no considera los espacios como parte de la cadena al determinar las entradas difusas (esto es, las que necesitan la atención del traductor porque el original ha cambiado).

  Por otra parte, "po-debconf" depende de "gettext" para detectar entradas difusas, y no trata los espacios como caracteres especiales. Por ello, debe eliminar los espacios superfluos al final de las cadenas de los ficheros de plantilla originales, o aparecerán en los ficheros POT y PO.

  Por la misma razón, debconf-gettextize puede marcar el texto como difuso por la falta de coincidencia de caracteres de espacio, y los traductores tendrán que quitar la marca de difusa a tales cadenas manualmente. Esto sólo ocurre una vez al convertir las plantillas al formato "po-debconf", a menos que cambie al azar los espacios en los ficheros de plantillas originales, lo cuál dificultaría la labor de los traductores.

• Habitualmente, el campo Default: no se debe traducir cuando el tipo de plantilla es Select o Multiselect. Bajo ciertas circunstancias (por ejemplo, al seleccionar el idioma para una aplicación) los valores localizados pueden ser significativos.

  El valor localizado no debe estar traducido, sino seleccionado de la lista de valores en inglés en el campo Choices. La mejor de forma de lograr esto es insertar un comentario en su fichero de plantillas que se copiará a los ficheros PO.

    Template: geneweb/lang
    Type: select
    __Choices: Danish (da), Dutch (nl), English (en), Esperanto (eo)
    #  You must NOT translate this string, but you can change its value.
    #  The comment between brackets is used to distinguish this msgid
    #  from the one in the Choices list; you do not have to worry about
    #  them, and have to simply choose a msgstr among the English values
    #  listed in the Choices field above, e.g. msgstr "Dutch (nl)"
    _Default: English (en)[ default language]
    _Description: Geneweb default language
      

  El valor predefinido también aparece en el campo Choices, y ambos tiene diferentes traducciones: el primero es un valor no traducido seleccionado entre los valores de Choices, mientras que el segundo es una traducción normal. Como "gettext" no puede tener dos traducciones diferentes para el mismo msgid, ambos msgids deben ser diferentes usando los comentarios entre paréntesis descritos en una sub-sección anterior.

  Antes de la versión 0.8.0 de "po-debconf", tales comentarios no estaban disponibles, y los desarrolladores tenían que reemplazar el campo _Default: con _DefaultChoice: para así resaltar esos campos en los ficheros PO:

    #. DefaultChoice
    msgid ""
    "English[ default: do not translate bracketed material, put your "
    "own language here but UNTRANSLATED.  If it is not in the list, "
    "put English (without bracketed material)]"
    msgstr ""
    "Swedish"
      

  Se recomienda usar comentarios sencillos en los ficheros de plantillas, menos proclives a causar un error.

PÁGINAS WEB DE ESTADÍSTICAS¶

Las estadísticas de traducciones basadas en "po-debconf" están disponibles en <http://www.debian.org/intl/l10n/po-debconf/> (o réplicas); se actualizan automáticamente cuando se envían paquetes nuevos. Sólo se consideran los paquetes que contienen ficheros debian/po/templates.pot y debian/po/POTFILES.in, compruebe que su paquete fuente los proporciona.

Los traductores pueden obtener aquí ficheros PO y POT, pero siempre deben contactar con el anterior traductor (la dirección de correo electrónico está dentro del fichero PO) y puede que también con los otros traductores del equipo en debian-l10n-<idioma>@lists.debian.org (si existe tal lista de correo) para comprobar que nadie está trabajando en la misma traducción, y también revisar los informes de fallo remitidos al paquete que van a traducir para ver si ya se ha enviado una traducción.

Después de traducir estos ficheros, deberían enviar su trabajo al desarrollador como un informe de fallo con severidad wishlist, y la etiqueta patch.

VÉASE TAMBIÉN¶

debconf-gettextize(1), debconf-updatepo(1), dh_installdebconf(1), podebconf-report-po(1), po2debconf(1), debconf-devel(7).

AUTORES¶

  Martin Quinson <Martin.Quinson@ens-lyon.fr>
  Denis Barbier <barbier@linuxfr.org>

TRADUCCIÓN¶

  Omar Campagne Polaino <ocampagne@gmail.com>, 2010.
  
  Esta traducción se ha realizado como parte del equipo de
  traducción al español de Debian, <debian-l10n-spanish.org>.