Contribuer au Répertoire#

Version facile, en ligne dans GitLab#

Rendez-vous sur la page du projet du Répertoire fantastique sur GitLab et cliquez le bouton Web IDE.

Faites vos changements puis cliquez Create commit.

Laissez Create a new branch et, optionnellement donnez un nom à cette branche en plus d’un message de commit plus évocateur. Cliquez Commit.

Pour une nouvelle branche, complétez la création de la merge request (MR) avec le bouton bleu Create merge request en bas. De l’écran d’une merge request, vous pouvez toujours accéder au Web IDE avec le bouton Code et au site composé de vos contribution avec le bouton View latest app.

Quand vous avez fini, faites signe pour qu’on fusionne sur la branche principale.

Version simple, au terminal#

Ouvrez un terminal et entrez les commandes

python --version
git --version

Si le résultat ressemble à un numéro de version, bravo! et passez à l’étape suivante.

Sinon, assurez-vous d’avoir bien installé Git et Python ou recommencez.

Récupérez le code sur votre ordinateur et placez-vous sur une branche

git clone git@gitlab.com:cblegaregroup/labz/repertoirefantastique.git
cd repertoirefantastique
git checkout -b objet-de-ma-contribution

Installez Nox, prenez connaissance des sessions existantes et vous êtes prêt.

pip install nox
nox --list-sessions

Modifiez les fichiers sans crainte, inspectez les fichiers obtenus avec nox, et envoyez régulièrement votre contenu sur le serveur:

git add -A
git commit -m "Court résumé de ma sauvegarde"
git push

Lisez attentivement les messages que git vous renvoie, ils sont souvent utiles. Par exemple, si git vous renvoie un message du serveur distant vous suggérant de créer une merge request (MR), considérez obtempérer et cliquer sur le lien.

Version populaire, avec VS Code#

Installez Visual Studio Code (VSCode) et ouvrez-le. Suivez les instruction pour ouvrir un répertoire d’un dépôt cloné (Cloner un dépôt) en utilisant l’URL Git appropriée, par exemple

https://gitlab.com/cblegaregroup/labz/repertoirefantastique.git

Si vous n’arrivez pas à faire faire ce que vous voulez à VSCode, ouvrez son terminal (menu Affichage puis Terminal) et essayez Version simple, au terminal.

Version charmante, avec PyCharm#

Installez PyCharm et ouvrez-le. Suivez les instructions pour ouvrir un projet d’un gestionnaire de source (Get from VCS) en utilisant l’URL Git appropriée, par exemple

https://gitlab.com/cblegaregroup/labz/repertoirefantastique.git

Si vous n’arrivez pas à faire faire ce que vous voulez à PyCharm, ouvrez son terminal (onglet Terminal en bas) et essayez Version simple, au terminal.

Version procrastination, créer un ticket#

Un peu perdu? Besoin d’information? Créez un ticket dan le système de suivi.

Créer un ticket

Ne vous souciez que des champs Title et Description.