github-chinese

# [GitHub 中文化插件][project-url] > 本項(xiàng)目源自: [52cik/github-hans](https://github.com/52cik/github-hans) **簡(jiǎn)體中文** · [繁體中文](/github-chinese/README_zh-TW.html) [![GitHub issues][issues-image]][issues-url] [![GitHub stars][stars-image]][stars-url] [![GitHub forks][forks-image]][forks-url] [![license GPL-3.0][license-image]][license-url] [![GreasyFork installs][greasyFork-image]][greasyFork-url]

[!warning]

本項(xiàng)目從未發(fā)布至 GitCode，如您發(fā)現(xiàn)請(qǐng)截圖并保留證據(jù)

?? 星標(biāo)歷史

</a>

?? 功能

• 中文化 GitHub 菜單欄，標(biāo)題，按鈕等公共組件
• 保留、完善正則功能
• 支持對(duì) “項(xiàng)目描述” 進(jìn)行人機(jī)翻譯 (參考: k1995/github-i18n-plugin)

?? 瀏覽器與腳本管理器

瀏覽器	腳本管理器
Chrome 或 基于 Chromium 內(nèi)核的瀏覽器	[Tampermonkey][Tampermonkey] 或 [Violentmonkey][Violentmonkey]
Safari 瀏覽器（macOS, iOS, iPadOS）	[Macaque][Macaque] 或 [Stay][Stay]
Firefox 或 基于 Gecko 內(nèi)核的瀏覽器	[Tampermonkey][Tampermonkey] 或 [Violentmonkey][Violentmonkey]
Via 瀏覽器（Android）	瀏覽器內(nèi)自帶

?? 安裝

1. 安裝用戶(hù)腳本管理器。
2. 打開(kāi)瀏覽器的開(kāi)發(fā)者模式。
3. 然后再點(diǎn)擊鏈接之一，安裝腳本即可。
   • [GitHub 中文化插件 - GitHub 托管【開(kāi)發(fā)版】][main.user.js]
   • [GitHub 中文化插件 - GreasyFork 托管【發(fā)布版】][main(greasyfork).user.js]
4. 刷新下頁(yè)面，即可發(fā)現(xiàn)網(wǎng)站已中文化。

[!NOTE]

1. 開(kāi)發(fā)版：通常比發(fā)布版更早進(jìn)入開(kāi)發(fā)和測(cè)試階段（重大版本更新前，還會(huì)專(zhuān)門(mén)創(chuàng)建新分支進(jìn)行測(cè)試）。日常維護(hù)詞庫(kù)內(nèi)容，并且詞庫(kù)版本號(hào)會(huì)在每周五凌晨自動(dòng)更新。

   注意:

   • 如果版本號(hào)未更新，即使內(nèi)容已更新，用戶(hù)腳本管理器仍會(huì)忽略這些更新，需要手動(dòng)安裝以獲取最新內(nèi)容。

2. 發(fā)布版: 日常功能被凍結(jié)（除非由項(xiàng)目所有者進(jìn)行更新）。通常在開(kāi)發(fā)版詞庫(kù)版本號(hào)更新后的下周一凌晨，自動(dòng)同步上一開(kāi)發(fā)版的詞庫(kù)文件。通常情況下，發(fā)布版與開(kāi)發(fā)版之間會(huì)存在一周的時(shí)間差。

[!IMPORTANT]

關(guān)于 “Chrome 127 及更高版本無(wú)法使用” 的問(wèn)題

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

解決方案：

1. 安裝 [Tampermonkey][Tampermonkey] 5.2.0 或更高版本。
2. 在瀏覽器的 “擴(kuò)展程序” 管理中開(kāi)啟 “開(kāi)發(fā)者模式”。

詞庫(kù)本地調(diào)試方法

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

[!TIP] 直接將詞庫(kù)文件拖到瀏覽器的地址欄，再?gòu)?fù)制地址欄的中地址即可。

[![][back-to-top]](#readme-top)

?? 更新說(shuō)明

2024-08-18 16:44:24

更新至 1.9.3

1. 新增功能：通過(guò)設(shè)置中文環(huán)境，自動(dòng)本地化時(shí)間元素，僅保留on開(kāi)頭的時(shí)間正則，并停用時(shí)間元素監(jiān)視
2. 優(yōu)化突變翻譯處理：
   • 引入characterDataPage規(guī)則，對(duì)特定頁(yè)面啟用篩選字符數(shù)據(jù)的變更
   • 引入ignoreMutationSelectorPage規(guī)則，忽略特定突變?cè)?/li>
