anoni-net / anoni-net/docs

content(style): 全站動補結構的口語寫法待逐批處理,扣掉 #480 之後還有 2419 處

Đang mở
#482 0 bình luận 0 reaction 0 người được giao Xem trên GitHub
documentation
Ngôn ngữ chính
JavaScript
Star
47
Fork
7
Merge trung bình
2 giờ 51 phút
Pull request đã merge (30 ngày)
288

Mô tả

## 這張票在追什麼

`docs_style_lint.py` 的口語清單只有「講」「拿到」「得先」「動手」「怎樣」「踩到」「找上門」那幾個,「動詞+得/不+補語」這一整類抓不到。#480 處理了其中八組,剩下的量遠大於那一批,需要分批做,所以先記下來。

## 目前的量

對 `origin/main`(`731fa9cd`)掃 `docs/zh-TW` 與 `docs/zh-CN` 的 445 個 `.md`:

| | 數字 |
|---|---|
| 總出現次數 | 2497 處 |
| 不重複詞形 | 517 種 |
| 涵蓋檔案 | 313 個 |
| #480 已處理 | 78 處 / 8 種 |
| **剩下** | **2419 處 / 511 種** |

掃描的正則是 `[一-鿿](得|不)[到上下住出動起回完過清了开动过]`,扣掉「值得」「取得」「懂得」「覺得」這類本來就是書面語的複合動詞。

分布很不平均,前 20 種佔 43%(1077 處),另一端有 369 種只出現一到兩次、合計 514 處。

## 出現最多的二十種

```
看得到 245 / 93 檔 看不到 171 / 102 檔 做得到 64 / 30 檔
連不上 51 / 30 檔 找不到 50 / 43 檔 连不上 48 / 29 檔
做不到 48 / 38 檔 用得上 38 / 34 檔 拿得到 36 / 30 檔
讀得到 34 / 18 檔 連得上 34 / 22 檔 读得到 33 / 18 檔
连得上 32 / 21 檔 查不到 31 / 21 檔 用不到 30 / 22 檔
看不出 28 / 22 檔 读不到 27 / 14 檔 讀不到 27 / 14 檔
查得到 26 / 22 檔 看得出 24 / 24 檔
```

## 不能一律代換

#480 做的時候抽樣過,其中相當大一部分是正確用法,直接全域取代會壞掉:

- **成對出現的技術二分**:「連得上/連不上」是 OONI 量測結果的說法,成對出現在內文與表格欄位標題(「回報每個網站在當地連不連得上」)
- **表格儲存格內容**:QR code 容量表的欄位值就是 `讀得到` / `讀不到` / `大致讀得到`
- **刻意的對照**:「你看不到它,平台看得到」這種句子,改掉就沒有對照了
- **標題**:改動標題會改變錨點,需要先確認沒有連結指向舊錨點

`看得到` 那 245 處大多是「誰看得到你的資料」,屬於這一類,`找不到`、`看不出` 在書面語裡本來就通。真正偏口語、值得改的是「拿得到」「對得上」「分得出」「救不回」這一群。

## 建議的做法

一次全改不可行,建議分批,每一批的流程照 #480 驗證過的:

1. 挑一組詞形,先用正則列出全部語境
2. 套通則代換
3. 逐條看 diff,讀起來不對的另外改寫(#480 那次 78 處裡有 17 處要特別處理)
4. `docs_style_lint.py`、三語系 strict 建置、`check_image_refs.py`、`check_start_parity.py`
5. 有標題被改到就查全站有沒有連結指向舊錨點

分批的切法建議按「同一組語意」而不是按檔案,例如「拿得到/拿不到」一批、「對得上/對不上/分得出」一批,這樣同一個概念在站上的寫法會一起變,不會出現改一半的狀態。

## 順便可以做的事

`tools/docs_style_lint.py` 目前抓不到這一類。可以加一條 warn 等級的規則掃 `動詞+得/不+補語`,配一份白名單放「連得上/連不上」「看得到/看不到」這些判定為正當用法的詞形,之後新寫的內容就不會再累積。規則名稱可以叫 `verb-complement`,跟現有的 `colloquial-*` 同一組。

CI 只在 error 才紅,warn 會過,所以加上去不會擋住既有的 PR。

## 相關

- #480 處理了八組(打不開、打得開、算不出、碰得到、用不了、用得到、進得來、進不來),並記錄了通則套不上的十七處是怎麼改的
- #479 收掉 `docs/*/offline.md` 與 `docs/zh-TW/js/offline-library.js` 那幾個檔的同一批用詞,因為那個 PR 已經在改同一行

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Đánh giá

Issue này chưa được đánh giá.

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.