Laprdus - Руководство пользователя

Версия 1.0

Содержание

1. Введение
   • 1.1 Что такое Laprdus?
   • 1.2 Для кого предназначен Laprdus?
   • 1.3 Поддерживаемые платформы
   • 1.4 Возможности
2. Установка
   • 2.1 Windows SAPI5
   • 2.2 Дополнение для NVDA
   • 2.3 Linux
   • 2.4 Android
3. Использование
   • 3.1 Основное использование
   • 3.2 Командная строка (Linux и Windows)
   • 3.3 Настройки NVDA
   • 3.4 Приложение для Android
4. Настройки
   • 4.1 Скорость речи
   • 4.2 Высота тона
   • 4.3 Громкость
   • 4.4 Паузы
   • 4.5 Способ чтения чисел
   • 4.6 Интонация
   • 4.7 Конфигуратор Laprdus (Windows)
5. Словари
   • 5.1 Типы словарей
   • 5.2 Расположение файлов словарей
   • 5.3 Основной словарь (user.json)
   • 5.4 Словарь для побуквенного чтения (spelling.json)
   • 5.5 Словарь эмодзи (emoji.json)
   • 5.6 Редактирование словарей в Windows (Конфигуратор Laprdus)
   • 5.7 Редактирование словарей на Android
   • 5.8 Ручное редактирование JSON-файлов
   • 5.9 Примеры практического использования
   • 5.10 Решение проблем со словарями
6. Голоса
   • 6.1 Доступные голоса
   • 6.2 Основные и производные голоса
   • 6.3 Выбор голоса
7. Решение проблем
   • 7.1 Частые проблемы
   • 7.2 Диагностические журналы
   • 7.3 Контакты и поддержка

1. Введение

1.1 Что такое Laprdus?

Laprdus — это синтезатор речи (TTS — Text-to-Speech) для хорватского и сербского языков. Он использует технологию конкатенативного синтеза, соединяя предварительно записанные фонемы для создания речи. Хотя он не достигает качества современных нейросетевых TTS-систем, Laprdus предлагает высокую производительность и минимальное потребление памяти.

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

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

1.2 Для кого предназначен Laprdus?

Laprdus предназначен не для всех. Это хороший выбор для тех, кто наслаждается ностальгическим звуком ретро-синтезаторов речи 1980-х и 1990-х годов.

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

Короче говоря: современные синтезаторы предлагают качество ценой ресурсов; Laprdus предлагает производительность ценой качества.

1.3 Поддерживаемые платформы

Laprdus доступен на следующих платформах:

• Windows 7 до Windows 11 — через стандарт Microsoft SAPI5, что позволяет использовать Laprdus во всех программах, поддерживающих Windows Speech, включая экранные чтецы, такие как Narrator, NVDA и JAWS.
• Прямая интеграция с экранным чтецом NVDA — доступен также как отдельное дополнение для бесплатного экранного чтеца Windows NVDA.
• Linux — через систему Speech Dispatcher для экранного чтеца Orca, а также как консольная программа.
• Android — как встроенный синтезатор речи для устройств Android.

1.4 Возможности

Lrdus предлагает следующие возможности:

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

2. Установка

2.1 Windows SAPI5

Чтобы установить Laprdus в системе Windows, выполните следующие шаги:

Шаг 1: Загрузка

1. Посетите официальную страницу Laprdus: https://hrvojekatic.com/laprdus
2. Найдите раздел для загрузки и нажмите на ссылку для Windows SAPI5.
3. Загрузите установочную программу (файл с именем Laprdus_SAPI5_Setup.exe).
4. Файл будет сохранен в вашу папку Загрузки.

Шаг 2: Запуск установки

1. Откройте Проводник Windows (клавиша Windows+E).
2. Стрелкой вниз найдите папку Загрузки и откройте её клавишей Enter.
3. Найдите загруженную установочную программу Laprdus (файл с именем Laprdus_SAPI5_Setup.exe).
4. Рекомендуется: Нажмите клавишу приложения или Shift+F10 на файле, затем выберите Запуск от имени администратора.
   • Альтернатива: Нажмите Enter для обычного запуска.
5. Если появится окно Контроля учетных записей (UAC), выберите Да.

Шаг 3: Процесс установки

1. Выберите язык установки стрелкой вниз и нажмите Enter.
2. Выберите расположение для установки (по умолчанию: C:\Program Files\Laprdus) и клавишей Tab выберите Далее, затем Enter.
3. Отметьте пробелом, если хотите, чтобы на рабочем столе был создан значок для конфигуратора Laprdus, затем клавишей Tab найдите Далее и нажмите Enter.
4. Клавишей Tab найдите Установить, нажмите Enter и дождитесь завершения установки.
5. В конце установки нажмите Enter на Готово для закрытия программы установки.

Шаг 4: Проверка установки

