Manual Completo de Git para Viernes

Este manual resume todo lo que hemos configurado para tu entorno de Gitea/GitLab. Ú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/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:

Ver qué ha cambiado:
```
git status
```
Preparar los archivos para guardar:
```
git add .
```
Crear el punto de control (Commit):
```
git commit -m "Explicación de los cambios"
```
Nota: En este punto, tus cambios ya están seguros en tu PC.
Subir al servidor:
```
git push
```

3. Cómo empezar un NUEVO proyecto

Si quieres empezar a trackear una carpeta nueva desde cero:

En la Web (Gitea/GitLab):
- Crea un nuevo repositorio vacío y copia su URL (https://...).

En tu ordenador (Terminal):

# 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:

Genéralo en la web de Gitea/GitLab (Ajustes -> Aplicaciones/Tokens).
Ú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.

Crear y entrar en una rama:
```
git switch -c nombre-rama
```
Volver a la rama principal:
```
git switch master
```
Fusionar los cambios (Merge): Estando en master, traes los cambios de la otra rama:
```
git merge nombre-rama
```
Borrar la rama (opcional):
```
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

3.2 KiB Raw Blame History