~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2010-02-01 13:53:24 UTC
  • mfrom: (4990.1.2 rm-obsolete)
  • Revision ID: pqm@pqm.ubuntu.com-20100201135324-cuhuolr97guf5xjp
(Jelmer) Remove obsolete (and broken) biobench and history2revfiles
        tools.

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