Migration vers al-folio v1
Utilisez cette compétence lorsqu'un utilisateur demande à un agent de migrer un fork personnalisé d'al-folio vers la version 1.x.
Workflow
- Travaillez dans une branche, un fork ou un clone jetable. N'écrasez pas le site original de l'utilisateur.
- Partez du contrat de démarrage v1, puis importez les fichiers propres au site :
- Valeurs de
_config.yml _data_bibliography- les collections de contenu
- les assets du site
- les surcharges locales intentionnelles de
_includes,_layoutset_sass
- Valeurs de
- Conservez le câblage des plugins de la v1 à partir du starter :
theme: al_folio_core- les gems
al_*etal_folio_*groupées dansGemfile - les entrées de plugins groupées dans
_config.yml
- Supprimez les fichiers runtime copiés obsolètes qui sont désormais gérés par les plugins, sauf s'il s'agit de surcharges intentionnelles.
- Exécutez les vérifications de mise à niveau :
bundle exec al-folio upgrade audit --no-fail
bundle exec al-folio upgrade overrides audit
- Pour chaque surcharge obsolète ou non reconnue :
bundle exec al-folio upgrade overrides diff LOCAL_PATH
bundle exec al-folio upgrade overrides accept LOCAL_PATH
- Construisez et inspectez les pages clés : accueil, CV, publications, dépôts, projets, articles et toutes les routes personnalisées.
Notes de migration
Validez .al-folio-overrides.yml lorsque le site conserve intentionnellement des surcharges locales. Ce fichier enregistre le dernier checksum du fichier plugin amont examiné, afin que les futures mises à jour de gemmes puissent signaler explicitement les dérives.
Transmission
Signalez les fichiers runtime obsolètes supprimés, les surcharges locales conservées, les différences visuelles non résolues et les commandes de validation exactes.