Publicación en GitHub Pages: alojamiento gratuito de sitios web estáticos
💡 Resumen en una frase: crea un repositorio
username.github.io, pega en la web los archivos generados por IA, abre Pages en Settings — y como máximo 10 minutos después, tu sitio web está en la internet pública.
Si buscas «tutorial de GitHub Pages», la mayoría de los artículos destacados asumen que ya sabes usar Git: clone, push, SSH key a toda velocidad, y quien parte de cero abandona tras dos párrafos. Esta lección elimina todo eso — en la lección A1 la IA ya escribió index.html, style.css, script.js en tu carpeta; ahora solo falta el último paso de «entregar la carpeta a GitHub», y todo se hace con clics en el navegador.
Esta es la lección 2 de la ruta A de escenarios prácticos (crear sitios web): A1 se encarga de «crearlo», y esta lección de «publicarlo»; A3 y A4 son la misma tarea en otras dos plataformas.
- ¿Todavía no tienes la página lista? Vuelve a A1 hacer un sitio web con IA
- ¿Aún no has elegido una ruta? Vuelve a 4.0 Escenarios prácticos: elige tu ruta
Qué podrás hacer al terminar
- Crear un repositorio con el nombre exacto
<你的用户名>.github.io, para que GitHub reconozca que «este es tu sitio personal» - Sin instalar Git ni tocar la línea de comandos, colocar los archivos web generados por IA en el repositorio a través del navegador
- Configurar el origen de publicación en Settings → Pages y convertir el repositorio en un sitio web accesible desde la internet pública
- Saber explicar por qué tras un cambio hay que esperar como máximo 10 minutos y dónde buscar la causa si supera 1 hora
- A partir de ahora, cada vez que actualices los archivos, el sitio se republicará automáticamente, sin repetir la subida de todo el sitio
Tu situación actual
- «La página lleva una semana en la carpeta. Sé que hay que “desplegarla”, pero al buscar solo encuentro comandos de git y claves SSH, no lo entiendo y no me atrevo a intentarlo»
- «He oído que para publicar hay que comprar un servidor, unas decenas al mes; para una página personal no vale la pena en absoluto»
- «Me registré en GitHub, pero solo sé hacer clic en Star — creé un repositorio una vez y nunca volví a abrirlo»
Cuándo usar esta técnica
Cuando necesitas:
- Una URL pública, gratuita y estable, para enviar directamente a otros la página que la IA creó
- De paso, tener tu primer repositorio de GitHub — útil para tu portafolio o para guardar archivos
- Que cada cambio futuro se republique automáticamente, sin subir archivos manualmente una y otra vez
Y no quieres:
- Instalar Git, configurar SSH ni aprender la línea de comandos
- Gastar dinero en servidores o dominios (usa primero la URL
username.github.ioque GitHub te regala) - Investigar un montón de opciones de configuración incomprensibles en la consola de una plataforma en la nube
¿Prefieres «arrastrar una carpeta y publicar»? Eso es A3 Cloudflare Pages; ¿prefieres «publicar con un solo comando»? Eso es A4 Vercel. La comparación de las cuotas gratuitas de las tres plataformas está en A5 Comparación de plataformas de despliegue.
🎒 Preparativos antes de empezar
- Haber completado A1 hacer un sitio web con IA: la carpeta contiene un
index.htmlverificado, y a ser posible tambiénstyle.cssyscript.js - Una cuenta de GitHub (si aún no tienes, regístrate primero en el sitio oficial de GitHub)
- Saber tu nombre de usuario de GitHub — el nombre del repositorio se forma con él, y si contiene mayúsculas deben convertirse todas a minúsculas
- Tener claro que el repositorio debe ser público: en las cuentas gratuitas de GitHub, el repositorio de Pages debe ser Public; lo que esto implica está en «Advertencias de errores comunes», punto 4
Idea central
GitHub Pages es el servicio oficial de alojamiento de sitios web estáticos de GitHub: toma los archivos HTML, CSS y JavaScript directamente de tu repositorio y los publica como un sitio web. No necesitas comprar un servidor — la construcción y publicación las realiza automáticamente el flujo de trabajo de Actions de GitHub, y para repositorios públicos es gratis con máquinas de construcción estándar.
Todo el mecanismo tiene solo tres actores:
| Rol | Qué es | Valor en esta lección |
|---|---|---|
| Repositorio | El lugar donde se guardan los archivos del sitio | <你的用户名>.github.io |
| Origen de publicación | Desde qué rama y qué directorio se toman los archivos para publicar | main la raíz / de la rama |
| Archivo de entrada | El primer archivo que ve el visitante al abrir la URL | index.html |
Una sola cadena de montaje: coloca los archivos en el repositorio → indica el origen de publicación en Settings → Pages → GitHub construye automáticamente (al publicar desde una rama usa por defecto el constructor Jekyll, del que no debes ocuparte) → el visitante abre https://<你的用户名>.github.io. Después, cada vez que hagas commit de un cambio, esta cadena se vuelve a ejecutar automáticamente.
¿Por qué el nombre del repositorio debe ser 用户名.github.io? Porque GitHub Pages tiene dos tipos de sitios, y el sitio de usuario se identifica por el nombre del repositorio:
| Tipo de sitio | Nombre del repositorio | URL | Límite de cantidad |
|---|---|---|---|
| Sitio de usuario (esta lección) | <用户名>.github.io | https://<用户名>.github.io | 1 por cuenta |
| Sitio del proyecto | Cualquier nombre de repositorio | https://<用户名>.github.io/<仓库名> | Por repositorio 1 |
Por último, recuerda los límites: GitHub Pages solo publica archivos estáticos, no admite lenguajes del lado del servidor como PHP, Ruby o Python — por eso la lección A1 te pidió hacer una primera versión puramente estática. Si de verdad necesitas funciones dinámicas, consulta A5 comparación de plataformas de despliegue.
Hazlo conmigo
Con cinco pasos, tu carpeta se convierte en una URL pública. Todo se hace con clics en el navegador, sin escribir ni una sola línea de comandos.
Paso 1: crea un repositorio llamado username.github.io
Por qué: el nombre del repositorio de un sitio de usuario es una regla estricta — GitHub usa ese nombre para reconocer que «este es el sitio personal de alguien»; si te equivocas en una sola letra, será solo un repositorio normal.
- Inicia sesión en GitHub, haz clic en + de la esquina superior derecha y elige New repository
- Como nombre del repositorio escribe
<你的用户名>.github.io. Por ejemplo, si el nombre de usuario esoctocat, el repositorio se llamaráoctocat.github.io; si el nombre de usuario tiene mayúsculas, conviértelas todas a minúsculas - En visibilidad elige Public — los repositorios de Pages en cuentas gratuitas de GitHub deben ser públicos
- Activa el interruptor Add README en On para que el repositorio tenga al menos un archivo
- Haz clic en Create repository
Deberías ver: una página de repositorio vacía, con un README.md en la lista de archivos.
- El nombre del repositorio coincide exactamente con tu nombre de usuario, todo en minúsculas
Paso 2: coloca los archivos del sitio web generados por IA en el repositorio
Por qué: GitHub Pages solo publica los archivos que están en el repositorio. Tu sitio web todavía está en la carpeta de tu ordenador; hay que trasladarlo — y se puede sin instalar Git: crea archivos nuevos en la web y pega el código.
- En la lista de archivos de la página del repositorio, crea un archivo nuevo con el nombre
index.html - Abre el
index.htmlgenerado por IA en la lección A1 con un editor de texto, selecciona todo, copia y pega en el cuadro de edición de la web - Haz clic en Commit changes para confirmar
style.css,script.jsy los demás archivos de páginas: créalos, pégalos y confírmalos uno por uno con el mismo método
Deberías ver: en la lista de archivos del repositorio aparecen index.html, style.css, script.js, coincidiendo con la lista de la carpeta de la lección A1.
💡 Las reglas del archivo de entrada
La lista que GitHub Pages usa para buscar el archivo de entrada es index.html, index.md, README.md (la documentación oficial los lista en ese orden). Tu index.html debe estar en el nivel más externo del directorio de publicación — en esta lección la fuente de publicación es la raíz del repositorio, así que va en la raíz del repositorio, no dentro de ninguna subcarpeta. El README.md generado automáticamente al crear el repositorio puede quedarse: seguirá siendo la portada de descripción del repositorio.
⚠️ Las imágenes no se pueden pegar
index.html y style.css son texto y se pueden pegar; los archivos binarios como las fotos no. Para la primera versión, pide a la IA que convierta las imágenes de marcador de posición en SVG en línea o efectos de CSS puro (ambos son texto y se pegan igual); la subida de imágenes reales no se trata en esta lección.
- La raíz del repositorio contiene
index.html, con el nombre escrito sin ni una letra mal
Paso 3: elige la rama de publicación en Settings → Pages
Por qué: con los archivos en su lugar falta un «interruptor» — decirle a GitHub desde qué rama tomar los archivos para publicar. Oficialmente esto se llama configurar la fuente de publicación (publishing source).
- Debajo del nombre del repositorio, haz clic en Settings
- En la barra lateral izquierda, dentro del grupo Code, planning, and automation, haz clic en Pages
- En la zona «Build and deployment», en el desplegable Source elige Deploy from a branch
- En el desplegable Branch elige
mainy, al lado, selecciona el directorio/ (root)— tus archivos están en la raíz del repositorio - Haz clic en Save
Deberías ver: Source muestra Deploy from a branch y Branch muestra main. GitHub empieza entonces la primera construcción — no tienes que hacer nada, solo esperar.
- Source = Deploy from a branch, Branch =
main+/ (root), con Save ya pulsado
Paso 4: espera como máximo 10 minutos y visita tu nuevo sitio web
Por qué: GitHub construye y publica tu sitio en segundo plano con un flujo de trabajo de Actions. Según la versión oficial: tras enviar los cambios, puede tardar hasta 10 minutos en surtir efecto — es el ritmo normal, no que se haya quedado colgado.
- En menos de 10 minutos, abre
https://<你的用户名>.github.ioen el navegador - También puedes llegar directamente desde la página Settings → Pages del repositorio, haciendo clic en Visit site
Deberías ver: la página que validaste en la lección A1 aparece tal cual en la web pública. Envía el enlace a tus amigos — podrán abrirlo sin tocar tu ordenador.
¿Sigue sin abrirse después de 10 minutos? Primero comprueba la ortografía de la URL (es el nombre del repositorio) y espera un poco más; si pasadas 1 hora no se ha actualizado, ve a la pestaña Actions del repositorio y revisa el registro de ejecuciones del flujo de trabajo: los errores de construcción quedan todos ahí — se detalla en «Avisos de errores comunes», punto 3.
https://<你的用户名>.github.ioAl abrirlo, lo que ves es tuindex.html
Paso 5: actualiza el sitio web — el ciclo cotidiano del tutorial de GitHub Pages
Por qué: publicar no es cosa de una sola vez. Cada vez que cambies el contenido en el futuro, seguirás el mismo ciclo, y además resultará más fácil que la primera vez.
- Deja que la IA modifique los archivos; los cambios pequeños también se pueden hacer en la web con el icono del lápiz
- Confirma los cambios (Commit changes)
- Espera como máximo 10 minutos y actualiza la URL
Deberías ver: la URL no cambia y el contenido se renueva automáticamente en menos de 10 minutos.
💡 Confirmar es publicar
Cada cambio que envías a la rama de publicación, GitHub Pages lo republica automáticamente — según la documentación oficial: en cuanto los cambios se envían a la rama de origen, las modificaciones de la carpeta de origen se publican en el sitio. No hay ningún botón de «volver a publicar» que pulsar.
Punto de control ✅
- El nombre del repositorio debe ser estrictamente
<你的用户名>.github.io, todo en minúsculas index.htmlva en la raíz del repositorio (el nivel más externo del directorio de publicación), no dentro de ninguna subcarpeta- Settings → Pages: Source = Deploy from a branch, Branch =
main+/ (root) - Al abrir
https://<你的用户名>.github.ioverás tu página - Recuerda dos números: tras un cambio, espera como máximo 10 minutos; si pasa de 1 hora, revisa el registro del flujo de trabajo en Actions
Avisos de errores comunes
❌ El nombre del repositorio está mal escrito, o las mayúsculas no se convirtieron a minúsculas
Síntoma: https://<用户名>.github.io no abre, aunque el repositorio está claramente creado.
Causa: el nombre del repositorio de un sitio de usuario es una regla fija; GitHub solo acepta la forma <用户名>.github.io; si el nombre de usuario contiene mayúsculas, el nombre del repositorio también debe ir todo en minúsculas.
Solución correcta: verifica la ortografía de tu nombre de usuario en tu perfil de GitHub, recrea el repositorio en minúsculas siguiendo <用户名>.github.io y vuelve a pegar los archivos; son solo unos archivos, cuestión de minutos.
❌ index.html quedó dentro de una subcarpeta
Síntoma: la URL abre, pero ves el contenido de README.md, no la página que hiciste.
Causa: el archivo de entrada debe estar en el nivel más externo del directorio de publicación. A veces la IA genera todo el conjunto de archivos en una subcarpeta como site/; si los copias tal cual, index.html queda escondido un nivel más abajo y en la raíz solo queda README.md como candidato a entrada.
Solución correcta: el origen de publicación de esta lección es la raíz del repositorio /; index.html, style.css y script.js van directamente en la raíz; las referencias relativas entre archivos (como href="style.css") funcionan tal cual; la estructura de directorios del sitio coincide con la del repositorio.
❌ A los diez minutos sin actualizaciones, cambias la configuración una y otra vez
Síntoma: enviaste los cambios, al refrescar sigue la página antigua, así que modificas Settings de un lado a otro y borras y vuelves a subir los archivos.
Causa: la documentación oficial dice claramente que tras un push hay que esperar hasta 10 minutos. La compilación lleva tiempo; no es un fallo.
Solución correcta: espera los 10 minutos completos antes de juzgar. Solo si pasadas 1 hora o más no hay actualización hace falta investigar: ve a la pestaña Actions del repositorio y mira si la última ejecución del flujo de trabajo terminó con éxito o con error; luego confirma que quien hizo el push tiene permisos de administrador del repositorio y que su cuenta de GitHub tiene el correo verificado; la documentación oficial dice que si no se cumplen estas dos condiciones, la compilación no se activa.
❌ Pones en el repositorio contenido que no quieres hacer público
Síntoma: número de teléfono, foto de documento, todo tipo de claves, subidos junto con los archivos del sitio.
Causa: el repositorio de Pages de una cuenta gratuita de GitHub debe ser Public; y además la documentación oficial advierte específicamente que, incluso si el repositorio es privado (solo permitido en planes de pago), el contenido del sitio de Pages queda igualmente visible en la web pública. «Repositorio privado = nadie puede verlo» no se cumple en GitHub Pages.
Solución correcta: antes de publicar, repasa la lista de archivos y elimina los datos sensibles antes de subirlos; la recomendación de la advertencia oficial es justamente esa: quitar los datos sensibles antes de publicar. Si te importa que el contenido sea público, las consideraciones para elegir plataforma están en A5 comparación de plataformas de despliegue.
Técnicas avanzadas (opcional)
🚀 ¿Quieres usar un framework como VitePress? (opcional)
Al publicar desde una rama, GitHub Pages construye tus archivos con Jekyll por defecto. Para cambiar a otro generador de sitios estáticos, la documentación oficial da dos caminos: usar un flujo de trabajo de GitHub Actions para construir y publicar (la documentación oficial ofrece plantillas; el flujo general es obtener el código → construir → subir el artefacto → desplegar), o poner un archivo vacío .nojekyll en la raíz del origen de publicación para desactivar Jekyll. Para tu primer sitio, completa todo el proceso con los archivos estáticos escritos a mano de A1, y deja el tema de los frameworks para después de A5.
🚀 ¿Quieres dar a cada obra su propia página web? (opcional)
Una cuenta solo tiene un sitio de usuario, pero los sitios de proyecto son uno por repositorio: en cualquier repositorio, abre Settings → Pages y haz la misma configuración; la URL es https://<用户名>.github.io/<仓库名>. Así se hace: un enlace por proyecto en tu portafolio.
🚀 ¿Quieres cambiar a tu propio dominio? (opcional)
username.github.io: úsalo por ahora. Cuando tengas tu propio dominio, el procedimiento completo desde la configuración DNS hasta el enlace está en 5.3 dominio personalizado.
Resumen de la lección
✅ Completaste el flujo completo de publicación de este tutorial de GitHub Pages:
- Crear el repositorio: el nombre debe ser estrictamente
<用户名>.github.io, y con cuenta gratuita elige Public - Subir los archivos: crea archivos en la web y pega el código,
index.htmlva en la raíz del repositorio - Activar la publicación: Settings → Pages, Deploy from a branch +
main+/ (root) - Verificar: espera como máximo 10 minutos, y al abrir
https://<用户名>.github.ioverás tu página - Actualizar: modifica archivos → Commit changes → republicación automática en menos de 10 minutos
| Configuración clave | Valor recomendado | Explicación |
|---|---|---|
| Nombre del repositorio | <用户名>.github.io | Nombre exclusivo del sitio de usuario, todo en minúsculas |
| Visibilidad | Public | Requisito obligatorio para cuentas gratuitas de GitHub |
| Source | Deploy from a branch | Ruta del asistente web; la otra es GitHub Actions |
| Branch / directorio | main + / (root) | Se publica desde donde estén los archivos |
| Archivo de entrada | index.html | También valen index.md, README.md; debe estar en el nivel más externo del directorio de publicación |
| Tiempo de efecto | hasta 10 minutos | Si pasa de 1 hora, revisa el registro del flujo de trabajo en Actions |
Avance de la próxima lección
En la próxima lección A3 Publicación en Cloudflare Pages: ni siquiera necesitas crear un repositorio; arrastra una carpeta en el navegador y queda publicada. Aprenderás:
- Cómo obtener una URL
项目名.pages.deven tres pasos con la subida por arrastre de Direct Upload - Cómo lograr «despliegue automático en cada push» con la integración de Git, para quienes saben Git
- Por qué estos dos métodos de despliegue, una vez elegidos, no son intercambiables
- Qué significa para los principiantes que Cloudflare ya recomiende empezar los proyectos nuevos con Workers
Cuando estés listo, ten la carpeta a mano y entra en A3 →