網站維護指南

架構(資料與程式分離)

Repo位置可見性用途
fengshen-dbD:\AI_Project\metaQuestMagic\封神演義資料庫私有資料源(單一真相),Obsidian vault,日後 Unity 也讀這個
fengshen-wikiD:\AI_Project\metaQuestMagic\封神wiki公開Quartz 站台程式;content/ 以 git submodule 引用 fengshen-db(不複製)
  • 線上網站:https://enl1217.github.io/fengshen-wiki/
  • 資料只有一份(在 fengshen-db),wiki 只存程式+一個指向資料的指標,永不漂移
  • GitHub Actions 用唯讀 deploy key 讀私有資料、自動 build 部署

日常更新(你只需碰資料庫)

  1. 在 Obsidian 開 封神演義資料庫 編輯(改內容、加人物、放圖片)
  2. 推送資料:
    cd D:\AI_Project\metaQuestMagic\封神演義資料庫
    git add -A
    git commit -m "更新說明"
    git push
    
  3. 網站更新:
    • 自動:每日 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) ③ 紅鏈(分別名可解/真缺頁)。真缺頁清單=「還沒建的條目」待辦

放圖片

  1. 圖檔放進 vault(如 95-圖像資料/哪吒/像.jpg)
  2. 在 md 裡引用:![[像.jpg]]
  3. 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)共用同一份資料。