Skip to content

Ressources tierces (bundles locaux)

Les bibliothèques tierces (Bootstrap, jQuery, Bootstrap Icons, MathJax, Mermaid, Font Awesome, GitHub Calendar, etc.) sont committées sous assets/vendor/. La build Jekyll par défaut de GitHub Pages n'exécute ni npm ni curl, donc tout ce dont le thème a besoin à l'exécution doit être présent dans le dépôt (ou dans la gem publiée).

Rafraîchir les fichiers tiers (mainteneurs)

  1. Manifeste : vendor-manifest.json liste les ressources basées sur curl (Bootstrap, MathJax, etc.) avec des sommes de contrôle SHA-256.
  2. Mermaid (npm uniquement) : Le thème ne télécharge pas Mermaid depuis jsDelivr. Installez le paquet et copiez le fichier dist compilé :
npm install
npm run vendor:mermaid

scripts/vendor-install.sh exécute aussi cette étape de copie après les téléchargements du manifeste lorsque node_modules/mermaid est présent.

  1. Rafraîchissement complet des ressources tierces : Depuis la racine du dépôt :
npm install
./scripts/vendor-install.sh

Options : --force (retélécharger les fichiers du manifeste), --dry-run, --verbose.

  1. Dépendances : curl, jq, et sha256sum ou shasum (macOS). Node/npm pour Mermaid. L'image Docker de développement installe jq pour ce workflow.

  2. Raccourci npm pour les téléchargements du manifeste uniquement :

npm run vendor:install

Après la mise à niveau des versions, mettez à jour package.json / le lockfile pour Mermaid ou le manifeste pour les ressources curl, puis committez les changements sous assets/vendor/.

Build npm optionnelle de Bootstrap (avancé)

npm run css:bootstrap compile le SCSS de Bootstrap en assets/css/vendor/bootstrap-from-npm.css. Le thème par défaut n'utilise pas ce fichier ; il utilise assets/vendor/bootstrap/css/bootstrap.min.css. Ne liez pas les deux feuilles de style Bootstrap complètes.

Includes associés

  • _includes/core/head.html — Bootstrap CSS, Bootstrap Icons, MathJax, main.css
  • _includes/components/js-cdn.html — jQuery, bundle Bootstrap
  • _includes/components/mermaid.html — Mermaid + Font Awesome (lorsque mermaid: true)
  • _config.yml — mermaid.src pointe vers le chemin local mermaid.min.js

Voir aussi

  • [[Development]]
  • [[Bootstrap Integration]]
  • [[Dependency Updates]]