terminology-ru-RU.md

Руководство по терминологии и текстам интерфейса ru-RU

Этот документ задает терминологию для русского (ru-RU) интерфейса и документации ScriptCat. Его цель - сохранять различия между возможностями продукта, использовать естественные для интерфейса формулировки и не повреждать технические идентификаторы при дальнейшей локализации.

Проверенные источники употребления: src/locales/ru-RU/*.json, docs/README_RU.md, docs/architecture.md

Основные принципы

1. Используйте краткие и понятные формулировки на русском языке, явно обозначающие действие или состояние.
2. Сохраняйте различия между Пользовательский скрипт, Скрипт страницы, Фоновый скрипт и Скрипт по расписанию; это разные типы продукта.
3. Не выполняйте глобальную замену слов только из-за похожего перевода. Сначала проверяйте функцию, место в интерфейсе и контекст фразы.
4. Сохраняйте точный технический смысл терминов регулярное выражение, выражение cron, хранилище, а также идентификаторов @match, @exclude, @grant и @connect.
5. Не изменяйте placeholders, HTML/React-теги, интерполяцию i18next, URL и идентификаторы метаданных в рамках языкового редактирования.
6. Указанные ниже ключи фиксируют текущее употребление или известные точки проверки; те же правила относятся к будущим строкам с тем же смыслом.

Категории

Категория	Назначение
A. Термины продукта и функций	Названия возможностей ScriptCat и типов скриптов.
B. Действия и состояния интерфейса	Предпочтительные формулировки для элементов управления и сообщений.
C. Термины, зависящие от контекста	Слова, выбор которых требует проверки конкретной функции.
D. Сохраняемые технические термины	Термины и идентификаторы, техническое значение которых нельзя терять.
E. Темы для последующей проверки	Уже существующие формулировки, требующие отдельного прохода.

A. Термины продукта и функций

Понятие	Предпочтительная формулировка	Примеры ключей	Примечание
ScriptCat browser extension	Расширение ScriptCat	welcome_title, ext_update_notification	Название продукта писать как ScriptCat.
generic user script	Пользовательский скрипт	create_user_script, script_list_content	Общее название пользовательского скрипта.
normal userscript type	Пользовательский скрипт / текущая категория Обычный скрипт	create_user_script, script_list.sidebar.normal_script	Не объединять с фоновыми или запланированными скриптами.
Tampermonkey compatibility	Пользовательский скрипт, совместимый с Tampermonkey / Скрипт Tampermonkey	docs/README_RU.md, docs/architecture.md	Использовать, когда важна совместимость; не заменять этим общее название или категорию скрипта.
page script	Скрипт страницы	script_list_enable_content	Обозначает выполняющийся на страницах скрипт в тексте интерфейса; не подменяет без проверки категорию Обычный скрипт.
background script	Фоновый скрипт	create_background_script, background_script	Тип скрипта, выполняемого в фоне.
scheduled script	Скрипт по расписанию	create_scheduled_script, scheduled_script	Предпочтительно для нового текста; сохраняет смысл планового запуска.
script synchronization	Синхронизация скриптов	script_sync, sync_status	Для удаления следует уточнять синхронизацию состояния удаления.
subscription	Подписка	subscribe_url, subscribe, importpage.count_subscribes	Подписаться использовать только для действия.
script browsing destination / gallery / market	Хранилище скриптов / Галерея скриптов / Магазин скриптов	script_gallery, script_list_title, README	В документации Хранилище скриптов обозначает переход к scriptcat.org/ru/search; для UI выбирать название фактического раздела назначения.

B. Действия и состояния интерфейса

Понятие	Предпочтительная формулировка	Примеры ключей	Примечание
create	Создать	create_script, create_background_script	При необходимости указывать объект действия.
save / save as	Сохранить / Сохранить как	save, save_as	Стандартные команды интерфейса.
import / export	Импорт / Экспорт; в предложениях импортировать / экспортировать	import, export, import_file, export_file	Форму выбирать по роли строки.
install / update	Установить / Обновить	script, update_script	При необходимости уточнять скрипт или подписку.
run / runtime	Запустить / Время выполнения	run, runtime, log_title	Для журнала подходит Журнал выполнения.
enable / disable	Включить / Выключить; состояния Включено / Выключено	enable, disable, updatepage.enabled	Не смешивать с открытием и закрытием UI.
settings	Настройки	settings, script_setting	Для параметров продукта.
permission	Разрешение / Разрешения	permission, request_permission	Для прав доступа скрипта.
connect / sync	Подключить / Синхронизировать	connect, script_sync	Подключение сервиса и синхронизация данных различаются.
directory	Папка / Каталог	open_backup_dir, open_directory	В пользовательском интерфейсе естественнее папка; технический контекст может требовать каталог.
browser tab	Вкладка	close_current_tab, script_run_env.all	Для browser tab использовать этот термин.

C. Термины, зависящие от контекста

Понятие	Возможная формулировка	Правило выбора	Примеры ключей
local / cloud	Локальный / Облачный, Облако	Выбирать по тому, описывается ли источник, место хранения или назначение синхронизации.	local, cloud, source_local_script
panel / console	панель / консоль	Панель управления продуктом не называть консолью разработчика.	background_script_description, build_success_message
source	Источник, Источник установки, Источник подписки	Называть объект, который предоставляет источник.	source, importpage.col_source, source_subscribe_link
storage	Хранилище, пространство хранения, API хранилища	Различать данные скрипта, настроенное место хранения и API.	script_storage, script_operation_description, storage_api
sync deletion	Синхронизировать состояние удаления / Синхронизировать удаления	Выбрать после подтверждения поведения функции.	sync_delete, sync_delete_desc, notification.script_sync_delete

D. Сохраняемые технические термины

Понятие	Использовать	Примеры ключей	Причина
regular expression	регулярное выражение	search_regex	Стандартный термин разработки.
cron expression	выражение cron	cron_invalid_expr, error_cron_invalid	Точно указывает на синтаксис расписания.
expression	выражение	value_export_expression, expression_format_error	Сохраняет технический смысл введенного выражения.
watch file changes	Отслеживать файл / Остановить отслеживание	watch_file, stop_watch_file	Описывает длительное наблюдение за изменениями файла.
metadata declaration	объявление	error_metadata_line_duplicated	Соответствует синтаксису метаданных.
product/API identifiers	Сохранять ESLint, VSCode, Cookie, GM API, @match, @exclude, @grant, @connect, @resource, @require	enable_eslint, vscode_url, confirm_operation_description, script_resource_tooltip	Имена и идентификаторы должны оставаться узнаваемыми.

E. Темы для последующей проверки

Эти пункты описывают имеющиеся расхождения. Создание руководства само по себе не меняет *.json; исправления должны выполняться отдельной проверяемой правкой.

Тема	Текущее состояние	Предпочтительное направление	Примеры ключей
scheduled script naming	Используются как Скрипт по расписанию, так и Запланированный скрипт.	После проверки экранов унифицировать термин продукта как Скрипт по расписанию, если это соответствует назначению типа.	create_scheduled_script, scheduled_script
subscription as object/action	Действие и объект могут встречаться в близких строках.	Для объекта использовать Подписка, для кнопки действия - Подписаться.	subscribe, subscribe_url, update_subscribe
documentation link locale	Русские строки могут вести на англоязычные страницы документации.	Менять ссылки только после подтверждения доступной русской страницы.	script_list_content, develop_mode_guide

Контрольный список для AI и участников

При добавлении или редактировании русского текста:

1. Убедитесь, что целевая локаль - ru-RU, и проверьте это руководство вместе с соседними строками интерфейса.
2. Сохраняйте различия типов скриптов и применяйте одинаковые названия для одной функции.
3. Для контекстно-зависимых терминов проверяйте фактическое поведение и место строки в UI.
4. Не изменяйте технические термины, placeholders, теги, интерполяцию, URL и metadata-идентификаторы.
5. Не превращайте темы последующей проверки в глобальные замены без отдельной проверки поведения.
6. Перед передачей результата проверьте новые и измененные строки на смешение типов скриптов, подписки как объекта и измененные идентификаторы.