al-folio v1 遷移 是做什麼的?
當使用者要求代理程式將現有自訂的 al-folio 分支遷移至 v1.x 時使用此技能。
工作流程
- 在可拋棄的分支、複製或複製環境中操作。請勿覆蓋使用者的原始站點。
- 從 v1 入門合約開始,然後帶入站點自有的檔案:
_config.yml的數值_data_bibliography- 內容集合
- 站點資產
- 刻意保留的本機
_includes、_layouts和_sass覆蓋覆寫
- 保留入門合約中的 v1 外掛程式配線:
theme: al_folio_core- 在
Gemfile中捆綁的al_*與al_folio_*Gem - 在
_config.yml中捆綁的外掛程式條目
- 移除現在由外掛程式擁有的過時複製執行時期檔案,除非是刻意保留的覆蓋覆寫。
- 執行升級檢查:
bundle exec al-folio upgrade audit --no-fail
bundle exec al-folio upgrade overrides audit
- 針對每個過時或未認可的覆蓋覆寫:
bundle exec al-folio upgrade overrides diff LOCAL_PATH
bundle exec al-folio upgrade overrides accept LOCAL_PATH
- 建立並檢查主要頁面:首頁、CV、論文、倉庫、專案、文章以及任何自訂路由。
遷移注意事項
當站點刻意保留本機覆蓋覆寫時,請提交 .al-folio-overrides.yml。它會記錄上次審查的上游外掛程式檔案校驗和,以便未來 Gem 更新時能明確標示差異。
交接
報告已移除的過時執行時期檔案、保留的本機覆蓋覆寫、未解決的視覺差異以及確切的驗證指令。