如果你還不認識 Buroguru…

這是一份教你如何使用 Buroguru 快速部署自己 Notion 部落格的教學。

Step 1：建立資料庫

在部署 Buroguru 之前，你需要準備一個 Notion 資料庫作為部落格的內容來源。你可以複製這個模板，或依照下列欄位自行建立：

欄位名稱	類型	說明
`Title`	Title	文章標題
`id`	Text	文章的 ID，也是文章的網址尾段（slug），例如 `buruguru.zudo.cc/get-started-zh`
`Published`	Checkbox	是否發佈
`Tags`	Multi-select	分類標籤
`Date`	Date	發佈時間
`Description`	Text	預覽時顯示的摘要
`Thumbnail`	Files & media	縮圖圖片

為了讓 Buroguru 存取你的 Notion 資料庫，我們需要建立一個 Notion Integration 並取得金鑰。

建立新的 Integration

前往 Notion Integration 頁面，點選「Add Integration」，選擇資料庫所在的 workspace，並輸入名稱，例如 blog，logo 可略。
開啟權限

點進剛新增的 Integration，在 Content Capabilities 區塊中，至少開啟 Read content 權限。
複製 Notion token

建立後你會看到 Internal Integration Token，請複製這個 Token，稍後會使用。
加入資料庫連線

回到你剛剛建立的 Notion 資料庫（需為 full page），點右上角三點 → 選擇 Connections，並選擇剛剛建立的 Integration。
複製資料庫 ID

點選右上角的 Share → Copy Link，你會獲得一個類似這樣的連結：

https://www.notion.so/wusandwitch-notes/212d51c8314480ca8d4ffa62487XXXXXX?v=...

Database ID 就是 ? 前的那段 ID，例如上方範例為 212d51c8314480ca8d4ffa62487XXXXXX，請記下來，等等會用到。

當 Notion 整合完成後，你可以 fork Buroguru 專案並開始部署。

Fork 專案

前往 https://github.com/WuSandWitch/Buroguru 並點選 Fork

替你的 repo 命名，例如 WuSandWitch-Blog 。
設定 GitHub Secrets / Notion Token

Fork 完成後，前往 Settings → Secrets and variables → Actions，然後點選 New repository secret

新增一個名稱為 NOTION_TOKEN 的 Secret，值為剛剛複製的 Notion Integration Token。

再新增一個 Secret 名稱為 NOTION_DATABASE_ID，值為你剛剛記下的資料庫 ID。