diff options
Diffstat (limited to 'doc/es/mini-tutorial/index.txt')
-rw-r--r-- | doc/es/mini-tutorial/index.txt | 281 |
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 + |