krishnendu-pain/krishnendu-pain.github.io

al-folio v1 마이그레이션

사용자가 에이전트에게 기존 맞춤형 al-folio 포크를 v1.x로 마이그레이션하도록 요청할 때 이 스킬을 사용하세요.

워크플로우

1. 임시 브랜치, 포크, 또는 클론에서 작업하세요. 사용자의 원본 사이트를 덮어쓰지 마십시오.
2. v1 스타터 템플릿으로 시작한 후, 사이트 소유 파일을 가져옵니다:
   • _config.yml 값
   • _data
   • _bibliography
   • 콘텐츠 컬렉션
   • 사이트 에셋
   • 의도적인 로컬 _includes, _layouts, _sass 오버라이드
3. 스타터 템플릿의 v1 플러그인 연결을 유지합니다:
   • theme: al_folio_core
   • Gemfile의 번들 al_* 및 al_folio_* 젬
   • _config.yml의 번들 플러그인 항목
4. 플러그인이 소유하게 된 오래된 복사된 런타임 파일을 제거합니다(의도적인 오버라이드가 아닌 경우).
5. 업그레이드 검사를 실행합니다:

bundle exec al-folio upgrade audit --no-fail
bundle exec al-folio upgrade overrides audit

6. 오래되었거나 인정되지 않은 오버라이드 각각에 대해:

bundle exec al-folio upgrade overrides diff LOCAL_PATH
bundle exec al-folio upgrade overrides accept LOCAL_PATH

7. 핵심 페이지를 빌드하고 검사합니다: 홈, CV, 출판물, 저장소, 프로젝트, 포스트 및 사용자 정의 경로.

마이그레이션 참고 사항

사이트가 의도적으로 로컬 오버라이드를 유지할 때 .al-folio-overrides.yml을 커밋하세요. 이 파일은 마지막으로 검토된 업스트림 플러그인 파일의 체크섬을 기록하여, 향후 gem 업데이트에서 변경 사항을 명시적으로 표시할 수 있게 합니다.

인계

제거된 오래된 런타임 파일, 유지된 로컬 오버라이드, 해결되지 않은 시각적 차이점 및 정확한 검증 명령어를 보고하세요.