Crea y publica una web con IA
Publicar HTML generado con IA en GitHub Pages: archivos, rutas y errores 404
Publica una web estática personal en GitHub Pages, organiza HTML y recursos, elige la rama de publicación y resuelve imágenes ausentes, errores 404 y actualizaciones.

Si una herramienta de IA ya te ha generado una página HTML, puedes publicarla gratis en GitHub Pages y compartir el enlace. Sirve para un portafolio personal, apuntes o una demo sencilla. Reúne la página de inicio y sus recursos, súbelos a un repositorio y activa Pages.
En esta guía usaremos un repositorio llamado ai-website y subiremos los archivos desde el navegador. La dirección final suele ser https://你的用户名.github.io/ai-website/: sustituye el marcador del nombre de usuario por tu cuenta de GitHub. GitHub Free permite usar Pages con repositorios públicos. Un dominio propio y los servicios externos pueden tener un coste adicional.
GitHub Pages aloja archivos estáticos. Una página con texto, imágenes, enlaces y funciones que se ejecutan en el navegador puede funcionar ahí. Si tu diseño incluye un formulario de inicio de sesión, necesitarás un servicio aparte para gestionar las cuentas.
| Qué recibiste | ¿Puedes seguir esta guía? | Qué revisar primero |
|---|---|---|
Un index.html que incluye estilos y scripts | Sí | Comprueba las imágenes externas y los enlaces |
| HTML con archivos CSS, JavaScript y carpetas de imágenes | Sí | Conserva las rutas entre los archivos |
| Una captura o maqueta | Cuando tengas los archivos web | Pide a la IA que genere el HTML |
| Código fuente de React o Next.js que necesita dependencias | Requiere una compilación y una configuración de despliegue adecuadas | Averigua si se puede exportar como sitio estático |
| Una aplicación con base de datos, pagos o tareas del servidor | Requiere evaluar otras opciones de alojamiento | Identifica qué servidor y tratamiento de datos necesita |
Pages no ejecuta lenguajes de servidor como PHP o Python. GitHub también prohíbe usarlo como alojamiento gratuito para operar un negocio en línea, procesar transacciones de comercio electrónico u ofrecer un SaaS comercial. Consulta los límites de GitHub Pages. Si tu proyecto necesita un servidor, consulta la guía de opciones de alojamiento para webs creadas con IA.
Nombra la página de inicio index.html, en minúsculas. Guarda junto a ella las imágenes, las hojas de estilo y los scripts que utiliza.
ai-website/
├── index.html
├── style.css
└── images/
└── cover.png
Si los estilos están dentro del HTML, puedes prescindir de style.css. Si recibiste un ZIP, descomprímelo y sube su contenido. Comprueba que el editor guardó index.html y no index.html.txt.
Puedes pasarle este encargo a tu herramienta de IA.
Prepara esta página como HTML estático listo para publicar. Nombra la página de inicio index.html e indica qué archivos CSS, JavaScript e imágenes debo guardar con ella. La web se publicará en la subruta /ai-website/. Revisa las rutas relativas de los recursos y enlaces, y señala qué funciones aún dependen de servicios externos.
Abre la página en tu equipo y prueba el texto, las imágenes y los botones. Las referencias a C:\Users\..., file://... o localhost no darán a los visitantes acceso a tu equipo. Mantén las contraseñas, claves de API y archivos privados fuera del código público.
Entra en la cuenta con la que vas a gestionar la web. Pulsa New repository, escribe ai-website, selecciona Public, añade un README y crea el repositorio.
El repositorio es el espacio donde guardarás los archivos del proyecto. Este ejemplo crea un sitio de proyecto. GitHub reserva el nombre 用户名.github.io para sitios de usuario: sustituye el marcador por tu cuenta real. Su estructura de URL es distinta. Consulta los tipos de sitios de GitHub Pages.
Con GitHub Free, usa un repositorio de origen público y prepara tanto la web como el código para que sean visibles. Para un sitio solo por invitación, comprueba por separado qué controles de acceso se aplican a la web publicada y al repositorio. Consulta la guía para crear un sitio de Pages.
En la pestaña Code del repositorio, abre Add file → Upload files. Sube index.html y los archivos que utiliza. Escribe un mensaje como «Publicar portada del portafolio» y confirma el cambio.
Cambia a la rama main y comprueba que los archivos aparezcan allí. Si la carga creó otra rama o una solicitud de cambios, incorpórala a main para que la fuente de publicación pueda recoger los archivos. Consulta cómo añadir archivos a un repositorio.
Para esta configuración, index.html debe verse en la raíz del repositorio. Si quedó dentro de una carpeta adicional ai-website, sube los archivos un nivel. Comprime las imágenes demasiado grandes. El navegador admite hasta 25 MiB por archivo y hasta 100 archivos por carga.
Entra en Settings → Pages, localiza Build and deployment y aplica esta configuración.
| Opción | Valor para este ejemplo | Qué selecciona |
|---|---|---|
| Source | Deploy from a branch | Publicación desde una rama existente |
| Branch | main | La rama donde subiste los archivos |
| Folder | /(root) | La raíz del repositorio |
Pulsa Save. Elige /(root) cuando index.html esté en la raíz del repositorio. Si eliges /docs, la portada debe quedar directamente en la carpeta docs de la rama main.

