更新紀錄

2024-07 Version 3.3.0

內容更新至 CBETA 2024.R1。
Search engine 改用 Manticore 6.2.12
endpoint /sphinx 改為 /search，舊網址預定 2025 起停用。
endpoint /kwic3/juan 改為 /search/kwic，舊網址預定 2025 起停用。
新增 /search/similar 相似搜尋功能，詳見： https://api.cbetaonline.cn/static_pages/search_similar
/search/notes
- 含夾注
- around 參數決定回傳 highlight 欄位關鍵字前後字數
- 回傳 note_place 欄位
/search/variants 異體字查詢
- 如果「搜尋字串」中含「組字式」，會列出該缺字的：Unicode、Big5 通用字、Unicode 通用字。
文本 HTML
- 新增 CBETA 內部連結，詳見： https://api.cbetaonline.cn/static_pages/html_for_ui#links
- 擴增缺字資訊，詳見： https://api.cbetaonline.cn/static_pages/html_for_ui#gaiji

Sphinx 全文 index 分兩套：含夾注、不含夾注 (預設含夾注)。
- /sphinx/notes: 取消 note_place 參數
- /sphinx/all_in_one: 新增 note 參數，指定是否含夾注
KWIC index 分兩套：含夾注、不含夾注。
- /kwic3/juan: 新增 note 參數，指定是否含夾注
Sphinx、KWIC 不區分大小寫。

目錄：取消「分冊目錄」，比照 CBReader 提供「原書目錄」。詳見： https://api.cbetaonline.cn/static_pages/catalog
佛典內文 HTML footnotes 原用 <span class='footnote'>，因可能含多段落（例 B35n0195_p0798a03），改用 <div class='footnote'>。
佛典資訊成立地點 places 欄位多值，例： https://api.cbetaonline.cn/works?work=T1501
存取紀錄可按 Referer 輸出報表。
Fix bug: https://api.cbetaonline.cn/juans/goto?canon=LC&work=1

穩定版網址改為 https://cbdata.dila.edu.tw/stable, 舊網址 https://cbdata.dila.edu.tw/v1.2 將於 2023 Q1 起停用。
內容更新至 CBETA 2022 Q4
KWIC 只限單卷。
校注
- 星號校注新增流水號，詳見： https://api.cbetaonline.cn/static_pages/html_for_ui#note_star
- 提供資訊可用來連結至「CBETA 校訂考證資料庫」，見： https://api.cbetaonline.cn/static_pages/html_for_ui#note_research
Metadata for TextRef
佛典相關資訊（作譯者、年代等）改由 DILA Authority 取得。
目次回傳資料在允許情況下提供 type 與 n 欄位。
全文檢索
- Sphinx all_in_one 參數 canon 允許多值。
- sphinx/variants 異體字查詢，允許參數 scope=title，於經名中存在的才回傳。方便前端提供「搜尋經名」功能時可提供「異體字建議」。
存取紀錄
- 新增 Referer 欄位，建議呼叫 API 時在 HTTP request header 設定 Referer，以便存取分析。
- 可匯出 CSV.

以前的版本，如果單詞被夾注切斷，會搜不到。例如：搜尋「差別」，搜不到「差(音雌)別」。
因此做以下調整：
- Sphinx 全文檢索：夾注移至註解區，內文區的全文檢索不含夾注。因此可以達成「跨夾注搜尋」的功能。
- KWIC：不含夾注。
Q1 新增《太虛大書全書》，Catalog 新增以下功能：
- 各藏部別目錄： https://api.cbetaonline.cn/catalog_entry?q=bu
- 各藏冊別目錄： https://api.cbetaonline.cn/catalog_entry?q=vol
詳見說明： https://api.cbetaonline.cn/static_pages/catalog