# 維護目錄

> 存放位置：本頁是目錄頁，落在 `JSC_WIKI_REPO_CONTENTS` 解出的專用存取庫（沒設定就退回 `JSC_WIKI_REPO`，都沒設定就停）。`MAINTAIN` 只有目錄頁、沒有內容頁，所以整個型別的紀錄就在這一頁。
> 版面：一個 H1 頁名、一段 `>` 引言，接著每一筆一個 H2 區塊。`MAINTAIN` 沒有內容頁，所以 H2 標題就是該存取庫的 `{owner}/{repo}`，標題不放連結、不加前後綴。存取庫名不會漂移，當鍵一樣穩；反過來造一個 `MAINTAIN_{HASH}` 式的標題，等於指向一個不存在的頁。欄位是標題底下的一層條列，一欄一條，格式 `- {欄位名}：{值}`。本頁不留 markdown 表格。
> 寫入語意：一個區塊代表一個受維護的存取庫。一律用 `jsc-gitea/tools/wiki-contents.sh upsert MAINTAIN 1 {owner}/{repo} {區塊檔} {本範本}` 單筆寫回：該存取庫已經有區塊就更新那個區塊，沒有才附加一個區塊，整頁一起送出。禁止整頁覆蓋，也不得改動別人的區塊。參數語意：`1` 是舊表格裡持有這一筆身分的那一欄的序號，也就是「存取庫」欄，只供自動轉檔用——本頁還是舊表格時，腳本靠這一欄取出 H2 標題（該欄沒有連結，就取格子純文字）；本頁已經是條列版面就完全忽略它。這個序號填錯，轉出來的標題就跟鍵對不上，既有那一筆會被當成新的附加上去，同一個存取庫變成兩個區塊，舊區塊從此再也更新不到，所以不是死參數、也不能隨便填。`{owner}/{repo}` 是 H2 標題，用來找既有區塊，寫這個存取庫實際的 `{owner}/{repo}`；`{區塊檔}` 是整個 H2 區塊的 markdown（`## {owner}/{repo}` 那一行加各條欄位），不是列檔。
> 連結寫法：一律寫成 `[{文字}]({連結})`。要指向別的頁型（例如交付頁）時，連結放 `jsc-gitea/tools/gitea.sh wiki-url` 給的絕對網址，不自行組路徑，也不用 `[[頁名]]` 或 `[[顯示文字|頁名]]`：後者只在同一個 wiki 內解析，寫錯不會報錯，畫面上看起來像純文字或死連結，巡不到也修不了。
> 寫入前驗證：要放進本頁的每一個連結先交給 `jsc-gitea/tools/link-check.sh`，結束碼 0 才寫入。有一筆 DEAD 就整個區塊不寫，把連不到的清單回報給呼叫端。驗證走 API，不看網頁狀態碼：私有存取庫的網頁網址對沒帶金鑰的請求一律回 404，照狀態碼判會把還活著的頁判成死連結。結束碼 `1`=至少一筆連不到、`2`=一個網址都沒給、`3`=`GITEA_HOST` 未設定、`7`=金鑰失效，停下回報金鑰問題，不得當成連不到。

<!-- 維護截止日 NULL = 永久維護 -->

## {owner}/{repo}

- 存取庫：{owner}/{repo}
- 維護方式：{例：套件更新與安全掃描}
- 維護起始日：{yyyy-MM-dd}
- 維護截止日：NULL
- 前次維護時間：{yyyy-MM-dd}