Skip to content

Latest commit

 

History

History
408 lines (294 loc) · 19.9 KB

README_zh-TW.md

File metadata and controls

408 lines (294 loc) · 19.9 KB

GitHub 中文化插件

本項目源自: 52cik/github-hans

简体中文版简介点击这里

GitHub issues GitHub stars GitHub forks license GPL-3.0 GreasyFork installs

Featured｜HelloGitHub

💖 星標歷史

Star History Chart

🚩 功能

  • 中文化 GitHub 菜單欄，標題，按鈕等公共組件
  • 保留、完善正則功能
  • 支持對 「項目描述」 進行人機翻譯 (參考: k1995/github-i18n-plugin)

🌐 瀏覽器與腳本管理器

瀏覽器 腳本管理器
Chrome 或 基於 Chromium 內核的瀏覽器 Tampermonkey 或 Violentmonkey
Safari 瀏覽器（macOS, iOS, iPadOS） Macaque 或 Stay
Firefox 或 基於 Gecko 內核的瀏覽器 Tampermonkey 或 Violentmonkey
Via 瀏覽器（Android） 瀏覽器內自帶

💽 安裝

  1. 安裝用戶腳本管理器。
  2. 然後再點擊 這裏，安裝腳本即可。
  3. 刷新下頁面，即可發現網站已中文化。

Note

  1. 開發版：通常比發布版更早進入開發和測試階段（重大版本更新前，還會專門創建新分支進行測試）。日常維護詞庫內容，並且詞庫版本號會在每周五淩晨自動更新。

    註意:

    • 如果版本號未更新，即使內容已更新，用戶腳本管理器仍會忽略這些更新，需要手動安裝以獲取最新內容。
  2. 發布版: 日常功能被凍結（除非由項目所有者進行更新）。通常在開發版詞庫版本號更新後的下周一淩晨，自動同步上一開發版的詞庫文件。通常情況下，發布版與開發版之間會存在一周的時間差。

Tip

  1. 需要視頻教程的可以去看看【這裏】收錄的一些視頻

Important

關於 「Chrome 127 及更高版本無法使用」 的問題

這是由於 Chrome 127 及更高版本逐步切換到 Manifest V3。目前已知腳本管理器 Tampermonkey 5.2.0 及以上版本能夠完美支持，而其他腳本管理器（如 Violentmonkey 等）可能無法正常運行此腳本。如果您使用的是其他腳本管理器，建議您改用支持 Manifest V3 的腳本管理器，或者將瀏覽器版本退回，等待相關腳本管理器開發者更新，或改用 Firefox 瀏覽器。詳情請參閱 #234 討論。

解決方案：

  1. 安裝 Tampermonkey 5.2.0 或更高版本。
  2. 在瀏覽器的 「擴展程序」 管理中開啟 「開發者模式」。

詞庫本地調試方法

  1. 安裝用戶腳本管理器 Tampermonkey。
  2. 在瀏覽器擴展管理中，開啟 Tampermonkey 的 「允許訪問文件網址」。
  3. 將修改的詞庫文件放到方便訪問的本地位置。
  4. 安裝 [GitHub 中文化插件 - GitHub 托管【開發版】][main.user.js] 或 GitHub 中文化插件 - GreasyFork 托管【發布版】。
  5. 回到腳本管理器，修改詞庫文件路徑，如將 // @require https://raw.githubusercontent.com/maboloshi/github-chinese/gh-pages/locals_zh-TW.js?v1.9.0 改為本地路徑格式如 file:///D:/APP/github%E9%A1%B9%E7%9B%AE/github-chinese/locals_zh-TW.js。

Tip

直接將詞庫文件拖到瀏覽器的地址欄，再復製地址欄的中地址即可。

📝 更新說明

2024-08-18 16:44:24

更新至 1.9.3

  1. 新增功能：通過設置中文環境，自動本地化時間元素，僅保留on開頭的時間正則，並停用時間元素監視
  2. 優化突變翻譯處理：
    • 引入characterDataPage規則，對特定頁面啟用篩選字符數據的變更
    • 引入ignoreMutationSelectorPage規則，忽略特定突變元素
  3. 合並reIgnoreClass，reIgnoreItemprop，ignoreId，ignoreTag為ignoreSelectorPage規則，處理全局及特定頁面，忽略特定元素
  4. 引入全局緩存模式，減少重復構建包括不限於基於page變化的忽略規則、正則規則數組等
  5. 調整：更新訊飛聽見翻譯引擎v2.0
  6. 優化：梳理、優化腳本
  7. 調整：調整詞庫語言代碼為zh-CN, 與環境語言設置一致

