anoni-net / anoni-net/docs

文件站補示意圖:優先頁面清單

Đang mở
#372 0 bình luận 0 reaction 0 người được giao Xem trên GitHub
documentation help wanted
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ả

承 #371。示意圖的做法已經定下來(`docs/diagrams/` 存原始檔、發布到 assets.anoni.net、三語系引用同一個網址),規範寫在 [貢獻技術圖示](https://anoni.net/docs/community/brand-assets/)。這則 issue 收要補圖的頁面,一次認一張,做完在下面勾掉。

## 現況

zh-TW 共 210 篇,自製示意圖八張(含 #371 新增的那張),集中在 `advanced/` 與 `basics/` 各一區。按分類看:

| 分類 | 篇數 | 自製示意圖 |
|---|---|---|
| `basics/` | 10 | 1 |
| `tools/` | 20 | 0(三張外部素材) |
| `scenarios/` | 10 | 0 |
| `taiwan/` | 6 | 0 |
| `community/` | 25+ | 0 |
| `advanced/` | 5 | 7 |

視覺化的投資本來就不少,只是集中在兩端:`games/` 的三件 three.js 3D 作品,以及 49 頁的 grid cards 加 669 次 material icon。中間那層「一張圖講完一個概念」還是空的。

## 第一批:概念層(完成)

這幾頁是全站最需要圖、目前一張都沒有的。`basics/` 十篇裡現在有五篇帶圖。

- [x] `basics/threat-model.md` — 填完之後長什麼樣的象限圖(#374)。原本規劃的是三題流程圖,但那三題頁面已經用編號列表講清楚了,改畫操作流程第 4 步的產出
- [x] `basics/metadata.md` — 信封圖,外圈是不用解密就看得到的欄位,中間是上鎖的內容,右邊接三條光憑外圈就能得到的結論(#375)
- [x] `basics/browser-fingerprinting.md` — 熵的漏斗,六階從「所有人」縮到「就是你」(#375)。比堆疊圖更貼近頁面裡熵那一段
- [x] `basics/surveillance-capability.md` — 成本與涵蓋範圍的反比(#375)。那頁已經有一張完整的「措施 × 四層」表格,所以不重畫同構的圖,改畫「怎麼讀這頁」第一條
- [x] `basics/anonymity-vs-privacy.md` — 四概念對照矩陣(#371)

## 第二批:工具層的比較頁(完成)

分兩個 PR 交付。`tools/` 二十篇裡現在有五篇帶自製示意圖。

- [x] `tools/vpn-guide.md` — 信任轉移圖,橙色標的是同時知道你是誰與你連哪的那個節點,直接連是 ISP、用 VPN 換成業者、Tor 那一列沒有(#377)
- [x] `tools/messaging-comparison.md` — 八個工具在身分綁定與 metadata 兩軸上的落點(#377)。原本規劃五軸矩陣,但那頁已經有六欄速查表,重畫表格沒有意義,改成把其中兩軸拉成座標,看空間關係
- [x] `tools/tails-vs-whonix-vs-qubes.md` — 三種隔離結構,速查表裡「雙 VM:Gateway + Workstation」那一格直接畫出來(#377)
- [x] `tools/what-is-anonymity-network.md` — 四層之間的關係(#378)。原本規劃工具家族分工圖,但那節已經是四張 grid cards,改畫卡片呈現不了的層間關係:環境層包住連線層、觀測層獨立在旁只記錄不保護、日常基本功橫跨最底下
- [x] `tools/onionshare.md` — 四種模式的資料方向(#378)。那頁本來就有多張介面截圖,所以畫的是方向而不是介面

## 第三批:場景與社群(完成)

四頁裡做了三張,`ooni-checklist` 評估後不加圖。全部在 #379。

- [x] `scenarios/asia-travel.md` — 出差準備的分層加碼,四層是疊加不是替換。原本規劃地區分層加決策樹,做出來合併成一張,因為分層本身就帶著「每層要多做什麼」。只放 zh-TW 與 zh-CN,en 版是另一篇文章(焦點在 clean-device 與邊境檢查),沒有四層風險分類那一節,圖裡的層級在那邊找不到出處。en 版 SVG 已翻好留在 `docs/diagrams/` 備用
- [x] `community/skill-level.md` — 三個工具乘三個層級的矩陣。頁面用 tabbed,一次只看得到一格,圖補的是橫向比對
- [x] `community/ooni-blocking-determination.md` — 判定的四個階段。頁面已有對照表,圖多給的是「判定有順序」,這正是 `*_match` 欄位常常是 null 的原因
- [ ] ~~`taiwan/ooni-checklist.md`~~ — 不加圖。那頁已經有一張「OONI Probe 檢測流程」圖,全頁 77 行,再加一張是重複

## 既有圖的翻譯

七張 drawio 圖裡是正體中文,目前 zh-CN 與 en 共用 zh-TW 那一份。

- [ ] `dh-exchange`、`double-ratchet`(`advanced/e2ee.md`)
- [ ] `ipfs-vs-onion`、`anoni-deployment`(`advanced/dweb-ipfs-onion.md`)
- [ ] `monero-ring`、`zcash-shielded`(`advanced/zk-identity-payments.md`)
- [ ] `pq-timeline`(`advanced/post-quantum.md`)

## 認領前先看

- 規範在 `community/brand-assets.md` 的「貢獻技術圖示」一節,配色照色票、深色模式要在 SVG 內自己處理
- 一張圖一個 PR,三個語系一起
- 順序是先跑 `./tools/publish_diagrams.sh` 發布圖,確認網址回 200,才改 Markdown

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.