アダプター
Takuhon のデータモデルとロジックは @takuhon/core にあり、プロフィールのホスト先には
依存しません。アダプター は、そのコアを特定のプラットフォーム — そのストレージ・
ランタイム・デプロイフロー — に接続し、同じ takuhon.json がどこでも動くようにします。
どう積み重なるか
Section titled “どう積み重なるか”@takuhon/core— スキーマ、バリデーション、ロケール解決、JSON-LD 生成、ストレージインターフェース。@takuhon/api— フレームワーク非依存の Hono ハンドラと RFC 7807 エラーエンベロープ。- アダプター — API をプラットフォームのストレージとランタイムに結線し、デプロイ経路を提供します。
利用可能なアダプター
Section titled “利用可能なアダプター”| アダプター | プラットフォーム | ステータス |
|---|---|---|
@takuhon/cloudflare | Cloudflare Workers + KV | 利用可能 |
| Static | ビルド済みの静的出力(takuhon build) | 利用可能 |
@takuhon/vercel | Vercel | 利用可能(read-only) |
| WordPress | WordPress プラグイン | 利用可能(Phase 1) |
Cloudflare アダプターは現在のリファレンスデプロイです: GET /(および各 /<locale>/)が
クローラー向けに Schema.org JSON-LD を埋め込んだサーバーレンダリングのプロフィールページを
返し、公開 JSON API・Workers KV ストレージ・トークンで保護された admin エンドポイントを
備えます。takuhon build は同じページをビルド済みの静的サイトとして出力でき、アカウントや
KV なしでどこにでもホストできます。ルートと完全なデプロイフローについては
@takuhon/cloudflare アダプターの README
を参照してください。
@takuhon/vercel
アダプターは、同じプロフィールページ・公開 API・JSON-LD を Vercel で配信します。
read-only です — データベース・admin UI・認証は持たず、takuhon.json を Git で
編集すると Vercel が再デプロイします。Cloudflare 専用の機能(画像アップロード・MCP
エンドポイント・activity バッジ)は含まれません。admin エディタやこれらの機能が必要な
場合は Cloudflare を使ってください。
WordPress アダプターはプラグイン(Phase 1)として、プロジェクトの
GitHub Releases(タグ wordpress-v*)で
zip 配布されています。WordPress は PHP で動作し、TypeScript の @takuhon/api を
実行できないため、プラグインの管理画面が保存時にブラウザ上で @takuhon/core/@takuhon/api
を使って公開用の成果物(プライバシーフィルター済みプロフィール・JSON-LD・サーバー
レンダリングされたページ)を生成します。PHP は保存と配信のみを担い、Takuhon のロジックを
PHP で再実装しません。takuhon/profile Gutenberg ブロックが、このサイトまたはリモートの
takuhon API からプロフィールを埋め込みます。Phase 1 は最小の JSON エディタで、より
リッチなフォームエディタは Phase 2 で予定しています。
ライセンスについて
Section titled “ライセンスについて”コアパッケージとほとんどのアダプターは Apache-2.0 です。WordPress アダプターは、 配布される場合 GPL-2.0-or-later です(WordPress の派生著作物ライセンスにより要求 されます)。あなたのプロフィールコンテンツのライセンスは別の選択です — ライセンス を参照してください。