bookish

書生氣

查看示範站點

Bookish 是 Drupal 9+ 的安裝設定文件，試圖為 Tome 用戶提供盡可能好的開箱即用體驗。

在功能方面，Bookish 與 Standard 配置檔案類似。此設定檔中的大部分工作都是使編輯體驗和前端盡可能具有現代感。

一些功能亮點包括：

• 能夠在上傳時、在 CKEditor 或欄位中過濾和裁剪圖像
• 影像模糊功能，類似 GatsbyJS
• 具有暗模式支援的主題，使用單文件組件構建
• 已配置 Metatag、Pathauto、Lunr 和 Simple XML 網站地圖集成
• 能夠在 CKEditor 中嵌入前端樣式的程式碼片段
• 簡化的工具列，僅列出預設快捷鍵

安裝（與 Tome 一起）

使用 Bookish 的最佳方式是使用 Tome Composer 專案。

在本地使用 Tome 的要求是：

• PHP 7+
• 作曲家
• 德魯什
• SQLite 3.26+ 和相關的 PHP 擴展

或者，您可以使用 mortenson/tome Docker 映像執行以下命令。請參閱 Docker 腳本文件以供參考。

使用 Tome 不需要 Drush 啟動器，只需輸入drush即可。如果不可用，請改用vendor/bin/drush 。

若要安裝 Tome 和 Bookish，請執行以下命令：

 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

現在您可以將初始程式碼庫、內容、設定和檔案提交到 Git。

若要啟動本機網路伺服器，請執行：

 drush runserver

然後在另一個選項卡中運行：

 drush uli -l 127.0.0.1:8888

並點擊連結開始編輯。

若要重新安裝您的站點，請執行：

 drush tome:install

有關部署網站的信息，您可以訪問本地網站上的/admin/help/topic/bookish_help.tome ，或閱讀 https://tome.fyi/docs 上的文件。

安裝（不含 Tome）

如果您不想使用 Tome，您可以從任何 Drupal 9+ 安裝中執行它：

 composer require drupal-tome/bookish
drush si bookish -y
drush pmu tome -y

進一步的幫助

登入後，點擊工具列中的「幫助」。此模組使用幫助主題模組在 Drupal 內部提供了大量文件。一個好的起點是「設定您的 Bookish 網站」頁面，它將引導您完成網站配置的個人化。

使用 AJAX 導航加速您的網站（實驗性）

要模擬 JavaScript 路由器的行為（在點擊連結時刷新頁面的主要內容而不是導航到新頁面），您可以啟用 Bookish Speed 模組。請注意，您的 JavaScript 必須在行為中運行，並且必須使用once() 。不支援內聯腳本和样式。

將內容匯出為 YAML（實驗）

如果您希望將內容匯出為 .yml 文件，您可以透過將此行新增至 settings.php 來嘗試使用 Tome 的實驗性「yaml」編碼器：

 $settings['tome_sync_encoder'] = 'yaml';

然後啟用 bookish_yaml 模組，該模組會重新格式化富文本內容，以確保它可以作為多行 YAML 字串輕鬆編輯。

然後，執行「drush tome:export」將內容重新匯出為 .yml 文件，並在執行「drush tome:install」並確認一切仍然有效後刪除舊的 .json 文件。

此功能是實驗性的，但將來可能會成為 Tome 安裝的預設功能，因此請提前感謝您對其進行測試！