はじめに

Blume に統合を追加して、ドキュメントサイトを拡張する手順を説明します。

@tai-kun/blume-integrations は、Blume のドキュメントサイトに小さな機能を追加する Astro 統合のコレクションです。

収録されている統合

統合	説明	必要な設定
`routeByBrowserLanguage()`	デフォルトロケールの URL を、訪問者のブラウザー言語に合うロケールへ転送します。	Blume の i18n（`defaultLocale` と `locales`）
`typeTableDetailsIds()`	`TypeTable` の各行に固定 ID を付け、プロパティ名をその ID へのリンクにします。	なし

動作環境

パッケージ	バージョン
Astro	7.0.0 以上
Blume	2.0.0 以上

インストール

npm install @tai-kun/blume-integrations

pnpm add @tai-kun/blume-integrations

yarn add @tai-kun/blume-integrations

bun add @tai-kun/blume-integrations

nub add @tai-kun/blume-integrations

aube add @tai-kun/blume-integrations

設定

blume.config.ts の integrations に追加します。次の例では、TypeTable の行に ID を付ける統合を有効にしています。

import { typeTableDetailsIds } from "@tai-kun/blume-integrations";
import { defineConfig } from "blume";

export default defineConfig({
  integrations: [typeTableDetailsIds()],
});

routeByBrowserLanguage() を使う場合は、Blume の i18n の defaultLocale に locales のいずれかのコードを設定し、デフォルトロケールのコンテンツをコンテンツのルートに置きます。詳しい設定方法はブラウザーの言語でルーティングを参照してください。

次に読む

ブラウザーの言語でルーティング

デフォルトロケールの URL を、訪問者の言語に合うページへ転送します。

TypeTable の行に ID を付ける

型テーブルの特定のプロパティへ直接リンクできるようにします。