al-folio 啟動器
在用戶要求代理程式建立、設定或個人化全新的 al-folio v1.x 網站時使用此技能。
工作流程
- 在編輯前先閱讀
AGENTS.md和docs/BOUNDARIES.md。 - 保持入門專案輕量:首先自訂
_config.yml、_data、內容集合以及網站資產。 - 將執行時期行為保留在插件儲存庫中。除非用戶有意要求本機覆寫,否則請勿將插件擁有的佈局、包含檔案、Sass、JavaScript 或資產複製到入門專案中。
- 對於本機視覺/內容自訂,優先採用:
_config.yml的功能旗標和網站元資料_data/*.yml_pages、_posts、_projects、_news、_teachings、_bibliography- 僅在設定或內容無法表達變更時,才使用本機
_includes、_layouts和_sass覆寫
- 在交回工作前執行驗證:
npm ci
npm run lint:prettier
bundle exec al-folio upgrade audit --no-fail
bundle exec jekyll build --baseurl /al-folio
路由
- 入門專案的接線/文件/範例/測試:編輯
al-folio。 - 共享的佈局/包含檔案/資產:使用
al_folio_core。 - CV 渲染:使用
al_folio_cv。 - Distill 執行時期:使用
al_folio_distill。 - 搜尋/圖示/數學/評論/分析/引用/外部文章/電子報/圖表/圖片:使用各自擁有的
al-*插件儲存庫。
交接
總結變更的檔案、驗證結果,以及任何已建立的本機覆寫。