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 托管【开发版】
- GitHub 中文化插件 - GreasyFork 托管【发布版】
刷新下页面，即可发现网站已中文化。

[!NOTE]

开发版：通常比发布版更早进入开发和测试阶段（重大版本更新前，还会专门创建新分支进行测试）。日常维护词库内容，并且词库版本号会在每周五凌晨自动更新。

注意:

如果版本号未更新，即使内容已更新，用户脚本管理器仍会忽略这些更新，需要手动安装以获取最新内容。

发布版: 日常功能被冻结（除非由项目所有者进行更新）。通常在开发版词库版本号更新后的下周一凌晨，自动同步上一开发版的词库文件。通常情况下，发布版与开发版之间会存在一周的时间差。

[!TIP]

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

[!IMPORTANT]

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

这是由于 Chrome 127 及更高版本逐步切换到 Manifest V3。目前已知脚本管理器 Tampermonkey 5.2.0 及以上版本能够完美支持，而其他脚本管理器（如 Violentmonkey 等）可能无法正常运行此脚本。如果您使用的是其他脚本管理器，建议您改用支持 Manifest V3 的脚本管理器，或者将浏览器版本退回，等待相关脚本管理器开发者更新，或改用 Firefox 浏览器。详情请参阅 #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%E9%A1%B9%E7%9B%AE/github-chinese/locals.js。

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

📝 更新说明

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: 主版本号(由项目所有者更新)

重新定义版本号规则, 如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](https://github.com/defunkt/jquery-pjax) 切换到 [hotwired/turbo](turbo.hotwired.dev), 导致已有的动态监测方式逐步失效目前, 通过以下修复: 1. 新增 `BODY` 元素新增监视 1. 解析 `TURBO-FRAME` 框架, 获取对应的 `page` 1. 修复 github 新动态加载模式, 导致`翻译描述`返回值无法插入 1. 修复 github 新动态加载模式, 导致`chrome`浏览器自带翻译功能卡死页面其他更新: 1. 修复`rePagePath`,`rePagePathRepo`,`rePagePathOrg`匹配规则，限制路径匹配层次，排除干扰 1. 直接使用网页URL`document.URL`变化触发`标题翻译`和`JS 筛选器`翻译 1. 修复`关闭正则`无法生效, 需要刷新页面才生效 1. 日常更新词库和忽略规则 1. 更新`JS 筛选器`规则 ### 2022-06-29 13:27:12 更新至 1.7.8 1. 紧急修复: GitHub 变更了`document.body`和`title`更新机制, 导致原有的`监测更新`规则部分失效, 目前使用`document.documentElement`监视整个页面 DOM 的变更 1. 跳过``标签 1. `标题翻译`和`JS 筛选器`翻译, 依据 URL变化更新 ### 2022-06-26 16:41:58 更新至 1.7.7 1. 新增`时间元素翻译`功能 1. 重写`页面标题翻译`函数 1. 梳理`遍历节点`函数逻辑 1. 优化`transPage`函数，默认翻译公共部分 1. 调整`getPage`函数, 使`ClassName匹配规则`优先 1. 优化`translate`函数, 跳过`不存在英文字母和符号,.`, 保留首尾空白部分等 1. 部分函数重命名，使用`es6`新语法 1. 日常更新词库和忽略规则，修复一个`JS 选择器规则` ### 2022-05-12 13:53:46 更新至 1.7.6 1. 日常更新词库和忽略规则 1. 添加手动开启/禁用正则翻译，添加切换菜单 1. 优化翻译文本函数：避免已翻译词汇二次匹配，提高效率；局部翻译优先于全局 ### 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] 希望大家依据许可证使用 ### 2021-10-31 21:49:00 正式发布 1.7.0 版本 ### 2021-10-07 13:16:16 原作者[楼教主](https://github.com/52cik/github-hans)已停止维护多年，且近年来 GitHub 页面结构的变化，导致原有的脚本无法正常工作。虽然 GitHub 在被微软售收购比较重视国际化，启动并基本完成了GitHub 文档的中文化。但是，关于 GitHub 页面的中文化暂时还没启动。对于，新手使用和高阶使用仍会存在一定的障碍。故，本人依据个人兴趣暂时进行了一定的修复和维护。本次维护基本恢复和保留大部分功能如：页面正则翻译（含日期的正则）。页面词条可能被我切得太碎不方便后期维护（先这样吧！）