Configura GitHub Pages

Elige GitHub Actions y comprueba las rutas de tu sitio.

Tu guía paso a paso

1. 01

   Abre tu repositorio en GitHub y entra a Settings → Pages. En Build and deployment selecciona Source: GitHub Actions. Necesitas permisos de administración sobre ese repositorio.

2. 02

   Comprueba en Settings → Actions → General que GitHub Actions esté habilitado y que las acciones oficiales de actions estén permitidas. El workflow solicita solamente los permisos necesarios en el trabajo de despliegue.

3. 03

   Un proyecto normal publica en https://OWNER.github.io/my-linux-notes/. Un repositorio OWNER.github.io publica en la raíz. La acción configure-pages obtiene automáticamente la ruta real y la pasa al script mediante PAGES_BASE_PATH.

4. 04

   Prueba localmente la ruta de subdirectorio antes de publicar. El script genera assets con /my-linux-notes/ para que JavaScript y CSS no den 404. En PowerShell usa $env:PAGES_BASE_PATH="/my-linux-notes"; npm run build.

5. 05

   GitHub Pages sirve archivos estáticos. Este starter guarda notas localmente y no necesita Express ni credenciales AWS. La API Node del taller anterior requiere otro servidor; no la publiques como si Pages pudiera ejecutarla.

6. 06

   Si agregas un dominio propio, configúralo en Settings → Pages y en DNS. La ruta base vuelve a ser la raíz; configure-pages la detecta. Espera la verificación del dominio y activa Enforce HTTPS cuando esté disponible.

PAGES_BASE_PATH=/my-linux-notes npm run build
npm run preview
# Open / Abre: http://127.0.0.1:4173/my-linux-notes/
# Root site / Sitio en la raíz:
PAGES_BASE_PATH="" npm run build