GitHub utiliza un flujo de Actions para los despliegues desde una rama. En este ejemplo de HTML, el flujo se ejecuta automáticamente. Consulta la guía para configurar el origen de publicación.
Si tienes carpetas estáticas cuyo nombre empieza por guion bajo, o necesitas omitir Jekyll, coloca un archivo vacío llamado .nojekyll en la raíz de la carpeta de publicación. Compila los proyectos de React por separado y corrige las rutas de recursos en los archivos. Consulta las indicaciones sobre generadores de sitios estáticos.
Revisa el despliegue de Pages en la pestaña Actions. Cuando termine correctamente, vuelve a Settings → Pages y selecciona Visit site. Comparte la dirección pública, no la vista de código del repositorio, como github.com/用户名/仓库名.
https://你的用户名.github.io/ai-website/
GitHub indica que los cambios pueden tardar hasta unos 10 minutos en publicarse. Si el flujo sigue en curso, puedes ver el progreso en Actions. Si falla, abre la ejecución y busca el error concreto. Consulta cómo ver el sitio publicado.
Prueba el enlace en un navegador sin sesión de GitHub y desde un móvil con datos. Revisa la portada, las imágenes, la navegación y los botones principales antes de añadir la web a tu currículum o perfil. Si tus lectores están en otra región, prueba desde una red que usen habitualmente.
| Qué ves | Dónde mirar | Qué hacer |
|---|---|---|
| Toda la web devuelve 404 | Actions, Visit site y origen de publicación | Espera al despliegue y comprueba rama y carpeta |
| Solo aparece el README | Archivo de entrada de la carpeta publicada | Confirma que la portada se subió como index.html |
| La portada devuelve 404 aunque el archivo está en GitHub | Nivel de la carpeta y mayúsculas del nombre | Coloca index.html en minúsculas en la raíz de publicación |
| La portada carga, pero faltan imágenes o estilos | Rutas solicitadas y recursos subidos | Revisa los archivos y las carpetas, y corrige las rutas relativas |
| Una página interna abre desde el menú y devuelve 404 al recargar | Existencia de un archivo estático para esa ruta | Usa un archivo HTML real o un sistema de rutas adecuado al proyecto |
GitHub distingue entre Index.html, index.HTML e index.html. Empieza por el nombre exacto y la ubicación. Consulta la guía de errores 404 de GitHub Pages.
En un sitio de proyecto, una / inicial puede quitar el nombre del repositorio de la ruta solicitada. Así resuelve el navegador las rutas desde https://example-user.github.io/ai-website/.
| Ruta escrita en la página | Ruta solicitada por el navegador |
|---|---|
./images/cover.png | /ai-website/images/cover.png |
/images/cover.png | /images/cover.png |
./about.html | /ai-website/about.html |
Para mostrar en la portada una imagen guardada en la carpeta images del proyecto, puedes usar una ruta como esta.
<img src="./images/cover.png" alt="作品展示图">
La URL solo ilustra cómo se resuelven las rutas; no demuestra que el sitio de ejemplo esté publicado. Ajusta las rutas para páginas en subcarpetas y respeta los nombres exactos, incluida la diferencia entre images/cover.png e images/Cover.png. Sustituye el texto alternativo de la imagen por una descripción útil en el idioma de tu web.
Pide a la IA que modifique los archivos locales y sube la versión nueva al mismo repositorio. Conserva los nombres y las referencias, y confirma los cambios en la misma rama de publicación. Cuando termine el despliegue, vuelve a abrir la dirección pública y comprueba un texto o una imagen que hayas cambiado.
Si la web sigue igual, confirma que los cambios llegaron a main y que el nuevo despliegue terminó correctamente. Después recarga la página y revisa la caché. Los cambios guardados en tu equipo o en otra rama todavía tienen que llegar a la fuente configurada. Consulta la guía para diagnosticar un despliegue desactualizado y volver a una versión anterior.
Si quieres seguir mejorando la web, consulta cómo conectar un dominio propio, añadir formularios o cuentas y comprobar la indexación en Google.