12.0.0
12.0.0のリリースノート。
リリース日: 2026-11-13
破壊的変更
11.0.0 で削除した
findInPageキーが設定に残っている場合、zudoDoc()はそれを無視せずTypeErrorを投げるようになりました。メッセージがキーの削除を案内します。findInPageを含まない設定には影響しません。(#4763)@takazudo/zudo-doc-history-serverの peer 下限が^11.0.0から^12.0.0に上がりました。ドキュメント履歴を有効にするプロジェクトは history-server 12.x が必要です。
機能
複数のロケールに実際のコンテンツがあるページは、canonical リンクの後に
<link rel="alternate" hreflang>で互いにリンクするようになりました。自身への参照と、デフォルトロケールのページを指すx-defaultも含みます。サイトマップにも同じ対応がxhtml:linkの代替リンクとして載ります。対象はホームページと最新版のドキュメントページで、フォールバックのみのページ、バージョン付きページ、タグページは対応付けません。siteUrlがない場合や単一ロケールのサイトでは何も変わりません。@takazudo/にzudo- doc/ route- enumerators getDocLocaleAlternatesとgetHomeLocaleAlternatesを追加し、サイトマップのエントリに省略可能なalternatesフィールドを追加しました。(#4787)
バグ修正
サイトマップの
<lastmod>は、すべての URL にビルド日を入れる代わりに、各ドキュメントページのドキュメント履歴にある最終更新日を使うようになりました。ページの「更新日」表示と同じ日付です。日付が分からないルート(ホームとロケールのトップ、タグページ、アセットページ、バージョン付きページ、およびdocHistoryが無効な場合やドキュメント履歴の生成を省略した場合の全ページ)には<lastmod>を出力しません。@takazudo/にzudo- doc/ route- enumerators enumerateSitemapEntriesを追加しました。enumerateAllRoutesは変わりません。(#4784)llms.txt、llms-full.txt、ブラウザー検索インデックス(search-index.json)、エージェント向けエクスポート(マニフェスト、項目、検索インデックス)、MCPのsearch/fetchの結果に含まれるページURLが、ビルドされるルートと同じくtrailingSlash設定に従うようになりました。trailingSlash: trueでは末尾が/になり、リダイレクトするURLを引用しなくなります。trailingSlash: falseの出力は変わりません。スキーマとエージェントのページIDは変わりませんが、trailingSlash: trueのサイトではurlの値、llms.txtのバイト列、エージェント向けコーパスのフィンガープリントが変わります。(#4783)MCPの
search結果のタイトルで、複数に分割されたページの分割番号を一度だけ示すようになりました。たとえばRead-ではなくonly MCP server (part 1/ 2) (en · part 1/ 2) Read-only MCP server (en · part 1/2)になります。保存される項目のタイトルとfetchの結果は変わりません。(#4783)siteUrlにhttp:やhttps:のスキームがない場合(例:docs.example.com:8443)に、/が不透明なmcp Origin: nullを許可しなくなりました。許可されるオリジンを追加するのはhttp(s)のsiteUrlだけです。Originのないリクエストと、エンドポイント自身のオリジンからのリクエストの扱いは変わりません。(#4783)エージェント向けエクスポート(
/のページ、項目、検索インデックス)で、注記、agent/ v1/ <Details>、<TabItem>を**Note: タイトル**のような太字のラベルと本文に変換し、<CategoryNav>、<CategoryTreeNav>、<SiteTreeNav>、<DocCardNav>、<NoteTrayIndex>を同じ言語で書き出されたページへのMarkdownリンク一覧として出力するようになりました。これらのページにはunsupportedDynamicContentが付かなくなります。それ以外のコンポーネントや、propsがリテラルではないコンポーネントは、引き続きプレースホルダーになり、[Dynamic content unavailable in text export: MathBlock]のようにコンポーネント名を示します。フラグも残ります。これらのコンポーネントを使うページでは、項目のテキストとコーパスのフィンガープリントが変わります。llms-full.txtは変わりません。(#4786)