bookish
1.0.0
Voir le site de démonstration
Bookish est un profil d'installation pour Drupal 9+ qui tente de rendre l'expérience prête à l'emploi pour les utilisateurs de Tome aussi agréable que possible.
En termes de fonctionnalités, Bookish est similaire au profil Standard. La majeure partie du travail dans ce profil a consisté à rendre l'expérience d'édition et l'interface aussi modernes que possible.
Certaines fonctionnalités principales sont :
La meilleure façon d'utiliser Bookish est d'utiliser le projet Tome Composer.
Les conditions requises pour utiliser Tome localement sont :
Vous pouvez également exécuter les commandes ci-dessous à l’aide de l’image Docker mortenson/tome. Consultez la documentation du script Docker pour référence.
Le Drush Launcher, qui permet de taper simplement drush , n'est pas obligatoire pour utiliser Tome. S’il n’est pas disponible, utilisez plutôt vendor/bin/drush .
Pour installer Tome et Bookish, exécutez ces commandes :
composer create-project drupal-tome/tome-project my_site --stability dev --no-interaction
cd my_site
composer require drupal-tome/bookish
drush tome:init # Select Bookish in the prompt
Vous pouvez désormais valider votre base de code initiale, votre contenu, votre configuration et vos fichiers sur Git.
Pour démarrer un serveur Web local, exécutez :
drush runserver
puis dans un autre onglet, exécutez :
drush uli -l 127.0.0.1:8888
et cliquez sur le lien pour commencer l'édition.
Pour réinstaller votre site, exécutez :
drush tome:install
Pour plus d'informations sur le déploiement de votre site, vous pouvez visiter /admin/help/topic/bookish_help.tome sur votre site local ou lire la documentation sur https://tome.fyi/docs.
Si vous ne souhaitez pas utiliser Tome, vous pouvez l'exécuter à partir de n'importe quelle installation Drupal 9+ :
composer require drupal-tome/bookish
drush si bookish -y
drush pmu tome -y
Après vous être connecté, cliquez sur "Aide" dans la barre d'outils. Ce module dispose d'une documentation complète située dans Drupal à l'aide du module Rubriques d'aide. Un bon point de départ serait la page « Configuration de votre site Bookish », qui vous guidera dans la personnalisation de la configuration de votre site.
Pour émuler le comportement des routeurs JavaScript qui actualisent le contenu principal de la page au lieu de naviguer vers une nouvelle page lorsque des liens sont cliqués, vous pouvez activer le module Bookish Speed. Notez que votre JavaScript devra s'exécuter dans les comportements et devra utiliser once() . Les scripts et styles en ligne ne sont pas pris en charge.
Si vous préférez exporter du contenu sous forme de fichiers .yml, vous pouvez essayer d'utiliser l'encodeur expérimental "yaml" pour Tome en ajoutant cette ligne à settings.php :
$settings['tome_sync_encoder'] = 'yaml';
Activez ensuite le module bookish_yaml, qui reformate le contenu en texte enrichi pour vous assurer qu'il est facilement modifiable en tant que chaîne YAML multiligne.
Ensuite, exécutez « drush tome:export » pour réexporter votre contenu sous forme de fichiers .yml et supprimez les anciens fichiers .json après avoir exécuté « drush tome:install » et confirmé que les choses fonctionnent toujours.
Cette fonctionnalité est expérimentale, mais elle pourrait être la valeur par défaut pour les installations de Tome à l'avenir, alors merci d'avance de la tester !
