Le dépôt officiel du code source des Gilets Jaunes

Le wiki : Accueil - Administrateur - Bureautique - Développeur - Intégrateur - Marketing - Multimédia - Objets numériques - Jeux - We make Hack

Accueil

Participer à l'amélioration du code dans un projet

Créer votre compte utilisateur sur l'outil de dépôt des Gilets Jaunes

L'adresse officielle du serveur de dépôt Gilets Jaunes est la suivante : https://gj-c.fr:3080.
Enregistrer son compte utilisateur depuis le lien suivant : https://gj-c.fr:3080/user/sign_up.

Consulter les projets mis à disposition

Les projets officiels sont mis à disposition par l'utilisateur giletjaune : https://gj-c.fr:3080/giletjaune.

Créer la copie d'un projet sur le dépôt Gilets Jaunes vers votre espace utilisateur

Depuis le projet de votre choix, cliquer sur le bouton Bifurcation en haut à droite.
Une copie du projet officiel est placée dans les projets de votre utilisateur.

Récupérer le code d'un projet sur sa machine personnelle

Installer le programme Git sur votre système d'exploitation :
- Linux
- Mac
- Windows

Faire une recherche sur un moteur de recherche pour trouver un tutoriel qui explique comment installer Git.

Récupérer le code depuis un système d'exploitation Linux

Créer un dossier qui va accueillir vos différents projets Git, par exemple, créer le dossier MesProjetsCollaboratifs.

**En mode graphique** :
Se Placer dans votre dossier utilisateur.
Clic droit, créer un dossier nommé MesProjetsCollaboratifs.

**Depuis un terminal** :
cd $HOME
mkdir MesProjetsCollaboratifs

Depuis la page du projet partagé sur le dépôt des Gilets Jaunes, se positionner sur l'onglet code.
Identifier le lien qui permet de cloner le projet qui se trouve au dessus à droite de l'ensemble des dossiers et fichiers du projet.
Pour le projet portailgj le lien qui va servir a cloner le code est https://gj-c.fr:3080/giletjaune/portailgj.git

Ouvrir un terminal depuis votre machine et se positionner dans le dossier MesProjetsCollaboratifs.
cd $HOME/MesProjetsCollaboratifs

Cloner le projet.
git clone https://gj-c.fr:3080/giletjaune/portailgj.git

Récupérer le code depuis un système d'exploitation Mac

Utiliser un tutoriel pour Mac.

Récupérer le code depuis un système d'exploitation Windows

Utiliser un tutoriel pour Windows.

Contribuer au développement et à la maintenance du code source

Vous pouvez bifurquer ou cloner le dépôt officiel pour ajouter vos améliorations sur votre copie personnelle du dépôt.
Il est indispensable d'être collaborateur du projet pour pouvoir déposer vos modifications sur le dépôt officiel.
Pour être ajouté aux collaborateurs du projet, vous pouvez adresser votre demande en créant un nouveau ticket.
Vous pouvez également adresser votre demande sur le salon DiscordApp : https://discord.gg/Z5B5gqS.

Depuis un projet qui a été bifurqué vers votre espace utilisateur

Éditer un fichier, le modifier puis enregistrer la modification après avoir rédigé une description pour décrire vos améliorations.
Cliquer sur l'onglet Demandes d'ajout, Nouvelle demande d'ajout.
Proposer l'ajout de vos modifications, et, indiquer la encore une description pour décrire les améliorations proposées.

Depuis le projet cloné sur votre machine Linux

Ouvrir un terminal depuis votre machine et se positionner dans le dossier MesProjetsCollaboratifs.
Se positionner ensuite dans le dossier du projet, ici, portailgj.
cd $HOME/MesProjetsCollaboratifs/portailgj

Avant d'apporter une contribution, toujours vérifier que les fichiers copiés dans votre projet sont à jour avec le dépôt officiel.
Récupérer la dernière versions des fichiers du projet, pour la branche master.
git pull origin master

