Semana 03 · Guía de trabajo

Publicar mi primera versión

Repositorio, sitio web y pruebas: tres cosas que debes distinguir.

Antes de subir: tu proyecto solo necesita index.html y README.md. Revisa datos ficticios y nombres exactos. No publiques el ZIP del curso, el respaldo JSON ni las guías privadas.

Desde el navegador

Prepara tu versión

En el taller, descarga el HTML y README. Abre el HTML y prueba una entrada válida y otra inválida. Guarda ambos archivos en una carpeta limpia.

Crea un repositorio propio

Inicia sesión en GitHub. Usa New repository; nombre sugerido: et505-aularecursos. Para la opción de GitHub Free con Pages, utiliza un repositorio público. No necesitas comprar un dominio.

Sube los archivos, no el ZIP

En el repositorio, Add file → Upload files, o el enlace para subir archivos de un repositorio vacío. Selecciona index.html y README.md. Deben quedar en la raíz, no dentro de otra carpeta.

Registra el cambio

Escribe un mensaje que describa tu modificación. Confirma el cambio en tu rama principal. Según la interfaz, puede mostrarse Commit changes o un flujo de propuesta; completa el flujo de tu propio repositorio.

Activa GitHub Pages

En Settings → Pages → Build and deployment → Source, elige Deploy from a branch. Selecciona main y /(root), y pulsa Save. Si la rama tiene otro nombre, usa la que contiene index.html.

Comprueba la publicación

Espera a que finalice. GitHub indica que puede tardar hasta unos 10 minutos. En Pages, usa Visit site. Si hay error, revisa el estado de la publicación, la rama, carpeta y nombre del archivo.

Verifica desde el sitio

Haz la prueba normal y la de error también en la web publicada. En el taller, conserva el enlace al repositorio y el enlace que realmente funciona. Mantén pendiente lo que no se haya publicado.

Publica una mejora posterior

Guarda una copia previa. Sube el index.html modificado al mismo repositorio y registra un mensaje nuevo. Espera la actualización y vuelve a comprobar que la aplicación funciona.

Repositorio

Ejemplo de formato: github.com/USUARIO/REPOSITORIO. Permite consultar archivos y cambios.

Sitio publicado

Ejemplo de formato: USUARIO.github.io/REPOSITORIO/. Es la aplicación que abre el usuario.

Los formatos anteriores son ejemplos, no enlaces publicados de un estudiante. Usa la URL real que muestre GitHub.

Qué demuestra la primera publicación

Que puedes preparar y compartir una versión y explicar sus límites. Pages publica archivos estáticos; no añade cuentas, API propia ni una base de datos compartida a tu aplicación.

Base: GitHub Docs · Crear un sitio con Pages · GitHub Docs · Configurar la publicación · GitHub Docs · Añadir archivos. Ejemplos y secuencia: elaboración didáctica del curso.

Volver al taller