> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# ブログ記事を書く

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

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

手順の前に、[始める前に](https://supastack.dev/ja/docs/web/before-you-start.md) と [ターミナルの基本](https://supastack.dev/ja/docs/web/terminal-basics.md) をお読みください。これらの手順では、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 を実行して、コンテンツ検証エラーを確認します。

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


## 次へ

[プロダクトドキュメント](https://supastack.dev/ja/docs/web/docs-site.md)