README

Bookish

查看演示站点

Bookish 是一个适用于 Drupal 9+ 的安装配置文件，旨在使 Tome 用户的使用体验尽可能好。

在功能上，Bookish 类似于标准配置文件。这个配置文件的大部分工作都是为了使编辑体验和前端尽可能现代化。

一些亮点功能包括

在上传时过滤和裁剪图像，在 CKEditor 或字段中
图像的模糊功能，类似于 GatsbyJS
支持深色模式的主题，使用单文件组件构建
已配置的 Metatag、Pathauto、Lunr 和 Simple XML 网站地图集成
在 CKEditor 中嵌入代码片段，并具有前端样式
简化工具栏，仅列出默认快捷键

安装（与 Tome 一起）

使用 Bookish 的最佳方式是与 Tome Composer 项目一起使用。

使用 Tome 本地的要求是

PHP 7+
Composer
Drush
SQLite 3.26+ 及相关 PHP 扩展

或者，您可以使用 mortenson/tome Docker 镜像运行以下命令。有关参考，请参阅 Docker 脚本文档。

Drush Launcher，允许您只需输入 drush 即可，使用 Tome 时不是必需的。如果不可用，请使用 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。

要启动本地 web 服务器，请运行

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 必须在 behaviors 中运行，并使用 once()。不支持内联脚本和样式。

将内容导出为 YAML（实验性）

如果您希望将内容导出为 .yml 文件，您可以尝试使用 Tome 的实验性“yaml”编码器，通过将此行添加到 settings.php 中来实现

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

然后启用 bookish_yaml 模块，该模块将富文本内容重新格式化，以确保它作为多行 YAML 字符串易于编辑。

然后，运行 "drush tome:export" 以重新导出您的内容为 .yml 文件，并在运行 "drush tome:install" 并确认一切正常后，删除旧的 .json 文件。

此功能是实验性的，但可能在未来成为 Tome 安装程序的默认选项，因此提前感谢您尝试使用它！

drupal-tome / bookish

维护者

详细信息