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 安装的默认功能，因此提前感谢您对其进行测试！