[RFR] wml://devel/website/examples

[Javi Taravilla <javiertaravilla@gmail.com>]

Mando a revisión.

Saludos.


---------- Forwarded message ----------
From: Javi Taravilla <javiertaravilla@gmail.com>
Date: 2010/12/24
Subject: [ITT] wml://devel/website/examples
To: Lista de Traductores de Debian <debian-l10n-spanish@lists.debian.org>


--
Javier Taravilla



-- 
Javier Taravilla

#use wml::debian::template title="Ejemplos"
#use wml::debian::translation-check translation="1.10"

<H3>Ejemplo de Cómo se Comienza una Traducción</H3>

<p>Usaremos el idioma francés para el ejemplo:

<pre>
   cvs checkout webwml/Makefile.common webwml/english
   cd webwml
   mkdir french
   cvs add french
   cd french
   cp ../english/.wmlrc ../english/Make.* .
   echo '<protect>include $(subst webwml/french,webwml/english,$(CURDIR))/Makefile</protect>' &gt;
   Makefile
   mkdir po
   cvs add Make* .wmlrc po
   cp Makefile po
   make -C po init-po
   cvs add po/Makefile po/*.fr.po
</pre>

<p>Edite el fichero <tt>.wmlrc</tt> y modifique:
<ul>
  <li>'-D CUR_LANG=English' por '-D CUR_LANG=French'
  <li>'-D CUR_ISO_LANG=en' por '-D CUR_ISO_LANG=fr'
  <li>'-D CUR_LOCALE=en_US' por '-D CUR_LOCALE=fr_FR'
  <li>'CHARSET=iso-8859-1' por lo que sea apropiado.<br>
      Parece que el francés usa la misma codificación de caracteres que
      el inglés, de manera que no hace falta cambiarlo, sin embargo, es
      probable que otros idiomas necesiten ajustar este valor.
</ul>

<p>Edite Make.lang y cambie 'LANGUAGE := en' por 'LANGUAGE := fr'.
En el caso de que traduzca a un idioma que use más de un byte por carácter (multi-byte),
puede que tenga que cambiar algunas otras variables en ese fichero, para más
información lea ../Makefile.common y a lo mejor otros ejemplos de trabajo
(traducciones como la china).

<p>Vaya al directorio french/po y traduzca las cadenas de los ficheros PO.
Esto debería ser bastante intuitivo.

<p>Asegúrese siempre de que copia el Makefile a cada directorio que
traduce. Es necesario porque el programa <code>make</code> es el que
usa para convertir los .wml en HTML, y <code>make</code> usa
Makefiles.

<p>Cuando acabe de añadir y editar páginas, haga
<pre>
   cvs commit
</pre>
desde el directorio webwml. Ahora puede usted empezar a traducir páginas.

<H3>Ejemplo de Traducción de una Página</H3>

<p>Usaremos la traducción del contrato social al francés como ejemplo:

<pre>
   cd webwml
   cp ./copypage.pl english/social_contract.wml .
   cvs add social_contract.wml
</pre>

<p>Esto agregará automaticamente la cabecera <em>translation-check</em> apuntando a la versión original del archivo que se ha copiado. Esto también crea el directorio de destino y Makefile, en caso que esté perdido.</p>

<p>Edite social_contract.wml y traduzca el texto. No trate de traducir o modificar
ningún enlace de forma alguna - si quiere cambiar cualquier cosa, notifíquelo en la
lista debian-www. Cuando termine, escriba

<pre>
   cvs commit -m "pequeña descripción de los cambios que hizo" social_contract.wml
</pre>

<H3>Ejemplo para Añadir un Nuevo Directorio</H3>

<p>Éste ejemplo muestra cómo añadir el directorio intro/ a la traducción francesa:

<pre>
   cd webwml/french
   mkdir intro
   cvs add intro
   cd intro
   cp ../english/intro/Makefile .
</pre>

Asegúrese que el nuevo directorio tiene el Makefile y que ha sido enviado al CVS.
De otra forma, dará un error a cualquiera que intente ejecutar make.

<pre>
   cvs add Makefile
   cd ..
   cvs commit -m "added the intro dir to CVS" intro
</pre>

#example not finished
# <H3>Example of a Conflict</H3>
#
# <p>This example shows a commit that won't work because the copy in the
# repository has been modified since your last <kbd>cvs update -d</kbd>.
#
# <pre>
#    cvs commit -m"fixed a broken link" foo.wml
# </pre>
#
# will output:
#
# <pre>
# cvs: Up-to-date check failed for foo.wml!
# cvs: fix the above errors first
# </pre>
#
# or something like that :)