# 這一包 JSON 檔的欄位說明

這份是檔案格式的說明，不是本書內容。版本：第一版（第八次修訂）；修訂日：2026-10-20（原定版日 2026-10-11）；數據截至：2026/10/8。
所有 JSON 都是 UTF-8。文字欄位都是本書或總圖表的原文，沒有改寫。

## 編號規則

| 編號 | 寫法 | 規則 |
|---|---|---|
| 章號 | 0–8 | 本書的章，共 9 章 |
| 圖號 | `<章號>-<序號>`，例 `6-6` | 成品上印的圖號，共 36 張；圖檔是 `figures/fig-<章號>-<序號>.svg` |
| 主張編號 | `F-<章號>-<兩位數序號>`，例 `F-3-03` | 各章「主張」由上到下，共 57 條 |
| 文獻編號 | 1–97 | 本書「理論基礎與文獻」表由上到下 |
| 名詞編號 | 1–87 | 本書「標準名詞表」由上到下 |

## facts.json

頂層：`version` 版本、`data_to` 數據截至日、`release_date` 修訂日、`original_release_date` 原定版日、`generated` 產生日、`fields` 欄位說明、`facts` 主張陣列。

| 欄位 | 意思 |
|---|---|
| id | 主張編號 |
| chapter | 章號 |
| chapter_title | 章名（原文） |
| claim | 主張（原文，只把圖號換成成品上的圖號） |
| why | 原因（原文，只把圖號換成成品上的圖號） |
| figures | claim 與 why 文字裡提到的圖號，依出現順序、不重複；沒提到就是空陣列 |
| chapter_figures | 該章全部圖號，依本書順序 |

## figures.json

頂層是 36 個物件的陣列，依圖號順序。

| 欄位 | 意思 |
|---|---|
| id | 圖號 |
| title | 圖名（成品原文） |
| chapter、chapter_title、chapter_question | 章號、章名、該章「本章回答」的問句 |
| role | 這張圖的作用：總圖表上印的那一句 |
| how_to_read | 怎麼看這張圖（原文） |
| width、height | SVG 的寬高（viewBox） |
| file | 圖檔相對路徑 |
| sha256 | 圖檔的 SHA-256 |
| text | 圖內文字，依 SVG 內出現順序的字串陣列 |
| relations | 這張圖連到哪些圖：`to` 對方圖號、`how` 總圖表上那筆關聯的原標記文字、`kind` 歸類（只有四種：展開、延伸、接／對照、順序） |
| facts.mentioned_by | 文字裡點名這張圖的主張編號 |
| facts.same_chapter | 與這張圖同章的主張編號 |

## figures.relations.json

| 欄位 | 意思 |
|---|---|
| legend_title、legend | 總圖表圖例：`line` 線的類別、`name` 圖例上的名稱、`meaning` 圖例上的說明 |
| kinds | `kind` 的四種值 |
| kind_basis | `kind` 的歸類依據：總圖表原始檔每條關聯畫線時用的類別 |
| how_to_kind | 原標記 `how` 歸到哪一類 `kind` 的對照表 |
| kind_pairs | 四類各有幾筆關聯 |
| how_values | `how` 出現過的每一種值：`kind` 歸類、`pairs` 幾筆關聯用它、`legend` 對應的圖例名稱（圖例沒有另外定義的是 null） |
| pairs_total | 關聯總筆數（一筆關聯在兩張圖各出現一次） |
| source_note | 總圖表說明檔關於關聯的原句 |

## glossary.json 與 glossary.keyed.json

`glossary.json` 是來源原樣：每筆是 6 個字串的陣列，順序＝繁體中文、English、日本語、简体中文、行銷學對應、定義。
`glossary.keyed.json` 是同一份內容加上欄位名：

| 欄位 | 意思 |
|---|---|
| id | 名詞編號 |
| zh_hant、en、ja、zh_hans | 繁體中文、英文、日文、簡體中文的名稱 |
| category | 行銷學對應 |
| definition | 定義 |

## refs.json 與 refs.indexed.json

`refs.json` 是來源原樣：`lead` 前言、`cats` 分類陣列（每類有 `name` 與 `items`，每筆 `theory` 理論、`citation` 出處、`use` IDAEO 怎麼用）、`note` 附註。
`refs.indexed.json` 把全部文獻展平：

| 欄位 | 意思 |
|---|---|
| id | 文獻編號 |
| category | 所屬分類的名稱（原文，即 `refs.json` 的 `cats[].name`） |
| theory | 理論（原文，欄名同來源 `items[].theory`） |
| citation | 出處（原文，欄名同來源） |
| use | IDAEO 怎麼用（原文，欄名同來源 `items[].use`） |

`theory`、`citation`、`use` 三欄是本書文獻表原有的三欄，欄名與文字都照來源；`id` 與 `category` 是為了方便取用而加的編號與分類名。

## jsonld-textbook.json、jsonld-atlas.json

schema.org 的 JSON-LD。`hasPart` 是各章（本書）或各圖（總圖表）；章的 `description` 是該章「本章回答」原句，圖的 `description` 是 figures.json 的 role。
`encoding` 列出這一包的資料檔與 SHA-256。`dateModified` 是修訂日。
`workTranslation` 是 schema.org 的翻譯版屬性：列出简体中文、English、日本語翻譯版（網站另行發布，不在本包），每筆有 `inLanguage`（BCP 47 語言碼）、網址，以及反指本作的 `translationOfWork`。

## manifest.json

| 欄位 | 意思 |
|---|---|
| version、version_path、data_to、release_date、generated | 版本、版本在網址裡的路徑段（v1）、數據截至日、修訂日、產生日 |
| original_release_date、publisher | 原定版日（修訂前的第一版）、發行 |
| status、base_url | 上線狀態與規劃中的網址 |
| source | 定版本書與定版總圖表兩個成品的 SHA-256 |
| audiences | 五類受眾各自適合讀的檔案 |
| files | 每個檔的 `path`、`bytes`、`sha256`（不含 manifest.json、SHA256SUMS、SHA256SUMS.txt） |
| languages | 本書與總圖表的語言（BCP 47）：本包是 zh-Hant，其餘是翻譯版 |
| translations、translations_note | 每種翻譯語言的 `lang`、`name`、`textbook` 與 `atlas` 兩個原檔網址、`reader` 專區閱讀頁網址；翻譯版不在本包的 files 與 SHA256SUMS 內 |