> ## 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/zh-tw/docs/web/before-you-start.md) 和[終端基礎知識](https://supastack.dev/zh-tw/docs/web/terminal-basics.md)。這些說明假設您在 VS Code 中開啟了完整的 supastack monorepo；它的根 package.json 標記儲存庫根。在 pnpm 命令中，工作區包是應用程式或共享程式碼資料夾；在產品中，工作空間是團隊的資料容器和安全邊界。 corepack pnpm --filter ... 從 monorepo 選擇一個包，同時從其根執行命令。如果您僅開啟同步的移動或桌面資料夾，則它不包含 Web 後端、Docker 設定或根指令碼：從此 monorepo 或可訪問的託管伺服器執行後端，並使用平臺資料夾自己的指令碼。環境變數是儲存在本地 .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.'] }]
}
```


## 要複製的命令

按照註釋檢視命令在哪個資料夾中執行。如果標記了兩個終端，請開啟兩個終端視窗，並在使用第二個命令時保持第一個命令執行。

```
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 物件補齊其餘型別欄位。釋出後保持 slug 穩定，讓已分享的 URL 繼續可用。標題需要唯一的 section id，供目錄與錨點連結使用。

分類來自文章目錄。索引使用基於 URL 的過濾，文章路由從內容生成後設資料。guide 欄位必須匹配已有的檔案 slug；相關內容應指向下一步有用的去處。


## 驗證與排障

如果文章返回 404，請檢查其 slug 是否唯一，並且是否已新增到 apps/web/src/resources/content.ts. 中的文章列表中。如果目錄無處跳轉，請為每個部分指定一個唯一的 id。從根目錄執行 corepack pnpm test -- apps/web/src/resources/content.test.ts 以檢視內容驗證錯誤。

執行內容測試，開啟文章路由，跟隨它的關聯指南，檢查過濾後的索引。對照原始資料核對日期與表述。不要釋出佔位連結，也不要僅因為某整合出現在文章裡就聲稱它已被驗證。


## 下一篇

[產品檔案](https://supastack.dev/zh-tw/docs/web/docs-site.md)