セットアッププリセットジェネレーター
create-zudo-docのセットアッププリセットを生成するインタラクティブヘルパー。
このインタラクティブツールを使って、zudo-docプロジェクトのオプションを設定し、セットアッププリセットを生成できます。出力はプログラマティックAPI用のJSON、またはターミナル用のCLIコマンドとしてコピーできます。
Project Name
Default Language
Color Scheme Mode
Color Scheme
Theme Pack
Features
Header right items
Markdown Options
Package Manager
カラースキーム
ジェネレーターが同梱するカラースキームは Default Light と Default Dark の 2 つだけで、1 セットの OKLCH ランプを共有しています。Single scheme モードでは、ドロップダウンでどちらか一方を選べます。Light & Dark(トグル) モードでは、ペアリングは Default Light / Default Dark に固定されており、別のペアリングを選ぶスキームのドロップダウンはありません — あるのはデフォルトモードとシステム設定を尊重するかどうかのオプションだけです。
この 2 つの出発点を超えてパレットをカスタマイズするには、スキャフォールド後に自作の colorSchemes 上書きモジュール(独自のランプとセマンティックマップを持つ)を作成し、zfb.config.ts の colorSchemes フィールドで渡します — カスタムカラースキームの追加 を参照し、Design Token Panel の Palette タブで変更をライブプレビューできます(カラースキームプレビューを参照)。
ヘッダー右側アイテム
「Header right items」セクションは headerRightItems フィールド — サイトヘッダー右側のクラスタ(テーマ切替、言語スイッチャー、バージョンスイッチャー、GitHub リンク、Design Token Panel / AI Chat トリガー)を構成します。各アイテムのオン・オフを切り替え、上下ボタンで描画順を変更できます。
2 種類のアイテム — link(任意の外部リンク)と html(生 HTML)— は、意図的に UI に出していません。これらを使う場合はスキャフォールド後に zfb.config.ts を直接編集してください。discriminated union のスキーマと使用例は ヘッダー右側アイテム を参照してください。
メタタグ
「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 — タグの語彙ルール監査。詳細は タグガバナンス。
Body foot util area — 記事本文の末尾にタグリストやフィードバックリンクなどのユーティリティを差し込めるスロット。詳細は Body foot util area。
Footer taglist — サイトフッターにグローバルタグクラウドを表示します。詳細は Footer taglist。
Design Token Panel — スペーシング・フォント・サイズ・カラーの各トークンを編集するタブ型パネル。設定キーは
designTokenPanel。Avoid robots indexing —
noindex: trueを設定し、すべてのページに<meta name="robots" content="noindex, nofollow">を出力し、robots.txtがDisallow: /を返すようにします。詳細はロボットインデックス回避を参照してください。