Информация

7.1 Параметры командной строки

Использование StarDict:

stardict опцииquery_word

query_word

С помощью query_word вы указываете StarDict выполнить поиск указанного слова сразу после запуска. Это работает так же, как ввод этого слова в поле поиска. Можно использовать шаблоны, нечёткий запрос и другие поддерживаемые режимы.

-m, --message-level=целое число

Эта опция задаёт минимальный уровень серьёзности, при котором сообщение должно быть показано в консоли. Значение может находиться в диапазоне от 0 до 6, где 0 — подавлять весь вывод, 6 — выводить все созданные сообщения, включая отладочные. Значение по умолчанию: 4 (передавать информационные сообщения, например, о том, какие словари загружаются при запуске).

-l, --log-level=целое число

Эта опция задаёт минимальный уровень серьёзности сообщения, при котором его следует сохранить в журнале. Значение может находиться в диапазоне от 0 до 6, где 0 — подавлять весь вывод, 6 — выводить все созданные сообщения, включая отладочные. Значение по умолчанию: 0 (файл журнала не используется). Дополнительные сведения о журнале StarDict: Раздел 7.5 ― Журналирование.

-h, --hide

Не показывать заставку при запуске и скрыть главное окно. Будет показан только значок в области уведомлений.

-n, --new

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

Эта опция доступна только в версиях StarDict для Windows и Gnome.

-q, --quit

Выйти из существующего экземпляра StarDict.

Эта опция доступна только в версии StarDict для Gnome.

--dirs-config

Указывает путь к файлу настройки каталогов StarDict. Дополнительные сведения о каталогах и файле настройки StarDict: Раздел 7.4 ― Каталоги StarDict.

Этот параметр доступен только в Windows-версии StarDict.

--portable-mode

Включить мобильный режим, см. Раздел 8 ― StarDict Portable. Указания этой опции недостаточно для того, чтобы превратить StarDict в StarDict Portable. Пользоваться этой опцией можно только при условии полного понимания принципов её работы.

Этот параметр доступен только в Windows-версии StarDict.

7.2 Управление словарями

Для управления словарями нажмите кнопку Управление словарями, расположенную в правом нижнем углу главного окна, или нажмите кнопку Главное меню и выберите пункт Управление словарями.

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

StarDict ищет файлы словарей в каталогах «~/.stardict/dic» и «/usr/share/stardict/dic», а файлы древовидных словарей — в каталогах «~/.stardict/treedict» и «/usr/share/stardict/treedict»

7.3 Справка

Чтобы открыть документацию в приложении StarDict, следует либо нажать клавишу F1, либо щёлкнуть по кнопке Главное меню и выбрать во всплывающем меню пункт Справка. Формат документации StarDict зависит от версии приложения. Основным форматом документации является DocBook. StarDict устанавливает документацию в формате DocBook только в версии для Gnome. В этой версии документация интегрируется в систему документации Gnome. Чтение документации можно выполнить с помощью Браузера справки. Документация была переведена на несколько языков; пользователю будет показана локализованная версия (если она доступна). Gnome позволяет настроить предпочитаемый язык.

В других версиях StarDict документация доступна в формате HTML. Потребуется настроить веб-браузер для просмотра документации, см. Раздел 4.2.2 ― Веб-браузер. При выборе языка документации StarDict в общих чертах следует алгоритму выбора локали пакета gettext. Сначала проверяется переменная среды LANGUAGE. Ожидается, что она будет содержать список кодов языков в порядке приоритета. Если переменная LANGUAGE не установлена, рассматривается текущая локаль. Наконец, если документация на предпочитаемых языках недоступна, отображается документация на английском.

В Windows-версии StarDict язык по умолчанию соответствует тому языку, который выбран в диалоге Язык и региональные стандарты.

Изменение языка по умолчанию

Откройте Панель управления, Язык и региональные стандарты. Появится диалоговое окно Язык и региональные стандарты. Перейдите на вкладку Региональные параметры и выберите язык в группе параметров Стандарты и форматы.

Переопределить язык по умолчанию можно с помощью переменной среды LANGUAGE.

Обычно файлы справки находятся в каталоге C:\Program Files\StarDict\help. Каждый каталог соответствует одному языку. Названия каталогов совпадают с кодами языков.

7.4 Каталоги StarDict

StarDict использует несколько каталогов для хранения данных приложения, загрузки и сохранения параметров конфигурации. Каталоги по умолчанию назначаются во время сборки, но некоторые из них можно переопределить с помощью файла stardict-dirs.cfg. Переопределение каталогов StarDict может быть полезным, если нужно выполнить отладку или подготовить специальные конфигурации (такие, как StarDict-portable для Windows); обычному пользователю это не требуется.

