ทีมโอเพ่นซอร์สของ Meta เพิ่งเปิดตัว Docusaurus 3.9 ซึ่งเป็นการอัปเดตสำคัญสำหรับเครื่องมือสร้างไซต์คงที่บน React ยอดนิยม
เวอร์ชันใหม่ ประกาศเมื่อวันที่ 25 กันยายน แนะนำความสามารถใหม่ที่สำคัญ: ผู้ช่วยการค้นหาที่ขับเคลื่อนด้วย AI
นอกจากฟีเจอร์ใหม่แล้ว การอัปเดตยังปรับปรุงเทคโนโลยีพื้นฐานให้ทันสมัย โดยกำหนดให้นักพัฒนาต้องใช้ Node.js 20 และยุติการสนับสนุน Node.js 18 รุ่นเก่า
การค้นหาการสนทนาที่ขับเคลื่อนด้วย AI ด้วย DocSearch v4
สำหรับนักพัฒนาที่ดูแลเอกสารขนาดใหญ่ ส่วนเสริมที่โดดเด่นใน Docusaurus 3.9 คือการรองรับ DocSearch v4 ของ Algolia อย่างเต็มรูปแบบ
การอัปเกรดนี้แนะนำ AskAI ซึ่งเป็นคุณลักษณะที่แปลงแถบค้นหามาตรฐานของไซต์ให้เป็นผู้ช่วยการสนทนา
แทนที่จะจับคู่คำหลักเพียงอย่างเดียว เครื่องมือนี้ให้คำตอบที่สังเคราะห์ขึ้น ซึ่งช่วยให้ผู้ใช้แก้ปัญหาได้ ปัญหามีประสิทธิภาพมากขึ้น
ตามความเห็นของทีม Docusaurus เป้าหมายคือ”ให้คุณเพิ่มผู้ช่วยค้นหาที่ขับเคลื่อนด้วย AI ไปยังไซต์ Docusaurus ของคุณ ซึ่งสามารถตอบคำถามโดยอิงจากสิ่งที่อยู่ในเอกสารประกอบของคุณด้วยประสบการณ์การสนทนา”
การเปลี่ยนจากการดึงคำสำคัญไปเป็นคำตอบเชิงสนทนาถือเป็นวิวัฒนาการที่สำคัญในประสบการณ์ผู้ใช้สำหรับเอกสารทางเทคนิค
การใช้งานการค้นหาขั้นสูงนี้คือการเลือกใช้ โดยให้ ทีมจะควบคุมการเปลี่ยนแปลง ผู้ดูแลโครงการสามารถเลือกที่จะคงอยู่บน DocSearch v3 หรืออัปเกรดทีละน้อยเพื่อปลดล็อกความสามารถ AI ใหม่
สำหรับผู้ที่พร้อมจะนำไปใช้ Algolia มอบจุดเริ่มต้นที่สามารถเข้าถึงได้ หน้าราคาอย่างเป็นทางการให้รายละเอียดเกี่ยวกับระดับ”สร้าง”ฟรีที่ รวมคำขอค้นหา 10,000 รายการต่อเดือน ทำให้ฟีเจอร์นี้ใช้งานได้สำหรับโปรเจ็กต์โอเพ่นซอร์สและทีมขนาดเล็ก
การบูรณาการดังกล่าวสะท้อนให้เห็นถึงแนวโน้มอุตสาหกรรมที่กว้างขึ้นของการฝัง AI ทั่วไปลงในแพลตฟอร์มนักพัฒนาโดยตรง เพื่อเพิ่มประสิทธิภาพการทำงานและ ลดอุปสรรคของผู้ใช้
การปรับปรุงพื้นฐานให้ทันสมัย: Node.js 20 จำเป็นตอนนี้
ในการย้ายที่มุ่งเป้าไปที่การปรับปรุงความปลอดภัยและประสิทธิภาพ Docusaurus 3.9 ได้เพิ่มข้อกำหนดรันไทม์ขั้นต่ำเป็น Node.js เวอร์ชัน 20.0, ยกเลิกการรองรับ Node.js 18 อย่างเป็นทางการ
เนื่องจาก Node.js 18 หมดอายุการใช้งานอย่างเป็นทางการแล้ว จึงไม่ได้รับการอัปเดตด้านความปลอดภัยอีกต่อไป ทำให้ใช้งานต่อไปอาจมีช่องโหว่ที่อาจเกิดขึ้นได้
ทีมงานของ Docusaurus วางกรอบการอัปเกรดที่จำเป็นนี้ว่าเป็นขั้นตอนสำคัญในการรักษาแพลตฟอร์มที่ปลอดภัยและมีเสถียรภาพ
“การยกเลิกการรองรับ Node.js 18 เมื่อสิ้นสุดอายุการใช้งาน”เวอร์ชันของ Node.js ในเวอร์ชันรองถือเป็นแนวทางปฏิบัติทั่วไปในระบบนิเวศของ Node.js ซึ่งขณะนี้เรารับรองอย่างเป็นทางการและบันทึกเป็นเอกสารเกี่ยวกับกระบวนการเผยแพร่ของเรา”
แม้ว่าการตัดสินใจนี้จะเป็นแนวทางปฏิบัติที่ดีที่สุด แต่ก็ต้องได้รับการดำเนินการจากทีมพัฒนา ผลกระทบที่เกิดขึ้นทันทีที่สุดคือต่อไปป์ไลน์ CI/CD และสภาพแวดล้อมการพัฒนาในท้องถิ่น
ตัวอย่างเชิงปฏิบัติของสิ่งนี้ปรากฏบน GitHub โดยที่ นักพัฒนายื่นเรื่อง โดยสังเกตว่าตัวอย่างเอกสารอย่างเป็นทางการสำหรับ GitHub Actions ยังคงชี้ไปที่ Node 18 ที่เลิกใช้งานแล้ว ซึ่งจำเป็นต้องมีการอัปเดตเพื่อให้ทำงานได้อย่างถูกต้อง
ทีมจะต้องตรวจสอบไม่เพียงแต่สคริปต์บิลด์ของพวกเขาเท่านั้น แต่ยังรวมถึง Dockerfiles และผู้จัดการสภาพแวดล้อมภายในเครื่องด้วยเพื่อให้แน่ใจว่าการเปลี่ยนแปลงจะราบรื่นและหลีกเลี่ยงความล้มเหลวของบิลด์
ความยืดหยุ่นที่ได้รับการปรับปรุงสำหรับไซต์เอกสารทั่วโลก
จัดการกับความท้าทายที่มีมายาวนานสำหรับไซต์หลายภาษา Docusaurus 3.9 แนะนำการปรับปรุงที่สำคัญสำหรับ การทำให้เป็นสากล (i18n) system.
ขณะนี้นักพัฒนาซอฟต์แวร์สามารถแทนที่คุณสมบัติ `baseUrl` และ `url` สำหรับแต่ละภาษาแยกกันได้โดยใช้ฟิลด์ `i18n.localeConfigs[locale]` ใหม่
โดยให้การควบคุมแบบละเอียดที่จำเป็นสำหรับการใช้งานหลายโดเมนที่ซับซ้อน เช่น การโฮสต์เอกสารภาษาอังกฤษที่ `docs.example.com` และเอกสารภาษาฝรั่งเศสที่ `docs.example.fr` ในขณะเดียวกันก็ทำให้มั่นใจว่าข้อมูลเมตาและลิงก์ทั้งหมดแก้ไขได้อย่างถูกต้อง
การเพิ่มประสิทธิภาพ i18n เพิ่มเติมยังรวมถึงแฟล็ก’แปล’ใหม่ ซึ่งขณะนี้ถูกปิดใช้งานตามค่าเริ่มต้นสำหรับไซต์ที่ไม่มีการแปล ซึ่งนำไปสู่เวลาในการสร้างที่รวดเร็วขึ้นโดยการหลีกเลี่ยงการอ่านระบบไฟล์ที่ไม่จำเป็น
นอกจากนี้ ยังสามารถกำหนดแอตทริบิวต์ `key` ใหม่ให้กับรายการในแถบด้านข้างได้ การเพิ่มคีย์นี้จะป้องกันความขัดแย้งของคีย์การแปลเมื่อหลายหมวดหมู่ใช้ป้ายกำกับเดียวกัน เช่น’API’เพื่อให้มั่นใจว่าแต่ละอินสแตนซ์สามารถแปลได้ไม่ซ้ำกันตามบริบทภายในโครงสร้างเอกสารประกอบ
การอัปเกรดคีย์สำหรับไดอะแกรม ประสิทธิภาพ และประสบการณ์ของนักพัฒนา
นอกเหนือจากฟีเจอร์พาดหัวแล้ว Docusaurus 3.9 ยังรวมโฮสต์ของการปรับปรุงอันทรงคุณค่าอื่นๆ ไว้ด้วย
ในบรรดาสิ่งเหล่านี้ มีการรองรับ อัลกอริธึมเค้าโครง Mermaid ELK Mermaid เป็นเครื่องมือยอดนิยมสำหรับการสร้างไดอะแกรมจากข้อความ และกลไกเค้าโครง ELK มอบความสามารถในการเรนเดอร์ที่ซับซ้อนยิ่งขึ้น ซึ่งมีประโยชน์อย่างยิ่งสำหรับสถาปัตยกรรมระบบขนาดใหญ่หรือซับซ้อน ไดอะแกรม
ประสิทธิภาพยังได้รับการเพิ่มประสิทธิภาพด้วยการอัปเกรดเป็น Rspack 1.5 ซึ่งใช้ประโยชน์จากตัวเลือกการกำหนดค่าใหม่เพื่อเร่งเวลาในการสร้าง Docusaurus บิลด์ที่เร็วขึ้นแปลโดยตรงไปสู่ประสิทธิภาพการทำงานของนักพัฒนาที่สูงขึ้น โดยเฉพาะอย่างยิ่งในวงกว้าง โครงการ
การเปลี่ยนแปลงที่โดดเด่นอื่นๆ ได้แก่ hooks ใหม่สำหรับการจัดการลิงก์ Markdown ที่เสียหาย ความสามารถในการปิดใช้งานการแสดงผลอิโมจิ และความเสถียรของภาพที่ดีขึ้นเมื่อสลับระหว่างโหมดสี
การปรับแต่งโดยรวมเหล่านี้ทำให้จุดยืนของ Docusaurus แข็งแกร่งขึ้นในฐานะแพลตฟอร์มที่แข็งแกร่ง มีประสิทธิภาพ และยืดหยุ่นสำหรับการสร้างเว็บไซต์เอกสารที่ทันสมัย
