取消 [[頁名]] 與 [[顯示文字|頁名]] 兩種同 wiki 寫法,不再分「同存取庫」與 「跨存取庫」兩條規則。那種寫法只在自己那個 wiki 內解析,寫錯不報錯,畫面上 看起來像普通文字或死連結,巡不到也修不了。 連結寫進頁面前先過 jsc-gitea 的 link-check.sh,結束碼 0 才寫。驗證一律走 API, 不看網頁狀態碼:私有存取庫的網頁網址對未登入請求一律回 404,拿狀態碼判會把 好連結判成壞的。認證失敗回 7,與死連結的 1 分開,免得金鑰一過期就把還在的頁 整批判死。
1.8 KiB
1.8 KiB
盤點目錄
存放位置:本頁是目錄頁,落在
JSC_WIKI_REPO_CONTENTS解出的專用存取庫(沒設定就退回JSC_WIKI_REPO,都沒設定就停)。盤點頁REPO_{HASH}住在JSC_WIKI_REPO_REPO那一邊,兩者不同存取庫。 寫入語意:一列代表一個存取庫的盤點。一律用jsc-gitea/tools/wiki-contents.sh upsert REPO 1 {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=金鑰失效,停下回報金鑰問題,不得當成連不到。 HASH:由jsc-gitea/tools/hash-id對該存取庫自己的{owner}/{repo}算出的完整 40 碼大寫十六進位,不截短、不加前綴。
| 存取庫 | 盤點頁 | HASH | commit sha | 盤點時間 |
|---|---|---|---|---|
| {owner}/{repo} | [{owner}/{repo}](https://{gitea 主機}/{owner}/{repo}/wiki/REPO_{HASH}) | {HASH} | {sha} |
{yyyy-MM-dd} |