- {settings.shortcuts.home}{t(settings.locale, "homeShortcut")}
- {settings.shortcuts.renameWindow}{t(settings.locale, "renameWindow")}
- {settings.shortcuts.toggleFullscreen.replace("Meta", window.canvasTTY.window.isMacOS ? "Command" : "Super")}{t(settings.locale, "toggleFullscreen")}
- {settings.shortcuts.focusUp}{t(settings.locale, "keyboardFocusUp")}
- Shift + drag{t(settings.locale, "marqueeSelectionHint")}
+ {([["home", "homeShortcut"], ["renameWindow", "renameWindow"], ["toggleFullscreen", "toggleFullscreen"],
+ ["focusUp", "keyboardFocusUp"]] as const).map(([action, label]) => (
+ {displayShortcutBinding(settings.shortcuts[action], window.canvasTTY.window.isMacOS)}{t(settings.locale, label)}
+ ))}
+ {t(settings.locale, "shortcutShiftDrag")}{t(settings.locale, "marqueeSelectionHint")}
{settings.canvasWheelCaptureMode === "key" && settings.canvasWheelOverride !== null && (
{displayCanvasNavigationBinding(settings.canvasWheelOverride, window.canvasTTY.window.isMacOS)}
{t(settings.locale, "canvasWheelOverrideHint")}
diff --git a/src/renderer/src/lib/i18n.ts b/src/renderer/src/lib/i18n.ts
index bcb08b77e..fb3b47fbd 100644
--- a/src/renderer/src/lib/i18n.ts
+++ b/src/renderer/src/lib/i18n.ts
@@ -522,16 +522,17 @@ const ru = {
zoomSensitivity: "Чувствительность зума",
useScrollWheelToZoom: "Зум обычным скроллом",
useScrollWheelToZoomDescription: "Если выключено, обычный скролл перемещает канвас, а Ctrl/Command + скролл и pinch масштабируют.",
- canvasWheelCapture: "Перехват wheel/pinch над виджетами",
- canvasWheelCaptureDescription: "Off оставляет обычный wheel/pinch focused input-виджету, включая live Browser page. On и активный бинд передают события канвасу; pinch и Ctrl/Command + скролл над Browser всегда масштабируют canvas. Клики и drag не перехватываются.",
- canvasWheelOverride: "Комбинация wheel/pinch",
- canvasWheelOverrideHint: "Wheel/pinch поверх виджетов",
+ canvasWheelCapture: "Перехват колеса и жеста масштаба над виджетами",
+ canvasWheelCaptureDescription: "«Выключено» оставляет обычную прокрутку колесом и жест масштаба виджету с фокусом ввода, включая открытую страницу браузера. «Включено», а также «По комбинации» при нажатой комбинации, передают их канвасу; жест масштаба и Ctrl/Command + прокрутка над браузером всегда масштабируют канвас. Клики и перетаскивание не перехватываются.",
+ canvasWheelCaptureKey: "По комбинации",
+ canvasWheelOverride: "Комбинация для колеса и жеста масштаба",
+ canvasWheelOverrideHint: "Колесо и жест масштаба поверх виджетов",
canvasOverrideShortcutInvalid: "Нужен модификатор, комбинация с ним или Mouse3/Mouse4/Mouse5.",
canvasNavigationOverride: "Перехват навигации канвасом",
- canvasNavigationOverrideDescription: "Пока комбинация или кнопка мыши удерживается, wheel, pinch и drag над любым виджетом принадлежат канвасу. Drag колёсиком работает всегда.",
+ canvasNavigationOverrideDescription: "Пока комбинация или кнопка мыши удерживается, прокрутка колесом, жест масштаба и перетаскивание над любым виджетом принадлежат канвасу. Перетаскивание с нажатым колёсиком работает всегда.",
canvasNavigationCaptureHint: "Удержите модификатор, нажмите комбинацию или Mouse3/Mouse4/Mouse5. Escape отменяет запись.",
canvasNavigationOverrideHint: "Навигация поверх виджетов",
- canvasOverrideBindingsMatch: "Комбинации совпадают: полный перехват имеет приоритет и также забирает drag.",
+ canvasOverrideBindingsMatch: "Комбинации совпадают: полный перехват имеет приоритет и также забирает перетаскивание.",
disabled: "Отключено",
terminalWheelDirection: "Направление колеса терминала",
copyOnSelect: "Копировать при выделении",
@@ -809,7 +810,8 @@ const ru = {
terminalSearchClose: "Закрыть поиск",
fitCanvas: "Показать всё",
focusWindowHint: "Фокус на соседнее окно",
- marqueeSelectionHint: "Shift + тянуть — выделить группу",
+ marqueeSelectionHint: "Выделить группу",
+ shortcutShiftDrag: "Shift + перетаскивание",
remarkAnchorStep: "Замечание к шагу",
remarkAnchorPage: "Замечание к странице",
remarkAnchorTime: "Замечание ко времени",
@@ -1595,6 +1597,7 @@ const en: Record = {
useScrollWheelToZoomDescription: "When off, plain scrolling pans the canvas while Ctrl/Command + scroll and pinch zoom.",
canvasWheelCapture: "Wheel/pinch capture over widgets",
canvasWheelCaptureDescription: "Off leaves plain wheel/pinch with the focused input widget, including a live Browser page. On and an active binding route it to the canvas; Browser pinch and Ctrl/Command + scroll always zoom the canvas. Clicks and drag are not captured.",
+ canvasWheelCaptureKey: "Key",
canvasWheelOverride: "Wheel/pinch shortcut",
canvasWheelOverrideHint: "Wheel/pinch over widgets",
canvasOverrideShortcutInvalid: "Use a modifier, a modifier-based chord, or Mouse3/Mouse4/Mouse5.",
@@ -1880,7 +1883,8 @@ const en: Record = {
terminalSearchClose: "Close search",
fitCanvas: "Fit to content",
focusWindowHint: "Focus the neighbouring window",
- marqueeSelectionHint: "Shift + drag selects a group",
+ marqueeSelectionHint: "Select a group",
+ shortcutShiftDrag: "Shift + drag",
remarkAnchorStep: "Remark on step",
remarkAnchorPage: "Remark on page",
remarkAnchorTime: "Remark on the time",
diff --git a/src/renderer/src/lib/shortcuts.ts b/src/renderer/src/lib/shortcuts.ts
index e0c65ea92..7b77e84b3 100644
--- a/src/renderer/src/lib/shortcuts.ts
+++ b/src/renderer/src/lib/shortcuts.ts
@@ -125,6 +125,15 @@ export function handleMacNativeSelectAll(event: KeyboardEvent, isMacOS: boolean)
return true;
}
+/**
+ * An action shortcut as the hints panel and the shortcut reference show it: arrows as glyphs, Meta as Command or
+ * Super. Key by key, so the Comma key is not looked for inside "Command".
+ */
+export function displayShortcutBinding(binding: string, isMacOS: boolean): string {
+ const names: Record = { Meta: isMacOS ? "Command" : "Super", Comma: ",", ArrowUp: "↑", ArrowDown: "↓", ArrowLeft: "←", ArrowRight: "→" };
+ return binding.split("+").map((key) => names[key] ?? key).join("+");
+}
+
export function displayCanvasNavigationBinding(binding: string, isMacOS: boolean): string {
if (!isMacOS) return binding;
return binding.split("+").map((part) => {
diff --git a/src/renderer/src/styles/app.css b/src/renderer/src/styles/app.css
index 0374b31a8..c8e049fdb 100644
--- a/src/renderer/src/styles/app.css
+++ b/src/renderer/src/styles/app.css
@@ -943,6 +943,8 @@ button { border: 0; }
.segmented__button--active { color: var(--text-dark); background: var(--primary); }
.segmented__button:focus-visible { box-shadow: inset 0 0 0 2px color-mix(in srgb, currentColor 42%, transparent); }
.setting-group__control > .segmented + .shortcut-editor { margin-top: .6em; }
+/* The canvas navigation rows sit in the narrow control column: their (longer localized) labels wrap instead of being cut off. */
+.setting-group__control .shortcut-editor__row > span { overflow-wrap: break-word; text-overflow: clip; white-space: normal; line-height: 1.3; }
.swatch-choices { display: grid; grid-template-columns: repeat(5, minmax(0, 1fr)); gap: .4em; }
.swatch-choices--four { grid-template-columns: repeat(4, minmax(0, 1fr)); }
.swatch-choice { min-width: 0; min-height: 4.6em; padding: .48em; display: grid; grid-template-rows: 2em auto; align-items: center; gap: .45em; border: .08em solid transparent; border-radius: .72em; outline: 0; color: var(--text-muted-on-dark); background: var(--surface-soft); cursor: pointer; font-size: .76em; font-weight: 700; transition: color .15s ease, background .15s ease, border-color .15s ease, box-shadow .15s ease; }
diff --git a/tests/ru-shortcut-hints-i18n.test.mjs b/tests/ru-shortcut-hints-i18n.test.mjs
new file mode 100644
index 000000000..a82edda29
--- /dev/null
+++ b/tests/ru-shortcut-hints-i18n.test.mjs
@@ -0,0 +1,113 @@
+import assert from "node:assert/strict";
+import { readFile } from "node:fs/promises";
+import test from "node:test";
+import { t } from "../src/renderer/src/lib/i18n.ts";
+
+const canvasPath = new URL("../src/renderer/src/features/workspace/WorkspaceCanvas.tsx", import.meta.url);
+const referencePath = new URL("../src/renderer/src/components/ShortcutReference.tsx", import.meta.url);
+const settingsPath = new URL("../src/renderer/src/features/settings/SettingsPanel.tsx", import.meta.url);
+
+// Latin words that may stay untranslated in Russian hints: keyboard and mouse key
+// names, plus product names and the HOME zone label that the UI shows verbatim.
+const allowedLatin = new Set([
+ "Shift", "Command", "Super", "Ctrl", "Control", "Alt", "Option", "Meta",
+ "Enter", "Escape", "Esc", "Space", "Tab", "Backspace", "Delete",
+ "PageUp", "PageDown", "Mouse3", "Mouse4", "Mouse5",
+ "HOME", "Codex", "CLI", "TUI"
+]);
+
+function latinWords(text) {
+ return [...text.matchAll(/[A-Za-z][A-Za-z0-9]*/g)].map((match) => match[0])
+ .filter((word) => !allowedLatin.has(word) && !/^F\d{1,2}$/.test(word));
+}
+
+async function hintKeys() {
+ const [canvas, reference] = await Promise.all([readFile(canvasPath, "utf8"), readFile(referencePath, "utf8")]);
+ const aside = canvas.slice(canvas.indexOf('