al-folio v1 Migration
Verwenden Sie diese Fähigkeit, wenn ein Benutzer einen Agenten bittet, eine vorhandene, angepasste al-folio-Gabelung auf v1.x zu migrieren.
Arbeitsablauf
- Arbeiten Sie in einem temporären Branch, Fork oder Klon. Überschreiben Sie nicht die ursprüngliche Seite des Benutzers.
- Beginnen Sie vom v1-Startvertrag, dann übertragen Sie seiten eigene Dateien:
_config.ymlWerte_data_bibliography- Inhaltssammlungen
- Seiten-Assets
- absichtliche lokale
_includes,_layoutsund_sassÜberschreibungen
- Behalten Sie die v1-Plugin-Verkabelung vom Starter bei:
theme: al_folio_core- gebündelte
al_*undal_folio_*Edelsteine inGemfile - gebündelte Plugin-Einträge in
_config.yml
- Entfernen Sie veraltete kopierte Laufzeit-Dateien, die jetzt im Besitz der Plugins sind, es sei denn, es handelt sich um absichtliche Überschreibungen.
- Führen Sie Upgrade-Überprüfungen durch:
bundle exec al-folio upgrade audit --no-fail
bundle exec al-folio upgrade overrides audit
- Für jede veraltete oder nicht bestätigte Überschreibung:
bundle exec al-folio upgrade overrides diff LOCAL_PATH
bundle exec al-folio upgrade overrides accept LOCAL_PATH
- Bauen und überprüfen Sie wichtige Seiten: Home, Lebenslauf, Publikationen, Repositories, Projekte, Beiträge und benutzerdefinierte Routen.
Migrationsnotizen
Committen Sie .al-folio-overrides.yml, wenn die Seite absichtlich lokale Überschreibungen behält. Es zeichnet die zuletzt überprüfte Prüfsumme der Upstream-Plugin-Datei auf, sodass zukünftige Gem-Updates Abweichungen explizit kennzeichnen können.
Übergabe
Melden Sie entfernte veraltete Laufzeit-Dateien, beibehaltene lokale Überschreibungen, ungelöste visuelle Unterschiede und genaue Validierungsbefehle.