3. Créer et gérer un dépôt distant sur Github

1. Créer un nouveau dépôt

Aller sur github, authentifiez-vous. Cliquez sur le bouton vert New Ajouter un nom au repo(sitory)

Apporter une description (c’est surtout pour soi)

On n’a pas besoin ici d’un repo privé, laissez-le public (il l’est par défaut et ce statut peut être changé dès qu’on le souhaite dans les paramètres).

Pour des raisons de clarté (pour autrui), il est nécessaire d’avoir un fichier README (le plus souvent écrit en d’où son extension en .md), mais on le générera une autre fois, laisser comme ça (sans README généré au moment de la création) Pareil pour le fichier .gitignore ; le fichier .gitignore est la liste (actuellement vide) de tous les fichiers qui potentiellement doivent rester en local et ne doivent pas être envoyés vers la forge. Pareil pour la licence, c’est important pour permettre à autrui de savoir comment utiliser/réutiliser le contenu du repository (notamment dans un cadre de Science Ouverte), mais on peut la rajouter plus tard et ici nous n’avons pas prévu que notre pizza soit réutilisée par autrui.

2. Charger des fichiers vers un remote dans une forge

On va connecter le repo en ligne qu’on vient de créer (donc le au repo en local (notre dossier Git) Pour faire ce lien, depuis le terminal, entrer la commande suivante :

$ git remote add origin git@github.com:damienbelveze/pizza.git

Si on a déjà un commit prêt dans son dossier local, il est prêt à être envoyé vers la forge. origin fait référence au remote (voir commande ci-dessus)

git push -u origin main # pousse les documents vers la branche main du remote ("origin", la branche destinataire du remote est connectée à "main")

éventuellement la première fois qu’on fait un en direction du repo, on est amené à entrer cette commande supplémentaire. C’est le cas si le dossier local contient plusieurs branches.

$ git push --set-upstream origin main

le lien entre le répertoire local et la forge va s’établir.

Rafraîchir la page d’accueil du répertoire sur la forge : les fichiers créés en local vont apparaître dans la page d’accueil du projet.

3. utiliser la forge pour éditer du texte

On va maintenant ajouter un README au dépôt cliquer sur le bouton “add README”. entrer une phrase.

Revenir sur le répertoire local. Pour récupérer depuis le remote le README qu’on vient d’écrire, on va faire un pull :

$ git pull

Voilà ! on a envoyé de l’info créée en local vers Github et de façon circulaire on a créé de l’info sur Github qu’on a rapatriée en local. La boucle est blouclée. Veillez à faire un git pull en local pour rapatrier le contenu d’un commit réalisé directement sur la forge. Sinon si vous faites un git push cela va introduire un conflit de versions entre le remote et le repo en local qu’il faudra réduire comme on l’a vu.

Si vous oubliez de passer cette commande git pull après avoir fait un commit en ligne et que vous tentez un git pushen local ; une erreur survient. Pour enregistrer vos modifications réalisées en local, passez la commande git stash. Faites ensuite un git pull, puis un nouveau commit et enfin un push.

# 3. Créer et gérer un dépôt distant sur Github ## 1. Créer un nouveau dépôt Aller sur github, authentifiez-vous. Cliquez sur le bouton vert *New* Ajouter un nom au repo(sitory) ![](images/github_new_repo.png) Apporter une description (c'est surtout pour soi) On n'a pas besoin ici d'un repo privé, laissez-le public (il l'est par défaut et ce statut peut être changé dès qu'on le souhaite dans les paramètres). Pour des raisons de clarté (pour autrui), il est nécessaire d'avoir un fichier README (le plus souvent écrit en {{< glossary markdown >}} d'où son extension en .md), mais on le générera une autre fois, laisser comme ça (sans README généré au moment de la création) Pareil pour le fichier .gitignore ; le fichier .gitignore est la liste (actuellement vide) de tous les fichiers qui potentiellement doivent rester en local et ne doivent pas être envoyés vers la forge. Pareil pour la licence, c'est important pour permettre à autrui de savoir comment utiliser/réutiliser le contenu du repository (notamment dans un cadre de Science Ouverte), mais on peut la rajouter plus tard et ici nous n'avons pas prévu que notre pizza soit réutilisée par autrui. ## 2. Charger des fichiers vers un remote dans une forge On va connecter le repo en ligne qu'on vient de créer (donc le {{< glossary remote >}} au repo en local (notre dossier Git) Pour faire ce lien, depuis le terminal, entrer la commande suivante : ```bash $ git remote add origin git@github.com:damienbelveze/pizza.git ``` Si on a déjà un *commit* prêt dans son dossier local, il est prêt à être envoyé vers la forge. *origin* fait référence au remote (voir commande ci-dessus) ```bash git push -u origin main # pousse les documents vers la branche main du remote ("origin", la branche destinataire du remote est connectée à "main") ``` éventuellement la première fois qu'on fait un {{< glossary commit >}} en direction du repo, on est amené à entrer cette commande supplémentaire. C'est le cas si le dossier local contient plusieurs branches. ```bash $ git push --set-upstream origin main ``` le lien entre le répertoire local et la forge va s'établir. Rafraîchir la page d'accueil du répertoire sur la forge : les fichiers créés en local vont apparaître dans la page d'accueil du projet. ## 3. utiliser la forge pour éditer du texte On va maintenant ajouter un README au dépôt cliquer sur le bouton "add README". entrer une phrase. Revenir sur le répertoire local. Pour récupérer depuis le remote le README qu'on vient d'écrire, on va faire un *pull* : ```bash $ git pull ``` Voilà ! on a envoyé de l'info créée en local vers Github et de façon circulaire on a créé de l'info sur Github qu'on a rapatriée en local. La boucle est blouclée. Veillez à faire un ``git pull`` en local pour rapatrier le contenu d'un commit réalisé directement sur la forge. Sinon si vous faites un ``git push`` cela va introduire un conflit de versions entre le remote et le repo en local qu'il faudra réduire comme on l'a vu. Si vous oubliez de passer cette commande ``git pull`` après avoir fait un commit en ligne et que vous tentez un ``git push``en local ; une erreur survient. Pour enregistrer vos modifications réalisées en local, passez la commande ``git stash``. Faites ensuite un ``git pull``, puis un nouveau commit et enfin un push.