Синтезатор Капитан

Синтезатор речи для программы экранного доступа NVDA на базе синтезатора Капитан Геннадия Нефёдова.

Содержание

• 1. Введение
  • 1.1. Основные возможности
  • 1.2. Лицензия и авторские права
  • 1.3. Лица, внёсшие вклад
  • 1.4. История версий
• 2. Системные требования
  • 2.1. Режим ограниченной функциональности в NVDA ниже 2019.3
• 3. Настройки синтезатора
  • 3.1. Диалог настроек речи
  • 3.2. Сервисное меню
  • 3.3. Конфигурационные файлы
    • 3.3.1. Файл конфигурации (config.txt)
    • 3.3.2. Словари синтезатора (*_dict.txt)
    • 3.3.3. Описания букв (*_letters.txt)
    • 3.3.4. Описания небуквенных символов (*_symbols.txt)

1. Введение

Капитан — это бесплатный гибко конфигурируемый компактный синтезатор, который ориентирован на обеспечение высокопроизводительной работы пользователей программ экранного доступа за счёт мгновенного отклика и «механического» голоса, сохраняющего членораздельность речи на большой скорости чтения.

1.1. Основные возможности

1. Синтез речи на русском и украинском языках с регулировкой скорости, громкости и высоты голоса (поддержка украинского реализована на основе русской фонемной базы).
2. Поддержка расширенного набора буквенных символов, включающего всю кириллицу, латиницу и греческий алфавит, в том числе буквы с диакритическими знаками и вариантные формы букв.
3. Поддержка функции автоматического переключения языков на лету, если читаемый текст содержит соответствующую разметку.
4. Настраиваемый вариант обработки некириллического текста: русская транслитерация латиницы, подражание английскому произношению и перенаправление на встроенный в NVDA синтезатор речи eSpeak NG или установленный в системе синтезатор стандарта SAPI5.
5. Отдельные от NVDA пользовательские словари замены, а также механизм конфигурирования описаний букв и небуквенных символов, дифференцированные по языкам и вариантам обработки латиницы.
6. Отдельно настраиваемые паузы в речи: между словами, между частями предложений и между предложениями.
7. Ряд дополнительных настроек произнесения букв, цифр и прочих неалфавитных символов.

1.2. Лицензия и авторские права

Copyright © Nikita Tseykovets tseikovets@rambler.ru
Copyright © Anatol Kamynin ak@tiflocomp.ru

Используя и распространяя это дополнение для программы экранного доступа NVDA (в дальнейшем именуемое «Дополнение»), вы принимаете следующие условия:

1. ДОПОЛНЕНИЕ ПОСТАВЛЯЕТСЯ ПО ПРИНЦИПУ «КАК ЕСТЬ», БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ (ЯВНЫХ ИЛИ ПОДРАЗУМЕВАЕМЫХ). ВСЕ РИСКИ, СВЯЗАННЫЕ С ИСПОЛЬЗОВАНИЕМ И РАСПРОСТРАНЕНИЕМ ЭТОГО ДОПОЛНЕНИЯ, ВЫ ПРИНИМАЕТЕ НА СЕБЯ.
2. Дополнение распространяется безвозмездно. Вы можете распространять Дополнение также только на безвозмездной основе. Дополнение не может быть предметом (или частью предмета) какой-либо возмездной сделки, включая, помимо прочего, взимание платы за носитель и услуги доставки или установки.
3. Условия повторного распространения Дополнения должны соответствовать тем условиям, на которых это Дополнение было получено изначально. Повторное распространение Дополнения допускается только при сохранении целостности исходного дистрибутива, включая, помимо прочего, все лицензии и уведомления об авторских правах.
4. Дополнение включает в себя компоненты, имеющие собственные лицензии. Такие компоненты являются собственностью их авторов, и данная лицензия на них не распространяется. Во всех иных случаях все условия данной лицензии относятся как к Дополнению в целом, так и ко всем его компонентам в отдельности. Используя и распространяя Дополнение, вы принимаете лицензии как Дополнения, так и всех его компонентов.

Лицензии компонентов Дополнения:

• Плагины и драйверы NVDA, а также скрипт установки дополнения: информация об авторах указана в прилагающихся файлах с исходным кодом; условия использования и распространения — GNU General Public License 2.
• Данные локализации интерфейса Дополнения (файлы manifest и ресурсы gettext): условия использования и распространения — CC0 1.0 Universal.
• Библиотека captaintts4nvda: бинарный компонент; Copyright Gennady Nefedov, Anatol Kamynin; условия использования и распространения — Лицензия Captain TTS for NVDA.
• Библиотека sonic: бинарный компонент; Copyright 2010 Bill Cox; условия использования и распространения— GNU Lesser General Public License 2.1.

1.3. Лица, внёсшие вклад

Список лиц, которые внесли свой вклад в развитие Капитана для NVDA различными способами с начала проекта, можно посмотреть по ссылке.

1.4. История версий

Список выпусков Капитана для NVDA с номерами версий, датами и описаниями изменений можно посмотреть по ссылке.

2. Системные требования

• Версия NVDA, начиная с 2012.3 и новее (в NVDA ниже 2019.3 синтезатор устанавливается и работает в режиме ограниченной функциональности).
• Около 800 килобайт дискового пространства.
• Операционная система и технические характеристики компьютера, соответствующие системным требованиям используемой версии NVDA (см. меню NVDA → Справка → Руководство пользователя → Системные требования).

2.1. Режим ограниченной функциональности в NVDA ниже 2019.3

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

Если дополнение устанавливается на NVDA ниже 2019.3, то при обновлении программы экранного доступа до 2019.3 и новее, синтезатор перестанет работать. Для восстановления его работоспособности потребуется переустановка из файла дополнения. Причём, предварительно рекомендуется выполнить удаление предыдущей установки через Менеджер дополнений (см. меню NVDA → Справка → Руководство пользователя → Менеджер дополнений). Пользовательские модификации конфигурационных файлов при этом потеряны не будут.

