<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="es"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>Bazaar en cinco minutos — documentación de Bazaar - 2.7.0</title> <link rel="stylesheet" href="../_static/classic.css" type="text/css" /> <link rel="stylesheet" href="../_static/pygments.css" type="text/css" /> <script type="text/javascript"> var DOCUMENTATION_OPTIONS = { URL_ROOT: '../', VERSION: '2.7.0', COLLAPSE_INDEX: false, FILE_SUFFIX: '.html', HAS_SOURCE: true }; </script> <script type="text/javascript" src="../_static/jquery.js"></script> <script type="text/javascript" src="../_static/underscore.js"></script> <script type="text/javascript" src="../_static/doctools.js"></script> <script type="text/javascript" src="../_static/translations.js"></script> <link rel="shortcut icon" href="../_static/bzr.ico"/> <link rel="search" title="Búsqueda" href="../search.html" /> <link rel="top" title="documentación de Bazaar - 2.7.0" href="../index.html" /> <link rel="next" title="Referencia Rapida" href="../quick-reference/index.html" /> <link rel="prev" title="Indice de Documentacion de Bazaar" href="../index.html" /> </head> <body role="document"> <div class="related" role="navigation" aria-label="related navigation"> <h3>Navegación</h3> <ul> <li class="right" style="margin-right: 10px"> <a href="../quick-reference/index.html" title="Referencia Rapida" accesskey="N">siguiente</a></li> <li class="right" > <a href="../index.html" title="Indice de Documentacion de Bazaar" accesskey="P">anterior</a> |</li> <li><a href="http://bazaar.canonical.com/"> <img src="../_static/bzr icon 16.png" /> Inicio</a> | </li> <a href="http://doc.bazaar.canonical.com/">Documentación</a> | </li> <li class="nav-item nav-item-0"><a href="../index.html">Contenidos (2.7.0)</a> »</li> </ul> </div> <div class="document"> <div class="documentwrapper"> <div class="bodywrapper"> <div class="body" role="main"> <div class="section" id="bazaar-en-cinco-minutos"> <h1>Bazaar en cinco minutos<a class="headerlink" href="#bazaar-en-cinco-minutos" title="Enlazar permanentemente con este título">¶</a></h1> <div class="section" id="introduccion"> <h2>Introducción<a class="headerlink" href="#introduccion" title="Enlazar permanentemente con este título">¶</a></h2> <p>Bazaar es un sistema de control de versiones distribuido que facilita que varias personas puedan trabajar de forma conjunta en proyectos de software.</p> <p>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.</p> <p>Si prefiere una introducción más detallada, eche un vistazo a <a class="reference internal" href="#aprendiendo-mas">Aprendiendo Más</a>.</p> </div> <div class="section" id="instalacion"> <h2>Instalación<a class="headerlink" href="#instalacion" title="Enlazar permanentemente con este título">¶</a></h2> <p>Esta guía no describe cómo instalar Bazaar pero normalmente es muy sencillo. Puede encontrar intrucciones de instalación en:</p> <ul class="simple"> <li><strong>GNU/Linux:</strong> Bazaar, probablemente, ya esté en su distribución GNU/Linux.</li> <li><strong>Windows:</strong> <a class="reference external" href="http://wiki.bazaar.canonical.com/WindowsDownloads">instrucciones de instalación para Windows</a>.</li> <li><strong>Mac OS X:</strong> <a class="reference external" href="http://wiki.bazaar.canonical.com/MacOSXBundle">instrucciones de instalación para Mac OS X</a>.</li> </ul> <p>Para otras plataformas y para instalar desde el código fuente, vea las páginas de <a class="reference external" href="http://wiki.bazaar.canonical.com/Download">Descarga</a> e <a class="reference external" href="http://wiki.bazaar.canonical.com/InstallationFaq">Instalación</a>.</p> </div> <div class="section" id="presentese"> <h2>Preséntese<a class="headerlink" href="#presentese" title="Enlazar permanentemente con este título">¶</a></h2> <p>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.</p> <p>Utilice su nombre y dirección de email en lugar de John Doe, teclee:</p> <div class="highlight-default"><div class="highlight"><pre><span></span>$ bzr whoami "John Doe <john.doe@gmail.com>" </pre></div> </div> <p>Bazaar creará o modificará ahora un archivo de configuración, incluyendo su nombre y dirección de email.</p> <p>Ahora compruebe que su nombre y dirección de email se han registrado correctamente:</p> <div class="highlight-default"><div class="highlight"><pre><span></span>$ bzr whoami John Doe <john.doe@gmail.com> </pre></div> </div> </div> <div class="section" id="ponga-archivos-bajo-control-de-versiones"> <h2>Ponga archivos bajo control de versiones<a class="headerlink" href="#ponga-archivos-bajo-control-de-versiones" title="Enlazar permanentemente con este título">¶</a></h2> <p>Vamos a crear un directorio y algunos archivos para utilizar con Bazaar:</p> <div class="highlight-default"><div class="highlight"><pre><span></span>$ mkdir miproyecto $ cd miproyecto $ mkdir subdirectorio $ touch test1.txt test2.txt test3.txt subdirectorio/test4.txt </pre></div> </div> <p><strong>Nota para usuarios de Windows:</strong> utilice Windows Explorer para crear sus directorios, luego haga click derecho en dichos directorios y seleccione <code class="docutils literal"><span class="pre">Nuevo</span> <span class="pre">archivo</span></code> para crear sus archivos.</p> <p>Ahora vamos a hacer que Bazaar se inicialize en el directorio de su proyecto:</p> <div class="highlight-default"><div class="highlight"><pre><span></span>$ bzr init </pre></div> </div> <p>Si parece que no ha ocurrido nada no se preocupe. Bazaar ha creado un <a class="reference external" href="http://wiki.bazaar.canonical.com/Branch">branch</a> dónde guardará sus archivos y su histórico de revisiones.</p> <p>El siguiente paso es decirle a Bazaar a que archivos desea seguirles la pista. Ejecutando <code class="docutils literal"><span class="pre">bzr</span> <span class="pre">add</span></code> agregará recursivamente todos los elementos dentro del proyecto:</p> <div class="highlight-default"><div class="highlight"><pre><span></span>$ bzr add added subdirectorio added test1.txt added test2.txt added test3.txt added subdirectorio/test4.txt </pre></div> </div> <p>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:</p> <div class="highlight-default"><div class="highlight"><pre><span></span>$ bzr commit -m "Importación inicial" </pre></div> </div> <p>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 <code class="docutils literal"><span class="pre">.bzr</span></code>.</p> </div> <div class="section" id="haciendo-cambios-en-sus-archivos"> <h2>Haciendo cambios en sus archivos<a class="headerlink" href="#haciendo-cambios-en-sus-archivos" title="Enlazar permanentemente con este título">¶</a></h2> <p>Vamos a cambiar un archivo e introduzcamos ese cambio en su branch.</p> <p>Edite <code class="docutils literal"><span class="pre">test1.txt</span></code> en su editor favorito y luego compruebe qué ha hecho:</p> <div class="highlight-default"><div class="highlight"><pre><span></span>$ 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 </pre></div> </div> <p>Añada su trabajo al branch de Bazaar:</p> <div class="highlight-default"><div class="highlight"><pre><span></span>$ bzr commit -m "Añadida la primera línea de texto" Committed revision 2. </pre></div> </div> </div> <div class="section" id="viendo-el-log-de-revisiones"> <h2>Viendo el log de revisiones<a class="headerlink" href="#viendo-el-log-de-revisiones" title="Enlazar permanentemente con este título">¶</a></h2> <p>Puede ver el histórico de su branch navegando su log:</p> <div class="highlight-default"><div class="highlight"><pre><span></span>$ 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 </pre></div> </div> </div> <div class="section" id="publicando-su-branch-con-sftp"> <h2>Publicando su branch con SFTP<a class="headerlink" href="#publicando-su-branch-con-sftp" title="Enlazar permanentemente con este título">¶</a></h2> <p>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.</p> <p>Sino salte a la siguiente sección para publicar con <a class="reference external" href="https://launchpad.net/">Launchpad</a>, un servicio de hosting gratuito para Bazaar.</p> <p>Vamos a suponer que desea publicar su branch en <code class="docutils literal"><span class="pre">www.example.com/miproyecto</span></code>:</p> <div class="highlight-default"><div class="highlight"><pre><span></span>$ bzr push --create-prefix sftp://su.nombre@example.com/~/public_html/miproyecto 2 revision(s) pushed. </pre></div> </div> <p>Bazaar creará un directorio <code class="docutils literal"><span class="pre">miproyecto</span></code> en el servidor remoto e introducirá su branch en él.</p> <p>Ahora cualquiera podrá crear su propia copia de su branch tecleando:</p> <div class="highlight-default"><div class="highlight"><pre><span></span>$ bzr branch http://www.example.com/miproyecto </pre></div> </div> <p><strong>Nota:</strong> para utilizar SFTP deberá instalar <code class="docutils literal"><span class="pre">paramiko</span></code> y <code class="docutils literal"><span class="pre">pyCrypto</span></code>. Vea <a class="reference external" href="http://wiki.bazaar.canonical.com/InstallationFaq">http://wiki.bazaar.canonical.com/InstallationFaq</a> para más información.</p> </div> <div class="section" id="publicando-su-branch-con-launchpad"> <h2>Publicando su branch con Launchpad<a class="headerlink" href="#publicando-su-branch-con-launchpad" title="Enlazar permanentemente con este título">¶</a></h2> <p>Launchpad es una suite de herramientas de desarrollo y hosting para proyectos de software libre. Puede utilizarlo para publicar su branch.</p> <p>Si no dispone de una cuenta de Launchpad, siga la <a class="reference external" href="https://help.launchpad.net/CreatingYourLaunchpadAccount">guia de registro de cuentas</a> y <a class="reference external" href="https://launchpad.net/people/+me/+editsshkeys">registre una clave SSH</a> en su nueva cuenta de Launchpad.</p> <p>Cambie <code class="docutils literal"><span class="pre">john.doe</span></code> por su nombre de usuario de Launchpad, teclee:</p> <div class="highlight-default"><div class="highlight"><pre><span></span>$ bzr push bzr+ssh://john.doe@bazaar.launchpad.net/~john.doe/+junk/miproyecto </pre></div> </div> <p><strong>Nota:</strong> <code class="docutils literal"><span class="pre">+junk</span></code> significa que este branch no está asociado con ningún proyecto concreto en Launchpad.</p> <p>Ahora cualquiera podrá crear su propia copia de su branch tecleando:</p> <div class="highlight-default"><div class="highlight"><pre><span></span>$ bzr branch http://bazaar.launchpad.net/~john.doe/+junk/miproyecto </pre></div> </div> <p>También puede ver información sobre su branch, histórico de revisiones incluido, en <a class="reference external" href="https://code.launchpad.net/people/+me/+junk/miproyecto">https://code.launchpad.net/people/+me/+junk/miproyecto</a></p> </div> <div class="section" id="creando-su-propia-copia-de-otro-branch"> <h2>Creando su propia copia de otro branch<a class="headerlink" href="#creando-su-propia-copia-de-otro-branch" title="Enlazar permanentemente con este título">¶</a></h2> <p>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:</p> <div class="highlight-default"><div class="highlight"><pre><span></span>$ bzr branch http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk bzr-gtk.john Branched 292 revision(s). </pre></div> </div> <p>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.</p> <p>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.</p> </div> <div class="section" id="actualizando-su-branch-desde-el-branch-principal"> <h2>Actualizando su branch desde el branch principal<a class="headerlink" href="#actualizando-su-branch-desde-el-branch-principal" title="Enlazar permanentemente con este título">¶</a></h2> <p>Mientras envía cambios a su branch, es probable que otras personas también sigan enviando código al branch principal.</p> <p>Para asegurarse de que su branch está al dia debería integrar los cambios desde el principal dentro de su branch personal:</p> <div class="highlight-default"><div class="highlight"><pre><span></span>$ bzr merge Merging from saved parent location: http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk All changes applied successfully. </pre></div> </div> <p>Compruebe qué ha cambiado:</p> <div class="highlight-default"><div class="highlight"><pre><span></span>$ bzr diff </pre></div> </div> <p>Si está contento con los cambios puede añadirlos en su branch personal:</p> <div class="highlight-default"><div class="highlight"><pre><span></span>$ bzr commit -m "Integración desde el branch principal" Committed revision 295. </pre></div> </div> </div> <div class="section" id="integrando-su-trabajo-en-el-branch-principal"> <h2>Integrando su trabajo en el branch principal<a class="headerlink" href="#integrando-su-trabajo-en-el-branch-principal" title="Enlazar permanentemente con este título">¶</a></h2> <p>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.</p> <p>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.</p> <p>Sustituyendo <code class="docutils literal"><span class="pre">mycode.patch</span></code>, cree su instrucción merge:</p> <div class="highlight-default"><div class="highlight"><pre><span></span>$ bzr send -o mycode.patch Using saved parent location: http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk </pre></div> </div> <p>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.</p> </div> <div class="section" id="aprendiendo-mas"> <h2>Aprendiendo más<a class="headerlink" href="#aprendiendo-mas" title="Enlazar permanentemente con este título">¶</a></h2> <p>Puede encontrar más sobre Bazaar en la <a class="reference external" href="../user-guide/index.html">Guía de Usuario de Bazaar</a>.</p> <p>Para aprender sobre Bazaar por línea de comandos:</p> <div class="highlight-default"><div class="highlight"><pre><span></span>$ bzr help </pre></div> </div> <p>Para aprender sobre comandos de Bazaar:</p> <div class="highlight-default"><div class="highlight"><pre><span></span>$ bzr help commands </pre></div> </div> <p>Para aprender acerca del tema o comando ‘’foo’‘:</p> <div class="highlight-default"><div class="highlight"><pre><span></span>$ bzr help foo </pre></div> </div> </div> </div> </div> </div> </div> <div class="sphinxsidebar" role="navigation" aria-label="main navigation"> <div class="sphinxsidebarwrapper"> <h3><a href="../index.html">Tabla de Contenidos</a></h3> <ul> <li><a class="reference internal" href="#">Bazaar en cinco minutos</a><ul> <li><a class="reference internal" href="#introduccion">Introducción</a></li> <li><a class="reference internal" href="#instalacion">Instalación</a></li> <li><a class="reference internal" href="#presentese">Preséntese</a></li> <li><a class="reference internal" href="#ponga-archivos-bajo-control-de-versiones">Ponga archivos bajo control de versiones</a></li> <li><a class="reference internal" href="#haciendo-cambios-en-sus-archivos">Haciendo cambios en sus archivos</a></li> <li><a class="reference internal" href="#viendo-el-log-de-revisiones">Viendo el log de revisiones</a></li> <li><a class="reference internal" href="#publicando-su-branch-con-sftp">Publicando su branch con SFTP</a></li> <li><a class="reference internal" href="#publicando-su-branch-con-launchpad">Publicando su branch con Launchpad</a></li> <li><a class="reference internal" href="#creando-su-propia-copia-de-otro-branch">Creando su propia copia de otro branch</a></li> <li><a class="reference internal" href="#actualizando-su-branch-desde-el-branch-principal">Actualizando su branch desde el branch principal</a></li> <li><a class="reference internal" href="#integrando-su-trabajo-en-el-branch-principal">Integrando su trabajo en el branch principal</a></li> <li><a class="reference internal" href="#aprendiendo-mas">Aprendiendo más</a></li> </ul> </li> </ul> <h4>Tema anterior</h4> <p class="topless"><a href="../index.html" title="capítulo anterior">Indice de Documentacion de Bazaar</a></p> <h4>Próximo tema</h4> <p class="topless"><a href="../quick-reference/index.html" title="próximo capítulo">Referencia Rapida</a></p> <div role="note" aria-label="source link"> <h3>Esta página</h3> <ul class="this-page-menu"> <li><a href="../_sources/mini-tutorial/index.txt" rel="nofollow">Mostrar el código</a></li> </ul> </div> <div id="searchbox" style="display: none" role="search"> <h3>Búsqueda rápida</h3> <form class="search" action="../search.html" method="get"> <div><input type="text" name="q" /></div> <div><input type="submit" value="Ir a" /></div> <input type="hidden" name="check_keywords" value="yes" /> <input type="hidden" name="area" value="default" /> </form> </div> <script type="text/javascript">$('#searchbox').show(0);</script> </div> </div> <div class="clearer"></div> </div> <div class="related" role="navigation" aria-label="related navigation"> <h3>Navegación</h3> <ul> <li class="right" style="margin-right: 10px"> <a href="../quick-reference/index.html" title="Referencia Rapida" >siguiente</a></li> <li class="right" > <a href="../index.html" title="Indice de Documentacion de Bazaar" >anterior</a> |</li> <li><a href="http://bazaar.canonical.com/"> <img src="../_static/bzr icon 16.png" /> Inicio</a> | </li> <a href="http://doc.bazaar.canonical.com/">Documentación</a> | </li> <li class="nav-item nav-item-0"><a href="../index.html">Contenidos (2.7.0)</a> »</li> </ul> </div> <div class="footer" role="contentinfo"> © Copyright 2009-2011 Canonical Ltd. Creado con <a href="http://sphinx-doc.org/">Sphinx</a> 1.4.9. </div> </body> </html>