-
Notifications
You must be signed in to change notification settings - Fork 374
/
main.user.js
505 lines (440 loc) · 20.2 KB
/
main.user.js
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
// ==UserScript==
// @name GitHub 中文化插件
// @namespace https://github.com/maboloshi/github-chinese
// @description 中文化 GitHub 界面的部分菜单及内容。原作者为楼教主(http://www.52cik.com/)。
// @copyright 2021, 沙漠之子 (https://maboloshi.github.io/Blog)
// @icon https://github.githubassets.com/pinned-octocat.svg
// @version 1.9.3-2024-12-15
// @author 沙漠之子
// @license GPL-3.0
// @match https://github.com/*
// @match https://skills.github.com/*
// @match https://gist.github.com/*
// @match https://www.githubstatus.com/*
// @require https://raw.githubusercontent.com/maboloshi/github-chinese/gh-pages/locals.js?v1.9.3-2024-12-15
// @run-at document-start
// @grant GM_xmlhttpRequest
// @grant GM_getValue
// @grant GM_setValue
// @grant GM_registerMenuCommand
// @grant GM_unregisterMenuCommand
// @grant GM_notification
// @connect fanyi.iflyrec.com
// @supportURL https://github.com/maboloshi/github-chinese/issues
// ==/UserScript==
(function (window, document, undefined) {
'use strict';
const lang = 'zh-CN'; // 设置默认语言
let enable_RegExp = GM_getValue("enable_RegExp", 1),
page = false,
cachedPage = null,
characterData = null,
ignoreMutationSelectors = [],
ignoreSelectors = [],
tranSelectors = [],
regexpRules = [];
function updateConfig(page) {
if (cachedPage !== page && page) {
cachedPage = page;
const { characterDataPage, ignoreMutationSelectorPage, ignoreSelectorPage } = I18N.conf;
characterData = characterDataPage.includes(page);
// 忽略突变元素选择器
ignoreMutationSelectors = ignoreMutationSelectorPage['*'].concat(ignoreMutationSelectorPage[page] || []);
// 忽略元素选择器
ignoreSelectors = ignoreSelectorPage['*'].concat(ignoreSelectorPage[page] || []);
// 通过 CSS 选择器翻译的规则
tranSelectors = (I18N[lang][page]?.selector || []).concat(I18N[lang]['public'].selector || []);
// 正则词条
regexpRules = (I18N[lang][page].regexp || []).concat(I18N[lang]['public'].regexp || []);
}
}
function initPage() {
const page = getPage();
updateConfig(page);
return page;
}
/**
* watchUpdate 函数:监视页面变化,根据变化的节点进行翻译
*/
function watchUpdate() {
// 检测浏览器是否支持 MutationObserver
const MutationObserver =
window.MutationObserver ||
window.WebKitMutationObserver ||
window.MozMutationObserver;
// 缓存当前页面的 URL
let previousURL = location.href;
// 监听 document.body 下 DOM 变化,用于处理节点变化
new MutationObserver(mutations => {
const currentURL = location.href;
// 如果页面的 URL 发生变化
if (currentURL !== previousURL) {
previousURL = currentURL;
page = initPage();
console.log(`DOM变化触发: 链接变化 page= ${page}`);
}
if (page) {
// 使用 mutations.flatMap 进行筛选突变:
// 1. 针对`节点增加`突变,后期迭代翻译的对象调整为`addedNodes`中记录的新增节点,而不是`target`,此举大幅减少重复迭代翻译
// 2. 对于其它`属性`和特定页面`文本节点`突变,仍旧直接处理`target`
// 3. 使用`nodes.filter()`筛选丢弃特定页面`特定忽略元素`内突变的节点
const filteredMutations = mutations.flatMap(({ target, addedNodes, type }) => {
let nodes = [];
if (type === 'childList' && addedNodes.length > 0) {
nodes = Array.from(addedNodes); // 将新增节点转换为数组
} else if (type === 'attributes' || (characterData && type === 'characterData')) {
nodes = [target]; // 否则,仅处理目标节点
}
// 对每个节点进行筛选,忽略特定选择器
return nodes.filter(node =>
!ignoreMutationSelectors.some(selector => node.parentElement?.closest(selector))
);
});
// 处理每个变化
filteredMutations.forEach(node => traverseNode(node));
}
}).observe(document.body, {
characterData: true,
subtree: true,
childList: true,
attributeFilter: ['value', 'placeholder', 'aria-label', 'data-confirm'], // 仅观察特定属性变化
});
}
/**
* traverseNode 函数:遍历指定的节点,并对节点进行翻译。
* @param {Node} node - 需要遍历的节点。
*/
function traverseNode(node) {
// 跳过忽略的节点
const skipNode = node => ignoreSelectors.some(selector => node.matches?.(selector));
if (skipNode(node)) return;
if (node.nodeType === Node.ELEMENT_NODE) { // 元素节点处理
// 处理不同标签的元素属性翻译
switch (node.tagName) {
case "RELATIVE-TIME": // 翻译时间元素
transTimeElement(node.shadowRoot);
watchTimeElement(node.shadowRoot);
return;
case "INPUT":
case "TEXTAREA": // 输入框 按钮 文本域
if (['button', 'submit', 'reset'].includes(node.type)) {
transElement(node.dataset, 'confirm'); // 翻译 浏览器 提示对话框
transElement(node, 'value');
} else {
transElement(node, 'placeholder');
}
break;
case "BUTTON":
if (/tooltipped/.test(node.className)) transElement(node, 'ariaLabel'); // 翻译 浏览器 提示对话框
transElement(node, 'title'); // 翻译 浏览器 提示对话框
transElement(node.dataset, 'confirm'); // 翻译 浏览器 提示对话框 ok
transElement(node.dataset, 'confirmText'); // 翻译 浏览器 提示对话框 ok
transElement(node.dataset, 'confirmCancelText'); // 取消按钮 提醒
transElement(node, 'cancelConfirmText'); // 取消按钮 提醒
transElement(node.dataset, 'disableWith'); // 按钮等待提示
break;
case "OPTGROUP":
transElement(node, 'label'); // 翻译 <optgroup> 的 label 属性
break;
case "A":
transElement(node, 'title'); // title 属性
break;
case "SPAN":
transElement(node, 'title'); // title 属性
transElement(node, 'ariaLabel');
break;
default:
// 仅当 元素存在'tooltipped'样式 aria-label 才起效果
if (/tooltipped/.test(node.className)) transElement(node, 'ariaLabel'); // 带提示的元素,类似 tooltip 效果的
}
node.childNodes.forEach(child => traverseNode(child)); // 遍历子节点
} else if (node.nodeType === Node.TEXT_NODE && node.length <= 500) { // 文本节点且长度小于等于 500
transElement(node, 'data');
}
}
/**
* getPage 函数:获取页面的类型。
* @param {URL object} URL - 需要分析的 URL。
* @returns {string|boolean} 页面的类型,如果无法确定类型,那么返回 false。
*/
function getPage(url = window.location) {
// 站点映射
const siteMapping = {
'gist.github.com': 'gist',
'www.githubstatus.com': 'status',
'skills.github.com': 'skills'
};
const site = siteMapping[url.hostname] || 'github';
const pathname = url.pathname;
// 是否登录
const isLogin = document.body.classList.contains("logged-in");
// 获取 analytics-location
const analyticsLocation = document.head.querySelector('meta[name="analytics-location"]')?.content || '';
// 判断页面类型
const isOrganization = /\/<org-login>/.test(analyticsLocation) || /^\/(?:orgs|organizations)/.test(pathname);
const isRepository = /\/<user-name>\/<repo-name>/.test(analyticsLocation);
const isProfile = document.body.classList.contains("page-profile") || analyticsLocation === '/<user-name>';
const isSession = document.body.classList.contains("session-authentication");
const { rePagePathRepo, rePagePathOrg, rePagePath } = I18N.conf;
let t, page = false;
if (isSession) {
page = 'session-authentication';
} else if (site === 'gist' || site === 'status' || site === 'skills') {
page = site;
} else if (isProfile) {
t = url.search.match(/tab=([^&]+)/);
page = t ? 'page-profile/' + t[1] : pathname.includes('/stars') ? 'page-profile/stars' : 'page-profile';
} else if (pathname === '/' && site === 'github') {
page = isLogin ? 'page-dashboard' : 'homepage';
} else if (isRepository) {
t = pathname.match(rePagePathRepo);
page = t ? 'repository/' + t[1] : 'repository';
} else if (isOrganization) {
t = pathname.match(rePagePathOrg);
page = t ? 'orgs/' + (t[1] || t.slice(-1)[0]) : 'orgs';
} else {
t = pathname.match(rePagePath);
page = t ? (t[1] || t.slice(-1)[0]) : false;
}
if (!page || !I18N[lang][page]) {
console.log(`请注意对应 page ${page} 词库节点不存在`);
page = false;
}
return page;
}
/**
* transTitle 函数:翻译页面标题
*/
function transTitle() {
const text = document.title; // 获取标题文本内容
let translatedText = I18N[lang]['title']['static'][text] || '';
if (!translatedText) {
const res = I18N[lang]['title'].regexp || [];
for (let [a, b] of res) {
translatedText = text.replace(a, b);
if (translatedText !== text) break;
}
}
document.title = translatedText;
}
/**
* transTimeElement 函数:翻译时间元素文本内容。
* @param {Element} el - 需要翻译的元素。
*/
function transTimeElement(el) {
const text = el.childNodes.length > 0 ? el.lastChild.textContent : el.textContent;
const translatedText = text.replace(/^on/, "");
if (translatedText !== text) {
el.textContent = translatedText;
}
}
/**
* watchTimeElement 函数:监视时间元素变化, 触发和调用时间元素翻译
* @param {Element} el - 需要监视的元素。
*/
function watchTimeElement(el) {
const MutationObserver =
window.MutationObserver ||
window.WebKitMutationObserver ||
window.MozMutationObserver;
new MutationObserver(mutations => {
transTimeElement(mutations[0].addedNodes[0]);
}).observe(el, {
childList: true
});
}
/**
* transElement 函数:翻译指定元素的文本内容或属性。
* @param {Element|DOMStringMap} el - 需要翻译的元素或元素的数据集 (node.dataset)。
* @param {string} field - 需要翻译的属性名称或文本内容字段。
*/
function transElement(el, field) {
const text = el[field]; // 获取需要翻译的文本
if (!text) return false; // 当 text 为空时,退出函数
const translatedText = transText(text); // 翻译后的文本
if (translatedText) {
el[field] = translatedText; // 替换翻译后的内容
}
}
/**
* transText 函数:翻译文本内容。
* @param {string} text - 需要翻译的文本内容。
* @returns {string|boolean} 翻译后的文本内容,如果没有找到对应的翻译,那么返回 false。
*/
function transText(text) {
// 判断是否需要跳过翻译
// 1. 检查内容是否为空或者仅包含空白字符或数字。
// 2. 检查内容是否仅包含中文字符。
// 3. 检查内容是否不包含英文字母和符号。
const shouldSkip = text => /^[\s0-9]*$/.test(text) || /^[\u4e00-\u9fa5]+$/.test(text) || !/[a-zA-Z,.]/.test(text);
if (shouldSkip(text)) return false;
// 清理文本内容
const trimmedText = text.trim(); // 去除首尾空格
const cleanedText = trimmedText.replace(/\xa0|[\s]+/g, ' '); // 去除多余空白字符(包括 空格 换行符)
// 尝试获取翻译结果
const translatedText = fetchTranslatedText(cleanedText);
// 如果找到翻译并且不与清理后的文本相同,则返回替换后的结果
if (translatedText && translatedText !== cleanedText) {
return text.replace(trimmedText, translatedText); // 替换原字符,保留首尾空白部分
}
return false;
}
/**
* fetchTranslatedText 函数:从特定页面的词库中获得翻译文本内容。
* @param {string} text - 需要翻译的文本内容。
* @returns {string|boolean} 翻译后的文本内容,如果没有找到对应的翻译,那么返回 false。
*/
function fetchTranslatedText(text) {
// 静态翻译
let translatedText = I18N[lang][page]['static'][text] || I18N[lang]['public']['static'][text]; // 默认翻译 公共部分
if (typeof translatedText === 'string') {
return translatedText;
}
// 正则翻译
if (enable_RegExp) {
for (let [a, b] of regexpRules) {
translatedText = text.replace(a, b);
if (translatedText !== text) {
return translatedText;
}
}
}
return false; // 没有翻译条目
}
/**
* transDesc 函数:为指定的元素添加一个翻译按钮,并为该按钮添加点击事件。
* @param {string} selector - CSS选择器,用于选择需要添加翻译按钮的元素。
*/
function transDesc(selector) {
// 使用 CSS 选择器选择元素
const element = document.querySelector(selector);
// 如果元素不存在 或者 translate-me 元素已存在,那么直接返回
if (!element || document.getElementById('translate-me')) return false;
// 在元素后面插入一个翻译按钮
const buttonHTML = `<div id='translate-me' style='color: rgb(27, 149, 224); font-size: small; cursor: pointer'>翻译</div>`;
element.insertAdjacentHTML('afterend', buttonHTML);
const button = element.nextSibling;
// 为翻译按钮添加点击事件
button.addEventListener('click', () => {
// 获取元素的文本内容
const descText = element.textContent.trim();
// 如果文本内容为空,那么直接返回
if (!descText) return false;
// 调用 transDescText 函数进行翻译
transDescText(descText, translatedText => {
// 翻译完成后,隐藏翻译按钮,并在元素后面插入翻译结果
button.style.display = "none";
const translatedHTML = `<span style='font-size: small'>由 <a target='_blank' style='color:rgb(27, 149, 224);' href='https://fanyi.iflyrec.com/text-translate'>讯飞听见</a> 翻译👇</span><br/>${translatedText}`;
element.insertAdjacentHTML('afterend', translatedHTML);
});
});
}
/**
* transDescText 函数:将指定的文本发送到讯飞的翻译服务进行翻译。
* @param {string} text - 需要翻译的文本。
* @param {function} callback - 翻译完成后的回调函数,该函数接受一个参数,即翻译后的文本。
*/
function transDescText(text, callback) {
// 使用 GM_xmlhttpRequest 函数发送 HTTP 请求
GM_xmlhttpRequest({
method: "POST", // 请求方法为 POST
url: "https://fanyi.iflyrec.com/TJHZTranslationService/v2/textAutoTranslation", // 请求的 URL
headers: { // 请求头
'Content-Type': 'application/json',
'Origin': 'https://fanyi.iflyrec.com',
},
data: JSON.stringify({
"from": 2,
"to": 1,
"type": 1,
"contents": [{
"text": text
}]
}), // 请求的数据
responseType: "json", // 响应的数据类型为 JSON
onload: (res) => {
try {
const { status, response } = res;
const translatedText = (status === 200) ? response.biz[0].sectionResult[0].dst : "翻译失败";
callback(translatedText);
} catch (error) {
console.error('翻译失败', error);
callback("翻译失败");
}
},
onerror: (error) => {
console.error('网络请求失败', error);
callback("网络请求失败");
}
});
}
/**
* transBySelector 函数:通过 CSS 选择器找到页面上的元素,并将其文本内容替换为预定义的翻译。
*/
function transBySelector() {
if (tranSelectors.length > 0) {
// 遍历每个翻译规则
for (let [selector, translatedText] of tranSelectors) {
// 使用 CSS 选择器找到对应的元素
const element = document.querySelector(selector);
// 如果找到了元素,那么将其文本内容替换为翻译后的文本
if (element) {
element.textContent = translatedText;
}
}
}
}
/**
* registerMenuCommand 函数:注册菜单。
*/
function registerMenuCommand() {
const toggleRegExp = () => {
enable_RegExp = !enable_RegExp;
GM_setValue("enable_RegExp", enable_RegExp);
GM_notification(`已${enable_RegExp ? '开启' : '关闭'}正则功能`);
if (enable_RegExp) {
location.reload();
}
GM_unregisterMenuCommand(id);
id = GM_registerMenuCommand(`${enable_RegExp ? '关闭' : '开启'}正则功能`, toggleRegExp);
};
let id = GM_registerMenuCommand(`${enable_RegExp ? '关闭' : '开启'}正则功能`, toggleRegExp);
}
/**
* init 函数:初始化翻译功能。
*/
function init() {
// 获取当前页面的翻译规则
page = initPage();
console.log(`开始page= ${page}`);
if (page) traverseNode(document.body);
// 监视页面变化
watchUpdate();
}
// 设置中文环境
document.documentElement.lang = lang;
// 监测 HTML Lang 值, 设置中文环境
new MutationObserver(mutations => {
if (document.documentElement.lang === "en") {
document.documentElement.lang = lang;
}
}).observe(document.documentElement, {
attributeFilter: ['lang']
});
// 监听 Turbo 完成事件
document.addEventListener('turbo:load', () => {
if (page) {
transTitle(); // 翻译页面标题
transBySelector();
if (page === "repository") { //仓库简介翻译
transDesc(".f4.my-3");
} else if (page === "gist") { // Gist 简介翻译
transDesc(".gist-content [itemprop='about']");
}
}
});
// 初始化菜单
registerMenuCommand();
// 在页面初始加载完成时执行
window.addEventListener('DOMContentLoaded', init);
})(window, document);