Кроме того, в NVDA ниже 2019.3 синтезатор будет работать в режиме ограниченной функциональности, а именно:

1. Не поддерживается обработка некириллического текста при помощи синтезатора eSpeak / eSpeak NG в NVDA ниже 2017.3.
2. Не поддерживается функция автоматического переключения языков в NVDA ниже 2019.3.
3. Не поддерживается ряд настроек синтезатора через диалог настроек речи в NVDA ниже 2019.3. Для их изменения следует редактировать файл конфигурации.

3. Настройки синтезатора

Настройка основных параметров синтезатора выполняется с помощью стандартного диалога настроек речи NVDA или кольца настроек синтезатора. Ряд специфичных опций вынесены в отдельное сервисное меню. Кроме того, тонкая настройка параметров синтезатора выполняется через редактирование конфигурационных файлов.

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

Основные настройки синтезатора вынесены в стандартную категорию «Речь» диалога настроек NVDA (см. меню NVDA → Справка → Руководство пользователя → Речь (NVDA+Control+V)), а также оперативно доступны, независимо от местонахождения, через кольцо настроек синтезатора (см. меню NVDA → Справка → Руководство пользователя → Кольцо настроек синтезатора).

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

Скорость

Стандартная опция NVDA, позволяющая изменять скорость речи синтезатора. Это ползунок, который регулируется от 0 до 100 (0 — самая медленная скорость, а 100 — самая быстрая).

Однако если максимальная скорость синтезатора для пользователя кажется недостаточно быстрой, то существует возможность увеличить шаг изменения скорости речи внутри диапазона от 51 до 100. Для этого в файле конфигурации следует отредактировать значение параметра rate.

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

Громкость

Стандартная опция NVDA, позволяющая изменять громкость речи синтезатора. Это ползунок, который регулируется от 0 до 100 (0 — самая низкая громкость, а 100 — самая высокая).

Однако если максимальная громкость синтезатора для пользователя кажется недостаточно высокой, то существует возможность увеличить шаг изменения громкости речи. Для этого в файле конфигурации следует отредактировать значение параметра volume.

Обработка некириллического текста

Дополнительная опция, позволяющая настроить вариант обработки текста, написанного некириллическими буквами. Это комбинированный список, в котором могут быть доступны следующие варианты:

• Транслитерация — текст, написанный латинскими буквами, будет читаться как русская транслитерация латинского с прямым соответствием фонетически схожих букв, например, «Captain synthesizer» как «Цаптаин сынтхесизер».
• Псевдоанглийский — текст, написанный латинскими буквами, будет читаться как подражание английскому произношению, например, «Captain synthesizer» как «Кэптэйн синсэсайзр». Однако в файле конфигурации при помощи параметра pseudo можно сделать чтение латиницы транслитерацией по правилам английского языка.
• Один или несколько пунктов «espeak: %language%: %code%», где на месте %language% находится английское название языка, а на месте %code% код этого языка. Это различные языковые версии синтезатора eSpeak NG, встроенного в используемую версию NVDA. В данном случае текст, написанный некириллическими буквами, будет произноситься синтезатором eSpeak NG в соответствии с выбранным языком.
• Один или несколько пунктов «sapi: %voice%», где на месте %voice% находится название голоса синтезатора речи стандарта SAPI5, установленного в системе. В данном случае текст, написанный некириллическими буквами, будет произноситься выбранным синтезатором SAPI5.

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

Синтезатор Капитан поддерживает обработку всех кириллических букв со всеми вариантными формами из следующих блоков Unicode:

• Cyrillic (400-4FF)
• Cyrillic Supplement (500-52F)
• Cyrillic Extended-C (1C80-1C8F)
• Cyrillic Extended-A (2DE0-2DFF)
• Cyrillic Extended-B (A640-A69F)

А также греческих букв из блока Greek and Coptic (370-03FF). Эти символы при любом варианте обработки некириллического текста будут читаться синтезатором Капитан, а все остальные могут быть перенаправлены на внешний синтезатор.

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

При перенаправлении некириллического текста на голос стандарта SAPI5, воспроизведение речи данного синтезатора будет осуществляться через то выходное аудиоустройство, которое задано в настройках преобразования текста в речь операционной системы Windows. В связи с этим пользователю следует убедиться, что данная настройка совпадает с настройкой устройства вывода в диалоге выбора синтезатора NVDA, через которое воспроизводится речь синтезатора Капитан (см. меню NVDA → Справка → Руководство пользователя → Выбор синтезатора (NVDA+Control+S)).

Возможность использовать встроенный в NVDA синтезатор eSpeak NG присутствует только в NVDA 2017.3 и новее.

Коррекция скорости второго голоса

Дополнительная опция, позволяющая скорректировать скорость речи второго голоса, который используется для обработки некириллического текста. Это комбинированный список, дающий выбрать числовое значение от -50 до 50 с шагом изменения 5. Выбранное значение складывается со значением опции основной скорости в диалоге настроек речи, и получившаяся сумма становится скоростью второго голоса.

Скорректированное значение не может выходить за рамки диапазона от 0 до 100. В случае, если сумма значений основной скорости и её коррекции выходит за эти границы, то фактическая скорость второго голоса будет установлена на уровне ближайшей границы допустимого диапазона.

Эта опция доступна только в NVDA 2019.3 и новее. В более старых версиях NVDA для изменения этой настройки следует в файле конфигурации редактировать значение параметра second_rate.

Коррекция высоты второго голоса

Дополнительная опция, позволяющая скорректировать высоту второго голоса, который используется для обработки некириллического текста. Это комбинированный список, дающий выбрать числовое значение от -50 до 50 с шагом изменения 5. Выбранное значение складывается со значением опции основной высоты в диалоге настроек речи, и получившаяся сумма становится высотой второго голоса.

