ContextQMD
Back to Github Chinese

[GitHub 中文化插件][github-project-link]

README_zh-TW.md

1.9.219.4 KB
Original Source
<div align="center"><a name="readme-top"></a>

GitHub 中文化插件

讓 GitHub 界面全面中文化 | 源自 52cik/github-hans

简体中文 · 繁體中文 · 反饋問題

<!-- SHIELD GROUP -->

<a href="https://hellogithub.com/repository/738d0abae49543f18d887a7e29ec9e90" target="_blank"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.hellogithub.com/v1/widgets/recommend.svg?rid=738d0abae49543f18d887a7e29ec9e90&claim_uid=zepvSg6Vwl4EqMr&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.hellogithub.com/v1/widgets/recommend.svg?rid=738d0abae49543f18d887a7e29ec9e90&claim_uid=zepvSg6Vwl4EqMr&theme=neutral" /> </picture> </a> </div>

[!warning] 本項目從未發佈至 GitCode，如您發現請截圖並保留證據

[!IMPORTANT] 💡 重要： 本繁體語言版本，使用基於OpenCC及自定義規則轉換

<details> <summary><kbd>目錄樹</kbd></summary>

TOC

</details>

🌟 功能特性

  • 全面中文化 GitHub 界面元素（菜單欄、標題、按鈕等）
  • 智能正則匹配功能
  • 支持項目描述的人機翻譯
  • 自動本地化時間元素
  • 持續更新詞庫

🌐 兼容環境

瀏覽器類型支持的腳本管理器
Chrome / Chromium 內核Tampermonkey, Violentmonkey
Safari（全平臺）Macaque, Stay
Firefox / Gecko 內核Tampermonkey, Violentmonkey
Via（Android）內置管理器

💻 安裝指南

  1. 安裝用戶腳本管理器：
  2. 基於 Chrome / Chromium 內核瀏覽器：
    1. 務必開啟 「擴展程序」 管理中的 「開發者模式」1
    2. 務必開啟 「擴展程序」 管理中腳本管理器擴展的 「允許運行用戶腳本」
    3. 具體可參考 Tampermonkey 官方指引
  3. 選擇安裝源：
  4. 刷新頁面後，插件即可生效
  5. 必要時，重啟瀏覽器

[!NOTE] 版本說明：

  • 🚀 開發版：實時更新，每週五自動更新詞庫
  • 🛡️ 穩定版：每週一同步開發版詞庫，更穩定

🔧 本地調試

  1. 安裝 Tampermonkey，並啟用 “允許訪問文件網址”。
  2. 下載詞庫文件到本地（如：D:\github-chinese\locals.js）
  3. 在腳本管理器中修改引用路徑：
    js
    // 原始路徑
// @require https://raw.githubusercontent.com/...

// 修改為
// @require file:///D:/github-chinese/locals.js
  4. 刷新頁面生效

[!TIP] 💡 溫馨提示： 您可以將詞庫文件拖拽至瀏覽器地址欄，複製路徑直接使用。

<div align="right">

</div>

🔄 更新日誌

最新版本

v1.9.3 (2024-08-18)

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

v1.9.2 (2024-06-14)

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

v1.9.1 (2024-05-23)

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

v1.9.0 (2023-12-09)

  1. 重新定義版本號規則, 如1.9.0-2023-12-09。
    • 1.9.0: 主版本號（由項目所有者更新）
    • 2023-12-09：詞庫發佈版本號（由 GitHub Action 自動更新）
  2. 加強: [GitHub 源【開發版】][main.user.js]每週一凌晨自動更新詞庫發佈版本號
  3. 加強: [GreasyFork 源【穩定版】][main(greasyfork).user.js]每週五凌晨自動更新詞庫發佈版本號, 詞庫內容同上一次[GitHub 源【開發版】][main.user.js]
  4. 加強：在 README.md 中自動更新貢獻者頭像
  5. 更新: 忽略規則, 詞條等

v1.8.5 (2023-08-31)

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

v1.8.4 (2023-08-08)

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

v1.8.3 (2023-08-07)

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

v1.8.2 (2023-05-15)

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

v1.8.1 (2023-01-22)

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

