コンテンツエントリ（Content Entry）
マニフェスト内の解決済みのコンテンツ項目1件で、slugで識別されます。パーマリンク、公開先、frontmatter、公開状態、HTML、プラグインが提供するデータを保持します。
エントリが保持するもの
slug— 内部的なキー。publicLocation— 解決済みのパーマリンク、リダイレクト、メタデータ。frontmatter— 解析済みのメタデータ。html— 描画済みの本文。- サイトが描画するデータヘルパーやJSXコンポーネントなど、プラグインが提供するデータ。
slugとpermalink
slugはビルドの内部でエントリを識別し、permalinkは公開URLです。エントリへリンクする側はslugではなく、エントリのpermalinkを読みます。
コンテンツマニフェストのエントリのフィールド
各ContentManifestEntryは次のフィールドを持ち、すべてコンテンツ処理中に埋められます。
| フィールド | 型 | 説明 |
|---|---|---|
slug |
string |
エントリを識別する内部的なキー。 |
contentId |
string | undefined |
slug、permalink、エイリアス、リダイレクトとは独立した、ソースに著者が書く任意の安定したコンテンツ識別子。 |
permalink |
string |
解決済みの公開URL（例：/blog/my-post/）。 |
publicLocation |
ContentPublicLocation |
このエントリのslug、permalink、言語、リダイレクト、メタデータ。 |
title |
string |
ページのタイトル。 |
aliases |
readonly string[] |
明示的なリダイレクトのエイリアス。 |
frontmatter |
PostFrontmatter |
解析済みのfrontmatterメタデータ。 |
publishing |
ResolvedPublishingState |
公開状態（published、unlisted、draft、scheduledなど）。 |
html |
string |
描画済みのHTML本文。 |
tags |
string[] |
このエントリに関連付けられたタグ。 |
links |
ContentLink[] |
コンテンツ内で解決されたMarkdownリンク/WikiLinkの参照。 |
backlinks |
string[] |
コンテンツグラフから自動計算されるバックリンク。 |
assets |
ContentAsset[] |
このエントリに対してプラグインが宣言したアセット。 |
利用側は通常、リンクにはpermalink、メタデータにはfrontmatter、レイアウトの構成にはプラグインが提供するデータを使います。
ページがエントリのデータを読む方法
ページやテンプレートは、マニフェストの検索用マップを通じてエントリのデータにアクセスします。よくある形は次のとおりです。
- パーマリンクの解決：
entry.permalinkを直接読むか、slugからURLを引くbyPermalinkマップを使う。 - frontmatter：ページ単位のメタデータ（タイトル、日付、タグなど）に
entry.frontmatterでアクセスする。 - headタグ：プラグインが
entry.headTagsを提供し、サイトのシェルが<head>内に描画する。 - アセット：
entry.assetsにはプラグインが宣言したContentAssetが入る。サイトは出力時にコピーするか参照する。
サイトのテンプレートでのエントリ参照の例：
const entry = manifest.bySlug.get("my-post");
if (entry) {
const url = entry.permalink;
const title = entry.title;
const meta = entry.frontmatter;
}