---
order: 3
section: guides
title: コンテンツモデル
description: ファイル、フロントマター、組み込みフィールド、リダイレクト、そして scribe validate のチェック内容についての解説です。
noindex: false
canonicalPath: /ja/docs/content-model
---
## Files

1つのドキュメントは、コンテンツタイプのフォルダ内にある1つの `.mdx`（または `.md`）ファイルに対応します。

```text
content/
  blog/
    hello-world.mdx        → slug "hello-world"
    _redirects.json        → redirect rules for this type (optional)
  authors/
    jane.mdx               → slug "jane"
```

- **ファイル名がそのまま英語のスラッグになります**。スラッグには小文字のケバブケース（kebab-case）を使用します。
- ディスク上に存在するのは英語のファイルのみです。他の言語バージョンはSQLiteストア内に保存されます。
- ファイル名が `_` や大文字で始まるファイル（例: `PUBLISHING.md`）は無視されます。コンテンツの横にメモを残したい場合に便利です。

## Frontmatter

フロントマターはYAML形式で記述し、コンテンツタイプで設定したZodスキーマに基づいて検証されます。

```mdx
---
title: "Hello, world"
description: "A long enough description for the schema."
author: jane
publishedAt: "2026-01-15"
updatedAt: "2026-02-01"
---

Body is MDX.
```

スキーマの検証はZodの設定に従います。通常の `z.object` を使用した場合、未定義のキーは静かに除外されます。フィールド名の入力ミスをエラーとして扱いたい場合は `.strict()` を使用してください。

## Built-in frontmatter fields

以下のフィールドは、スキーマで宣言しなくても**すべて**のコンテンツタイプで利用できます。これらはスキーマの処理が実行される前にフロントマターから抽出されるため、Zodスキーマ内で明示的に宣言しても効果はありません。

| フィールド | タイプ | 説明 |
| --- | --- | --- |
| `publishedAt` | ISO date | 公開日。 |
| `updatedAt` | ISO date | 最終更新日。デフォルトは `publishedAt` です。サイトマップの `lastModified` に反映されます。 |
| `noindex` | boolean | サイトマップから除外します。ページのrobotsメタタグとして出力できます。 |
| `canonicalPath` | string | 正規URLパスを手動で上書きします。 |

各言語のドキュメントは、英語の親ドキュメントから `publishedAt`、`updatedAt`、`noindex`、`canonicalPath` を継承します。翻訳者がこれらを変更することはできません。

また、読み込まれたすべてのドキュメントには、`slug`、`enSlug`（英語の親スラッグ。英語ドキュメントの場合は `slug` と同一）、`locale`、`frontmatter`、`content` が含まれます。

## Bodyless types

参照専用のコレクション（スキーマが構造のみで構成される `model` や `category` などのタイプ）では、MDXの本文が不要なことがよくあります。この場合、タイプに `body: false` を指定して明示します。

```ts
defineContentType({
  id: "model",
  contentDir: "models",
  schema: modelSchema,
  body: false, // entries are frontmatter-only
});
```

デフォルトは `body: true` であるため、完全な下位互換性が保たれます。`body: false` のタイプに空白以外の本文が含まれているとバリデーションエラーになります。また、ローダーはMDXの解析をスキップし、静的エクスポートでも本文は出力されません。翻訳可能なフィールドが**ゼロ**の本文なしタイプは、すべての翻訳ワークフローからも除外されます（不要な通知を防ぎます）。一方、翻訳可能なフィールドを持つ本文なしタイプは、フロントマターのみのペイロードとしてToDoに残ります。翻訳可能性のルールについては、[translation](/docs/translation) を参照してください。

## Beyond frontmatter

MDXの本文では、単なるテキスト以上の表現が可能です。

- [インライントークン](/docs/inline-tokens)を使用すると、リンク、アセットURL、翻訳不要なリテラルを本文に直接埋め込み、読み込み時に言語ごとに解決できます。
- `field.asset()` で宣言された[アセット](/docs/assets)はディスク上で検証され、読み込み時に公開URLとして解決されます。

## Redirects: `_redirects.json`

コンテンツタイプのフォルダごとにオプションの `_redirects.json` ファイルを追加することで、スラッグの移行や廃止されたドキュメントを定義できます。ソースのMDXを削除してもリダイレクトは機能し続けます。翻訳元のスラッグはSQLiteから自動的に展開されます。

```json
{
  "redirects": [
    { "from": "hello-world", "toSlug": "hello-scribe" },
    { "from": ["old-a", "old-b"], "toSlug": "hello-scribe" },
    { "from": "moved-post", "toType": "glossary", "toSlug": "virtual-try-on" },
    { "from": "retired-page", "toUrl": "/pricing" },
    { "from": "retired-ext", "toUrl": "https://example.com/app" }
  ]
}
```

リダイレクトには3つの種類があります（エントリごとにターゲットは1つだけ指定します）。

| 種類 | フィールド | 説明 |
| --- | --- | --- |
| Same-type | `toSlug` | 同じコンテンツタイプ内のターゲットとなる英語スラッグ。URLはこのタイプの `path` から構築され、言語ごとにローカライズされます。 |
| Cross-type | `toType` + `toSlug` | ルーティング可能な別のコンテンツタイプ（`path` が必須）のターゲットとなる英語スラッグ。 |
| Anywhere | `toUrl` | ルート相対の同一サイトパス、または絶対外部URL。すべての言語で共通です。 |

- `from`: 英語のスラッグのみ指定可能です。翻訳元のスラッグはSQLiteから解決されます。
- オプションの `permanent`（デフォルトは `true`）。

ドキュメントを廃止または名前変更するには、`_redirects.json` にエントリを追加し、ソースのMDXを削除（または名前変更）してから、`scribe validate` を実行して再ビルドします。リダイレクトのルールは、プロキシやフレームワークの設定用に `buildAllContentRedirects()` によって出力されます。

## Validation

```bash
scribe validate
```

英語のファイルごとに、スキーマの解析、組み込みフィールドの形式、`crossValidate` フック、そして**本文のMDXコンパイル**をチェックします。MDXとして解析できない本文は、英語のソースでも保存された翻訳でも、ビルドをブロックするエラーとなります。

プロジェクト全体では以下の項目もチェックします。リレーションの整合性（必須リレーションの欠落はエラー、オプションのリレーションの欠落は警告）、`_redirects.json` のルール（有効なターゲット、ソースの重複なし、リダイレクトチェーンの不在）、ローカライズされたスラッグの接尾辞ルール、[宣言されたアセットフィールド](/docs/assets)（ファイルの存在、`formats`、`maxKB`）、[本文のインライントークン](/docs/inline-tokens)（不正なスパン、リレーションの欠落、ルーティング不可タイプへの `:href`、`vars` キーの欠落、アセットファイルの欠落）、本文を含んでいる `body: false` タイプ、アセットディレクトリ設定時の画像アセットの欠落、および翻訳ストアの存在。

エラーが見つかった場合、終了コードはゼロ以外になります。ビルドの前に必ず実行してください。

```json
{
  "scripts": {
    "build": "scribe validate && <your framework build>"
  }
}
```