## 概要

`CategoryTreeNav`は、カテゴリの子ページをネストされたツリー形式のリンク（`ul > li > ul > li`パターン）で表示する、サーバーレンダリングのzudo-reactコンポーネントです。カードグリッドスタイルの`CategoryNav`の代替として、より深いネストを持つカテゴリに適したコンパクトな表示を提供します。

[Dynamic content unavailable in text export]

`CategoryTreeNav`はすべてのMDXドキュメントページでグローバルに利用できます — インポートは不要です。アドモニションコンポーネント（`Note`、`Tip`など）と同様に、ドキュメントページルートで登録されています。



## ライブデモ

以下は`CategoryTreeNav`で「ガイド」カテゴリを表示した例です：

[Dynamic content unavailable in text export]

## 使い方

カテゴリの`index.mdx`で`CategoryTreeNav`を使用してコンパクトなツリー形式のリストを作成します：

```mdx
---
title: Getting Started
sidebar_position: 0
---

Welcome to the Getting Started section.

<CategoryTreeNav category="getting-started" />
```

`CategoryTreeNav`は完全にサーバー側でレンダリングされ、クライアントサイドJavaScriptはゼロです — ハイドレートディレクティブは不要です。

## CategoryNavとの比較

| 特徴 | CategoryNav | CategoryTreeNav |
|---------|-------------|-----------------|
| レイアウト | 2カラムカードグリッド | ネストされたツリーリスト |
| 説明文 | 各カード内に表示 | タイトルの後にインラインで表示 |
| ネスト | フラット（子のみ） | 無制限（フルデプス） |
| 最適な用途 | ランディングページ、概要 | 深い階層構造、コンパクトな一覧 |

## プロップ

| プロップ | 型 | デフォルト | 説明 |
|------|------|---------|-------------|
| `category` | `string` | （必須） | カテゴリスラッグ（例：`"guides"`、`"reference"`） |
| `lang` | `Locale` | 自動検出 | コンテンツコレクションのロケールを上書き |

`lang`プロップは現在のURLパスから自動的に検出されるため、通常は設定する必要はありません。

## ソース

コンポーネントのレンダリングロジックはパッケージの`@takazudo/zudo-doc/category-tree-nav`から提供され、パッケージ所有ルート（`packageOwnedRoutes`、デフォルトで有効）を通じてすべてのMDXドキュメントページに自動的に組み込まれます — プロジェクト側で保守すべきファイルはありません。