GitHub 中文化插件

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

💖 星标历史

🚩 功能

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

🌐 浏览器与脚本管理器

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

💽 安装

请先安装用户脚本管理器。
然后再点击以下链接之一，安装脚本即可。
- GitHub 中文化插件 - GitHub 托管【开发版】（相对及时更新）
  注意：
  1. 当版本号未更新的情况下，即使内容已更新，用户脚本管理器依然会忽略，需要手动安装获取更新
  2. 目前，已实现每周一凌晨自动更新开发版版本号
- GitHub 中文化插件 - GreasyFork 托管【发布版】（仅大版本更新）
刷新页面，即可发现网站已中文化。

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

[!注意]

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

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

解决方案：

必须安装 Tampermonkey 5.2.0 及以上版本，其他脚本管理器暂不支持

必须在浏览器的"扩展程序"管理中开启"开发者模式"

词库本地调试方法

需要安装用户脚本管理器 Tampermonkey，其他可能不支持。
在浏览器扩展管理中，开启 Tampermonkey 的"允许访问文件网址"，如图：
将修改后的词库文件放到本地方便访问的位置。
安装 GitHub 中文化插件 - GitHub 托管【开发版】（相对及时更新），实际上 GitHub 中文化插件 - GreasyFork 托管【发布版】（仅大版本更新）也可以。
回到脚本管理器，修改词库文件路径，即将类似 // @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

新增功能：通过设置中文环境，自动本地化时间元素，仅保留以"on"开头的时间正则，并停用时间元素监视
新增功能：优化突变翻译处理：
- 引入characterDataPage规则，对特定页面启用"筛选字符数据"的变更
- 引入ignoreMutationSelectorPage规则，忽略特定突变元素
新增功能：合并reIgnoreClass，reIgnoreItemprop，ignoreId，ignoreTag为ignoreSelectorPage规则，处理全局及特定页面，忽略特定元素
新增功能：引入全局缓存模式，减少重复构建包括但不限于基于page变化的忽略规则、正则规则数组等
调整：更新讯飞听见翻译引擎v2.0
优化：梳理、优化脚本
调整：调整词库语言代码为zh-CN，与环境语言设置一致

2024-06-14 19:27:20

更新至 1.9.2

适配www.githubstatus.com
适配skills.github.com

2024-05-23 16:42:55

更新至 1.9.1

更新"切换正则功能按钮"

2023-12-09 20:46:16

更新至 1.9.0

重新定义版本号规则，如1.9.0-2023-12-09 其中，1.9.0：主版本号（由项目所有者更新） 2023-12-09：词库发布日期（手动或按周期自动发布）
加强：GitHub 托管【开发版】每周一凌晨自动更新"词库"发布版本号
加强：GreasyFork 托管【发布版】每周五凌晨自动更新"词库"发布版本号，词库内容同上一次GitHub 托管【开发版】
加强：在 README.md 中自动更新贡献者头像
更新：忽略规则、词条等

2023-08-31 13:39:36

更新至 1.8.5

优化：transDesc 函数代码
修复：重复添加translate-me翻译按钮
加强：watchUpdate 函数新增节点文本更新的情况
调整：transBySelector和transDesc函数延迟执行时间
更新：忽略规则、词条等

2023-08-08 11:53:03

更新至 1.8.4

修复：Itemprop过滤规则，依然使用正则方式
修复：tooltipped样式提示，依然使用正则方式

2023-08-07 14:41:17

更新至 1.8.3

梳理、优化脚本
更新：忽略规则、大量词条等

2023-05-15 18:02:04

更新至 1.8.2

greasyfork 托管源切换到"按页面精细化词条模式"
调整词库格式
功能加强：优化"元素筛选器"翻译逻辑
更新：忽略规则、大量词条等

2023-01-22 22:01:39

更新至 1.8.1

修复：#8 与 dark reader 扩展发生冲突，导致时间显示出现问题
GitHub源开始切换到"按页面精细化词条模式(开发版)"，词库未完全迁移适配
停止greasyfork源词库文件的同步更新

2023-01-18 12:56:24

更新至 1.8.0

删除：TURBO-FRAME框架处理代码。Github 已调整新动态加载模式，直接检测url的变化就能获取对应的page信息
新增：支持时间元素的Shadow DOM翻译，并监听变化
新增：启用并更新"时间元素翻译"专项正则词条
新增：仅当page有效才翻译页面
修复：原"简介翻译"引擎GitHub中文社区失效，改为讯飞引擎（测试）
修复：追加公共正则重复迭代的问题
修复：正则标记变量RegExp与构造函数new RegExp冲突
更新：忽略规则、词条等预告：下次将细化page匹配规则，导致词库文件结构大调整，词库文件会适当变大，页面正则更精细，效率会提升

🎁 更多

2022-07-17 14:04:44

更新至 1.7.9

GitHub 的 ajax 加载方式逐步从 defunkt/jquery-pjax 切换到 hotwired/turbo，导致已有的动态监测方式逐步失效

目前，通过以下修复:

新增对 BODY 元素的监视
解析 TURBO-FRAME 框架，获取对应的 page
修复 GitHub 新动态加载模式导致"翻译描述"返回值无法插入的问题
修复 GitHub 新动态加载模式导致 Chrome 浏览器自带翻译功能卡死页面的问题

其他更新:

修复rePagePath、rePagePathRepo、rePagePathOrg匹配规则，限制路径匹配层次，排除干扰
直接使用网页 URL document.URL 变化触发"标题翻译"和"JS 筛选器"翻译
修复"关闭正则"无法生效，需要刷新页面才生效的问题
日常更新词库和忽略规则
更新"JS 筛选器"规则

2022-06-29 13:27:12

更新至 1.7.8

紧急修复: GitHub 变更了 document.body 和 title 更新机制，导致原有的"监测更新"规则部分失效，目前使用 document.documentElement 监视整个页面 DOM 的变更
跳过 <HEAD> 标签
"标题翻译"和"JS 筛选器"翻译，依据 URL 变化更新