技述｜JS.GRIPE

寫文建站如何產生網站

寫文建站如何產生網站

Markdown 文章與頁面區塊產生靜態網站。瀏覽器功能在本機執行，可選服務在訪客同意後載入。

內容放在哪裡
路徑用途
content/posts/<文章>/zh-tw.md文章中繼資料與 Markdown 內文
content/pages/<頁面>/zh-tw.json包含有序版面區塊的頁面中繼資料
content/assets/公開圖片與其他內容資源
themes/<主題>/HTML 版面與主題樣式
config.yml導覽、主題與可選服務說明

使用 Node.js 22.12 或更新版本。建置輸出 dist/，可部署到 Cloudflare、Vercel、Netlify、騰訊 EdgeOne Pages 與阿里雲 ESA Pages。雜湊 CSS 與 JavaScript 快取一年，HTML 保持可重新驗證。

npm ci
npm run dev
npm run build

在 plugins.consent.services 按服務名稱註冊。訪客未同意時不載入對應資源；同意後，可見的嵌入按需載入。登入、儲存與其他後端能力由獨立服務負責，平台入口放在 backend/<平台名>。