WPanda/GEMINI_vscode_gitea.md

Gitea integrálása Visual Studio Code-ba

A VS Code alapból a GitHub-ra van kiélezve, de könnyedén használható bármilyen Git szerverrel, így a saját Gitea-dal is. Két dolgot kell megkülönböztetni: az alap Git műveleteket és az extra, szerver-specifikus funkciókat.

1. Alap Git Műveletek (Clone, Push, Pull, Commit)

Ehhez valójában semmilyen extra kiegészítő nem kell, a VS Code a rendszereden telepített Gitet használja.

1. Klónozás:

   • Nyisd meg a VS Code-ot, és a Source Control (Ctrl+Shift+G) panelen kattints a Clone Repository gombra.
   • Másold be a Gitea repozitóriod HTTPS vagy SSH URL-jét.
   • A VS Code le fogja klónozni a repót.

2. Hitelesítés (Authentication):

   • HTTPS esetén: Amikor először próbálsz push-olni (feltölteni), a VS Code/Git kérni fogja a Gitea felhasználónevedet és jelszavadat. Fontos: Javasolt a Gitea felületén generálni egy Access Token-t (Beállítások -> Alkalmazások -> Új token generálása), és a jelszó helyett azt használni. Ez biztonságosabb.
   • SSH esetén: Add hozzá a publikus SSH kulcsodat a Gitea profilodhoz (Beállítások -> SSH/GPG kulcsok). Ha az SSH kulcsod jelszóval védett, a VS Code kérheti a jelszót.

Ha ez megvan, az alapvető Git parancsok (commit, push, pull, branch létrehozás stb.) már működni fognak a VS Code grafikus felületéről.

2. Extra Gitea Funkciók (Pull Requestek, Issue-k)

Ahhoz, hogy a VS Code-on belülről tudj Pull Requesteket kezelni, issue-kat látni (ahogy a GitHub kiegészítőnél), telepítened kell egy erre szakosodott kiegészítőt.

A legjobb választás erre a hivatalosnak tűnő Gitea kiegészítő.

Telepítés és beállítás:

1. A VS Code oldalsó sávjában kattints az Extensions ikonra (Ctrl+Shift+X).
2. A keresőbe írd be: Gitea.
3. Keresd meg a Gitea Team által fejlesztett "Gitea" nevű kiegészítőt és kattints az Install gombra.
4. A telepítés után nyisd meg a beállításokat (Ctrl+,), és keress rá a gitea szóra.
5. Itt meg kell adnod két fontos dolgot:
   • Gitea: Vscode > Remotes: Ide kell felvenned a Gitea szervered adatait. Kattints az "Add Item" gombra, add meg a szervered URL-jét (pl. https://gitea.sajatcegem.hu) és egy Access Tokent, amit a Gitea felületén generáltál.
   • A kiegészítő ezután már képes lesz kommunikálni a szerverrel, és a Source Control panelen megjelennek a Gitea-specifikus opciók.

Összefoglalva: Az alap műveletekhez elég klónozni a repót, az extra kényelmi funkciókhoz pedig telepítsd a Gitea kiegészítőt és add meg neki a szervered címét és egy tokent.