bookish
1.0.0
Demoseite ansehen
Bookish ist ein Installationsprofil für Drupal 9+, das versucht, das Out-of-the-Box-Erlebnis für Tome-Benutzer so angenehm wie möglich zu gestalten.
Vom Funktionsumfang her ähnelt Bookish dem Standardprofil. Die meiste Arbeit in diesem Profil bestand darin, das Bearbeitungserlebnis und das Frontend so modern wie möglich zu gestalten.
Einige Funktionshighlights sind:
Die beste Möglichkeit, Bookish zu verwenden, ist das Tome Composer-Projekt.
Die Voraussetzungen für die lokale Nutzung von Tome sind:
Alternativ können Sie die folgenden Befehle mit dem Docker-Image mortenson/tome ausführen. Weitere Informationen finden Sie in der Dokumentation zum Docker-Skript.
Der Drush Launcher, mit dem Sie einfach drush eingeben können, ist für die Verwendung von Tome nicht erforderlich. Wenn nicht verfügbar, verwenden Sie stattdessen vendor/bin/drush .
Führen Sie die folgenden Befehle aus, um Tome und Bookish zu installieren:
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
Sie können jetzt Ihre ursprüngliche Codebasis, Ihren Inhalt, Ihre Konfiguration und Ihre Dateien an Git übertragen.
Um einen lokalen Webserver zu starten, führen Sie Folgendes aus:
drush runserver
Führen Sie dann in einem anderen Tab Folgendes aus:
drush uli -l 127.0.0.1:8888
und klicken Sie auf den Link, um mit der Bearbeitung zu beginnen.
Um Ihre Site neu zu installieren, führen Sie Folgendes aus:
drush tome:install
Informationen zur Bereitstellung Ihrer Website finden Sie unter /admin/help/topic/bookish_help.tome auf Ihrer lokalen Website oder in den Dokumenten unter https://tome.fyi/docs.
Wenn Sie Tome nicht verwenden möchten, können Sie dies von jeder Drupal 9+-Installation aus ausführen:
composer require drupal-tome/bookish
drush si bookish -y
drush pmu tome -y
Klicken Sie nach der Anmeldung in der Symbolleiste auf „Hilfe“. Dieses Modul verfügt über eine umfangreiche Dokumentation in Drupal über das Modul „Hilfethemen“. Ein guter Ausgangspunkt wäre die Seite „Konfigurieren Ihrer Bookish-Site“, die Sie durch die Personalisierung der Konfiguration Ihrer Site führt.
Um das Verhalten von JavaScript-Routern zu emulieren, die den Hauptinhalt der Seite aktualisieren, anstatt zu einer neuen Seite zu navigieren, wenn auf Links geklickt wird, können Sie das Bookish Speed-Modul aktivieren. Beachten Sie, dass Ihr JavaScript in Verhaltensweisen ausgeführt werden muss und once() verwenden muss. Inline-Skripte und -Stile werden nicht unterstützt.
Wenn Sie Inhalte lieber als .yml-Dateien exportieren möchten, können Sie versuchen, den experimentellen „yaml“-Encoder für Tome zu verwenden, indem Sie diese Zeile zur Datei „settings.php“ hinzufügen:
$settings['tome_sync_encoder'] = 'yaml';
Aktivieren Sie dann das Modul bookish_yaml, das Rich-Text-Inhalte neu formatiert, um sicherzustellen, dass sie problemlos als mehrzeilige YAML-Zeichenfolge bearbeitet werden können.
Führen Sie dann „drush tome:export“ aus, um Ihre Inhalte erneut als .yml-Dateien zu exportieren, und entfernen Sie alte .json-Dateien, nachdem Sie „drush tome:install“ ausgeführt und bestätigt haben, dass alles noch funktioniert.
Diese Funktion ist experimentell, könnte aber in Zukunft die Standardeinstellung für Tome-Installationen sein, also vielen Dank im Voraus, dass Sie sie getestet haben!