v1.8.0 (2023-01-18)

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

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

v1.7.9 (2022-07-17)

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 篩選器規則

v1.7.8 (2022-06-29)

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

v1.7.7 (2022-06-26)

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

v1.7.6 (2022-05-12)

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

</div>

📌 待辦事項

  1. 添加 GitHub 專用名詞解釋
  2. 整理 Git & GitHub 學習資料
  3. 完善文檔翻譯，需大家 PR 共同翻譯

🤝 參與貢獻

歡迎通過以下方式參與貢獻：

  1. 完善詞庫翻譯（編輯 locals.js）
  2. 提交議題報告，參與話題討論
  3. 改進代碼邏輯

翻譯參考資源:

  1. Pro Git 第二版 簡體中文
  2. Pro Git: 翻譯約定
  3. Git 官方軟件包的簡體中文翻譯
  4. GitHub 詞彙表官方譯本
  5. CSS 選擇器 用於編寫忽略規則

查看詳細貢獻指南

🖼️ 效果預覽

<picture> <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/maboloshi/github-chinese/gh-pages/preview/img1.png"/> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/maboloshi/github-chinese/gh-pages/preview/img3.png"/> </picture> <picture> <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/maboloshi/github-chinese/gh-pages/preview/img2.png"/> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/maboloshi/github-chinese/gh-pages/preview/img4.png"/> </picture>

🙏 特別鳴謝

核心團隊

貢獻者牆

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

<!--AUTO_GENERATED_PLEASE_DONT_DELETE_IT--> <a href="https://github.com/maboloshi" title="沙漠之子"> </a> <a href="https://github.com/52cik" title="樓教主"> </a> <a href="https://github.com/TC999" title="陳生雜物房"> </a> <a href="https://github.com/qznfbnj" title="其智乃反不能及"> </a> <a href="https://github.com/wyc-26" title="wyc-26"> </a> <a href="https://github.com/pylover7" title="大葉子"> </a> <a href="https://github.com/cat-kun" title="cat-kun"> </a> <a href="https://github.com/ChinaGodMan" title="人民的勤務員"> </a> <a href="https://github.com/buiawpkgew1" title="菾凴"> </a> <a href="https://github.com/yrljroli" title="𠭞"> </a> <a href="https://github.com/YiShengJunn" title="益生君"> </a> <a href="https://github.com/3DMXM" title="小莫"> </a> <a href="https://github.com/xuexb" title="前端小武"> </a> <a href="https://github.com/wang4yu6peng13" title="wang4yu6peng13"> </a> <a href="https://github.com/pangshitong" title="pangshitong"> </a> <a href="https://github.com/daydaygo" title="dayday"> </a> <a href="https://github.com/heicks" title="create new ██████╗ ██╔══██╗ ██████╔╝ ██╔══██╗ ██████╔╝ ╚═════╝ 　　██╗ 　 ██╗ 　　██║ 　 ██║ 　　██║ 　 ██║ 　　██║ 　 ██║ 　　╚█████╔╝ 　　╚═════╝ ███████╗ ██╔════╝　 ██║████═╗　 ██║　 ██　║ ╚██████╔╝　 　╚══════╝"> </a> <a href="https://github.com/KS-OTO" title="KS-OTO"> </a> <a href="https://github.com/swsoyee" title="InfinityLoop"> </a> <a href="https://github.com/ImgBotApp" title="Imgbot"> </a> <a href="https://github.com/neveler" title="neveler"> </a> <!--AUTO_GENERATED_PLEASE_DONT_DELETE_IT-END-->

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

<div align="right">

</div>

📈 項目統計

<a href="https://star-history.com/#maboloshi/github-chinese&Timeline"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=maboloshi/github-chinese&type=Timeline&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=maboloshi/github-chinese&type=Timeline" /> </picture> </a>

<div align="right">

</div>

🎁 歡迎打賞

讚賞列表

微信讚賞支付寶讚賞
<small>☕喝點咖啡繼續幹☕</small>
<small>🌶️來包辣條吧~🍪</small>
<!-- LINK GROUP -->

Footnotes

  1. Chrome 切換到 Manifest V3後，使用問題 ↩