このインタラクティブツールを使って、zudo-docプロジェクトのオプションを設定し、セットアッププリセットを生成できます。出力はプログラマティックAPI用のJSON、またはターミナル用のCLIコマンドとしてコピーできます。

[Dynamic content unavailable in text export]

## 言語

**Default language**のセレクトでプライマリロケールを選び、プレフィックスのない`/docs/...`ルートを決めます。**Additional language codes**には`ja, de`のようなカンマ区切りの順序付きリストを入力します。空でないリストは自動的にi18nを追加し、生成プリセットの完全な`additionalLangs`配列になります。日本語や1つの追加ロケールに限定されません。

単一言語のプリセットにするには空欄のままにします。空欄では`additionalLangs`が省略され、`features`に`i18n`は追加されません。コードは小文字に正規化され、生成前に検証されます。重複、選択したデフォルトコード、パストラバーサル、区切り文字など安全でない値を入力するとインラインエラーが表示され、**Generate Preset**が無効になります。

生成ダイアログでは、同じハイドレーション済みフォーム状態を2つの形式で確認できます。次の簡略化したJSONはロケールフィールドに焦点を当てています。実際のプリセットには他に選択した機能も含まれます。

```json
{
  "defaultLang": "en",
  "additionalLangs": ["ja", "de"],
  "features": ["i18n"]
}
```

**as CLI command**チェックボックスで、対応する`--lang en --additional-langs ja,de --i18n`フラグをコピーできます。両方を指定した場合、CLIのリストがプリセットのリストを置き換え、追加はしません。旧来のブール値推論と明示的な`--no-i18n`に関する警告は[i18nガイド](https://zudo-doc.takazudomodular.com/ja/docs/guides/i18n)を参照してください。

## カラースキーム

ジェネレーターが同梱するカラースキームは `Default Light` と `Default Dark` の 2 つだけで、1 セットの OKLCH ランプを共有しています。**Single scheme** モードでは、ドロップダウンでどちらか一方を選べます。**Light & Dark（トグル）** モードでは、ペアリングは `Default Light` / `Default Dark` に固定されており、別のペアリングを選ぶスキームのドロップダウンはありません — あるのはデフォルトモードとシステム設定を尊重するかどうかのオプションだけです。

この 2 つの出発点を超えてパレットをカスタマイズするには、スキャフォールド後に自作の `colorSchemes` 上書きモジュール（独自のランプとセマンティックマップを持つ）を作成し、`zfb.config.ts` の `colorSchemes` フィールドで渡します — [カスタムカラースキームの追加](https://zudo-doc.takazudomodular.com/ja/docs/reference/color#%E3%82%AB%E3%82%B9%E3%82%BF%E3%83%A0%E3%82%AB%E3%83%A9%E3%83%BC%E3%82%B9%E3%82%AD%E3%83%BC%E3%83%A0%E3%81%AE%E8%BF%BD%E5%8A%A0) を参照し、[Design Token Panel](https://zudo-doc.takazudomodular.com/ja/docs/reference/design-token-panel) の Palette タブで変更をライブプレビューできます（[カラースキームプレビュー](https://zudo-doc.takazudomodular.com/ja/docs/guides/color-scheme-preview)を参照）。

## ヘッダー右側アイテム

「Header right items」セクションは `headerRightItems` フィールド — サイトヘッダー右側のクラスタ(外観メニュー、言語スイッチャー、バージョンスイッチャー、GitHub リンク、Design Token Panel / AI Chat トリガー)を構成します。各アイテムのオン・オフを切り替え、上下ボタンで描画順を変更できます。

2 種類のアイテム — `link`(任意の外部リンク)と `html`(生 HTML)— は、意図的に UI に出していません。これらを使う場合はスキャフォールド後に `zfb.config.ts` を直接編集してください。discriminated union のスキーマと使用例は [ヘッダー右側アイテム](https://zudo-doc.takazudomodular.com/ja/docs/guides/header-right-items) を参照してください。

## メタタグ

「Meta tags」セクションは `metaTags` フィールド — 各ページの `<head>` に出力されるメタタグを設定します。設定できる項目は以下のとおりです。

- **SEO description meta** — `<meta name="description">` を出力します。デフォルトでオン。
- **Keywords** — カンマ区切りのキーワードリストを持つ `<meta name="keywords">` を出力します。デフォルトでオフ。有効にするとテキスト入力欄が表示されます。
- **OGP image (og:image)** — `og:image`（と `twitter:image`）を出力します。デフォルトでオフ。有効にするとパス入力欄（デフォルト `/img/ogp.png`）が表示されます。
- **og:site_name** — `og:site_name` を出力します。デフォルトでオン。
- **Twitter card** — `twitter:card` ブロックを出力します。デフォルトでオフ。有効にするとカードタイプ選択（`summary` / `summary_large_image`）とオプションの `twitter:site` / `twitter:creator` ハンドル入力欄が表示されます。

`og:title` は常に出力され、ここには表示されません — DocHead の契約であり、この設定では無効化できません。

## その他の機能

Features セクションには、以下の機能もあります。

- **Image enlarge** — コンテンツ画像のクリック拡大。デフォルトで有効。
- **Tag governance** — タグの語彙ルール監査。詳細は [タグガバナンス](https://zudo-doc.takazudomodular.com/ja/docs/guides/tag-governance)。
- **Body foot util area** — 記事本文の末尾にタグリストやフィードバックリンクなどのユーティリティを差し込めるスロット。詳細は [Body foot util area](https://zudo-doc.takazudomodular.com/ja/docs/guides/body-foot-util-area)。
- **Footer taglist** — サイトフッターにグローバルタグクラウドを表示します。詳細は [Footer taglist](https://zudo-doc.takazudomodular.com/ja/docs/guides/footer-taglist)。
- **Design Token Panel** — スペーシング・フォント・サイズ・カラーの各トークンを編集するタブ型パネル。設定キーは `designTokenPanel`。
- **Avoid robots indexing** — `noindex: true`を設定し、すべてのページに`<meta name="robots" content="noindex, nofollow">`を出力し、`robots.txt`が`Disallow: /`を返すようにします。詳細は[ロボットインデックス回避](https://zudo-doc.takazudomodular.com/ja/docs/guides/avoid-robots-indexing)を参照してください。