3. 合并reIgnoreClass，reIgnoreItemprop，ignoreId，ignoreTag為ignoreSelectorPage規(guī)則，處理全局及特定頁(yè)面，忽略特定元素
4. 引入全局緩存模式，減少重復(fù)構(gòu)建包括不限于基于page變化的忽略規(guī)則、正則規(guī)則數(shù)組等
5. 調(diào)整：更新訊飛聽(tīng)見(jiàn)翻譯引擎v2.0
6. 優(yōu)化：梳理、優(yōu)化腳本
7. 調(diào)整：調(diào)整詞庫(kù)語(yǔ)言代碼為zh-CN, 與環(huán)境語(yǔ)言設(shè)置一致

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: 主版本號(hào)(由項(xiàng)目所有者更新)

1. 重新定義版本號(hào)規(guī)則, 如1.9.0-2023-12-09
2. 加強(qiáng): [GitHub 托管【開(kāi)發(fā)版】][main.user.js]每周一凌晨自動(dòng)更新詞庫(kù)發(fā)布版本號(hào)
3. 加強(qiáng): [GreasyFork 托管【發(fā)布版】][main(greasyfork).user.js]每周五凌晨自動(dòng)更新詞庫(kù)發(fā)布版本號(hào), 詞庫(kù)內(nèi)容同上一次[GitHub 托管【開(kāi)發(fā)版】][main.user.js]
4. 加強(qiáng)：在 README.md 中自動(dòng)更新貢獻(xiàn)者頭像
5. 更新: 忽略規(guī)則, 詞條等

2023-08-31 13:39:36

更新至 1.8.5

1. 優(yōu)化: transDesc 函數(shù)代碼
2. 修復(fù): 重復(fù)添加translate-me翻譯按鈕
3. 加強(qiáng)：watchUpdate 函數(shù)新增節(jié)點(diǎn)文本更新的情況
4. 調(diào)整: transBySelector和transDesc函數(shù)延遲執(zhí)行時(shí)間
5. 更新: 忽略規(guī)則, 詞條等

2023-08-08 11:53:03

更新至 1.8.4

1. 修復(fù): Itemprop過(guò)濾規(guī)則, 依然使用正則方式
2. 修復(fù): tooltipped樣式提示, 依然使用正則方式

2023-08-07 14:41:17

更新至 1.8.3

1. 梳理、優(yōu)化腳本
2. 更新: 忽略規(guī)則, 大量詞條等

2023-05-15 18:02:04

更新至 1.8.2

1. greasyfork 托管源切換到按頁(yè)面精細(xì)化詞條模式
2. 調(diào)整詞庫(kù)格式
3. 功能加強(qiáng): 優(yōu)化元素篩選器翻譯邏輯
4. 更新: 忽略規(guī)則, 大量詞條等

2023-01-22 22:01:39

更新至 1.8.1

1. 修復(fù): #8 與 dark reader 擴(kuò)展發(fā)生沖突，導(dǎo)致時(shí)間顯示出現(xiàn)問(wèn)題
2. GitHub源開(kāi)始切換到按頁(yè)面精細(xì)化詞條模式(開(kāi)發(fā)版), 詞庫(kù)未完全遷移適配
3. 停止greasyfork源詞庫(kù)文件的同步更新

2023-01-18 12:56:24

更新至 1.8.0

1. 刪除: TURBO-FRAME框架處理代碼. Github 已調(diào)整新動(dòng)態(tài)加載模式, 直接檢測(cè)url的變化就能獲取對(duì)應(yīng)的page信息
2. 新增: 支持時(shí)間元素的Shadow DOM翻譯, 并監(jiān)聽(tīng)變化
3. 新增: 啟用并更新時(shí)間元素翻譯專(zhuān)項(xiàng)正則詞條
4. 新增: 僅當(dāng)page有效才翻譯頁(yè)面
5. 修復(fù): 原簡(jiǎn)介翻譯引擎GitHub中文社區(qū)失效, 改為訊飛引擎(測(cè)試)
6. 修復(fù): 追加公共正則重復(fù)迭代的問(wèn)題
7. 修復(fù): 正則標(biāo)記變量RegExp與構(gòu)造函數(shù)new RegExp沖突
8. 更新: 忽略規(guī)則, 詞條等

預(yù)告, 下次將細(xì)化page匹配規(guī)則, 導(dǎo)致詞庫(kù)文件結(jié)構(gòu)大調(diào)整, 詞庫(kù)文件會(huì)適當(dāng)變大, 頁(yè)面正則更精細(xì)效率會(huì)提升

