docs: workflow git pas à pas pour débutant dans tuto-gitea.md
Ajout de la section 8 expliquant le cycle add→commit→push→pull avec diagrammes ASCII, conventions de messages et exemple complet jardinage. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
+179
-2
@@ -307,7 +307,184 @@ SKILLS_REPO=/chemin/local bash install.sh
|
||||
|
||||
---
|
||||
|
||||
## 8. Commandes git essentielles
|
||||
## 8. Workflow git pas à pas — pour débutant
|
||||
|
||||
### Le cycle de travail en 4 étapes
|
||||
|
||||
```
|
||||
Modifier des fichiers
|
||||
↓
|
||||
git add ← "je veux inclure ces fichiers dans mon enregistrement"
|
||||
↓
|
||||
git commit ← "j'enregistre une version avec un message"
|
||||
↓
|
||||
git push ← "j'envoie mon travail vers Gitea"
|
||||
```
|
||||
|
||||
Et dans l'autre sens :
|
||||
|
||||
```
|
||||
git pull ← "je récupère les modifications de Gitea vers ma machine"
|
||||
↓
|
||||
Modifier des fichiers
|
||||
↓
|
||||
...
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Étape 0 — Vérifier où on en est (toujours commencer par là)
|
||||
|
||||
```bash
|
||||
git status
|
||||
```
|
||||
|
||||
Ce que ça dit :
|
||||
- **"nothing to commit"** → tout est propre, rien à faire
|
||||
- **"Changes not staged"** → tu as modifié des fichiers mais pas encore fait `git add`
|
||||
- **"Changes to be committed"** → tu as fait `git add`, prêt pour `git commit`
|
||||
- **"Your branch is ahead of origin"** → tu as des commits locaux à `push`
|
||||
|
||||
> 💡 **Règle d'or :** lance `git status` avant de faire quoi que ce soit. C'est ton tableau de bord.
|
||||
|
||||
---
|
||||
|
||||
### Étape 1 — `git add` — Préparer les fichiers à enregistrer
|
||||
|
||||
`git add` ne sauvegarde rien encore. Il dit juste à git : *"ces fichiers feront partie de mon prochain enregistrement"*.
|
||||
|
||||
```bash
|
||||
# Ajouter un fichier précis
|
||||
git add skills/dev/debugging/claude-code.md
|
||||
|
||||
# Ajouter tous les fichiers modifiés d'un dossier
|
||||
git add skills/dev/debugging/
|
||||
|
||||
# Ajouter tous les fichiers modifiés du projet (à utiliser avec précaution)
|
||||
git add .
|
||||
```
|
||||
|
||||
Après un `git add`, refais `git status` pour voir ce qui est "en attente de commit" (en vert).
|
||||
|
||||
---
|
||||
|
||||
### Étape 2 — `git commit` — Enregistrer une version
|
||||
|
||||
`git commit` crée un point de sauvegarde local avec un message qui explique **ce que tu as fait et pourquoi**.
|
||||
|
||||
```bash
|
||||
git commit -m "feat: ajout skill debugging pour claude-code"
|
||||
```
|
||||
|
||||
> 💡 Un bon message de commit répond à la question : *"Si je lis ça dans 6 mois, je comprends ce qui a changé ?"*
|
||||
|
||||
**Conventions de messages (optionnel mais utile) :**
|
||||
|
||||
| Préfixe | Usage |
|
||||
|---------|-------|
|
||||
| `feat:` | Nouveau skill, nouvelle fonctionnalité |
|
||||
| `fix:` | Correction d'une erreur |
|
||||
| `docs:` | Modification de documentation |
|
||||
| `chore:` | Maintenance, nettoyage |
|
||||
|
||||
À ce stade, ton travail est **sauvegardé localement** mais **pas encore sur Gitea**.
|
||||
|
||||
---
|
||||
|
||||
### Étape 3 — `git push` — Envoyer vers Gitea
|
||||
|
||||
`git push` envoie tes commits locaux vers ton dépôt Gitea. C'est à ce moment que les autres (ou toi depuis une autre machine) peuvent voir ton travail.
|
||||
|
||||
```bash
|
||||
# Premier push sur une nouvelle branche
|
||||
git push -u origin main
|
||||
|
||||
# Tous les push suivants (plus court)
|
||||
git push
|
||||
```
|
||||
|
||||
Si ça demande un mot de passe → tu utilises HTTPS. Passe en SSH (voir section 3) pour ne plus jamais avoir à saisir de mot de passe.
|
||||
|
||||
---
|
||||
|
||||
### Étape 4 — `git pull` — Récupérer les modifications de Gitea
|
||||
|
||||
`git pull` télécharge les modifications faites sur Gitea (par toi depuis une autre machine, ou par quelqu'un d'autre) et les intègre à ta copie locale.
|
||||
|
||||
```bash
|
||||
git pull
|
||||
```
|
||||
|
||||
> 💡 **Bonne habitude :** fais toujours `git pull` avant de commencer à travailler, pour être sûr d'avoir la version la plus récente.
|
||||
|
||||
---
|
||||
|
||||
### Exemple complet — Ajouter un skill et le pousser
|
||||
|
||||
```bash
|
||||
# 1. Récupérer les dernières modifications de Gitea
|
||||
git pull
|
||||
|
||||
# 2. Vérifier l'état du dépôt
|
||||
git status
|
||||
|
||||
# 3. Créer ton nouveau skill
|
||||
cp templates/claude-code.md skills/jardinage/arrosage/claude-code.md
|
||||
# Éditer le fichier avec ton éditeur...
|
||||
|
||||
# 4. Vérifier ce qui a changé
|
||||
git status
|
||||
# → "Untracked files: skills/jardinage/arrosage/claude-code.md"
|
||||
|
||||
# 5. Préparer le fichier pour l'enregistrement
|
||||
git add skills/jardinage/arrosage/claude-code.md
|
||||
|
||||
# 6. Vérifier (optionnel mais recommandé)
|
||||
git status
|
||||
# → "Changes to be committed: new file: skills/jardinage/..."
|
||||
|
||||
# 7. Enregistrer la version avec un message
|
||||
git commit -m "feat: ajout skill arrosage pour jardinage"
|
||||
|
||||
# 8. Envoyer vers Gitea
|
||||
git push
|
||||
```
|
||||
|
||||
Résultat : ton skill est visible sur `https://gitea.maison43.duckdns.org/gilles/mes_skills`
|
||||
|
||||
---
|
||||
|
||||
### Voir l'historique de tes commits
|
||||
|
||||
```bash
|
||||
# Compact (une ligne par commit)
|
||||
git log --oneline -10
|
||||
|
||||
# Avec dates et auteur
|
||||
git log --oneline --graph -10
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Annuler des erreurs courantes
|
||||
|
||||
```bash
|
||||
# J'ai fait git add par erreur sur un fichier → l'enlever de la sélection
|
||||
git restore --staged fichier.md
|
||||
|
||||
# J'ai modifié un fichier et je veux revenir à la version du dernier commit
|
||||
git restore fichier.md
|
||||
|
||||
# Je veux voir ce que j'ai modifié avant de committer
|
||||
git diff
|
||||
|
||||
# Je veux voir ce qui est dans le "add" (staged)
|
||||
git diff --staged
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 9. Commandes git essentielles
|
||||
|
||||
```bash
|
||||
# Statut du dépôt
|
||||
@@ -320,7 +497,7 @@ git log --oneline -10
|
||||
git diff
|
||||
|
||||
# Annuler les modifications d'un fichier (non commité)
|
||||
git checkout -- fichier.md
|
||||
git restore fichier.md
|
||||
|
||||
# Créer une branche
|
||||
git checkout -b ma-branche
|
||||
|
||||
Reference in New Issue
Block a user