Tutorial de Mecurial sobre BitBucket
Mercurial es un sistema de versionamiento, o sea, cuando se modifica un archivo, se salvarn slo 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 ) !"re"ar el repositorio de #op $u% a mi cuenta de BitBucket &) Modificar el repositorio de #op $u% ' aceptar los cam(ios )) *echa+ar cam(ios ' volver a versin anterior ,) -incroni+ar el repositorio de #op $u% con mi disco duro local .) /rucos ' limitaciones de Mercurial
Crear una cuenta de BitBucket
0na cuenta de BitBucket se crea en https:11(it([Link]"1, una ve+ creada de(en mandar un correo a francisco."uerrero.cr2"[Link] o l&clara2"[Link] con correo o nom(re de usuario de BitBucket ' ellos le darn acceso al repositorio.
Agregar el repositorio de Pop Wuj a mi cuenta de BitBucket
Cuando ten"an una cuenta de BitBucket ' acceso al repositorio de(en in"resar a BitBucket ' diri"irse a esta 0*3 [Link] 4ecesitar presionar el cora+n 5ue indica follo6 7se"uir los avances de pro'ecto)
Cuando se presione mostrar follo6in" 7si"uiendo los avances del pro'ecto)
#ara verificar 5ue se est si"uiendo el estado del pro'ecto se puede presionar 8ash(oard, ah9 se vern los repositorios 5ue se estn si"uiendo con un cora+n.
3ue"o si se presiona so(re el hiperv9nculo #:# $0;, o si se in"resa la 0*3 https:11(it([Link]"1palantefilms1pop<6u%<&d se ir al :vervie6 del pro'ecto. En el overvie6 va a venir una direccin 0*3, similar a https:11====2(it([Link]"1palantefilms1pop<6u%<&d . Esa se conoce como la direccin personal del repositorio ' es diferente por cada usuario. Esa direccin se ocupar para el si"uiente paso
Descargar el repositorio de Pop Wuj a mi disco duro local
-e de(e instalar tortoise >? http:11tortoiseh".(it([Link]"[Link] Existen versiones para 3inux, $indo6s and Mac:-. 3os pasos 5ue se indican en este documento son para $indo6s @, sin em(ar"o los dems sistemas operativos son similares. 0na ve+ instalado, se de(e crear una carpeta, por e%emplo C:A#op$u%AMercur', ' se presiona click derecho. 3ue"o en /ortoise>", se de(e esco"er la opcin CloneB
3ue"o se de(e indicar la direccin personal del repositorio en el campo de source ' presionar clone
0na ve+ clonado el repositorio el directorio local de(er tener varios archivos de la si"uiente foma
Modificar el repositorio de Pop Wuj y aceptar los cambios
Cuando se tra(a%a con un repositorio pueden ocurrir repositorio o se modifica el un archivo 'a a"re"ado. casos: -e a"re"a un nuevo archivo al
Cuando se desea a"re"ar un archivo, primero el archivo tiene 5ue estar dentro del folder de mercurial, lue"o en el archivo se da click derecho, /ortoise>?, !dd files.
Cuando se a presionado !dd Ciles, se mostrar un dilo"o donde se de(e presionar !dd para a"re"ar los archivos, lue"o se de(e cerrar el d9alo"o.
0na ve+ a"re"ado el archivo, o modificado las carpeta superiores se pondrn en ro%o indicando 5ue se de(en aceptar los cam(ios. Esto se lo"ra lle"ando a la carpeta inicial 7Mercur' en el e%emplo) ' presionar click derecho >" Commit.
Cuando se a presionado commit, se mostrar un dilo"o donde se de(e presionar commit para a"re"ar los archivos, lue"o se de(e cerrar el d9alo"o. -e de(e escri(ir al"o en el commit, de caso contrario /ortoise>" no permitir 5ue se acepte el cam(io.
Rechazar cambios y ol er a ersi!n anterior
En ciertas ocasiones, cuando un cam(io no es aceptado, sea por5ue 5ue(r al"Dn archivo (lender, o simplemente por5ue se considera la versin anterior me%or 5ue la actual, se de(e proceder a recha+ar los cam(ios. Existen formas de recha+ar los cam(ios. 3a primera, si no se han aceptado los cam(ios 7commit), se puede ir al archivo ' presionar click derecho ' presionar *evert Ciles
!l presionar *evert Ciles, se mostrar un dilo"o con los archivos 5ue se 5uieren recha+ar los cam(ios, al recha+ar los cam(ios el archivo volver a la Dltima versin aceptada
Existe otro caso, en el 5ue los cam(ios han sido aceptados ' se desea recha+ar ' volver a la Dltima versin aceptada, o al"una versin aceptada anterior se de(e presionar click derecho so(re el archivo ' presionar *evision >istor'
Cuando se presiona *evision >istor' se mostrar un dilo"o con todas las versin aceptadas del archivo, a5u9 se puede esco"er la versin deseada
3ue"o se presiona click derecho so(re la versin deseada ' se presiona *evert to this revisin. !l momento saldr un dilo"o de confirmacin
Cuando se recha+a un versin aceptada ' se vuelve a una anterior, el archivo necesitar volver a aceptarse para 5ue se "uarden los cam(ios a nivel del repositorio 7revisar seccin anterior, aceptar cam(ios).
"incronizar el repositorio de Pop Wuj con mi disco duro local
Cuando se aceptan o recha+an los cam(ios, estos son aceptados a nivel local, cada cierto tiempo estos cam(ios se de(en a"re"ar al servidor de BitBucket. Este proceso se llama -incroni+acin. #ara sincroni+ar los repositorios se de(e ir a la carpeta inicial 7Mercur' en el e%emplo) ' presionar click derecho >" $ork(ench.
Cuando se presiona $ork(ench se mostrar el si"uiente dilo"o
Enicialmente se recomienda primero descar"ar los cam(ios 5ue otros usuario han su(ido al repositorio. Esto se lo"ra presionando este (otn en el 6ork(ench. Cuando todos los cam(ios han sido descar"ados, en la parte de a(a%o del dilo"o se mostrar
0na ve+ descar"ados las modificaciones del servidor, se de(en su(ir las modificaciones locales. Esto se lo"ra presionando el (otn . Cuando se presiona el (otn se mostrar el mensa%e de confirmacin. Cuando se confirme, se empe+ar a su(ir los cam(ios locales al servidor, lue"o de unos instantes el sistema indicar 5ue re5uiere la contraseFa para su(ir los cam(ios al servidor. 3a contraseFa es la clave de usuario.
. Cuando todos los cam(ios han sido su(idos al servidor, en la parte de a(a%o del dilo"o se mostrar
#rucos y limitaciones de Mercurial
Mercurial no permite a"re"ar carpetas, cuando se desee a"re"ar una carpeta, se de(e a"re"ar al menos un archivo. -i se desea a"re"ar una carpeta pero no ha' nin"Dn archivo, se puede a"re"ar un archivo vacio llamado [Link], 5ue cuando se ha'an a"re"ado los archivos re5ueridos se puede eliminar En mercurial se pueden (orrar o renom(rar archivos de la misma manera 5ue se a"re"an archivos, primero se aceptan los cam(ios, lue"o se sincroni+an los repositorios. -e recomienda sincroni+ar los repositorios en las maFanas ' en las tardes para 5ue todos los cam(ios estIn sincroni+ados con el servidor 8e(ido a 5ue los archivos "enerados para #:#<$0; son "eneralmente (inarios 7archivos de Blender, ?EM#, Enk-cape, !rdour), si personas modifican el mismo archivo al mismo tiempo, las modificaciones no se podrn me+clar ' al"uien perder9a su avance.
#or lo 5ue se re5uiere 5ue en un momento dado, solo una persona sea el propietario de un archivo. Mercurial no ofrece la posi(ilidad de asi"narle el propietario a un archivo, por 5ue se recomienda tener una lista de usuarios con los archivos 5ue esta1estar modificando. -e de(e tratar de crear archivos con nom(res 5ue ten"an letras en in"lIs unicamente, por lo 5ue se de(en eliminar las tildes ' la F pasa a n.