From 76492f8d6211edbe8c28ed2a29d24d6736518989 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 3 Sep 2026 04:54:09 +0000 Subject: [PATCH] Update "LOG_CONTENTS" --- LOG_CONTENTS.md | 35 +++++++++++++++++++++++++++++------ 1 file changed, 29 insertions(+), 6 deletions(-) diff --git a/LOG_CONTENTS.md b/LOG_CONTENTS.md index 07f890a..de23200 100644 --- a/LOG_CONTENTS.md +++ b/LOG_CONTENTS.md @@ -1,9 +1,32 @@ # 日誌目錄 -> 由 `jsc-log:worklog` 維護。每個日誌頁一列；頁名使用共享 `HASH` 規則，頁內仍依該週五日期整理。 +> 由 `jsc-log:worklog` 維護。每個日誌頁一個區塊；`{HASH}` 是 `{owner}/{repo}` 的完整 40 碼大寫十六進位 SHA-1，頁內仍依該週五日期整理。 +> 本頁落在 `JSC_WIKI_REPO_CONTENTS` 解出的專用存取庫，日誌頁 `LOG_{HASH}` 落在 `JSC_WIKI_REPO_LOG` 的存取庫，兩者分屬不同 wiki。 +> 連結寫法：日誌頁那一條寫成 `[{頁名}]({絕對網址})`，網址取自 `jsc-gitea/tools/gitea.sh wiki-url`，不用 `[[...]]`。兩頁分屬不同存取庫，`[[...]]` 連不過去，畫面上還看不出壞掉。 +> 連結驗證：每個要寫進本頁的連結先交給 `jsc-gitea/tools/link-check.sh`，退出碼 0 才寫入。出現 DEAD 就不寫，把連不到的那幾筆回報給呼叫端。 +> 寫入語意：一個區塊代表一個日誌頁。一律用 `jsc-gitea/tools/wiki-contents.sh upsert LOG 1 LOG_{HASH} {區塊檔} {本範本}` 單一區塊整頁寫回——它讀整頁、找得到該頁既有的那個區塊就換掉，找不到才附加到頁尾。 +> 參數語意：`` 的 `1` 只在舊頁還是表格時用得到，代表轉檔時取第 1 欄格子的文字當 H2 標題；頁面已經是條列格式就完全忽略它。`` 是 H2 標題文字，也就是內容頁頁名 `LOG_{HASH}`。第四個參數是區塊檔，內容是 `## {key}` 那一行加空行加各條欄位，不是一列表格。 +> 鍵是 H2 標題的頁名，不是連結。頁名只由 `{owner}/{repo}` 決定：`GITEA_HOST` 一換、`JSC_WIKI_REPO_LOG` 改指別的存取庫，或 Gitea 對頁名的編碼有差，都動不到它。連結帶著主機名與存取庫名，這三件事任一變動就跟上一輪寫的不一樣；拿連結當鍵就比不到既有那一筆，走附加，同一個日誌頁多出第二個區塊，舊區塊從此不再更新。 +> 禁止整頁覆蓋，也不得改動別人的區塊。 -| 日誌頁 | 週五日期 | 條目數 | 最後更新 | -| --- | --- | --- | --- | -| [LOG_87095D0516385877D3F9602AD8405565DB7D104B](https://gitea.jsc.idv.tw/knowledges/LOG/wiki/LOG_87095D0516385877D3F9602AD8405565DB7D104B) | 2026-08-28 | 2 | 2026-08-26 08:15 | -| [LOG_FB8DF0B5646689B45747957081FDFA56503E19A2](https://gitea.jsc.idv.tw/knowledges/LOG/wiki/LOG_FB8DF0B5646689B45747957081FDFA56503E19A2) | 2026-08-28 | 5 | 2026-08-27 19:15 | -| [LOG_E0494A8CA74F9D21AF51BC724B66D313C784A31E](https://gitea.jsc.idv.tw/knowledges/LOG/wiki/LOG_E0494A8CA74F9D21AF51BC724B66D313C784A31E) | 2026-09-04 | 1 | 2026-09-04 | +## LOG_87095D0516385877D3F9602AD8405565DB7D104B + +- 日誌頁：[LOG_87095D0516385877D3F9602AD8405565DB7D104B](https://gitea.jsc.idv.tw/knowledges/LOG/wiki/LOG_87095D0516385877D3F9602AD8405565DB7D104B) +- 週五日期：2026-08-28 +- 條目數：2 +- 最後更新：2026-08-26 08:15 + +## LOG_FB8DF0B5646689B45747957081FDFA56503E19A2 + +- 日誌頁：[LOG_FB8DF0B5646689B45747957081FDFA56503E19A2](https://gitea.jsc.idv.tw/knowledges/LOG/wiki/LOG_FB8DF0B5646689B45747957081FDFA56503E19A2) +- 週五日期：2026-08-28 +- 條目數：5 +- 最後更新：2026-08-27 19:15 + +## LOG_E0494A8CA74F9D21AF51BC724B66D313C784A31E + +- 日誌頁：[LOG_E0494A8CA74F9D21AF51BC724B66D313C784A31E](https://gitea.jsc.idv.tw/knowledges/LOG/wiki/LOG_E0494A8CA74F9D21AF51BC724B66D313C784A31E) +- HASH：E0494A8CA74F9D21AF51BC724B66D313C784A31E +- 週五日期：2026-09-04 +- 條目數：1 +- 最後更新：2026-09-03 11:57