Nhóm nguồn mở của Meta gần đây đã phát hành Docusaurus 3.9, một bản cập nhật quan trọng cho trình tạo trang tĩnh dựa trên React phổ biến của nó.
Phiên bản mới của nó, đã công bố vào ngày 25 tháng 9, đã giới thiệu một khả năng mới đáng kể: trợ lý tìm kiếm được hỗ trợ bởi AI.
Bên cạnh các tính năng mới, bản cập nhật còn hiện đại hóa công nghệ cơ bản, yêu cầu các nhà phát triển sử dụng Node.js 20 và ngừng hỗ trợ cho Node.js 18 cũ hơn.
Tìm kiếm hội thoại được hỗ trợ bởi AI với DocSearch v4
Đối với các nhà phát triển duy trì tài liệu quy mô lớn, tính năng bổ sung nổi bật trong Docusaurus 3.9 là hỗ trợ đầy đủ cho DocSearch v4 của Algolia.
Bản nâng cấp giới thiệu AskAI, một tính năng biến thanh tìm kiếm tiêu chuẩn của trang web thành trợ lý đàm thoại.
Thay vì chỉ khớp từ khóa, công cụ này cung cấp các câu trả lời tổng hợp, giúp người dùng giải quyết giải quyết vấn đề hiệu quả hơn.
Theo nhóm Docusaurus, mục tiêu là “cho phép bạn thêm trợ lý tìm kiếm được hỗ trợ bởi AI vào trang Docusaurus của bạn. Trợ lý này có thể trả lời các câu hỏi dựa trên nội dung trong tài liệu của bạn bằng trải nghiệm trò chuyện.”
Việc chuyển từ truy xuất từ khóa sang câu trả lời hội thoại đánh dấu một bước tiến lớn trong trải nghiệm người dùng đối với tài liệu kỹ thuật.
Việc triển khai tìm kiếm nâng cao này là chọn tham gia, mang lại các nhóm kiểm soát quá trình chuyển đổi. Những người bảo trì dự án có thể chọn duy trì DocSearch v3 hoặc nâng cấp dần dần để khai thác các khả năng AI mới.
Đối với những người sẵn sàng áp dụng nó, Algolia cung cấp một điểm truy cập. Trang giá chính thức của nó nêu chi tiết về cấp độ”Xây dựng”miễn phí bao gồm 10.000 yêu cầu tìm kiếm mỗi tháng, giúp tính năng này trở nên khả thi đối với các dự án nguồn mở và các nhóm nhỏ hơn.
Việc tích hợp như vậy phản ánh xu hướng rộng hơn trong ngành là nhúng AI tổng hợp trực tiếp vào nền tảng của nhà phát triển để tăng năng suất và giảm ma sát của người dùng.
Hiện đại hóa nền tảng: Hiện cần có Node.js 20
Trong một động thái nhằm cải thiện tính bảo mật và hiệu suất, Docusaurus 3.9 đã nâng yêu cầu thời gian chạy tối thiểu lên Node.js v20.0, chính thức ngừng hỗ trợ cho Node.js 18.
Vì Node.js 18 đã hết vòng đời chính thức nên nó không còn nhận được các bản cập nhật bảo mật nữa, khiến việc tiếp tục sử dụng nó sẽ tạo ra một lỗ hổng tiềm ẩn.
Nhóm của Docusaurus coi việc nâng cấp bắt buộc này là một bước quan trọng để duy trì một nền tảng an toàn và ổn định.
“Hạ bỏ Các phiên bản cuối vòng đời của Node.js trên các bản phát hành phiên bản nhỏ là một thông lệ phổ biến trong hệ sinh thái Node.js mà giờ đây chúng tôi đã chính thức xác nhận và ghi lại về quy trình phát hành của mình.”
Mặc dù quyết định này là phương pháp hay nhất nhưng nó đòi hỏi phải có hành động từ các nhóm phát triển. Tác động ngay lập tức nhất của nó là đối với quy trình CI/CD và môi trường phát triển cục bộ.
Một ví dụ thực tế về điều này đã xuất hiện trên GitHub, trong đó một nhà phát triển đã gửi một vấn đề lưu ý rằng các ví dụ tài liệu chính thức cho Hành động GitHub vẫn chỉ ra Nút không được dùng nữa 18, yêu cầu cập nhật để hoạt động chính xác.
Các nhóm sẽ cần kiểm tra không chỉ các tập lệnh xây dựng mà còn cả Dockerfile và trình quản lý môi trường cục bộ để đảm bảo quá trình chuyển đổi suôn sẻ và tránh lỗi xây dựng.
Tính linh hoạt nâng cao cho các trang web tài liệu toàn cầu
Giải quyết thách thức lâu dài đối với các trang web đa ngôn ngữ, Docusaurus 3.9 giới thiệu những cải tiến đáng kể đối với quốc tế hóa (i18n) hệ thống.
Giờ đây, các nhà phát triển có thể ghi đè các thuộc tính `baseUrl` và `url` cho từng ngôn ngữ riêng lẻ bằng cách sử dụng trường `i18n.localeConfigs[locale]` mới.
Nó cung cấp khả năng kiểm soát chi tiết cần thiết cho việc triển khai nhiều miền phức tạp—ví dụ: lưu trữ tài liệu tiếng Anh tại `docs.example.com` và tài liệu tiếng Pháp tại `docs.example.fr`, trong khi vẫn đảm bảo tất cả siêu dữ liệu và liên kết được phân giải chính xác.
Các tối ưu hóa khác của i18n bao gồm cờ `translate` mới, hiện bị tắt theo mặc định đối với các trang web không có bản dịch, dẫn đến thời gian xây dựng nhanh hơn bằng cách tránh đọc hệ thống tệp không cần thiết.
Ngoài ra, thuộc tính `key` mới có thể được gán cho các mục thanh bên. Việc thêm khóa này sẽ ngăn chặn khóa dịch xung đột khi nhiều danh mục có chung nhãn, chẳng hạn như’API’, đảm bảo rằng mỗi phiên bản có thể được dịch duy nhất dựa trên ngữ cảnh của nó trong cấu trúc tài liệu.
Các bản nâng cấp chính cho Sơ đồ, Hiệu suất và Trải nghiệm của nhà phát triển
Ngoài các tính năng tiêu biểu, Docusaurus 3.9 còn tích hợp một loạt các cải tiến có giá trị khác.
Trong số này hỗ trợ cho Thuật toán bố cục ELK nàng tiên cá. Nàng tiên cá là một công cụ phổ biến để tạo sơ đồ từ văn bản và công cụ bố cục ELK của nó cung cấp các khả năng kết xuất phức tạp hơn, đặc biệt hữu ích cho kiến trúc hệ thống lớn hoặc phức tạp sơ đồ.
Hiệu suất cũng được cải thiện nhờ bản nâng cấp lên Rspack 1.5, nâng cấp lên các tùy chọn cấu hình mới để tăng tốc thời gian xây dựng Docusaurus. Các bản dựng nhanh hơn trực tiếp mang lại năng suất cao hơn cho nhà phát triển, đặc biệt là ở các các dự án.
Những thay đổi đáng chú ý khác bao gồm các móc mới để xử lý các liên kết Markdown bị hỏng, khả năng vô hiệu hóa hiển thị biểu tượng cảm xúc và cải thiện độ ổn định hình ảnh khi chuyển đổi giữa các chế độ màu.
Những cải tiến tập thể này củng cố vị thế của Docusaurus như một nền tảng mạnh mẽ, hiệu quả và linh hoạt để xây dựng các trang web tài liệu hiện đại.
