本项目源自: 52cik/github-hans
- 中文化 GitHub 菜单栏,标题,按钮等公共组件
- 保留、完善正则功能
- 支持对 “项目描述” 进行人机翻译 (参考: k1995/github-i18n-plugin)
浏览器 | 脚本管理器 |
---|---|
Chrome 或 基于 Chromium 内核的浏览器 | Tampermonkey 或 Violentmonkey |
Safari 浏览器(macOS, iOS, iPadOS) | Macaque 或 Stay |
Firefox 或 基于 Gecko 内核的浏览器 | Tampermonkey 或 Violentmonkey |
Via 浏览器(Android) | 浏览器内自带 |
- 安装用户脚本管理器。
- 然后再点击链接之一,安装脚本即可。
- 刷新下页面,即可发现网站已中文化。
Note
- 开发版:通常比发布版更早进入开发和测试阶段(重大版本更新前,还会专门创建新分支进行测试)。日常维护词库内容,并且词库版本号会在每周五凌晨自动更新。
注意:
- 如果版本号未更新,即使内容已更新,用户脚本管理器仍会忽略这些更新,需要手动安装以获取最新内容。
- 发布版: 日常功能被冻结(除非由项目所有者进行更新)。通常在开发版词库版本号更新后的下周一凌晨,自动同步上一开发版的词库文件。通常情况下,发布版与开发版之间会存在一周的时间差。
Tip
- 需要视频教程的可以去看看【这里】收录的一些视频
Important
这是由于 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
直接将词库文件拖到浏览器的地址栏,再复制地址栏的中地址即可。
更新至 1.9.3
- 新增功能:通过设置中文环境,自动本地化时间元素,仅保留
on
开头的时间正则,并停用时间元素监视 - 优化突变翻译处理:
- 引入
characterDataPage
规则,对特定页面启用筛选字符数据
的变更 - 引入
ignoreMutationSelectorPage
规则,忽略特定突变元素
- 引入
- 合并
reIgnoreClass,reIgnoreItemprop,ignoreId,ignoreTag
为ignoreSelectorPage
规则,处理全局及特定页面,忽略特定元素 - 引入全局缓存模式,减少重复构建包括不限于基于
page
变化的忽略规则、正则规则数组等 - 调整:更新讯飞听见翻译引擎v2.0
- 优化:梳理、优化脚本
- 调整:调整词库语言代码为
zh-CN
, 与环境语言设置一致
更新至 1.9.2
- 适配
www.githubstatus.com
- 适配
skills.github.com
更新至 1.9.1
- 更新
切换正则功能按钮
更新至 1.9.0
其中,
1.9.0
: 主版本号(由项目所有者更新)
- 重新定义版本号规则, 如
1.9.0-2023-12-09
- 加强: GitHub 托管【开发版】每周一凌晨自动更新
词库
发布版本号 - 加强: GreasyFork 托管【发布版】每周五凌晨自动更新
词库
发布版本号, 词库内容同上一次GitHub 托管【开发版】 - 加强:在
README.md
中自动更新贡献者头像 - 更新: 忽略规则, 词条等
更新至 1.8.5
- 优化:
transDesc 函数
代码 - 修复: 重复添加
translate-me
翻译按钮 - 加强:
watchUpdate 函数
新增节点文本更新的情况 - 调整:
transBySelector和transDesc函数
延迟执行时间 - 更新: 忽略规则, 词条等
更新至 1.8.4
- 修复:
Itemprop
过滤规则, 依然使用正则方式 - 修复:
tooltipped
样式提示, 依然使用正则方式
更新至 1.8.3
- 梳理、优化脚本
- 更新: 忽略规则, 大量词条等
更新至 1.8.2
greasyfork 托管
源切换到按页面精细化词条模式
- 调整词库格式
- 功能加强: 优化
元素筛选器
翻译逻辑 - 更新: 忽略规则, 大量词条等
更新至 1.8.1
- 修复: #8 与 dark reader 扩展发生冲突,导致时间显示出现问题
GitHub
源开始切换到按页面精细化词条模式(开发版)
, 词库未完全迁移适配- 停止
greasyfork
源词库文件的同步更新
更新至 1.8.0
- 删除:
TURBO-FRAME
框架处理代码. Github 已调整新动态加载模式, 直接检测url
的变化就能获取对应的page
信息 - 新增: 支持时间元素的
Shadow DOM
翻译, 并监听变化 - 新增: 启用并更新
时间元素翻译
专项正则词条 - 新增: 仅当
page
有效才翻译页面 - 修复: 原
简介翻译
引擎GitHub中文社区
失效, 改为讯飞
引擎(测试) - 修复: 追加公共正则重复迭代的问题
- 修复: 正则标记变量
RegExp
与构造函数new RegExp
冲突 - 更新: 忽略规则, 词条等
预告, 下次将细化page
匹配规则, 导致词库文件结构大调整, 词库文件会适当变大, 页面正则更精细效率会提升
更新至 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 筛选器
规则
更新至 1.7.8
- 紧急修复: GitHub 变更了
document.body
和title
更新机制, 导致原有的监测更新
规则部分失效, 目前使用document.documentElement
监视整个页面 DOM 的变更 - 跳过
<HEAD>
标签 标题翻译
和JS 筛选器
翻译, 依据 URL变化更新
更新至 1.7.7
- 新增
时间元素翻译
功能 - 重写
页面标题翻译
函数 - 梳理
遍历节点
函数逻辑 - 优化
transPage
函数,默认翻译公共部分 - 调整
getPage
函数, 使ClassName匹配规则
优先 - 优化
translate
函数, 跳过不存在英文字母和符号,.
, 保留首尾空白部分等 - 部分函数重命名,使用
es6
新语法 - 日常更新词库和忽略规则,修复一个
JS 选择器规则
更新至 1.7.6
- 日常更新词库和忽略规则
- 添加手动开启/禁用正则翻译,添加切换菜单
- 优化翻译文本函数:避免已翻译词汇二次匹配,提高效率;局部翻译优先于全局
更新至 1.7.5
更新至 1.7.4
更新至 1.7.3
更新至 1.7.2
更新许可证为 GPL-3.0 希望大家依据许可证使用
正式发布 1.7.0 版本
原作者楼教主已停止维护多年,且近年来 GitHub 页面结构的变化,导致原有的脚本无法正常工作。
虽然 GitHub 在被微软售收购比较重视国际化,启动并基本完成了GitHub 文档的中文化。但是,关于 GitHub 页面的中文化暂时还没启动。
对于,新手使用和高阶使用仍会存在一定的障碍。故,本人依据个人兴趣暂时进行了一定的修复和维护。
本次维护基本恢复和保留大部分功能如:页面正则翻译(含日期的正则)。页面词条可能被我切得太碎不方便后期维护(先这样吧!)
- 添加 GitHub 名词解释,新手可能不太理解部分名词具体表达的意思,比如
pull request
。 - 整理部分 Git & GitHub 学习资料, 帮助新手更快上手。
- 本人英文渣渣,翻译非常困难,急需大家 PR 共同翻译
查看我们的贡献小技巧
目前已翻译大部分常用页面,欢迎补充完善,中文词条在locals.js
中。大家在补充完善的过程,请遵循以下文档对相关术语进行翻译:
maboloshi - 项目作者
wuyuncheng-26 - 项目协作者
52cik - 项目原作者
一如既往,感谢我们出色的贡献者❤️!
贡献者列表,由 GitHub Action 自动生成