TextMarksTheSpot (Метка для содержания)

Зрячие читатели могут взглянуть на веб-страницу и за пару секунд найти место, где начинается основное содержание. Они просто не замечают меню, баннер с куки-файлами и список похожих материалов. Пользователи экранных дикторов всегда были вынуждены проходить через все эти элементы по одному.

Text Marks the Spot выполняет эту работу за вас. Когда страница загружается, курсор перемещается к началу основного содержания, и NVDA читает его. Никаких нажатий клавиш не требуется. После этого вы можете пользоваться обычными клавишами NVDA.

Всё работает локально. Без сетевых запросов, без искусственного интеллекта, без телеметрии.

Услышьте в действии

Короткий аудиофрагмент работы дополнения на трёх веб-страницах (mp3).

Скачать и установить

Скачать Text Marks the Spot.

Откройте скачанный файл. NVDA предложит установить дополнение. Подтвердите установку и перезапустите NVDA, когда программа попросит.

Чтобы удалить дополнение позже: NVDA → Сервис → Управление дополнениями → выберите Text Marks the Spot → Удалить → перезапустите NVDA.

Если вы предпочитаете выбрать конкретную версию, страница релизов содержит их полный список.

Дополнение также подано на публикацию в магазин дополнений NVDA. После его принятия NVDA будет автоматически обновлять дополнение за вас.

Как это работает

Когда страница завершает загрузку в режиме обзора, дополнение анализирует структуру страницы и определяет её тип. Для статьи выбирается одна позиция, для списка материалов — другая, для формы или страницы с подтверждением — своя.

Если дополнение не уверено в назначении страницы, оно не вмешивается, и обычные клавиши NVDA работают как всегда. Неверное предположение хуже, чем его отсутствие.

Что оно делает

Позиция курсора зависит от типа страницы:

• Статья (Википедия, новость, запись в блоге): курсор перемещается к первому смысловому абзацу, и NVDA читает его. Вы пропускаете меню, баннер с куки-файлами и ссылку «перейти к основному содержанию» без нажатия H или P.
• Список или индексная страница (главная новостная страница, результаты поиска, сетка карточек): курсор перемещается к первому заголовку, чтобы вы могли начать просмотр с помощью H. Авточтение не выполняется.
• Страница с формой (регистрация, вход, контактная форма): объявляется заголовок формы, и фокус перемещается на первое поле.
• Статусная страница (закрытая форма, «спасибо за отправку», страница обслуживания, 404): курсор устанавливается на предложение со статусом.
• Виджет с результатом (тест скорости, погода, котировка акций, уровень заряда батареи): курсор устанавливается на подпись, чтобы значение было прочитано при следующем нажатии стрелки.
• Поле поиска уже в фокусе: дополнение бездействует. Сайт уже определил, с чего вам начинать.
• Видеоплеер, панель управления, приложение или что-либо нераспознанное: дополнение бездействует.

Команды клавиатуры

Дополнение назначает три жеста. Все остальные клавиши NVDA работают как обычно.

• Z в режиме обзора: переход вперёд от курсора к следующему смысловому абзацу. Дополнение пропускает заголовки (используйте для них H NVDA), а также пропускает рекламу, меню и кнопки «поделиться».
• Shift+Z в режиме обзора: возврат к месту, куда дополнение поместило вас на этой странице. Быстрый прыжок назад.
• NVDA+Z в режиме обзора: добавление или удаление текущего сайта из списка исключений. NVDA запрашивает подтверждение перед изменением. На исключённом сайте нажмите Z дважды быстро, чтобы выполнить однократное определение без изменения списка.

Вне режима обзора (терминалы, поля ввода, обычные приложения) Z вводит обычную букву.

Советы и хитрости

