~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/es/mini-tutorial/index.txt

- improved handling of non-ascii branch names and test
  patch from Joel Rosdahl

Show diffs side-by-side

added added

removed removed

Lines of Context:
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
 
 
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
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
 
 
33
 
.. _instrucciones de instalación para Windows: http://bazaar-vcs.org/WindowsDownloads
34
 
.. _instrucciones de instalación para Mac OS X: http://bazaar-vcs.org/MacOSXBundle
35
 
.. _Descarga: http://bazaar-vcs.org/Download
36
 
.. _Instalación: http://bazaar-vcs.org/InstallationFaq
37
 
 
38
 
 
39
 
Preséntese
40
 
==========
41
 
 
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
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>"
49
 
 
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
68
 
 
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
76
 
 
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
 
 
80
 
.. _branch: http://bazaar-vcs.org/Branch
81
 
 
82
 
El siguiente paso es decirle a Bazaar a que archivos desea seguirles la pista.
83
 
Ejecutando ``bzr add`` agregará recursivamente todos los elementos dentro del
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
 
 
93
 
A continuación tome una instantánea de sus archivos agregándolos a su branch.
94
 
Agregue un mensaje para explicar por qué hace el commit::
95
 
 
96
 
  $ bzr commit -m "Importación inicial"
97
 
 
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.
161
 
 
162
 
Bazaar creará un directorio ``miproyecto`` en el servidor remoto e
163
 
introducirá su branch en él.
164
 
 
165
 
Ahora cualquiera podrá crear su propia copia de su branch tecleando::
166
 
 
167
 
 $ bzr branch http://www.example.com/miproyecto
168
 
 
169
 
**Nota:** para utilizar sftp deberá instalar ``paramiko`` y
170
 
``pyCrypto``. Vea http://bazaar-vcs.org/InstallationFaq para más información.
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
 
 
189
 
**Nota:** ``+junk`` significa que este branch no está asociado con ningún proyecto
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
195
 
 
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
207
 
  Branched 292 revision(s).
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
229
 
  Merging from saved parent location: http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk
230
 
  All changes applied successfully.
231
 
 
232
 
Compruebe qué ha cambiado::
233
 
 
234
 
  $ bzr diff
235
 
 
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
257
 
 Using saved parent location: http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk
258
 
 
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.
262
 
 
263
 
 
264
 
Aprendiendo más
265
 
===============
266
 
 
267
 
Puede encontrar más sobre Bazaar en la
268
 
`Guía de Usuario de Bazaar <../user-guide/index.html>`_.
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