al-folio v1 迁移
使用此技能当用户要求AI助手将现有的自定义al-folio分支迁移到v1.x版本。
工作流程
- 在可丢弃的分支、fork或clone中工作。不要覆盖用户的原始站点。
- 从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 本地路径
bundle exec al-folio upgrade overrides accept 本地路径
- 构建并检查关键页面：首页、简历、出版物、仓库、项目、博客文章以及任何自定义路由。
迁移说明
当站点有意保留本地覆盖时，请提交 .al-folio-overrides.yml。该文件记录了上次审核的上游插件文件校验和，以便未来的gem更新能够明确标记更改。
交接
报告已删除的过时运行时文件、保留的本地覆盖、未解决的可视差异以及确切的验证命令。