El 11/11/18 a las 12:26 p. m., Rafa escribió:
Hola Alfredo:
On Sun, Nov 11, 2018 at 11:54:46AM -0400, Alfredo Quintero wrote:
El 9/11/18 a las 3:01 p. m., Rafa escribió:
[...]
L3: translation="d2e8c3..." ->
"55b6f42c8b91b52404cf09a178e66550253b8417"
[...]
Hola.
Incluí las observaciones que mencionaste, adjunto el nuevo archivo y el diff
con el archivo anterior.
Gracias por la actualización.
Espero que disculpes la insistencia, pero la modificación de la L3 es
importante. La etiqueta «translation» tiene que coincidir con el hash del
commit mediante el cual se incorporó al repositorio la versión en inglés a la
que corresponde la nueva traducción.
Usando Git lo puedes obtener con:
git log -- english/devel/website/translating.wml
Y usando Gitlab, en:
https://salsa.debian.org/webmaster-team/webwml/commits/master/english/devel/website/translating.wml
En este caso, el valor a utilizar es:
55b6f42c8b91b52404cf09a178e66550253b8417
Otra cosa: no es necesario que me incluyas directamente en la cabecera
de los correos, es suficiente con que los envíes a la lista.
Gracias.
Un saludo,
Alfredo.
Un saludo,
Rafa.
Todavía me estoy acostumbrando al sistema y algunas cosas se me pasan,
es el entusiasmo.
Ya corregí la línea en el archivo. Perdón por la molestia con el correo
(Espero haberlo hecho
bien esta vez).
Un saludo,
Alfredo.
#use wml::debian::template title="Traducción de las páginas web de Debian" BARETITLE=true
#use wml::fmt::verbatim
#use wml::debian::translation-check translation="55b6f42c8b91b52404cf09a178e66550253b8417" maintainer="Alfredo Quintero"
<p>Para hacer el trabajo de los traductores tan fácil como sea posible, las
páginas se generan de forma algo diferente a como muchos de ustedes
están acostumbrados. Las páginas web se actualizan realmente usando
fuentes que están escritas en <a
href="http://www.engelschall.com/sw/wml/"><tt>wml</tt></a>.
Hay diferentes directorios para cada idioma.
</p>
<p>Si piensa comenzar una traducción completamente nueva del servidor
web de Debian, por favor, vea la <a href="#completenew">sección del
comienzo de una nueva traducción</a>.
</p>
<h2><a name="singlepages">Traducción de páginas individuales</a></h2>
<p>Usamos WML para separar el contenido especÃfico de una página de los
elementos comunes a múltiples páginas. Esto significa que uno debe
editar ciertos ficheros fuente WML en lugar de ficheros HTML. Por favor,
<a href="using_git">utilice Git</a> para obtener los fuentes actuales.
Necesitará descargar al menos dos directorios: <tt>webwml/english/</tt> y
<tt>webwml/<var><idioma></var>/</tt>.</p>
<p>Para traducir una única página del inglés a su idioma, deberá traducir
el fichero .wml y colocarlo dentro del directorio del otro idioma. El
nombre y el path relativo deben ser los mismos que el del directorio
inglés, para que los enlaces sigan funcionando.</p>
<h3>Cabeceras de traducción</h3>
<p>También recomendamos
encarecidamente que la persona que traduce añada una lÃnea adicional a las cabeceras
tras la última sentencia <code>#use</code> para registrar la versión («commit»)
exacta del fichero original que se tradujo, de manera que
<a href="uptodate">sea más sencillo actualizar</a>.
La lÃnea serÃa algo como:
<kbd>#use wml::debian::translation-check translation="<var><git_commit_hash></var>"</kbd>.
Por favor tenga en cuenta que si genera el fichero a traducir usando la herramienta
<tt>copypage.pl</tt> (que se recomienda encarecidamente), el hash del commit de git
se generará automáticamente. El uso de <tt>copypage.pl</tt> se explica más adelante.
</p>
<p><strong>Nota: </strong>algunas partes de la información siguiente están obsoletas,
especialmente todo lo relacionado con CVS. Por favor descarte esa parte de la
información por ahora y ayude a actualizar estas instrucciones, si puede.
</p>
<p>Algunos equipos de traducción usan también esta lÃnea para marcar la persona
encargada oficialmente de la traducción de cada página web. Haciéndolo, le llegarán mensajes
automáticamente cada vez que las páginas que mantiene sean actualizadas en
inglés, y necesitan su atención para actualizar la traducción. Para ello,
simplemente añada su nombre como mantenedor al final de la lÃnea
<code>#use</code> de manera que quede asÃ:
<kbd>#use wml::debian::translation-check translation="<var>git_commit_hash</var>"
maintainer="<var>su nombre</var>"</kbd>. El script <tt>copypage.pl</tt>
hará esto automáticamente si está presente la variable de entorno <tt>DWWW_MAINT</tt>
o usa la opción -m en la lÃnea de órdenes.
</p>
# Se han eliminado las descripciones especÃficas para cvs debido a la migración a git.
#
#<p>También hace falta explicarle al robot quién es usted, con qué
#frecuencia quiere que le lleguen mensajes automáticos y su contenido. Para
#ello, edite (o dÃgaselo a su coordinador) el fichero
#webwml/<var>idioma</var>/international/<var>idioma</var>/translator.db.pl
#en el repositorio. DeberÃa entender la sintaxis fácilmente, y puede usar el
#fichero del equipo francés como plantilla si no existe aún el de su
#idioma. El robot puede enviar varios tipos de información, y para cada
#tipo, puede escoger la frecuencia con que le será enviada. Los tipos
#disponibles son:
#</p>
#<ul>
# <li><b>summary</b>: resumen de qué documentos están obsoletos</li>
# <li><b>logs</b>: los "cvs log" entre las versiones traducidas y las
# actuales</li>
# <li><b>diff</b>: "cvs diff"</li>
# <li><b>tdiff</b>: el script intentará encontrar la parte del texto
# traducido modificado por el parche en inglés</li>
# <li><b>file</b>: añade la versión actual del fichero a traducir</li>
#</ul>
#<p>Luego, para cada tipo, el valor debe ser: 0 (nunca), 1 (mensual),
#2 (semanal) o 3 (diario).</p>
#<p>Un ejemplo podrÃa ser:
#</p>
#<verbatim>
# 'Martin Quinson' => {
# email => 'martin.quin...@tuxfamily.org',
# summary => 3,
# logs => 3,
# diff => 3,
# tdiff => 0,
# file => 0
# },
#</verbatim>
<p>La cabecera de la página web puede producirla fácilmente usando el
script <tt>copypage.pl</tt> del directorio raÃz de webwml. El script
copiará la página en el lugar correcto, creará directorios y «makefiles» si
fuera necesario, y añadirá la cabecera adecuada de forma automática.
Se le advertirá si una pagina a copiar existe en el repositorio, ya sea
porque la página fue eliminada del repositorio (debido a estar muy
desactualizada) o porque alguien ya envió una traducción y su repositorio
local no está actualizado.
</p>
<p>Para empezar a usar <tt>copypage.pl</tt> primero debe configurar
el fichero <tt>language.conf</tt> que se usará para determinar a qué
idioma se está traduciendo. Ese fichero solo necesita tener una lÃnea con el
nombre del idioma, eso es todo. También puede definir el idioma usando la variable
de entorno <tt>DWWW_LANG</tt> y usar la variable de entorno <tt>DWWW_MAINT</tt>
para poner su nombre, que se añadirá a la cabecera de los ficheros wml
generados, como persona encargada de la traducción. Existen otras caracterÃsticas
disponibles en el script, solo ejecútelo sin argumentos para obtener la ayuda.
</p>
<p>Después de haber ejecutado, digamos, <kbd>./copypage.pl
<var>fichero</var>.wml</kbd>, traduzca el texto original que hay dentro
del fichero. Encontrará comentarios en los ficheros indicando si hay
elementos que no deberÃan ser traducidos: respételos. No haga cambios
innecesarios al formato; si hay que arreglar algo, deberÃa hacerse en el
fichero original.</p>
<h3>Creación y publicación de páginas</h3>
<p>Ya que usamos <a href="content_negotiation">negociación de
contenido</a>, los ficheros HTML no se llaman
<tt><var>fichero</var>.html</tt> sino
<tt><var>fichero</var>.<var><idioma></var>.html</tt>, siendo
<var><idioma></var> el código de dos letras del idioma, de acuerdo
con la <a
href="https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes">lista ISO 639</a>
(ej: <tt>es</tt> para Español).</p>
<p>Puede generar HTML del WML ejecutando <kbd>make
<var>fichero</var>.<var><idioma></var>.html</kbd>. Si funciona,
compruebe que la sintaxis es completamente válida con <kbd>weblint
<var>fichero</var>.<var><lang></var>.html</kbd>.</p>
<p>NOTA: Las páginas web son regularmente reconstruidas en el servidor
www-master, basándose en la fuente wml en git. Este proceso es en su mayor
parte impermeable a errores. Sin embargo, si envÃa un fichero estropeado
en el nivel superior de la traducción (ej: el fichero index.wml de nivel
superior), interrumpirá el proceso de compilación y detendrá todo el resto
de actualizaciones del sitio web. Preste atención especial a estos ficheros.
</p>
<p>Una vez esté lista la página, puede enviarla a Git. Si tiene permiso
para hacerlo por sà mismo, envÃe sus cambios (<kbd>git push</kbd>) al
<a
href="https://salsa.debian.org/webmaster-team/webwml">repositorio git webwml
</a>; y si no, envÃelo a <a href="translation_coordinators">alguien que
tenga derechos de escritura en el repositorio</a>.</p>
<h2><a name="completenew">Comienzo de una nueva traducción</a></h2>
<p>Si desea comenzar la traducción de las páginas web de Debian a un
nuevo idioma, envÃenos un mensaje (en inglés) a
<a href="mailto:webmas...@debian.org">webmas...@debian.org</a>.</p>
<p>Antes que nada, copie nuestro árbol de fuentes, tal como se describe
en <a href="using_git">nuestra página de introducción a Git</a>.</p>
<p>Tras haber clonado el repositorio git, empiece creando un directorio de alto nivel
para su traducción, junto a english/ y los otros. El nombre del directorio
de la traducción debe estar en inglés y todo en minúsculas (ej: «german»,
no «Deutsch»).</p>
<p>Copie los ficheros <tt>Make.lang</tt> y <tt>.wmlrc</tt> del directorio
english/ al nuevo directorio de traducción. Estos ficheros son esenciales
para compilar la traducción partiendo de ficheros WML. Están pensados para
que una vez los copie al nuevo directorio de idioma, sólo tenga que
cambiar estas cosas:</p>
<ol>
<li>Debe cambiar la variable LANGUAGE del fichero <tt>Make.lang</tt>.
<li>Debe cambiar las variables CUR_LANG, CUR_ISO_LANG y CHARSET en el
fichero <tt>.wmlrc</tt>. Añada CUR_LOCALE en caso de que la necesite
para ordenación.
<li>Puede que algunos idiomas necesiten algo de procesado extra para
controlar el juego de caracteres. Esto se puede hacer usando las
opciones de wml --prolog y --epilog. Use las variables WMLPROLOG y
WMLEPILOG de <tt>Make.lang</tt> para esto.
<li>Debe cambiar la variable LANGUAGES en el fichero de nivel superior
<tt>webwml/Makefile</tt> de manera que su idioma se compile junto
con los otros, en www.debian.org. PreferirÃamos que dejase este
cambio en particular a los webmasters, porque puede que los ficheros
de la traducción contengan errores al ser descargados desde cero del
repositorio, y esto podrÃa interrumpir el proceso de compilación del resto
de nuestro sitio web.
</ol>
<p>Tras hacer esto, ponga la siguiente lÃnea en un fichero nuevo llamado
"Makefile" en ese directorio:</p>
<pre>
<protect>include $(subst webwml/<var>dirdesuidioma</var>,webwml/english,$(CURDIR))/Makefile</protect>
</pre>
<p>(Cambie <var>dirdesuidioma</var> por el nombre del directorio de su
idioma, por supuesto).</p>
<p>Ahora cree un subdirectorio llamado «po» dentro del de idioma, y copie
el mismo Makefile dentro de ese subdirectorio (<kbd>cp ../Makefile .</kbd>).
</p>
<p>Ejecute <kbd>make init-po</kbd> en el directorio po/ para generar el
conjunto inicial de ficheros *.po.</p>
<p>Ahora que ya tiene el esqueleto preparado, puede empezar a
añadir traducciones a nuestras etiquetas WML compartidas que se usan en
las plantillas. Las primeras plantillas que deberÃa traducir son aquellas
que aparecen en todas las páginas, como las palabras clave de la cabecera,
las entradas en la barra de navegación, y el pie de página.</p>
# The page on <a href="using_wml">using WML</a> has more information on this.
<p>Empiece traduciendo el fichero <code>po/templates.<var>xy</var>.po</code>
(siendo <var>xy</var> el código de dos letras de su idioma). Por cada
<code>msgid "<var>algo</var>"</code> hay en principio un
<code>msgstr ""</code> y deberÃa escribir la traducción de
<var>algo</var> dentro de las comillas dobles tras el
<code>msgstr</code>.</p>
<p>No tiene que traducir todas las cadenas de texto de todos los ficheros
.po, sino sólo aquellas que necesiten realmente las páginas ya traducidas.
Para saber si necesita traducir una cadena, vea los comentarios en el
fichero .po justo encima de cada sentencia <code>msgid</code>. Si el
fichero referenciado está en <tt>english/template/debian</tt>, entonces
mejor tradúzcalo. Si no, puede posponerlo para más adelante, cuando
traduzca realmente la sección relevante de las páginas web que lo
precisan.</p>
<p>El punto de los ficheros po/ es hacer las cosas mas fáciles para los traductores,
asà ellos (casi) nunca tendrán que editar nada en el directorio
<tt>english/template/debian</tt>.
Si encuentra algo incorrecto en la forma en que esta configurado
el directorio de plantillas, por favor asegúrese de que el problema sea arreglado
en una manera general (puede pedirle a alguien mas que lo haga por usted),
en lugar de enviar las traducciones a las plantillas, lo que seria
(generalmente) un problema grave.</p>
<p>Si no está seguro de si lo hizo correctamente, pregunte en la lista
debian-www antes de enviar los cambios.</p>
<p>Nota: si encuentra que necesita hacer cualquier otro cambio, envÃe un
mensaje de correo a debian-www diciendo qué necesita cambiar y por qué, para
que el problema pueda se corregido.</p>
<p>Tras terminar con el esqueleto de plantilla, puede empezar con la
traducción de la página inicial y otros ficheros *.wml. Si desea una lista
de lo que deberÃa ser traducido antes que nada, consulte
<a href="translation_hints">la página de consejos</a>. Traduzca páginas
*.wml tal como está descrito <a href="#singlepages">al principio de esta
página</a>.</p>
<h3>Reviviendo traducciones desactualizadas</h3>
<p> Como se describió en <a href="uptodate">mantener las traducciones actualizadas</a>,
traducciones desactualizadas del sitio pueden ser removidas automáticamente cuando
un largo periodo de tiempo ha pasado sin tener una actualización.</p>
<p>Si encuentra que algún fichero se eliminó en algún momento en el pasado
y le gustarÃa recuperar el fichero de nuevo para editarlo, puede buscar a través
de la historia de cambios usando las órdenes estándar de git.</p>
<p>Por ejemplo, si el fichero eliminado es "eliminado.wml", puede buscar en la
historia de cambios ejecutando:</p>
<verbatim>
git log --all --full-history -- <ruta/al/fichero/eliminado.wml>
</verbatim>
<p>Puede encontrar el «commit» exacto que eliminó el fichero que desea,
junto con la cadena del hash de ese «commit». Para mostrar la información
detallada sobre la modificación realizada al fichero en ese «commit» puede usar
<code>git show</code> subcommand:</p>
<verbatim>
git show <COMMIT_HASH_STRING> -- <ruta/al/fichero/eliminado.wml>
</verbatim>
<p>Si el cambio es exactamente el que eliminó el archivo, puede restaurar el archivo
usando <code>git checkout</code>:</p>
<verbatim>
git checkout <COMMIT_HASH_STRING>^ -- <ruta/al/fichero/eliminado.wml>
</verbatim>
<p>Una vez que haga esto tendrá que, por supuesto, actualizar el documento antes
de añadirlo otra vez. O podrÃa ser eliminado.</p>
<h3>El resto de la historia</h3>
<p>Es probable que la descripción anterior sea suficiente para empezar.
Tras esto, quizá quiera consultar los siguientes documentos, que
proporcionan explicaciones más detalladas e información útil adicional.</p>
<ul>
<li>Algunos <a href="examples">ejemplos</a> para darle una
idea más clara de cómo puede empezar.
<li>Respuestas a algunas preguntas comunes con consejos
de ayuda, en la página <a href="translation_hints">consejos de
traducción</a>.
<li>Tenemos mecanismos para ayudar a <a href="uptodate">mantener las
traducciones actualizadas</a>.
<li>Para ver el estado de su traducción y compararlo con otros,
compruebe las <a href="stats/">estadÃsticas</a>.
</ul>
<p>Esperamos que encuentre que el trabajo que hemos hecho haga que la
traducción de las páginas sea tan sencilla como sea posible. Como ya hemos
mencionado, si tiene alguna pregunta, puede hacerla en la lista de correo
<a href="mailto:debian-...@lists.debian.org">debian-www</a>.</p>