2024-06-14 19:27:20

更新至 1.9.2

  1. 適配www.githubstatus.com
  2. 適配skills.github.com

2024-05-23 16:42:55

更新至 1.9.1

  1. 更新切換正則功能按鈕

2023-12-09 20:46:16

更新至 1.9.0

其中, 1.9.0: 主版本號(由項目所有者更新)

  1. 重新定義版本號規則, 如1.9.0-2023-12-09
  2. 加強: [GitHub 托管【開發版】][main.user.js]每周一淩晨自動更新詞庫發布版本號
  3. 加強: GreasyFork 托管【發布版】每周五淩晨自動更新詞庫發布版本號, 詞庫內容同上一次[GitHub 托管【開發版】][main.user.js]
  4. 加強：在 README.md 中自動更新貢獻者頭像
  5. 更新: 忽略規則, 詞條等

2023-08-31 13:39:36

更新至 1.8.5

  1. 優化: transDesc 函數代碼
  2. 修復: 重復添加translate-me翻譯按鈕
  3. 加強：watchUpdate 函數新增節點文本更新的情況
  4. 調整: transBySelector和transDesc函數延遲執行時間
  5. 更新: 忽略規則, 詞條等

2023-08-08 11:53:03

更新至 1.8.4

  1. 修復: Itemprop過濾規則, 依然使用正則方式
  2. 修復: tooltipped樣式提示, 依然使用正則方式

2023-08-07 14:41:17

更新至 1.8.3

  1. 梳理、優化腳本
  2. 更新: 忽略規則, 大量詞條等

2023-05-15 18:02:04

更新至 1.8.2

  1. greasyfork 托管源切換到按頁面精細化詞條模式
  2. 調整詞庫格式
  3. 功能加強: 優化元素篩選器翻譯邏輯
  4. 更新: 忽略規則, 大量詞條等

2023-01-22 22:01:39

更新至 1.8.1

  1. 修復: #8 與 dark reader 擴展發生沖突，導致時間顯示出現問題
  2. GitHub源開始切換到按頁面精細化詞條模式(開發版), 詞庫未完全遷移適配
  3. 停止greasyfork源詞庫文件的同步更新

2023-01-18 12:56:24

更新至 1.8.0

  1. 刪除: TURBO-FRAME框架處理代碼. Github 已調整新動態加載模式, 直接檢測url的變化就能獲取對應的page信息
  2. 新增: 支持時間元素的Shadow DOM翻譯, 並監聽變化
  3. 新增: 啟用並更新時間元素翻譯專項正則詞條
  4. 新增: 僅當page有效才翻譯頁面
  5. 修復: 原簡介翻譯引擎GitHub中文社區失效, 改為訊飛引擎(測試)
  6. 修復: 追加公共正則重復叠代的問題
  7. 修復: 正則標記變量RegExp與構造函數new RegExp沖突
  8. 更新: 忽略規則, 詞條等

預告, 下次將細化page匹配規則, 導致詞庫文件結構大調整, 詞庫文件會適當變大, 頁面正則更精細效率會提升

🎁 更多

2022-07-17 14:04:44

更新至 1.7.9

GitHub 的 ajax 載入方式逐步從 defunkt/jquery-pjax 切換到 hotwired/turbo, 導致已有的動態監測方式逐步失效

目前, 通過以下修復:

  1. 新增 BODY 元素新增監視
  2. 解析 TURBO-FRAME 框架, 獲取對應的 page
  3. 修復 github 新動態加載模式, 導致翻譯描述返回值無法插入
  4. 修復 github 新動態加載模式, 導致chrome瀏覽器自帶翻譯功能卡死頁面

其他更新:

  1. 修復rePagePath,rePagePathRepo,rePagePathOrg匹配規則，限製路徑匹配層次，排除幹擾
  2. 直接使用網頁URLdocument.URL變化觸發標題翻譯和JS 篩選器翻譯
  3. 修復關閉正則無法生效, 需要刷新頁面才生效
  4. 日常更新詞庫和忽略規則
  5. 更新JS 篩選器規則