StarDict ищет файл stardict-dirs.cfg в каталоге user_config_dir. Расположение файла stardict-dirs.cfg можно переопределить с помощью переменной среды STARDICT_DIRS_CONFIG_FILE или параметра командной строки --dirs-config. Параметр командной строки обладает наивысшим приоритетом, за ним следует переменная среды, далее — файл в каталоге user_config_dir. В качестве файла конфигурации будет использован первый указанный файл. В случае сбоя загрузки программа не будет пытаться использовать другие файлы.

Файл stardict-dirs.cfg похож на конфигурационный файл .ini. Синтаксис файлов .ini подробно описывается здесь: Desktop Entry Specification. Все ключи должны принадлежать группе "general".

Не забудьте продублировать символы обратной косой черты в значениях. В Windows обратная косая черта используется в качестве разделителя пути.

Пример файла stardict-dirs.cfg для Windows:

[general]
data_dir=C:\\Program Files\\StarDict
dll_dir=C:\\StarDict\\msvc_2008\\Debug
plugin_dir=C:\\StarDict\\msvc_2008\\Debug

	

Каталоги StarDict
user_config_dir

Каталог с файлами конфигурации.

Значение по умолчанию для Windows: C:\Documents and Settings\%USERNAME%\Application Data\StarDict.

Значение по умолчанию для других операционных систем: ~/.stardict.

Переменная среды: STARDICT_CONFIG_PATH.

Ключ stardict-dirs.cfg: user_config_dir.

user_cache_dir

Каталог пользовательского кэша.

Значение по умолчанию для Windows: C:\Documents and Settings\%USERNAME%\Temporary Internet Files\stardict.

Значение по умолчанию для других операционных систем: ~/.cache/stardict.

Ключ stardict-dirs.cfg: user_cache_dir.

data_dir

Каталог данных.

Значение по умолчанию для Windows: C:\Program Files\StarDict.

Значение по умолчанию для других операционных систем: /usr/share/stardict.

Ключ stardict-dirs.cfg: data_dir.

dll_dir

Каталог с dll обработчика, только в версии для Windows.

Значение по умолчанию для Windows: data_dir.

Ключ stardict-dirs.cfg: dll_dir.

plugin_dir

Каталог с модулями StarDict.

Значение по умолчанию для Windows: data_dir + "/plugins".

Значение по умолчанию для других операционных систем: /usr/lib/stardict/plugins.

Ключ stardict-dirs.cfg: plugins_dir.

help_dir

Каталог с файлами справки, во всех версиях, за исключением версии для Gnome.

По умолчанию: data_dir + "/help".

Ключ stardict-dirs.cfg: help_dir.

log_dir

Каталог для файлов журнала.

Значение по умолчанию для Windows: C:\Documents and Settings\%USERNAME%\Local Settings\Temp\StarDict.

Значение по умолчанию для других операционных систем: /var/tmp/stardict.

Ключ stardict-dirs.cfg: log_dir.

Значения по умолчанию в списке выше приведены в иллюстративных целях — чтобы показать возможные значения переменных. Фактическое значение по умолчанию зависит от ряда факторов, его не так просто вычислить. Чтобы узнать, как вычисляется значение по умолчанию, посмотрите на класс AppDirs в файле conf.h.

7.5 Журналирование

StarDict может записывать сообщения в файл. По умолчанию журналирование отключено. Его можно включить, указав отличный от нуля уровень журналирования с помощью параметра командной строки --log-level (см. Раздел 7.1 ― Параметры командной строки).

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

Сведения о стандартном расположении каталога с журналом доступны в разделе Раздел 7.4 ― Каталоги StarDict (параметр log_dir). Файлы журнала StarDict имеют названия вида stardict-номер_процесса.log. Номера процессов нужны для создания уникальных файлов журнала, так как одновременно могут работать несколько экземпляров StarDict. Чтобы найти файл журнала, относящийся к последнему запущенному экземпляру StarDict, обратите внимание на время создания файла.

7.6 Язык интерфейса

