Manual de Git actualizado y ampliado

manual_git.md

@@ -1,71 +1,78 @@
-# Manual de Git para Viernes
+# Manual Completo de Git para Viernes
 
-Este manual contiene los comandos esenciales para gestionar tus archivos de configuración con Git y GitLab.
+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. El Ciclo de Trabajo Básico
+---
-Cada vez que hagas cambios en tus documentos, sigue estos tres pasos:
 
-1.  **Ver el estado**: Mira qué archivos han cambiado.
+## 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 cambios**: Añade los archivos que quieres guardar.
+2.  **Preparar los archivos para guardar**:
     ```powershell
     git add .
     ```
-3.  **Guardar la versión (Commit)**: Crea un punto de control con un mensaje descriptivo.
+3.  **Crear el punto de control (Commit)**:
     ```powershell
-    git commit -m "Explicación de lo que has cambiado"
+    git commit -m "Explicación de los cambios"
     ```
-4.  **Subir a GitLab**: Envía tus cambios al servidor.
+    *Nota: En este punto, tus cambios ya están seguros en tu PC.*
+4.  **Subir al servidor**:
     ```powershell
     git push
     ```
 
 ---
 
-## 2. Recuperar Versiones Anteriores
+## 3. Cómo empezar un NUEVO proyecto
-Si cometes un error y quieres volver atrás:
+Si quieres empezar a trackear una carpeta nueva desde cero:
 
-### Ver el historial
+1.  **En la Web (Gitea/GitLab)**:
-```powershell
+    *   Crea un nuevo repositorio vacío y copia su URL (`https://...`).
-git log --oneline
+2.  **En tu ordenador (Terminal)**:
-```
+    ```powershell
-*(Muestra una lista de commits con un código de letras y números al principio, ej: `16e644f`)*
+    # Entra en la carpeta y actívala
+    git init
 
-### Deshacer cambios no guardados
+    # Añade tus archivos y haz el primer commit
-Si has modificado un archivo pero **no** has hecho `commit`:
+    git add .
-```powershell
+    git commit -m "Primer commit"
-git restore nombre_del_archivo.txt
-```
 
-### Volver a una versión anterior
+    # Conecta tu carpeta con el servidor
-Si quieres que todo el proyecto vuelva a como estaba en un commit específico:
+    git remote add origin URL_QUE_COPIASTE
-```powershell
+
-git checkout código_del_commit
+    # Sube todo por primera vez
-```
+    git push -u origin master
+    ```
 
 ---
 
-## 3. Trabajar con GitLab
+## 4. Identidad y Seguridad
-Como ya configuramos el "remote", estos comandos te serán útiles:
+Tu identidad ya está configurada **globalmente**, por lo que no tienes que hacerlo de nuevo en carpetas nuevas:
+*   **Usuario:** `viernes`
+*   **Email:** `viernes@tumonstruo.es`
 
-- **Bajar cambios**: Si editas algo desde la web de GitLab y quieres tenerlo en tu PC:
+### Autenticación (Access Tokens)
-  ```powershell
+Si el servidor te pide contraseña y no te funciona la habitual, usa un **Personal Access Token**:
-  git pull
+1.  Genéralo en la web de Gitea/GitLab (Ajustes -> Aplicaciones/Tokens).
-  ```
+2.  Úsalo como si fuera tu contraseña en la terminal.
-- **Ver la conexión**:
-  ```powershell
-  git remote -v
-  ```
 
 ---
 
-## 4. Configuración del Usuario
+## 5. Comandos de Emergencia (Volver atrás)
-Por si necesitas cambiar tus datos algún día:
+*   **Ver historial de versiones**: `git log --oneline`
-- **Nombre**: `git config --global user.name "viernes"`
+*   **Deshacer cambios en un archivo (antes de hacer commit)**: `git restore nombre_archivo`
-- **Email**: `git config --global user.email "viernes@tumonstruo.es"`
+*   **Bajar cambios hechos por otros (o desde la web)**: `git pull`
 
 ---
 
-*Creado por Antigravity para Viernes.*
+*Manual actualizado por Antigravity - Mayo 2026*