109 lines
3.2 KiB
Markdown
109 lines
3.2 KiB
Markdown
# Manual Completo de Git para Viernes
|
|
|
|
Este manual resume todo lo que hemos configurado para tu servidor privado GitLab, que corre Gitea. Úsalo como referencia cuando necesites guardar versiones o empezar un proyecto nuevo.
|
|
|
|
---
|
|
|
|
## 1. Conceptos Fundamentales
|
|
* **Git (Local):** Vive en tu ordenador. Guarda el historial de tus archivos aunque no tengas internet. Cada `commit` es una "foto" de tus documentos en ese momento.
|
|
* **Gitea en tu servidor privado GitLab (Remoto):** Es tu copia de seguridad en el servidor. Usamos `push` para subir tus `commits` locales allí.
|
|
|
|
---
|
|
|
|
## 2. El Ciclo de Trabajo Diario
|
|
Cuando modifiques tus archivos, sigue siempre este orden:
|
|
|
|
1. **Ver qué ha cambiado**:
|
|
```powershell
|
|
git status
|
|
```
|
|
2. **Preparar los archivos para guardar**:
|
|
```powershell
|
|
git add .
|
|
```
|
|
3. **Crear el punto de control (Commit)**:
|
|
```powershell
|
|
git commit -m "Explicación de los cambios"
|
|
```
|
|
*Nota: En este punto, tus cambios ya están seguros en tu PC.*
|
|
4. **Subir al servidor**:
|
|
```powershell
|
|
git push
|
|
```
|
|
|
|
---
|
|
|
|
## 3. Cómo empezar un NUEVO proyecto
|
|
Si quieres empezar a trackear una carpeta nueva desde cero:
|
|
|
|
1. **En la Web (Gitea)**:
|
|
* Crea un nuevo repositorio vacío y copia su URL (`https://...`).
|
|
2. **En tu ordenador (Terminal)**:
|
|
```powershell
|
|
# Entra en la carpeta y actívala
|
|
git init
|
|
|
|
# Añade tus archivos y haz el primer commit
|
|
git add .
|
|
git commit -m "Primer commit"
|
|
|
|
# Conecta tu carpeta con el servidor
|
|
git remote add origin URL_QUE_COPIASTE
|
|
|
|
# Sube todo por primera vez
|
|
git push -u origin master
|
|
```
|
|
|
|
---
|
|
|
|
## 4. Identidad y Seguridad
|
|
Tu identidad ya está configurada **globalmente**, por lo que no tienes que hacerlo de nuevo en carpetas nuevas:
|
|
* **Usuario:** `viernes`
|
|
* **Email:** `viernes@tumonstruo.es`
|
|
|
|
### Autenticación (Access Tokens)
|
|
Si el servidor te pide contraseña y no te funciona la habitual, usa un **Personal Access Token**:
|
|
1. Genéralo en la web de Gitea (Ajustes -> Aplicaciones/Tokens).
|
|
2. Úsalo como si fuera tu contraseña en la terminal.
|
|
|
|
---
|
|
|
|
## 5. Comandos de Emergencia (Volver atrás)
|
|
* **Ver historial de versiones**: `git log --oneline`
|
|
* **Deshacer cambios en un archivo (antes de hacer commit)**: `git restore nombre_archivo`
|
|
* **Bajar cambios hechos por otros (o desde la web)**: `git pull`
|
|
|
|
---
|
|
|
|
## 6. Ramas (Branches) y Fusión (Merge)
|
|
Las ramas sirven para trabajar en algo nuevo sin "romper" lo que ya funciona.
|
|
|
|
1. **Crear y entrar en una rama**:
|
|
```powershell
|
|
git switch -c nombre-rama
|
|
```
|
|
2. **Volver a la rama principal**:
|
|
```powershell
|
|
git switch master
|
|
```
|
|
3. **Fusionar los cambios (Merge)**:
|
|
Estando en `master`, traes los cambios de la otra rama:
|
|
```powershell
|
|
git merge nombre-rama
|
|
```
|
|
4. **Borrar la rama (opcional)**:
|
|
```powershell
|
|
git branch -d nombre-rama
|
|
```
|
|
|
|
---
|
|
|
|
## 7. Consejos de Oro
|
|
* **Haz commits pequeños**: Es mejor hacer 5 commits de cosas pequeñas que uno gigante de todo el día.
|
|
* **Mensajes claros**: "Corregido error en X" es mejor que "Cambios".
|
|
* **No tengas miedo a las ramas**: Son gratis y muy útiles para experimentar.
|
|
|
|
---
|
|
|
|
*Manual actualizado por Antigravity - Mayo 2026*
|