docs(tools): 補上腳本結束碼說明,並改指階梯規則正本
腳本標頭沒把每個結束碼代表什麼、該怎麼處理寫清楚,呼叫端只能用猜的。階梯表又同時抄在說明檔與技能內文,改規則時兩邊容易不同步。 - 推導基底的腳本標頭逐碼說明狀況與處置,並標明該碼屬於哪一種模式。 - 產生分支名的腳本標頭補上參數不足的結束碼。 - 說明檔刪掉重複的階梯表,改指向指引的階梯章節。 - 說明檔補上型別優先序腳本的說明,並更新兩支技能的摘要。
This commit is contained in:
+6
-1
@@ -4,7 +4,12 @@
|
||||
# 規則: 全部轉小寫,非 a-z0-9 的字元換成連字號,
|
||||
# 連續連字號合併成一個,並去除開頭與結尾的連字號。
|
||||
# 輸出: {type}/{slug}(例如: slugify.sh feat "export report" → feat/export-report)
|
||||
# 護欄: 輸入含非 ASCII 字元回傳 2;slug 化後為空回傳 3。兩者都印繁中錯誤到 stderr。
|
||||
# 結束碼: 0=stdout 印出 {type}/{slug},直接拿去當分支名。
|
||||
# 1=參數少於兩個。補上 type 與 phrase 再重跑。
|
||||
# 2=type 或 phrase 含非 ASCII 字元。先把描述翻成英文短語再重跑,
|
||||
# 不要自己動手拼分支名。
|
||||
# 3=phrase slug 化之後是空字串(裡面一個 a-z0-9 都沒有)。換一句英文短語再重跑。
|
||||
# 錯誤訊息都印到 stderr,其中 2 與 3 印繁體中文。
|
||||
set -u
|
||||
|
||||
if [ "$#" -lt 2 ]; then
|
||||
|
||||
Reference in New Issue
Block a user