1. Откройте Панель управления:
   • Нажмите клавишу Windows.
   • Введите Панель управления и нажмите Enter.
2. Выберите Специальные возможности > Распознавание речи.
3. Клавишей Tab найдите Преобразование текста в речь и нажмите Enter.
4. В раскрывающемся списке Выбор голоса вы должны увидеть голоса Laprdus:
   • Laprdus Josip
   • Laprdus Vlado
   • Laprdus Detence
   • Laprdus Baba
   • Laprdus Djedo

2.2 Дополнение для NVDA

Для использования Laprdus с экранным чтецом NVDA:

Шаг 1: Загрузка

1. Посетите официальную страницу Laprdus: https://hrvojekatic.com/laprdus
2. Найдите раздел для загрузки и нажмите на ссылку для дополнения NVDA.
3. Загрузите дополнение NVDA (файл с расширением .nvda-addon).
4. Файл будет сохранен в вашу папку Загрузки.

Шаг 2: Установка дополнения

1. Откройте Проводник Windows (клавиша Windows+E).
2. Найдите папку Загрузки.
3. Найдите загруженный файл дополнения Laprdus для NVDA (файл с расширением .nvda-addon).
4. Нажмите Enter на файле.
   • Альтернатива: Нажмите клавишу приложения (или Shift+F10) для вызова контекстного меню, затем выберите Открыть.
5. NVDA отобразит диалог с вопросом Вы хотите установить это дополнение?.
6. Клавишей Tab найдите кнопку Да и нажмите Enter, или просто нажмите D для Да.
7. Дождитесь завершения установки.

Шаг 3: Перезапуск NVDA

1. NVDA запросит перезапуск.
2. Выберите Да для немедленного перезапуска.
3. Подождите, пока NVDA перезапустится.

Шаг 4: Выбор Laprdus в качестве синтезатора

Метод 1: Через меню NVDA

1. Откройте меню NVDA: нажмите клавишу NVDA + N.
2. Стрелкой вниз найдите Параметры и нажмите Enter.
3. Стрелкой вниз найдите Настройки и нажмите Enter.
4. В диалоговом окне Настройки стрелкой вниз найдите категорию Речь.
5. Клавишей Tab найдите кнопку Изменить..., которая находится сразу после параметра Синтезатор речи.
6. Нажмите Enter на кнопке Изменить....
7. В списке синтезаторов стрелкой вниз найдите Laprdus и нажмите Enter.
8. Нажмите Escape для закрытия настроек.

Метод 2: Быстрое сочетание клавиш (рекомендуется)

1. Нажмите сочетание Control + клавиша NVDA + S.
2. Откроется диалог выбора синтезатора.
3. Стрелкой вниз найдите Laprdus и нажмите Enter.

2.3 Linux

Debian и Ubuntu

Откройте терминал и выполните следующую команду (замените имя файла на имя загруженного .deb файла):

sudo dpkg -i laprdus_amd64.deb

Fedora

Выполните следующую команду (замените имя файла на имя загруженного .rpm файла):

sudo rpm -i laprdus.x86_64.rpm

Arch Linux

1. Загрузите PKGBUILD файл с веб-сайта.
2. В терминале перейдите в каталог с файлом PKGBUILD.
3. Выполните:

makepkg -si

Ручная установка (из tarball архива)

1. Распакуйте архив (замените имя файла на имя загруженного архива):

   tar xf laprdus-linux-x86_64.tar.xz
   cd laprdus-linux-x86_64

2. Запустите установочный скрипт:

   sudo ./install.sh

Настройка для экранного чтеца Orca

После установки Laprdus автоматически настраивается для Speech Dispatcher. Для использования с экранным чтецом Orca:

1. На всякий случай рекомендуется перезапустить Speech Dispatcher:

   systemctl --user restart speech-dispatcher

2. Откройте настройки Orca:

   • Нажмите Insert+Пробел для открытия настроек (или Caps Lock + Пробел, если модификатор Orca установлен на Caps Lock или раскладка ноутбука).
   • Или в средах рабочего стола Gnome или Mate: Alt+F2, введите orca -s, затем Enter.

3. Клавишей Tab или Shift+Tab перейдите к вкладкам настроек, стрелкой вправо найдите вкладку Голос, а затем, повторно нажимая Tab, выберите:

   • Система синтеза: Нажмите Пробел для раскрытия раскрывающегося списка, стрелкой вниз выберите Speech Dispatcher, если он еще не выбран, и нажмите Enter.
   • Синтезатор речи: Нажмите Пробел для раскрытия раскрывающегося списка, стрелкой вниз выберите Laprdus, затем Enter.
   • Голос: Нажмите Пробел для раскрытия раскрывающегося списка, стрелкой вниз выберите желаемый голос (josip, vlado и т.д.) и нажмите Enter.

4. Клавишей Tab найдите Применить и закройте настройки.

2.4 Android

Шаг 1: Загрузка APK файла

