[GitHub 中文化插件][project-url]
本项目源自: 52cik/github-hans
[![GitHub issues][issues-image]][issues-url]
[![GitHub stars][stars-image]][stars-url]
[![GitHub forks][forks-image]][forks-url]
[![license GPL-3.0][license-image]][license-url]
[![GreasyFork installs][greasyFork-image]][greasyFork-url]
</a>
💖 星标历史
</a>
🚩 功能
🌐 浏览器与脚本管理器
浏览器 |
脚本管理器 |
Chrome 或 基于 Chromium 内核的浏览器 |
[Tampermonkey][Tampermonkey], [Violentmonkey][Violentmonkey] |
Safari 浏览器 |
[Macaque][Macaque] |
Firefox 浏览器 |
未测试 |
💽 安装
- 请先安装用户脚本管理器。
- 然后再点击链接之一,安装脚本即可。
- [GitHub 中文化插件 - GitHub 托管【开发版】(相对及时更新)][main.user.js]
注意:
- 当版本号未更新的情况下, 即使内容已更新, 用户脚本管理器依然会忽略, 需要手动安装获取更新
- 目前, 已实现每周一凌晨自动更新开发版版本号
- [GitHub 中文化插件 - GreasyFork 托管【发布版】(仅大版本更新)][main(greasyfork).user.js]
- 刷新下页面,即可发现网站已中文化。
词库本地调试方法
- 需要安装插件管理器 [Tampermonkey][Tampermonkey],其他可能不支持。
-
在浏览器插件管理中,开启 [Tampermonkey][Tampermonkey] 的 “允许访问文件网址” 如图:
- 将修改的词库文件放到方便访问的本地位置。
- 安装 [GitHub 中文化插件 - GitHub 托管【开发版】(相对及时更新)][main.user.js],实际 [GitHub 中文化插件 - GreasyFork 托管【发布版】(仅大版本更新)][main(greasyfork).user.js] 也可。
- 回到插件管理器,修改词库文件路径,即类似
// @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]
直接将词库文件拖到浏览器的地址栏,再复制地址栏的中地址即可。
📝 更新说明
2023-12-09 20:46:16
更新至 1.9.0
- 重新定义版本号规则, 如
1.9.0-2023-12-09
其中, 1.9.0
: 主版本号(由项目所有者更新)
2023-12-09
:词库发布日期(手动或按周期自动发布)
- 加强: [GitHub 托管【开发版】][main.user.js]每周一凌晨自动更新
词库
发布版本号
- 加强: [GreasyFork 托管【发布版】][main(greasyfork).user.js]每周五凌晨自动更新
词库
发布版本号,
词库内容同上一次[GitHub 托管【开发版】][main.user.js]
- 加强:在
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 的变更
2. 跳过``标签
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][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 页面的中文化暂时还没启动。
对于,新手使用和高阶使用仍会存在一定的障碍。故,本人依据个人兴趣暂时进行了一定的修复和维护。
本次维护基本恢复和保留大部分功能如:页面正则翻译(含日期的正则)。页面词条可能被我切得太碎不方便后期维护(先这样吧!)
</details>
## ✔ 待办 (TODO)
1. 添加 GitHub 名词解释,新手可能不太理解部分名词具体表达的意思,比如 `pull request`。
2. 整理部分 [Git](https://git-scm.com/) & [GitHub](https://github.com/) 学习资料, 帮助新手**更快**上手。
3. **本人英文渣渣,翻译非常困难,急需大家 PR 共同翻译**
## ✨ 贡献
查看我们的[贡献小技巧](https://github.com/maboloshi/github-chinese/issues/52)
目前已翻译大部分常用页面,欢迎补充完善,中文词条在`locals.js`中。大家在补充完善的过程,请遵循以下文档对相关术语进行翻译:
### 相关概念及资料文档:
1. [Pro Git 第二版 简体中文](https://git-scm.com/book/zh/v2)
2. [Pro Git: 翻译约定](https://github.com/progit/progit2-zh/blob/master/TRANSLATION_NOTES.asc)
3. [Git 官方软件包的简体中文翻译](https://github.com/git/git/blob/master/po/zh_CN.po)
4. [GitHub 词汇表官方译本](https://docs.github.com/cn/get-started/quickstart/github-glossary)
## 🎨 预览
🎁 打赏
[project-url]: https://github.com/maboloshi/github-chinese "GitHub 中文化插件"
[issues-url]: https://github.com/maboloshi/github-chinese/issues "议题"
[issues-image]: https://img.shields.io/github/issues/maboloshi/github-chinese?style=flat-square&logo=github&label=Issue
[stars-url]: https://github.com/maboloshi/github-chinese/stargazers "星标"
[stars-image]: https://img.shields.io/github/stars/maboloshi/github-chinese?style=flat-square&logo=github&label=Star
[forks-url]: https://github.com/maboloshi/github-chinese/network "复刻"
[forks-image]: https://img.shields.io/github/forks/maboloshi/github-chinese?style=flat-square&logo=github&label=Fork
[license-url]: https://opensource.org/licenses/GPL-3.0 "许可证"
[license-image]: https://img.shields.io/github/license/maboloshi/github-chinese?style=flat-square&logo=github&label=License
[greasyFork-url]: https://greasyfork.org/scripts/435208 "GreasyFork - GitHub 中文化插件"
[greasyFork-image]: https://img.shields.io/badge/dynamic/json?style=flat-square&label=GreasyFork&query=total_installs&suffix=%20installs&url=https://greasyfork.org/scripts/435208.json
[Tampermonkey]: http://tampermonkey.net/ "篡改猴"
[Violentmonkey]: https://violentmonkey.github.io/ "暴力猴"
[Macaque]: https://macaque.app/ "猕猴"
[main.user.js]: https://github.com/maboloshi/github-chinese/raw/gh-pages/main.user.js "GitHub 中文化插件 - GitHub 托管"
[main(greasyfork).user.js]: https://greasyfork.org/scripts/435208-github-%E4%B8%AD%E6%96%87%E5%8C%96%E6%8F%92%E4%BB%B6/code/GitHub%20%E4%B8%AD%E6%96%87%E5%8C%96%E6%8F%92%E4%BB%B6.user.js "GitHub 中文化插件 - GreasyFork 托管"
## 💝 鸣谢
[maboloshi](https://github.com/maboloshi) - 项目作者
[wuyuncheng-26](https://github.com/wuyuncheng-26) - 项目协作者
[52cik](https://github.com/52cik) - 项目原作者
### 感谢所有贡献者
一如既往,感谢我们出色的贡献者❤️!
贡献者列表,由 [GitHub Action](https://github.com/maboloshi/github-chinese/blob/gh-pages/.github/workflows/update_contributors_images.yml) 自动生成