# Документация QStarDict

QStarDict — это словарное приложение. Оно позволяет пользователю устанавливать словари Kiwix и StarDict и искать слова в этих словарях.

Эта инструкция должна помочь Вам в использовании QStarDict.

## Содержание

- Запуск QStarDict
- Работа в фоне
- Запуск с системой
- Установка словарей Kiwix
- Установка словарей StarDict
- Поиск слов
- Всплывающее окно

## Starting QStarDict

QStarDict можно запустить либо через меню среды среды рабочего стола в разделе «Образование», либо с использованием командной строки путем набора команды

`qstardict`

## Работа в фоне

Когда QStarDict запущен, он может быть либо в нормальном режиме, когда главное окно показано, как здесь: или он может быть запущен в фоновом режиме.

Когда QStarDict запущен в фоновом режиме, он может быть показать в области уведомлений:

Предназначение фонового режима — сделать возможным для QStarDict сканирование cвыделения в других приложениях и показ всплывающего окна со словарными статьями. Смотрите раздел о всплывающем окне для деталей.

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

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

Если Вы хотите, чтобы QStarDict запускался в фоновом режиме, используйте опцию командной строки `--background`, запуская QStarDict как

`qstardict --background`

## Запуск с системой

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

По умолчанию запуск с системой отключен.

## Установка словарей Kiwix

Kiwix — это проект, целью которого является создание оффлайн-версий веб-сайтов. Наиболее выдающимся среди этих веб-сайтов для использования с QStarDict является Викисловарь.

Для того, чтобы загрузить оффлайн-версии Викисловаря для языков, которые Вам требуются, посетите Страницу загрузки ZIM-файлов и выберите версию "nopic" Викисловаря для языка, который Вам требуется.

Обратите внимание, что язык, указанный в имени файла является целевым языком, а не исходным языком. Каждый язык содержит статьи для слов на всех исходных языках на целевом языке. К примеру, если Вы хотите смотреть слова на английском, переведенные на русский, Вам нужно выбрать файл с языковым кодом «ru_all».

Примеры названий файлов:

- «wiktionary_ru_all_nopic_2023-09.zim» — словарь на русском для всех языков;
- «wiktionary_en_all_nopic_2023-07.zim» — словарь на английском для всех языков.

Предположим, что Вы загрузили файл «wiktionary_en_all_nopic_2023-07.zim» в директорию «~/Загрузки».

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

Для того, чтобы установить словарь, нажмите кнопку «Добавить словарь», которая отмечена на скриншоте.

Выполнение этого приведет к открытию файлового диалога:

В файловом диалоге выберите фильтр «ZIM файлы Kiwix» (отмеченный на скриншоте) и затем выберите ZIM файл, который Вы хотите добавить.

Когда файл выбран, появится диалог добавления словаря:

Он предложит Вам переместить словарь в директорию QStarDict.

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

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

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

## Установка словарей StarDict

QStarDict поддерживает словари в формате StarDict 2.x и StarDict 3.x.

Словарь StarDict состоит из трех файлов:

- «.ifo» — файл, содержащий метаданные о словаре;
- «.idx» — индексный файл словаря;
- «.dict.dz» — файл, содержащий словарные статьи.

Словарь StarDict может быть установлен в QStarDict путем открытия вкладки «Словари» в диалоге настроек, который может быть открыт с использованием меню «Настройки» → «Конфигурация» в главном окне: Для того, чтобы установить словарный файл в QStarDict, нажмите кнопку «Добавить словарь», которая отмечена на скриншоте.

Это приведет к открытию файлового диалога:

В файловом диалоге выберите фильтр «IFO файлы StarDict» (отмеченный на скриншоте) и затем выберите ".ifo" файл, который Вы хотите добавить.

Обратите внимание, что «.idx» и «.dict.dz» файлы должны быть в той же директории, что и «.ifo» файл для того, чтобы словарь мог быть успешно импортирован.

После импортирования словаря он появится наверху списка словарей в диалоге настроек:

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

## Поиск слов

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

## Всплывающее окно

Всплывающее окно — это окно, которое может быть показано рядом со словами, выделенными мышью. Его поведение может быть настроено во вкладке «Всплывающее окно» диалога конфигурации.