コードと同じ場所にあるドキュメント

• 既存のドキュメントをそのまま利用。 Markdown、MDX、ローカルアセットをリポジトリから直接読み込むか、バージョンと整合性を固定した npm パッケージからサイトを構築できます。コンテンツソース。
• API リファレンスを生成。 ローカルの OpenAPI 仕様から、検索可能な概要と操作ごとのページを作成します。パラメータ、リクエストボディ、レスポンス、例を掲載できます。OpenAPI リファレンス。
• 検索を標準搭載。 Pagefind がページと見出しをローカルで索引化します。キーボードショートカットで検索を開き、検索用アセットは必要なときに読み込まれます。検索。
• ドキュメントの成長に対応するナビゲーション。 タブやグループ化したサイドバーでセクションを整理し、ページ内目次、前後のページへのリンク、モバイル用のナビゲーションドロワーを提供できます。検索とナビゲーション。
• 技術文書用のコンポーネント。 MDX でタブ、注意書き、カード、手順、コードグループ、コピー操作付きのコードハイライト、隔離された対話的プレビューを使えます。執筆用コンポーネント。
• 製品に合ったテーマ。 Tasty と Glaze でブランドカラー、セマンティックなパレット、フォント、タイポグラフィ、コンポーネントの各パーツを設定できます。ライト、ダーク、高コントラストの各表示には、ビルド時に生成した静的 CSS が配信されます。テーマとコンポーネント。
• 言語とバージョン。 翻訳ページやバージョン別のドキュメントを提供できます。切り替え先に対応するページがあれば、そのページへ移動します。言語とバージョン。
• 公開前の検証。 リンク切れ、アセットの欠落、重複したルート、無効なナビゲーションを、ソースの場所を示すエラーで検出します。事前生成した HTML は任意の静的ホストに公開できます。品質チェック。
• 共有しやすく、読み取りやすいページ。 正規 URL、ソーシャルプレビュー、サイトマップ、ダウンロード用 Markdown、コーディングエージェント向けの llms.txt 索引を公開できます。公開メタデータ。

README.md または docs/ ディレクトリがあるプロジェクトで、次を実行します。

npm create @tenphi/cookbook@latest docs-site -- --source . --yes
cd docs-site
npm run dev

Cookbook はファイルを現在の場所から読み込みます。新しいサイトを作る、npm に公開されたファイルをそのまま文書化する、既存の Astro プロジェクトに追加する方法もあります。

このページの原稿は docs/ja/index.md にあります。小さな Astro アプリ が、リポジトリの docs/ ディレクトリを直接読み込んでサイトを構築します。ナビゲーション、検索、コード操作、編集リンク、Git の更新日時は、どの Cookbook サイトでも利用できます。

• はじめに：リポジトリ、npm パッケージ、既存の Astro プロジェクト。
• ドキュメントツールの比較：Cookbook のコンテンツとカスタマイズの考え方。
• 使用例：リポジトリ、モノレポ、パッケージ、共有テーマ。
• 検索とナビゲーション：読者がページを見つける仕組み。
• 執筆：ページ、コンポーネント、対話的な例。
• テーマとコンポーネント：ブランド、トークン、フォント、組み込みスタイル、独自コンポーネント。
• デプロイ：検証と静的ホスティング。

これ以外のドキュメントは現在英語で公開されています。AI エージェント向けの手順、設定リファレンス、公開設定、CLI リファレンスも参照してください。