Дополнение NVDA PDF Reader – Документация

Версия 0.1.0

Дополнение PDF Reader превращает NVDA в полноценную среду для чтения и управления PDF-документами, созданную с учётом максимальной доступности. Оно предоставляет незрячим и слабовидящим пользователям мощные инструменты для извлечения текста, навигации, аннотирования, оптического распознавания символов, высококачественного синтеза речи и манипуляции документами — всё это через интуитивно понятный интерфейс диалогов и множество горячих клавиш.

Содержание

1. Обзор
2. Список возможностей
3. Установка
4. Первые шаги
5. Панель PDF Reader
6. Справочник по меню
7. Оптическое распознавание символов (OCR)
8. Синтез речи и чтение вслух
9. Экспорт документов
10. Диалог настроек
11. Горячие клавиши
12. Системные требования
13. Поддержка и сообщество
14. Конфиденциальность

Обзор

Дополнение PDF Reader превращает NVDA в многофункциональную рабочую станцию для работы с PDF. Оно открывает стандартные PDF-файлы (включая защищённые паролем), извлекает текст в нескольких режимах чтения и позволяет перемещаться по документу, искать, создавать закладки, делать аннотации и экспортировать документы. Встроенное OCR обеспечивает чтение отсканированных или графических PDF, а голоса Microsoft Edge TTS предоставляют естественное звучание при чтении вслух. Инструменты манипуляции документами позволяют поворачивать, удалять, объединять, разделять страницы, добавлять водяные знаки, редактировать конфиденциальный текст и извлекать встроенные изображения.

Все действия доступны через чётко подписанные кнопки, контекстные меню и настраиваемые сочетания клавиш. Навигатор по меню (Ctrl+Shift+M) обеспечивает быстрый доступ к любому меню прямо из области текста. Прогресс чтения, закладки, заметки и настройки автоматически сохраняются и восстанавливаются между сеансами.

Список возможностей

• Импорт PDF в нескольких форматах – открывайте PDF-файлы, включая защищённые паролем, через диалог выбора файлов или из списка недавно использованных.
• Пять режимов извлечения текста – Блоки, Текст, Слова, HTML и Структурированный – для адаптации к разным макетам документов.
• Профили извлечения – профили «По умолчанию», «Простой», «Подробный», «Только OCR» и «Чистый», которые фильтруют и форматируют извлечённый текст.
• Встроенное OCR (Tesseract) – распознавание отсканированных страниц с автоматическим определением установки Tesseract; при необходимости возможен ручной выбор.
• Синтез речи с Edge TTS – чтение текущей страницы вслух с использованием нейросетевых голосов; полный контроль над голосом, скоростью, высотой и громкостью; предварительное прослушивание голоса.
• Создание аудиокниг – экспорт страниц или всего документа в MP3 с выбранными настройками TTS.
• Расширенный поиск – поиск по всем страницам или в пределах текущей страницы; поддержка учёта регистра, целых слов, регулярных выражений и истории поиска.
• Поиск и замена – замена фрагментов на текущей странице непосредственно внутри PDF с сохранением структуры документа.
• Менеджер закладок – добавление, переименование, удаление, переход к закладкам и их экспорт с пользовательскими названиями.
• Ведение заметок – прикрепление многострочных заметок к любой странице.
• Навигация по оглавлению – просмотр структуры документа в виде дерева и переход к любому разделу.
• Экспорт в нескольких форматах – экспорт в TXT, DOCX, HTML, JSON, CSV (таблицы) и MP3 (аудиокнига) с возможностью включения заметок и текста OCR.
• Манипуляции с документом – поворот страниц, удаление страниц, извлечение диапазонов страниц, объединение PDF, разделение на отдельные страницы, извлечение изображений, сохранение страницы как изображение, добавление текстовых водяных знаков, редактирование конфиденциального текста.
• Текстовые аннотации – добавление видимых текстовых аннотаций на страницы PDF и сохранение новой аннотированной копии.
• Защита паролем – шифрование PDF с помощью AES-256 и заданного пользователем пароля.
• Визуальная настройка – высокая контрастность, инверсия цветов, тёмный режим, регулируемый размер шрифта и уровень масштабирования.
• Раздельный просмотр – отображение двух последовательных страниц рядом для сравнения.
• Автопрокрутка – автоматическое перелистывание страниц с настраиваемой скоростью.
• Статистика документа – общее количество слов, символов, изображений, ссылок и средние значения на страницу.
• Сравнение страниц – сравнение количества слов и символов на нескольких указанных страницах.
• Извлечение ссылок – сбор и сохранение всех гиперссылок из документа.
• Перевод текста – перевод содержимого текущей страницы через Google Translate.
• История чтения – автоматическое предложение продолжить чтение и постоянное отслеживание прогресса.
• Список недавних файлов – быстрый доступ к последним 15 открытым PDF.
• Навигатор по меню – (Ctrl+Shift+M) открывает список всех меню для быстрого доступа.
• Просмотр метаданных – отображение и копирование свойств PDF-документа.
• Постоянные настройки – все предпочтения сохраняются в локальном JSON-файле.
• Доступные диалоги – все элементы управления имеют подписи и доступны с клавиатуры; диалоги прогресса предоставляют обновления статуса в реальном времени.

