bookish

Kutu buku

Lihat situs demo

Bookish adalah profil instalasi untuk Drupal 9+ yang mencoba membuat pengalaman unik bagi pengguna Tome sebaik mungkin.

Dari segi fungsionalitas, Bookish mirip dengan profil Standar. Sebagian besar pekerjaan di profil ini adalah membuat pengalaman pengeditan dan tampilan depan semodern mungkin.

Beberapa fitur unggulannya adalah:

• Kemampuan untuk memfilter dan memotong gambar saat diunggah, di CKEditor, atau bidang
• Fungsi blur-up untuk gambar, mirip dengan GatsbyJS
• Tema dengan dukungan mode gelap, dibuat menggunakan Komponen File Tunggal
• Integrasi peta situs Metatag, Pathauto, Lunr, dan Simple XML sudah dikonfigurasi
• Kemampuan untuk menyematkan cuplikan kode di CKEditor yang ditata di frontend
• Toolbar sederhana yang hanya mencantumkan pintasan default

Instal (dengan Tome)

Cara terbaik untuk menggunakan Bookish adalah dengan proyek Tome Composer.

Persyaratan untuk menggunakan Tome secara lokal adalah:

• PHP 7+
• Komposer
• mabuk
• SQLite 3.26+ dan ekstensi PHP terkait

Alternatifnya, Anda dapat menjalankan perintah di bawah ini menggunakan image Docker mortenson/tome. Lihat dokumentasi skrip Docker untuk referensi.

Drush Launcher, yang memungkinkan pengetikan secara sederhana drush , tidak diperlukan untuk menggunakan Tome. Jika tidak tersedia, gunakan vendor/bin/drush sebagai gantinya.

Untuk menginstal Tome dan Bookish, jalankan perintah berikut:

 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

Anda sekarang dapat memasukkan basis kode, konten, konfigurasi, dan file awal Anda ke Git.

Untuk memulai server web lokal, jalankan:

 drush runserver

lalu di tab lain jalankan:

 drush uli -l 127.0.0.1:8888

dan klik tautan untuk mulai mengedit.

Untuk menginstal ulang situs Anda, jalankan:

 drush tome:install

Untuk informasi tentang penerapan situs Anda, Anda dapat mengunjungi /admin/help/topic/bookish_help.tome di situs lokal Anda, atau membaca dokumen di https://tome.fyi/docs.

Instal (tanpa Tome)

Jika Anda tidak ingin menggunakan Tome, Anda dapat menjalankan ini dari instalasi Drupal 9+ mana pun:

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

Bantuan lebih lanjut

Setelah masuk, klik "Bantuan" di toolbar. Modul ini memiliki dokumentasi ekstensif yang terdapat di dalam Drupal menggunakan modul Topik Bantuan. Tempat yang baik untuk memulai adalah halaman "Mengonfigurasi situs Bookish Anda", yang akan memandu Anda dalam mempersonalisasi konfigurasi situs Anda.

Mempercepat situs Anda dengan navigasi AJAX (eksperimental)

Untuk meniru perilaku router JavaScript yang menyegarkan konten utama laman alih-alih bernavigasi ke laman baru saat tautan diklik, Anda dapat mengaktifkan modul Kecepatan Buku. Perhatikan bahwa JavaScript Anda harus dijalankan dalam perilaku, dan harus menggunakan once() . Skrip dan gaya sebaris tidak didukung.

Mengekspor konten sebagai YAML (eksperimental)

Jika Anda lebih suka mengekspor konten sebagai file .yml, Anda dapat mencoba menggunakan encoder "yaml" eksperimental untuk Tome dengan menambahkan baris ini ke settings.php:

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

Kemudian aktifkan modul bookish_yaml, yang memformat ulang konten teks kaya untuk memastikan konten tersebut mudah diedit sebagai string YAML multi-baris.

Kemudian, jalankan "drush tome:export" untuk mengekspor ulang konten Anda sebagai file .yml, dan hapus file .json lama setelah menjalankan "drush tome:install" dan mengonfirmasi semuanya masih berfungsi.

Fitur ini bersifat eksperimental, namun mungkin menjadi default untuk instalasi Tome di masa mendatang, jadi terima kasih sebelumnya karena telah mengujinya!