Cómo usar el repositorio mercurial de Mozilla Hispano
De Mozilla Hispano - Documentación
Los proyectos de Mozilla Hispano están alojados en un repositorio Mercurial, en esta página se explica brevemente cómo descargar y enviar código al mismo, para una explicación más detallada sobre Mercurial visita el documento al respecto en el Mozilla Developer Center.
Índice de contenido |
[editar] Descargar código
Para poder descargar código del repositorio mercurial de Mozilla Hispano sólo necesitas un cliente de mercurial. Basaremos nuestro ejemplo en cómo descargar el código de la extensión tuentifox, por lo que la url a usar será http://hg.mozilla-hispano.org/tuentifox
[editar] Windows
Con el cliente TortoiseHG podreis clonar, actualizar y enviar al repositorio.
[editar] GNU/Linux
Deberemos tener instalado el paquete hg de los repositorios de nuestra distribución.
[editar] Manualmente
Para descargar la primera copia ejecutaremos:
hg clone http://hg.mozilla-hispano.org/tuentifox
Para actualizarla, estando dentro del directorio del repositorio, ejecutaremos:
hg pull
[editar] Gráficamente
En Linux hay una versión de tortoise para manejar los cambios gráficamente. En lauchpad hay un repositorio para distros basadas en debian:
https://launchpad.net/~gpoo/+archive
Una vez instalado solo hay que ejecutar:
hgtk clone
Nos parecerá una ventana para elegir desde dónde y a qué carpeta guardarlo
Para ver la ventana que nos permitirá actualizar la copia local o enviar nuestros cambios, os podéis crear en vuestro directorio bin un script para gestionarlo, lo llamamos mercurial y le damos permisos de ejecución:
#!/bin/bash
#Asignamos el directorio donde tengamos las carpetas con los repositorios mercurial DIR=/home/nuke/Desarrollo/Extensiones
#Abrimos para gestionar el nombre del repositorio que le pasemos cd $DIR/$1 hgtk commit & hgtk synch
Ahora podremos gestionar todos los repositorios que tengamos simplemente ejecutando:
mercurial nombredelrepositorio
nos mostrará dos ventanas, una aceptar los cambios locales llamada commit, elegiremos los archivos de los que aceptar los cambios y pulsaremos en commit. Y otra para sincronizar la copia con el repositorio pulsando el botón push.
[editar] Enviar código
En el caso de que quieras enviar tu código para que se añada a la aplicación tienes dos formas de hacerlo.
[editar] Crear un fork
La opción más sencilla es que desde la web del repositorio entres al proyecto que te interese modificar, pulses sobre fork y así crees tu propia rama privada a la que podrás hacer todos los cambios que quieras. Recuerda que la url para descargar y enviar datos será diferente a la del proyecto original.
Una vez creas conveniente, de nuevo desde la web del proyecto podrás usar la opción pull request para pedir a los desarrolladores de la rama principal integren todos los cambios que has hecho.
[editar] Participar en la rama principal
Puedes pedir acceso de escritura para el proyecto principal desde el foro de desarrollo. Y una vez tu cuenta tenga permisos podrás enviar directamente código.
[editar] Windows
Usaremos la misma utilidad (tortoisegh) que para descargar.
[editar] GNU/Linux
Podemos usar el script que creamos anteriormente para hacerlo de forma gráfica o manualmente:
cd tuentifox # Actualizaremos lo que queramos en los archivos y lo aplicamos al repositorio local hg commit -m "cambios realizados" #Verificamos el estado hg status #Enviamos el código hg push
Si tienes cualquier duda con este proceso no dudes en preguntar en el foro de desarrollo.
[editar] Informar de errores o proponer mejoras
Si el proyecto en cuestión tiene habilitado el sistema de incidencias, podrás avisar de errores (bug), de mejoras (enhacement) o propuestas (proposal) en la pestaña Issues del repositorio del proyecto en cuestión.
