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:

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):
- 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 (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