# 報表目錄

> 由 `jsc-log:report` 維護。年、月、週、日各一個區塊；`HASH` 取 `{owner}/{repo}/{期間}` 的完整 40 碼大寫十六進位 SHA-1，算法與其他頁面共用，但這裡的 `{owner}/{repo}` 取 REPORT wiki 存取庫，不是程式碼存取庫。
> 本頁落在 `JSC_WIKI_REPO_CONTENTS` 解出的專用存取庫，報表頁 `REPORT_{HASH}` 落在 `JSC_WIKI_REPO_REPORT` 的存取庫，兩者分屬不同 wiki。
> 連結寫法：報表頁那一條寫成 `[{頁名}]({絕對網址})`，網址取自 `jsc-gitea/tools/gitea.sh wiki-url`，不用 `[[...]]`。兩頁分屬不同存取庫，`[[...]]` 連不過去，畫面上還看不出壞掉。
> 連結驗證：每個要寫進本頁的連結先交給 `jsc-gitea/tools/link-check.sh`，退出碼 0 才寫入。出現 DEAD 就不寫，把連不到的那幾筆回報給呼叫端。
> 寫入語意：一個區塊代表一個報表頁，也就是一個存取庫的一種期間。一律用 `jsc-gitea/tools/wiki-contents.sh upsert REPORT 1 REPORT_{HASH} {區塊檔} {本範本}` 單一區塊整頁寫回——它讀整頁、找得到該報表頁既有的那個區塊就換掉，找不到才附加到頁尾。
> 參數語意：`<key-col>` 的 `1` 只在舊頁還是表格時用得到，代表轉檔時取第 1 欄格子的文字當 H2 標題，格子是 `[文字](網址)` 就只取文字；頁面已經是條列格式就完全忽略它。`<key>` 是 H2 標題文字，也就是內容頁頁名 `REPORT_{HASH}`。第四個參數是區塊檔，內容是 `## {key}` 那一行加空行加各條欄位，不是一列表格。
> 鍵是 H2 標題的頁名，不是連結。頁名只由 `{owner}/{repo}/{期間}` 決定，`GITEA_HOST` 一換或 Gitea 對頁名的編碼有差都動不到它；連結帶著主機名與頁名編碼，一變就跟上一輪寫的不一樣，拿它當鍵就比不到既有那一筆，走附加，同一個報表頁多出第二個區塊，舊區塊從此不再更新。
> 但 `JSC_WIKI_REPO_REPORT` 改指別的存取庫是另一回事：`HASH` 本身就取自 REPORT wiki 存取庫，換庫等於換頁，四個期間會各多一個區塊。那是換庫的本意，不是鍵失準，舊區塊請人工清掉。
> 禁止整頁覆蓋，也不得改動別人的區塊。

## REPORT_{HASH}

- 報表頁：[REPORT_{HASH}]({報表頁絕對網址})
- HASH：{HASH}
- 期間：{daily、weekly、monthly、yearly 四選一}
- 最新一期：{最新一期的標籤}
- 期數：{n}
- 最後更新：{yyyy-MM-dd HH:mm}