feat(wiki): 巡檢目錄頁改成一台機器一個大標題區塊
巡檢目錄頁的版面從 markdown 表格換成「大標題加條列」:一台機器一個大標題 區塊,標題就是那一台機器監控頁的實際頁名,欄位改成標題底下的一層條列。 範本、技能敘述、行為清單與說明文件一併跟上,目錄頁上不再留任何表格。 表格的欄位組合是整頁共用的,表頭跟著建頁那一台機器走,之後每一台只改自己 那一列。欄位一增減,只有跑到新版的機器寫得出新的格數,同一張表就混著兩種 格數,多出來的那一格對不到任何欄名,而目錄頁又沒有整頁改寫的路可以走—— 整頁覆蓋等於刪掉別台機器的紀錄。條列一筆一個區塊,欄位各自獨立,加一條只 動到自己那一個區塊。 比對鍵從裸雜湊那一格改成大標題本身,標題寫成監控頁的實際頁名。頁名只由 主機名與登入帳號決定,換主機位址、換專用存取庫或換一種頁名編碼都動不到 它;含網址的那一條連結照樣留著給人點,但不當鍵。呼叫改成拿頁名當鍵,欄號 那個參數只在舊表格頁轉檔時用得到。範本原本用二階標題寫的說明區段全部搬進 引言,否則轉檔後會被當成一筆真紀錄讀進去。 範圍是助理的巡檢目錄頁與 assistant 技能的敘述。
This commit is contained in:
@@ -4,7 +4,7 @@
|
||||
> 這頁固定三塊:本頁基本資料、最新一輪、近 24 輪摘要。
|
||||
> 最新一輪每輪整塊換掉;摘要表一輪一列往上疊,只留 24 列;基本資料建頁時寫一次就不動。
|
||||
> 完整內容只留最新一輪,頁面才讀得完;軌跡留在摘要表,看得出是從哪一輪開始壞的。
|
||||
> 目錄頁 `MONITOR_CONTENTS` 在 `JSC_WIKI_REPO_CONTENTS` 解出的專用存取庫,和這頁不同庫;那一頁只更新自己那一列,別台機器的列一個字都不動。
|
||||
> 目錄頁 `MONITOR_CONTENTS` 在 `JSC_WIKI_REPO_CONTENTS` 解出的專用存取庫,和這頁不同庫;那一頁一台機器一個 H2 區塊,只更新自己那一個區塊,別台機器的區塊一個字都不動。
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
@@ -14,7 +14,7 @@ flowchart LR
|
||||
D --> E[本輪摘要列插到表格最上面,截到 24 列]
|
||||
E --> V[link-check.sh 驗這一頁要放的連結]
|
||||
V --> F[結束碼 0 才整頁寫回]
|
||||
F --> G[wiki-contents.sh upsert 更新目錄頁自己那一列]
|
||||
F --> G[wiki-contents.sh upsert 更新目錄頁自己那一個區塊]
|
||||
G --> H[最後才寫心跳]
|
||||
```
|
||||
|
||||
@@ -174,7 +174,7 @@ flowchart LR
|
||||
- 舊格式的頁(一輪一節疊起來的那種)第一次重組時,基本資料留著,那些節收掉,摘要表從本輪這一列開始,並在回報裡說明。
|
||||
- 連結一律寫成 `[{文字}]({絕對網址})`,網址取 `jsc-gitea/tools/gitea.sh wiki-url` 印出的那一個,不自己組路徑。wiki 自己那種雙中括號寫法只在同一個 wiki 裡解得開,寫錯不會報錯,畫面上看不出壞掉。
|
||||
- 這一頁要放進去的每一個連結,寫入前先交給 `jsc-gitea/tools/link-check.sh`,結束碼 0 才整頁寫回。有 DEAD 就不寫,把連不到的那幾筆回報給呼叫端;結束碼 3 是 `GITEA_HOST` 沒設定,補設定再驗,不准跳過;結束碼 7 是金鑰失效,停下來回報金鑰問題,不要當成死連結。驗證一律走 API,不看網頁狀態碼——私有存取庫的網頁網址對未登入請求一律回 404。
|
||||
- 整頁寫成之後,才回頭更新目錄頁自己那一列,寫入交給 `jsc-gitea/tools/wiki-contents.sh upsert`,別台機器的列一個字都不動。目錄頁那一欄的連結同樣先驗過才寫。
|
||||
- 整頁寫成之後,才回頭更新目錄頁自己那一個區塊,寫入交給 `jsc-gitea/tools/wiki-contents.sh upsert`,別台機器的區塊一個字都不動。目錄頁那一個區塊的連結同樣先驗過才寫。
|
||||
- 這一頁沒寫成就不寫心跳,讓它過期。心跳代表的是「這一輪的結果記在這一頁上了」。
|
||||
- 目錄頁只是索引。目錄頁的存取庫沒設定(結束碼 3)時照樣寫心跳,並把那一筆列進待人處理;其餘寫入失敗才不寫心跳。
|
||||
- 目錄頁只是索引。目錄頁的存取庫沒設定(結束碼 3)時照樣寫心跳,並把那一筆列進待人處理;其餘寫入失敗才不寫心跳。目錄頁少一個區塊只少一筆索引,這一輪的結果已經在這一頁上。
|
||||
- 執行狀態事件那一節的內容由 `tools/patrol.sh collect` 排空、彙整好,寫頁的人原樣採用,不自己再跑一次 `drain`。`drain` 是消耗性讀取:它一讀完就把位移往前推,同一批事件不會再出現第二次,第二次跑只會拿到 3,或者把下一輪的事件提前吃掉。
|
||||
|
||||
Reference in New Issue
Block a user