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

De Analyse Développement Hacking
Sauter à la navigation Sauter à la recherche
Naviguer dans ce wiki : Accueil du wiki - Objectifs - Administrateur - Bureautique - Développeur - Intégrateur - Marketing - Multimédia - Objets numériques - Jeux - We make Hack
Consulter le site : Accueil du site - Annuaire - Blog - Forum - Outils - Utilisateur     Consulter le Redmine : Accueil du Redmine

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

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

Vous êtes sur le wiki de Vision du Web.
Les pages présentées sur le wiki évoluent tous les jours.
Certaines recherches sont peu abouties et incluent des erreurs.
Pour participer sur le wiki, créer un compte utilisateur en haut à droite.
La recherche interne du wiki permet de trouver le contenu qui vous intéresse.
Les informations présentes sur ce wiki sont issues d'une recherche personnelle.
Identifiez-vous pour poser vos questions sur la page de discussion de VisionDuWeb.
Améliorer le contenu des pages en faisant des propositions depuis l'onglet discussion.
Les informations du wiki ne doivent pas servir à nuire à autrui ou à un système informatique.
De nombreux outils gratuits sont listés et disponibles dans la boîte à outils de Vision du web.
D'autres pages du wiki peuvent correspondre à vos attentes. La liste de toutes les pages du wiki.

VALORISER LE WIKI

Valoriser le contenu partagé sur 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 :
Gagner des Altcoins - Miner des Altcoins.
Consulter le miroir du wiki depuis Planet Hoster : Le miroir du wiki version du 12 Juillet 2019.