ローカルでの実行

frameworks/docusaurus で実行する。Bun 1.3.14 以降が必要で、ルートの mise.toml が固定バージョンを提供する。Bun を package manager と Docusaurus CLI・プロジェクトスクリプトの runtime の両方に使用する。

インストール

bun install

開発

Docusaurus の開発プロセスは一度に1ロケールを提供する。

bun run start       # 英語
bun run start:ja    # 日本語

英語は /docfw-cmp/docusaurus/en/、日本語は /docfw-cmp/docusaurus/ja/ という base 付き URL を使う。

本番ビルド

bun run build

wrapper はロケール別に build/en/ と build/ja/ を生成し、ブラウザー言語を 選択する build/index.html を追加する。Docusaurus は通常既定ロケール名を省略 するが、比較サイトでは両方の言語 segment が必要なためである。

リンクを検証するときは build/ を /docfw-cmp/docusaurus/ 以下で配信する。 ファイルシステム root での配信は GitHub Pages の base path を再現しない。