Files

T

jiantw83 f4e489ceb4 feat(link): 連結一律寫成 [文字](絕對網址)，寫入前先驗證連得到

取消 [[頁名]] 與 [[顯示文字|頁名]] 兩種同 wiki 寫法，不再分「同存取庫」與
「跨存取庫」兩條規則。那種寫法只在自己那個 wiki 內解析，寫錯不報錯，畫面上
看起來像普通文字或死連結，巡不到也修不了。

連結寫進頁面前先過 jsc-gitea 的 link-check.sh，結束碼 0 才寫。驗證一律走 API，
不看網頁狀態碼：私有存取庫的網頁網址對未登入請求一律回 404，拿狀態碼判會把
好連結判成壞的。認證失敗回 7，與死連結的 1 分開，免得金鑰一過期就把還在的頁
整批判死。

2026-09-02 14:27:18 +08:00

2.1 KiB

Raw Blame History

交付目錄

存放位置：本頁是目錄頁，落在 JSC_WIKI_REPO_CONTENTS 解出的專用存取庫（沒設定就退回 JSC_WIKI_REPO，都沒設定就停）。交付頁 DELIVER_{HASH} 住在 JSC_WIKI_REPO_DELIVER 那一邊，兩者不同存取庫。寫入語意：一列代表一個工作包的交付。一律用 jsc-gitea/tools/wiki-contents.sh upsert DELIVER 6 {HASH} {列檔} {本範本} 單列寫回：該工作包已經有列就更新那一列，沒有才附加一列，整頁一起送出。禁止整頁覆蓋，也不得改動別人的列。連結寫法：一律寫成 [{文字}]({連結})。交付頁欄位的連結放 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} 加工作包編號（例 plugins/sdlc#WP-01）算出的完整 40 碼大寫十六進位，不截短、不加前綴。一個工作包一頁，彼此不覆蓋。

計畫名稱	工作包	交付	交付型別	交付頁	HASH	存取庫	交付時間
{計畫名稱}	WP-01 {工作包名稱}	是	API 文件	[{WP-01 工作包名稱}](https://{gitea 主機}/{owner}/{repo}/wiki/DELIVER_{HASH})	{HASH}	{owner}/{repo}	{yyyy-MM-dd HH:mm:ss}

2.1 KiB Raw Blame History

交付目錄

2.1 KiB

Raw Blame History