В этом разделе описывается алгоритм, используемый для выбора языка интерфейса в StarDict.

  1. Извлечь переменную среды STARDICTLANG. Перейти к 3, если переменная определена.

  2. Извлечь стандартную локаль пользователя (чтобы установить локаль по умолчанию: Панель управления ▸ Язык и региональные стандарты ▸ Региональные параметры ▸ Стандарты и форматы ▸ Язык). Если локаль не определена, использовать «en».

  3. Назначить код языка переменной среды LANG.

  4. Извлечь значение переменной среды LANGUAGE. Это расширение GNU. Значение может представлять собой разделённый двоеточиями список имён локалей. Если переменная определена, перейти к 8.

  5. Значение переменной среды LC_ALL, LC_xxx или LANG. Точнее, первой из этих переменных, которая установлена в непустое значение. Так это определяется в POSIX. Значение представляет собой имя одной локали. Если определено, перейти к 8.

  6. Зависящий от системы список предпочитаемых языков. Его значением может быть разделённый двоеточиями список имён локалей. Если определено, перейти к 8.

  7. Зависящее от системы имя стандартной локали. Если определено, перейти к 8.

  8. Обработать найденное значение как разделённый двоеточиями список кодов языков. Выбрать первый доступный язык. Если доступных языков нет, не выбирать перевод.

Шаги с 4 по 8 описывают алгоритм выбора перевода пакета gettext. Фактическая процедура может отличаться.

Наилучший способ указать язык интерфейса StarDict — определить переменную среды STARDICTLANG. Она должна содержать код языка. Список поддерживаемых языков доступен в $StarDictDataDir/locale.

7.7 StarDict dictionaries

StarDict supports two types of dictionaries: index (normal) dictionaries and tree dictionaries. The vast majority of dictionaries for StarDict you may find on Internet are of the index type. In fact, you hardly find a tree dictionary for StarDict. An index dictionary contain a list of words in one file and corresponding definitions in other file. That index of words is the reason we call it an index dictionary. An index dictionary may contain other data as well. In a tree dictionary data are organized in a tree that is why it name. StarDict searches index and tree dictionaries in different directories.

Almost all files constituting a dictionary are binary. It does not make sense to open them in a text editor. A notable exception is .ifo file, it contains dictionary description.

Index dictionary files and directories
dictname.ifo

Information about the dictionary. This a text file, you may open it in a text editor. You may found useful information here like dictionary description, author name and e-mail.

dictname.idx or dictname.idx.gz

Index of words available in the dictionary.

dictname.dict or dictname.dict.dz

Main content of the dictionary ‒ articles.

dictname.syn

Index of synonyms. Optional.

dictname.idx.oft

Cache for the index file. This file is created by StarDict to speedup dictionaries loading. You should not redistribute this file.

dictname.syn.oft

Cache for the synonyms file. This file is created by StarDict to speedup dictionaries loading. You should not redistribute this file.

dictname.idx.clt

Collation file for the index file. This file is created by StarDict when you use collations to modify sorting order of words. You should not redistribute this file.

dictname.syn.clt

Collation file for the synonyms file. This file is created by StarDict when you use collations to modify sorting order of words. You should not redistribute this file.

res.rifo, res.ridx, res.rdic

Files of resource database. It contains resources like images, sound and video files used in the dictionary. Optional.

res.ridx.oft

Cache for the resource index file. This file is created by StarDict to speedup resource database loading. You should not redistribute this file.

res

A directory containing dictionary resources. This is alternative to res.rifo, res.ridx, res.rdic collection of files. Optional.

Tree dictionary files
dictname.ifo

Information about the dictionary. This a text file, you may open it in a text editor. You may found useful information here like dictionary description, author name and e-mail.

dictname.tdx or dictname.tdx.gz

A word list forming a tree.

dictname.dict or dictname.dict.dz

Main content of the dictionary ‒ articles.

7.7.1 Directories

This section describes directories where StarDict searches dictionaries.

Under Unix™, StarDict searches ~/.stardict/dic and /usr/share/stardict/dic directories for index dictionaries and ~/.stardict/treedict and /usr/share/stardict/treedict directories for tree dictionaries. If you build StarDict with non-standard prefix, the application searches a pair of additional directories for dictionaries. It checks $(datadir)/dic for index dictionaries and $(datadir)/treedict for tree dictionaries. Here $(datadir) is an autoconf directory variable.

Under Windows™, StarDict searches C:\Program Files\StarDict\dic for index dictionaries and C:\Program Files\StarDict\treedict for tree dictionaries, assuming that StarDict was installed into C:\Program Files\StarDict. If you've install StarDict into a different directory, replace C:\Program Files\StarDict with real installation path.

Under Windows™, you may overwrite $data_dir variable, see Раздел 7.4 ― Каталоги StarDict. By default it matches the StarDict installation directory. In this case StarDict will search $data_dir\dic for index dictionaries and $data_dir\treedict for tree dictionaries.

All directories are processed recusively.