実践評価
Docus サンプルの実装から得た所感と、日付を明記した検証可能な事実です。
実践評価
この評価は 2026-07-19 に再調査・再ビルドしました。所感はこの実装から、 バージョンや機能の説明は外部から確認できる情報から分けて記載します。
実装して得た所感
- 最小限の有用な多言語サイトはコンテンツ中心で作れました。Docus レイヤーが レイアウト、ナビゲーション、検索、カラーモード、ルーティングをまとめて提供します。
- 一方でレイヤーは意見の強い設計です。ヘッダーのブランドリンクの見た目のように テーマ設定が公開していない部分を変えるには、Nuxt レイヤーのコンポーネントを 1つローカルで上書きする必要があり、テーマ設定の編集ほど分かりやすくはありません。
- 静的出力自体は動きますが、GitHub Pages では
baseURLとautoSubfolderIndexの明示が必要です。標準スターターのサーバービルドとは異なります。 - MDC と Nuxt UI はリッチなページを作りやすい反面、最小構成の Markdown SSG より 依存関係とビルド対象が大きくなります。
検証可能なスナップショット
| 項目 | 2026-07-19 時点で確認した事実 |
|---|---|
| Docus | package.json で 5.12.3 を固定 |
| 基盤 | 公式リポジトリ記載の Nuxt 4、Nuxt Content、Nuxt UI、Nuxt Image |
| 依存条件 | Docus 5 スターターは Nuxt 4 と better-sqlite3 12 を使用 |
| 検索 | 設定ガイドでは Fuse.js のクライアント検索が既定で、FTS5 は任意 |
| i18n | 公式リポジトリに言語別コンテンツツリーを持つ i18n スターターが存在 |
| 静的出力 | nuxt generate により .output/public へ日英38ルートをディレクトリ形式で生成 |
選定のまとめ
Nuxt を使うチームが、MDC、Nuxt UI、検索、画像連携、自動ナビゲーションを 一体で欲しい場合に Docus は有力です。依存の小ささや抽象層の少なさを優先するなら、 より小規模な SSG も比較対象にすべきです。