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.

Comenzar la lección interactivaLeer los apuntes

¿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.

Archivos del taller

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

Start hereArchivos del taller

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.

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.

Archivos de este paso

Start hereArchivos del taller

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.

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.

Netlify: crear despliegues

Archivos de este paso

Start hereArchivos del taller

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 = "."

Netlify: crear despliegues

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.

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.

Archivos de este paso

Start hereArchivos del taller

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.

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.

Archivos de este paso

Start hereArchivos del taller

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.

  1. Cambia un elemento visible, actualiza el indicador de P1 a P2 y examina las diferencias.
  2. Registra el commit y envíalo; encuentra el despliegue correspondiente.
  3. 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.

¿Te resultó útil esta lección?

Deja un me gusta o compártela con alguien a quien pueda servirle.

Sigue aprendiendo

Explora las otras lecciones