Установка

1. Скачайте файл .nvda-addon для PDF Reader.
2. Запустите NVDA (если он ещё не запущен), нажав Control+Alt+N или используя меню «Пуск».
3. Откройте меню NVDA с помощью NVDA+N, перейдите в Сервис и выберите Менеджер дополнений.
4. В менеджере дополнений нажмите кнопку Установить.
5. Перейдите к скачанному файлу дополнения, выберите его и нажмите Enter.
6. Подтвердите установку, выбрав Да. NVDA попросит перезапуститься; нажмите Enter для перезапуска.
7. После перезапуска дополнение готово к работе. Доступ к нему осуществляется через NVDA+Alt+P или меню Сервис.

Первые шаги

Нажмите NVDA+Alt+P, чтобы открыть главный диалог PDF Reader. Оттуда вы можете импортировать PDF, продолжить чтение последнего файла или выбрать из списка недавних. Альтернативно, используйте меню NVDA Сервис и выберите PDF Reader.

После открытия PDF появляется Панель PDF Reader, отображающая содержимое документа и набор панелей инструментов и кнопок. Панель можно закрыть с помощью Ctrl+W, Escape или кнопки Закрыть панель читалки.

Панель PDF Reader

Это основная рабочая область. Она содержит:

• Кнопки панели инструментов – Файл, Правка, Вид, Сервис, Навигация, Манипуляции, Настройки, Справка. Каждая открывает раскрывающееся меню.
• Информационная панель – показывает текущую страницу / общее количество страниц и раскрывающийся список Режим чтения.
• Область отображения текста – текстовое поле только для чтения, показывающее извлечённое содержимое. Вы можете выделять текст, перемещаться и использовать стандартные команды обзора.
• Строка навигации – кнопки «Предыдущая» / «Следующая», раскрывающийся список номеров страниц и кнопка «Перейти» для перехода к определённой странице.
• Кнопки быстрых действий – быстрый доступ к поиску, закладкам, оглавлению, OCR, экспорту, заметкам и чтению вслух.
• Строка состояния – режим чтения, уровень масштабирования, позиция курсора и длина текста.

Внутри области текста вы можете нажать Ctrl+Shift+M, чтобы открыть Навигатор по меню – список всех меню и настроек для немедленного доступа.

Справочник по меню

Меню «Файл»

• Импортировать PDF (Ctrl+I) – открыть другой PDF, закрыв текущий.
• Экспорт (Ctrl+Shift+E) – открыть диалог экспорта.
• Свойства (Ctrl+M) – просмотр метаданных документа (название, автор, количество страниц, размер файла и т.д.).
• Защитить PDF – добавить пароль и сохранить зашифрованную копию.
• Закрыть (Ctrl+W) – закрыть панель читалки.

