summaryrefslogtreecommitdiff
path: root/doc/es/mini-tutorial/index.txt
diff options
context:
space:
mode:
Diffstat (limited to 'doc/es/mini-tutorial/index.txt')
-rw-r--r--doc/es/mini-tutorial/index.txt281
1 files changed, 281 insertions, 0 deletions
diff --git a/doc/es/mini-tutorial/index.txt b/doc/es/mini-tutorial/index.txt
new file mode 100644
index 0000000..35106bd
--- /dev/null
+++ b/doc/es/mini-tutorial/index.txt
@@ -0,0 +1,281 @@
+=======================
+Bazaar en cinco minutos
+=======================
+
+Introducción
+============
+
+Bazaar es un sistema de control de versiones distribuido que facilita que
+varias personas puedan trabajar de forma conjunta en proyectos de software.
+
+A lo largo de los próximos cinco minutos, aprenderá cómo poner sus archivos
+bajo control de versiones, como registrar cambios en ellos, examinar su
+trabajo, publicarlo y enviar su trabajo para que sea integrado en el trunk de
+un proyecto.
+
+Si prefiere una introducción más detallada, eche un vistazo a
+`Aprendiendo Más`_.
+
+
+Instalación
+===========
+
+Esta guía no describe cómo instalar Bazaar pero normalmente es muy
+sencillo. Puede encontrar intrucciones de instalación en:
+
+- **GNU/Linux:** Bazaar, probablemente, ya esté en su distribución GNU/Linux.
+- **Windows:** `instrucciones de instalación para Windows`_.
+- **Mac OS X:** `instrucciones de instalación para Mac OS X`_.
+
+Para otras plataformas y para instalar desde el código fuente, vea las
+páginas de Descarga_ e Instalación_.
+
+.. _instrucciones de instalación para Windows: http://wiki.bazaar.canonical.com/WindowsDownloads
+.. _instrucciones de instalación para Mac OS X: http://wiki.bazaar.canonical.com/MacOSXBundle
+.. _Descarga: http://wiki.bazaar.canonical.com/Download
+.. _Instalación: http://wiki.bazaar.canonical.com/InstallationFaq
+
+
+Preséntese
+==========
+
+Antes de empezar a trabajar, es conveniente que le diga a Bazaar quién es
+usted. De ese modo su trabajo será identificando correctamente en los logs
+de revisión.
+
+Utilice su nombre y dirección de email en lugar de John Doe, teclee::
+
+ $ bzr whoami "John Doe <john.doe@gmail.com>"
+
+Bazaar creará o modificará ahora un archivo de configuración, incluyendo su
+nombre y dirección de email.
+
+Ahora compruebe que su nombre y dirección de email se han registrado correctamente::
+
+ $ bzr whoami
+ John Doe <john.doe@gmail.com>
+
+
+Ponga archivos bajo control de versiones
+========================================
+
+Vamos a crear un directorio y algunos archivos para utilizar con Bazaar::
+
+ $ mkdir miproyecto
+ $ cd miproyecto
+ $ mkdir subdirectorio
+ $ touch test1.txt test2.txt test3.txt subdirectorio/test4.txt
+
+**Nota para usuarios de Windows:** utilice Windows Explorer para crear sus
+directorios, luego haga click derecho en dichos directorios y seleccione
+``Nuevo archivo`` para crear sus archivos.
+
+Ahora vamos a hacer que Bazaar se inicialize en el directorio de su proyecto::
+
+ $ bzr init
+
+Si parece que no ha ocurrido nada no se preocupe. Bazaar ha creado un
+branch_ dónde guardará sus archivos y su histórico de revisiones.
+
+.. _branch: http://wiki.bazaar.canonical.com/Branch
+
+El siguiente paso es decirle a Bazaar a que archivos desea seguirles la pista.
+Ejecutando ``bzr add`` agregará recursivamente todos los elementos dentro del
+proyecto::
+
+ $ bzr add
+ added subdirectorio
+ added test1.txt
+ added test2.txt
+ added test3.txt
+ added subdirectorio/test4.txt
+
+A continuación tome una instantánea de sus archivos agregándolos a su branch.
+Agregue un mensaje para explicar por qué hace el commit::
+
+ $ bzr commit -m "Importación inicial"
+
+Como Bazaar es un sistema de control de versiones distribuido, no necesita
+conectar con un servidor central para hacer el commit. Bazaar guarda su
+branch y todos sus commits dentro del directorio con el que está trabajando,
+busque el subdirectorio ``.bzr``.
+
+
+Haciendo cambios en sus archivos
+================================
+
+Vamos a cambiar un archivo e introduzcamos ese cambio en su branch.
+
+Edite ``test1.txt`` en su editor favorito y luego compruebe qué ha hecho::
+
+ $ bzr diff
+ === modified file 'test1.txt'
+ --- test1.txt 2007-10-08 17:56:14 +0000
+ +++ test1.txt 2007-10-08 17:46:22 +0000
+ @@ -0,0 +1,1 @@
+ +test test test
+
+Añada su trabajo al branch de Bazaar::
+
+ $ bzr commit -m "Añadida la primera línea de texto"
+ Committed revision 2.
+
+
+Viendo el log de revisiones
+===========================
+
+Puede ver el histórico de su branch navegando su log::
+
+ $ bzr log
+ ------------------------------------------------------------
+ revno: 2
+ committer: John Doe <john.doe@gmail.com>
+ branch nick: miproyecto
+ timestamp: Mon 2007-10-08 17:56:14 +0000
+ message:
+ Añadida la primera línea de texto
+ ------------------------------------------------------------
+ revno: 1
+ committer: John Doe <john.doe@gmail.com>
+ branch nick: miproyecto
+ timestamp: Mon 2006-10-08 17:46:22 +0000
+ message:
+ Importación inicial
+
+
+Publicando su branch con SFTP
+=============================
+
+Hay un par de maneras para publicar su branch. Si ya tiene un servidor
+SFTP o se siente cómodo configurando uno, puede publicar su branch con el.
+
+Sino salte a la siguiente sección para publicar con Launchpad_, un
+servicio de hosting gratuito para Bazaar.
+
+.. _Launchpad: https://launchpad.net/
+
+Vamos a suponer que desea publicar su branch en ``www.example.com/miproyecto``::
+
+ $ bzr push --create-prefix sftp://su.nombre@example.com/~/public_html/miproyecto
+ 2 revision(s) pushed.
+
+Bazaar creará un directorio ``miproyecto`` en el servidor remoto e
+introducirá su branch en él.
+
+Ahora cualquiera podrá crear su propia copia de su branch tecleando::
+
+ $ bzr branch http://www.example.com/miproyecto
+
+**Nota:** para utilizar SFTP deberá instalar ``paramiko`` y
+``pyCrypto``. Vea http://wiki.bazaar.canonical.com/InstallationFaq para más información.
+
+
+Publicando su branch con Launchpad
+==================================
+
+Launchpad es una suite de herramientas de desarrollo y hosting
+para proyectos de software libre. Puede utilizarlo para publicar su branch.
+
+Si no dispone de una cuenta de Launchpad, siga la `guia de registro de cuentas`_
+y `registre una clave SSH`_ en su nueva cuenta de Launchpad.
+
+.. _guia de registro de cuentas: https://help.launchpad.net/CreatingYourLaunchpadAccount
+.. _registre una clave SSH: https://launchpad.net/people/+me/+editsshkeys
+
+Cambie ``john.doe`` por su nombre de usuario de Launchpad, teclee::
+
+ $ bzr push bzr+ssh://john.doe@bazaar.launchpad.net/~john.doe/+junk/miproyecto
+
+**Nota:** ``+junk`` significa que este branch no está asociado con ningún proyecto
+concreto en Launchpad.
+
+Ahora cualquiera podrá crear su propia copia de su branch tecleando::
+
+ $ bzr branch http://bazaar.launchpad.net/~john.doe/+junk/miproyecto
+
+También puede ver información sobre su branch, histórico de revisiones
+incluido, en https://code.launchpad.net/people/+me/+junk/miproyecto
+
+
+Creando su propia copia de otro branch
+======================================
+
+Para trabajar con el código de otra persona, tendrá que hacer su propia
+copia de su branch. Vamos a coger un ejemplo real, la interfaz GTK de Bazaar::
+
+ $ bzr branch http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk bzr-gtk.john
+ Branched 292 revision(s).
+
+Bazaar descargará todos los archivos y el histórico de revisiones completo
+del trunk branch del proyecto bzr-gtk y creará una copia llamada
+bzr-gtk.john.
+
+Ahora dispone de su propia copia del branch y puede enviar cambios con
+o sin una conexión de red. Puede compartir su branch en cualquier momento
+publicándola y, si el equipo de bzr-gtk desea utilizar su trabajo, Bazaar
+les facilita integrar su branch dentro de su trunk branch.
+
+
+Actualizando su branch desde el branch principal
+================================================
+
+Mientras envía cambios a su branch, es probable que otras personas también
+sigan enviando código al branch principal.
+
+Para asegurarse de que su branch está al dia debería integrar los cambios
+desde el principal dentro de su branch personal::
+
+ $ bzr merge
+ Merging from saved parent location: http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk
+ All changes applied successfully.
+
+Compruebe qué ha cambiado::
+
+ $ bzr diff
+
+Si está contento con los cambios puede añadirlos en su branch personal::
+
+ $ bzr commit -m "Integración desde el branch principal"
+ Committed revision 295.
+
+
+Integrando su trabajo en el branch principal
+============================================
+
+Después de haber trabajado en su branch personal de bzr-gtk puede que
+quiera enviar sus cambios de vuelta al proyecto. La manera más fácil
+es utilizando una instrucción merge.
+
+Una instrucción merge es una petición de lectura mecánica para
+llevar a cabo una integración concreta. Por lo general contiene un
+parche de vista previa de la integración y, o bien contiene las
+revisiones necesarias, o proporciona un branch donde pueden encontrarse.
+
+Sustituyendo ``mycode.patch``, cree su instrucción merge::
+
+ $ bzr send -o mycode.patch
+ Using saved parent location: http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk
+
+Ahora puede enviar por email la instruccion merge al proyecto bzr-gtk
+quien, si así lo quieren, pueden utilizarla para integrar su trabajo
+dentro del branch principal.
+
+
+Aprendiendo más
+===============
+
+Puede encontrar más sobre Bazaar en la
+`Guía de Usuario de Bazaar <../user-guide/index.html>`_.
+
+Para aprender sobre Bazaar por línea de comandos::
+
+ $ bzr help
+
+Para aprender sobre comandos de Bazaar::
+
+ $ bzr help commands
+
+Para aprender acerca del tema o comando ''foo''::
+
+ $ bzr help foo
+