Bootstrap al-folio
Utilisez cette compétence lorsqu'un utilisateur demande à un agent de créer, configurer ou personnaliser un nouveau site al-folio v1.x.
Flux de travail
- Lisez
AGENTS.mdetdocs/BOUNDARIES.mdavant d'éditer. - Gardez le starter minimal : personnalisez d'abord
_config.yml,_data, les collections de contenu et les assets du site. - Laissez le comportement runtime dans les dépôts des plugins. Ne copiez pas les layouts, includes, Sass, JavaScript ou assets appartenant aux plugins dans le starter, sauf si l'utilisateur souhaite intentionnellement une surcharge locale.
- Pour la personnalisation visuelle/locale du contenu, privilégiez :
- Les indicateurs de fonctionnalités (
feature flags) et les métadonnées du site dans_config.yml _data/*.yml_pages,_posts,_projects,_news,_teachings,_bibliography- Les surcharges locales de
_includes,_layoutset_sassuniquement lorsque la configuration ou le contenu ne peut pas exprimer le changement.
- Les indicateurs de fonctionnalités (
- Exécutez la validation avant de rendre le travail :
npm ci
npm run lint:prettier
bundle exec al-folio upgrade audit --no-fail
bundle exec jekyll build --baseurl /al-folio
Routage
- Câblage du starter / documentation / exemples / tests : éditez
al-folio. - Layouts / includes / assets partagés : utilisez
al_folio_core. - Rendu du CV : utilisez
al_folio_cv. - Runtime Distill : utilisez
al_folio_distill. - Recherche / icônes / mathématiques / commentaires / analytiques / citations / posts externes / newsletter / graphiques / images : utilisez le dépôt du plugin
al-*propriétaire.
Remise
Résumez les fichiers modifiés, les résultats de validation et toutes les surcharges locales créées.