1. На вашем Android-устройстве откройте веб-браузер.
2. Перейдите на сайт: https://hrvojekatic.com/laprdus
3. Загрузите APK файл (файл с расширением .apk).

Шаг 2: Разрешение установки из неизвестных источников

Это необходимо, только если вы устанавливаете приложение не из магазина Google Play.

Для Android 8.0 и новее:

1. Откройте Настройки на вашем устройстве.
2. Перейдите в: Приложения > Особый доступ приложений > Установка неизвестных приложений.
   • Или: Настройки > Безопасность > Установка неизвестных приложений.
3. Найдите используемый вами веб-браузер (например, Chrome).
4. Включите опцию Разрешить из этого источника.

Для старых версий Android:

1. Откройте Настройки.
2. Перейдите в: Безопасность.
3. Включите опцию Неизвестные источники.

Шаг 3: Установка приложения

1. Откройте файловый менеджер на вашем устройстве.
2. Найдите загруженный APK файл (обычно в папке Загрузки).
3. Коснитесь APK файла.
4. При появлении запроса коснитесь Установить.
5. Дождитесь завершения установки.
6. Коснитесь Открыть для запуска приложения или Готово для закрытия.

Шаг 4: Установка Laprdus в качестве TTS по умолчанию

1. Откройте Настройки на вашем устройстве.
2. Перейдите в: Специальные возможности > Преобразование текста в речь (Text-to-speech).
   • На некоторых устройствах: Настройки > Система > Язык и ввод > Преобразование текста в речь.
   • На устройствах Samsung: Настройки > Общее управление > Язык и ввод > Преобразование текста в речь.
3. Коснитесь Предпочтительный движок или значка шестеренки.
4. Выберите Laprdus TTS из списка.
5. Вернитесь на предыдущий экран и коснитесь Прослушать пример для тестирования.

Примечание для пользователей экранного чтеца TalkBack

Если вы используете TalkBack, все интерфейсы приложения Laprdus полностью доступны:

• Используйте стандартные жесты TalkBack для навигации.
• Двойное касание для активации кнопок и опций.
• Проведение двумя пальцами для прокрутки списков.

3. Использование

3.1 Основное использование

После установки Laprdus автоматически становится доступен всем программам, использующим синтез речи в вашей системе. Это включает:

• Экранные чтецы (NVDA, Orca, Narrator).
• Веб-браузеры с функцией чтения.
• Программы для чтения документов.
• Любые программы, использующие Windows SAPI5 или Android TTS.

3.2 Командная строка (Linux и Windows)

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

Основные примеры

# Произнесение текста
laprdus "Добрый день!"

# Использование другого голоса
laprdus -v vlado "Здравствуй, мир!"

# Регулировка скорости речи
laprdus -r 1.5 "Более быстрая речь"

# Сохранение в WAV файл
laprdus -o speech.wav "Текст для записи"

# Чтение из файла
laprdus -i document.txt

# Чтение из стандартного ввода
echo "Текст" | laprdus

Опции консольной программы

3.3 Настройки NVDA

При использовании Laprdus с экранным чтецом NVDA настройки голоса можно изменить следующим образом:

1. Откройте меню NVDA (клавиша NVDA + N).
2. Выберите подменю Параметры, затем Настройки > категория Речь.
3. В диалоге вы можете настроить:
   • Голос (выберите один из 5 голосов Laprdus).
   • Скорость речи.
   • Высоту тона.
   • Громкость.
   • Дополнительное ускорение (Rate Boost) (расширяет максимальную скорость с 2x до 4x).

3.4 Приложение для Android

Приложение Laprdus для Android включает экран настроек, где вы можете:

1. Выбрать голос.
2. Настроить скорость речи.
3. Настроить высоту тона.
4. Настроить громкость.
5. Включить/выключить чтение эмодзи.
6. Настроить способ чтения чисел.
7. Настроить длительность пауз.

Для доступа к настройкам:

1. Откройте приложение Laprdus из панели приложений.
2. Нажмите на кнопку Настройки Laprdus.
3. Измените настройки по желанию (изменения сохраняются автоматически).

4. Настройки

4.1 Скорость речи

Скорость речи определяет, как быстро Laprdus произносит текст. Диапазон от 0.5 (в два раза медленнее) до 2.0 (в два раза быстрее), где 1.0 — нормальная скорость.

• 0.5 — Очень медленно, полезно для начинающих или когда нужно внимательно слушать каждое слово.
• 1.0 — Нормальная скорость, подходит для большинства ситуаций.
• 1.5 — Умеренно быстро, для опытных пользователей.
• 2.0 — Быстро, для продвинутых пользователей.

Примечание: В дополнении для NVDA опция Дополнительное ускорение расширяет максимальную скорость до 4.0.

4.2 Высота тона

Высота тона позволяет регулировать основную частоту голоса. Диапазон от 0.5 (более низкий голос) до 2.0 (более высокий голос), где 1.0 — естественная высота голоса.

