InterKit · 系統入口 / System Index

InterKit

互動展演工具組 — 型錄、場佈、序列生成與視覺語彙規範。
Generators · 生成工具
01 Catalog
Generator
型錄生成器 Open ↗
02 Setup
Generator
場佈生成器 Open ↗
Reference · 參考與資料
Visual Vocabulary Spec 視覺語彙規範
Luxmin · InterKit
InterKit 開發者指引
Developer Guide
一、在本機開啟(才能載入 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  ← 檔名:中文名_英文名

腳本據此自動產生每筆的 idnameCN / 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 讀取失敗