feat(link): 連結一律寫成 [文字](絕對網址),寫入前先驗證連得到
取消 [[頁名]] 與 [[顯示文字|頁名]] 兩種同 wiki 寫法,不再分「同存取庫」與 「跨存取庫」兩條規則。那種寫法只在自己那個 wiki 內解析,寫錯不報錯,畫面上 看起來像普通文字或死連結,巡不到也修不了。 連結寫進頁面前先過 jsc-gitea 的 link-check.sh,結束碼 0 才寫。驗證一律走 API, 不看網頁狀態碼:私有存取庫的網頁網址對未登入請求一律回 404,拿狀態碼判會把 好連結判成壞的。認證失敗回 7,與死連結的 1 分開,免得金鑰一過期就把還在的頁 整批判死。
This commit is contained in:
@@ -19,6 +19,17 @@
|
||||
`--page` 的 `TYPE` 是頁名前綴(`PLAN`、`ANALYZE`、`DELIVER`、`REPO`、`MAINTAIN`、`LOG`)。腳本用它解析
|
||||
該類型的 wiki 存取庫,再換成絕對網址,所以跨存取庫的頁面也連得到。目錄頁(`*_CONTENTS`)也算寫入,要列。
|
||||
|
||||
## 連結驗證
|
||||
|
||||
連結一律寫成 `[{文字}]({連結})`,網址取自 `jsc-gitea/tools/gitea.sh wiki-url`,不自行組路徑,
|
||||
也不用 `[[頁名]]` 或 `[[顯示文字|頁名]]`。寫進任何頁面之前,每個連結先交給
|
||||
`jsc-gitea/tools/link-check.sh`,結束碼 0 才寫入;有 DEAD 就不寫,把連不到的清單回報給使用者。
|
||||
|
||||
`stage-report.sh` 印出來的那張連結清單也會再驗一次,逐列標「通過、無可查端點、連不到、未驗證」。
|
||||
這一道是複查,不是上面那道關卡的替代品:頁面在收尾之前就寫完了,所以這裡只註記、不阻擋。
|
||||
金鑰失效(`link-check.sh` 結束碼 7)標成「未驗證」,不標成「連不到」——把金鑰問題寫成死連結,
|
||||
下一手就會照著去刪還活著的頁。
|
||||
|
||||
## 實作階段多回報四項
|
||||
|
||||
| 項目 | 選項 | 腳本自己查的部分 |
|
||||
@@ -47,6 +58,6 @@
|
||||
| 碼 | 意思 | 呼叫端要做的事 |
|
||||
| --- | --- | --- |
|
||||
| 0 | 回報完整 | 把輸出原樣貼給使用者 |
|
||||
| 1 | 有警告(缺工作日誌、或實作階段沒有 PR) | 一樣把輸出貼給使用者。**這是警告不是阻擋**,階段的工作已經做完了 |
|
||||
| 1 | 有警告(缺工作日誌、實作階段沒有 PR、或清單裡有連不到的連結) | 一樣把輸出貼給使用者,連不到的連結照著修。**這是警告不是阻擋**,階段的工作已經做完了 |
|
||||
| 2 | 用法錯誤 | 修正參數重跑 |
|
||||
| 3 | 找不到 `gitea.sh` 或 `sdlc-gate.sh` | 修好相依關係再重跑 |
|
||||
|
||||
Reference in New Issue
Block a user