• 0.5 — Более низкий голос.
• 1.0 — Естественная высота.
• 2.0 — Более высокий голос.

Примечание: Регулировка высоты тона не влияет на характер голоса (нет эффекта мультфильма).

4.3 Громкость

Громкость определяет, насколько громкой будет речь. Диапазон от 0.0 (тихо) до 1.0 (максимальная громкость).

• 0.0 — Тихо (нет звука).
• 0.5 — Умеренная громкость.
• 1.0 — Максимальная громкость.

4.4 Паузы

Laprdus автоматически вставляет паузы после знаков препинания, чтобы речь звучала более естественно. Вы можете настроить длительность пауз для:

• Точка — Пауза после точки (по умолчанию: 100 мс в пользовательских настройках, 80 мс в консольной программе).
• Восклицательный знак — Пауза после восклицательного знака (по умолчанию: 100 мс в пользовательских настройках, 70 мс в консольной программе).
• Вопросительный знак — Пауза после вопросительного знака (по умолчанию: 100 мс в пользовательских настройках, 60 мс в консольной программе).
• Запятая — Короткая пауза внутри предложения (по умолчанию: 100 мс).
• Новая строка — Пауза для разрыва строки (по умолчанию: 100 мс).

Значения указываются в миллисекундах (мс). Диапазон от 0 до 2000 мс.

Примечание: Пользовательский конфигуратор (Windows/Android) использует единую настройку 100 мс для всех знаков конца предложения (точка, восклицательный знак, вопросительный знак), в то время как консольная программа позволяет настраивать каждый знак отдельно.

4.5 Способ чтения чисел

Laprdus может читать числа двумя способами:

1. Словами (по умолчанию) — Числа читаются как полные слова.

   • Пример: 123 читается как сто двадцать три.

2. По цифрам — Числа читаются по цифрам.

   • Пример: 123 читается как один два три.

Чтение словами поддерживает числа до центиллиона (10^303) и использует правильные грамматические формы.

4.6 Интонация

Интонация — это естественное изменение высоты тона, следующее за пунктуацией:

• Точка в конце предложения вызывает понижение тона.
• Вопросительный знак вызывает повышение тона в конце.
• Восклицательный знак добавляет акцент.
• Запятая вызывает легкое повышение тона.

Интонацию можно включить или выключить. Когда она включена, речь звучит более естественно.

4.7 Конфигуратор Laprdus (Windows)

В системе Windows дополнительные настройки можно выполнить через Конфигуратор Laprdus:

1. Откройте меню Пуск Windows, затем найдите Конфигуратор Laprdus в папке программы Laprdus и откройте его клавишей Enter.
2. Или, если Laprdus установлен как дополнение NVDA, откройте меню NVDA > подменю Laprdus > Конфигуратор Laprdus.

Конфигуратор позволяет настроить:

• Скорость, высоту тона и громкость речи.
• Способ чтения чисел.
• Длительность пауз.
• Интонацию.
• Настройку пользовательских словарей.

Настройки сохраняются в папке пользователя %APPDATA%\Laprdus и являются общими для SAPI5 и дополнения NVDA.

5. Словари

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

5.1 Типы словарей

Laprdus использует три типа словарей, каждый из которых имеет свое назначение:

5.2 Расположение файлов словарей

Расположение файлов словарей зависит от используемой платформы:

Windows (SAPI5 и NVDA)

Все файлы словарей находятся в пользовательском каталоге Laprdus:

%APPDATA%\Laprdus\

Полный путь обычно такой: C:\Users\ИмяПользователя\AppData\Roaming\Laprdus\

Как открыть этот каталог:

1. Нажмите клавиши Windows+R, чтобы открыть диалог Выполнить.
2. Введите: %APPDATA%\Laprdus
3. Нажмите Enter.

Файлы в этом каталоге:

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

Linux

Файлы словарей находятся в:

~/.config/Laprdus/

Используйте те же имена файлов, что и в Windows (user.json, spelling.json, emoji.json).

Android

На Android словари редактируются исключительно через интерфейс приложения Laprdus. Файлы хранятся во внутренней памяти приложения и не доступны пользователю напрямую.

5.3 Основной словарь (user.json)

Основной словарь служит для замены слов или фраз на настроенное произношение. Полезен для:

• Иностранные слова и бренды — например, произносить Facebook как Фейсбук.
• Аббревиатуры — например, произносить TV как ТэВэ.
• Технические термины — например, произносить ChatGPT как ЧатДжиПиТи.
• Имена с необычным произношением — например, произносить Sean как Шон.

Формат файла

Файл user.json использует формат JSON. Вот пример:

