Localizes GitHub websites into Russian
// ==UserScript==
// @name GitHub Russian Localization
// @name:ru Русская локализация GitHub
// @author Deflecat
// @contributionURL https://boosty.to/rushanm
// @description Localizes GitHub websites into Russian
// @description:ru Локализует сайты GitHub на русский язык
// @grant none
// @homepageURL https://github.com/RushanM/GitHub-Russian-Localization
// @icon https://github.githubassets.com/favicons/favicon.png
// @license MIT
// @match https://*.github.com/*
// @match https://education.github.com/*
// @match https://github.blog/*
// @match https://github.com/*
// @run-at document-end
// @namespace githubrussianlocalization
// @supportURL https://github.com/RushanM/GitHub-Russian-Localization/issues
// @version P37
// ==/UserScript==
(function() {
'use strict';
// ссылка на локализационный файл формата FTL l10n/ru.ftl в репозитории
const FTL_URL = 'https://raw.githubusercontent.com/RushanM/GitHub-Russian-Localization/master/l10n/ru.ftl';
const LOG_PREFIX = '[GHRL10N]';
/**
* синтаксический анализатор FTL
* считывает сообщения в формате «ключ = значение»
*/
class SimpleFTLParser {
constructor(ftlContent) {
this.messages = new Map();
this.parse(ftlContent);
}
parse(content) {
const lines = content.split('\n');
for (let line of lines) {
line = line.trim();
// пропуск комментариев и пустых строк
if (!line || line.startsWith('#') || line.startsWith('##')) {
continue;
}
// считывание сообщений формата «ключ = значение»
const match = line.match(/^([a-zA-Z0-9-_]+)\s*=\s*(.+)$/);
if (match) {
const [, key, value] = match;
this.messages.set(key, value);
}
}
}
getMessage(key) {
return this.messages.get(key) || null;
}
hasMessage(key) {
return this.messages.has(key);
}
}
/**
* локализация Гитхаба
*/
class GitHubLocalizer {
constructor(ftlContent) {
this.parser = new SimpleFTLParser(ftlContent);
this.observer = null;
this.protectedElements = new Map(); // элементы под защитой от изменений
console.info(`${LOG_PREFIX} Localizer initialized with ${this.parser.messages.size} messages.`);
}
getTranslation(key, fallback = null) {
const message = this.parser.getMessage(key);
return message != null ? message : fallback;
}
/**
* локализация элемента по его текстовому содержимому
*/
localizeByText(element, originalText, messageKey) {
if (!element || !element.textContent) return false;
const currentText = element.textContent.trim();
// получение локализации
const translation = this.getTranslation(messageKey);
if (!translation) return false;
// если текст уже переведён, добавляем защиту и пропускаем
if (currentText === translation) {
this.protectElement(element, translation);
return false;
}
// если текст не совпадает с оригиналом, пропускаем
if (currentText !== originalText) return false;
// переводим
element.textContent = translation;
element.setAttribute('data-ru-localized', 'true');
// защищаем элемент от изменений
this.protectElement(element, translation);
return true;
}
/**
* локализация элемента БЕЗ защиты от изменений
* используется для элементов, которые могут динамически меняться (например, Ask/Task)
*/
localizeByTextDynamic(element, translations) {
if (!element || !element.textContent) return false;
const currentText = element.textContent.trim();
// проверяем каждую пару оригинал → перевод
for (const { original, key } of translations) {
const translation = this.getTranslation(key);
if (!translation) continue;
// если текст уже переведён, пропускаем
if (currentText === translation) return false;
// если текст совпадает с оригиналом, переводим
if (currentText === original) {
element.textContent = translation;
return true;
}
}
return false;
}
/**
* защита элемента от изменения текста обратно на английский
*/
protectElement(element, translatedText) {
// если элемент уже под защитой, пропускаем
if (this.protectedElements.has(element)) return;
// создание наблюдателя для этого элемента
const protectionObserver = new MutationObserver((mutations) => {
for (let mutation of mutations) {
if (mutation.type === 'characterData' || mutation.type === 'childList') {
const currentText = element.textContent.trim();
// если текст изменился с перевода на что-то другое
if (currentText !== translatedText) {
// немедленно восстанавливаем перевод
element.textContent = translatedText;
}
}
}
});
// наблюдение за изменениями текста и дочерних элементов
protectionObserver.observe(element, {
characterData: true,
childList: true,
subtree: true
});
// сохранение наблюдателя
this.protectedElements.set(element, {
observer: protectionObserver,
translation: translatedText
});
}
/**
* локализация хлебной крошки Dashboard
*/
localizeDashboard() {
// старый селектор
const dashboardElements = document.querySelectorAll('.AppHeader-context-item-label');
dashboardElements.forEach(el => {
this.localizeByText(el, 'Dashboard', 'dashboard');
});
// новый селектор для хлебных крошек
const breadcrumbElements = document.querySelectorAll('.styles-module__contextCrumbLast__cE7QReI');
breadcrumbElements.forEach(el => {
this.localizeByText(el, 'Dashboard', 'dashboard');
});
}
normalizeSearchPlaceholderText(translation) {
if (typeof translation !== 'string') {
return null;
}
if (!translation.includes('{{kbd}}')) {
return translation.replace(/\s+/g, ' ').trim();
}
const normalized = translation.replace('{{kbd}}', '/');
return normalized.replace(/\s+/g, ' ').trim();
}
renderSearchPlaceholder(target, translation) {
if (!target || typeof translation !== 'string') {
return;
}
if (!translation.includes('{{kbd}}')) {
target.textContent = translation;
return;
}
const [beforeKbd, afterKbd] = translation.split('{{kbd}}');
const existingKbd = target.querySelector('kbd');
const kbdElement = existingKbd ?? (() => {
const newKbd = document.createElement('kbd');
newKbd.className = 'AppHeader-search-kbd';
newKbd.textContent = '/';
return newKbd;
})();
const fragment = document.createDocumentFragment();
fragment.appendChild(document.createTextNode(beforeKbd ?? ''));
fragment.appendChild(kbdElement);
fragment.appendChild(document.createTextNode(typeof afterKbd === 'string' ? afterKbd : ''));
target.replaceChildren(fragment);
}
resolveKbdElement(identifier, kbdMap) {
if (!(kbdMap instanceof Map) || kbdMap.size === 0) {
return null;
}
const normalized = (identifier ?? '').trim();
if (!normalized) {
const firstEntry = kbdMap.entries().next();
if (!firstEntry.done) {
const [firstKey, element] = firstEntry.value;
kbdMap.delete(firstKey);
return element;
}
return null;
}
if (kbdMap.has(normalized)) {
const element = kbdMap.get(normalized);
kbdMap.delete(normalized);
return element;
}
const lower = normalized.toLowerCase();
for (const [key, element] of kbdMap.entries()) {
if (key.trim().toLowerCase() === lower) {
kbdMap.delete(key);
return element;
}
}
const fallback = kbdMap.entries().next();
if (!fallback.done) {
const [fallbackKey, element] = fallback.value;
kbdMap.delete(fallbackKey);
return element;
}
return null;
}
createFragmentFromKbdTranslation(translation, kbdElements) {
if (typeof translation !== 'string') {
return null;
}
const fragment = document.createDocumentFragment();
const map = kbdElements instanceof Map
? new Map(kbdElements)
: new Map(Array.isArray(kbdElements) ? kbdElements : []);
const regex = /\[kbd\](.*?)\[\/kbd\]/g;
let lastIndex = 0;
let match;
let hasPlaceholders = false;
while ((match = regex.exec(translation)) !== null) {
hasPlaceholders = true;
const textPart = translation.slice(lastIndex, match.index);
if (textPart) {
fragment.appendChild(document.createTextNode(textPart));
}
const placeholderContent = match[1] ?? '';
const kbdElement = this.resolveKbdElement(placeholderContent, map);
if (kbdElement) {
const displayText = placeholderContent.trim();
if (displayText) {
kbdElement.textContent = displayText;
}
fragment.appendChild(kbdElement);
} else if (placeholderContent) {
fragment.appendChild(document.createTextNode(placeholderContent));
}
lastIndex = regex.lastIndex;
}
if (!hasPlaceholders) {
fragment.appendChild(document.createTextNode(translation));
return fragment;
}
const remainder = translation.slice(lastIndex);
if (remainder) {
fragment.appendChild(document.createTextNode(remainder));
}
return fragment;
}
replaceContentWithKbdTranslation(target, translationKey, kbdElements) {
if (!target) {
return false;
}
const translation = this.getTranslation(translationKey);
if (!translation) {
return false;
}
const fragment = this.createFragmentFromKbdTranslation(translation, kbdElements);
if (!fragment) {
return false;
}
target.replaceChildren(fragment);
target.setAttribute('data-ru-localized', 'true');
return true;
}
/**
* локализация поисковой строки «Type / to search»
*/
localizeSearchPlaceholder() {
// новый селектор для поисковой строки в шапке
const searchPlaceholder = document.querySelector('.Search-module__placeholder__Ke68F3b');
if (searchPlaceholder) {
const translation = this.getTranslation('type-slash-to-search');
if (translation) {
const currentText = searchPlaceholder.textContent.replace(/\s+/g, ' ').trim();
const hasOriginalText = currentText.includes('Type') && currentText.includes('to search');
const normalizedTranslation = this.normalizeSearchPlaceholderText(translation);
if (searchPlaceholder.getAttribute('data-ru-localized') === 'true') {
if (hasOriginalText || !searchPlaceholder.querySelector('kbd')) {
this.renderSearchPlaceholder(searchPlaceholder, translation);
}
return;
}
if (hasOriginalText) {
this.renderSearchPlaceholder(searchPlaceholder, translation);
searchPlaceholder.setAttribute('data-ru-localized', 'true');
}
}
return;
}
// старый селектор (для совместимости)
const searchInput = document.querySelector('#qb-input-query');
if (!searchInput) return;
const translation = this.getTranslation('type-slash-to-search');
if (!translation) return;
const normalizedTranslation = this.normalizeSearchPlaceholderText(translation);
if (!normalizedTranslation) {
return;
}
const currentText = searchInput.textContent.replace(/\s+/g, ' ').trim();
const hasOriginalText = currentText.includes('Type') && currentText.includes('to search');
if (searchInput.getAttribute('data-ru-localized') === 'true') {
if (!currentText || currentText !== normalizedTranslation || (translation.includes('{{kbd}}') && !searchInput.querySelector('kbd'))) {
this.renderSearchPlaceholder(searchInput, translation);
}
this.protectSearchElement(searchInput, translation, normalizedTranslation);
return;
}
if (!hasOriginalText) {
return;
}
this.renderSearchPlaceholder(searchInput, translation);
searchInput.setAttribute('data-ru-localized', 'true');
this.protectSearchElement(searchInput, translation, normalizedTranslation);
}
/**
* защита поискового элемента
*/
protectSearchElement(element, translation, normalizedTranslation = null) {
if (this.protectedElements.has(element)) return;
const expectedText = normalizedTranslation ?? this.normalizeSearchPlaceholderText(translation) ?? '';
const protectionObserver = new MutationObserver(() => {
const currentText = element.textContent.replace(/\s+/g, ' ').trim();
const hasOriginalText = currentText.includes('Type') && currentText.includes('to search');
const hasKbd = Boolean(element.querySelector('kbd'));
if (!hasOriginalText && currentText === expectedText && (!translation.includes('{{kbd}}') || hasKbd)) {
return;
}
this.renderSearchPlaceholder(element, translation);
element.setAttribute('data-ru-localized', 'true');
});
protectionObserver.observe(element, {
characterData: true,
childList: true,
subtree: true
});
this.protectedElements.set(element, {
observer: protectionObserver,
translation: translation
});
}
/**
* локализация всплывающих подсказок (tooltips)
*/
localizeTooltips() {
// «Command palette»
const commandPaletteTooltips = document.querySelectorAll('tool-tip[for="AppHeader-commandPalette-button"]');
commandPaletteTooltips.forEach(tooltip => {
this.localizeByText(tooltip, 'Command palette', 'command-palette');
});
// «Chat with Copilot»
const copilotTooltips = document.querySelectorAll('tool-tip[for="copilot-chat-header-button"]');
copilotTooltips.forEach(tooltip => {
this.localizeByText(tooltip, 'Chat with Copilot', 'chat-with-copilot');
});
}
/**
* локализация всплывающих подсказок шапки страницы (AppHeader)
* обрабатывает tooltips с горячими клавишами и без них
*/
localizeAppHeaderTooltips() {
// маппирование латинских клавиш на русские (по позиции на клавиатуре)
const keyboardMap = {
'G': 'П', 'g': 'п',
'I': 'Ш', 'i': 'ш',
'K': 'Л', 'k': 'л',
'P': 'З', 'p': 'з',
'N': 'Т', 'n': 'т',
'D': 'В', 'd': 'в'
};
// конфигурация подсказок для локализации
const tooltipConfigs = [
// простые подсказки (без клавиш или клавиши не переводятся)
{ text: 'Open menu', key: 'open-menu', translateKeys: false },
{ text: 'Homepage', key: 'homepage', translateKeys: false },
{ text: 'Chat with Copilot', key: 'chat-with-copilot', translateKeys: false },
{ text: 'Create new...', key: 'create-new', translateKeys: false },
{ text: 'Repositories', key: 'repositories', translateKeys: false },
{ text: 'Open user navigation menu', key: 'open-user-navigation-menu', translateKeys: false },
{ text: 'Search for repositories', key: 'search-for-repositories', translateKeys: false },
{ text: 'Add repositories, files, and spaces', key: 'add-repositories-files-spaces', translateKeys: false },
// подсказки с клавишами, которые нужно перевести
{ text: 'Command palette', key: 'command-palette', translateKeys: true },
{ text: 'Issues', key: 'issues', translateKeys: true },
{ text: 'Pull requests', key: 'pull-requests', translateKeys: true },
{ text: 'You have no unread notifications', key: 'you-have-no-notifications', translateKeys: true },
// подсказки с клавишами, которые не нужно переводить (пиктограмма клавиши ввода, символы и т. п.)
{ text: 'Send now', key: 'send-now', translateKeys: false, preserveKbd: true }
];
// находим все tooltips в шапке
const tooltips = document.querySelectorAll('.prc-TooltipV2-Tooltip-tLeuB');
tooltips.forEach(tooltip => {
if (tooltip.hasAttribute('data-ru-localized')) return;
// находим span с id (основной текст подсказки)
const textSpan = tooltip.querySelector('span[id]');
if (!textSpan) {
// структура без вложенных элементов
const tooltipText = tooltip.textContent.trim();
const config = tooltipConfigs.find(c => c.text === tooltipText);
if (config) {
const translation = this.getTranslation(config.key);
if (translation) {
tooltip.textContent = translation;
tooltip.setAttribute('data-ru-localized', 'true');
}
}
return;
}
// извлекаем видимый текст (без скрытых элементов и kbd)
const hiddenSpan = textSpan.querySelector('.prc-src-InternalVisuallyHidden-2YaI6');
const kbdElement = textSpan.querySelector('kbd');
let visibleText = textSpan.textContent.trim();
if (hiddenSpan) {
visibleText = visibleText.replace(hiddenSpan.textContent, '').trim();
}
if (kbdElement) {
visibleText = visibleText.replace(kbdElement.textContent, '').trim();
}
// ищем подходящую конфигурацию
const config = tooltipConfigs.find(c => c.text === visibleText);
if (!config) return;
const translation = this.getTranslation(config.key);
if (!translation) return;
// заменяем текст
if (config.preserveKbd) {
// сохраняем элемент kbd при замене текста
const kbdElement = textSpan.querySelector('kbd');
if (kbdElement) {
const kbdClone = kbdElement.cloneNode(true);
textSpan.textContent = translation + ' ';
textSpan.appendChild(kbdClone);
} else {
textSpan.textContent = translation;
}
} else if (hiddenSpan) {
// сохраняем скрытый span и заменяем текстовые узлы
const hiddenClone = hiddenSpan.cloneNode(true);
textSpan.textContent = translation + ' ';
textSpan.appendChild(hiddenClone);
} else {
textSpan.textContent = translation;
}
// переводим клавиши, если нужно
if (config.translateKeys) {
// обрабатываем элементы kbd с горячими клавишами
const kbdContainer = tooltip.querySelector('.prc-TooltipV2-KeybindingHintContainer-Ymj-3');
if (kbdContainer) {
// находим все отображаемые буквы клавиш
const keySpans = kbdContainer.querySelectorAll('[data-kbd-chord] span[aria-hidden="true"]');
keySpans.forEach(keySpan => {
const keyText = keySpan.textContent.trim();
if (keyboardMap[keyText]) {
keySpan.textContent = keyboardMap[keyText];
}
});
// обновляем скрытые тексты для доступности
const hiddenKeySpans = kbdContainer.querySelectorAll('.prc-src-InternalVisuallyHidden-2YaI6');
hiddenKeySpans.forEach(span => {
const keyText = span.textContent.trim();
if (keyboardMap[keyText]) {
span.textContent = keyboardMap[keyText];
}
});
}
}
tooltip.setAttribute('data-ru-localized', 'true');
});
}
/**
* метод для локализации элементов ActionListItem-label
*/
localizeActionListItems() {
const translationMap = new Map([
['Home', 'home'],
['Feed', 'feed'],
['Issues', 'issues'],
['Pull requests', 'pull-requests'],
['Projects', 'projects'],
['Discussions', 'discussions'],
['Codespaces', 'codespaces'],
['Copilot', 'copilot'],
['Explore', 'explore'],
['Marketplace', 'marketplace'],
['MCP registry', 'mcp-registry'],
['New issue', 'new-issue'],
['New repository', 'new-repository'],
['Import repository', 'import-repository'],
['New agent task', 'new-agent-task'],
['New codespace', 'new-codespace'],
['New gist', 'new-gist'],
['New organization', 'new-organization'],
['New project', 'new-project'],
['Profile', 'profile'],
['Repositories', 'repositories'],
['Stars', 'stars'],
['Gists', 'gists'],
['Organizations', 'organizations'],
['Enterprises', 'enterprises'],
['Sponsors', 'sponsors'],
['Settings', 'settings'],
['Copilot settings', 'copilot-settings'],
['Feature preview', 'feature-preview'],
['Appearance', 'appearance'],
['Accessibility', 'accessibility'],
['Try Enterprise', 'try-enterprise'],
['Sign out', 'sign-out'],
['Open', 'open'],
['Closed', 'closed'],
['Authored', 'authored'],
['Mentioned', 'mentioned'],
['Review requested', 'review-requested'],
['Reviewed', 'reviewed'],
['Assigned to me', 'assigned-to-me'],
['Involves me', 'involves-me'],
['Repositories…', 'copilot-repositories'],
['Files and folders…', 'files-and-folders'],
['Spaces…', 'spaces'],
['Upload from computer', 'upload-from-computer'],
['Extensions…', 'extensions'],
['New agent session', 'new-agent-session'],
['Basic Git commands', 'basic-git-commands'],
['Git branching', 'git-branching'],
['Advanced Git commands', 'advanced-git-commands']
]);
const selectors = ['.ActionListItem-label', '.prc-ActionList-ItemLabel-TmBhn'];
const items = document.querySelectorAll(selectors.join(', '));
items.forEach(item => {
const text = item.textContent.trim();
if (!translationMap.has(text)) {
return;
}
const key = translationMap.get(text);
this.localizeByText(item, text, key);
});
const headingTranslationMap = new Map([
['Agent sessions to include', 'agent-sessions-to-include'],
['Number of results', 'number-of-results'],
['Pull requests to include', 'pull-requests-to-include'],
['Issues to include', 'issues-to-include'],
['Models', 'models'],
['Fast and cost-efficient', 'fast-and-cost-efficient'],
['Versatile and highly intelligent', 'versatile-and-highly-intelligent'],
['Most powerful at complex tasks', 'most-powerful-at-complex']
]);
const headingSelectors = ['.prc-ActionList-GroupHeading-eahp0', '.ModelPicker-module__menuHeading--PBTLv'];
const headings = document.querySelectorAll(headingSelectors.join(', '));
headings.forEach(heading => {
const text = heading.textContent.trim();
if (!headingTranslationMap.has(text)) {
return;
}
const key = headingTranslationMap.get(text);
this.localizeByText(heading, text, key);
});
}
/**
* метод для локализации всплывающих подсказок (tooltips)
*/
localizeAllTooltips() {
const tooltipTranslations = [
{ selector: 'tool-tip[for="global-copilot-agent-button"]', text: 'Open agents panel', key: 'open-agents-panel' },
{ selector: 'tool-tip[for="global-create-menu-anchor"]', text: 'Create new…', key: 'create-new' },
{ selector: 'tool-tip#notification-indicator-tooltip', text: 'You have no unread notifications', key: 'you-have-no-notifications' }
];
tooltipTranslations.forEach(({ selector, text, key }) => {
const tooltips = document.querySelectorAll(selector);
tooltips.forEach(tooltip => {
this.localizeByText(tooltip, text, key);
});
});
// динамические подсказки с изменяемыми идентификаторами
this.localizeDynamicTooltips();
}
/**
* локализация подсказок с динамическими идентификаторами
*/
localizeDynamicTooltips() {
const dynamicTranslations = [
{ text: 'Your issues', key: 'your-issues' },
{ text: 'Your pull requests', key: 'your-pull-requests' },
{ text: 'Account switcher', key: 'account-switcher' },
{ text: 'Repositories', key: 'repositories' }
];
const allTooltips = document.querySelectorAll('tool-tip, .prc-TooltipV2-Tooltip-cYMVY');
allTooltips.forEach(tooltip => {
const text = tooltip.textContent.trim();
const translation = dynamicTranslations.find(t => t.text === text);
if (translation) {
this.localizeByText(tooltip, translation.text, translation.key);
}
});
}
/**
* локализация приветствия с учётом времени суток
*/
localizeGreeting() {
// поддержка нескольких вариантов классов
const selectors = [
'.h2.prc-Heading-Heading-6CmGO',
'.h2.prc-Heading-Heading-MtWFE'
];
const greetingElements = document.querySelectorAll(selectors.join(', '));
greetingElements.forEach(el => {
const text = el.textContent.trim();
// установки для разных приветствий
const patterns = [
{ regex: /^Good night,\s*(.+)!$/, key: 'good-night' },
{ regex: /^Good morning,\s*(.+)!$/, key: 'good-morning' },
{ regex: /^Good afternoon,\s*(.+)!$/, key: 'good-afternoon' },
{ regex: /^Good evening,\s*(.+)!$/, key: 'good-evening' }
];
const alreadyLocalized = patterns.some(pattern => {
const translation = this.getTranslation(pattern.key);
return translation ? text.startsWith(translation) : false;
});
if (alreadyLocalized) {
return;
}
for (const pattern of patterns) {
const match = text.match(pattern.regex);
if (match) {
const username = match[1];
const translation = this.getTranslation(pattern.key);
if (translation) {
el.textContent = `${translation}, ${username}!`;
el.setAttribute('data-ru-localized', 'true');
break;
}
}
}
});
}
/**
* локализация элементов «GitHub Education»
*/
localizeGitHubEducation() {
// заголовок
const taglines = document.querySelectorAll('.h4');
taglines.forEach(el => {
this.localizeByText(el, 'Learn. Collaborate. Grow.', 'learn-collaborate-grow');
});
// описание
const descriptions = document.querySelectorAll('p.my-3.text-small');
descriptions.forEach(el => {
const text = el.textContent.trim().replace(/\s+/g, ' ');
const translation = this.getTranslation('github-education-gives-here');
if (!translation) return;
if (text === translation) {
el.setAttribute('data-ru-localized', 'true');
return;
}
if (text.includes('GitHub Education gives you the tools')) {
el.textContent = translation;
el.setAttribute('data-ru-localized', 'true');
}
});
// кнопка
const buttons = document.querySelectorAll('.Button-label');
buttons.forEach(button => {
this.localizeByText(button, 'Go to GitHub Education', 'go-to-github-education');
});
}
/**
* локализация элементов Копайлота и части левой боковой панели
*/
localizeCopilotChatAndLeftBarPart() {
// textarea placeholder и aria-label
const chatTextarea = document.querySelector('#copilot-chat-textarea');
if (chatTextarea) {
const translation = this.getTranslation('ask-anything');
if (translation) {
const currentPlaceholder = chatTextarea.getAttribute('placeholder');
if (currentPlaceholder !== translation) {
chatTextarea.setAttribute('placeholder', translation);
chatTextarea.setAttribute('aria-label', translation);
chatTextarea.setAttribute('data-ru-localized', 'true');
}
}
}
// «Top repositories»
const topReposElements = document.querySelectorAll('div');
topReposElements.forEach(el => {
if (el.textContent.trim() === 'Top repositories') {
this.localizeByText(el, 'Top repositories', 'top-repositories');
}
});
// поле ввода «Search for repositories»
const repoSearchInputs = document.querySelectorAll('input[aria-label="Search for repositories"], input[placeholder="Search for repositories"]');
if (repoSearchInputs.length) {
const placeholderTranslation = this.getTranslation('search-for-repositories');
if (placeholderTranslation) {
repoSearchInputs.forEach(input => {
if (input.getAttribute('placeholder') !== placeholderTranslation) {
input.setAttribute('placeholder', placeholderTranslation);
}
if (input.getAttribute('aria-label') !== placeholderTranslation) {
input.setAttribute('aria-label', placeholderTranslation);
}
input.setAttribute('data-ru-localized', 'true');
});
}
}
// «Add repositories, files, and spaces»
const attachmentButtons = document.querySelectorAll('.ChatInput-module__attachmentButtonText--fVuEs');
attachmentButtons.forEach(button => {
this.localizeByText(button, 'Add repositories, files, and spaces', 'add-repositories-files-spaces');
});
// кнопка режима Ask/Task. Без защиты, чтобы динамически менялось
const askTaskTranslations = [
{ original: 'Ask', key: 'ask' },
{ original: 'Task', key: 'task' }
];
const modeButtons = document.querySelectorAll('.ChatInput-module__modeSelectButton__gV9F1kA .prc-Button-Label-FWkx3');
modeButtons.forEach(button => {
this.localizeByTextDynamic(button, askTaskTranslations);
});
// Ask/Task во всплывающем меню
const menuLabels = document.querySelectorAll('.prc-ActionList-ItemLabel-81ohH');
menuLabels.forEach(label => {
this.localizeByTextDynamic(label, askTaskTranslations);
});
}
/**
* локализация меток и статусов
*/
localizeLabelsStatusesAndLinks() {
// метка о предварительной версии (старый и новый селекторы)
const previewSelectors = [
'.prc-Label-Label--LG6X[data-size="small"][data-variant="success"]',
'.prc-Label-Label-qG-Zu[data-size="small"][data-variant="success"]'
];
const previewLabels = document.querySelectorAll(previewSelectors.join(', '));
previewLabels.forEach(label => {
this.localizeByText(label, 'Preview', 'preview');
});
const modelPreviewLabels = document.querySelectorAll('.ModelPicker-module__modelMetaLabel--zMick');
modelPreviewLabels.forEach(label => {
this.localizeByText(label, 'Preview', 'preview');
});
// метка New («Новинка»), старый и новый селекторы
const newSelectors = [
'.prc-Label-Label--LG6X[data-size="small"][data-variant="accent"]',
'.prc-Label-Label-qG-Zu[data-size="small"][data-variant="accent"]'
];
const newLabels = document.querySelectorAll(newSelectors.join(', '));
newLabels.forEach(label => {
this.localizeByText(label, 'New', 'new');
});
// метка Free («Бесплатно»), старый и новый селекторы
const freeSelectors = [
'.prc-Label-Label--LG6X[data-size="small"][data-variant="primary"]',
'.prc-Label-Label-qG-Zu[data-size="small"][data-variant="primary"]'
];
const freeLabels = document.querySelectorAll(freeSelectors.join(', '));
freeLabels.forEach(label => {
this.localizeByText(label, 'Free', 'free');
});
// ссылка обратной связи
const feedbackLinks = document.querySelectorAll('a.CopilotHeaderBase-module__feedbackLink--fnf2R');
feedbackLinks.forEach(link => {
this.localizeByText(link, 'Feedback', 'feedback');
});
// кнопки Give feedback и Switch back (старый и новый селекторы)
const linkButtonSelectors = [
'button.prc-Link-Link-85e08',
'button.prc-Link-Link-9ZwDx'
];
const linkButtons = document.querySelectorAll(linkButtonSelectors.join(', '));
linkButtons.forEach(button => {
this.localizeByText(button, 'Give feedback', 'give-feedback');
this.localizeByText(button, 'Switch back', 'switch-back');
});
const autoButtons = document.querySelectorAll('.ModelPicker-module__buttonName--Iid1H');
autoButtons.forEach(button => {
this.localizeByText(button, 'Auto', 'auto');
});
// уведомление о лимите премиум-запросов
const footerElements = document.querySelectorAll('.ModelPicker-module__footer--yCNLJ');
footerElements.forEach(footer => {
if (footer.hasAttribute('data-ru-localized')) return;
const text = footer.textContent.trim();
if (text.includes('You have used 80%') && text.includes('premium requests')) {
const translation = this.getTranslation('you-have-used-eighty');
if (!translation) return;
const link = footer.querySelector('a');
if (!link) return;
const parts = translation.split(/\[link\]|\[\/link\]/);
if (parts.length >= 3) {
const prefix = parts[0] ?? '';
const linkText = parts[1] ?? '';
const suffix = parts.slice(2).join('');
const fragment = document.createDocumentFragment();
if (prefix) fragment.appendChild(document.createTextNode(prefix));
link.textContent = linkText;
fragment.appendChild(link);
if (suffix) fragment.appendChild(document.createTextNode(suffix));
footer.replaceChildren(fragment);
footer.setAttribute('data-ru-localized', 'true');
}
}
});
}
/**
* локализация элементов CommandPill (команды)
*/
localizeCommandPills() {
const commandTranslations = [
{ text: 'Task', key: 'cw3-task' },
{ text: 'Create issue', key: 'create-issue' },
{ text: 'Spark', key: 'spark' }
];
// старый и новый селекторы
const commandPillSelectors = [
'.CommandPill-module__text--ggGhT',
'.CommandPill-module__text__degaI4N'
];
const commandPills = document.querySelectorAll(commandPillSelectors.join(', '));
commandPills.forEach(pill => {
commandTranslations.forEach(({ text, key }) => {
this.localizeByText(pill, text, key);
});
});
}
/**
* локализация заголовков и элементов панели управления
*/
localizeDashboardElements() {
// «Latest from our changelog»
const changelogTitles = document.querySelectorAll('.dashboard-changelog__title');
changelogTitles.forEach(title => {
this.localizeByText(title, 'Latest from our changelog', 'latest-from-our-changelog');
});
// «Agent sessions», «Pull requests», «Issues»
const stackLabels = document.querySelectorAll('.prc-Stack-Stack-WJVsK[data-gap="condensed"]');
stackLabels.forEach(label => {
const text = label.textContent.trim();
if (text === 'Agent sessions') {
this.localizeByText(label, 'Agent sessions', 'agent-sessions');
} else if (text === 'Pull requests') {
this.localizeByText(label, 'Pull requests', 'pull-requests');
} else if (text === 'Issues') {
this.localizeByText(label, 'Issues', 'issues');
}
});
// «View all»
const viewAllLinks = document.querySelectorAll('a.prc-Link-Link-85e08');
viewAllLinks.forEach(link => {
this.localizeByText(link, 'View all', 'view-all');
});
// «Show more»
const showMoreSpans = document.querySelectorAll('span.color-fg-muted.f6');
showMoreSpans.forEach(span => {
this.localizeByText(span, 'Show more', 'show-more');
});
// «View changelog →»
const changelogLinks = document.querySelectorAll('a.text-small.mt-2.Link--muted[href*="changelog"]');
changelogLinks.forEach(link => {
this.localizeByText(link, 'View changelog →', 'view-changelog');
});
// кнопка «Pull requests»
const starterTitles = document.querySelectorAll('.StarterPill-module__title--Nsp36');
starterTitles.forEach(title => {
this.localizeByText(title, 'Pull requests', 'pull-requests');
});
}
/**
* локализация подсказок панели управления и прочих динамических вариаций
*/
localizeDashboardTooltips() {
const tooltipTranslations = [
{ text: 'Agent sessions options', key: 'agent-sessions-options' },
{ text: 'Pull request options', key: 'pull-request-options' },
{ text: 'Issue options', key: 'issue-options' },
{ text: 'Search for repositories', key: 'search-for-repositories' },
{ text: 'Open in Copilot Chat', key: 'open-in-copilot-chat' },
{ text: 'Assign to Copilot', key: 'assign-to-copilot' },
{ text: 'Send now', key: 'send-now' },
{ text: 'Close menu', key: 'close-menu' },
{ text: 'Select a custom agent', key: 'select-custom-agent' },
{ text: 'Start task', key: 'start-task' }
];
const tooltips = document.querySelectorAll('.prc-TooltipV2-Tooltip-cYMVY');
tooltips.forEach(tooltip => {
// проверяем, не был ли элемент уже локализован
if (tooltip.hasAttribute('data-ru-localized')) return;
// пытаемся найти span с id (для сложных tooltips типа «Send now»)
const firstSpan = tooltip.querySelector('span[id]');
let visibleText;
let targetElement;
if (firstSpan) {
// сложная структура: извлекаем текст без скрытых элементов
const tempDiv = document.createElement('div');
tempDiv.innerHTML = firstSpan.innerHTML;
tempDiv.querySelectorAll('.prc-src-InternalVisuallyHidden-nlR9R').forEach(el => el.remove());
visibleText = tempDiv.textContent.trim();
targetElement = firstSpan;
} else {
// простая структура: используем весь текст tooltip
visibleText = tooltip.textContent.trim();
targetElement = tooltip;
}
const translation = tooltipTranslations.find(t => t.text === visibleText);
if (translation) {
const ftlTranslation = this.getTranslation(translation.key);
if (ftlTranslation) {
if (firstSpan) {
// для сложных подсказок: заменяем текст в span, сохраняя скрытые элементы
const hiddenSpan = firstSpan.querySelector('.prc-src-InternalVisuallyHidden-nlR9R');
firstSpan.textContent = ftlTranslation;
if (hiddenSpan) {
firstSpan.appendChild(hiddenSpan);
}
} else {
// для простых подсказок: используем localizeByText
this.localizeByText(targetElement, visibleText, translation.key);
}
tooltip.setAttribute('data-ru-localized', 'true');
}
}
});
}
/**
* локализация элементов поиска («Search syntax tips», «Give feedback»)
*/
localizeSearchElements() {
// «Search syntax tips»
const syntaxLinks = document.querySelectorAll('a.Link.color-fg-accent.text-normal[href*="understanding-github-code-search-syntax"]');
syntaxLinks.forEach(link => {
this.localizeByText(link, 'Search syntax tips', 'search-syntax-tips');
});
// «Give feedback»
const feedbackButtons = document.querySelectorAll('button.Button--link .Button-label');
feedbackButtons.forEach(label => {
this.localizeByText(label, 'Give feedback', 'give-feedback');
});
}
/**
* локализация элементов в поиске и меню
*/
localizeCopilotSearchElements() {
// заголовки разделов
const sectionTranslations = new Map([
['Copilot', 'copilot'],
['Owners', 'owners'],
['Repositories', 'repositories'],
['Agents', 'agents']
]);
const sectionTitles = document.querySelectorAll('.ActionList-sectionDivider-title');
sectionTitles.forEach(title => {
const text = title.textContent.trim();
const translationKey = sectionTranslations.get(text);
if (translationKey) {
this.localizeByText(title, text, translationKey);
}
});
// «Chat with Copilot»
const copilotLabels = document.querySelectorAll('.ActionListItem-label');
copilotLabels.forEach(label => {
this.localizeByText(label, 'Chat with Copilot', 'chat-with-copilot');
});
// «Start a new Copilot thread»
const copilotDescriptions = document.querySelectorAll('.ActionListItem-description.QueryBuilder-ListItem-trailing');
copilotDescriptions.forEach(desc => {
this.localizeByText(desc, 'Start a new Copilot thread', 'start-copilot-thread');
});
// «Jump to»
const jumpToDescriptions = document.querySelectorAll('.ActionListItem-description.QueryBuilder-ListItem-trailing');
jumpToDescriptions.forEach(desc => {
this.localizeByText(desc, 'Jump to', 'jump-to');
});
}
/**
* локализация подсказок с шаблоном «Branch: <name>»
*/
localizeBranchTooltips() {
const tooltips = document.querySelectorAll('.prc-TooltipV2-Tooltip-cYMVY');
tooltips.forEach(tooltip => {
const text = tooltip.textContent.trim();
const branchMatch = text.match(/^Branch:\s+(.+)$/);
if (branchMatch) {
const branchName = branchMatch[1];
const translation = this.getTranslation('branch');
if (translation) {
tooltip.textContent = `${translation}: ${branchName}`;
console.log(`${LOG_PREFIX} Translated: "Branch: ${branchName}" → "${translation}: ${branchName}"`);
}
}
});
}
/**
* локализация заголовка «Agents» в панели
*/
localizeAgentsHeader() {
const headers = document.querySelectorAll('.GlobalCopilotOverlay-module__header--mBq7d h2.f5');
headers.forEach(h2 => {
this.localizeByText(h2, 'Agents', 'agents');
});
}
/**
* локализация палитры команд (Command Palette)
*/
localizeCommandPalette() {
// «Search or jump to...» в placeholder и input
const searchInputs = document.querySelectorAll('input.typeahead-input[placeholder="Search or jump to..."]');
searchInputs.forEach(input => {
const translation = this.getTranslation('search-or-jump');
if (translation) {
input.setAttribute('placeholder', translation);
console.log(`${LOG_PREFIX} Translated placeholder: "Search or jump to..." → "${translation}"`);
}
});
// также проверяем placeholder атрибуты в command-palette-mode
const paletteInputs = document.querySelectorAll('command-palette-input[placeholder="Search or jump to..."]');
paletteInputs.forEach(input => {
const translation = this.getTranslation('search-or-jump');
if (translation) {
input.setAttribute('placeholder', translation);
console.log(`${LOG_PREFIX} Translated command palette placeholder: "Search or jump to..." → "${translation}"`);
}
});
// placeholder в command-palette-mode элементах
const paletteModes = document.querySelectorAll('command-palette-mode[data-placeholder="Search or jump to..."]');
paletteModes.forEach(mode => {
const translation = this.getTranslation('search-or-jump');
if (translation) {
mode.setAttribute('data-placeholder', translation);
console.log(`${LOG_PREFIX} Translated data-placeholder: "Search or jump to..." → "${translation}"`);
}
});
// «Tip:»
const tipLabels = document.querySelectorAll('span.text-bold');
tipLabels.forEach(label => {
this.localizeByText(label, 'Tip:', 'tip');
});
const hintConfigs = [
{
tokens: ['Type', '@', 'to search people and organizations'],
translationKey: 'type-at-to-search',
identifier: '@',
logMessage: 'Type @ to search people...'
},
{
tokens: ['Type', '?', 'for help and tips'],
translationKey: 'type-question-for-help',
identifier: '?',
logMessage: 'Type ? for help...'
},
{
tokens: ['Type', '#', 'to search issues'],
translationKey: 'type-hash-to-issues',
identifier: '#',
logMessage: 'Type # to search issues'
},
{
tokens: ['Type', '>', 'to activate command mode'],
translationKey: 'type-gt-to-command',
identifier: '>',
logMessage: 'Type > to activate command mode'
},
{
tokens: ['Type', '#', 'to search pull requests'],
translationKey: 'type-hash-to-prs',
identifier: '#',
logMessage: 'Type # to search pull requests'
}
];
const localizeHintElement = (element, options = {}) => {
if (!element || element.getAttribute('data-ru-localized') === 'true') {
return null;
}
const text = element.textContent;
if (!text) {
return null;
}
for (const config of hintConfigs) {
if (!config.tokens.every(token => text.includes(token))) {
continue;
}
const kbdElement = element.querySelector('kbd.hx_kbd');
if (!kbdElement || kbdElement.textContent.trim() !== config.identifier) {
continue;
}
if (options.leadingNodes && options.leadingNodes.length > 0) {
const translation = this.getTranslation(config.translationKey);
if (!translation) {
continue;
}
const fragment = this.createFragmentFromKbdTranslation(
translation,
new Map([[config.identifier, kbdElement]])
);
if (!fragment) {
continue;
}
const nodes = [...options.leadingNodes];
if (options.insertSpaceAfterLeading !== false) {
nodes.push(document.createTextNode(options.spaceText ?? ' '));
}
nodes.push(fragment);
element.replaceChildren(...nodes);
element.setAttribute('data-ru-localized', 'true');
} else {
const replaced = this.replaceContentWithKbdTranslation(
element,
config.translationKey,
new Map([[config.identifier, kbdElement]])
);
if (!replaced) {
continue;
}
}
return config.logMessage;
}
return null;
};
const helpHintDivs = document.querySelectorAll('command-palette-help div');
helpHintDivs.forEach(div => {
const message = localizeHintElement(div);
if (message) {
console.log(`${LOG_PREFIX} Translated: "${message}"`);
}
});
// подсказки в элементах command-palette-tip
const paletteTips = document.querySelectorAll('command-palette-tip');
paletteTips.forEach(tip => {
// обработка структуры: два div внутри гибкого контейнера
const flexContainer = tip.querySelector('.d-flex.flex-items-start.flex-justify-between');
if (!flexContainer) return;
const leftDiv = flexContainer.children[0]; // левая часть
const rightDiv = flexContainer.children[1]; // правая часть «Type ? for help»
if (rightDiv) {
const message = localizeHintElement(rightDiv);
if (message) {
console.log(`${LOG_PREFIX} Translated trailing part: "${message}"`);
}
}
// Локализация левой части
if (!leftDiv) return;
const text = leftDiv.textContent;
const boldSpan = leftDiv.querySelector('span.text-bold');
// «Go to your accessibility settings to change your keyboard shortcuts»
if (text && text.includes('Go to your accessibility settings')) {
const translation = this.getTranslation('go-to-accessibility-settings');
if (translation && boldSpan) {
leftDiv.innerHTML = '';
leftDiv.appendChild(boldSpan);
leftDiv.appendChild(document.createTextNode(' ' + translation));
console.log(`${LOG_PREFIX} Translated: "Go to your accessibility settings..."`);
}
}
else {
const options = boldSpan ? { leadingNodes: [boldSpan] } : undefined;
const message = localizeHintElement(leftDiv, options);
if (message) {
console.log(`${LOG_PREFIX} Translated: "${message}"`);
}
}
});
// заголовки групп: Pages, Repositories, Users
const groupHeaders = document.querySelectorAll('[data-target="command-palette-item-group.header"]');
groupHeaders.forEach(header => {
const text = header.textContent.trim();
if (text === 'Pages') {
this.localizeByText(header, 'Pages', 'pages');
} else if (text === 'Repositories') {
this.localizeByText(header, 'Repositories', 'repositories');
} else if (text === 'Users') {
this.localizeByText(header, 'Users', 'users');
}
});
// заголовки элементов палитры команд
const itemTitles = document.querySelectorAll('[data-target="command-palette-item.titleElement"]');
itemTitles.forEach(title => {
const text = title.textContent.trim();
if (text === 'Copilot') {
this.localizeByText(title, 'Copilot', 'copilot');
} else if (text === 'Dashboard') {
this.localizeByText(title, 'Dashboard', 'dashboard');
} else if (text === 'Notifications') {
this.localizeByText(title, 'Notifications', 'notifications');
} else if (text === 'Issues') {
this.localizeByText(title, 'Issues', 'issues');
} else if (text === 'Pull requests') {
this.localizeByText(title, 'Pull requests', 'pull-requests');
}
});
// «Jump to»
const hintTexts = document.querySelectorAll('[data-target="command-palette-item.hintText"]');
hintTexts.forEach(hint => {
const text = hint.textContent.trim();
if (text === 'Jump to') {
this.localizeByText(hint, 'Jump to', 'jump-to');
}
});
// «Enter to jump to Tab to search» с сохранением элементов kbd
const enterTabHints = document.querySelectorAll('[data-target="command-palette-item.hintText"]');
enterTabHints.forEach(hint => {
const text = hint.textContent;
if (text && text.includes('Enter') && text.includes('to jump to') && text.includes('Tab') && text.includes('to search')) {
// ищем div внутри hint
const innerDiv = hint.querySelector('.hide-sm');
if (innerDiv) {
const kbds = innerDiv.querySelectorAll('kbd.hx_kbd');
if (kbds.length >= 2) {
const enterKbd = kbds[0];
const tabKbd = kbds[1];
const translation = this.getTranslation('enter-to-jump-tab-to-search');
if (translation) {
const enterClone = enterKbd.cloneNode(true);
const tabClone = tabKbd.cloneNode(true);
const fragment = this.createFragmentFromKbdTranslation(
translation,
new Map([
[enterClone.textContent.trim(), enterClone],
[tabClone.textContent.trim(), tabClone]
])
);
if (fragment) {
innerDiv.replaceChildren(fragment);
innerDiv.setAttribute('data-ru-localized', 'true');
console.log(`${LOG_PREFIX} Translated: "Enter to jump to Tab to search" with preserved kbd`);
}
}
}
}
}
});
}
/**
* локализация агентной панели
*/
localizeCopilotTaskScreen() {
// «Start a new task with Copilot»
const taskHeadings = document.querySelectorAll('.GlobalCopilotOverlay-module__messageStateHeading--F5_1N');
const taskErrorVariants = [
'Tasks couldn\'t be loaded',
'Tasks couldn’t be loaded'
];
taskHeadings.forEach(heading => {
this.localizeByText(heading, 'Start a new task with Copilot', 'start-new-task-copilot');
taskErrorVariants.some(variant => this.localizeByText(heading, variant, 'tasks-couldnt-be-loaded'));
});
// описание
const taskDescriptions = document.querySelectorAll('.GlobalCopilotOverlay-module__messageStateDescription--IWyBI');
taskDescriptions.forEach(desc => {
this.localizeByText(desc, 'Describe your task in natural language. Copilot will work in the background and open a pull request for your review.', 'copilot-task-description');
this.localizeByText(desc, 'Try again or, if the problem persists, contact support.', 'try-again-or');
});
// ссылка «Learn more about Copilot coding agent»
const learnMoreLinks = document.querySelectorAll('.GlobalCopilotOverlay-module__messageState--ORDxQ a.prc-Link-Link-85e08');
learnMoreLinks.forEach(link => {
this.localizeByText(link, 'Learn more about Copilot coding agent', 'learn-more-copilot-agent');
this.localizeByText(link, 'GitHub status', 'github-status');
});
// уведомление «Copilot uses AI. Check for mistakes.» с сохранением ссылки
const disclosureParagraphs = document.querySelectorAll('.GlobalCopilotOverlay-module__copilotDisclosureText--hPU0b');
const disclosureTranslation = this.getTranslation('copilot-uses-ai');
if (disclosureTranslation) {
const disclosureParts = disclosureTranslation.split(/\[link\]|\[\/link\]/);
const normalizedDisclosure = disclosureParts.join('').replace(/\s+/g, ' ').trim();
const englishDisclosure = 'Copilot uses AI. Check for mistakes.'.replace(/\s+/g, ' ').trim();
disclosureParagraphs.forEach(paragraph => {
const link = paragraph.querySelector('a');
if (!link) {
return;
}
const currentText = paragraph.textContent.replace(/\s+/g, ' ').trim();
if (currentText === normalizedDisclosure) {
if (paragraph.getAttribute('data-ru-localized') !== 'true') {
paragraph.setAttribute('data-ru-localized', 'true');
}
return;
}
if (currentText !== englishDisclosure && paragraph.getAttribute('data-ru-localized') === 'true') {
return;
}
if (disclosureParts.length < 3) {
return;
}
const prefix = disclosureParts[0] ?? '';
const linkText = disclosureParts[1] ?? '';
const suffix = disclosureParts.slice(2).join('');
const fragment = document.createDocumentFragment();
if (prefix) {
fragment.appendChild(document.createTextNode(prefix));
}
link.textContent = linkText;
fragment.appendChild(link);
if (suffix) {
fragment.appendChild(document.createTextNode(suffix));
}
paragraph.replaceChildren(fragment);
paragraph.setAttribute('data-ru-localized', 'true');
});
}
}
/**
* локализация сообщения об отсутствии сессий
*/
localizeNoResultsMessages() {
const noSessionsTranslation = this.getTranslation('no-sessions-found');
const noSessionsParts = noSessionsTranslation ? noSessionsTranslation.split(/\[link\]|\[\/link\]/) : [];
const noSessionsPrefix = noSessionsParts[0] ?? '';
const noSessionsLinkText = noSessionsParts[1] ?? '';
const noSessionsSuffix = noSessionsParts.slice(2).join('');
const expectedTextNormalized = (noSessionsPrefix + noSessionsLinkText + noSessionsSuffix).replace(/\s+/g, ' ').trim();
const expectedLinkTextNormalized = noSessionsLinkText.replace(/\s+/g, ' ').trim();
const englishNormalized = 'No sessions found. Try a different filter, or start a session.'.replace(/\s+/g, ' ').trim();
const englishLinkTextCandidates = [
'start a session',
'start a session.'
].map(text => text.replace(/\s+/g, ' ').trim());
const unableToLoadTranslation = this.getTranslation('unable-to-load-agent');
const unableEnglish = 'Unable to load agent tasks, try again later.'.replace(/\s+/g, ' ').trim();
const titles = document.querySelectorAll('.Title-module__title--YTYH_');
titles.forEach(title => {
const link = title.querySelector('a');
const currentTextNormalized = title.textContent.replace(/\s+/g, ' ').trim();
if (!link) {
if (!unableToLoadTranslation) {
return;
}
const isAlreadyLocalized = currentTextNormalized === unableToLoadTranslation;
if (isAlreadyLocalized) {
if (title.getAttribute('data-ru-localized') !== 'true') {
title.setAttribute('data-ru-localized', 'true');
}
return;
}
const matchesEnglish = currentTextNormalized === unableEnglish;
if (!matchesEnglish) {
return;
}
title.textContent = unableToLoadTranslation;
title.setAttribute('data-ru-localized', 'true');
return;
}
if (!noSessionsTranslation || noSessionsParts.length < 3) {
return;
}
const currentLinkTextNormalized = link.textContent.replace(/\s+/g, ' ').trim();
const alreadyLocalized = currentTextNormalized === expectedTextNormalized && currentLinkTextNormalized === expectedLinkTextNormalized;
if (alreadyLocalized) {
if (title.getAttribute('data-ru-localized') !== 'true') {
title.setAttribute('data-ru-localized', 'true');
}
return;
}
const matchesEnglish = currentTextNormalized === englishNormalized
&& englishLinkTextCandidates.includes(currentLinkTextNormalized);
if (!matchesEnglish) {
return;
}
const fragment = document.createDocumentFragment();
fragment.appendChild(document.createTextNode(noSessionsPrefix));
link.textContent = noSessionsLinkText;
fragment.appendChild(link);
fragment.appendChild(document.createTextNode(noSessionsSuffix));
title.replaceChildren(fragment);
title.setAttribute('data-ru-localized', 'true');
});
}
/**
* перевод абсолютного времени в title (всплывающая подсказка)
*/
translateAbsoluteTime(text) {
if (typeof text !== 'string' || !text.trim()) {
return text;
}
// формат: «Nov 5, 2025, 11:25 PM GMT+3»
const regex = /^([A-Z][a-z]{2,8})\s+(\d{1,2}),\s+(\d{4}),\s+(\d{1,2}):(\d{2})\s+(AM|PM)\s+GMT([+-]\d+)$/;
const match = text.match(regex);
if (match) {
const [, month, day, year, hours, minutes, ampm, gmt] = match;
const monthKey = month.length <= 3 ? `month-short-${month.toLowerCase()}` : `month-long-${month.toLowerCase()}`;
const translatedMonth = this.getTranslation(monthKey, month);
if (translatedMonth) {
// конвертация AM/PM в 24-часовой формат
let hour = parseInt(hours);
if (ampm === 'PM' && hour !== 12) hour += 12;
if (ampm === 'AM' && hour === 12) hour = 0;
// формат: «5 нояб. 2025, 23:25 по МСК»
const timezone = gmt === '+3'
? this.getTranslation('timezone-msk', 'GMT+3')
: `GMT${gmt}`;
const normalizedHour = String(hour).padStart(2, '0');
return `${day} ${translatedMonth} ${year}, ${normalizedHour}:${minutes} ${timezone}`;
}
}
return text;
}
/**
* локализация относительного времени
*/
localizeRelativeTime() {
const relativeTimes = document.querySelectorAll('relative-time');
if (!relativeTimes.length) {
return;
}
relativeTimes.forEach(timeElement => {
const needsLangUpdate = timeElement.getAttribute('lang') !== 'ru';
const prefixAttr = timeElement.getAttribute('prefix');
const prefixPropValue = typeof timeElement.prefix === 'string' ? timeElement.prefix : null;
const hasEnglishPrefixAttr = typeof prefixAttr === 'string' && prefixAttr.trim().toLowerCase() === 'on';
const hasEnglishPrefixProp = typeof prefixPropValue === 'string' && prefixPropValue.trim().toLowerCase() === 'on';
const wasTranslated = timeElement.getAttribute('data-ru-translated') === 'true';
// переводим всплывающую подсказку через FTL
if (timeElement.hasAttribute('title')) {
const originalTitle = timeElement.getAttribute('title');
const translatedTitle = this.translateAbsoluteTime(originalTitle);
if (translatedTitle !== originalTitle) {
timeElement.setAttribute('title', translatedTitle);
}
}
if (!needsLangUpdate && !hasEnglishPrefixAttr && !hasEnglishPrefixProp && wasTranslated) {
this.cleanRelativeTimeShadow(timeElement);
return;
}
if (needsLangUpdate) {
try {
timeElement.setAttribute('lang', 'ru');
if (typeof timeElement.update === 'function') {
timeElement.update();
}
} catch (error) {
console.warn(`${LOG_PREFIX} Unable to apply lang="ru" to relative-time:`, error);
}
}
if (hasEnglishPrefixAttr || hasEnglishPrefixProp) {
// удаляем префикс «on», чтобы не было «on 17 окт.» после перевода
timeElement.removeAttribute('prefix');
if (typeof timeElement.prefix === 'string') {
try {
timeElement.prefix = '';
} catch (error) {
console.warn(`${LOG_PREFIX} Unable to clear prefix property on relative-time:`, error);
}
}
if (typeof timeElement.update === 'function') {
timeElement.update();
}
}
this.cleanRelativeTimeShadow(timeElement);
timeElement.setAttribute('data-ru-translated', 'true');
});
// локализация текстов «Created on», «Opened by», Updated в описаниях элементов
const numberSignTranslation = this.getTranslation('number-sign');
const descriptions = document.querySelectorAll('.Description-module__container--Ks2Eo');
descriptions.forEach(desc => {
const text = desc.textContent || '';
const container = desc.closest('.ItemContainer-module__contents--EBVbu');
// определяем, тема это или запрос на слияние
const isIssue = container && container.querySelector('.octicon-issue-opened');
const isPR = container && container.querySelector('.octicon-git-pull-request, .octicon-git-pull-request-draft');
// «Opened by»
if (text.includes('Opened by')) {
let translationKey = null;
let logMessage = null;
if (isIssue) {
// для тем: «Opened by» → «Открыта»
translationKey = 'issue-opened-by';
logMessage = '"Opened by" (Issue)';
} else if (isPR || !text.includes('Created')) {
// для запросов на слияние: «Opened by» → «Подан»
translationKey = 'opened-by';
logMessage = '"Opened by" (PR)';
}
if (translationKey) {
const translation = this.getTranslation(translationKey);
if (translation) {
const originalHTML = desc.innerHTML;
const replacedHTML = originalHTML.replace(/Opened by/g, translation);
if (replacedHTML !== originalHTML) {
desc.innerHTML = replacedHTML;
desc.setAttribute('data-ru-localized', 'true');
}
}
}
}
// Updated
if (text.includes('Updated')) {
let translationKey = null;
let logMessage = null;
if (isIssue) {
// для тем: Updated → «Отредактирована»
translationKey = 'issue-updated';
logMessage = '"Updated" (Issue)';
} else if (isPR) {
// для запросов на слияние: Updated → «Отредактирован»
translationKey = 'pr-updated';
logMessage = '"Updated" (PR)';
}
if (translationKey) {
const translation = this.getTranslation(translationKey);
if (translation) {
const originalHTML = desc.innerHTML;
const updatedOnPattern = /Updated(?:\s| )+on(?=(?:\s| |<))/g;
const updatedPattern = /Updated/g;
let html = originalHTML;
html = html.replace(updatedOnPattern, translation);
html = html.replace(updatedPattern, translation);
if (html !== originalHTML) {
desc.innerHTML = html;
desc.setAttribute('data-updated-localized', 'true');
}
}
}
}
// «Created on»
if (text.includes('Created')) {
const defaultCreated = this.getTranslation('created-on', 'Created');
const translation = isIssue
? this.getTranslation('issue-created-on', defaultCreated)
: defaultCreated;
if (translation) {
const originalHTML = desc.innerHTML;
const createdOnPattern = /Created(?:\s| )+on(?=(?:\s| |<))/g;
const createdPattern = /Created/g;
let html = originalHTML;
html = html.replace(createdOnPattern, translation);
html = html.replace(createdPattern, translation);
if (html !== originalHTML) {
desc.innerHTML = html;
desc.setAttribute('data-created-localized', 'true');
}
}
}
if (numberSignTranslation && text.includes('#')) {
const numberWalker = document.createTreeWalker(desc, NodeFilter.SHOW_TEXT, null);
let numberNode;
while ((numberNode = numberWalker.nextNode())) {
if (!numberNode.textContent || !numberNode.textContent.includes('#')) {
continue;
}
const updated = numberNode.textContent.replace(/#(?=\d)/g, numberSignTranslation);
if (updated !== numberNode.textContent) {
numberNode.textContent = updated;
}
}
}
// удаляем on, который остаётся перед датами/relative-time
const walker = document.createTreeWalker(desc, NodeFilter.SHOW_TEXT, null);
const textNodesToClean = [];
let textNode;
while (textNode = walker.nextNode()) {
if (!textNode.textContent) {
continue;
}
if (/\bon\b/i.test(textNode.textContent)) {
textNodesToClean.push(textNode);
}
}
textNodesToClean.forEach(node => {
let content = node.textContent;
// убираем on сразу после переведённых глаголов
content = content.replace(/(Отредактирован(?:а)?|Создан(?:а)?)(?:[\s\u00a0]+)on\b(?:[\s\u00a0]*)/gi, '$1 ');
// убираем самостоятельные on и лишние пробелы вокруг них
content = content.replace(/[\s\u00a0]*\bon\b[\s\u00a0]*/gi, ' ');
// нормализуем множественные пробелы, но не удаляем ведущие, если они нужны
content = content.replace(/\s{2,}/g, ' ');
node.textContent = content;
});
});
}
cleanRelativeTimeShadow(timeElement) {
if (!timeElement || typeof timeElement !== 'object') {
return;
}
const shadowRoot = timeElement.shadowRoot;
if (!shadowRoot) {
return;
}
const ownerDocument = timeElement.ownerDocument;
const nodeFilter = typeof NodeFilter !== 'undefined'
? NodeFilter
: ownerDocument?.defaultView?.NodeFilter;
if (!ownerDocument || typeof ownerDocument.createTreeWalker !== 'function' || !nodeFilter) {
return;
}
const walker = ownerDocument.createTreeWalker(shadowRoot, nodeFilter.SHOW_TEXT, null);
let node;
while ((node = walker.nextNode())) {
if (!node.textContent) {
continue;
}
const original = node.textContent;
let updated = original.replace(/(^|\s)on\s+/gi, '$1');
updated = updated.replace(/(?:\s|\u00a0)+г\.$/gi, '');
updated = updated.replace(/\s{2,}/g, ' ');
updated = updated.trimStart();
updated = updated.trimEnd();
if (updated !== original) {
node.textContent = updated;
}
}
}
/**
* локализует текстовые узлы с Updated
*/
localizeUpdatedText() {
// ищем все текстовые узлы, которые содержат Updated
const walker = document.createTreeWalker(
document.body,
NodeFilter.SHOW_TEXT,
{
acceptNode: function(node) {
// пропускаем пустые узлы и узлы внутри script/style
if (!node.textContent.trim() ||
node.parentElement?.tagName === 'SCRIPT' ||
node.parentElement?.tagName === 'STYLE') {
return NodeFilter.FILTER_REJECT;
}
const text = node.textContent.trim();
// принимаем только узлы с Updated (не переведённые)
// проверяем И с пробелом, И без пробела
if (text === 'Updated' || text === 'Updated ') {
// проверяем, не помечен ли родитель как переведённый
if (node.parentElement?.getAttribute('data-updated-localized') === 'true') {
return NodeFilter.FILTER_REJECT;
}
return NodeFilter.FILTER_ACCEPT;
}
return NodeFilter.FILTER_REJECT;
}
}
);
let node;
const nodesToUpdate = []; // собираем узлы перед обновлением
while (node = walker.nextNode()) {
const trimmedText = node.textContent.trim();
// двойная проверка: что это действительно Updated или «Updated »
if (trimmedText === 'Updated' || trimmedText === 'Updated ') {
// проверяем, не помечен ли родитель (дополнительная проверка)
if (node.parentElement?.getAttribute('data-updated-localized') === 'true') {
continue;
}
nodesToUpdate.push(node);
}
}
const resolveUpdatedTranslation = (parentElement) => {
const fallback = this.getTranslation('pr-updated', 'Updated');
if (!parentElement) {
return fallback;
}
const container = parentElement.closest('.ItemContainer-module__contents--EBVbu');
if (container) {
if (container.querySelector('.octicon-issue-opened')) {
return this.getTranslation('issue-updated', fallback);
}
if (container.querySelector('.octicon-git-pull-request, .octicon-git-pull-request-draft')) {
return this.getTranslation('pr-updated', fallback);
}
}
return this.getTranslation('pr-updated', fallback);
};
// обновляем все найденные узлы с ЗАЩИТОЙ через MutationObserver
nodesToUpdate.forEach(node => {
const oldText = node.textContent;
const parent = node.parentElement;
if (!parent) {
const translationText = resolveUpdatedTranslation(null);
node.textContent = `${translationText} `;
return;
}
// СНАЧАЛА устанавливаем MutationObserver, ПОТОМ переводим
const protectObserver = new MutationObserver((mutations) => {
mutations.forEach(mutation => {
if (mutation.type === 'characterData' || mutation.type === 'childList') {
// проверяем, не восстановил ли Гитхаб оригинальный текст
const walker = document.createTreeWalker(
parent,
NodeFilter.SHOW_TEXT,
null
);
let textNode;
while (textNode = walker.nextNode()) {
const text = textNode.textContent.trim();
if (text === 'Updated' || text === 'Updated ') {
const translationText = resolveUpdatedTranslation(parent);
console.warn(`${LOG_PREFIX} Restored English "Updated" text detected. Reapplying translation.`);
textNode.textContent = `${translationText} `;
}
}
}
});
});
// наблюдаем за изменениями В РОДИТЕЛЕ (ПЕРЕД переводом)
protectObserver.observe(parent, {
characterData: true,
childList: true,
subtree: true
});
// ТЕПЕРЬ применяем перевод (при активном observer)
const translationText = resolveUpdatedTranslation(parent);
node.textContent = `${translationText} `;
parent.setAttribute('data-updated-localized', 'true');
});
}
/**
* локализация страницы настройки предпочтений куки
*/
localizeCookiePreferencesPage() {
const cookieHeadingTranslation = this.getTranslation('manage-cookie-preferences');
const cookieHeadingEnglish = 'Manage cookie preferences';
if (cookieHeadingTranslation) {
const headingElements = document.querySelectorAll('h1');
headingElements.forEach(heading => {
if (heading.textContent.trim() === cookieHeadingEnglish) {
this.localizeByText(heading, cookieHeadingEnglish, 'manage-cookie-preferences');
}
});
}
// локализация заголовков категорий куки
const cookieCategoryTranslations = [
{ text: 'Required', key: 'required' },
{ text: 'Analytics', key: 'analytics' },
{ text: 'Social media', key: 'social-media' },
{ text: 'Advertising', key: 'advertising' }
];
const categoryHeadings = document.querySelectorAll('h2');
categoryHeadings.forEach(heading => {
const text = heading.textContent.trim();
const translation = cookieCategoryTranslations.find(t => t.text === text);
if (translation) {
this.localizeByText(heading, translation.text, translation.key);
}
});
// локализация описания «Required»
const requiredDescriptionEnglish = 'GitHub uses required cookies to perform essential website functions and to provide the services. For example, cookies are used to log you in, save your language preferences, provide a shopping cart experience, improve performance, route traffic between web servers, detect the size of your screen, determine page load times, improve user experience, and for audience measurement. These cookies are necessary for our websites to work.';
const requiredDescriptionTranslation = this.getTranslation('github-uses-required-work');
if (requiredDescriptionTranslation) {
const paragraphs = document.querySelectorAll('p');
paragraphs.forEach(p => {
const normalizedText = p.textContent.replace(/\s+/g, ' ').trim();
if (normalizedText === requiredDescriptionEnglish.replace(/\s+/g, ' ').trim()) {
this.localizeByText(p, requiredDescriptionEnglish, 'github-uses-required-work');
}
});
}
const cookieDescriptionTranslation = this.getTranslation('most-github-websites-use-cookies');
const cookieDescriptionEnglish = 'Most GitHub websites use cookies. Cookies are small text files placed on your device to store data so web servers can use it later. GitHub and our third-party partners use cookies to remember your preferences and settings, help you sign in, show you personalized ads, and analyze how well our websites are working. For more info, see the Cookies and similar technologies section of the Privacy Statement.';
if (!cookieDescriptionTranslation) {
return;
}
const parts = cookieDescriptionTranslation.split(/\[link\]|\[\/link\]/);
const hasLink = parts.length >= 3;
const paragraphs = document.querySelectorAll('form p');
const englishNormalized = cookieDescriptionEnglish.replace(/\s+/g, ' ').trim();
paragraphs.forEach(paragraph => {
const normalizedText = paragraph.textContent.replace(/\s+/g, ' ').trim();
const alreadyLocalized = paragraph.getAttribute('data-ru-localized') === 'true';
const matchesEnglish = normalizedText === englishNormalized;
if (!matchesEnglish && !alreadyLocalized) {
return;
}
if (hasLink) {
const link = paragraph.querySelector('a');
if (!link) {
this.localizeByText(paragraph, cookieDescriptionEnglish, 'most-github-websites-use-cookies');
return;
}
const prefix = parts[0] ?? '';
const linkText = parts[1] ?? '';
const suffix = parts.slice(2).join('');
const fragment = document.createDocumentFragment();
if (prefix) {
fragment.appendChild(document.createTextNode(prefix));
}
link.textContent = linkText;
fragment.appendChild(link);
if (suffix) {
fragment.appendChild(document.createTextNode(suffix));
}
paragraph.replaceChildren(fragment);
paragraph.setAttribute('data-ru-localized', 'true');
} else {
this.localizeByText(paragraph, cookieDescriptionEnglish, 'most-github-websites-use-cookies');
}
});
}
/**
* локализует подвал (footer)
*/
localizeFooter() {
// «© 2025 GitHub, Inc.»
const copyrightSpans = document.querySelectorAll('span');
copyrightSpans.forEach(span => {
const text = span.textContent.trim();
if (text.includes('© 2025 GitHub,') && text.includes('Inc.')) {
this.localizeByText(span, '© 2025 GitHub,\u00A0Inc.', 'copyright-2025');
}
});
// ссылки подвала
const footerLinks = document.querySelectorAll('.Link--secondary.Link');
const linkTranslations = [
{ text: 'Terms', key: 'terms' },
{ text: 'Privacy', key: 'privacy' },
{ text: 'Security', key: 'security' },
{ text: 'Status', key: 'status' },
{ text: 'Community', key: 'community' },
{ text: 'Docs', key: 'docs' },
{ text: 'Contact', key: 'contact' }
];
footerLinks.forEach(link => {
const text = link.textContent.trim();
const translation = linkTranslations.find(t => t.text === text);
if (translation) {
this.localizeByText(link, translation.text, translation.key);
}
});
// кнопки управления куки в подвале
const cookieButtons = document.querySelectorAll('cookie-consent-link > button.Link--secondary.underline-on-hover');
const cookieTranslations = [
{ text: 'Manage cookies', key: 'manage-cookies' },
{ text: 'Do not share my personal information', key: 'do-not-share-info' }
];
cookieButtons.forEach(button => {
const text = button.textContent.trim();
const translation = cookieTranslations.find(t => t.text === text);
if (translation) {
this.localizeByText(button, translation.text, translation.key);
}
});
}
/**
* локализация заголовков новостей GitHub
* работает на страницах ленты событий (github.com) и журнала изменений (github.blog/changelog)
*/
localizeNewsHeadlines() {
// создаём переводчик заголовков
if (!this.headlineTranslator) {
this.headlineTranslator = new NewsHeadlineTranslator(this.parser);
}
// селекторы для заголовков новостей
// на странице ленты событий github.com
const feedHeadlines = document.querySelectorAll('.dashboard-changelog a.Link--primary.Link');
// на странице журнала изменений github.blog/changelog
const changelogHeadlines = document.querySelectorAll('a.ChangelogItem-title');
// объединяем все заголовки
const allHeadlines = [...feedHeadlines, ...changelogHeadlines];
allHeadlines.forEach(headline => {
// пропускаем уже переведённые
if (headline.hasAttribute('data-ru-headline-translated')) {
return;
}
const originalText = headline.textContent.trim();
const translatedText = this.headlineTranslator.translate(originalText);
if (translatedText) {
headline.textContent = translatedText;
headline.setAttribute('data-ru-headline-translated', 'true');
headline.setAttribute('data-ru-headline-original', originalText);
}
});
}
/**
* запуск локализации всех поддерживаемых элементов
*/
localize() {
this.localizeDashboard();
this.localizeSearchPlaceholder();
this.localizeTooltips();
this.localizeAppHeaderTooltips();
this.localizeAllTooltips();
this.localizeActionListItems();
this.localizeGreeting();
this.localizeGitHubEducation();
this.localizeCopilotChatAndLeftBarPart();
this.localizeLabelsStatusesAndLinks();
this.localizeCommandPills();
this.localizeDashboardElements();
this.localizeDashboardTooltips();
this.localizeSearchElements();
this.localizeCopilotSearchElements();
this.localizeBranchTooltips();
this.localizeAgentsHeader();
this.localizeCommandPalette();
this.localizeCopilotTaskScreen();
this.localizeNoResultsMessages();
this.localizeUpdatedText();
this.localizeRelativeTime();
this.localizeCookiePreferencesPage();
this.localizeFooter();
this.localizeNewsHeadlines();
}
/**
* устанавливка наблюдателя за изменениями DOM
*/
observeChanges() {
this.observer = new MutationObserver((mutations) => {
let shouldRelocalize = false;
for (let mutation of mutations) {
if (mutation.type === 'childList' && mutation.addedNodes.length > 0) {
shouldRelocalize = true;
break;
}
}
if (shouldRelocalize) {
// debounce: локализуем только через 100 мс после последнего изменения
clearTimeout(this.relocalizeTimeout);
this.relocalizeTimeout = setTimeout(() => {
this.localize();
}, 100);
}
});
this.observer.observe(document.body, {
childList: true,
subtree: true
});
}
/**
* останавливает наблюдатель
*/
stopObserving() {
if (this.observer) {
this.observer.disconnect();
}
}
}
/**
* переводчик заголовков новостей GitHub
* машинный перевод через словарь комбинаций фраз (от длинных к коротким)
*/
class NewsHeadlineTranslator {
constructor(ftlParser) {
this.ftlParser = ftlParser;
// инициализация словарей из FTL
this.initFullHeadlines();
this.initPhrasesDictionary();
this.initMonths();
}
/**
* инициализация словаря полных заголовков (точные совпадения)
*/
initFullHeadlines() {
// словарь ключей FTL для полных заголовков
this.fullHeadlines = {
// исходные заголовки
'Showing tool calls and other improvements to Copilot chat on the web': 'hl-showing-tool-calls-copilot-web',
'Docker and Docker Compose version upgrades on hosted runners': 'hl-docker-compose-version-upgrades',
'Codespaces is now in public preview for GitHub Enterprise with data residency': 'hl-codespaces-public-preview-enterprise',
'CodeQL 2.24.0 adds Swift 6.2 and .NET 10 support, and improves file handling for minified JavaScript': 'hl-codeql-adds-swift-dotnet-support',
'Copilot metrics in GitHub Enterprise Cloud with data residency in public preview': 'hl-copilot-metrics-enterprise-cloud',
'GitHub Actions: Smarter editing, clearer debugging, and a new case function': 'hl-github-actions-smarter-editing',
'arm64 standard runners are now available in private repositories': 'hl-arm64-runners-private-repos',
'Claude and Codex are now available in public preview on GitHub': 'hl-claude-codex-public-preview',
'Dependabot now supports OIDC authentication': 'hl-dependabot-oidc-auth',
'The Dependabot Proxy is now open source with an MIT license': 'hl-dependabot-proxy-opensource',
'GitHub Mobile: Comment on unchanged lines in pull request files': 'hl-github-mobile-comment-unchanged',
'Closing down notice of legacy Copilot metrics APIs': 'hl-closing-down-notice-of-legacy-copilot-metrics-apis',
'Improved search for GitHub Issues in public preview': 'hl-improved-search-for-github-issues-in-public-preview',
'ACP support in Copilot CLI is now in public preview': 'hl-acp-support-in-copilot-cli-is-now-in-public-preview',
'GitHub MCP Server: New Projects tools, OAuth scope filtering, and new features': 'hl-github-mcp-server-new-projects-tools-oauth',
'Changes to GitHub Dependabot pull request comment commands': 'hl-changes-to-github-dependabot-pull-request-comment-commands',
'Introducing the Agents tab in your repository': 'hl-introducing-agents-tab-in-your-repository',
'GPT-5.2-Codex is now available in Visual Studio, JetBrains IDEs, Xcode, and Eclipse': 'hl-gpt52codex-available-in-ides',
'Improved pull request “Files changed” page on by default': 'hl-improved-files-changed-on-by-default'
};
}
/**
* инициализация словаря комбинаций фраз из FTL
* порядок: от самых длинных к самым коротким
*/
initPhrasesDictionary() {
// массив комбинаций фраз, отсортированный по длине (от длинных к коротким)
// формат: [английская фраза, ключ FTL]
const phrasesConfig = [
// очень длинные комбинации (10+ слов)
['Showing tool calls and other improvements to Copilot chat on the web', 'hl-showing-tool-calls-other-improvements-copilot-chat-on-the-web'],
['and other improvements to Copilot chat on the web', 'hl-and-other-improvements-to-copilot-chat-on-the-web'],
['other improvements to Copilot chat on the web', 'hl-other-improvements-to-copilot-chat-on-the-web'],
['is now in public preview for GitHub Enterprise with data residency', 'hl-is-now-in-public-preview-for-github-enterprise-with-data-residency'],
['in public preview for GitHub Enterprise with data residency', 'hl-in-public-preview-for-github-enterprise-with-data-residency'],
['for GitHub Enterprise with data residency', 'hl-for-github-enterprise-with-data-residency'],
['GitHub Enterprise with data residency', 'hl-github-enterprise-with-data-residency'],
['GitHub Enterprise Cloud with data residency', 'hl-github-enterprise-cloud-with-data-residency'],
['with data residency in public preview', 'hl-with-data-residency-in-public-preview'],
// средние комбинации (5-9 слов)
['Showing tool calls and other improvements', 'hl-showing-tool-calls-and-other-improvements'],
['tool calls and other improvements', 'hl-tool-calls-and-other-improvements'],
['and other improvements to', 'hl-and-other-improvements-to'],
['other improvements to', 'hl-other-improvements-to'],
['Copilot chat on the web', 'hl-copilot-chat-on-the-web'],
['are now available in public preview on GitHub', 'hl-are-now-available-in-public-preview'],
['is now available in public preview on GitHub', 'hl-is-now-available-in-public-preview'],
['in public preview on GitHub', 'hl-in-public-preview-on-github'],
['is now in public preview for', 'hl-is-now-in-public-preview-for'],
['is now in public preview', 'hl-is-now-in-public-preview'],
['in public preview', 'hl-in-public-preview'],
['public preview', 'hl-public-preview'],
['version upgrades on hosted runners', 'hl-version-upgrades-on-hosted-runners'],
['upgrades on hosted runners', 'hl-upgrades-on-hosted-runners'],
['on hosted runners', 'hl-on-hosted-runners'],
['are now available in private repositories', 'hl-are-now-available-in-private-repositories'],
['in private repositories', 'hl-in-private-repositories'],
['private repositories', 'hl-private-repositories'],
['Smarter editing, clearer debugging', 'hl-smarter-editing-clearer-debugging'],
['and a new case function', 'hl-and-a-new-case-function'],
['a new case function', 'hl-a-new-case-function'],
['file handling for minified JavaScript', 'hl-file-handling-for-minified-javascript'],
['for minified JavaScript', 'hl-for-minified-javascript'],
['minified JavaScript', 'hl-minified-javascript'],
// короткие комбинации (2-4 слова)
['Showing tool calls', 'hl-showing-tool-calls'],
['tool calls', 'hl-tool-calls'],
['and other', 'hl-and-other'],
['other improvements', 'hl-other-improvements'],
['improvements to', 'hl-improvements-to'],
['Copilot chat', 'hl-copilot-chat'],
['chat on', 'hl-chat-on'],
['on the web', 'hl-on-the-web'],
['the web', 'hl-the-web'],
['Docker and Docker Compose', 'hl-docker-and-docker-compose'],
['and Docker Compose', 'hl-and-docker-compose'],
['Docker Compose', 'hl-docker-compose'],
['version upgrades', 'hl-version-upgrades'],
['hosted runners', 'hl-hosted-runners'],
['standard runners', 'hl-standard-runners'],
['arm64 standard runners', 'hl-arm64-standard-runners'],
['now available', 'hl-now-available'],
['are now available', 'hl-are-now-available'],
['is now available', 'hl-is-now-available'],
['with data residency', 'hl-with-data-residency'],
['data residency', 'hl-data-residency'],
['now supports', 'hl-now-supports'],
['OIDC authentication', 'hl-oidc-authentication'],
['is now open source', 'hl-is-now-open-source'],
['open source', 'hl-open-source'],
['MIT license', 'hl-mit-license'],
['with an MIT license', 'hl-with-an-mit-license'],
['and improves', 'hl-and-improves'],
['and improves file handling', 'hl-and-improves-file-handling'],
['file handling', 'hl-file-handling'],
['adds support', 'hl-adds-support'],
['support and', 'hl-support-and'],
['unchanged lines', 'hl-unchanged-lines'],
['pull request files', 'hl-pull-request-files'],
['Comment on', 'hl-comment-on'],
['Comment on unchanged lines', 'hl-comment-on-unchanged-lines'],
// новые комбинации для заголовков
['Closing down notice of legacy', 'hl-closing-down-notice-of-legacy'],
['Closing down notice of', 'hl-closing-down-notice-of'],
['Closing down notice', 'hl-closing-down-notice'],
['metrics APIs', 'hl-metrics-apis'],
['Improved search for', 'hl-improved-search-for'],
['Improved search', 'hl-improved-search'],
['search for', 'hl-search-for'],
['GitHub Issues', 'hl-github-issues'],
['ACP support in', 'hl-acp-support-in'],
['ACP support', 'hl-acp-support'],
['Copilot CLI', 'hl-copilot-cli'],
['GitHub MCP Server', 'hl-github-mcp-server'],
['New Projects tools', 'hl-new-projects-tools'],
['OAuth scope filtering', 'hl-oauth-scope-filtering'],
['new features', 'hl-new-features'],
['Changes to', 'hl-changes-to'],
['pull request comment commands', 'hl-pull-request-comment-commands'],
['comment commands', 'hl-comment-commands'],
['Introducing the', 'hl-introducing-the'],
['Introducing', 'hl-introducing'],
['Agents tab in your repository', 'hl-agents-tab-in-your-repository'],
['Agents tab', 'hl-agents-tab'],
['in your repository', 'hl-in-your-repository'],
['your repository', 'hl-your-repository'],
['JetBrains IDEs', 'hl-jetbrains-ides'],
['"Files changed" page', 'hl-files-changed-page'],
['on by default', 'hl-on-by-default'],
['by default', 'hl-by-default'],
// названия продуктов
['GitHub Actions', 'hl-github-actions'],
['GitHub Mobile', 'hl-github-mobile'],
['GitHub Enterprise Cloud', 'hl-github-enterprise-cloud'],
['GitHub Enterprise', 'hl-github-enterprise'],
['GitHub Copilot', 'hl-github-copilot'],
['GitHub Dependabot', 'hl-github-dependabot'],
['Codespaces', 'hl-codespaces'],
['Dependabot Proxy', 'hl-dependabot-proxy'],
['Dependabot', 'hl-dependabot'],
['CodeQL', 'hl-codeql'],
['Copilot metrics', 'hl-copilot-metrics'],
['Claude and Codex', 'hl-claude-and-codex']
// одиночные предлоги (and, for, to, in, on, with) обрабатываются в методе translatePrepositions()
];
// загружаем переводы из FTL и сортируем по длине (от длинных к коротким)
this.phrases = [];
for (const [eng, ftlKey] of phrasesConfig) {
const translation = this.ftlParser.getMessage(ftlKey);
if (translation !== null) {
this.phrases.push({
english: eng,
russian: translation,
length: eng.length
});
}
}
// сортировка по убыванию длины
this.phrases.sort((a, b) => b.length - a.length);
// инициализация словаря предлогов (жёстко закодировано для сохранения пробелов)
this.prepositions = [
{ english: / and /g, russian: ' и ' },
{ english: /, and /g, russian: ' и ' },
{ english: / for /g, russian: ' для ' },
{ english: / to /g, russian: ' к ' },
{ english: / in /g, russian: ' в ' },
{ english: / on /g, russian: ' на ' },
{ english: / with /g, russian: ' с ' }
];
}
/**
* инициализация прилагательных месяцев из FTL
*/
initMonths() {
const monthNames = ['january', 'february', 'march', 'april', 'may', 'june',
'july', 'august', 'september', 'october', 'november', 'december'];
this.months = {};
for (const month of monthNames) {
const capMonth = month.charAt(0).toUpperCase() + month.slice(1);
const m = this.ftlParser.getMessage(`month-adj-${month}-m`);
const f = this.ftlParser.getMessage(`month-adj-${month}-f`);
const n = this.ftlParser.getMessage(`month-adj-${month}-n`);
if (m && f && n) {
this.months[capMonth] = { m, f, n };
}
}
}
/**
* перевод заголовка новости
*/
translate(headline) {
if (!headline || typeof headline !== 'string') {
return null;
}
const trimmedHeadline = headline.trim();
// 1. Проверяем точное совпадение с полным заголовком
if (this.fullHeadlines[trimmedHeadline]) {
const ftlKey = this.fullHeadlines[trimmedHeadline];
const translation = this.ftlParser.getMessage(ftlKey);
if (translation) {
return translation;
}
}
// 2. Проверяем паттерны месячных релизов
const monthlyResult = this.translateMonthlyPattern(trimmedHeadline);
if (monthlyResult) {
return monthlyResult;
}
// 3. Применяем замены комбинаций фраз (от длинных к коротким)
let result = trimmedHeadline;
for (const phrase of this.phrases) {
if (result.includes(phrase.english)) {
result = result.replace(phrase.english, phrase.russian);
}
}
// 4. Обрабатываем предлоги (с сохранением пробелов)
result = this.translatePrepositions(result);
// проверяем, было ли что-то переведено
if (result !== trimmedHeadline) {
return this.postProcess(result);
}
// если ничего не переведено, возвращаем null
return null;
}
/**
* перевод предлогов с сохранением пробелов
*/
translatePrepositions(text) {
let result = text;
for (const prep of this.prepositions) {
result = result.replace(prep.english, prep.russian);
}
return result;
}
/**
* обработка паттернов месячных релизов
*/
translateMonthlyPattern(headline) {
// месячные релизы с версией
// «X in Y vN.N – Month Release» → «Месячный релиз — версия N.N «X» в «Y»»
const releaseMatch = headline.match(/^(.+?)\s+in\s+(.+?)\s+v([\d.]+)\s*[–—-]\s*(January|February|March|April|May|June|July|August|September|October|November|December)\s+Release$/i);
if (releaseMatch) {
const [, product, platform, version, month] = releaseMatch;
const monthAdj = this.months[month]?.m;
if (monthAdj) {
return `${monthAdj} релиз — версия ${version} «${product}» в «${platform}»`;
}
}
// месячные обновления
// «X in Y — Month update» → «Месячное обновление «X» в «Y»»
const updateMatch = headline.match(/^(.+?)\s+in\s+(.+?)\s*[–—-]\s*(January|February|March|April|May|June|July|August|September|October|November|December)\s+update$/i);
if (updateMatch) {
const [, product, platform, month] = updateMatch;
const monthAdj = this.months[month]?.n;
if (monthAdj) {
return `${monthAdj} обновление «${product}» в «${platform}»`;
}
}
return null;
}
/**
* постобработка переведённого заголовка
*/
postProcess(result) {
// удаляем лишние пробелы
result = result.replace(/\s+/g, ' ').trim();
// исправляем двойные пробелы вокруг знаков препинания
result = result.replace(/\s+([,.:;!?])/g, '$1');
result = result.replace(/([,.:;!?])\s+/g, '$1 ');
// убираем пустые кавычки
result = result.replace(/«»/g, '');
// первая буква заглавная
if (result.length > 0) {
result = result.charAt(0).toUpperCase() + result.slice(1);
}
return result;
}
}
/**
* загрузка файла формата FTL из репозитория
*/
async function loadFTL(url) {
try {
console.info(`${LOG_PREFIX} Fetching FTL file from ${url}`);
const response = await fetch(url);
if (!response.ok) {
throw new Error(`HTTP error! Status: ${response.status}`);
}
const content = await response.text();
console.info(`${LOG_PREFIX} FTL file downloaded successfully.`);
return content;
} catch (error) {
console.error(`${LOG_PREFIX} Failed to download FTL file:`, error);
throw error;
}
}
// инициализация
console.info(`${LOG_PREFIX} Userscript loaded.`);
// ждём полной загрузки DOM
if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', init);
} else {
init();
}
async function init() {
console.info(`${LOG_PREFIX} DOM ready, initializing localizer...`);
try {
// загружаем файл формата FTL из репозитория
const ftlContent = await loadFTL(FTL_URL);
// создаём локализатор с загруженным содержимым
const localizer = new GitHubLocalizer(ftlContent);
// первоначальная локализация
localizer.localize();
// наблюдаем за изменениями для динамически загружаемого контента
localizer.observeChanges();
// сохраняем в глобальном объекте для отладки
window.GitHubLocalizer = localizer;
} catch (error) {
console.error(`${LOG_PREFIX} Failed to initialize localizer:`, error);
}
}
})();