Меню «Правка»

• Найти (Ctrl+F) – открыть диалог поиска с параметрами.
• Найти далее (F3) – перейти к следующему результату поиска.
• Найти ранее (Shift+F3) – перейти к предыдущему результату.
• Найти и заменить – введите текст для поиска и замены; замена выполняется непосредственно на текущей странице путём вычёркивания старого текста и вставки нового на его место.
• Скопировать текст страницы (Ctrl+C) – скопировать текст текущей страницы (или выделенный фрагмент) в буфер обмена.
• Скопировать весь текст (Ctrl+Shift+C) – скопировать текст со всех страниц.
• Выделить выделение (Ctrl+Shift+L) – добавить аннотацию выделения для выбранного текста на текущей странице.

Меню «Вид»

• Увеличить (Ctrl+Plus) / Уменьшить (Ctrl+Minus) / Сбросить масштаб (Ctrl+0) – изменение размера текста.
• Высокая контрастность (Ctrl+H) – переключение отображения заглавными буквами.
• Инвертировать цвета (Ctrl+Shift+I) – реверсирование порядка текста.
• Тёмный режим – переключение тёмного фона со светлым текстом.
• Раздельный просмотр (Ctrl+Shift+V) – отображение второй панели со следующей страницей.

Меню «Сервис»

• OCR (Ctrl+Shift+O) – запуск оптического распознавания символов.
• Профиль извлечения (Ctrl+Shift+P) – переключение между профилями обработки текста.
• Читать вслух (Ctrl+R) – запуск/остановка чтения страницы.
• Автопрокрутка (Ctrl+Shift+A) – автоматическое перелистывание страниц.
• Сравнить страницы (Ctrl+Shift+C) – сравнение количества слов и символов для указанных страниц.
• Статистика (Ctrl+Shift+S) – отображение диалога статистики документа.
• Перевести страницу (Ctrl+Shift+T) – перевод текущей страницы на другой язык.
• Извлечь ссылки – сохранение всех ссылок в текстовый файл.
• Предпросмотр голоса – воспроизведение короткого образца TTS с текущими настройками.
• Вычеркнуть текст – полное удаление всех вхождений заданного текста из всего документа.

Меню «Навигация»

• Закладки (Ctrl+B) – добавить закладку.
• Менеджер закладок (Ctrl+Shift+B) – открыть список закладок для редактирования, перехода, экспорта.
• Экспортировать закладки – сохранить закладки в текстовый файл.
• Оглавление (Ctrl+T) – открыть структурированное дерево оглавления.
• Аннотации (Ctrl+Shift+N) – просмотр сохранённых аннотаций.
• Выделения (Ctrl+Shift+H) – просмотр выделений.
• Перейти к странице (Ctrl+G) – ввести номер страницы.
• Предыдущая страница (Alt+PageUp) / Следующая страница (Alt+PageDown).

Меню «Манипуляции»

• Добавить аннотацию – открывает диалог с кнопками Добавить и Отмена; текстовая аннотация помещается на текущую страницу, и документ сохраняется как новый PDF.
• Повернуть страницу по часовой стрелке / против часовой стрелки – поворот текущей страницы на 90 градусов.
• Удалить текущую страницу – удаление страницы (с подтверждением).
• Извлечь страницы – создание нового PDF из диапазона страниц.
• Объединить PDF – объединение другого PDF с текущим документом.
• Разделить PDF – сохранение каждой страницы в отдельный PDF-файл.
• Извлечь изображения – сохранение всех встроенных изображений в папку.
• Сохранить страницу как изображение – преобразование текущей страницы в PNG высокого разрешения.
• Добавить водяной знак – наложение диагонального текстового водяного знака на все страницы.