?? 更多

### 2022-07-17 14:04:44 更新至 1.7.9 GitHub 的 ajax 載入方式逐步從 [defunkt/jquery-pjax](https://github.com/defunkt/jquery-pjax) 切換到 [hotwired/turbo](turbo.hotwired.dev), 導(dǎo)致已有的動(dòng)態(tài)監(jiān)測(cè)方式逐步失效 目前, 通過(guò)以下修復(fù): 1. 新增 `BODY` 元素新增監(jiān)視 1. 解析 `TURBO-FRAME` 框架, 獲取對(duì)應(yīng)的 `page` 1. 修復(fù) github 新動(dòng)態(tài)加載模式, 導(dǎo)致`翻譯描述`返回值無(wú)法插入 1. 修復(fù) github 新動(dòng)態(tài)加載模式, 導(dǎo)致`chrome`瀏覽器自帶翻譯功能卡死頁(yè)面 其他更新: 1. 修復(fù)`rePagePath`,`rePagePathRepo`,`rePagePathOrg`匹配規(guī)則，限制路徑匹配層次，排除干擾 1. 直接使用網(wǎng)頁(yè)URL`document.URL`變化觸發(fā)`標(biāo)題翻譯`和`JS 篩選器`翻譯 1. 修復(fù)`關(guān)閉正則`無(wú)法生效, 需要刷新頁(yè)面才生效 1. 日常更新詞庫(kù)和忽略規(guī)則 1. 更新`JS 篩選器`規(guī)則 ### 2022-06-29 13:27:12 更新至 1.7.8 1. 緊急修復(fù): GitHub 變更了`document.body`和`title`更新機(jī)制, 導(dǎo)致原有的`監(jiān)測(cè)更新`規(guī)則部分失效, 目前使用`document.documentElement`監(jiān)視整個(gè)頁(yè)面 DOM 的變更 1. 跳過(guò)``標(biāo)簽 1. `標(biāo)題翻譯`和`JS 篩選器`翻譯, 依據(jù) URL變化更新 ### 2022-06-26 16:41:58 更新至 1.7.7 1. 新增`時(shí)間元素翻譯`功能 1. 重寫(xiě)`頁(yè)面標(biāo)題翻譯`函數(shù) 1. 梳理`遍歷節(jié)點(diǎn)`函數(shù)邏輯 1. 優(yōu)化`transPage`函數(shù)，默認(rèn)翻譯公共部分 1. 調(diào)整`getPage`函數(shù), 使`ClassName匹配規(guī)則`優(yōu)先 1. 優(yōu)化`translate`函數(shù), 跳過(guò)`不存在英文字母和符號(hào),.`, 保留首尾空白部分等 1. 部分函數(shù)重命名，使用`es6`新語(yǔ)法 1. 日常更新詞庫(kù)和忽略規(guī)則，修復(fù)一個(gè)`JS 選擇器規(guī)則` ### 2022-05-12 13:53:46 更新至 1.7.6 1. 日常更新詞庫(kù)和忽略規(guī)則 1. 添加手動(dòng)開(kāi)啟/禁用正則翻譯，添加切換菜單 1. 優(yōu)化翻譯文本函數(shù)：避免已翻譯詞匯二次匹配，提高效率；局部翻譯優(yōu)先于全局 ### 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][license-url] 希望大家依據(jù)許可證使用 ### 2021-10-31 21:49:00 正式發(fā)布 1.7.0 版本 ### 2021-10-07 13:16:16 原作者[樓教主](https://github.com/52cik/github-hans)已停止維護(hù)多年，且近年來(lái) GitHub 頁(yè)面結(jié)構(gòu)的變化，導(dǎo)致原有的腳本無(wú)法正常工作。 雖然 GitHub 在被微軟售收購(gòu)比較重視國(guó)際化，啟動(dòng)并基本完成了GitHub 文檔的中文化。但是，關(guān)于 GitHub 頁(yè)面的中文化暫時(shí)還沒(méi)啟動(dòng)。 對(duì)于，新手使用和高階使用仍會(huì)存在一定的障礙。故，本人依據(jù)個(gè)人興趣暫時(shí)進(jìn)行了一定的修復(fù)和維護(hù)。 本次維護(hù)基本恢復(fù)和保留大部分功能如：頁(yè)面正則翻譯（含日期的正則）。頁(yè)面詞條可能被我切得太碎不方便后期維護(hù)（先這樣吧?。? </details>

