bookish

ชอบจองหอง

ดูไซต์สาธิต

Bookish เป็นโปรไฟล์การติดตั้งสำหรับ Drupal 9+ ที่พยายามสร้างประสบการณ์นอกกรอบให้กับผู้ใช้ Tome ให้ดีที่สุดเท่าที่จะเป็นไปได้

ในแง่ของการใช้งาน Bookish นั้นคล้ายคลึงกับโปรไฟล์มาตรฐาน งานส่วนใหญ่ในโปรไฟล์นี้คือการทำให้ประสบการณ์การแก้ไขและส่วนหน้ามีความทันสมัยที่สุดเท่าที่จะเป็นไปได้

ไฮไลท์คุณสมบัติบางประการคือ:

• ความสามารถในการกรองและครอบตัดรูปภาพเมื่ออัปโหลดใน CKEditor หรือฟิลด์
• ฟังก์ชั่นเบลอภาพคล้ายกับ GatsbyJS
• ธีมที่รองรับโหมดมืด สร้างโดยใช้ Single File Components
• กำหนดค่าการรวมแผนผังเว็บไซต์ Metatag, Pathauto, Lunr และ Simple XML แล้ว
• ความสามารถในการฝังข้อมูลโค้ดใน CKEditor ที่จัดรูปแบบไว้ที่ส่วนหน้า
• แถบเครื่องมือแบบง่ายที่แสดงรายการทางลัดเริ่มต้น

ติดตั้ง (กับ Tome)

วิธีที่ดีที่สุดในการใช้ Bookish คือการใช้โปรเจ็กต์ Tome Composer

ข้อกำหนดสำหรับการใช้ Tome ภายในเครื่องคือ:

• PHP7+
• ผู้แต่ง
• ดรัช
• 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 ได้แล้ว

หากต้องการเริ่มเว็บเซิร์ฟเวอร์ท้องถิ่น ให้รัน:

 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 คุณสามารถลองใช้ตัวเข้ารหัส "yaml" รุ่นทดลองสำหรับ Tome ได้โดยเพิ่มบรรทัดนี้ใน settings.php:

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

จากนั้นเปิดใช้งานโมดูล bookish_yaml ซึ่งจะจัดรูปแบบเนื้อหา Rich Text เพื่อให้แน่ใจว่าจะแก้ไขได้อย่างง่ายดายเป็นสตริง YAML แบบหลายบรรทัด

จากนั้น เรียกใช้ "drush tome:export" เพื่อส่งออกเนื้อหาของคุณอีกครั้งเป็นไฟล์ .yml และลบไฟล์ .json เก่าหลังจากเรียกใช้ "drush tome:install" และยืนยันว่าสิ่งต่างๆ ยังคงใช้งานได้

คุณลักษณะนี้ยังอยู่ในช่วงทดลอง แต่อาจเป็นค่าเริ่มต้นสำหรับการติดตั้ง Tome ในอนาคต ดังนั้นขอขอบคุณล่วงหน้าสำหรับการทดสอบ!