====== Démarrer sur Gitea ======

==  Ajout de la clé ssh dans Gitea ==


== Générer une clé ==
 <code | download>
`ssh-keygen -t rsa -b 4096 -C "your_email@example.com"`

</code>
== Enregistrer la clé dans Gitea ==

Aller dans "paramètres" en haut a droite de la fenêtre principale du dépôt Gitea.

Sur la gauche 2ème section en partant du bas "clé de déploiement" 

  * contenu -> coller la clé ssh 
  * Activer l'accès en écriture 
  * Ajouter une clé de déploiement 

===== Configuration et opérations en local =====

== Créer un dossier de travail ==

<code | download>
cd xx/xx/xx |`mkdir agedei`
</code>
== Initialiser git ==

<code | download>
`git init`
</code>

== Pour lier git et le dépôt gitea ==


Enregistrer son nom d'utilisateur
<code | download>
git config --global user.name= "mon nom"
</code>

Enregistrer son adresse électronique
<code | download>
git config --global user.email= "mon adresse électronique"
</code>

On clone le dépôt distant

<code | download>
git clone gitea@latortue.ynh.fr:orlane/agedei.git
</code> 
vers un répertoire spécifique (pour qu'il ne créé pas un nouveau répertoire dans le répertoire créé
<code | download>
git clone gitea@latortue.ynh.fr:orlane/agedei.git <chemin du répertoire>
</code> 

On relie le dépôt local au dépôt distant

<code | download>
`git remote add origin https://latortue.ynh.fr/git/orlane/agedei.git`
</code>
== On vérifie que le dossier local correspond au dossier distant ==

<code | download>
`git checkout nom_de_la_branche`
</code>


== Premier commmit ==
 
<code | download>
`git commit -m "test`"
</code>


====== Créer une nouvelle branche ======

=== Sur Gitea  ===
 
en haut a gauche de de la fenêtre principale du dépôt
main/voir toutes les branches
branche par défaut 
->main 
premier icône au bout de la ligne a droite 
créé une nouvelles branche a partir de main 

lié la branche local a la branche distante
<code | download>
`git push --set-upstream origin nom_de_votre_branche`
</code>

=== Ou en local et en ligne de commande ===

Créer une branche et basculer directemment dessus
<code | download>
git checkout -b nouvelle-branche
</code>

====== Procédure Mise à jour de fichier et transmission à Gitea ======
== 
Commandes générales ==


<code | download>
`git status`
</code>  git vérifie si le dépôt local correspond à son indexation et donne les fichiers à ajouter à son index

<code | download>
`git add <chemin et nom du fichier donné par git>`
</code>  __ou__  <code | download>
`git add -A`
</code> pour ajouter tous les fichiers nommés pour indexation par git.

<code | download>
`git commit -m "message pour le commit"
</code>` on enregistre un point historique de modification

== Pour transmettre au dépôt distant ==

<code | download>
`git pull <le nom du dépôt> <la branche>`
</code> on récupère les infos du dépôt distant  

<code | download>
`git push <le nom du dépôt> <la branche>`
</code>

== En cas de branche divergentes ==

<code | download>
`git config --global pull.rebase merges`
</code>

le paramètre --global permet d'enregistrer les paramètres dépôt et branche (comme ça plus besoin de saisir. voir https://comprendre-git.com/fr/config/git-pull-rebase/

=== resynchroniser complètement avec l'état actuel de notre branche sur le dépôt distant (remote) ===

Pour se faire, rien de plus simple, il suffit d'utiliser la commande git reset, mais au lieu d'indiquer un hash de commit, cette fois nous allons pointer sur une branche distante, comme ceci :

<code | download>
git reset --hard origin/[branch_name]
</code>

Dans l'exemple ci-dessus, "origin" désigne le nom donné au dépôt distant (remote), et "branch_name" correspond au nom de la branche à laquelle on veut se synchroniser.

Attention, l'option "--hard" indique que toutes vos modifications locales (commits ou non sauvegardées), seront perdues sans possibilité de revenir en arrière !