跳至主要内容

共編方式

網站公開供所有人瀏覽;原始碼保存在 GitHub 私有儲存庫,只有擁有者與受邀協作者可以維護。一般訪客可在瀏覽器記錄草稿並匯出,再交給認識的協作者審核,無法直接寫入公開內容。

指定協作者​

  1. 由擁有者邀請進入私有儲存庫,接受邀請後建立自己的分支。
  2. 店家資訊編輯 data/restaurants.json;正式食記編輯 docs/reviews/<食記ID>.md。
  3. 食記開頭的 JSON front matter 保存評分、作者、用餐日期等欄位,下方 Markdown 是食記內文。照片放在 data/,於 photos 中填入檔名與替代文字;內文末尾 <!-- photos --> 以下是公開圖片區。
  4. 執行 npm ci、npm test、npm run build。建置會將 Markdown 轉成首頁使用的 JSON 並驗證資料。
  5. 提交 Commit 與 Pull Request,由維護者審核合併 main;Cloudflare Pages 隨後重新建置公開網站。

同一作者在同一店家保留一則食記。修改時保留 id 與 authorId,updatedAt 必須更新,並與前一版至少間隔七天。旅客 ID 不代表已驗證身分;維護者仍需人工審稿。編輯正式食記時也要提交建置更新的 data/reviews.json,CI 會檢查它與 Markdown 是否一致。

投稿資料​

將匯出的 JSON 每一筆轉為一份 Markdown。將 text 移到 front matter 下方,其他欄位保留;不要覆蓋別人的食記。新增店家的 id 使用小寫英文、數字與短橫線。

價格與營業資訊以記錄當時為準。只提交有權公開的文字與照片,請勿加入 email、IP、token 或私人備註。私有原始碼不會讓發布後的食記保密。