Objetivos de aprendizaje

Al final de esta clase podrán:

Entender qué es GitHub Pages y para qué sirve en investigación y docencia.
Publicar un sitio estático desde un repositorio.
Diferenciar un flujo manual y uno automatizado con GitHub Actions.
Aplicar una lista mínima de control de calidad antes de publicar.
Anotar sitios web con hypothes.is

Contenidos

1. Por qué publicar resultados en la web
2. Fundamentos de GitHub Pages
3. Flujos de publicación
4. Buenas prácticas y errores frecuentes
5. Anotación web con hypothes.is

Contenidos

1. Por qué publicar resultados en la web
2. Fundamentos de GitHub Pages
3. Flujos de publicación
4. Buenas prácticas y errores frecuentes
5. Anotación web con hypothes.is

1) Por qué publicar resultados en la web

Transparencia: mostrar resultados, decisiones y actualizaciones.
Reproducibilidad: vincular código, datos y documentos.
Comunicación pública: acceso sencillo para estudiantes y colegas.
Trazabilidad: cada cambio queda registrado en el historial.
Revisión: facilita la revisión eficiente por pares en diferentes dispositivos

Casos de uso en ciencias sociales

Sitio del curso con programa, clases y recursos.
Sitio de proyecto con reportes, tablas y visualizaciones.
Documentación metodológica para equipos de investigación.
Repositorio de resultados intermedios y versiones finales.

Contenidos

1. Por qué publicar resultados en la web
2. Fundamentos de GitHub Pages
3. Flujos de publicación
4. Buenas prácticas y errores frecuentes
5. Anotación web con hypothes.is

Qué es GitHub Pages

Servicio de hosting para sitios estáticos.
Publica HTML, CSS, JS e imágenes directamente desde GitHub.
La lógica es que se genera una acción automática (github action) cada vez que se actualiza el repositorio.

-> Es decir, cada vez que se hace un commit/push, se ejecuta un proceso de construcción que genera la página web y la publica automáticamente.

Contenidos

1. Por qué publicar resultados en la web
2. Fundamentos de GitHub Pages
3. Flujos de publicación
4. Buenas prácticas y errores frecuentes
5. Anotación web con hypothes.is

Flujo

Editar contenido.
Renderizar sitio localmente.
Confirmar que carpeta docs se está actualizando correctamente.
Commit + push.
Verificar página publicada.

Configuración visual en GitHub (paso a paso)

Ir a Settings -> Pages del repositorio.
Definir fuente de publicación (branch/carpeta o workflow).
Confirmar URL publicada y estado del deploy.

Paso 1: Settings -> Pages

Configuración de GitHub Pages en Settings

Paso 2: Build and deployment

Sección Build and deployment de GitHub Pages

Paso 3: Verificación en Actions

Panel de GitHub Actions para revisar despliegue

Contenidos

1. Por qué publicar resultados en la web
2. Fundamentos de GitHub Pages
3. Flujos de publicación
4. Buenas prácticas y errores frecuentes
5. Anotación web con hypothes.is

Checklist antes de publicar

Título, menú y navegación correctos.
Enlaces internos y externos funcionando.
Gráficos/tablas visibles en móvil y escritorio.
Metadatos básicos presentes (título, descripción, autor).
Página principal actualizada y consistente con contenidos nuevos.

Errores frecuentes

El sitio no se actualiza: se editó fuente pero no se regeneró salida.
Rutas rotas: se movieron archivos sin ajustar links.
Fallo de permisos: workflow sin permisos para publicar.
Caché del navegador: aparenta no actualizar, pero el deploy sí ocurrió.

Diagnóstico rápido

Revisar último commit en GitHub.
Revisar estado del workflow en Actions.
Abrir logs del paso que falla.
Confirmar carpeta de salida y rutas relativas.
Probar en modo incógnito para descartar caché.

Contenidos

1. Por qué publicar resultados en la web
2. Fundamentos de GitHub Pages
3. Flujos de publicación
4. Buenas prácticas y errores frecuentes
5. Anotación web con hypothes.is

Comentar sitios web con Hypothes.is

Hypothes.is permite anotar y discutir textos directamente sobre páginas web y PDFs.

Permite comentarios individuales o por grupos.
Se puede hacer réplica a los comentarios
Deja evidencia del proceso de lectura y argumentación.
Gratuito y funciona desde el navegador sin necesidad de instalar software adicional.

Paso 1: Crear cuenta

Ir a web.hypothes.is y seleccionar la opción de registro.
Completar correo, usuario y contraseña.
Confirmar el correo para activar la cuenta.

Paso 2: Registro en hypothes.is

Paso 3: Comentar una web

Instalar la extensión de navegador de Hypothes.is.
Abrir una página web y activar el panel de anotaciones.
Seleccionar texto, escribir comentario y etiquetar.
Elegir visibilidad: público o grupo privado

:::

Cierre

GitHub Pages permite publicar rápido y con trazabilidad.
La calidad final depende del flujo, no solo de la herramienta.
Publicar bien es parte del método de investigación abierta.
hypothes.is es una herramienta sencilla para obtener comentarios discusión de resultados publicados en html