Скорректированное значение не может выходить за рамки диапазона от 0 до 100. В случае, если сумма значений основной высоты и её коррекции выходит за эти границы, то фактическая высота второго голоса будет установлена на уровне ближайшей границы допустимого диапазона.

Эта опция доступна только в NVDA 2019.3 и новее. В более старых версиях NVDA для изменения этой настройки следует в файле конфигурации редактировать значение параметра second_pitch.

Коррекция громкости второго голоса

Дополнительная опция, позволяющая скорректировать громкость второго голоса, который используется для обработки некириллического текста. Это комбинированный список, дающий выбрать числовое значение от -50 до 50 с шагом изменения 5. Выбранное значение складывается со значением опции основной громкости в диалоге настроек речи, и получившаяся сумма становится громкостью второго голоса.

Скорректированное значение не может выходить за рамки диапазона от 0 до 100. В случае, если сумма значений основной громкости и её коррекции выходит за эти границы, то фактическая громкость второго голоса будет установлена на уровне ближайшей границы допустимого диапазона.

Эта опция доступна только в NVDA 2019.3 и новее. В более старых версиях NVDA для изменения этой настройки следует в файле конфигурации редактировать значение параметра second_volume.

Использовать словари синтезатора

Дополнительная опция, позволяющая воспользоваться внутренними словарями синтезатора Капитан, которые работают отдельно от словарей NVDA. Устанавливая или снимая этот флажок, можно включать или выключать использование словарей синтезатора.

Переключение этой опции также может быть выполнено быстро при помощи жеста ввода (клавиши на клавиатуре, кнопки на брайлевском дисплее и т. д.). Для этого в диалоге назначения жестов ввода в категории «Синтезатор Капитан» следует выбрать команду «Включает и выключает использование словарей синтезатора Капитан» и добавить для неё интересующий жест (см. меню NVDA → Справка → Руководство пользователя → Жесты ввода). Однако действие по жесту ввода не выполняется, если NVDA запущена в безопасном режиме (см. меню NVDA → Справка → Руководство пользователя → Дополнительные темы).

Эта опция и её быстрое переключение при помощи жеста ввода доступны только в NVDA 2019.3 и новее. В более старых версиях NVDA для изменения этой настройки следует в файле конфигурации редактировать значение параметра dict.

Пауза между словами

Дополнительная опция, позволяющая регулировать паузы между словами в синтезируемой речи. Это комбинированный список, дающий выбрать числовое значение от 0 до 100 с шагом изменения 5 (0 — отсутствие паузы, а 100 — самая большая пауза).

Паузы данного типа в речи синтезатора вставляются на месте знаков пробела.

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

Эта опция доступна только в NVDA 2019.3 и новее. В более старых версиях NVDA для изменения этой настройки следует в файле конфигурации редактировать значение параметра word_pause.

Пауза между частями предложений

Дополнительная опция, позволяющая регулировать паузы между частями предложений в синтезируемой речи. Это комбинированный список, дающий выбрать числовое значение от 0 до 200 с шагом изменения 10 (0 — отсутствие паузы, а 200 — самая большая пауза).

Паузы данного типа в речи синтезатора вставляются на месте следующих знаков препинания:

• Запятая: ,
• Точка с запятой: ;
• Двоеточие: :
• Длинное тире: —
• Короткое тире: –
• Левая и правая круглые скобки: ()
• Левая и правая квадратные скобки: []

Для срабатывания паузы на месте знака препинания необходимо, чтобы соответствующий символ передавался на синтезатор. Это определяется опцией «Передавать фактический символ на синтезатор» в диалоге настроек NVDA «Произношение символов/пунктуации» (см. меню NVDA → Справка → Руководство пользователя → Произношение символов/пунктуации).

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

Эта опция доступна только в NVDA 2019.3 и новее. В более старых версиях NVDA для изменения этой настройки следует в файле конфигурации редактировать значение параметра comma_pause.

Пауза между предложениями

Дополнительная опция, позволяющая регулировать паузы между предложениями в синтезируемой речи. Это комбинированный список, дающий выбрать числовое значение от 0 до 400 с шагом изменения 20 (0 — отсутствие паузы, а 400 — самая большая пауза).

Паузы данного типа в речи синтезатора вставляются на месте следующих знаков препинания:

• Точка: .
• Вопросительный знак: ?
• Восклицательный знак: !
• Многоточие: …

Для срабатывания паузы на месте знака препинания необходимо, чтобы соответствующий символ передавался на синтезатор. Это определяется опцией «Передавать фактический символ на синтезатор» в диалоге настроек NVDA «Произношение символов/пунктуации» (см. меню NVDA → Справка → Руководство пользователя → Произношение символов/пунктуации).

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

Эта опция доступна только в NVDA 2019.3 и новее. В более старых версиях NVDA для изменения этой настройки следует в файле конфигурации редактировать значение параметра dot_pause.

Автоматическое переключение языков

Это стандартная опция NVDA. Устанавливая или снимая этот флажок, можно включать или выключать автоматическое переключение языков на лету, если читаемый текст содержит соответствующую разметку. Однако данная функция поддерживается синтезатором только в NVDA 2019.3 и новее.

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

Переключение этой опции также может быть выполнено быстро при помощи жеста ввода (клавиши на клавиатуре, кнопки на брайлевском дисплее и т. д.). Для этого в диалоге назначения жестов ввода в категории «Синтезатор Капитан» следует выбрать команду «Включает и выключает автоматическое переключение языков по разметке» и добавить для неё интересующий жест (см. меню NVDA → Справка → Руководство пользователя → Жесты ввода). Однако действие по жесту ввода не выполняется, если NVDA запущена в безопасном режиме (см. меню NVDA → Справка → Руководство пользователя → Дополнительные темы).

3.2. Сервисное меню

После установки, дополнение синтезатора Капитан добавляет в интерфейс NVDA собственное сервисное меню, которое расположено по пути: меню NVDA → Сервис → Синтезатор Капитан. Опции данного меню предназначены для управления конфигурационными файлами синтезатора и получения дополнительной информации о нём.

