bookish

本好き

デモサイトを見る

Bookish は Drupal 9 以降のインストール プロファイルで、Tome ユーザーがすぐに使用できるエクスペリエンスを可能な限り向上させようとします。

機能の点では、Bookish は標準プロファイルに似ています。このプロファイルの作業のほとんどは、編集エクスペリエンスとフロントエンドを可能な限り現代的なものにすることでした。

いくつかの機能のハイライトは次のとおりです。

• 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 Launcher は必要ありません。利用できない場合は、代わりに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 はビヘイビアーで実行する必要があり、 once()使用する必要があることに注意してください。インライン スクリプトとスタイルはサポートされていません。

コンテンツを YAML としてエクスポートする (実験的)

コンテンツを .yml ファイルとしてエクスポートしたい場合は、次の行を settings.php に追加して、Tome 用の実験的な「yaml」エンコーダを使用してみてください。

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

次に、bookish_yaml モジュールを有効にします。これは、リッチ テキスト コンテンツを再フォーマットして、複数行の YAML 文字列として簡単に編集できるようにします。

次に、「drush tome:export」を実行してコンテンツを .yml ファイルとして再エクスポートし、「drush tome:install」を実行して動作することを確認した後、古い .json ファイルを削除します。

この機能は実験的なものですが、将来的には Tome インストールのデフォルトになる可能性がありますので、事前にテストしていただきありがとうございます。