
Minilección · Español
Cómo publicar tu sitio web desde GitHub
Publica la página proporcionada desde un repositorio de práctica de GitHub y verifica que una edición posterior llegue al sitio público.
¿Para quién es esta lección?
Para quienes quieren poner un sitio en línea y actualizarlo de forma fiable. Se proporcionan los archivos; puedes usar GitHub Desktop y un asistente sin escribir comandos Git.
Antes de empezar
Necesitas tus propias cuentas GitHub y Netlify, y GitHub Desktop o acceso equivalente. Usa un repositorio y un proyecto de alojamiento independientes de práctica. La página P1 proporcionada funciona aunque no hayas cursado la lección de sitio personal. Las respuestas resueltas son ejemplos, no pruebas realizadas en tu cuenta. Sustituye sus observaciones por tus resultados o indica el paso bloqueado.
Tiempo estimado: 21–33 min
Estimaciones con los archivos iniciales y las cuentas y herramientas necesarias ya listas. La configuración, las colas de publicación y las esperas de correo o DNS requieren tiempo adicional. Las estimaciones excluyen instalar GitHub Desktop, acceder a cuentas y esperar colas de compilación. El uso del alojamiento depende de tu cuenta.
Qué aprenderás
- Conecta un repositorio de práctica al alojamiento.
- Publica un cambio visible y verifica el resultado público.
- Localiza la etapa que falló si la página pública no está actualizada.
Paso 1
Prepara una página reconocible
Usa el sitio P1 listo en vez de crear primero un sitio.
Abre los archivos del taller y guarda index.html, style.css, netlify.toml y .gitignore en una misma carpeta de proyecto. Abre index.html en tu equipo para ver la página P1 y pide al asistente que coloque esos archivos en la raíz de un repositorio de prueba independiente.
La página debe mostrar Portfolio version P1. Elige un repositorio y un proyecto de práctica y comprueba que ninguno sea otro sitio ya en servicio.
Un ejemplo concreto
Usa una sola carpeta con index.html, style.css, netlify.toml y .gitignore. La marca Portfolio version P1 de la página permitirá reconocer exactamente esta primera versión más adelante.
Usa el sitio P1 y los archivos de publicación proporcionados. Ayúdame a ponerlos en la raíz de un repositorio de práctica independiente con GitHub Desktop, revisar si hay archivos privados y conectar el repositorio a mi propio proyecto Netlify de práctica. Pregunta antes de publicar. Explica cómo confirmar P1 en la página pública y ayúdame a publicar una pequeña edición P2 sin cambiar un sitio activo existente.Archivos de este paso
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Pon tu sitio en línea desde GitHub
Al publicar, se copia una versión de tus archivos en un servicio de alojamiento para que otras personas puedan acceder a ellos.
Tu página local, el repositorio GitHub y el despliegue del alojamiento son tres lugares distintos. Guardar localmente no actualiza automáticamente la página pública. Un commit registra una versión; un alojamiento conectado puede desplegarla.
Utiliza un proyecto nuevo de práctica. Asegúrate de que la carpeta contiene la página principal y la hoja de estilos reales, no una carpeta superior con una colección de archivos ajenos.
Para comprobar visualmente la versión, añade el párrafo “Portfolio version P1” antes del primer commit. En la tarea final cámbialo a P2 junto con tu cambio significativo de contenido. El indicador permite comparar el archivo local, el commit remoto y la página desplegada sin adivinar qué copia está abierta.
Ejemplo resuelto
Alex añade la frase visible “Portfolio version P1”. Esa frase y el ID del commit permiten distinguir un despliegue correcto de un navegador que todavía muestra una versión antigua.
Extra implementation exercise
Guardaste P1 localmente, pero la página alojada sigue diciendo P0. ¿Qué dos pasos de publicación podrían faltar?
Mostrar una solución desarrollada
Comprueba primero el repositorio y después el registro de despliegue. Actualizar el navegador no publica un cambio que nunca llegó al alojamiento.
- Comprueba si el cambio se registró en un commit y se envió al remoto.
- Comprueba si un despliegue correcto utilizó ese commit.
Error habitual
Tratar un guardado local como prueba de un despliegue nuevo.
Paso 2
Revisa y envía el cambio a GitHub
Comprueba la lista de archivos antes de publicarlos.
En GitHub Desktop, revisa los archivos modificados con el asistente. Crea un commit de los archivos previstos y envía la rama de práctica cuando esté lista. Excluye archivos de entorno y secretos de cuenta.
Abre el repositorio en GitHub y confirma que la página de inicio está en la raíz. Si aparece un archivo privado, retíralo antes de enviar nada.
Un ejemplo concreto
Compara los archivos modificados antes de enviarlos. index.html y style.css pertenecen a esta página pública; un .env privado no. Después del push, revisa los archivos remotos en lugar de suponer que guardar localmente los llevó a GitHub.
Pruébalo
Materiales para empezar
Si no tienes un sitio, descarga y extrae este paquete. Coloca index.html y style.css junto a netlify.toml en tu repositorio de práctica. La marca P1 ya está visible. La publicación real requiere tus cuentas de GitHub y alojamiento.
Archivos de este paso
¿Qué archivos enviaste y encuentras la página de inicio en el repositorio remoto de práctica?
Comenta tu respuesta con el tutor
Mostrar una solución desarrollada
Ejemplo de comprobación: GitHub Desktop mostraba index.html, style.css, netlify.toml y .gitignore. Hice commit y push de esos archivos. En GitHub, index.html está en la raíz; no hay .env ni archivos privados de cuenta.
- Enumera los archivos públicos previstos y comprueba que los privados queden excluidos.
- Confirma que el repositorio remoto contiene la página inicial en la raíz de publicación.
Archivos de este paso
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Pon los archivos adecuados en el repositorio
Registra un conjunto pequeño de archivos públicos y examínalo antes de enviarlo.
Procedimiento guiado: crea un repositorio de práctica en GitHub y utiliza File → Clone repository en GitHub Desktop para clonarlo en una carpeta local nueva. Añade primero el .gitignore proporcionado a la carpeta clonada. Copia después solo los archivos públicos del sitio, con index.html en la raíz, y examina los cambios antes de prepararlos y registrarlos en un commit.
En GitHub Desktop, examina Changes y las diferencias, escribe un resumen, registra el commit en la rama prevista y elige Push origin. Si aparece Publish branch, publica esa rama en el remoto. El ejemplo de comandos es una alternativa para un clon ya inicializado. Una regla de Git ignore no elimina un secreto ya registrado. Si expones una clave real, revócala y repara el repositorio; borrar el archivo actual no basta.
Ejemplo resuelto
La lista de comandos prepara archivos concretos del sitio, no todos los archivos del equipo. Después muestra el cambio preparado para que compruebes qué contiene el commit.
git add index.html style.css netlify.toml .gitignore
git diff --cached
git commit -m "Add personal website"Extra implementation exercise
Las diferencias preparadas incluyen .env con una clave de servicio. ¿Qué debes hacer antes de enviar?
Mostrar una solución desarrollada
Retira el archivo del área de preparación, mantenlo fuera del control de versiones y examina otra vez las diferencias. Si la clave llegó a un remoto u otras personas, revócala en vez de suponer que una regla de exclusión la volvió privada.
Antes de enviar, vuelve a examinar las diferencias preparadas. Si ya existían commits, examina el historial y el remoto en busca de la credencial sin copiar su valor al informe. Rota cualquier clave real expuesta; añadir .gitignore no borra la exposición anterior.
- Retira el archivo secreto de los cambios preparados.
- Comprueba si la credencial ya quedó expuesta y la rota cuando corresponde.
Error habitual
Subir una carpeta completa de desarrollo sin revisar su contenido.
Paso 3
Conecta el repositorio al alojamiento
Haz que el alojamiento publique la carpeta que contiene la página de inicio.
Crea o elige tu proyecto Netlify de práctica independiente y conecta el repositorio y rama previstos. Para este sitio sencillo usa la configuración de publicación proporcionada; no hace falta compilar un framework.
Espera a que el alojamiento indique un despliegue correcto. Abre la URL pública en una ventana privada y busca P1; una etiqueta de éxito del panel no confirma por sí sola la página correcta.
Un ejemplo concreto
Página local: P1. GitHub: P1. El alojamiento anuncia publicación, pero la URL pública muestra 404. Lo siguiente es comprobar si publica la carpeta que realmente contiene index.html.
Pruébalo
Materiales para empezar
Si no tienes un sitio, descarga y extrae este paquete. Coloca index.html y style.css junto a netlify.toml en tu repositorio de práctica. La marca P1 ya está visible. La publicación real requiere tus cuentas de GitHub y alojamiento.
Archivos de este paso
¿La URL pública muestra P1 sin iniciar sesión? Si no, ¿qué ves realmente?
Comenta tu respuesta con el tutor
Mostrar una solución desarrollada
Ejemplo de comprobación: Abrí la URL pública de práctica en una ventana privada y vi Portfolio version P1. Un fallo como «404 público; P1 local aún abre» me llevaría a la carpeta publicada y a su página inicial, no a los colores.
- Describe la página o error real obtenido en la URL pública sin sesión iniciada.
- Usa la marca P1 para distinguir la página prevista de otro despliegue.
Archivos de este paso
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Conecta el alojamiento y elige su carpeta de publicación
El alojamiento necesita saber qué repositorio usar y qué carpeta contiene los archivos públicos.
En tu cuenta Netlify crea un proyecto nuevo desde el repositorio de práctica y selecciona su rama de producción prevista. Autoriza solo el acceso de repositorio necesario. Para HTML sencillo, deja vacío el comando de compilación y publica la raíz del repositorio.
El netlify.toml proporcionado hace explícita esa raíz. Un proyecto con framework utilizaría la salida de compilación de su framework; no copies este ajuste a otro proyecto sin comprobar su estructura.
Comprueba el árbol de carpetas antes de configurar: raíz del repositorio → index.html y style.css. Para esta vía HTML, publish='.' y ningún comando de compilación van juntos. La carpeta fuente de un framework no es automáticamente su salida publicable; sus instrucciones determinan esa salida.
Ejemplo resuelto
Si la raíz contiene index.html, publicar “.” sirve ese archivo como página principal. Publicar una carpeta sin la página compilada puede producir un despliegue cuya raíz devuelve 404.
[build]
publish = "."Extra implementation exercise
El despliegue termina correctamente, pero su página principal devuelve 404. ¿Qué archivo y ajuste debes comparar?
Mostrar una solución desarrollada
Confirma que el directorio seleccionado contiene index.html. Una subida correcta no demuestra que se subiera la carpeta adecuada.
- Encuentra index.html en el repositorio o en la salida real de compilación.
- Compara esa ubicación con el directorio de publicación.
Error habitual
Introducir un comando de compilación de framework para un sitio HTML que no necesita compilarse.
Paso 4
Rastrea una página pública desactualizada
Compara el repositorio, el registro del alojamiento y el resultado del navegador.
Haz una pequeña edición y marca P2 con el asistente. Guarda, crea el commit y envíalo; examina el despliegue correspondiente. Conserva el registro P1 para comparar.
Comprueba la versión en GitHub, la desplegada y la mostrada por la URL solicitada. Actualizar el navegador no envía una edición pendiente de envío.
Un ejemplo concreto
GitHub P2 → alojamiento P1 → público P1 apunta a la publicación. GitHub P2 → alojamiento P2 → público P1 exige comprobar la URL pedida y la respuesta entregada. La misma página aparentemente antigua puede tener causas diferentes.
Pruébalo
Materiales para empezar
Si no tienes un sitio, descarga y extrae este paquete. Coloca index.html y style.css junto a netlify.toml en tu repositorio de práctica. La marca P1 ya está visible. La publicación real requiere tus cuentas de GitHub y alojamiento.
Archivos de este paso
¿Qué versiones muestran ahora repositorio, alojamiento y página pública? ¿Dónde empieza la diferencia?
Comenta tu respuesta con el tutor
Mostrar una solución desarrollada
Ejemplo de diagnóstico: GitHub contiene P2, el último despliegue correcto aún identifica el commit P1 y la página pública muestra P1. La primera diferencia está entre GitHub y el alojamiento. Revisaré la rama y el despliegue antes de atribuirlo a la caché del navegador.
- Registra por separado las versiones observadas en GitHub, el despliegue y la página pública.
- Localiza la primera diferencia y elige una comprobación en esa etapa.
Archivos de este paso
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Relaciona la página publicada con su commit
Comprueba la versión y la experiencia del visitante, no solo una insignia verde de despliegue.
Abre la URL pública del alojamiento en una ventana privada. Confirma que la página y el CSS cargan sin tu sesión de propietario. Pulsa los enlaces internos y comprueba el indicador P1.
Compara el commit registrado por el alojamiento con el último commit previsto del repositorio. Una página anticuada puede venir de un despliegue anterior, una rama inesperada o la caché. Utiliza esas observaciones para elegir la comprobación siguiente.
Ejemplo resuelto
Un registro útil contiene el commit, la URL de despliegue y el indicador visible. Si el despliegue enumera P1 pero la página contiene P0, examina la URL solicitada y la respuesta antes de cambiar ajustes de compilación al azar.
Extra implementation exercise
El repositorio contiene P2, pero el registro de despliegue nombra el commit P1. ¿Es principalmente un problema de actualizar el navegador?
Mostrar una solución desarrollada
No. Investiga por qué el alojamiento no desplegó el commit P2. Diagnostica la caché del navegador solo tras confirmar que la versión prevista está realmente desplegada.
- Identifica que P2 no se ha desplegado.
- Comprueba la selección de rama y el resultado de la última compilación.
Error habitual
Comprobar solo el panel y no abrir nunca la página como visitante.
Paso 5
Publica y verifica P2
Termina con una actualización pública real identificable.
Publica P2 por el mismo recorrido de práctica. Abre la dirección final sin sesión y prueba el enlace o contenido afectado. Conserva los identificadores de cambio/despliegue P1 y P2 de las herramientas.
Verifica la marca y la función realmente cambiada, no solo un icono verde. Indica los pasos que no terminaste.
Un ejemplo concreto
Una entrega útil de P2 une tres elementos: el cambio del repositorio, el despliegue y la nueva frase visible. Un icono verde sin el contenido público previsto deja sin comprobar el último paso.
Pruébalo
Materiales para empezar
Si no tienes un sitio, descarga y extrae este paquete. Coloca index.html y style.css junto a netlify.toml en tu repositorio de práctica. La marca P1 ya está visible. La publicación real requiere tus cuentas de GitHub y alojamiento. Los archivos y contenidos de prueba están incluidos. La verificación real requiere tu propia cuenta, buzón o dominio, según los requisitos. Puedes inspeccionar localmente; registra los pasos reales como no probados hasta ejecutarlos.
Archivos de este paso
Entrega el resultado P2 y las comprobaciones que muestran que la edición llegó a la página pública.
Qué debes entregar La URL pública de práctica, los registros P1/P2 y las comprobaciones reales sin sesión.
Comenta tu respuesta con el tutor
Mostrar una solución desarrollada
Ejemplo de entrega: La URL de práctica muestra Portfolio version P2 sin iniciar sesión. El cambio y el despliegue correcto identifican el mismo commit P2. La frase revisada aparece y Contact aún llega a su sección. Guardé el registro P1 para reconocer la versión anterior funcional.
- Relaciona el resultado público P2 con el cambio y el despliegue correspondientes.
- Describe una comprobación del contenido o acción realmente modificados en el navegador.
Archivos de este paso
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Tu tarea: publicar una segunda versión
Demuestra que el proceso funciona otra vez después de la primera publicación correcta.
Haz un cambio visible significativo, como añadir la descripción de un proyecto. Regístralo en un commit y envíalo mediante tu propio repositorio. Espera el despliegue correspondiente y verifica su página pública.
Conserva ambos registros de versión. Utilizarás la relación entre commits y despliegues al aprender vistas previas y reversiones.
Ejemplo resuelto
El registro de antes y después debe explicar qué cambió e identificar ambos commits. La URL pública por sí sola no identifica qué versión vio alguien.
Encontrarás el desarrollo completo de referencia en reference/assignment-walkthrough.txt. Compara sus pasos con tu resultado; rellena el registro de pruebas con observaciones de tu propio proyecto.
Extra implementation exercise
Publica P2 y aporta pruebas de que el alojamiento sirve el commit previsto.
- Cambia un elemento visible, actualiza el indicador de P1 a P2 y examina las diferencias.
- Registra el commit y envíalo; encuentra el despliegue correspondiente.
- Prueba la URL pública y registra el indicador nuevo.
Mostrar una solución desarrollada
Antes del primer commit, pon 'Portfolio version P1' en un párrafo visible. Guarda, examina las diferencias de Changes en GitHub Desktop, registra solo index.html/style.css/netlify.toml/.gitignore y envía la rama prevista. En la vista de archivos de GitHub, confirma que los cuatro están en la raíz.
Registra el ID del commit como P1. En Netlify selecciona el mismo repositorio y rama, deja vacío el comando de compilación y utiliza publish='.'. Relaciona el commit del despliegue correcto con P1, abre su URL pública sin sesión y lee el indicador. Cámbialo a P2, repite commit, envío y despliegue y conserva ambos registros.
Un diagnóstico útil es: repositorio=P2, despliegue=P1, indicador público=P1 → investiga rama, compilación y estado de despliegue. Otro caso es despliegue=P2, indicador=P1 → examina primero el servidor solicitado, la respuesta y la caché. No publiques un secreto para probar si Git puede ocultarlo; examina las diferencias preparadas y cualquier historial antes de enviar.
- El contenido público coincide con el cambio P2 y el commit registrado.
- La página principal, el CSS y la navegación funcionan sin acceso de propietario.
Error habitual
Afirmar que el despliegue funciona a partir de una captura de la página local.
¿Te resultó útil esta lección?
Deja un me gusta o compártela con alguien a quien pueda servirle.
Sigue aprendiendo
- Cómo crear tu primer sitio web personal
- Cómo conectar un dominio propio a tu sitio web
- Cómo configurar correo en tu propio dominio
- Cómo hacer que tu sitio web se pueda utilizar en teléfonos
- Cómo acelerar la carga de imágenes de tu sitio web
- Cómo recibir los comentarios de tu sitio web en tu bandeja de entrada
- Cómo añadir suscripciones por correo a tu sitio
- Cómo enviar correos automáticos desde tu sitio web
- Cómo guardar envíos de formularios en una base de datos
- Cómo permitir que las personas inicien sesión en tu sitio web
- Cómo mantener privada una página
- Cómo permitir que los usuarios editen su perfil
- Cómo permitir que los usuarios suban imágenes
- Cómo mantener las claves de API fuera del frontend
- Cómo mostrar datos de una API externa en tu sitio web
- Cómo añadir un chatbot de IA a tu sitio web
- Cómo hacer que un chatbot responda desde tu contenido
- Cómo añadir un blog a tu sitio web
- Cómo añadir búsqueda a tu sitio web
- Cómo añadir otro idioma a tu sitio web
- Cómo ayudar a Google a encontrar tu sitio web
- Cómo corregir la vista previa de tu sitio al compartir un enlace
- Cómo medir visitas y acciones útiles en tu sitio web
- Cómo permitir que los visitantes reserven una cita
- Cómo aceptar un pago en tu sitio web
- Cómo previsualizar cambios de tu sitio antes de publicarlos
- Cómo revertir un despliegue defectuoso de tu sitio web
- Cómo hacer copias de seguridad y restaurar los datos de tu sitio
- Cómo encontrar y corregir errores en tu sitio publicado