Requisitos previos para el desarrollo

Esta página le ayudará a configurar un sistema Trisquel listo para ayudar en el desarrollo del proyecto Trisquel.

Cree una cuenta en GitLab

• Antes de poder empezar a hackear la base de código de Triquel, tendrás que crear una cuenta para Trisquel's GitLab

Configure GitLab

• Una vez que has activado tu cuenta de GitLab, hay algunos ajustes iniciales que deben ajustarse.

Subiendo tu clave SSH

• Este paso facilita mucho la entrada y extracción de código desde GitLab.
• Si aún no tienes una clave pública, crear una es muy sencillo. Abre un terminal y escribe lo siguiente:

   $ ssh-keygen 
  

• Esto creará una clave pública que se encuentra en ~/.ssh/id_rsa.pub
• Copia la clave pública a tu portapapeles ejecutando el siguiente comando en un terminal y copiando la salida.

   $ cat ~/.ssh/id_rsa.pub 
  

• En GitLab selecciona Configuración de perfil -> 'Claves SSH -> Añadir clave SSH'''
• Asigna un título a tu nueva clave y pega la clave en el archivo que se proporcione.

Bifurcar los Repositorios

El desarrollo de Trisquel se desarrolla en tres repositorios.

• makeiso
• package-helpers
• trisquel-packages

Haz un fork de cada uno de estos repositorios y aparecerán en tu perfil de GitLab.

Instala el software necesario

• Instalar git y otros programas necesarios ejecutando el comando:

$ sudo apt-get install git devscripts reprepro quilt

Configure Git

• Documentación oficial: Git - Primera Configuración de Git

• Configurar tu identidad para Git

$ git config --global user.name "John Doe"
$ git config --global user.email johndoe@example.com

Clona los Repositorios de GitLab en tu máquina local

Navega a la carpeta en tu máquina local donde quieres guardar todos los archivos de desarrollo y clona los repositorios de gitlab en estas carpetas locales. Asegúrate de cambiar $username por tu nombre de usuario real.

$ git clone ssh://git@devel.trisquel.info:10022/$username/package-helpers.git
$ git clone ssh://git@devel.trisquel.info:10022/$username/trisquel-packages.git
$ git clone ssh://git@devel.trisquel.info:10022/$username/makeiso.git

=Establecer repositorios aguas arriba

El flujo de trabajo general de git consiste en hacer cambios localmente en tu propio entorno de desarrollo y luego enviar estos cambios a los repositorios aguas arriba. La mejor práctica es trabajar siempre desde el código upstream más actualizado. Para facilitar este proceso, puedes configurar repositorios remotos aguas arriba. Querrás hacer este paso desde cada repositorio específico. Por ejemplo, si estamos configurando el repositorio upstream para los package-helpers;

$ cd /path/to/your/dev/package-helpers 
$ git remote add upstream ssh://git@devel.trisquel.info:10022/trisquel/package-helpers.git

Puedes confirmar que este paso funcionó ejecutando el siguiente comando; deberías ver aquí tanto tus repositorios locales como los aguas arriba.

$ git remote -v 

Querrás repetir estos pasos para cada uno de los otros repositorios con los que vayas a trabajar.

Fusión aguas arriba

Antes de hacer cualquier cambio en tu código, asegúrate de tener el código más reciente en tu máquina local.

$ git fetch upstream 
$ git checkout belenos 
$ git rebase upstream/belenos

Hackear y empujar cambios

Ahora que tienes código actualizado, busca un problema, ve a trabajar en él y, cuando estés satisfecho con tus cambios, publica tus cambios.

$ git checkout belenos -b <your-branch-name>
$ cd helpers #hack, hack, hack
$ bash make-0  #test that the dsc build works
$ git add <your-changed-files>
$ git commit
$ git push origin <your-branch-name>

Solicitud de fusión

Una vez que hayas enviado tu código de trabajo y quieras que se incluya en el proyecto Trisquel, puedes enviar una solicitud de fusión desde la interfaz de GitLab.

Recuerda seleccionar como rama de origen la que empujaste, y como rama remota, el nombre de la versión trisquel (belenos, toutatis, taranis), no enviar solicitudes de fusión a la rama principal de los paquetes helpers.