Оптическое распознавание символов (OCR)

Когда PDF содержит отсканированные изображения, используйте OCR для извлечения читаемого текста:

1. Нажмите Ctrl+Shift+O или кнопку OCR.
2. Выберите Текущая страница, Все страницы или Диапазон страниц (укажите начало и конец).
3. Нажмите «Старт». Дополнение сначала ищет Tesseract в стандартных путях установки (C:\Program Files\Tesseract-OCR\tesseract.exe и C:\Program Files (x86)\Tesseract-OCR\tesseract.exe). Если не найден, вам будет предложено указать исполняемый файл вручную.
4. Диалог прогресса показывает статус OCR. Результаты кэшируются; повторный запуск OCR на той же странице использует кэш.
5. После обработки профиль извлечения автоматически переключается на Только OCR, отображая распознанный текст. Позже вы можете переключиться обратно на другие профили.

Синтез речи и чтение вслух

Дополнение использует Microsoft Edge TTS для высококачественного синтеза речи. Настройте его в диалоге настроек (вкладка Синтез речи):

• Голос – выберите из списка. Нажмите Получить последние голоса, чтобы загрузить полный каталог с серверов Microsoft; список сохраняется локально.
• Скорость – от –50% до +50%.
• Высота тона – от –20 Гц до +20 Гц.
• Громкость – от 0 до 100 (на вкладке «Дополнительно»).

Чтобы начать чтение, нажмите Ctrl+R или кнопку Читать. Метка кнопки меняется на Стоп; нажмите снова, чтобы остановить. По завершении воспроизведения чтение останавливается автоматически. Используйте Предпросмотр голоса из меню «Сервис», чтобы прослушать короткий образец.

Экспорт аудиокниги (MP3) также учитывает эти настройки TTS; разбивку на фрагменты для больших документов можно включить на вкладке дополнительных настроек.

Экспорт документов

Чтобы экспортировать содержимое, нажмите кнопку «Экспорт» или Ctrl+Shift+E. В диалоге:

• Формат – TXT, DOCX, MP3 (аудиокнига), CSV (таблицы), JSON, HTML.
• Область – текущая страница, весь PDF или отмеченные страницы.
• Параметры – включать заметки, включать текст OCR.

После выбора места сохранения индикатор прогресса показывает статус экспорта. Для DOCX требуется библиотека python-docx. Для CSV необходимы pdfplumber и pandas; экспорт извлекает таблицы из выбранных страниц.

Диалог настроек

Все настройки сохраняются автоматически. Диалог имеет три вкладки:

• Общие – уровень масштабирования, размер шрифта, высокая контрастность, инверсия цветов, скорость автопрокрутки, профиль извлечения по умолчанию.
• Синтез речи – выбор голоса (с кнопкой получения), скорость, высота тона.
• Дополнительно – каталог экспорта по умолчанию, громкость TTS (0‑100), включение/отключение разбивки TTS на фрагменты.

После нажатия OK настройки применяются немедленно и сохраняются.

Горячие клавиши

Поддержка и сообщество

По вопросам, отзывам или помощи:

• Используйте диалог Справка (F1) внутри читалки для получения полного справочника по горячим клавишам.
• Присоединяйтесь к Telegram-каналу Blind Tech Nexus по адресу https://t.me/blindtechvisionary для связи с другими пользователями и разработчиком.

Ваши предложения помогают формировать будущие обновления. Пожалуйста, делитесь опытом и сообщайте о любых проблемах через канал.

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

Это дополнение работает полностью в автономном режиме. Никакое содержимое документов, личные данные или статистика использования не собираются и не передаются. Получение списка голосов подключается к серверам Microsoft только тогда, когда вы явно нажимаете кнопку Получить последние голоса. Вся обработка PDF, OCR и генерация аудио TTS происходят локально на вашем компьютере.

Дополнение NVDA PDF Reader – Версия 0.1.0 – Создано для доступности.