Publicar la documentación

Este sitio se publica en GitHub Pages desde el repositorio. El despliegue incluye únicamente la documentación generada.

Publicación automática

En Settings → Pages → Build and deployment, la fuente es GitHub Actions. El workflow .github/workflows/pages.yml construye y prueba la documentación; los cambios enviados a main publican el resultado. Los pull requests solo validan cambios. También puedes ejecutar Documentation Pages → Run workflow sobre main.

El artefacto es docs/site/.vitepress/dist. No incluye datos locales, credenciales ni el servidor de Hyperion. El despliegue usa el entorno github-pages, con permisos pages: write e id-token: write.

Idiomas y rutas

El español sigue en la raíz del sitio; el inglés está en /en/. Las páginas equivalentes conservan su ruta para que el selector cambie de idioma sin perder la ubicación. Ambos idiomas se publican juntos.

La ruta local predeterminada es /hyperion/. En producción se usa la ruta configurada en GitHub Pages; scripts/check-pages.mjs verifica que los recursos generados existen y pertenecen a ese prefijo antes de subir el artefacto.

Verificar antes de publicar

npm --prefix docs/site ci
npm --prefix docs/site exec -- playwright install chromium
npm --prefix docs/site test

Puedes abrir el resultado con npm --prefix docs/site run preview y visitar http://127.0.0.1:4175/hyperion/.

Con GitHub Actions activado, si falla el despliegue, revisa el workflow Documentation Pages en Actions. Para volver a publicar, usa Run workflow sobre main. Si el contenido es incorrecto, revierte el cambio en el repositorio y deja que el workflow vuelva a publicar.

Referencias: despliegue de VitePress y workflows de GitHub Pages.

El workflow reconstruye el sitio con la ruta devuelta por GitHub Pages (HYPERION_DOCS_BASE). Así, un cambio de nombre del repositorio no deja los recursos apuntando a la ruta anterior. Las pruebas locales conservan /hyperion/ como ruta de referencia.

La instalación del navegador de pruebas tiene un límite de cinco minutos para evitar que un runner bloqueado retenga el despliegue indefinidamente.