一、在本機開啟(才能載入 SVG)
file:// 無法引入附檔,需開本機伺服器:
cd 專案資料夾
python3 -m http.server 8000
瀏覽器開 http://localhost:8000/InterKit_Setup_Generator.html
專案資料夾結構(同一層):
InterKit_Setup_Generator.html
build_asset_index.py ← 產生索引的腳本
asset_index.json ← 由腳本產生,勿手改
assets/…/*.svg ← 你的素材
(或用介面「⋯ → 資產 → 選擇資產資料夾」選含 asset_index.json 的資料夾,file:// 也可。)
二、資產採「資料夾即資料」
分類、分組、名稱全部由資料夾與檔名決定,不需手動編輯 JSON。階層即慣例:
assets/
人物 People/ ← 分類資料夾(中文 英文)
camera/ ← 分組資料夾(group id)
相機1_camera1.svg ← 檔名:中文名_英文名
腳本據此自動產生每筆的 id、nameCN / nameEN(檔名 _ 前後)、group(子資料夾名)與搜尋 tags;所有元件一律以固定 icon 尺寸生成,實際大小在畫布上再調。
三、新增元件 / 分組 / 分類
全部都只是「放檔案」,不開 JSON:
新增元件 → SVG 命名「中文_英文.svg」放進對應分組資料夾
新增分組 → 在分類資料夾下新建子資料夾(夾名=group id)
新增分類 → 在 assets/ 下新建「中文 英文」資料夾
子資料夾分組為選用;中英之間用半形底線 _ 分隔,英文尾數會自動補到中文(椅子_Chair1 → 椅子1)。
四、特規元件 profile(選用 · 進階)
分類資料夾名稱開頭加 [關鍵字] 前綴,即可讓整個分類套用特殊元件行為。前綴只影響分頁顯示名稱(會自動剝掉)與行為;分類鍵與 SVG 路徑仍用含括號的真實資料夾名:
[figure]… → 人物剪影:線框↔剪影、可填滿、底部中心錨點直立
[device]… → 設備剪影:只描邊、中心錨點擺放
[object]… → 物件:四角貼地透視、保留原色
(無前綴) → 一般素材:保留原色、可調描邊(預設)
例:把 人物 People/ 改名為 [figure]人物 People/,分頁仍顯示「人物 People」,但其中的 SVG 會套上人物剪影。未知關鍵字(如 [2024])視為一般素材、原名保留,--check 會印出提示。
五、重新產生索引並套用
放好檔案後,於專案根目錄執行:
python3 build_asset_index.py
它會掃描 assets/ 重產 asset_index.json,回瀏覽器重新整理即可看到新元件。若沒出現,開 Console 看有無 SVG 讀取失敗。