3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
1 |
======================= |
2 |
Bazaar en cinco minutos |
|
3 |
======================= |
|
4 |
||
5 |
Introducción |
|
6 |
============ |
|
7 |
||
8 |
Bazaar es un sistema de control de versiones distribuido que facilita que |
|
9 |
varias personas puedan trabajar de forma conjunta en proyectos de software. |
|
10 |
||
4853.1.1
by Patrick Regan
Removed trailing whitespace from files in doc directory |
11 |
A lo largo de los próximos cinco minutos, aprenderá cómo poner sus archivos |
12 |
bajo control de versiones, como registrar cambios en ellos, examinar su |
|
13 |
trabajo, publicarlo y enviar su trabajo para que sea integrado en el trunk de |
|
3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
14 |
un proyecto. |
15 |
||
16 |
Si prefiere una introducción más detallada, eche un vistazo a |
|
17 |
`Aprendiendo Más`_. |
|
18 |
||
19 |
||
20 |
Instalación |
|
21 |
=========== |
|
22 |
||
23 |
Esta guía no describe cómo instalar Bazaar pero normalmente es muy |
|
24 |
sencillo. Puede encontrar intrucciones de instalación en: |
|
25 |
||
26 |
- **GNU/Linux:** Bazaar, probablemente, ya esté en su distribución GNU/Linux. |
|
27 |
- **Windows:** `instrucciones de instalación para Windows`_. |
|
28 |
- **Mac OS X:** `instrucciones de instalación para Mac OS X`_. |
|
29 |
||
30 |
Para otras plataformas y para instalar desde el código fuente, vea las |
|
31 |
páginas de Descarga_ e Instalación_. |
|
32 |
||
5050.22.1
by John Arbash Meinel
Lots of documentation updates. |
33 |
.. _instrucciones de instalación para Windows: http://wiki.bazaar.canonical.com/WindowsDownloads |
34 |
.. _instrucciones de instalación para Mac OS X: http://wiki.bazaar.canonical.com/MacOSXBundle |
|
35 |
.. _Descarga: http://wiki.bazaar.canonical.com/Download |
|
36 |
.. _Instalación: http://wiki.bazaar.canonical.com/InstallationFaq |
|
3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
37 |
|
38 |
||
39 |
Preséntese |
|
40 |
========== |
|
41 |
||
4853.1.1
by Patrick Regan
Removed trailing whitespace from files in doc directory |
42 |
Antes de empezar a trabajar, es conveniente que le diga a Bazaar quién es |
43 |
usted. De ese modo su trabajo será identificando correctamente en los logs |
|
3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
44 |
de revisión. |
45 |
||
46 |
Utilice su nombre y dirección de email en lugar de John Doe, teclee:: |
|
47 |
||
48 |
$ bzr whoami "John Doe <john.doe@gmail.com>" |
|
4853.1.1
by Patrick Regan
Removed trailing whitespace from files in doc directory |
49 |
|
3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
50 |
Bazaar creará o modificará ahora un archivo de configuración, incluyendo su |
51 |
nombre y dirección de email. |
|
52 |
||
53 |
Ahora compruebe que su nombre y dirección de email se han registrado correctamente:: |
|
54 |
||
55 |
$ bzr whoami |
|
56 |
John Doe <john.doe@gmail.com> |
|
57 |
||
58 |
||
59 |
Ponga archivos bajo control de versiones |
|
60 |
======================================== |
|
61 |
||
62 |
Vamos a crear un directorio y algunos archivos para utilizar con Bazaar:: |
|
63 |
||
64 |
$ mkdir miproyecto |
|
65 |
$ cd miproyecto |
|
66 |
$ mkdir subdirectorio |
|
67 |
$ touch test1.txt test2.txt test3.txt subdirectorio/test4.txt |
|
4853.1.1
by Patrick Regan
Removed trailing whitespace from files in doc directory |
68 |
|
3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
69 |
**Nota para usuarios de Windows:** utilice Windows Explorer para crear sus |
70 |
directorios, luego haga click derecho en dichos directorios y seleccione |
|
71 |
``Nuevo archivo`` para crear sus archivos. |
|
72 |
||
73 |
Ahora vamos a hacer que Bazaar se inicialize en el directorio de su proyecto:: |
|
74 |
||
75 |
$ bzr init |
|
4853.1.1
by Patrick Regan
Removed trailing whitespace from files in doc directory |
76 |
|
3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
77 |
Si parece que no ha ocurrido nada no se preocupe. Bazaar ha creado un |
78 |
branch_ dónde guardará sus archivos y su histórico de revisiones. |
|
79 |
||
5050.22.1
by John Arbash Meinel
Lots of documentation updates. |
80 |
.. _branch: http://wiki.bazaar.canonical.com/Branch |
3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
81 |
|
82 |
El siguiente paso es decirle a Bazaar a que archivos desea seguirles la pista. |
|
4853.1.1
by Patrick Regan
Removed trailing whitespace from files in doc directory |
83 |
Ejecutando ``bzr add`` agregará recursivamente todos los elementos dentro del |
3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
84 |
proyecto:: |
85 |
||
86 |
$ bzr add |
|
87 |
added subdirectorio |
|
88 |
added test1.txt |
|
89 |
added test2.txt |
|
90 |
added test3.txt |
|
91 |
added subdirectorio/test4.txt |
|
92 |
||
4853.1.1
by Patrick Regan
Removed trailing whitespace from files in doc directory |
93 |
A continuación tome una instantánea de sus archivos agregándolos a su branch. |
3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
94 |
Agregue un mensaje para explicar por qué hace el commit:: |
95 |
||
96 |
$ bzr commit -m "Importación inicial" |
|
4853.1.1
by Patrick Regan
Removed trailing whitespace from files in doc directory |
97 |
|
3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
98 |
Como Bazaar es un sistema de control de versiones distribuido, no necesita |
99 |
conectar con un servidor central para hacer el commit. Bazaar guarda su |
|
100 |
branch y todos sus commits dentro del directorio con el que está trabajando, |
|
101 |
busque el subdirectorio ``.bzr``. |
|
102 |
||
103 |
||
104 |
Haciendo cambios en sus archivos |
|
105 |
================================ |
|
106 |
||
107 |
Vamos a cambiar un archivo e introduzcamos ese cambio en su branch. |
|
108 |
||
109 |
Edite ``test1.txt`` en su editor favorito y luego compruebe qué ha hecho:: |
|
110 |
||
111 |
$ bzr diff |
|
112 |
=== modified file 'test1.txt' |
|
113 |
--- test1.txt 2007-10-08 17:56:14 +0000 |
|
114 |
+++ test1.txt 2007-10-08 17:46:22 +0000 |
|
115 |
@@ -0,0 +1,1 @@ |
|
116 |
+test test test |
|
117 |
||
118 |
Añada su trabajo al branch de Bazaar:: |
|
119 |
||
120 |
$ bzr commit -m "Añadida la primera línea de texto" |
|
121 |
Committed revision 2. |
|
122 |
||
123 |
||
124 |
Viendo el log de revisiones |
|
125 |
=========================== |
|
126 |
||
127 |
Puede ver el histórico de su branch navegando su log:: |
|
128 |
||
129 |
$ bzr log |
|
130 |
------------------------------------------------------------ |
|
131 |
revno: 2 |
|
132 |
committer: John Doe <john.doe@gmail.com> |
|
133 |
branch nick: miproyecto |
|
134 |
timestamp: Mon 2007-10-08 17:56:14 +0000 |
|
135 |
message: |
|
136 |
Añadida la primera línea de texto |
|
137 |
------------------------------------------------------------ |
|
138 |
revno: 1 |
|
139 |
committer: John Doe <john.doe@gmail.com> |
|
140 |
branch nick: miproyecto |
|
141 |
timestamp: Mon 2006-10-08 17:46:22 +0000 |
|
142 |
message: |
|
143 |
Importación inicial |
|
144 |
||
145 |
||
146 |
Publicando su branch con sftp |
|
147 |
============================= |
|
148 |
||
149 |
Hay un par de maneras para publicar su branch. Si ya tiene un servidor |
|
150 |
SFTP o se siente cómodo configurando uno, puede publicar su branch con el. |
|
151 |
||
152 |
Sino salte a la siguiente sección para publicar con Launchpad_, un |
|
153 |
servicio de hosting gratuito para Bazaar. |
|
154 |
||
155 |
.. _Launchpad: https://launchpad.net/ |
|
156 |
||
157 |
Vamos a suponer que desea publicar su branch en ``www.example.com/miproyecto``:: |
|
158 |
||
159 |
$ bzr push --create-prefix sftp://su.nombre@example.com/~/public_html/miproyecto |
|
160 |
2 revision(s) pushed. |
|
4853.1.1
by Patrick Regan
Removed trailing whitespace from files in doc directory |
161 |
|
3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
162 |
Bazaar creará un directorio ``miproyecto`` en el servidor remoto e |
163 |
introducirá su branch en él. |
|
4853.1.1
by Patrick Regan
Removed trailing whitespace from files in doc directory |
164 |
|
3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
165 |
Ahora cualquiera podrá crear su propia copia de su branch tecleando:: |
166 |
||
167 |
$ bzr branch http://www.example.com/miproyecto |
|
4853.1.1
by Patrick Regan
Removed trailing whitespace from files in doc directory |
168 |
|
3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
169 |
**Nota:** para utilizar sftp deberá instalar ``paramiko`` y |
5050.22.1
by John Arbash Meinel
Lots of documentation updates. |
170 |
``pyCrypto``. Vea http://wiki.bazaar.canonical.com/InstallationFaq para más información. |
3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
171 |
|
172 |
||
173 |
Publicando su branch con Launchpad |
|
174 |
================================== |
|
175 |
||
176 |
Launchpad es una suite de herramientas de desarrollo y hosting |
|
177 |
para proyectos de software libre. Puede utilizarlo para publicar su branch. |
|
178 |
||
179 |
Si no dispone de una cuenta de Launchpad, siga la `guia de registro de cuentas`_ |
|
180 |
y `registre una clave SSH`_ en su nueva cuenta de Launchpad. |
|
181 |
||
182 |
.. _guia de registro de cuentas: https://help.launchpad.net/CreatingYourLaunchpadAccount |
|
183 |
.. _registre una clave SSH: https://launchpad.net/people/+me/+editsshkeys |
|
184 |
||
185 |
Cambie ``john.doe`` por su nombre de usuario de Launchpad, teclee:: |
|
186 |
||
187 |
$ bzr push bzr+ssh://john.doe@bazaar.launchpad.net/~john.doe/+junk/miproyecto |
|
188 |
||
4853.1.1
by Patrick Regan
Removed trailing whitespace from files in doc directory |
189 |
**Nota:** ``+junk`` significa que este branch no está asociado con ningún proyecto |
3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
190 |
concreto en Launchpad. |
191 |
||
192 |
Ahora cualquiera podrá crear su propia copia de su branch tecleando:: |
|
193 |
||
194 |
$ bzr branch http://bazaar.launchpad.net/~john.doe/+junk/miproyecto |
|
4853.1.1
by Patrick Regan
Removed trailing whitespace from files in doc directory |
195 |
|
3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
196 |
También puede ver información sobre su branch, histórico de revisiones |
197 |
incluido, en https://code.launchpad.net/people/+me/+junk/miproyecto |
|
198 |
||
199 |
||
200 |
Creando su propia copia de otro branch |
|
201 |
====================================== |
|
202 |
||
203 |
Para trabajar con el código de otra persona, tendrá que hacer su propia |
|
204 |
copia de su branch. Vamos a coger un ejemplo real, la interfaz GTK de Bazaar:: |
|
205 |
||
206 |
$ bzr branch http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk bzr-gtk.john |
|
4853.1.1
by Patrick Regan
Removed trailing whitespace from files in doc directory |
207 |
Branched 292 revision(s). |
3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
208 |
|
209 |
Bazaar descargará todos los archivos y el histórico de revisiones completo |
|
210 |
del trunk branch del proyecto bzr-gtk y creará una copia llamada |
|
211 |
bzr-gtk.john. |
|
212 |
||
213 |
Ahora dispone de su propia copia del branch y puede enviar cambios con |
|
214 |
o sin una conexión de red. Puede compartir su branch en cualquier momento |
|
215 |
publicándola y, si el equipo de bzr-gtk desea utilizar su trabajo, Bazaar |
|
216 |
les facilita integrar su branch dentro de su trunk branch. |
|
217 |
||
218 |
||
219 |
Actualizando su branch desde el branch principal |
|
220 |
================================================ |
|
221 |
||
222 |
Mientras envía cambios a su branch, es probable que otras personas también |
|
223 |
sigan enviando código al branch principal. |
|
224 |
||
225 |
Para asegurarse de que su branch está al dia debería integrar los cambios |
|
226 |
desde el principal dentro de su branch personal:: |
|
227 |
||
228 |
$ bzr merge |
|
3596.3.1
by James Westby
Give the user a bit more information about which saved location is being used. |
229 |
Merging from saved parent location: http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk |
3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
230 |
All changes applied successfully. |
4853.1.1
by Patrick Regan
Removed trailing whitespace from files in doc directory |
231 |
|
3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
232 |
Compruebe qué ha cambiado:: |
233 |
||
234 |
$ bzr diff |
|
4853.1.1
by Patrick Regan
Removed trailing whitespace from files in doc directory |
235 |
|
3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
236 |
Si está contento con los cambios puede añadirlos en su branch personal:: |
237 |
||
238 |
$ bzr commit -m "Integración desde el branch principal" |
|
239 |
Committed revision 295. |
|
240 |
||
241 |
||
242 |
Integrando su trabajo en el branch principal |
|
243 |
============================================ |
|
244 |
||
245 |
Después de haber trabajado en su branch personal de bzr-gtk puede que |
|
246 |
quiera enviar sus cambios de vuelta al proyecto. La manera más fácil |
|
247 |
es utilizando una instrucción merge. |
|
248 |
||
249 |
Una instrucción merge es una petición de lectura mecánica para |
|
250 |
llevar a cabo una integración concreta. Por lo general contiene un |
|
251 |
parche de vista previa de la integración y, o bien contiene las |
|
252 |
revisiones necesarias, o proporciona un branch donde pueden encontrarse. |
|
253 |
||
254 |
Sustituyendo ``mycode.patch``, cree su instrucción merge:: |
|
255 |
||
256 |
$ bzr send -o mycode.patch |
|
3596.3.1
by James Westby
Give the user a bit more information about which saved location is being used. |
257 |
Using saved parent location: http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk |
4853.1.1
by Patrick Regan
Removed trailing whitespace from files in doc directory |
258 |
|
3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
259 |
Ahora puede enviar por email la instruccion merge al proyecto bzr-gtk |
260 |
quien, si así lo quieren, pueden utilizarla para integrar su trabajo |
|
261 |
dentro del branch principal. |
|
4853.1.1
by Patrick Regan
Removed trailing whitespace from files in doc directory |
262 |
|
263 |
||
3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
264 |
Aprendiendo más |
265 |
=============== |
|
266 |
||
267 |
Puede encontrar más sobre Bazaar en la |
|
4488.2.1
by Dmitry Vasiliev
Optimize configuration for build documentation |
268 |
`Guía de Usuario de Bazaar <../user-guide/index.html>`_. |
3405.2.4
by Martin Albisetti
Added mini-tutorial in spanish by Lucio Albenga |
269 |
|
270 |
Para aprender sobre Bazaar por línea de comandos:: |
|
271 |
||
272 |
$ bzr help |
|
273 |
||
274 |
Para aprender sobre comandos de Bazaar:: |
|
275 |
||
276 |
$ bzr help commands |
|
277 |
||
278 |
Para aprender acerca del tema o comando ''foo'':: |
|
279 |
||
280 |
$ bzr help foo |
|
281 |