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

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/GitLab)**:
    *   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/GitLab (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`

---

*Manual actualizado por Antigravity - Mayo 2026*