[LCFC] wml://devel/website/using_cvs.wml

[Laura Arjona Reina]

Saludos

-- 
Laura Arjona
https://wiki.debian.org/LauraArjona



#use wml::debian::template title="Uso del CVS"
#use wml::debian::translation-check translation="1.29" maintainer="Luis Uribe"

<p>CVS es un programa que se usa para controlar el trabajo que se realiza de manera simultanea por varias 
personas sobre un mismo material. Con él, cada usuario crea una copia
local del repositorio principal. Las copias locales pueden estar en la
misma máquina o en cualquier lugar del mundo. Los usuarios pueden modificar
la copia local como deseen y, cuando el material modificado esté preparado, enviar
los cambios al repositorio principal.</p>

<p>Para un accesso de sólo lectura puede usar la <a href="http://anonscm.debian.org/viewvc/webwml/webwml/";>interfaz web</a>. Existen también muchos clientes gráficos como <a href="https://packages.debian.org/cervisia";>Cervisia</a> de KDE. Este documento describe el flujo de trabajo con el programa de linea de órdenes <code>cvs</code>, aunque otros clientes ofrecen funciones similares.</p>

<p>CVS no le permitirá enviar un fichero si la copia del repositorio
principal se ha modificado desde la última actualización que usted realizó.
Normalmente esto no es problema, ya que puede actualizar su copia
local. Si las modificaciones realizadas en la copia del repositorio central
eran de partes diferentes a aquellas en las que usted trabajaba,
los cambios se fusionan silenciosamente. Si los cambios afectan al mismo área
en la que estuvo trabajando, le avisará de que hay un conflicto y usted tendrá que
editar el fichero y corregir el problema antes de enviarlo.</p>

<p>A continuación se usará como ejemplo un acceso anónimo. Si usted tiene
acceso a una cuenta que le dé permisos de escritura en el repositorio, debería usarla. 
Si está planeando hacer cambios, antes de empezar debería conseguir una cuenta, ya que los usuarios anónimos no pueden enviar cambios.
Para más información vea la sección sobre <a href="#write-access">acceso con escritura</a>.</p>

<p>Para empezar a usar CVS, primero ha de <code>autenticarse</code> en el servidor CVS:</p>

<pre>
   cvs -d :pserver:anonym...@anonscm.debian.org:/cvs/webwml login
</pre>

<p>(pulse intro cuando se le pida la clave)</p>

<p>Para bajar una copia de los ficheros wml a su máquina local, necesita usar</p>

<pre>
   cvs -d :pserver:anonym...@anonscm.debian.org:/cvs/webwml checkout webwml
</pre>

<p>Con ello puede obtener un subconjunto de páginas como éste:</p>

<pre>
   cvs -d :pserver:anonym...@anonscm.debian.org:/cvs/webwml checkout -l \\
          webwml webwml/&lt;<var>idioma</var>&gt;
   cvs -d :pserver:anonym...@anonscm.debian.org:/cvs/webwml checkout \\
          webwml/Perl webwml/english/template webwml/&lt;<var>idioma</var>&gt;/Pics
   cvs -d :pserver:anonym...@anonscm.debian.org:/cvs/webwml checkout \\
          &lt;<var>ruta a los ficheros deseados</var>&gt;
</pre>

<p>Puede repetirlo para todos los subdirectorios o ficheros que quiera. La
segunda línea incluye todos los ficheros que necesitará si quiere
crear HTML a partir de los ficheros WML. En realidad no están permitidas las descargas parciales, 
por lo que las instrucciones anteriores puede que no siempre funcionen.</p>

<p>Si tiente una cuenta en Alioth, con una <a
 href="https://alioth.debian.org/account/editsshkeys.php";>\
 clave SSH pública</a>, puede usarla de esta forma:
</p>

<pre>
   cvs -d :ext:usua...@cvs.debian.org:/cvs/webwml checkout webwml/english/doc
</pre>

<p>Desde entonces, no necesitará usar la parte <code>'-d :ext:...'</code>
Pero cada pocos días tendrá que ejecutar</p>

<pre>
   cvs update -d
</pre>

<p>para actualizarse con los ficheros del repositorio que hayan cambiado. La
opción de actualización <code>-d</code> añadirá automáticamente los nuevos directorios.
Esto también revisa los directorios que fueron omitidos en el caso de que
usted realizara una descarga parcial &mdash; en ese caso es posible 
que quiera usar el script <code>cvsup.py</code>.</p>


<p>Puede que quiera crear un fichero <code>~/.cvsrc</code>, de forma que no tenga que teclear
las mismas opciones constantemente. Esto puede contener por ejemplo:</p>

<pre>
cvs -z9
update -d -P
diff -u
</pre>

<p>Lo que sigue es para aquellos que tienen permiso de escritura en el repositorio.
Cuando termine con una página, puede enviar sus cambios al repositorio usando</p>

<pre>
   cvs commit &lt;fichero&gt;.wml
</pre>

<p>o</p>

<pre>
   cvs commit &lt;directorio&gt;    (para entregar todos los cambios en &lt;directorio&gt;)
</pre>

<p>o</p>

<pre>
   cvs commit          (para entregar todos los cambios en el directorio actual y sus subdirectorios)
</pre>

<p>Si es la primera persona en traducir una página, necesita hacer</p>

<pre>
   cvs add &lt;file&gt;.wml
</pre>

<p>antes de enviarla. Tenga en cuenta que <code>cvs add</code> no es recursivo, por lo que
necesitará añadir un directorio antes de añadir su contenido.</p>

<p>Para más información sobre CVS, use <code>info cvs</code>.</p>

<p>
Si incluye <code>Closes: #</code><var>nnnnnn</var> en su mensaje de «commit»,
entonces el informe de fallo con número <code>#</code><var>nnnnnn</var> se cerrará
automáticamente cuando entregue los cambios. La forma concreta de esto es la misma
que se indica en la <a href="$(DOC)/debian-policy/footnotes.html#f17">política de Debian</a>.
</p>


<p>
Many Debian websites support SSL, please use HTTPS links for the
ones that do support SSL.
Some Debian/DebConf/SPI/etc websites do not have HTTPS support or are
only signed by SPI and not by any SSL CA that is trusted by browsers
outside of Debian, we should avoid linking to https: versions of
these websites so that people not using Debian don't get errors
they may not understand.
The CVS repository will reject commits containing plain HTTP links for
Debian websites that support HTTPS or containing HTTPS links for the
Debian/DebConf/SPI websites that are known to either not
support HTTPS or use certificates signed only by SPI.</p>


<p>
Muchos sitios web de Debian soportan SSL, por favor use enlaces HTTPS para los que 
soportan SSL.
Algunos sitios web de Debian/DebConf/SPI/etc no tienen soporte HTTPS o sólo están 
firmados por SPI y no por una Autoridad de Certificación SSL fuera de Debian en la que confíen los
navegadores, por lo que debería evitarse enlazar a versiones https: de esos sitios web
para que la gente que no usa Debian no vea errores que quizá no entiendan.

 El repositorio CVS rechazará cambios
que contengan enlaces simples HTTP para sitios que soportan HTTPS, o que contengan 
enlaces HTTPS a sitios web de Debian/DebConf/SPI que se sabe que o bien no soportan 
HTTPS o bien usan certificados firmados solamente por SPI.</p>

<h3><a name="write-access">Acceso con escritura al CVS</a></h3>

<p>
Si ya sabe <a href="$(DEVEL)/website/desc#help">cómo ayudar</a>, y ha proporcionado
suficientes parches aceptados por el equipo web o de traducción, podría obtener acceso de escritura a la página web: solicite por favor unirse al <a href="https://alioth.debian.org/project/request.php?group_id=1135";> proyecto <code>webwml</code> en Alioth</a> 
(tendrá que <a
href="https://alioth.debian.org/account/register.php";>crear una cuenta de Alioth</a> 
si aún no tiene una).
Por favor escriba algo útil en su solicitud, como en qué idioma o qué parte del sitio web
tiene planeado trabajar, y quién respondería por usted.
</p>

signature.asc
Description: OpenPGP digital signature