CONTRIB.fr.md

Contribuer au code source

Contenu

• Prérequis
• Créer sa copie du projet
• Contribuer au code
• Créer un nouveau skin

Prérequis

Les équipes de développement AFI et Biblibre utilisent le sytème de gestion de développement libre GitLab et le système de gestion de version Git. Ce document décrit l'utilisation minimale nécessaire de ces deux outils pour pouvoir contribuer au code des projets maintenus par AFI et Biblibre. Néanmoins nous vous invitons à lire le livre Pro Git.

Nous hébergeons les codes sources des projets sur une instance de GitLab accessible à l'URL https://git.afi-sa.fr. Les projets publics sont accessibles sans compte à l'URL https://git.afi-sa.fr/public.

Créer sa copie du projet

Créer un compte gitlab

Depuis la page Sign Up vous pouvez créer votre compte. Un mail sera automatiqument envoyé pour vous confirmer l'accès.

Cloner le projet

Une fois connecté, depuis la page du project OPACCE, cliquez sur le bouton Fork repository.

Cela vous créera une copie intégrale du projet, accessible publiquement à l'adresse http://git.afi-sa.fr/mon_compte/opacce.

L'accès SSH au dépôt git est donné sur la page d'accueil de votre projet. Par exemple git@git.afi-sa.fr:mon_compte/opacce.git

Installer l'accès SSH

Le poussage de modifications sur gitlab requiert un accès ssh. Sur la page de modification de votre profil, à l'onglet SSH Keys, le lien Add SSH Key permet d'ajouter une clé.

Créer et déclarer sa clé

Si vous posséder déjà une clé sur votre poste de travail dans ~/.ssh/id_rsa.pub, copiez le contenu.

Sinon pour générer une clé SSH sur votre poste de travail, utilisez la commande suivante:

ssh-keygen -t rsa -C "addresse_email@domaine.ext"

et pour afficher le contenu: