Se ha configurado el proyecto para que GitHub Pages publique automáticamente desde la carpeta docs/ en la rama mi-cambio.
- Cambio: Descomentadas las líneas que ignoraban
docs/ - Razón: Ahora necesitamos versionar la carpeta
docs/para que GitHub Pages la pueda leer
- Cambio: Workflow completamente rediseñado
- Nuevo comportamiento:
- Se ejecuta al hacer push a
mi-cambio(antes eramain) - Genera el build con
jupyter-book build ./content - Copia todo el contenido de
content/_build/html/adocs/ - Crea archivo
.nojekyllendocs/(importante para GitHub Pages) - Hace commit automático de los cambios en
docs/con el mensaje:"Auto-update docs/ from Jupyter Book build [skip ci]" - El
[skip ci]evita que el commit dispare el workflow nuevamente (previene loops infinitos)
- Se ejecuta al hacer push a
- Nuevo archivo: Indica a GitHub Pages que NO use Jekyll para procesar los archivos
- Importante: Sin este archivo, GitHub Pages procesará incorrectamente algunos archivos con guiones bajos
El workflow sftp-deploy.yml sigue funcionando correctamente y no requiere modificaciones:
- Se ejecuta al hacer push a
mi-cambio - Genera su propio build independiente
- Modifica temporalmente el
baseurlen_config.ymlpara USAL - Sube el contenido al servidor USAL por SFTP
Para que esto funcione, debes configurar GitHub Pages en tu repositorio:
- Ve a tu repositorio en GitHub
- Settings → Pages
- En "Source", selecciona:
- Branch:
mi-cambio - Folder:
/docs
- Branch:
- Guarda los cambios
1. Haces cambios en content/
2. Haces commit y push a mi-cambio
3. Se disparan AMBOS workflows en paralelo:
Workflow A (main.yml):
- Genera build
- Copia a docs/
- Hace commit automático de docs/
- GitHub Pages detecta cambio y publica
Workflow B (sftp-deploy.yml):
- Genera build con baseurl diferente
- Sube a servidor USAL por SFTP
- GitHub Pages:
https://[tu-usuario].github.io/python-TIF/ - Hosting USAL: (la URL que ya tienes configurada)
- ✅ Los archivos HTML están versionados en
docs/(puedes ver el historial) - ✅ GitHub Pages lee directamente de la rama
mi-cambio - ✅ No hay confusión con ramas separadas (todo en
mi-cambio) - ✅ El workflow SFTP sigue funcionando independientemente
- ✅ Prevención de loops infinitos con
[skip ci] - ✅ Solo se disparan los workflows cuando cambias archivos relevantes
- Permisos: El workflow usa
GITHUB_TOKENque GitHub proporciona automáticamente. Asegúrate de que en Settings → Actions → General → Workflow permissions esté en "Read and write permissions" - Primera ejecución: La primera vez que hagas push después de estos cambios, verás que el workflow genera un commit adicional con los archivos en
docs/ - Conflictos: Si trabajas localmente y haces cambios manuales en
docs/, pueden surgir conflictos. La recomendación es NO modificardocs/manualmente, dejarlo solo para el workflow
- Ve a Settings → Actions → General → Workflow permissions
- Selecciona "Read and write permissions"
- Marca "Allow GitHub Actions to create and approve pull requests"
- Verifica que hayas configurado Pages para leer de
mi-cambio/docs - Asegúrate de que el archivo
.nojekyllexiste endocs/ - Espera unos minutos, GitHub Pages puede tardar en actualizar
- Verifica que
baseurl: /python-TIF/en_config.ymlsea correcto - El
baseurldebe coincidir con el nombre de tu repositorio
- Asegúrate de que el mensaje de commit incluya
[skip ci] - Esto está ya configurado en el workflow, pero si lo modificas, mantenlo
- Hacer commit de estos cambios
- Push a
mi-cambio - Configurar GitHub Pages en el repositorio (Settings → Pages)
- Esperar a que el workflow se ejecute
- Verificar que
docs/se actualice automáticamente - Acceder a la URL de GitHub Pages para confirmar que funciona