Meta のオープンソース チームは最近、人気の React ベースの静的サイト ジェネレーターの重要なアップデートである Docusaurus 3.9 をリリースしました。
その新しいバージョンである 9 月 25 日に発表されたには、AI を活用した検索アシスタントという重要な新機能が導入されました。
このアップデートでは新機能に加えて、基盤となるテクノロジーも最新化されており、開発者は Node.js 20 を使用する必要があり、古い Node.js 18 のサポートが終了します。
AI を活用した会話型検索 DocSearch v4 を使用
大規模なドキュメントを管理する開発者にとって、Docusaurus 3.9 の際立った追加機能は、Algolia の DocSearch v4 の完全サポートです。
このアップグレードでは、サイトの標準検索バーを会話型アシスタントに変換する機能である AskAI が導入されています。
このツールは、単にキーワードを照合するだけでなく、合成された回答を提供し、ユーザーの解決策を支援します。
Docusaurus チームによると、目標は「対話形式でドキュメントの内容に基づいて質問に回答できる AI 搭載の検索アシスタントを Docusaurus サイトに追加できるようにすることです。」
キーワード検索から会話形式の回答への移行は、技術ドキュメントのユーザー エクスペリエンスに大きな進化をもたらします。
この高度な検索の実装はオプトインであり、 チームがトランジションをコントロールします。プロジェクトの管理者は、DocSearch v3 を使用し続けるか、段階的にアップグレードして新しい AI 機能を利用するかを選択できます。
Algolia を導入する準備ができている人向けに、Algolia はアクセス可能なエントリ ポイントを提供します。公式価格ページには、月あたり 10,000 件の検索リクエストが含まれる無料の「Build」層の詳細が記載されており、この機能はオープンソース プロジェクトや小規模チームでも実行可能です。
このような統合は、生成 AI を開発者プラットフォームに直接埋め込んで開発者プラットフォームを強化するという、より広範な業界トレンドを反映しています。
基盤の最新化: Node.js 20 が必須
セキュリティとパフォーマンスの向上を目的とした動きの一環として、Docusaurus 3.9 では、最小ランタイム要件が Node.js v20.0、Node.js 18 のサポートを正式に終了します。
Node.js 18 は正式にサポート終了となったため、セキュリティ アップデートを受信できなくなり、継続使用が潜在的な脆弱性になります。
Docusaurus のチームは、この必須のアップグレードを安全で安定したプラットフォームを維持するための重要なステップとして位置づけています。
「削除」 マイナー バージョン リリースでの Node.js のサポート終了バージョンは、Node.js エコシステムの一般的な慣行であり、現在、私たちはそれを公式に承認し、リリース プロセスについて文書化しています。」
この決定はベスト プラクティスですが、開発チームのアクションが必要です。その最も直接的な影響は、CI/CD パイプラインとローカル開発環境にあります。
この実際の例は GitHub に掲載されており、開発者が問題を提出し、GitHub Actions の公式ドキュメントの例が依然として非推奨のノードを指していることを指摘しました。 18 では、正しく機能するにはアップデートが必要です。
チームは、スムーズな移行を確保し、ビルドの失敗を回避するために、ビルド スクリプトだけでなく、Dockerfile やローカル環境マネージャーも監査する必要があります。
グローバル ドキュメント サイトの柔軟性の強化
多言語サイトに対する長年の課題に対処するため、Docusaurus 3.9 では、大幅な改善が導入されています。 国際化 (i18n) システム.
開発者は、新しい `i18n.localeConfigs[locale]` フィールドを使用して、各ロケールの `baseUrl` プロパティと `url` プロパティを個別にオーバーライドできるようになりました。
これにより、複雑なマルチドメイン展開に必要な詳細な制御が提供されます。たとえば、英語のドキュメントは `docs.example.com` で、フランス語のドキュメントは でホストされます。 `docs.example.fr` を使用して、すべてのメタデータとリンクが正しく解決されるようにします。
さらに i18n の最適化には、新しい `translate` フラグが含まれています。これは、翻訳のないサイトではデフォルトで無効になり、不必要なファイル システムの読み取りを回避することでビルド時間が短縮されます。
さらに、新しい `key` 属性をサイドバー項目に割り当てることができます。このキーを追加すると翻訳ができなくなります 複数のカテゴリが「API」などの同じラベルを共有する場合に重要な競合が発生し、ドキュメント構造内のコンテキストに基づいて各インスタンスを一意に翻訳できるようになります。
図、パフォーマンス、開発者エクスペリエンスに関する主要なアップグレード
見出しの機能以外にも、Docusaurus 3.9 には、その他の貴重な改善点が数多くバンドルされています。
これらの中には、 Mermaid ELK レイアウト アルゴリズム。 Mermaid は、テキストから図を作成するための人気のあるツールであり、その ELK レイアウト エンジンは、より高度なレンダリング機能を提供します。これは、大規模または複雑なシステム アーキテクチャ図に特に役立ちます。
Rspack 1.5 へのアップグレードでもパフォーマンスが向上し、新しい構成オプションを利用して Docusaurus のビルド時間を短縮できます。ビルドの高速化は、特に大規模なプロジェクトにおいて、開発者の生産性の向上に直接つながります。
その他の注目すべき変更点 これには、壊れた Markdown リンクを処理するための新しいフック、絵文字のレンダリングを無効にする機能、カラー モード間の切り替え時の視覚的安定性の向上が含まれます。
これらの総合的な改良により、最新のドキュメント Web サイトを構築するための堅牢でパフォーマンスが高く、柔軟なプラットフォームとしての Docusaurus の地位が確固たるものになります。