{
    "version": "1.0",
    "entries": [
        {
            "grapheme": "Facebook",
            "phoneme": "Фейсбук",
            "caseSensitive": false,
            "wholeWord": true,
            "comment": "Социальная сеть"
        },
        {
            "grapheme": "TV",
            "phoneme": "ТэВэ",
            "caseSensitive": false,
            "wholeWord": true,
            "comment": "Аббревиатура телевидения"
        },
        {
            "grapheme": "ChatGPT",
            "phoneme": "ЧатДжиПиТи",
            "caseSensitive": false,
            "wholeWord": true,
            "comment": "AI чат-бот"
        }
    ]
}

Описание полей

Объяснение опций

caseSensitive (учет регистра):

• false (по умолчанию): Facebook, facebook, FACEBOOK — все будут заменены.
• true: Будет заменено только точное совпадение.

wholeWord (только целое слово):

• true (по умолчанию): Заменяет только тогда, когда текст является целым словом.
  • TV в TV программа будет заменено.
  • TV в активатор не будет заменено (так как это часть большего слова).
• false: Заменяет и внутри других слов.
  • Полезно для суффиксов и префиксов.

5.4 Словарь для побуквенного чтения (spelling.json)

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

• Буквы алфавита — например, произносить B как Бэ.
• Цифры — например, произносить 5 как пять.
• Знаки препинания — например, произносить . как точка.
• Специальные символы — например, произносить @ как собака.

Формат файла

{
    "version": "1.0",
    "entries": [
        { "character": "A", "pronunciation": "А" },
        { "character": "B", "pronunciation": "Бэ" },
        { "character": "Č", "pronunciation": "Чэ" },
        { "character": "1", "pronunciation": "один" },
        { "character": ".", "pronunciation": "точка" },
        { "character": "@", "pronunciation": "собака" }
    ]
}

Встроенное произношение символов

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

Буквы алфавита (пример для хорватского):

Цифры:

Обычные знаки препинания:

Специальные символы:

5.5 Словарь эмодзи (emoji.json)

Словарь эмодзи преобразует символы эмодзи в произносимый текст.

Включение чтения эмодзи

Windows (Конфигуратор Laprdus):

1. Откройте Конфигуратор Laprdus (Пуск > Laprdus > Конфигуратор Laprdus).
2. Клавишей Tab найдите опцию Читать эмодзи.
3. Отметьте флажок.
4. Клавишей Tab выберите OK и нажмите Enter.

NVDA:

1. Откройте меню NVDA (клавиша NVDA + N) > подменю Laprdus > Конфигуратор Laprdus.
2. Клавишей Tab найдите опцию Читать эмодзи.
3. Отметьте флажок.
4. Клавишей Tab выберите OK и нажмите Enter.

Android:

1. Откройте приложение Laprdus.
2. Коснитесь Настройки Laprdus.
3. Найдите переключатель Читать эмодзи и включите его.

Формат файла

{
    "version": "1.0",
    "entries": [
        { "emoji": "😀", "text": "улыбающееся лицо" },
        { "emoji": "👍", "text": "палец вверх" },
        { "emoji": "❤️", "text": "красное сердце" },
        { "emoji": "🎉", "text": "конфетти" }
    ]
}

Встроенные эмодзи

Laprdus поставляется с обширным встроенным словарем эмодзи, содержащим более 1100 эмодзи с описаниями. Вот несколько примеров:

5.6 Редактирование словарей в Windows (Конфигуратор Laprdus)

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

Как открыть Конфигуратор:

• Из меню Пуск: Пуск > Laprdus > Конфигуратор Laprdus.
• Из меню NVDA: клавиша NVDA + N > подменю Laprdus > Конфигуратор Laprdus.

Редактирование словарей:

1. В Конфигураторе Laprdus клавишей Tab или Shift+Tab найдите кнопку Словари... и нажмите Enter.
2. Откроется окно Редактор словарей.
3. В верхней части окна находится раскрывающийся список для выбора типа словаря, который вы хотите настроить:
   • Основной словарь — для замены слов и фраз.
   • Словарь для побуквенного чтения — для произношения отдельных символов.
   • Словарь эмодзи — для преобразования эмодзи в текст.
4. Выберите нужный тип словаря стрелкой вниз.

Добавление новой записи:

1. Нажмите кнопку Добавить....
2. Откроется диалог для ввода:
   • Исходная строка: Введите текст, который хотите заменить.
   • Заменяющая строка: Введите, как текст должен произноситься.
   • Учитывать регистр: Отметьте, если важно точное совпадение.
   • Только целое слово: Отметьте, если не хотите замены внутри других слов.
   • Комментарий: Необязательное описание записи.
3. Нажмите Enter или клавишей Tab найдите кнопку OK, затем подтвердите Enter для сохранения записи.

Редактирование существующей записи:

1. Выберите запись в списке, перемещаясь стрелками вниз или вверх.
2. Клавишей Tab найдите кнопку Редактировать....
3. Измените нужные значения.
4. Нажмите Enter или клавишей Tab найдите кнопку OK и нажмите Enter.

