共編方式
網站公開供所有人瀏覽;原始碼保存在 GitHub 私有儲存庫,只有擁有者與受邀協作者可以維護。一般訪客可在瀏覽器記錄草稿並匯出,再交給認識的協作者審核,無法直接寫入公開內容。
指定協作者
- 由擁有者邀請進入私有儲存庫,接受邀請後建立自己的分支。
- 店家資訊編輯
data/restaurants.json;正式食記編輯docs/reviews/<食記ID>.md。 - 食記開頭的 JSON front matter 保存評分、作者、用餐日期等欄位,下方 Markdown 是食記內文。照片放在
data/,於photos中填入檔名與替代文字;內文末尾<!-- photos -->以下是公開圖片區。 - 執行
npm ci、npm test、npm run build。建置會將 Markdown 轉成首頁使用的 JSON 並驗證資料。 - 提交 Commit 與 Pull Request,由維護者審核合併 main;Cloudflare Pages 隨後重新建置公開網站。
同一作者在同一店家保留一則食記。修改時保留 id 與 authorId,updatedAt 必須更新,並與前一版至少間隔七天。旅客 ID 不代表已驗證身分;維護者仍需人工審稿。編輯正式食記時也要提交建置更新的 data/reviews.json,CI 會檢查它與 Markdown 是否一致。
投稿資料
將匯出的 JSON 每一筆轉為一份 Markdown。將 text 移到 front matter 下方,其他欄位保留;不要覆蓋別人的食記。新增店家的 id 使用小寫英文、數字與短橫線。
價格與營業資訊以記錄當時為準。只提交有權公開的文字與照片,請勿加入 email、IP、token 或私人備註。私有原始碼不會讓發布後的食記保密。