Contentful

contentful() ソースを使用して Delivery API 経由で Contentful のコンテンツタイプを読み込み、リッチテキスト本文を Markdown に変換します。追加のインストールは不要です。

組み込みの contentful() アダプターは、Content Delivery API を通じて 1 つのコンテンツタイプのエントリーを読み込み、各エントリーのリッチテキスト本文を Markdown に変換します。見出し、マーク、リンク、リスト、引用、テーブル、埋め込みアセットは、それぞれ対応する Markdown の要素に変換されます。Markdown の長文テキストフィールドに保持された本文は、記述されたとおりにそのまま渡されます。ただし、Web、メール、電話、相対アドレスのいずれでもないリンク（たとえば javascript: URL）は、リッチテキストの場合と同様にラベルのみが残ります。アダプターは REST API と直接通信するため、何もインストールする必要はありません。

import { defineConfig } from "blume";
import { contentful, filesystem } from "blume/sources";

export default defineConfig({
  content: {
    sources: [
      filesystem({ root: "docs" }),
      contentful({
        prefix: "guides",
        space: "abc123",
        contentType: "guide",
        // environment: "master", locale: "en-US"
        // Field ids default to title / description / slug / body, and the
        // date to sys.updatedAt
        fields: { body: "content" },
        // Extra Delivery API query parameters
        params: { "fields.section": "sdk" },
      }),
    ],
  },
});

Delivery API のトークンは、アダプターが宣言する CONTENTFUL_ACCESS_TOKEN 環境変数から取得されます。--preview を指定すると、アダプターは CONTENTFUL_PREVIEW_TOKEN を使用して Preview API から下書きを読み込みます。Preview API は配信用トークンを受け付けません。そのため、プレビュー用トークンなしで --preview を指定した場合は、CONTENTFUL_ACCESS_TOKEN にフォールバックせず、明確なエラーで失敗します。アセットはダウンロードされず、Contentful の CDN から参照されます。これらの URL は変わらないためです。contentfulSource を直接構築して custom() に渡す場合は、エンジンの serializers オプションを使用して、埋め込みエントリーを Blume コンポーネントにマッピングできます。このオプションのキーにはコンテンツタイプ ID を指定します。serializers を設定すると、返されたコンポーネントがレンダリングされるように、そのソースのページは MDX として書き出されます。シリアライザーが設定されていない埋め込みエントリーは、その旨がコメントとして出力されます。別のエントリーへのリンクには参照先のルートがないため、プレーンテキストとしてレンダリングされます。