Сервисное меню недоступно, если NVDA запущена в безопасном режиме (см. меню NVDA → Справка → Руководство пользователя → Дополнительные темы).

Просмотреть конфигурационные файлы

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

Операция просмотра всех файлов также может быть выполнена быстро при помощи жеста ввода (клавиши на клавиатуре, кнопки на брайлевском дисплее и т. д.). Для этого в диалоге назначения жестов ввода в категории «Синтезатор Капитан» следует выбрать команду «Открывает директорию конфигурационных файлов синтезатора Капитан» и добавить для неё интересующий жест (см. меню NVDA → Справка → Руководство пользователя → Жесты ввода). Однако действие по жесту ввода не выполняется, если NVDA запущена в безопасном режиме (см. меню NVDA → Справка → Руководство пользователя → Дополнительные темы).

Восстановить конфигурационные файлы

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

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

Просмотреть журнал

Если используется установленная копия NVDA, то данный элемент меню будет являться подменю, в котором будут доступны два пункта для открытия пользовательского и системного журналов синтезатора. Если же используется переносная копия NVDA, то данный элемент меню будет просто пунктом, открывающим пользовательский журнал синтезатора. Файлы журнала открываются в текстовом редакторе по умолчанию. Данные файлы пишутся во время работы синтезатора в режиме отладки, который включается через файл конфигурации при помощи параметра debug.

Операция просмотра пользовательского или системного журнала также может быть выполнена быстро при помощи жеста ввода (клавиши на клавиатуре, кнопки на брайлевском дисплее и т. д.). Для этого в диалоге назначения жестов ввода в категории «Синтезатор Капитан» следует выбрать соответствующую команду (либо «Открывает пользовательский журнал синтезатора Капитан», либо «Открывает системный журнал синтезатора Капитан») и добавить для неё интересующий жест (см. меню NVDA → Справка → Руководство пользователя → Жесты ввода). Однако действие по жесту ввода не выполняется, если NVDA запущена в безопасном режиме (см. меню NVDA → Справка → Руководство пользователя → Дополнительные темы). Кроме того, просмотр системного журнала будет доступен только при использовании установленной копии NVDA.

Справка

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

Это действие аналогично нажатию кнопки «Справка по дополнению» в Менеджере дополнений (см. меню NVDA → Сервис → Менеджер дополнений). Однако, в отличие от менеджера дополнений, эта опция сервисного меню всегда доступна, даже если файл справки на текущем языке NVDA отсутствует. В последнем случае будет открыта справка на английском языке.

Страница дополнения в Интернете

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

3.3. Конфигурационные файлы

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

Конфигурационные файлы синтезатора Капитан — это обычные текстовые файлы с расширением .txt в кодировке UTF-8 (допускается вариант как с BOM, так и без BOM). Открыть их место хранения и просмотреть каждый файл по-отдельности можно через подменю «Просмотреть конфигурационные файлы», доступное в сервисном меню. Там же при помощи подменю «Восстановить конфигурационные файлы» можно вернуть их к состоянию по умолчанию, если, например, был сделан большой объём нежелательных изменений.

Обрабатываемые конфигурационные файлы синтезатора находятся в директории captaintts_data, которая располагается в папке настроек текущего пользователя NVDA. Если путь для сохранения всех настроек NVDA изменён при помощи специального параметра запуска, то и конфигурационные файлы также будут искаться по соответствующему изменённому пути (см. меню NVDA → Справка → Руководство пользователя → Ключи командной строки).

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

3.3.1. Файл конфигурации (config.txt)

Файл config.txt предназначен для задания основных параметров синтезатора. При редактировании файла необходимо учитывать следующие правила:

