GitHub en carne viva: tu web, versionada por ti

Hoy tu web deja de vivir solo en tu portátil. Cada uno sale de clase con su cuenta de GitHub, su Git configurado y autenticado, su repositorio enlazado a la web que empezaste el viernes, varios commits de verdad, una máquina del tiempo usada, y dos diseños distintos en dos ramas. Con una norma que no se rompe hoy: todas las dudas se preguntan primero a los modelos del centro.

Qué es Git, de verdad

La mitad de los líos de hoy vienen de creer que Git y GitHub son la misma cosa. No lo son, y no se parecen: uno es un programa y el otro es una web. Empecemos por el programa.

Las cuatro paradas de un cambio (esto es lo que más cuesta)

Cuando cambias un color en tu CSS, ese cambio no salta directo a GitHub: hace cuatro paradas, y cada salto lo provoca un comando distinto. Entender esto es entender Git entero; la mayoría de los «no me sube nada» son un cambio dormido en la parada equivocada.

Qué es GitHub, de verdad

GitHub es una web y una empresa: github.com, nacida en 2008 y comprada por Microsoft en 2018. Su trabajo es guardar repositorios de Git en sus servidores y montar herramientas alrededor. Es un sitio, no una tecnología —hay otros que hacen lo mismo: GitLab, Bitbucket, Codeberg, o un servidor tuyo—. Podrías usar Git toda tu vida sin abrir GitHub jamás.

Entonces, ¿para qué lo usamos? Porque encima de Git añade todo esto, que Git no tiene:

Las dos herramientas, una al lado de la otra

Configuración global: dile a Git quién eres

Antes del primer commit hay que configurar Git en ese ordenador. Son dos cosas: quién eres (para que pueda firmar tus commits) y cómo quieres que se comporte (para que no te sorprenda). Se hace una vez y vale para todos tus repositorios.

Los tres niveles: system, global y local

Git lee su configuración de tres sitios, del más general al más concreto, y siempre gana el más cercano al repositorio:

Los cinco comandos, uno a uno

Cámbialos por tus datos y pégalos en la terminal, línea a línea. Las comillas son necesarias cuando el valor lleva espacios.

git config --global user.name "Ana García"
git config --global user.email "ana@ejemplo.com"
git config --global init.defaultBranch main
git config --global core.editor "nano -w"
git config --global pull.rebase false

• user.name — tu nombre y apellido, con espacios y acentos si quieres. No es tu usuario de GitHub: es la firma que aparecerá en cada commit. Escríbelo como te gustaría que lo lea quien te esté planteando contratarte, porque es exactamente quien lo va a leer.
• user.email — tiene que ser uno de los correos de tu cuenta de GitHub, de los que aparecen verificados en Settings → Emails. Es lo que enlaza cada commit con tu perfil: si pones otro correo, los commits salen con un muñequito gris, no llevan a tu cuenta y no cuentan en tu cuadrito verde de contribuciones.
• init.defaultBranch main — que los repositorios nuevos nazcan con la rama llamada main. GitHub usa main; Git venía de fábrica con master. Esta línea te ahorra el error src refspec main does not match any.
• core.editor — cuando Git necesite que escribas un texto largo (el mensaje de una fusión, por ejemplo) abrirá un editor dentro de la terminal. Sin esta línea abre vim, y ahí es donde se queda encallada media clase. Con nano se sale con Ctrl+O, Enter, Ctrl+X. Si prefieres VS Code: "code --wait".
• pull.rebase false — le dices de antemano qué hacer cuando tu copia y la de GitHub han avanzado cada una por su lado: false significa «fúndelas». Sin esta línea, el día que pase, Git se planta y te suelta un aviso de divergent branches en vez de hacer nada.

El correo sin enseñar tu correo

Cuidado con una cosa: el correo del commit se publica y queda visible para cualquiera que mire tu repositorio. Si no quieres que tu correo real acabe en manos de un robot de spam, GitHub te regala uno de mentira que sigue enlazando con tu perfil. En Settings → Emails marcas Keep my email addresses private y te dan una dirección con esta pinta, que es la que pones en user.email:

git config --global user.email "12345678+anagarcia@users.noreply.github.com"

Comprobar que ha quedado bien

git config --global --list
git config --list --show-origin

El primero tiene que enseñar, como mínimo, tu user.name y tu user.email. El segundo dice además de qué fichero sale cada línea: es el comando con el que se descubre, en dos segundos, que el portátil traía puesta la configuración de otra persona. Y si estás dentro de un repo, git config user.email a secas te dice el que se está aplicando ahí de verdad, contando el local.

Usuario y contraseña: qué escribir exactamente

Aquí es donde se atasca media clase todos los años, así que vamos despacio. La clave es ver que Git te pide dos cosas distintas en dos momentos distintos: la identidad, al hacer commit, y las credenciales, al hacer push. No son lo mismo y no se escriben igual.

El momento exacto: qué sale en la terminal

Cuando haces tu primer git push por HTTPS, la terminal se para y te enseña estas dos líneas:

Username for 'https://github.com':
Password for 'https://anagarcia@github.com':

Cómo se saca el token, paso a paso

