al-folio v1 マイグレーション は何をしますか？
このスキルは、ユーザーがカスタマイズされた既存の al-folio フォークを v1.x に移行するようエージェントに依頼したときに使用します。
ワークフロー
- 使い捨てのブランチ、フォーク、またはクローンで作業します。ユーザーの元のサイトを上書きしないでください。
- v1 スターターコントラクトから開始し、サイト所有のファイルを移行します:
_config.ymlの値_data_bibliography- コンテンツコレクション
- サイトアセット
- 意図的に追加したローカルの
_includes、_layouts、_sassのオーバーライド
- v1 プラグインの配線はスターターからそのまま維持:
theme: al_folio_coreGemfile内のバンドルされた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 更新で明示的にドリフトを検出できるようにします。
引き継ぎ
削除した古いランタイムファイル、保持したローカルオーバーライド、未解決の視覚的な差異、および正確なバリデーションコマンドを報告します。