Удаление записи:

1. Выберите запись в списке стрелками вверх или вниз.
2. Клавишей Tab найдите кнопку Удалить и нажмите Enter.

Дублирование записи:

1. Выберите запись, которую хотите дублировать.
2. Клавишей Tab найдите кнопку Дублировать и нажмите Enter.
3. Новая запись с скопированными значениями будет добавлена в список.
4. Отредактируйте дублированную запись при необходимости.

5.7 Редактирование словарей на Android

Приложение Android предоставляет встроенный интерфейс для управления словарями.

Шаг 1: Откройте словари

1. Откройте приложение Laprdus из панели приложений.
2. Коснитесь кнопки Настройки Laprdus.
3. Коснитесь кнопки Управление словарями.

Шаг 2: Выберите тип словаря

В верхней части экрана находится раскрывающийся список для выбора типа словаря:

• Основной словарь — для замены слов и фраз.
• Словарь для побуквенного чтения — для произношения символов.
• Словарь эмодзи — для преобразования эмодзи.

Коснитесь раскрывающегося списка и выберите нужный тип.

Шаг 3: Добавление новой записи

1. Коснитесь кнопки + (плюс) в правом нижнем углу экрана.
2. Откроется экран для ввода:
   • Исходный текст: Введите слово или фразу, которую хотите заменить.
   • Заменяющее произношение: Введите, как это должно произноситься.
   • Учитывать регистр: Включите, если важно точное совпадение.
   • Только целое слово: Включите, если не хотите замены внутри других слов.
   • Комментарий: Необязательное описание (например, Социальная сеть).
3. Коснитесь кнопки Сохранить внизу экрана.

Шаг 4: Редактирование существующей записи

1. Найдите запись в списке.
2. Коснитесь записи, чтобы открыть экран редактирования.
3. Измените нужные значения.
4. Коснитесь Сохранить.

Шаг 5: Удаление записи

1. Найдите запись в списке.
2. Проведите по записи влево, чтобы отобразить опцию удаления.
3. Коснитесь значка корзины.
4. Подтвердите удаление.

Примечание для пользователей TalkBack:

• Используйте стандартные жесты TalkBack для навигации.
• Двойное касание для активации кнопок.
• Для удаления: двойное касание и удержание на записи, затем выберите Удалить.

5.8 Ручное редактирование JSON-файлов (продвинутый уровень)

Этот метод предназначен для продвинутых пользователей, которые хотят напрямую редактировать JSON-файлы словарей. Для большинства пользователей мы рекомендуем использовать Конфигуратор Laprdus (Windows) или интерфейс приложения Android.

Преимущества ручного редактирования:

• Быстрое массовое добавление/редактирование большого количества записей.
• Возможность обмениваться словарями с другими пользователями.
• Создание резервных копий словарей.

Шаг 1: Откройте каталог со словарями

Windows:

1. Нажмите Windows+R.
2. Введите: %APPDATA%\Laprdus
3. Нажмите Enter.

Linux:

1. Откройте файловый менеджер.
2. Откройте скрытую папку .config в вашем домашнем каталоге.
3. Откройте папку Laprdus
   • Или в терминале: cd ~/.config/Laprdus

Шаг 2: Откройте или создайте файл

• Если файл уже существует, откройте его в текстовом редакторе.
• Если файл не существует, создайте новый текстовый файл с соответствующим именем:
  • user.json для основного словаря.
  • spelling.json для словаря побуквенного чтения.
  • emoji.json для словаря эмодзи.

Шаг 3: Отредактируйте содержимое

Используйте формат JSON, описанный в предыдущих разделах (5.3, 5.4, 5.5). Пример для user.json:

{
    "version": "1.0",
    "entries": [
        {
            "grapheme": "YouTube",
            "phoneme": "Ютуб",
            "caseSensitive": false,
            "wholeWord": true,
            "comment": "Видеоплатформа"
        },
        {
            "grapheme": "Google",
            "phoneme": "Гугл",
            "caseSensitive": false,
            "wholeWord": true,
            "comment": "Поисковая система"
        }
    ]
}

ВАЖНО - Правила синтаксиса JSON:

• Все ключи и текстовые значения должны быть в двойных кавычках ".
• Запятые , между записями, НО НЕ после последней записи.
• Фигурные скобки {} для каждой записи.
• Квадратные скобки [] для списка записей.

Шаг 4: Сохраните файл

• Обязательно сохраните файл в кодировке UTF-8 (для поддержки кириллицы).
• Блокнот Windows: Файл > Сохранить как > Кодировка: UTF-8.
• Linux: Большинство редакторов автоматически используют UTF-8.

Шаг 5: Перезапустите синтезатор

• Windows SAPI5: Закройте и снова откройте приложение, использующее Laprdus.
• NVDA: Нажмите клавиша NVDA + Q и перезапустите NVDA, или переключитесь на другой синтезатор, а затем вернитесь на Laprdus.
• Linux: Перезапустите приложение или Speech Dispatcher: systemctl --user restart speech-dispatcher.