[![][back-to-top]](#readme-top)

## ? 待辦 (TODO) 1. 添加 GitHub 名詞解釋?zhuān)率挚赡懿惶斫獠糠置~具體表達(dá)的意思，比如 `pull request`。 1. 整理部分 [Git](https://git-scm.com/) & [GitHub](https://github.com/) 學(xué)習(xí)資料, 幫助新手**更快**上手。 1. **本人英文渣渣，翻譯非常困難，急需大家 PR 共同翻譯** ## ? 貢獻(xiàn) 查看我們的[貢獻(xiàn)小技巧](https://github.com/maboloshi/github-chinese/issues/52) 目前已翻譯大部分常用頁(yè)面，歡迎補(bǔ)充完善，中文詞條在`locals.js`中。大家在補(bǔ)充完善的過(guò)程，請(qǐng)遵循以下文檔對(duì)相關(guān)術(shù)語(yǔ)進(jìn)行翻譯： ### 相關(guān)概念及資料文檔: 1. [Pro Git 第二版 簡(jiǎn)體中文](https://git-scm.com/book/zh/v2) 1. [Pro Git: 翻譯約定](https://github.com/progit/progit2-zh/blob/master/TRANSLATION_NOTES.asc) 1. [Git 官方軟件包的簡(jiǎn)體中文翻譯](https://github.com/git/git/blob/master/po/zh_CN.po) 1. [GitHub 詞匯表官方譯本](https://docs.github.com/cn/get-started/quickstart/github-glossary) ## ?? 預(yù)覽

?? 打賞

## ?? 鳴謝 [maboloshi](https://github.com/maboloshi) - 項(xiàng)目作者 [wuyuncheng-26](https://github.com/wuyuncheng-26) - 項(xiàng)目協(xié)作者 [52cik](https://github.com/52cik) - 項(xiàng)目原作者 ### 感謝所有貢獻(xiàn)者 一如既往，感謝我們出色的貢獻(xiàn)者??！ 貢獻(xiàn)者列表，由 [GitHub Action][GitHub Action] 自動(dòng)生成

[![][back-to-top]](#readme-top)

[back-to-top]: https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square [project-url]: https://github.com/maboloshi/github-chinese "GitHub 中文化插件" [issues-url]: https://github.com/maboloshi/github-chinese/issues "議題" [issues-image]: https://img.shields.io/github/issues/maboloshi/github-chinese?style=flat-square&logo=github&label=Issue [stars-url]: https://github.com/maboloshi/github-chinese/stargazers "星標(biāo)" [stars-image]: https://img.shields.io/github/stars/maboloshi/github-chinese?style=flat-square&logo=github&label=Star [forks-url]: https://github.com/maboloshi/github-chinese/network "復(fù)刻" [forks-image]: https://img.shields.io/github/forks/maboloshi/github-chinese?style=flat-square&logo=github&label=Fork [license-url]: https://opensource.org/licenses/GPL-3.0 "許可證" [license-image]: https://img.shields.io/github/license/maboloshi/github-chinese?style=flat-square&logo=github&label=License [greasyFork-url]: https://greasyfork.org/scripts/435208 "GreasyFork - GitHub 中文化插件" [greasyFork-image]: https://img.shields.io/badge/dynamic/json?style=flat-square&label=GreasyFork&query=total_installs&suffix=%20installs&url=https://greasyfork.org/scripts/435208.json [Tampermonkey]: http://tampermonkey.net/ "篡改猴" [Violentmonkey]: https://violentmonkey.github.io/ "暴力猴" [Macaque]: https://macaque.app/ "獼猴" [Stay]: https://apps.apple.com/cn/app/stay-for-safari-%E6%B5%8F%E8%A7%88%E5%99%A8%E4%BC%B4%E4%BE%A3/id1591620171 "Stay" [main.user.js]: https://github.com/maboloshi/github-chinese/raw/gh-pages/main.user.js "GitHub 中文化插件 - GitHub 托管" [main(greasyfork).user.js]: https://greasyfork.org/scripts/435208-github-%E4%B8%AD%E6%96%87%E5%8C%96%E6%8F%92%E4%BB%B6/code/GitHub%20%E4%B8%AD%E6%96%87%E5%8C%96%E6%8F%92%E4%BB%B6.user.js "GitHub 中文化插件 - GreasyFork 托管" [GitHub Action]: https://github.com/maboloshi/github-chinese/blob/gh-pages/.github/workflows/update_contributors_images.yml

This site is open source. Improve this page.