Git y publicación

1.Qué es Git y por qué lo necesitas

Imagina que cada vez que cambias tu página pudieras guardar una fotografía del proyecto con una nota que diga qué hiciste. Si algo se rompe, vuelves a una fotografía anterior. Eso hace Git: un sistema de control de versiones.

Tres razones para usarlo desde ya:

1. Puedes equivocarte sin miedo: cada versión anterior se puede recuperar.
2. Publicas gratis con GitHub Pages, como lo hace este curso.
3. Es el estándar en el trabajo de programación: aprenderlo ahora te abre puertas.

2.Instalación y configuración

1. Descarga Git desde git-scm.com e instálalo con las opciones por defecto.
2. Abre una terminal: en Windows, «Git Bash» (se instala con Git); en Mac y Linux, la aplicación «Terminal». También sirve la terminal integrada de Cursor (Ctrl + `).
3. Comprueba la instalación con el comando de abajo.
4. Dile a Git quién eres (solo una vez por computadora).

git --version
git config --global user.name "Tu Nombre"
git config --global user.email "tu-correo@ejemplo.com"
git config --global init.defaultBranch main

El correo debe ser el mismo de tu cuenta de GitHub, para que tus cambios se asocien contigo. Crea tu cuenta gratuita en github.com.

3.El ciclo de trabajo

Todo lo que harás con Git sigue el mismo recorrido. Entiéndelo bien y el resto son detalles:

• Tu carpeta: donde editas tus archivos de siempre.
• Área de preparación (staging): eliges qué cambios entran en la próxima «fotografía».
• Historial local: cada commit queda guardado en tu computadora.
• GitHub: con git push subes tus commits a internet.

4.Tu primer repositorio

Vamos a convertir una carpeta con tu página en un repositorio. Los comandos se ejecutan dentro de la carpeta del proyecto.

cd mi-pagina
git init
git status
git add .
git commit -m "Primera versión de mi página personal"
git log --oneline

Mensajes de commit que se entienden

Un buen mensaje responde a «¿qué hace este cambio?». Dentro de unos meses, tu yo del futuro te lo agradecerá.

5.Subir tu proyecto a GitHub

1. En GitHub, pulsa New repository. Elige un nombre (por ejemplo mi-pagina), déjalo público y no marques «Add a README» (ya tienes tus archivos).
2. GitHub te mostrará una dirección como https://github.com/tu-usuario/mi-pagina.git. Cópiala.
3. En tu terminal, conecta tu carpeta con ese repositorio y sube el historial.

git remote add origin https://github.com/tu-usuario/mi-pagina.git
git branch -M main
git push -u origin main
git remote -v

• git remote add origin … registra la dirección con el nombre origin.
• git push -u origin main sube la rama main y recuerda la conexión para las próximas veces.
• git remote -v muestra los remotos configurados.

6.Publicar con GitHub Pages

GitHub Pages publica gratis los archivos de un repositorio como un sitio web. Es lo que usa este curso.

1. Abre tu repositorio en GitHub y entra a Settings → Pages.
2. En Source, elige Deploy from a branch.
3. Elige la rama main y la carpeta / (root). Pulsa Save.
4. Espera uno o dos minutos. Arriba verás la dirección: https://tu-usuario.github.io/mi-pagina/.

A partir de ahora, cada vez que hagas git push, GitHub Pages se actualiza solo.

7.Tu rutina de todos los días

# 1. Edita tus archivos y pruébalos en el navegador
# 2. Mira qué cambió
git status
# 3. Prepara y guarda
git add .
git commit -m "Describe lo que hiciste"
# 4. Sube a GitHub (y se publica solo)
git push

Si trabajas desde dos computadoras

git pull

git pull descarga lo que haya nuevo en GitHub. Hazlo antes de empezar a trabajar.

Ignorar archivos

Hay archivos que no deben subirse (contraseñas, archivos del sistema, carpetas pesadas). Se listan en un archivo llamado .gitignore:

.DS_Store
Thumbs.db
node_modules/
.env
*.log

8.Ramas y colaboración (un vistazo)

Una rama es una línea de trabajo paralela: puedes probar una idea sin tocar main, y si funciona, la unes. Es la base de cómo se colabora.

git switch -c mejora-menu      # crea y entra a una rama nueva
# …haces cambios y commits…
git push -u origin mejora-menu # sube la rama
git switch main                # vuelve a main

En GitHub, una rama se propone para unirse a main mediante un Pull Request (PR): otras personas ven los cambios, los comentan y, cuando están conformes, los fusionan (merge). Este curso se actualizó justamente así.

9.Problemas frecuentes

10.Glosario