diff --git a/manual_git.md b/manual_git.md index dfa239f..3635872 100644 --- a/manual_git.md +++ b/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 -Si cometes un error y quieres volver atrás: +## 3. Cómo empezar un NUEVO proyecto +Si quieres empezar a trackear una carpeta nueva desde cero: -### Ver el historial -```powershell -git log --oneline -``` -*(Muestra una lista de commits con un código de letras y números al principio, ej: `16e644f`)* +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 -### Deshacer cambios no guardados -Si has modificado un archivo pero **no** has hecho `commit`: -```powershell -git restore nombre_del_archivo.txt -``` + # Añade tus archivos y haz el primer commit + git add . + git commit -m "Primer commit" -### Volver a una versión anterior -Si quieres que todo el proyecto vuelva a como estaba en un commit específico: -```powershell -git checkout código_del_commit -``` + # Conecta tu carpeta con el servidor + git remote add origin URL_QUE_COPIASTE + + # Sube todo por primera vez + git push -u origin master + ``` --- -## 3. Trabajar con GitLab -Como ya configuramos el "remote", estos comandos te serán útiles: +## 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` -- **Bajar cambios**: Si editas algo desde la web de GitLab y quieres tenerlo en tu PC: - ```powershell - git pull - ``` -- **Ver la conexión**: - ```powershell - git remote -v - ``` +### 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. --- -## 4. Configuración del Usuario -Por si necesitas cambiar tus datos algún día: -- **Nombre**: `git config --global user.name "viernes"` -- **Email**: `git config --global user.email "viernes@tumonstruo.es"` +## 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` --- -*Creado por Antigravity para Viernes.* +*Manual actualizado por Antigravity - Mayo 2026*