Skip to content
/ eleventy-dsfr Public template

Template pour la création d'un site utilisant le système de design de l'État avec Eleventy.

License

Notifications You must be signed in to change notification settings

codegouvfr/eleventy-dsfr

Repository files navigation

img build

eleventy-dsfr

Un dépôt pour démarrer un site statique au DSFR avec le générateur Eleventy, déployé pour démonstration sur GitHub Pages. Pour d'autres exemples de réutilisation, cf. Démonstration et réutilisations.

Screenshot of the website front page.

Fonctionnalités

Prise en main

Installation

Cloner le dépôt :

git clone https://github.com/codegouvfr/eleventy-dsfr.git my-site-name

Naviguer dans le dossier :

cd my-site-name

Installer les dépendances :

npm install

Exécuter Eleventy :

Construire un livrable, indexé avec pagefind pour la recherche :

npm run build

L'exécuter sur le serveur de développement local :

npm start

Ou exécuter un mode de débogage.

Réutilisation

Développement

Voir aussi la documentation des composants

  • Ajouter des chaînes de caractères localisées dans le dossier _data/i18n/[lang]/index.js.
    • Pour ajouter une nouvelle traduction, ajouter un dossier [lang] dans content, un nouveau fichier _data/i18n/[lang]/index.js et l'inclure dans _data/i18n/index.js.
  • Ajouter des styles personnalisés et des images dans le dossier public.
    • Celui-ci sera copié tel quel dans le dossier de sortie. Cela signifie que ./public/css/* persistera dans ./_site/css/* après la construction du livrable.
  • Compléter le README et la documentation. 😀

Ajout de contenu

Voir la documentation des fonctionnalités et du Markdown

Déploiement

En cas d'erreur lors du build :

Error: Get Pages site failed
Error: HttpError: Not Found

Essayer cette configuration.

Documentation

La suite de la documentation (composants, fonctionnalités) est disponible dans content/fr/blog/posts ou directement sur le site de démonstration.

Démonstration et réutilisations

Pour une démonstration, voir la GitHub Pages correspondante.

Licence

Le dépôt est publié sous licence MIT pour le code et sous licence Etalab 2.0 pour les autres contenus.

Il est maintenu par la mission logiciels libres de la DINUM.

Crédits images