Les améliorations peuvent maintenant être effectuées en local sur le code source d'un projet dupliqué et bien mis à jour.
Ajouter de nouveaux fichiers dans le projet de travail local, proposer des améliorations du code source en local.

Faire remonter les modifications en local vers le projet officiel distant, sur le dépôt des Gilets Jaunes :
Prendre en compte les modifications.
git add .

Commenter la proposition d'amélioration.
git commit -m "Ajout d'un commentaire dans le nomdufichier.ext pour rendre compréhensible le code source du projet Gilets Jaunes."

Appliquer le changement vers le dépôt officiel.
git push origin master

Nous avons ici récupéré le dépôt officiel et travaillé en local sur la branche master.
Les propositions d'améliorations ont été effectuées vers la branche master du dépôt officiel Gilets Jaunes.
Pour éviter de compliquer le travail des développeurs, il est recommandé de créer une branche pour chaque nouvel apport.

Créer une branche

Créer une branche sur le dépôt officiel

Pour créer une branche sur le dépôt officiel, vous devez être collaborateur du projet.
Vous pouvez tout de même créer une branche sur votre dépôt personnel.
Cliquer sur Branche: master.
Dans le champ du formulaire "Filtrer une branche ou un tag", indiquer le nom de la branche que vous souhaitez créer.
Si le nom de branche proposée n'existe pas, l'outil Gitea proposera la création de la branche.

Créer une branche sur le dépôt de votre machine Linux

Ouvrir un terminal depuis votre machine et se positionner dans le dossier MesProjetsCollaboratifs.
Se positionner ensuite dans le dossier du projet, ici, portailgj.
cd $HOME/MesProjetsCollaboratifs/portailgj

Créer par exemple une branche commenter-le-code depuis le dossier contenant le projet en local.
git branch commenter-le-code

Se position sur la branche commenter-le-code
git checkout commenter-le-code

Ajouter la nouvelle branche dans le dépôt officiel Gilets Jaunes.
git push origin commenter-le-code

Le nom d'utilisateur et le mot de passe de votre compte sont nécessaires pour valider cette action vers le projet officiel.
Username for 'https://gj-c.fr:3080':
Password for 'https://Zer00CooL@gj-c.fr:3080': Votre_Mot_De_Passe_Utilisateur

L'erreur suivante indique que vous n'avez pas été ajouté dans le projet en tant que collaborateur.
Username for 'https://gj-c.fr:3080': Zer00CooL
Password for 'https://Zer00CooL@gj-c.fr:3080': 
remote: User permission denied
fatal: unable to access 'https://gj-c.fr:3080/giletjaune/portailgj.git/': The requested URL returned error: 403

Une fois que votre compte aura été ajouté au projet en tant que collaborateur, vous pourrez ajouter votre branche au projet.
git push origin commenter-le-code

Username for 'https://gj-c.fr:3080': Zer00CooL
Password for 'https://Zer00CooL@gj-c.fr:3080': Votre_Mot_De_Passe_Utilisateur
Total 0 (delta 0), reused 0 (delta 0)
remote: 
remote: Create a new pull request for 'commenter-le-code':
remote:   https://gj-c.fr:3080/giletjaune/portailgj/compare/master...commenter-le-code
remote: 
To https://gj-c.fr:3080/giletjaune/portailgj.git
 * [new branch]      commenter-le-code -> commenter-le-code

La nouvelle branche commenter-le-code a été créée.

Changer de branche

##################################
# Ne pas se tromper de branche ! #
##################################

Connaître les branches existantes. L'étoile indique la branche utilisée :
git branch
* commenter-le-code
  master

Connaître les branches existantes et l'étoile indique la branche utilisée, ainsi que le commentaire du dernier commit :
git branch -v
* commenter-le-code 3594383 config clés secrètes dans _db_ident.php
  master 3594383 config clés secrètes dans _db_ident.php

