[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

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

Sin cambios desde el RFR.
Saludos
-- 
Laura Arjona
https://wiki.debian.org/LauraArjona



#use wml::debian::template title="Uso del CVS"
#use wml::debian::translation-check translation="1.28" 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:anonymous@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:anonymous@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:anonymous@anonscm.debian.org:/cvs/webwml checkout -l \\
          webwml webwml/&lt;<var>idioma</var>&gt;
   cvs -d :pserver:anonymous@anonscm.debian.org:/cvs/webwml checkout \\
          webwml/Perl webwml/english/template webwml/&lt;<var>idioma</var>&gt;/Pics
   cvs -d :pserver:anonymous@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:usuario@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>
Por favor no incluya enlaces HTTPS a Debian, DebConf o sitios web de SPI.
Actualmente los certificados de todos esos sitios están firmados por la Autoridad
de Certificación de SPI, en la cual confían las máquinas que usan Debian pero no
los navegadores de otras plataformas, en general. Usar enlaces HTTPS para los sitios
web de debian significa que los visitantes pueden encontrar errores confusos de SSL
en sus navegadores y quejarse a Debian por ello. El repositorio CVS rechazará cambios
que contengan enlaces HTTPS para algunas partes de los sitios web de Debian que se 
conoce que no necesitan SSL.</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>

Attachment: 0x7E4AF4A3.asc
Description: application/pgp-keys

Attachment: signature.asc
Description: OpenPGP digital signature

Reply to: