GitHub 中文化插件

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

<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" /> <img alt="精选｜HelloGitHub" src="https://api.hellogithub.com/v1/widgets/recommend.svg?rid=738d0abae49543f18d887a7e29ec9e90&claim_uid=zepvSg6Vwl4EqMr&theme=neutral" style="width: 250px; height: 54px;" width="250" height="54" /> </picture> </a>

💖 星标历史

<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" /> <img alt="星标历史图表" src="https://api.star-history.com/svg?repos=maboloshi/github-chinese&type=Timeline" width="75%" /> </picture> </a>

🚩 功能

• 中文化 GitHub 菜单栏、标题、按钮等公共组件
• 保留、完善正则功能
• 除基础组件中文化外，还支持对"项目描述"进行人机翻译（参考：k1995/github-i18n-plugin）

🌐 浏览器与脚本管理器

浏览器	脚本管理器
Chrome 或基于 Chromium 内核的浏览器	Tampermonkey 或 Violentmonkey
Safari 浏览器（macOS、iOS、iPadOS）	Macaque 或 Stay
Firefox 或基于 Gecko 内核的浏览器	Tampermonkey 或 Violentmonkey
Via 浏览器（Android）	浏览器内自带

💽 安装

1. 请先安装用户脚本管理器。
2. 然后再点击以下链接之一，安装脚本即可。
   • GitHub 中文化插件 - GitHub 托管【开发版】（相对及时更新）

     注意：

     1. 当版本号未更新的情况下，即使内容已更新，用户脚本管理器依然会忽略，需要手动安装获取更新
     2. 目前，已实现每周一凌晨自动更新开发版版本号

   • GitHub 中文化插件 - GreasyFork 托管【发布版】（仅大版本更新）
3. 刷新页面，即可发现网站已中文化。

需要视频教程的可以查看这里收录的一些视频

[!注意]

关于"Chrome 127 及更高版本无法使用"的问题

原因是 Chrome 127 及更高版本陆续切换到 Manifest V3，目前已知 Tampermonkey 5.2.0 及以上版本支持，详见 #234 讨论

解决方案：

1. 必须安装 Tampermonkey 5.2.0 及以上版本，其他脚本管理器暂不支持
2. 必须在浏览器的"扩展程序"管理中开启"开发者模式"

词库本地调试方法

1. 需要安装用户脚本管理器 Tampermonkey，其他可能不支持。

2. 在浏览器扩展管理中，开启 Tampermonkey 的"允许访问文件网址"，如图：

   <picture> <source media="(prefers-color-scheme: light)" srcset="https://yellow-cdn.veclightyear.com/0a4dffa0/fc2f1772-e3a5-4857-987f-51593d4355b5.png"/> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/maboloshi/github-chinese/gh-pages/preview/允许访问文件网址-dark.png"/> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/fc2f1772-e3a5-4857-987f-51593d4355b5.png" width="75%" /> </picture>

3. 将修改后的词库文件放到本地方便访问的位置。

4. 安装 GitHub 中文化插件 - GitHub 托管【开发版】（相对及时更新），实际上 GitHub 中文化插件 - GreasyFork 托管【发布版】（仅大版本更新） 也可以。

5. 回到脚本管理器，修改词库文件路径，即将类似 // @require https://raw.githubusercontent.com/maboloshi/github-chinese/gh-pages/locals.js?v1.9.0 中的网址改为本地路径格式，如 file:///D:/APP/github项目/github-chinese/locals.js。

[!提示] 直接将词库文件拖到浏览器的地址栏，然后复制地址栏中的地址即可。

📝 更新说明

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. 重新定义版本号规则，如1.9.0-2023-12-09 其中，1.9.0：主版本号（由项目所有者更新） 2023-12-09：词库发布日期（手动或按周期自动发布）
2. 加强：GitHub 托管【开发版】每周一凌晨自动更新"词库"发布版本号
3. 加强：GreasyFork 托管【发布版】每周五凌晨自动更新"词库"发布版本号， 词库内容同上一次GitHub 托管【开发版】
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匹配规则，导致词库文件结构大调整，词库文件会适当变大，页面正则更精细，效率会提升

<details> <summary><h2>🎁 更多</h2></summary>

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. 直接使用网页 URL document.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 页面的中文化暂时还没启动。

对于新手使用和高阶使用仍会存在一定的障碍。故，本人依据个人兴趣暂时进行了一定的修复和维护。

本次维护基本恢复和保留大部分功能如：页面正则翻译（含日期的正则）。页面词条可能被我切得太碎不方便后期维护（先这样吧！）

</details>

✔ 待办 (TODO)

1. 添加 GitHub 名词解释，新手可能不太理解部分名词具体表达的意思，比如 pull request。
2. 整理部分 Git & GitHub 学习资料，帮助新手更快上手。
3. 本人英文渣渣，翻译非常困难，急需大家 PR 共同翻译

✨ 贡献

查看我们的贡献小技巧

目前已翻译大部分常用页面，欢迎补充完善，中文词条在locals.js中。大家在补充完善的过程，请遵循以下文档对相关术语进行翻译：

相关概念及资料文档:

1. Pro Git 第二版 简体中文
2. Pro Git: 翻译约定
3. Git 官方软件包的简体中文翻译
4. GitHub 词汇表官方译本

🎨 预览

<picture> <source media="(prefers-color-scheme: light)" srcset="https://yellow-cdn.veclightyear.com/0a4dffa0/fb11ff95-de03-472b-ad2c-5ca318b3caf4.png"/> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/maboloshi/github-chinese/gh-pages/preview/img3.png"/> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/fb11ff95-de03-472b-ad2c-5ca318b3caf4.png" width="75%" /> </picture> <picture> <source media="(prefers-color-scheme: light)" srcset="https://yellow-cdn.veclightyear.com/0a4dffa0/ba25c0f2-0dc2-4e09-a89a-6aec623eaa02.png"/> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/maboloshi/github-chinese/gh-pages/preview/img4.png"/> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/ba25c0f2-0dc2-4e09-a89a-6aec623eaa02.png" width="75%" /> </picture> <details> <summary><h2>🎁 打赏</h2></summary>

<img src="https://yellow-cdn.veclightyear.com/0a4dffa0/45226536-c0bd-49e7-9a5a-f9bc0e0f5938.jpg" alt="微信赞赏" width="30%"> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/99c0f9fe-4a57-4bd3-8d1b-751ed87a82e9.jpg" alt="支付宝赞赏" width="30%">

</details>

💝 鸣谢

maboloshi - 项目作者

wuyuncheng-26 - 项目协作者

52cik - 项目原作者

感谢所有贡献者

一如既往，感谢我们出色的贡献者❤️！

<!--AUTO_GENERATED_PLEASE_DONT_DELETE_IT--> <a href="https://github.com/maboloshi" title="沙漠之子"> <img src="https://avatars.githubusercontent.com/u/7850715?v=4" width="42;" alt="沙漠之子"/> </a> <a href="https://github.com/52cik" title="楼教主"> <img src="https://avatars.githubusercontent.com/u/5033310?v=4" width="42;" alt="楼教主"/> </a> <a href="https://github.com/wuyuncheng-26" title="是小胖呀26"> <img src="https://avatars.githubusercontent.com/u/122529705?v=4" width="42;" alt="是小胖呀26"/> </a> <a href="https://github.com/TC999" title="陈生杂物房"> <img src="https://avatars.githubusercontent.com/u/88823709?v=4" width="42;" alt="陈生杂物房"/> </a> <a href="https://github.com/qznfbnj" title="其智乃反不能及"> <img src="https://avatars.githubusercontent.com/u/100760086?v=4" width="42;" alt="其智乃反不能及"/> </a> <a href="https://github.com/pylover7" title="大叶子"> <img src="https://avatars.githubusercontent.com/u/56282729?v=4" width="42;" alt="大叶子"/> </a> <a href="https://github.com/cat-kun" title="cat-kun"> <img src="https://avatars.githubusercontent.com/u/8529528?v=4" width="42;" alt="cat-kun"/> </a> <a href="https://github.com/pecasha" title="Pecasha"> <img src="https://avatars.githubusercontent.com/u/9607128?v=4" width="42;" alt="Pecasha"/> </a> <a href="https://github.com/buiawpkgew1" title="菾凴"> <img src="https://avatars.githubusercontent.com/u/71136405?v=4" width="42;" alt="菾凴"/> </a> <a href="https://github.com/3DMXM" title="小莫"> <img src="https://avatars.githubusercontent.com/u/28587093?v=4" width="42;" alt="小莫"/> </a> <a href="https://github.com/xuexb" title="前端小武"> <img src="https://avatars.githubusercontent.com/u/3872051?v=4" width="42;" alt="前端小武"/> </a> <a href="https://github.com/wang4yu6peng13" title="wang4yu6peng13"> <img src="https://avatars.githubusercontent.com/u/10207042?v=4" width="42;" alt="wang4yu6peng13"/> </a> <a href="https://github.com/pangshitong" title="pangshitong"> <img src="https://avatars.githubusercontent.com/u/41714457?v=4" width="42;" alt="pangshitong"/> </a> <a href="https://github.com/daydaygo" title="dayday"> <img src="https://avatars.githubusercontent.com/u/3986303?v=4" width="42;" alt="dayday"/> </a> <a href="https://github.com/heicks" title="create new ██████╗ ██╔══██╗ ██████╔╝ ██╔══██╗ ██████╔╝ ╚═════╝ 　　██╗ 　 ██╗ 　　██║ 　 ██║ 　　██║ 　 ██║ 　　██║ 　 ██║ 　　╚█████╔╝ 　　╚═════╝ ███████╗ ██╔════╝　 ██║████═╗　 ██║　 ██　║ ╚██████╔╝　 　╚══════╝"> <img src="https://avatars.githubusercontent.com/u/12287943?v=4" width="42;" alt="create new ██████╗ ██╔══██╗ ██████╔╝ ██╔══██╗ ██████╔╝ ╚═════╝ 　　██╗ 　 ██╗ 　　██║ 　 ██║ 　　██║ 　 ██║ 　　██║ 　 ██║ 　　╚█████╔╝ 　　╚═════╝ ███████╗ ██╔════╝　 ██║████═╗　 ██║　 ██　║ ╚██████╔╝　 　╚══════╝"/> </a> <a href="https://github.com/KS-OTO" title="KS-OTO"> <img src="https://avatars.githubusercontent.com/u/6616413?v=4" width="42;" alt="KS-OTO"/> </a> <a href="https://github.com/swsoyee" title="InfinityLoop"> <img src="https://avatars.githubusercontent.com/u/20528423?v=4" width="42;" alt="InfinityLoop"/> </a> <a href="https://github.com/ImgBotApp" title="Imgbot"> <img src="https://avatars.githubusercontent.com/u/31427850?v=4" width="42;" alt="Imgbot"/> </a> <a href="https://github.com/CN-traveler" title="CN-traveler"> <img src="https://avatars.githubusercontent.com/u/55753029?v=4" width="42;" alt="CN-traveler"/> </a> <!--AUTO_GENERATED_PLEASE_DONT_DELETE_IT-END-->

贡献者列表，由 GitHub Action 自动生成