網站維護指南
架構(資料與程式分離)
| Repo | 位置 | 可見性 | 用途 |
|---|---|---|---|
| fengshen-db | D:\AI_Project\metaQuestMagic\封神演義資料庫 | 私有 | 資料源(單一真相),Obsidian vault,日後 Unity 也讀這個 |
| fengshen-wiki | D:\AI_Project\metaQuestMagic\封神wiki | 公開 | Quartz 站台程式;content/ 以 git submodule 引用 fengshen-db(不複製) |
- 線上網站:https://enl1217.github.io/fengshen-wiki/
- 資料只有一份(在 fengshen-db),wiki 只存程式+一個指向資料的指標,永不漂移
- GitHub Actions 用唯讀 deploy key 讀私有資料、自動 build 部署
日常更新(你只需碰資料庫)
- 在 Obsidian 開
封神演義資料庫編輯(改內容、加人物、放圖片) - 推送資料:
cd D:\AI_Project\metaQuestMagic\封神演義資料庫 git add -A git commit -m "更新說明" git push - 網站更新:
- 自動:每日 02:00(台灣時間)自動抓最新資料重建
- 立即:想馬上更新就跑
gh workflow run deploy.yml -R ENL1217/fengshen-wiki
封神wiki資料夾平時完全不用碰——除非你要改網站外觀(配色/字型在quartz.config.ts)。
內文自動連結(新增條目後跑)
內文提到的人物/法寶/法術名會自動變成可點連結。新增或大改條目後,跑一次即可:
cd D:\AI_Project\metaQuestMagic\封神演義資料庫
python 00-說明/scripts/autolink.py apply # 自動加內文連結(冪等,可重複跑)
python 00-說明/scripts/audit_links.py # 審查,輸出三張清單到 %TEMP%\link_audit.txt
- 別名感知:讀各頁「別名」欄,「女媧」自動連到
女媧娘娘(顯示女媧、連對頁) - 每次提到都連:任何一次提及都可點,不會有「怎麼沒連」的漏連感
- 保護原文:
>引文區塊(L1 原文)、既有連結、「」引文一律不動 - 防呆:避免子字串誤連(馬元帥不會變 馬元帥、余化龍不會變 余化龍)
- 審查三清單:① 疑似誤連(FP) ② 漏連(FN) ③ 紅鏈(分別名可解/真缺頁)。真缺頁清單=「還沒建的條目」待辦
放圖片
- 圖檔放進 vault(如
95-圖像資料/哪吒/像.jpg) - 在 md 裡引用:
![[像.jpg]] - commit + push 資料庫 → 網站自動帶入顯示
⚠ frontmatter YAML 規則(重要)
Quartz 用嚴格 YAML,列表欄位的每個元素必須加引號,且不能在 [...] 裡混未引號的 (註記) 或 [[連結]]。正確:
同門: ["[[廣成子]]", "[[赤精子]]"] # ✓ 每項引號
教主: "[[紂王]](天子)/[[聞仲]](太師)" # ✓ 整值引號錯誤(Obsidian 容忍但 Quartz 會擋):
同門: [闡教十二代弟子([[廣成子]]、...)] # ✗ 未引號混連結(既有 384 條已全部正規化;新增條目請照此規則。)
首次設定紀錄(已完成,供參考)
- 兩 repo git init;fengshen-db 私有、fengshen-wiki 公開
- submodule:
git submodule add https://github.com/ENL1217/fengshen-db.git content - deploy key(唯讀):公鑰加 fengshen-db、私鑰設為 fengshen-wiki 的 secret
CONTENT_DEPLOY_KEY - Pages 環境允許分支加入
master .gitignore排除node_modules/、public/
之後接 Unity
fengshen-db 是共用資料源。Unity 專案 clone fengshen-db,用匯出腳本轉 JSON 讀取(見 待辦與規劃 C 節)。三邊(資料庫/wiki/Unity)共用同一份資料。