Примечание: Если вы редактируете словарь, когда приложение Android запущено, изменения не будут видны, пока вы не обновите список или не откроете приложение заново.

5.9 Примеры практического использования

Пример 1: Иностранные компании и бренды

Многие иностранные компании и бренды имеют произношение, отличающееся от письменной формы:

{
    "grapheme": "Microsoft",
    "phoneme": "Майкрософт",
    "caseSensitive": false,
    "wholeWord": true
}

{
    "grapheme": "Google",
    "phoneme": "Гугл",
    "caseSensitive": false,
    "wholeWord": true
}

{
    "grapheme": "WhatsApp",
    "phoneme": "Ватсап",
    "caseSensitive": false,
    "wholeWord": true
}

Пример 2: Аббревиатуры

Аббревиатуры, которые вы хотите произносить по буквам:

{
    "grapheme": "TV",
    "phoneme": "ТэВэ",
    "caseSensitive": false,
    "wholeWord": true
}

{
    "grapheme": "USA",
    "phoneme": "ЮэСА",
    "caseSensitive": false,
    "wholeWord": true,
    "comment": "Соединенные Штаты Америки"
}

{
    "grapheme": "EU",
    "phoneme": "ЕУ",
    "caseSensitive": false,
    "wholeWord": true,
    "comment": "Европейский союз"
}

Пример 3: Технические термины

{
    "grapheme": "ChatGPT",
    "phoneme": "ЧатДжиПиТи",
    "caseSensitive": false,
    "wholeWord": true
}

{
    "grapheme": "WiFi",
    "phoneme": "Вайфай",
    "caseSensitive": false,
    "wholeWord": true
}

{
    "grapheme": "USB",
    "phoneme": "УСБ",
    "caseSensitive": false,
    "wholeWord": true
}

Пример 4: Имена с необычным произношением

{
    "grapheme": "Sean",
    "phoneme": "Шон",
    "caseSensitive": false,
    "wholeWord": true,
    "comment": "Ирландское имя"
}

{
    "grapheme": "Elon",
    "phoneme": "Илон",
    "caseSensitive": false,
    "wholeWord": true
}

Пример 5: Замена внутри слов (wholeWord: false)

Для замены суффиксов или префиксов установите wholeWord в false:

{
    "grapheme": "tion",
    "phoneme": "шн",
    "caseSensitive": false,
    "wholeWord": false,
    "comment": "Английский суффикс -tion"
}

С этой записью слова, такие как information, будут содержать произношение шн вместо тион.

5.10 Решение проблем со словарями

Проблема: Изменения в словаре не применяются

Возможные причины и решения:

1. Применение пользовательских словарей отключено

   • Включите опцию Применять пользовательские словари в Конфигураторе Laprdus (Windows) или в настройках Laprdus (Android).

2. Синтаксическая ошибка в JSON-файле

   • Проверьте, все ли кавычки правильно закрыты.
   • Проверьте, правильно ли расставлены запятые.
   • Используйте онлайн-валидатор JSON для проверки синтаксиса.

3. Файл не сохранен в кодировке UTF-8

   • В Блокноте: Файл > Сохранить как > Кодировка: UTF-8.
   • В других редакторах: проверьте настройки кодировки.

4. Синтезатор не был перезапущен

   • Закройте и снова откройте приложение.
   • Для NVDA: Insert+Q > Перезапустить NVDA.

5. Файл находится в неправильном месте

   • Windows: %APPDATA%\Laprdus\
   • Linux: ~/.config/Laprdus/

Проблема: Слово заменяется в неправильных местах

Решение: Включите опцию Только целое слово для проблемной записи или вручную измените значение для этой записи в конфигурационном файле на wholeWord: true.

Пример проблемы: Запись для TV заменяется и в активатор, так как содержит TV.

{
    "grapheme": "TV",
    "phoneme": "ТэВэ",
    "wholeWord": true
}

Проблема: Замена не работает для разных регистров

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

• Для замены независимо от регистра: caseSensitive: false.
• Для точного совпадения: caseSensitive: true.

Проблема: Синтаксическая ошибка JSON

Частые ошибки в формате JSON:

Пропущенная запятая:

// НЕПРАВИЛЬНО:
{
    "grapheme": "test"
    "phoneme": "test"
}

// ПРАВИЛЬНО:
{
    "grapheme": "test",
    "phoneme": "test"
}

Запятая в конце:

// НЕПРАВИЛЬНО:
{
    "entries": [
        { "grapheme": "a", "phoneme": "b" },
    ]
}

// ПРАВИЛЬНО:
{
    "entries": [
        { "grapheme": "a", "phoneme": "b" }
    ]
}

Отсутствуют фигурные скобки:

