feat(link): 連結一律寫成 [文字](絕對網址)，寫入前先驗證連得到
取消 [[頁名]] 與 [[顯示文字|頁名]] 兩種同 wiki 寫法，不再分「同存取庫」與 「跨存取庫」兩條規則。那種寫法只在自己那個 wiki 內解析，寫錯不報錯，畫面上 看起來像普通文字或死連結，巡不到也修不了。 連結寫進頁面前先過 jsc-gitea 的 link-check.sh，結束碼 0 才寫。驗證一律走 API， 不看網頁狀態碼：私有存取庫的網頁網址對未登入請求一律回 404，拿狀態碼判會把 好連結判成壞的。認證失敗回 7，與死連結的 1 分開，免得金鑰一過期就把還在的頁 整批判死。
This commit is contained in:
@@ -2,7 +2,8 @@
|
||||
|
||||
> 由 `jsc-log:learn` 維護。這是教訓目錄頁 `LEARN_CONTENTS`。每個存取庫一列；`LEARN_{HASH}` 的 `{HASH}` 依共用 wiki hash 規則產生：取 `{owner}/{repo}` 的完整 SHA-1 四十碼，a-f 轉大寫，不截短、不加前綴。
|
||||
> 本頁落在 `JSC_WIKI_REPO_CONTENTS` 解出的專用存取庫，教訓頁 `LEARN_{HASH}` 落在 `JSC_WIKI_REPO_LEARN` 的存取庫，兩者分屬不同 wiki。
|
||||
> 所以指向教訓頁的連結一律用 `gitea.sh wiki-url` 取得的絕對網址。`[[LEARN_{HASH}]]` 只在同一個 wiki 內解得開，寫在這裡就是死連結。
|
||||
> 連結寫法：教訓紀錄那一欄寫成 `[{頁名}]({絕對網址})`，網址取自 `jsc-gitea/tools/gitea.sh wiki-url`，不用 `[[...]]`。兩頁分屬不同存取庫，`[[...]]` 連不過去，畫面上還看不出壞掉。
|
||||
> 連結驗證：每個要寫進本頁的連結先交給 `jsc-gitea/tools/link-check.sh`，退出碼 0 才寫入。出現 DEAD 就不寫，把連不到的那幾筆回報給呼叫端。
|
||||
> 寫入語意：一列代表一個存取庫。一律用 `jsc-gitea/tools/wiki-contents.sh upsert LEARN 1 {owner}/{repo} {列檔} {本範本}` 單列整頁寫回——它讀整頁、找得到該存取庫既有的那一列就換掉那一列，找不到才附加。
|
||||
> 鍵取第 1 欄的存取庫名稱，不取第 2 欄的連結。存取庫名稱每一輪都一樣，連結會隨主機名與頁名編碼變動。
|
||||
> 禁止整頁覆蓋，也不得改動別人的列。
|
||||
|
||||
@@ -2,7 +2,8 @@
|
||||
|
||||
> 由 `jsc-log:worklog` 維護。每個日誌頁一列；`{HASH}` 是 `{owner}/{repo}` 的完整 40 碼大寫十六進位 SHA-1，頁內仍依該週五日期整理。
|
||||
> 本頁落在 `JSC_WIKI_REPO_CONTENTS` 解出的專用存取庫，日誌頁 `LOG_{HASH}` 落在 `JSC_WIKI_REPO_LOG` 的存取庫，兩者分屬不同 wiki。
|
||||
> 所以指向日誌頁的連結一律用 `gitea.sh wiki-url` 取得的絕對網址。`[[LOG_{HASH}]]` 只在同一個 wiki 內解得開，寫在這裡就是死連結。
|
||||
> 連結寫法：日誌頁那一欄寫成 `[{頁名}]({絕對網址})`，網址取自 `jsc-gitea/tools/gitea.sh wiki-url`，不用 `[[...]]`。兩頁分屬不同存取庫，`[[...]]` 連不過去，畫面上還看不出壞掉。
|
||||
> 連結驗證：每個要寫進本頁的連結先交給 `jsc-gitea/tools/link-check.sh`，退出碼 0 才寫入。出現 DEAD 就不寫，把連不到的那幾筆回報給呼叫端。
|
||||
> 寫入語意：一列代表一個日誌頁。一律用 `jsc-gitea/tools/wiki-contents.sh upsert LOG 2 {HASH} {列檔} {本範本}` 單列整頁寫回——它讀整頁、找得到該頁既有的那一列就換掉那一列，找不到才附加。
|
||||
> 鍵取第 2 欄的裸 HASH，不取第 1 欄的連結。第 1 欄的連結帶著主機名與存取庫名：`GITEA_HOST` 一換、`JSC_WIKI_REPO_LOG` 改指別的存取庫，或 Gitea 對頁名的編碼有差，連結就跟上一輪寫的不一樣，鍵比不到就走附加，同一個日誌頁多出第二列，舊列從此不再更新。裸 HASH 只跟 `{owner}/{repo}` 有關，這三件事都動不到它。
|
||||
> 禁止整頁覆蓋，也不得改動別人的列。
|
||||
|
||||
@@ -4,7 +4,8 @@
|
||||
> 任務有三種：一個工作包、一輪 PR 留言修正、一個獨立的修正提交。同一個工作包跑五輪留言修正就是五筆，
|
||||
> 標題各自寫清楚是哪一輪，時間與 token 分開記。
|
||||
> `HASH` 依共享規則計算；頁名不再寫入年月週數，但頁內仍依本工作週的週五整理內容。
|
||||
> {PLAN 頁絕對網址}、{ANALYZE 頁絕對網址} 由 `jsc-gitea/tools/gitea.sh wiki-url` 取得——LOG 與 PLAN／ANALYZE 可能分屬不同存取庫，`[[頁名]]` 跨庫不通。
|
||||
> 連結寫法：計畫名稱、工作包編號、PR 目標分支三欄一律寫成 `[{文字}]({絕對網址})`，wiki 頁的網址由 `jsc-gitea/tools/gitea.sh wiki-url` 取得，不用 `[[...]]`。LOG 與 PLAN／ANALYZE 可能分屬不同存取庫，`[[...]]` 跨庫連不過去，畫面上還看不出壞掉。
|
||||
> 連結驗證：條目裡的每個連結先交給 `jsc-gitea/tools/link-check.sh`，退出碼 0 才寫入。出現 DEAD 就不寫，把連不到的那幾筆回報給呼叫端。
|
||||
> 解不出 wiki 存取庫或頁面不存在時，該欄填「無」，其他欄照填。由 `maintain` 觸發的日誌本來就沒有計畫頁與分析頁。
|
||||
|
||||
---
|
||||
|
||||
@@ -2,7 +2,8 @@
|
||||
|
||||
> 由 `jsc-log:report` 維護。年、月、週、日各一頁；`HASH` 取 `{owner}/{repo}/{期間}` 的完整 40 碼大寫十六進位 SHA-1，算法與其他頁面共用，但這裡的 `{owner}/{repo}` 取 REPORT wiki 存取庫，不是程式碼存取庫。
|
||||
> 本頁落在 `JSC_WIKI_REPO_CONTENTS` 解出的專用存取庫，報表頁 `REPORT_{HASH}` 落在 `JSC_WIKI_REPO_REPORT` 的存取庫，兩者分屬不同 wiki。
|
||||
> 所以指向報表頁的連結一律用 `gitea.sh wiki-url` 取得的絕對網址。`[[REPORT_{HASH}]]` 只在同一個 wiki 內解得開，寫在這裡就是死連結。
|
||||
> 連結寫法：報表頁那一欄寫成 `[{頁名}]({絕對網址})`，網址取自 `jsc-gitea/tools/gitea.sh wiki-url`，不用 `[[...]]`。兩頁分屬不同存取庫，`[[...]]` 連不過去，畫面上還看不出壞掉。
|
||||
> 連結驗證：每個要寫進本頁的連結先交給 `jsc-gitea/tools/link-check.sh`，退出碼 0 才寫入。出現 DEAD 就不寫，把連不到的那幾筆回報給呼叫端。
|
||||
> 寫入語意：一列代表一個報表頁，也就是一個存取庫的一種期間。一律用 `jsc-gitea/tools/wiki-contents.sh upsert REPORT 2 {HASH} {列檔} {本範本}` 單列整頁寫回——它讀整頁、找得到該報表頁既有的那一列就換掉那一列，找不到才附加。
|
||||
> 鍵取第 2 欄的裸 HASH，不取第 1 欄的連結。第 1 欄的連結帶著主機名與頁名編碼，`GITEA_HOST` 一換或 Gitea 對頁名的編碼有差，連結就跟上一輪寫的不一樣，鍵比不到就走附加，同一個報表頁多出第二列，舊列從此不再更新。裸 HASH 不受這兩件事影響。
|
||||
> 但 `JSC_WIKI_REPO_REPORT` 改指別的存取庫是另一回事：HASH 本身就取自 REPORT wiki 存取庫，換庫等於換頁，四個期間會各多一列。那是換庫的本意，不是鍵失準，舊列請人工清掉。
|
||||
|
||||
Reference in New Issue
Block a user