1. 1 · Entra en github.com con tu cuenta.
2. 2 · Pulsa tu foto, arriba a la derecha, y entra en Settings.
3. 3 · En la columna de la izquierda, baja hasta el final: Developer settings.
4. 4 · Personal access tokens → Tokens (classic) → botón Generate new token (classic).
5. 5 · En Note, un nombre para acordarte de para qué es: portatil-aula. En Expiration, 90 días (lo que dura esta parte del curso).
6. 6 · En Select scopes, marca la casilla repo, la primera del todo: con eso puedes leer y escribir en tus repositorios. No marques nada más; un token da exactamente los permisos que le pongas, y de más no hace falta.
7. 7 · Abajo del todo, Generate token.
8. 8 · Copia el token ahora, con el botón de copiar. En cuanto salgas de esa página no se vuelve a enseñar nunca. Si lo pierdes no es un drama: se borra ese y se genera otro.

Para no volver a escribirlo cada vez

Git puede recordar la credencial. El credential helper que toca depende de tu sistema:

# Windows (viene con Git for Windows)
git config --global credential.helper manager

# macOS (lo guarda en el Llavero)
git config --global credential.helper osxkeychain

# Linux: en tu portátil, lo recuerda para siempre...
git config --global credential.helper store
# ...y en uno compartido, mejor que lo olvide en una hora:
git config --global credential.helper 'cache --timeout=3600'

• Windows. El Git Credential Manager ya viene instalado con Git. La primera vez abre una ventana del navegador para que inicies sesión en GitHub —ahí sí usas tu cuenta normal, con el doble factor— y él se fabrica el token solito. Si te sale esa ventana, no te has equivocado: es lo normal en Windows.
• Linux con store. Guarda el token en texto plano en ~/.git-credentials. En tu portátil vale; en uno compartido, ni se te ocurra: el siguiente que lo use puede leerlo y subir cosas con tu nombre.

ssh-keygen -t ed25519 -C "ana@ejemplo.com"
cat ~/.ssh/id_ed25519.pub

git remote set-url origin git@github.com:anagarcia/mi-web.git

Los errores que vais a ver hoy (y qué significa cada uno)

Los mensajes de Git dan miedo por la pinta, pero casi todos dicen exactamente lo que pasa. Aquí están los que más salen, con el texto tal cual aparece. Búscalo, ábrelo, arréglalo. Y cuando te salga uno que no esté aquí: cópialo entero y pregúntaselo a la IA del centro, que para eso está.

No me deja ni empezar (configuración)

git config --global user.name "Ana García"
git config --global user.email "ana@ejemplo.com"

pwd
ls -a
git init

git config --global core.editor "nano -w"

git config --global pull.rebase false
git pull

No me deja subir (autenticación)

git remote -v
git remote set-url origin https://github.com/anagarcia/mi-web.git

ssh -T git@github.com
cat ~/.ssh/id_ed25519.pub

Sube, pero hay algo raro

git remote -v
git remote set-url origin https://github.com/anagarcia/mi-web.git

git log --oneline
git branch
git branch -M main
git push -u origin main

git pull --rebase origin main
git push -u origin main

git config --global user.email "12345678+anagarcia@users.noreply.github.com"

git log --format="%an <%ae>" -5
git config user.name "Ana García"
git config user.email "ana@ejemplo.com"

Los cinco conceptos (esto sí te lo explico yo)

Lo importante de hoy no son los comandos —esos los pregunta cada uno a su IA—, es entender qué está pasando. Esto es lo que no puede hacer nadie por ti:

Las misiones de hoy

Cómo preguntar bien a la IA del centro

La calidad de lo que te responda depende de cómo lo preguntes. La fórmula: contexto + objetivo + restricción. Una plantilla para arrancar:

Estoy en 1º DAM usando Git por primera vez. Tengo una carpeta en mi portátil con index.html, style.css y script.js, y un repositorio vacío recién creado en GitHub llamado mi-web.
Explícame paso a paso, comando a comando, qué debo escribir en la terminal para enlazar mi carpeta local con ese repositorio de GitHub y subir la web. Para cada comando, dime en una línea qué hace y qué veré si ha salido bien.

• Pide siempre el «qué hace cada comando»: si no lo sabes explicar, no lo teclees.
• Si te responde algo que no entiendes, no insistas con la misma pregunta: díselo literalmente («no entiendo el paso 2, explícamelo como si nunca hubiera usado la terminal»).
• Si algo sale mal, copia el mensaje de error exacto y pregúntale qué significa y qué hacer. Los errores de Git son mensajes legibles si preguntas: «conflict», «detached HEAD», «non-fast-forward»… son los cinco conceptos hablando.
• Ojo con una cosa: los modelos tienen fecha de caducidad en lo suyo, y en Git y GitHub las pantallas cambian. Si la IA te dice que pongas tu contraseña de GitHub en el push, te está dando una respuesta de hace años: la buena es la de esta página.

Checklist de entrega (antes de salir)

Para la próxima sesión

• ☐ Tu repo enlazado y con push: no necesitas traer nada más — tu trabajo ya vive en la nube
• ☐ Tu token a mano (o el credential helper puesto): el día que no puedas subir, perderás media clase
• ☐ Curiosidad por el siguiente paso: la misma dinámica de hoy, pero con un agente escribiendo los comandos contigo (y tú decidiendo todos los commits)