Add Gitea guide for Claude agents

2025-12-30 11:00:42 +07:00 · 2025-12-30 11:00:42 +07:00 · f3779a801a
commit f3779a801a
parent fe30e811a3
1 changed files with 217 additions and 0 deletions
--- a/docs/GITEA_GUIDE.md
+++ b/docs/GITEA_GUIDE.md
@ -0,0 +1,217 @@
+# Guide Gitea pour Claude
+
+## Credentials
+
+**Toujours lire en premier:**
+```
+C:\Users\alexi\Documents\projects\ProjectTracker\.env
+```
+
+Contient:
+- `GITEA_URL` - URL du serveur Gitea
+- `GITEA_TOKEN` - Token d'authentification API
+
+## Creer un nouveau repo
+
+### 1. Creer le repo sur Gitea via API
+
+```bash
+curl -X POST "https://git.etheryale.com/api/v1/user/repos" \
+  -H "Authorization: token <GITEA_TOKEN>" \
+  -H "Content-Type: application/json" \
+  -d "{\"name\": \"<nom-repo>\", \"description\": \"<description>\", \"private\": false}"
+```
+
+**Reponse:** JSON avec `clone_url` et `html_url`
+
+### 2. Initialiser git localement
+
+```bash
+cd "<chemin-projet>"
+git init
+```
+
+### 3. Creer .gitignore adapte au projet
+
+Exemple pour projet Access/VBA:
+```
+# Access lock files
+*.laccdb
+*.ldb
+
+# Backups
+.vba_backups/
+*.bak
+
+# Windows
+Thumbs.db
+Desktop.ini
+nul
+con
+prn
+aux
+
+# Temp
+*.tmp
+~$*
+```
+
+### 4. Ajouter les fichiers
+
+**Important:** Ne pas utiliser `git add .` si fichier `nul` existe (erreur Windows).
+
+Ajouter fichiers specifiquement:
+```bash
+git add .gitignore README.md <autres-fichiers>
+git add <dossiers>/
+git status
+```
+
+### 5. Premier commit
+
+```bash
+git commit -m "$(cat <<'EOF'
+Initial commit - <Nom Projet>
+
+<Description des fichiers>
+
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+EOF
+)"
+```
+
+### 6. Configurer remote et push
+
+```bash
+git branch -M main
+git remote add origin https://git.etheryale.com/StillHammer/<nom-repo>.git
+git push -u origin main
+```
+
+---
+
+## Operations courantes
+
+### Commit et push
+
+```bash
+git add <fichiers>
+git commit -m "Description du changement"
+git push
+```
+
+### Voir le status
+
+```bash
+git status
+git log --oneline -5
+```
+
+### Creer une branche
+
+```bash
+git checkout -b feature/ma-fonctionnalite
+git push -u origin feature/ma-fonctionnalite
+```
+
+---
+
+## API Gitea - Endpoints utiles
+
+Base URL: `https://git.etheryale.com/api/v1`
+
+| Action | Methode | Endpoint |
+|--------|---------|----------|
+| Lister mes repos | GET | `/user/repos` |
+| Creer repo | POST | `/user/repos` |
+| Info repo | GET | `/repos/StillHammer/<repo>` |
+| Supprimer repo | DELETE | `/repos/StillHammer/<repo>` |
+| Lister branches | GET | `/repos/StillHammer/<repo>/branches` |
+| Lister issues | GET | `/repos/StillHammer/<repo>/issues` |
+| Creer issue | POST | `/repos/StillHammer/<repo>/issues` |
+
+### Exemple: Lister mes repos
+
+```bash
+curl -H "Authorization: token <GITEA_TOKEN>" \
+  "https://git.etheryale.com/api/v1/user/repos" | jq '.[].name'
+```
+
+---
+
+## Troubleshooting
+
+### Erreur "nul" ou fichier reserve Windows
+
+Ajouter au .gitignore:
+```
+nul
+con
+prn
+aux
+```
+
+Et ajouter fichiers specifiquement au lieu de `git add .`
+
+### Erreur proxy/connexion
+
+Le fichier .env mentionne:
+> Use wget instead of curl for API calls due to proxy compatibility
+
+Si curl echoue, essayer wget:
+```bash
+wget --header="Authorization: token <TOKEN>" \
+  --header="Content-Type: application/json" \
+  --post-data='{"name":"repo"}' \
+  -qO- "https://git.etheryale.com/api/v1/user/repos"
+```
+
+### Authentification git push
+
+Si demande credentials, utiliser:
+- Username: `StillHammer`
+- Password: `<GITEA_TOKEN>`
+
+Ou configurer credential helper:
+```bash
+git config credential.helper store
+```
+
+---
+
+## Template .gitignore par type de projet
+
+### Python
+```
+__pycache__/
+*.pyc
+*.pyo
+.venv/
+venv/
+*.egg-info/
+dist/
+build/
+```
+
+### Node.js
+```
+node_modules/
+npm-debug.log
+.env
+dist/
+```
+
+### Access/VBA
+```
+*.laccdb
+*.ldb
+.vba_backups/
+~$*
+```
+
+---
+
+**Auteur:** Claude
+**Date:** 2025-12-30