Migración a al-folio v1
Usa esta skill cuando un usuario le pida a un agente migrar una bifurcación al-folio personalizada existente a la versión v1.x.
Flujo de trabajo
- Trabaja en una rama, bifurcación o clon desechable. No sobrescribas el sitio original del usuario.
- Comienza desde el contrato inicial de v1, luego incorpora los archivos propiedad del sitio:
- Valores de
_config.yml _data_bibliography- colecciones de contenido
- activos del sitio
- anulaciones intencionadas locales de
_includes,_layoutsy_sass
- Valores de
- Mantén el cableado de plugins de v1 del iniciador:
theme: al_folio_core- gemas
al_*yal_folio_*incluidas enGemfile - entradas de plugins incluidas en
_config.yml
- Elimina archivos runtime copiados obsoletos que ahora son propiedad de los plugins, a menos que sean anulaciones intencionadas.
- Ejecuta las verificaciones de actualización:
bundle exec al-folio upgrade audit --no-fail
bundle exec al-folio upgrade overrides audit
- Para cada anulación obsoleta o no reconocida:
bundle exec al-folio upgrade overrides diff LOCAL_PATH
bundle exec al-folio upgrade overrides accept LOCAL_PATH
- Compila e inspecciona las páginas clave: inicio, CV, publicaciones, repositorios, proyectos, entradas y cualquier ruta personalizada.
Notas de migración
Confirma .al-folio-overrides.yml cuando el sitio mantenga intencionadamente anulaciones locales. Registra la suma de verificación del archivo del plugin ascendente que se revisó por última vez, de modo que futuras actualizaciones de gemas puedan marcar explícitamente las diferencias.
Entrega
Informa sobre archivos runtime obsoletos eliminados, anulaciones locales retenidas, diferencias visuales no resueltas y comandos de validación exactos.