anoni-net / anoni-net/docs

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

Open
#482 0 comments 0 reactions 0 assignees View on GitHub
documentation
Dominant language
JavaScript
Stars
47
Forks
7
Avg merge
2h 51m
Merged PRs (30d)
288

Description

## 這張票在追什麼

`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)

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.