Revenir à la branche master :
git checkout master

Revenir à la branche commenter-le-code :
git checkout commenter-le-code

Proposer une amélioration dans le dépôt officiel du projet

Ouvrir un terminal depuis votre machine et se positionner dans le dossier MesProjetsCollaboratifs.
Se positionner ensuite dans le dossier du projet, ici, portailgj.
cd $HOME/MesProjetsCollaboratifs/portailgj

Se positionner sur la branche correspondante à votre travail, ici, la branche utilisée est : commenter-le-code
git checkout commenter-le-code

Modifier maintenant les fichiers sources que vous avez à disposition sur votre machine.
L'objectif de la branche commenter-le-code est de décrire les fonctionnalités du code source existant.
Les propositions peuvent être ajoutées vers le dépôt officiel Gilets Jaunes, sur la branche commenter-le-code du projet.

Prendre en compte toutes les modifications effectuées sur les fichiers en local pour les ajouter au projet officiel.
git add .

Ajouter une description pour faciliter la relecture de l'historique.
git commit -m "Propositions de commentaires pour le fichier nom_du_fichier.ext."

Ajouter vos modifications vers le dépôt officiel des Gilets Jaunes, sur la branche commenter-le-code du projet.
git push origin commenter-le-code

Renseigner le nom d'utilisateur utilisé sur le dépôt officiel des Gilets Jaunes.
Le nom d'utilisateur et le mot de passe de votre compte sont nécessaires pour valider cette action vers le projet officiel.
Username for 'https://gj-c.fr:3080': Zer00CooL
Password for 'https://Zer00CooL@gj-c.fr:3080': Votre_Mot_De_Passe_Utilisateur

Les fichiers proposés sont maintenant présents sur le dépôt officiel, dans la branche commenter-le-code.

Supprimer une branche

De préférence, ne pas se positionner sur la branche qui va être supprimée.
Supprimer une branche locale sur votre machine.
git branch -d ma_branche_test

Supprimer une branche distante sur le dépôt officiel des Gilets Jaunes.
git push origin :ma_branche_test

Améliorer l'affichage des branches dans votre terminal Linux

Afficher la branche git courante en couleur.

Régler un conflit de code avec merge

Il est important de récupérer la dernière version du code officiel comme présenté plus haut, avec la commande pull.
Il est préférable de toujours déposer vos améliorations immédiatement pour ne pas risquer des conflits de versions.
En cas de difficultés avec Git ou avec le code du projet, créer un ticket ou demander de l'aide sur Discord.

NAVIGATION

PARTICIPER ET PARTAGER Bienvenue sur le wiki de Amis SH. De nombreuses pages sont partagées sur ce wiki. Créer un compte utilisateur pour participer sur le wiki. Les pages présentées sur le wiki évoluent tous les jours. Certaines recherches sont peu abouties et incluent des erreurs. Utiliser la recherche interne du wiki pour trouver votre contenu. La page de discussion de Amis SH vous permet de poser vos questions. Consulter le site amis-sh.fr pour installer votre propre serveur web. Améliorer le contenu des pages avec vos retours depuis l'onglet discussion. Ce contenu ne doit pas servir à nuire à autrui ou à un système informatique. Protéger votre système Linux ou Windows avec cette page dédiée à la sécurité.

SOUTENIR CE WIKI Soutenir le wiki avec un don en monnaie numérique : AEON - Bitcoins - Bitcoins Cash - Bitcoins Gold - Bitcore - Blackcoins - Basic Attention Token - Bytecoins - Clams - Dash - Monero - Dogecoins - Ğ1 - Ethereum - Ethereum Classique - Litecoins - Potcoins - Solarcoins - Zcash OBTENIR DE LA MONNAIE NUMERIQUE Obtenir gratuitement de la monnaie numérique : Miner de la cryptomonnaie.