• Курсор автоматически устанавливается на первый смысловой абзац. Если выбор оказался неверным, нажмите H NVDA, чтобы найти нужный заголовок раздела, затем нажмите Z, чтобы перейти к первому абзацу под ним.
• Shift+Z в любой момент возвращает вас туда, куда дополнение поместило вас изначально. Полезно после перемещения стрелками, если вы хотите начать заново.
• На медленно загружающихся сайтах (Gmail, некоторые новостные страницы) содержание иногда появляется после первого сканирования дополнения. Дополнение автоматически выполняет повторное сканирование примерно через полторы секунды. Вы также можете нажать Z, чтобы инициировать новое сканирование с текущей позиции.
• NVDA+S переключает режим речи NVDA, и дополнение учитывает это. В режиме сигналов NVDA издаёт звуковые сигналы для каждой строки. В выключенном режиме курсор всё равно перемещается, но речь не озвучивается.

Отключение на нежелательном сайте

Нажмите NVDA+Z в режиме обзора. NVDA спросит, хотите ли вы добавить текущий сайт в список исключений. Нажмите Y для подтверждения. После этого дополнение будет бездействовать на этом сайте.

Чтобы снова включить сайт, снова нажмите на нём NVDA+Z.

Для однократного определения на исключённом сайте нажмите Z дважды подряд. Дополнение выполнит определение один раз, не изменяя ваш список исключений.

Визуальное отображение позиции курсора

Если у вас есть остаточное зрение, NVDA может обводить курсор цветной рамкой. Откройте Параметры -> Настройки -> Отображение и включите «Выделять фокус» или «Выделять курсор обзора». Полезно для слабовидящих пользователей, а также для демонстрации работы дополнения зрячим коллегам, родственникам или клиентам.

Известные ограничения

• Электронная почта пока не поддерживается. На данный момент дополнение работает только с веб-страницами. Поддержка электронной почты находится в планах.
• Очень короткие страницы (визитки, страницы только с контактами). Дополнение бездействует, поскольку не находит существенного содержания для позиционирования. Ваши обычные клавиши NVDA работают как всегда.
• Медленно загружающиеся страницы (Gmail, одностраничные приложения). Содержание иногда появляется после первого сканирования дополнения. Оно выполняет повторное сканирование автоматически. Вы также можете нажать Z, чтобы инициировать новое сканирование.
• Статьи, введение в которых находится в необычном месте. На некоторых сайтах (например, Apple Support) введение статьи находится там, где дополнение не может его обнаружить. Курсор устанавливается на следующий абзац. Используйте Shift+H для возврата к заголовку страницы и перемещайтесь стрелкой вниз, чтобы прочитать введение.

Сообщение об ошибках и получение помощи

Откройте вопрос на GitHub, если что-то работает не так, как вы ожидаете.

Наиболее полезным сообщение об ошибке будет, если оно содержит:

• Версию дополнения (отображается в менеджере дополнений NVDA)
• Вашу версию NVDA
• URL-адрес, на котором произошла проблема (если он не является приватным)
• Краткое описание того, что вы услышали и что ожидали услышать

Если вы предпочитаете не публиковать сообщение публично, напишите по адресу help@webfriendlyhelp.com. В любом случае я свяжусь с вами.

Для вопросов, идей или общих отзывов используйте вкладку Discussions в том же репозитории.

Конфиденциальность

Всё работает локально. Без сетевых запросов, без телеметрии, без сбора данных.

Совместимость

NVDA 2024.1 или новее. Последнее тестирование проводилось с NVDA 2026.1.1. Чистый Python, без нативных библиотек. Работает в 32-битной и 64-битной версиях NVDA.

Лицензия

GPL v2.

Автор

Кейси Мэтьюз (Casey Mathews). Web Friendly Help LLC. help@webfriendlyhelp.com.

Сертифицированный эксперт NVDA (2017, 2019, 2022, 2025).

Для разработчиков

См. файлы SPEC.md и CLAUDE.md в репозитории проекта для ознакомления с документом дизайна, инструкциями по сборке и примечаниями для участников.