bookish

Книжный

Посмотреть демо-сайт

Bookish — это установочный профиль для Drupal 9+, который пытается сделать стандартный интерфейс для пользователей Tome максимально приятным.

По функциональности Bookish аналогичен профилю Standard. Большая часть работы в этом профиле заключалась в том, чтобы сделать процесс редактирования и интерфейс максимально современным.

Некоторые особенности:

• Возможность фильтровать и обрезать изображения при загрузке, в CKEditor или в поле.
• Функция размытия изображений, аналогичная GatsbyJS.
• Тема с поддержкой темного режима, созданная с использованием однофайловых компонентов.
• Уже настроена интеграция Metatag, Pathauto, Lunr и Simple XML с картой сайта.
• Возможность вставлять в CKEditor фрагменты кода, стилизованные во внешнем интерфейсе.
• Упрощенная панель инструментов, на которой перечислены ярлыки по умолчанию.

Установить (с Томом)

Лучший способ использовать Bookish — это проект Tome Composer.

Требования для локального использования Tome:

• PHP 7+
• Композитор
• Друш
• SQLite 3.26+ и связанные расширения PHP

Альтернативно вы можете запустить приведенные ниже команды, используя образ Docker mortenson/tome. Дополнительную информацию см. в документации по скрипту Docker.

Для использования Tome не требуется программа Drush Launcher, позволяющая просто набирать 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, вы можете запустить его из любой установки Drupal 9+:

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

Дополнительная помощь

После входа в систему нажмите «Справка» на панели инструментов. Этот модуль имеет обширную документацию, расположенную внутри Drupal с помощью модуля «Темы справки». Хорошим местом для начала будет страница «Настройка вашего книжного сайта», которая поможет вам персонализировать конфигурацию вашего сайта.

Ускорение вашего сайта с помощью навигации AJAX (экспериментально)

Чтобы эмулировать поведение маршрутизаторов JavaScript, которые обновляют основное содержимое страницы вместо перехода на новую страницу при нажатии ссылки, вы можете включить модуль Bookish Speed. Обратите внимание, что ваш JavaScript должен будет работать в поведении и использовать once() . Встроенные скрипты и стили не поддерживаются.

Экспорт контента в формате YAML (экспериментальный)

Если вы предпочитаете экспортировать контент в виде файлов .yml, вы можете попробовать использовать экспериментальный кодировщик «yaml» для Tome, добавив эту строку в файл settings.php:

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

Затем включите модуль bookish_yaml, который переформатирует содержимое форматированного текста, чтобы его можно было легко редактировать в виде многострочной строки YAML.

Затем запустите «drush tome:export», чтобы повторно экспортировать контент в виде файлов .yml, и удалите старые файлы .json после запуска «drush tome:install» и убедитесь, что все еще работает.

Эта функция является экспериментальной, но в будущем может стать функцией по умолчанию для установки Tome, поэтому заранее благодарим вас за ее тестирование!