Дополнение 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 происходят локально на вашем компьютере.

Примечание: Дополнение включает несколько библиотек с открытым исходным кодом. Если ваше антивирусное программное обеспечение блокирует эти компоненты, пожалуйста, разрешите папку дополнения или конкретные DLL/исполняемые файлы. Функция OCR зависит от работающей установки Tesseract; если автоматическое обнаружение не удалось, вы можете вручную указать файл tesseract.exe.

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