Migração para al-folio v1
Use esta habilidade quando um usuário pedir a um agente para migrar um fork personalizado do al-folio para a versão v1.x.
Fluxo de Trabalho
- Trabalhe em um branch, fork ou clone descartável. Não sobrescreva o site original do usuário.
- Inicie a partir do contrato inicial da v1, depois traga os arquivos de propriedade do site:
- Valores de
_config.yml _data_bibliography- Coleções de conteúdo
- Assets do site
- Sobrescritas intencionais locais de
_includes,_layoutse_sass
- Valores de
- Mantenha a estrutura de plugins da v1 vinda do modelo inicial:
theme: al_folio_core- Gems
al_*eal_folio_*agrupadas noGemfile - Entradas de plugins agrupadas em
_config.yml
- Remova arquivos de runtime copiados obsoletos que agora são gerenciados por plugins, a menos que sejam sobrescritas intencionais.
- Execute verificações de upgrade:
bundle exec al-folio upgrade audit --no-fail
bundle exec al-folio upgrade overrides audit
- Para cada sobrescrita obsoleta ou não reconhecida:
bundle exec al-folio upgrade overrides diff LOCAL_PATH
bundle exec al-folio upgrade overrides accept LOCAL_PATH
- Construa e inspecione as principais páginas: home, CV, publicações, repositórios, projetos, posts e quaisquer rotas personalizadas.
Notas de Migração
Confirme o arquivo .al-folio-overrides.yml quando o site mantém intencionalmente sobrescritas locais. Ele registra a soma de verificação do arquivo do plugin upstream que foi revisado por último, para que futuras atualizações de gemas possam sinalizar desvios explicitamente.
Handoff
Relate os arquivos de runtime obsoletos removidos, as sobrescritas locais mantidas, as diferenças visuais não resolvidas e os comandos de validação exatos.