// НЕПРАВИЛЬНО:
"grapheme": "test",
"phoneme": "test"

// ПРАВИЛЬНО:
{
    "grapheme": "test",
    "phoneme": "test"
}

Проблема: Эмодзи не читаются

Решение: Проверьте, включено ли чтение эмодзи.

1. Откройте Конфигуратор Laprdus или настройки Android.
2. Найдите опцию Читать эмодзи.
3. Включите эту опцию.
4. Сохраните настройки.

6. Голоса

6.1 Доступные голоса

Laprdus включает пять голосов — два основных и три производных:

6.2 Основные и производные голоса

Основные голоса (Josip и Vlado) используют физические записи фонем — реальные звуковые файлы дикторов.

Производные голоса (Detence, Baba, Djedo) используют те же звуковые файлы, что и основные голоса, но с измененной высотой тона:

• Detence использует фонемы Josip с высотой тона 1.5x (более высокий голос).
• Baba использует фонемы Josip с высотой тона 1.2x (немного более высокий голос).
• Djedo использует фонемы Vlado с высотой тона 0.75x (более низкий голос).

6.3 Выбор голоса

Windows SAPI5

1. Откройте Панель управления.
2. Выберите Специальные возможности > Распознавание речи > Преобразование текста в речь.
3. В раскрывающемся списке Выбор голоса выберите желаемый голос Laprdus.
4. Нажмите Применить.

NVDA

Метод 1: Настройки речи

1. Откройте меню NVDA (клавиша NVDA + N).
2. Выберите Параметры > Настройки > Речь.
3. В раскрывающемся списке Голос выберите желаемый голос.
4. Нажмите OK или Применить.

Метод 2: Кольцо настроек

1. Нажмите Control + клавиша NVDA + стрелка влево/вправо для изменения голоса.
2. Или используйте Control + клавиша NVDA + V для открытия диалога выбора голоса.

Linux (Speech Dispatcher)

# Список доступных голосов
spd-say -o laprdus -L

# Использование определенного голоса
spd-say -o laprdus -y josip "Текст на хорватском"
spd-say -o laprdus -y vlado "Текст на сербском"

Для постоянного изменения в экранном чтеце Orca:

1. Откройте настройки Orca (Insert+Пробел).
2. На вкладке Голос выберите желаемый голос из раскрывающегося списка.

Android

1. Откройте приложение Laprdus.
2. Коснитесь Настройки Laprdus.
3. В разделе Голос коснитесь раскрывающегося списка Голос.
4. Выберите желаемый голос из списка.

Для изменения голоса по умолчанию в системе:

1. Откройте Настройки > Специальные возможности > Преобразование текста в речь.
2. Коснитесь значка шестеренки рядом с Laprdus TTS.
3. Выберите желаемый голос.

7. Решение проблем

7.1 Частые проблемы

Нет звука

1. Проверьте, выбран ли Laprdus в качестве активного синтезатора.
2. Убедитесь, что громкость не установлена на 0.
3. Проверьте системную громкость компьютера.
4. Перезапустите программу, которую вы используете.

Слишком быстрая или слишком медленная речь

Настройте скорость речи:

• В NVDA: Control + клавиша NVDA + N > Настройки > Речь > Скорость.
• На Android: Откройте приложение Laprdus и отрегулируйте ползунок скорости в настройках Laprdus.
• В консольной программе: используйте опцию -r.

NVDA не находит Laprdus

1. Проверьте, правильно ли установлено дополнение (меню NVDA > Сервис > Управление дополнениями).
2. Перезапустите NVDA.
3. Убедитесь, что дополнение не отключено.

Speech Dispatcher не работает в Linux

1. Проверьте, установлен ли модуль Laprdus:

   ls /usr/lib/speech-dispatcher-modules/sd_laprdus

2. Проверьте конфигурацию:

   grep laprdus /etc/speech-dispatcher/speechd.conf

3. Перезапустите Speech Dispatcher:

   systemctl --user restart speech-dispatcher

7.2 Диагностические журналы

Дополнение для NVDA

Для включения диагностических журналов для дополнения NVDA:

1. Создайте пустой файл laprdus_debug во временном каталоге.
   • Windows: %TEMP%\laprdus_debug
2. Перезапустите NVDA.
3. Журналы будут сохраняться в %TEMP%\laprdus_debug.log.

Linux

Используйте опцию -w для подробного вывода:

laprdus -w "Тест"

7.3 Контакты и поддержка

Для помощи и поддержки:

• Эл. почта: hrvojekatic@gmail.com
• Веб-сайт: https://hrvojekatic.com/laprdus
• Исходный код: https://github.com/hkatic/laprdus

При сообщении о проблеме, пожалуйста, укажите:

• Версию Laprdus.
• Операционную систему.
• Используемый экранный чтец (если применимо).
• Описание проблемы.
• Шаги для воспроизведения проблемы.

Последнее изменение: февраль 2026.