Tutorial de Mecurial sobre BitBucket Mercurial es un sistema de versionamiento, o sea, cuando se modifica un archivo, se salvarán sólo las

modificaciones del archivo. El sistema necesita un servidor, en nuestro caso el servidor será BitBucket.

Este tutorial explicará en pasos sencillos como:

1) Crear una cuenta de BitBucket

2) Agregar el repositorio de Pop Wuj a mi cuenta de BitBucket

3) Modificar el repositorio de Pop Wuj y aceptar los cambios

4) Rechazar cambios y volver a versión anterior

5) Sincronizar el repositorio de Pop Wuj con mi disco duro local

6) Trucos y limitaciones de Mercurial

Crear una cuenta de BitBucketUna cuenta de BitBucket se crea en https://bitbucket.org/, una vez creada deben mandar un correo a

francisco.guerrero.cr@gmail.com o l3clara@gmail.com con correo o nombre de usuario de BitBucket y ellos le darán acceso al repositorio.

Agregar el repositorio de Pop Wuj a mi cuenta de BitBucketCuando tengan una cuenta de BitBucket y acceso al repositorio deben ingresar a BitBucket y

dirigirse a esta URL

https://bitbucket.org/palantefilms/pop-wuj-3d/zealots

Necesitará presionar el corazón que indica follow (seguir los avances de proyecto)

Cuando se presione mostrará following (siguiendo los avances del proyecto)

Para verificar que se está siguiendo el estado del proyecto se puede presionar Dashboard, ahí se verán los repositorios que se están siguiendo con un corazón.

Luego si se presiona sobre el hipervínculo POP WUJ, o si se ingresa la URL https://bitbucket.org/palantefilms/pop-wuj-3d se irá al Overview del proyecto. En el overview va a venir una dirección URL, similar a https://XXXX@bitbucket.org/palantefilms/pop-wuj-3d . Esa se conoce como la dirección personal del repositorio y es diferente por cada usuario. Esa dirección se ocupará para el siguiente paso

Descargar el repositorio de Pop Wuj a mi disco duro localSe debe instalar tortoise HG

http://tortoisehg.bitbucket.org/download/index.html

Existen versiones para Linux, Windows and MacOS. Los pasos que se indican en este documento son para Windows 7, sin embargo los demás sistemas operativos son similares.

Una vez instalado, se debe crear una carpeta, por ejemplo C:\PopWuj\Mercury, y se presiona click derecho. Luego en TortoiseHg, se debe escoger la opción Clone…

Luego se debe indicar la dirección personal del repositorio en el campo de source y presionar clone

Una vez clonado el repositorio el directorio local deberá tener varios archivos de la siguiente foma

Modificar el repositorio de Pop Wuj y aceptar los cambios

Cuando se trabaja con un repositorio pueden ocurrir 2 casos: Se agrega un nuevo archivo al repositorio o se modifica el un archivo ya agregado.

Cuando se desea agregar un archivo, primero el archivo tiene que estar dentro del folder de mercurial, luego en el archivo se da click derecho, TortoiseHG, Add files.

Cuando se a presionado Add Files, se mostrará un diálogo donde se debe presionar Add para agregar los archivos, luego se debe cerrar el díalogo.

Una vez agregado el archivo, o modificado las carpeta superiores se pondrán en rojo indicando que se deben aceptar los cambios. Esto se logra llegando a la carpeta inicial (Mercury en el ejemplo) y presionar click derecho Hg Commit.

Cuando se a presionado commit, se mostrará un diálogo donde se debe presionar commit para agregar

los archivos, luego se debe cerrar el díalogo. Se debe escribir algo en el commit, de caso contrario TortoiseHg no permitirá que se acepte el cambio.

Rechazar cambios y volver a versión anteriorEn ciertas ocasiones, cuando un cambio no es aceptado, sea porque quebró algún archivo blender, o

simplemente porque se considera la versión anterior mejor que la actual, se debe proceder a rechazar los cambios. Existen 2 formas de rechazar los cambios. La primera, si no se han aceptado los cambios (commit), se puede ir al archivo y presionar click derecho y presionar Revert Files

Al presionar Revert Files, se mostrará un diálogo con los archivos que se quieren rechazar los cambios, al rechazar los cambios el archivo volverá a la última versión aceptada

Existe otro caso, en el que los cambios han sido aceptados y se desea rechazar y volver a la última

versión aceptada, o alguna versión aceptada anterior se debe presionar click derecho sobre el archivo y presionar Revision History

Cuando se presiona Revision History se mostrará un diálogo con todas las versión aceptadas del archivo, aquí se puede escoger la versión deseada

Luego se presiona click derecho sobre la versión deseada y se presiona Revert to this revisión. Al momento saldrá un diálogo de confirmación

Cuando se rechaza un versión aceptada y se vuelve a una anterior, el archivo necesitará volver a aceptarse para que se guarden los cambios a nivel del repositorio (revisar sección anterior, aceptar cambios).

Sincronizar el repositorio de Pop Wuj con mi disco duro localCuando se aceptan o rechazan los cambios, estos son aceptados a nivel local, cada cierto tiempo estos

cambios se deben agregar al servidor de BitBucket. Este proceso se llama Sincronización. Para sincronizar los repositorios se debe ir a la carpeta inicial (Mercury en el ejemplo) y presionar click derecho Hg Workbench.

Cuando se presiona Workbench se mostrará el siguiente diálogo

Inicialmente se recomienda primero descargar los cambios que otros usuario han subido al

repositorio. Esto se logra presionando este botón en el workbench. Cuando todos los cambios han sido descargados, en la parte de abajo del diálogo se mostrará

Una vez descargados las modificaciones del servidor, se deben subir las modificaciones locales. Esto

se logra presionando el botón . Cuando se presiona el botón se mostrará el mensaje de confirmación. Cuando se confirme, se empezará a subir los cambios locales al servidor, luego de unos instantes el sistema indicará que requiere la contraseña para subir los cambios al servidor. La contraseña es la clave de usuario.

. Cuando todos los cambios han sido subidos al servidor, en la parte de abajo del diálogo se mostrar

Trucos y limitaciones de Mercurial Mercurial no permite agregar carpetas, cuando se desee agregar una carpeta, se debe

agregar al menos un archivo. Si se desea agregar una carpeta pero no hay ningún archivo, se puede agregar un archivo vacio llamado “vacio.txt”, que cuando se hayan agregado los archivos requeridos se puede eliminar

En mercurial se pueden borrar o renombrar archivos de la misma manera que se agregan archivos, primero se aceptan los cambios, luego se sincronizan los repositorios.

Se recomienda sincronizar los repositorios en las mañanas y en las tardes para que todos los cambios estén sincronizados con el servidor

Debido a que los archivos generados para POP-WUJ son generalmente binarios (archivos de Blender, GIMP, InkScape, Ardour), si 2 personas modifican el mismo archivo al mismo tiempo, las modificaciones no se podrán mezclar y alguien perdería su avance. Por lo que se requiere que en un momento dado, solo una persona sea el propietario de un

archivo. Mercurial no ofrece la posibilidad de asignarle el propietario a un archivo, por que se recomienda tener una lista de usuarios con los archivos que esta/estará modificando.

Se debe tratar de crear archivos con nombres que tengan letras en inglés unicamente, por lo que se deben eliminar las tildes y la ñ pasa a n.