2022-06-29 13:27:12

更新至 1.7.8

  1. 緊急修復: GitHub 變更了document.body和title更新機製, 導致原有的監測更新規則部分失效, 目前使用document.documentElement監視整個頁面 DOM 的變更
  2. 跳過<HEAD>標簽
  3. 標題翻譯和JS 篩選器翻譯, 依據 URL變化更新

2022-06-26 16:41:58

更新至 1.7.7

  1. 新增時間元素翻譯功能
  2. 重寫頁面標題翻譯函數
  3. 梳理遍歷節點函數邏輯
  4. 優化transPage函數，默認翻譯公共部分
  5. 調整getPage函數, 使ClassName匹配規則優先
  6. 優化translate函數, 跳過不存在英文字母和符號,., 保留首尾空白部分等
  7. 部分函數重命名，使用es6新語法
  8. 日常更新詞庫和忽略規則，修復一個JS 選擇器規則

2022-05-12 13:53:46

更新至 1.7.6

  1. 日常更新詞庫和忽略規則
  2. 添加手動開啟/禁用正則翻譯，添加切換菜單
  3. 優化翻譯文本函數：避免已翻譯詞匯二次匹配，提高效率；局部翻譯優先於全局

2022-02-26 12:36:14

更新至 1.7.5

2022-01-21 13:34:06

更新至 1.7.4

2021-12-26 12:01:11

更新至 1.7.3

2021-12-01 09:04:58

更新至 1.7.2

2021-11-23 10:51:22

更新許可證為 GPL-3.0 希望大家依據許可證使用

2021-10-31 21:49:00

正式發布 1.7.0 版本

2021-10-07 13:16:16

原作者樓教主已停止維護多年，且近年來 GitHub 頁面結構的變化，導致原有的腳本無法正常工作。

雖然 GitHub 在被微軟售收購比較重視國際化，啟動並基本完成了GitHub 文檔的中文化。但是，關於 GitHub 頁面的中文化暫時還沒啟動。

對於，新手使用和高階使用仍會存在一定的障礙。故，本人依據個人興趣暫時進行了一定的修復和維護。

本次維護基本恢復和保留大部分功能如：頁面正則翻譯（含日期的正則）。頁面詞條可能被我切得太碎不方便後期維護（先這樣吧！）

✔ 待辦 (TODO)

  1. 添加 GitHub 名詞解釋，新手可能不太理解部分名詞具體表達的意思，比如 pull request。
  2. 整理部分 Git & GitHub 學習資料, 幫助新手更快上手。
  3. 本人英文渣渣，翻譯非常困難，急需大家 PR 共同翻譯

✨ 貢獻

查看我們的貢獻小技巧

目前已翻譯大部分常用頁面，歡迎補充完善，中文詞條在locals.js中。大家在補充完善的過程，請遵循以下文檔對相關術語進行翻譯：

相關概念及資料文檔:

  1. Pro Git 第二版 簡體中文
  2. Pro Git: 翻譯約定
  3. Git 官方軟件包的簡體中文翻譯
  4. GitHub 詞匯表官方譯本

🎨 預覽

🎁 打賞

微信贊賞 支付寶贊賞

💝 鳴謝

maboloshi - 項目作者

wuyuncheng-26 - 項目協作者

52cik - 項目原作者

感謝所有貢獻者

一如既往，感謝我們出色的貢獻者❤️！

沙漠之子 樓教主 陳生雜物房 其智乃反不能及 大葉子 cat-kun Pecasha 人民的勤務員 菾凴 wyc-26 益生君 小莫 前端小武 wang4yu6peng13 pangshitong dayday create new ██████╗ ██╔══██╗ ██████╔╝ ██╔══██╗ ██████╔╝ ╚═════╝ 　　██╗ 　 ██╗ 　　██║ 　 ██║ 　　██║ 　 ██║ 　　██║ 　 ██║ 　　╚█████╔╝ 　　╚═════╝ ███████╗ ██╔════╝　 ██║████═╗　 ██║　 ██　║ ╚██████╔╝　 　╚══════╝ KS-OTO InfinityLoop Imgbot CN-traveler

貢獻者列表，由 GitHub Action 自動生成