• Каждый параметр задаётся на отдельной строке и состоит из пары названия параметра и его значения, разделённых знаком равенства (=).
• В именах параметров и их значениях пробелы не допускаются, то есть знаков пробела в принципе не должно быть в строке, задающей какой-либо параметр.
• Аналогичные настройки, сделанные через диалог настроек речи и сохранённые в настройках NVDA, перекрывают настройки из файла config.txt, так как параметры из файла конфигурации Капитана устанавливаются один раз в момент инициализации синтезатора.
• Строки, начинающиеся с символа решётки (#), считаются однострочными комментариями, так что не обрабатываются.
• Если файл сохранён в кодировке с BOM, то на первой строке не должен задаваться параметр, потому что он будет проигнорирован. В целом, рекомендуется оставлять первую строку файла пустой или писать в ней комментарий.

Параметр rate

Данный параметр задаёт первоначальную скорость речи синтезатора, а также коэффициент её изменения в верхней половине шкалы настройки. Его допустимым значением является целое число от 0 до 100, а также необязательное второе целое число от 100 до 200, добавляемое к первому через точку с запятой (без пробела). Значение по умолчанию — 50;100.

• Первое число определяет значение скорости синтезатора от 0 до 100 при его первичной инициализации. Однако поскольку в диалоге настроек речи всегда уже задано какое-то значение, то именно оно и будет сразу же применено, так что изменение данного числа в файле конфигурации ни к каким заметным изменениям не приведёт.
• Второе число определяет чувствительность фактической скорости синтезатора к изменению соответствующей настройки в диапазоне от 51 до 100 и может принимать значения от 100 до 200. При изменении настройки скорости на 1, фактическая скорость синтезатора будет меняться на результат деления этого числа на 100, например:
  • rate=50;100 — изменение настройки скорости на 1 будет изменять фактическую скорость в верхней половине шкалы также на 1, так как 100/100 = 1.
  • rate=50;150 — изменение настройки скорости на 1 будет изменять фактическую скорость в верхней половине шкалы на 1,5, так как 150/100 = 1,5. Данный коэффициент масштабирования шкалы скорости распространяется только на голос синтезатора Капитан.

Таким образом, редактируя второе число в значении данного параметра, можно изменять эластичность фактической скорости по отношению к соответствующей настройке в диапазоне от 51 до 100. В частности, при максимально допустимом значении 200 можно получить удвоение максимальной скорости речи синтезатора.

Параметр volume

Данный параметр задаёт первоначальную громкость речи синтезатора, а также коэффициент её изменения. Его допустимым значением является целое число от 0 до 100, а также необязательное второе целое число от 100 до 200, добавляемое к первому через точку с запятой (без пробела). Значение по умолчанию — 50;100.

• Первое число определяет значение громкости синтезатора от 0 до 100 при его первичной инициализации. Однако поскольку в диалоге настроек речи всегда уже задано какое-то значение, то именно оно и будет сразу же применено, так что изменение данного числа в файле конфигурации ни к каким заметным изменениям не приведёт.
• Второе число определяет чувствительность фактической громкости синтезатора к изменению соответствующей настройки и может принимать значения от 100 до 200. При изменении настройки громкости на 1, фактическая громкость синтезатора будет меняться на результат деления этого числа на 100, например:
  • volume=50;100 — изменение настройки громкости на 1 будет изменять фактическую громкость также на 1, так как 100/100 = 1.
  • volume=50;150 — изменение настройки громкости на 1 будет изменять фактическую громкость на 1,5, так как 150/100 = 1,5. Данный коэффициент масштабирования шкалы громкости распространяется как на голос синтезатора Капитан, так и на голос внешнего синтезатора, использующегося для обработки некириллического текста.

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

Параметр second_langs

Данный параметр определяет языки голосов синтезаторов eSpeak NG и SAPI5, которые будут доступны для выбора в опции «Обработка некириллического текста» в диалоге настроек речи. Параметр работает как фильтр, то есть он отбирает для показа в интерфейсе выбора только голоса для тех языков, которые в нём указываются.

Значением этого параметра является строка, в которой указывается один или несколько кодов языков. Значение по умолчанию — en.

Поддерживается возможность уточнения варианта языка, путём присоединения к основному языковому коду дополнительных кодов стран и диалектов через знак дефиса (-) или нижнего подчёркивания (_). Итоговый спецификатор языка из одного или нескольких кодов передаётся на eSpeak NG в неизменном виде, поэтому по написанию должен точно соответствовать одному из поддерживаемых им языков. Для голосов SAPI5 отбор языков будет идти сначала по первым двум кодам спецификатора, если же для такого спецификатора нет соответствующего языка, то только по первому коду.

Для указания нескольких языков их коды должны записываться через точку с запятой (;).

Если в качестве значения параметра указать знак звёздочки (*), то это будет трактоваться как полное отсутствие каких-либо правил фильтрации по языкам, в результате чего для выбора станут доступны абсолютно все варианты голосов eSpeak NG и SAPI5, установленные в системе.

Примеры указания second_langs с описанием результата:

• second_langs= — пустое значение. Трактуется как указание английского языка, то есть эквивалентно second_langs=en
• second_langs=en;fr;de — указание кодов английского, французского и немецкого через точку с запятой. Приведёт к выводу голосов для всех этих языков, если они доступны в системе.
• second_langs=en-gb — указание кода британского английского. Приведёт к выводу голосов только для британского варианта английского языка. Однако, если среди установленных в системе голосов SAPI5 не будет найден ни один голос для британского английского, то будет выведен результат поиска любых английских голосов, то есть эквивалентно second_langs=en
• second_langs=en-gb-x-rp — указание кода британского английского с нормативным произношением. Приведёт к выводу единственного соответствующего голоса eSpeak (English (Received Pronunciation)), а для SAPI5 будут учитываться значения только первых двух элементов спецификатора, то есть эквивалентно second_langs=en-gb
• second_langs=* — указание знака звёздочки для снятия любых фильтров. Приведёт к тому, что в комбинированном списке «обработка некириллического текста» будут показаны абсолютно все доступные варианты eSpeak и SAPI5 для любых языков. Рекомендуется использовать только в ознакомительных целях, например, чтобы посмотреть коды интересующих вариантов языков.
• second_langs=qwerty — указание несуществующего кода языка. Приведёт к тому, что не будет показано ни одного голоса. Может использоваться для намеренной очистки комбинированного списка от любых внешних синтезаторов речи.

Параметр pseudo

Данный параметр отвечает за активацию псевдоанглийского произношения текста, написанного латинскими буквами. Допустимым значением этого параметра является 0, означающее отключение, или 1, означающее включение. Значение по умолчанию — 1.

Настройка относится только к варианту «Псевдоанглийский» в опции «Обработка некириллического текста» в диалоге настроек речи.

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

Вариант обработки некириллического текста «Псевдоанглийский» с отключённым псевдоанглийским произношением будет отличаться от варианта «Транслитерация» только именованием латинских букв их английскими, а не латинскими названиями, а также иным фонетическим значением двух букв:

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

Параметр second_rate

Данный параметр задаёт коррекцию скорости речи второго голоса, который используется для обработки некириллического текста. Его редактирование имеет смысл только при использовании синтезатора в NVDA ниже 2019.3, так как в NVDA 2019.3 и новее за данную настройку отвечает опция «Коррекция скорости второго голоса» в диалоге настроек речи.

Допустимым значением этого параметра является любое целое (положительное или отрицательное) число, а также 0. Значение по умолчанию — 0.

Указанное значение складывается со значением опции основной скорости в диалоге настроек речи, и получившаяся сумма становится скоростью второго голоса.

Скорректированное значение не может выходить за рамки диапазона от 0 до 100. В случае, если сумма значений основной скорости и её коррекции выходит за эти границы, то фактическая скорость второго голоса будет установлена на уровне ближайшей границы допустимого диапазона.

Параметр second_pitch

Данный параметр задаёт коррекцию высоты второго голоса, который используется для обработки некириллического текста. Его редактирование имеет смысл только при использовании синтезатора в NVDA ниже 2019.3, так как в NVDA 2019.3 и новее за данную настройку отвечает опция «Коррекция высоты второго голоса» в диалоге настроек речи.

Допустимым значением этого параметра является любое целое (положительное или отрицательное) число, а также 0. Значение по умолчанию — 0.

Указанное значение складывается со значением опции основной высоты в диалоге настроек речи, и получившаяся сумма становится высотой второго голоса.

Скорректированное значение не может выходить за рамки диапазона от 0 до 100. В случае, если сумма значений основной высоты и её коррекции выходит за эти границы, то фактическая высота второго голоса будет установлена на уровне ближайшей границы допустимого диапазона.

Параметр second_volume

Данный параметр задаёт коррекцию громкости второго голоса, который используется для обработки некириллического текста. Его редактирование имеет смысл только при использовании синтезатора в NVDA ниже 2019.3, так как в NVDA 2019.3 и новее за данную настройку отвечает опция «Коррекция громкости второго голоса» в диалоге настроек речи.

Допустимым значением этого параметра является любое целое (положительное или отрицательное) число, а также 0. Значение по умолчанию — 0.

Указанное значение складывается со значением опции основной громкости в диалоге настроек речи, и получившаяся сумма становится громкостью второго голоса.

Скорректированное значение не может выходить за рамки диапазона от 0 до 100. В случае, если сумма значений основной громкости и её коррекции выходит за эти границы, то фактическая громкость второго голоса будет установлена на уровне ближайшей границы допустимого диапазона.

Параметр dict

Данный параметр определяет использование словарей синтезатора. Допустимым значением этого параметра является 0, означающее отключение, или 1, означающее включение. Значение по умолчанию — 0.

Редактирование этого параметра имеет смысл только при использовании синтезатора в NVDA ниже 2019.3, так как в NVDA 2019.3 и новее за данную настройку отвечает опция «Использовать словари синтезатора» в диалоге настроек речи.

Параметр word_pause

Данный параметр задаёт паузы между словами в синтезируемой речи. Его редактирование имеет смысл только при использовании синтезатора в NVDA ниже 2019.3, так как в NVDA 2019.3 и новее за данную настройку отвечает опция «Пауза между словами» в диалоге настроек речи.

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

Параметр comma_pause

Данный параметр задаёт паузы между частями предложений в синтезируемой речи. Его редактирование имеет смысл только при использовании синтезатора в NVDA ниже 2019.3, так как в NVDA 2019.3 и новее за данную настройку отвечает опция «Пауза между частями предложений» в диалоге настроек речи.

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

Параметр dot_pause

Данный параметр задаёт паузы между предложениями в синтезируемой речи. Его редактирование имеет смысл только при использовании синтезатора в NVDA ниже 2019.3, так как в NVDA 2019.3 и новее за данную настройку отвечает опция «Пауза между предложениями» в диалоге настроек речи.

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

Параметр abbreviations

Данный параметр отвечает за активацию побуквенного чтения слов, состоящих из одних согласных букв. Допустимым значением этого параметра является 0, означающее отключение, или 1, означающее включение. Значение по умолчанию — 1.

При включённом побуквенном чтении, например, слово «ВЛКСМ» будет прочитано как [вэ эл ка эс эм], а при отключённом — как [влксм].

Параметр single_preposition

Данный параметр отвечает за активацию чтения слов, представляющих собой отдельно стоящую букву, как соответствующего звука, а не названия буквы. Допустимым значением этого параметра является 0, означающее отключение, или 1, означающее включение. Значение по умолчанию — 1.

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

Параметр number_size

Данный параметр задаёт максимальную длину чисел, которые будут читаться синтезатором как числа. Его допустимым значением является целое число от 1 до

12. Значение по умолчанию — 12.

С помощью этого параметра можно установить, начиная с какой разрядности, числа будут произноситься не как числа, а как набор отдельных цифр для облегчения их восприятия на слух. Например, при значении 4, число 1234 будет читаться как «одна тысяча двести тридцать четыре», а число 12345 уже как «один два три четыре пять».

Синтезатор поддерживает полное чтение чисел только до двенадцатизначных включительно. Начиная с числа 1 триллион, числа всегда читаются по цифрам.

Параметр punctuation

Данный параметр задаёт активный уровень чтения символов пунктуации и других небуквенных символов, как уже встроенных в синтезатор, так и добавляемых посредством конфигурационных файлов. Он имеет четыре допустимых значения, соответствующих возможным уровням пунктуации для символов (см. Описания небуквенных символов (*_symbols.txt)). Значение по умолчанию — none.

Эта опция представляет собой отдельную настройку, никак не связанную с аналогичной опцией NVDA. Использование собственной настройки синтезатора Капитан имеет смысл в особых случаях, а во всех остальных рекомендуется использовать стандартную функциональность (см. меню NVDA → Справка → Руководство пользователя → Уровень пунктуации).

Параметр single_punctuation

Данный параметр отвечает за активацию обязательного чтения одиночных знаков пунктуации. Допустимым значением этого параметра является 0, означающее отключение, или 1, означающее включение. Значение по умолчанию — 0.

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

Обработка символов будет осуществляться средствами синтезатора Капитан в соответствии со встроенными правилами чтения и файлами описания небуквенных символов. Для успешной обработки необходимо, чтобы соответствующий символ передавался на синтезатор. Это определяется опцией «Передавать фактический символ на синтезатор» в диалоге настроек NVDA «Произношение символов/пунктуации» (см. меню NVDA → Справка → Руководство пользователя → Произношение символов/пунктуации).

Параметр debug

Данный параметр отвечает за активацию режима отладки синтезатора. Допустимым значением этого параметра является 0, означающее отключение, или 1, означающее включение. Значение по умолчанию — 0.

В режиме отладки синтезатор на протяжении всей своей работы пишет файл журнала, чьё содержимое в последствие может быть использовано разработчиком для выявления причин сбоев. Данный журнал сохраняется в системную директорию временных файлов:
%tmp%\captain_nvda_log.txt

Синтезатор может создавать два варианта журнала: пользовательский, который пишется во время обычной работы из под текущего пользователя системы, и системный, который пишется во время работы на экране входа в систему и других защищённых экранах. Пользовательский журнал сохраняется в директорию временных файлов соответствующего пользователя, а системный в директорию временных файлов всей системы (%SystemRoot%\Temp\captain_nvda_log.txt). Поскольку взаимодействие с защищёнными экранами системы не поддерживается переносными и временными копиями NVDA, то и системный журнал синтезатора актуален лишь для установленной NVDA.

Открыть файл можно при помощи пункта «Просмотреть журнал» в сервисном меню.

Новая информация дописывается в конец файла, поэтому со временем журнал может достичь существенных размеров. Рекомендуется периодически его удалять, в том числе и перед журналированием чётко воспроизводимых проблем, чтобы в файл попала только последняя информация непосредственно перед сбоем и во время него.

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

3.3.2. Словари синтезатора (*_dict.txt)

Словари применяются для коррекции чтения тех слов и сочетаний символов, которые, по мнению пользователя, синтезатор озвучивает неправильно или неразборчиво. За использование словарей отвечает опция «Использовать словари синтезатора» в диалоге настроек речи. Это встроенная функция синтезатора Капитан, которая никак не связана с речевыми словарями NVDA (см. меню NVDA → Справка → Руководство пользователя → Речевые словари). Правила строенных словарей синтезатора Капитан применяются после применения правил речевых словарей NVDA.

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

• ru_dict.txt — русский словарь по умолчанию. Правила данного словаря используются синтезатором, работающим в режиме чтения на русском языке с вариантом обработки некириллического текста, отличном от «Псевдоанглийский».
• en_ru_dict.txt — русский словарь для псевдоанглийского. Правила данного словаря используются синтезатором, работающим в режиме чтения на русском языке с вариантом обработки некириллического текста «Псевдоанглийский».
• uk_dict.txt — украинский словарь по умолчанию. Правила данного словаря используются синтезатором, работающим в режиме чтения на украинском языке с вариантом обработки некириллического текста, отличном от «Псевдоанглийский».
• en_uk_dict.txt — украинский словарь для псевдоанглийского. Правила данного словаря используются синтезатором, работающим в режиме чтения на украинском языке с вариантом обработки некириллического текста «Псевдоанглийский».

При редактировании файлов необходимо учитывать следующие правила:

• Файл содержит пары из двух последовательностей символов: заменяемой и заменяющей. Каждая такая пара размещается на отдельной строке.
• Строки, начинающиеся с символов решётки (#) или точки с запятой (;), считаются однострочными комментариями, так что не обрабатываются.
• Пустые строки игнорируются.

Каждая строка, содержащая заменяемую и заменяющую последовательности, должна начинаться с символа, который будет восприниматься в качестве символа- разделителя полей, например, с точки (.). После символа-разделителя должна идти заменяемая последовательность, после которой должен опять помещаться символ-разделитель. Затем должна идти заменяющая последовательность. Например:

.чт.четверг

Такая запись означает, что если будет встречено слово из двух букв «чт», то оно будет заменено на слово «четверг» с учётом регистра букв в заменяемом слове. Под словом здесь подразумевается любой набор символов, отделённый от соседних подобно слову в письменной речи, то есть пробелами и знаками препинания.

Если нужно выполнять замену без учёта регистра букв, то необходимо после заменяющей последовательности добавить символ-разделитель и латинскую букву i. Например:

.чт.четверг.i

Если необходимо выполнять замену не слова целиком, а его части (несколько начальных, конечных или центральных символов), то необходимо использовать символ звёздочки (*) на том месте, где в заменяемом слове может быть произвольный набор символов. Например:

.булочн*.булошн.i

Символ звёздочки может быть помещён либо только в начало, либо только в конец, либо и в начало, и в конец заменяемой последовательности.

Для каждого из пользовательских словарей установлены следующие ограничения:

• Длина каждой из заменяемой и заменяющей последовательностей — не более 64 символов (лишнее отсекается).
• Общее количество пар из заменяемой и заменяющей последовательностей — не более 5000 (последующие записи игнорируются).

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

3.3.3. Описания букв (*_letters.txt)

Файлы описания букв применяются для управления произнесением поступающих на синтезатор буквенных символов. Они позволяют переопределить как уже встроенные в синтезатор правила чтения каких-то алфавитных знаков, так и добавить новые правила для ещё неизвестных букв.

Описания букв представляют собой файлы с именем *_letters.txt, где на месте знака звёздочки находится кодовое обозначение языка, для которого они предназначены. Поддерживаются следующие варианты файлов:

• ru_letters.txt — русское описание букв по умолчанию. Описания из этого файла используются синтезатором, работающим в режиме чтения на русском языке с вариантом обработки некириллического текста, отличном от «Псевдоанглийский».
• en_ru_letters.txt — русское описание букв для псевдоанглийского. Описания из этого файла используются синтезатором, работающим в режиме чтения на русском языке с вариантом обработки некириллического текста «Псевдоанглийский».
• uk_letters.txt — украинское описание символов по умолчанию. Описания из этого файла используются синтезатором, работающим в режиме чтения на украинском языке с вариантом обработки некириллического текста, отличном от «Псевдоанглийский».
• en_uk_letters.txt — украинское описание символов для псевдоанглийского. Описания из этого файла используются синтезатором, работающим в режиме чтения на украинском языке с вариантом обработки некириллического текста «Псевдоанглийский».

При редактировании файлов необходимо учитывать следующие правила:

• Файл содержит правила чтения букв. Каждое такое правило размещается на отдельной строке.
• Строки, начинающиеся с символов решётки (#) или точки с запятой (;), считаются однострочными комментариями, так что не обрабатываются.
• Пустые строки игнорируются.

Каждая строка, содержащая правило, должна начинаться с символа, который будет восприниматься в качестве символа-разделителя полей, например, с точки (.). Затем идёт прописной вариант буквы, чтение которой определяется в данном правиле. Затем следует символ-разделитель. Далее идёт строчной вариант буквы, чтение которой определяется в данном правиле. Далее опять следует символ- разделитель. Затем идёт название буквы, то есть текст, который будет озвучиваться синтезатором при посимвольном чтении. Затем снова следует символ- разделитель. Далее идёт фонетическое значение буквы, то есть текст, который будет озвучиваться синтезатором на месте этого знака внутри слов. Далее снова следует символ-разделитель. И завершает строку так называемый индикатор гласности, принимающий либо значение 1 для гласных букв, либо 0 для согласных. Например:

.Ь.ь.мягкий.ь.1

Такая запись означает, что мягкий знак (как прописной (Ь), так и строчной (ь)) при посимвольном чтении будет называться сокращённо «мягкий», а в составе слов во время их прочтения будет интерпретироваться как «ь».

Индикатор гласности определяет лишь то, будет ли слово из одних согласных букв и описываемой буквы считаться словом, полностью написанным согласными буквами. Это имеет значение для обработки слов, определяемой параметром abbreviations из файла конфигурации. В случае мягкого знака использовано значение 1, чтобы частицы «ль» при любых значениях параметра abbreviations читались бы звуком [л'], а не отдельными названиями букв.

Для каждого из файлов описания букв установлены следующие ограничения:

• Тексты названия и фонетического значения буквы должны быть написаны при помощи 33 русских букв от «а» до «я» и знака пробела (прочие символы не читаются).
• Длина названия буквы — не более 32 символов (лишнее отсекается).
• Длина фонетического значения буквы — не более 8 символов (лишнее отсекается).
• Общее количество описываемых букв — не более 512 (последующие записи игнорируются).

Функция фонетического описания символов не зависит от синтезатора и реализуется на уровне программы экранного доступа. Подробные разъяснения относительно принципов конфигурирования NVDA выходят за рамки данного справочного материала, поэтому лишь кратко отметим, что в NVDA от 2012.3 до 2023.1 для добавления фонетических описаний символов следует редактировать файл, расположенный по пути
%nvda%\locale\%lang%\characterDescriptions.dic,
где
%nvda% — системная директория NVDA, содержащая исполняемый файл nvda.exe, вызовом которого и запускается программа;
%lang% — директория с локализацией для активного языка NVDA, чьё название соответствует его коду, например, ru для русского.

Файл characterDescriptions.dic сохранён в кодировке UTF-8 без BOM и на отдельных строках содержит символы и их фонетические описания, разделённые знаком табуляции. Новые символы добавляются аналогичным образом, например:

ѳ Филофей

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

Кроме того, следует учитывать, что в более новых версиях NVDA принципы хранения и редактирования фонетических описаний символов могут измениться, поэтому вышеприведённую информацию перед применением следует уточнять по документации самой NVDA.

3.3.4. Описания небуквенных символов (*_symbols.txt)

Файлы описания символов применяются для управления произнесением поступающих на синтезатор знаков пунктуации и других небуквенных символов. Это встроенная функция синтезатора Капитан, которая никак не связана с аналогичной функциональностью NVDA (см. меню NVDA → Справка → Руководство пользователя → Произношение символов/пунктуации). Правила синтезатора Капитан применяются после применения правил произношения символов/пунктуации NVDA в отношении тех символов, которые доходят до синтезатора в соответствии с настройками NVDA.

Описания символов представляют собой файлы с именем *_symbols.txt, где на месте знака звёздочки находится кодовое обозначение языка, для которого они предназначены. Поддерживаются следующие варианты файлов:

• ru_symbols.txt — русское описание символов. Описания из этого файла используются синтезатором, работающим в режиме чтения на русском языке.
• uk_symbols.txt — украинское описание символов. Описания из этого файла используются синтезатором, работающим в режиме чтения на украинском языке.

При редактировании файлов необходимо учитывать следующие правила:

• Файл содержит правила чтения небуквенных символов. Каждое такое правило размещается на отдельной строке.
• Строки, начинающиеся с символов решётки (#) или точки с запятой (;), считаются однострочными комментариями, так что не обрабатываются.
• Пустые строки игнорируются.

Каждая строка, содержащая правило, должна начинаться с символа, который будет восприниматься в качестве символа-разделителя полей, например, с точки (.). Затем идёт символ, чтение которого определяется в данном правиле. Затем следует символ-разделитель. Далее идёт описание символа, то есть текст, который будет озвучиваться синтезатором, когда он встретит этот символ в текстовом потоке. Затем снова следует символ-разделитель. И завершает строку так называемый уровень пунктуации, обозначаемый одним из зарезервированных слов (none, some, most, all). Например:

.⠿.брайлевское шеститочие.none

Такая запись означает, что если будет встречен знак брайлевского шеститочия (⠿), то на этом месте синтезатором будет произнесено словосочетание «брайлевское шеститочие», начиная с уровня пунктуации none.

Уровень пунктуации определяет, начиная с какого режима чтения пунктуации, синтезатор будет озвучивать данный символ. Названия режимов имеют следующий функциональный смысл:

• none — символ озвучивается всегда.
• some — символ озвучивается в режимах some, most и all.
• most — символ озвучивается в режимах most и all.
• all — символ озвучивается только в режиме all.

Действующий режим уровня чтения пунктуации задаётся в файле конфигурации как значение параметра punctuation.

Для каждого из файлов описания небуквенных символов установлены следующие ограничения:

• Текст описания символа должен быть написан при помощи 33 русских букв от «а» до «я» и знака пробела (прочие символы не читаются).
• Общее количество описываемых символов — не более 512 (последующие записи игнорируются).

Текст доступен по лицензии Creative Commons Attribution-ShareAlike 4.0 International.