Home

Awesome

GitHub 中文化插件

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

繁體中文用戶請前往zh-TW 分支

GitHub issues GitHub stars GitHub forks license GPL-3.0 GreasyFork installs

<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="Featured|HelloGitHub" src="https://api.hellogithub.com/v1/widgets/recommend.svg?rid=738d0abae49543f18d887a7e29ec9e90&claim_uid=zepvSg6Vwl4EqMr&theme=neutral" style="width: 250px; height: 54px;" /> </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="Star History Chart" src="https://api.star-history.com/svg?repos=maboloshi/github-chinese&type=Timeline" width="75%" /> </picture> </a>

🚩 功能

🌐 浏览器与脚本管理器

浏览器脚本管理器
Chrome 或 基于 Chromium 内核的浏览器TampermonkeyViolentmonkey
Safari 浏览器(macOS, iOS, iPadOS)MacaqueStay
Firefox 或 基于 Gecko 内核的浏览器TampermonkeyViolentmonkey
Via 浏览器(Android)浏览器内自带

💽 安装

  1. 安装用户脚本管理器。
  2. 然后再点击链接之一,安装脚本即可。
  3. 刷新下页面,即可发现网站已中文化。

[!NOTE]

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

    注意:

    • 如果版本号未更新,即使内容已更新,用户脚本管理器仍会忽略这些更新,需要手动安装以获取最新内容。
  2. 发布版: 日常功能被冻结(除非由项目所有者进行更新)。通常在开发版词库版本号更新后的下周一凌晨,自动同步上一开发版的词库文件。通常情况下,发布版开发版之间会存在一周的时间差。

[!TIP]

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

[!IMPORTANT]

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

这是由于 Chrome 127 及更高版本逐步切换到 Manifest V3。目前已知脚本管理器 Tampermonkey 5.2.0 及以上版本能够完美支持,而其他脚本管理器(如 Violentmonkey 等)可能无法正常运行此脚本。如果您使用的是其他脚本管理器,建议您改用支持 Manifest V3 的脚本管理器,或者将浏览器版本退回,等待相关脚本管理器开发者更新,或改用 Firefox 浏览器。详情请参阅 #234 讨论。

解决方案:

  1. 安装 Tampermonkey 5.2.0 或更高版本。
  2. 在浏览器的 “扩展程序” 管理中开启 “开发者模式”。

词库本地调试方法

  1. 安装用户脚本管理器 Tampermonkey
  2. 在浏览器扩展管理中,开启 Tampermonkey 的 “允许访问文件网址”。
  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%E9%A1%B9%E7%9B%AE/github-chinese/locals.js

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

📝 更新说明

2024-08-18 16:44:24

更新至 1.9.3

  1. 新增功能:通过设置中文环境,自动本地化时间元素,仅保留on开头的时间正则,并停用时间元素监视
  2. 优化突变翻译处理:
    • 引入characterDataPage规则,对特定页面启用筛选字符数据的变更
    • 引入ignoreMutationSelectorPage规则,忽略特定突变元素
  3. 合并reIgnoreClass,reIgnoreItemprop,ignoreId,ignoreTagignoreSelectorPage规则,处理全局及特定页面,忽略特定元素
  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.9.0: 主版本号(由项目所有者更新)

  1. 重新定义版本号规则, 如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. 直接使用网页URLdocument.URL变化触发标题翻译JS 筛选器翻译
  3. 修复关闭正则无法生效, 需要刷新页面才生效
  4. 日常更新词库和忽略规则
  5. 更新JS 筛选器规则

2022-06-29 13:27:12

更新至 1.7.8

  1. 紧急修复: GitHub 变更了document.bodytitle更新机制, 导致原有的监测更新规则部分失效, 目前使用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://raw.githubusercontent.com/maboloshi/github-chinese/gh-pages/preview/img1.png"/> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/maboloshi/github-chinese/gh-pages/preview/img3.png"/> <img src="https://raw.githubusercontent.com/maboloshi/github-chinese/gh-pages/preview/img1.png" width="75%" /> </picture> <picture> <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/maboloshi/github-chinese/gh-pages/preview/img2.png"/> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/maboloshi/github-chinese/gh-pages/preview/img4.png"/> <img src="https://raw.githubusercontent.com/maboloshi/github-chinese/gh-pages/preview/img2.png" width="75%" /> </picture> <details> <summary><h2>🎁 打赏</h2></summary>

<img src="https://cdn.jsdelivr.net/gh/maboloshi/maboloshi/img/weixin.jpg" alt="微信赞赏" width="30%"> <img src="https://cdn.jsdelivr.net/gh/maboloshi/maboloshi/img/alipay.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 自动生成