For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ja/docs/web/blog-content.md (or send Accept: text/markdown).

ブログ記事を書く

機能するカテゴリとガイドリンクを持つローカルで型付きの記事を公開する。

このガイドについて質問

インストールとセットアップ

手順の前に、始める前にとターミナルの基本をお読みください。これらの手順では、VS Code で完全な supastack モノリポジトリを開いたことが前提となっています。そのルート package.json はリポジトリのルートをマークします。 pnpm コマンドでは、ワークスペースパッケージはアプリまたは共有コードフォルダーです。この製品では、ワークスペースはチームのデータコンテナであり、セキュリティ境界です。 corepack pnpm --filter ... コマンドがルートから実行されている間にモノリポジトリから 1 つのパッケージを選択します。同期されたモバイルフォルダーまたはデスクトップフォルダーのみを開いた場合、そのフォルダーには Web バックエンド、Docker セットアップ、またはルートスクリプトが含まれていません。このモノリポジトリまたはアクセス可能なホストサーバーからバックエンドを実行し、プラットフォームフォルダー独自のスクリプトを使用します。環境変数は、ローカルの .env ファイルまたはホスティングダッシュボードに保存される名前付き設定です。変更後に関連するアプリを再起動し、NEXT_PUBLIC_ および EXPO_PUBLIC_ 値にサーバーシークレットが含まれないようにします。

1. VS Code で apps/web/src/resources/content.ts を開き、開始点として近くの記事全体をコピーします。記事のコピーは、公開ダッシュボードではなくリポジトリに存在します。

2. 記事に新しいスラッグ、タイトル、カテゴリ、日付、セクション、および既存のガイドのスラッグを追加します。

3. リポジトリルートから corepack pnpm --filter @supastack/web dev を実行し、http://localhost:3000/blog/<your-slug>. を開きます。予想: URL を共有する前に、記事とその関連ガイドリンクがローカルに読み込まれます。

ブログのコンテンツは src/resources/content.ts および blog-posts.ts に保存されます。これはリポジトリ管理のコンテンツです。 CMS 公開サービスはありません。各投稿には、一意のスラッグ、タイトル、説明、カテゴリ、日付、関連ガイド、セクションが必要です。

{
  slug: 'your-article',
  title: 'A specific reader question',
  category: 'Guides',
  date: '2026-09-07',
  guide: 'web/local-setup',
  sections: [{ id: 'start', title: 'Start here', paragraphs: ['Your original text.'] }]
}

コピーするコマンド

コメントに従って、コマンドがどのフォルダーで実行されるかを確認します。 2 つのターミナルにラベルが付いている場合は、2 つのターミナルウィンドウを開き、2 番目のコマンドを使用している間、最初のコマンドを実行し続けます。

corepack pnpm --filter @supastack/web dev

# Replace <your-slug> with the article slug:
# http://localhost:3000/blog/<your-slug>
corepack pnpm test -- apps/web/src/resources/content.test.ts

実装ワークフロー

残りの型付きフィールドについては既存の完全な Post オブジェクトに従ってください。共有 URL が機能し続けるよう、公開後はスラッグを安定させてください。見出しは目次とアンカーリンクのために一意のセクション ID が必要です。

カテゴリは記事カタログから派生します。インデックスは URL フィルタリングを使い、記事ルートはコンテンツからメタデータを生成します。guide 値は既存のドキュメントスラッグと一致する必要があります。関連コンテンツは有用な次のステップへ導くべきです。

検証とトラブルシューティング

記事が 404 を返した場合は、そのスラッグが一意であること、および apps/web/src/resources/content.ts. の記事リストに追加されたことを確認してください。目次がどこにもジャンプしない場合は、すべてのセクションに一意の ID を与えます。ルートから corepack pnpm test -- apps/web/src/resources/content.test.ts を実行して、コンテンツ検証エラーを確認します。

コンテンツテストを実行し、記事ルートを開き、関連ガイドをたどり、フィルタ済みインデックスを確認します。日付と主張をソースと照合します。プレースホルダーリンクを公開したり、記事に登場するというだけで統合が検証済みと主張したりしないでください。