Использование StarDict:
stardict опцииquery_word
С помощью query_word вы указываете StarDict выполнить поиск указанного слова сразу после запуска. Это работает так же, как ввод этого слова в поле поиска. Можно использовать шаблоны, нечёткий запрос и другие поддерживаемые режимы.
Эта опция задаёт минимальный уровень серьёзности, при котором сообщение должно быть показано в консоли. Значение может находиться в диапазоне от 0 до 6, где 0 — подавлять весь вывод, 6 — выводить все созданные сообщения, включая отладочные. Значение по умолчанию: 4 (передавать информационные сообщения, например, о том, какие словари загружаются при запуске).
Эта опция задаёт минимальный уровень серьёзности сообщения, при котором его следует сохранить в журнале. Значение может находиться в диапазоне от 0 до 6, где 0 — подавлять весь вывод, 6 — выводить все созданные сообщения, включая отладочные. Значение по умолчанию: 0 (файл журнала не используется). Дополнительные сведения о журнале StarDict: Раздел 7.5 ― Журналирование.
Не показывать заставку при запуске и скрыть главное окно. Будет показан только значок в области уведомлений.
Запустить новый экземпляр StarDict. По умолчанию программа StarDict проверяет, работает ли уже приложение, и предотвращает запуск второго экземпляра.
Эта опция доступна только в версиях StarDict для Windows и Gnome.
Выйти из существующего экземпляра StarDict.
Эта опция доступна только в версии StarDict для Gnome.
Указывает путь к файлу настройки каталогов StarDict. Дополнительные сведения о каталогах и файле настройки StarDict: Раздел 7.4 ― Каталоги StarDict.
Этот параметр доступен только в Windows-версии StarDict.
Включить мобильный режим, см. Раздел 8 ― StarDict Portable. Указания этой опции недостаточно для того, чтобы превратить StarDict в StarDict Portable. Пользоваться этой опцией можно только при условии полного понимания принципов её работы.
Этот параметр доступен только в Windows-версии StarDict.
Для управления словарями нажмите кнопку Управление словарями, расположенную в правом нижнем углу главного окна, или нажмите кнопку Главное меню и выберите пункт Управление словарями.
В диалоге управления словарями можно отключить ненужные словари, а также установить порядок, в котором словари будут опрашиваться.
StarDict ищет файлы словарей в каталогах «~/.stardict/dic» и «/usr/share/stardict/dic», а файлы древовидных словарей — в каталогах «~/.stardict/treedict» и «/usr/share/stardict/treedict»
Чтобы открыть документацию в приложении 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. Каждый каталог соответствует одному языку. Названия каталогов совпадают с кодами языков.
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
Каталог с файлами конфигурации.
Значение по умолчанию для Windows: C:\Documents and Settings\%USERNAME%\Application Data\StarDict.
Значение по умолчанию для других операционных систем: ~/.stardict.
Переменная среды: STARDICT_CONFIG_PATH.
Ключ stardict-dirs.cfg: user_config_dir.
Каталог пользовательского кэша.
Значение по умолчанию для Windows: C:\Documents and Settings\%USERNAME%\Temporary Internet Files\stardict.
Значение по умолчанию для других операционных систем: ~/.cache/stardict.
Ключ stardict-dirs.cfg: user_cache_dir.
Каталог данных.
Значение по умолчанию для Windows: C:\Program Files\StarDict.
Значение по умолчанию для других операционных систем: /usr/share/stardict.
Ключ stardict-dirs.cfg: data_dir.
Каталог с dll обработчика, только в версии для Windows.
Значение по умолчанию для Windows: data_dir.
Ключ stardict-dirs.cfg: dll_dir.
Каталог с модулями StarDict.
Значение по умолчанию для Windows: data_dir + "/plugins".
Значение по умолчанию для других операционных систем: /usr/lib/stardict/plugins.
Ключ stardict-dirs.cfg: plugins_dir.
Каталог с файлами справки, во всех версиях, за исключением версии для Gnome.
По умолчанию: data_dir + "/help".
Ключ stardict-dirs.cfg: help_dir.
Каталог для файлов журнала.
Значение по умолчанию для Windows: C:\Documents and Settings\%USERNAME%\Local Settings\Temp\StarDict.
Значение по умолчанию для других операционных систем: /var/tmp/stardict.
Ключ stardict-dirs.cfg: log_dir.
Значения по умолчанию в списке выше приведены в иллюстративных целях — чтобы показать возможные значения переменных. Фактическое значение по умолчанию зависит от ряда факторов, его не так просто вычислить. Чтобы узнать, как вычисляется значение по умолчанию, посмотрите на класс AppDirs в файле conf.h.
StarDict может записывать сообщения в файл. По умолчанию журналирование отключено. Его можно включить, указав отличный от нуля уровень журналирования с помощью параметра командной строки --log-level (см. Раздел 7.1 ― Параметры командной строки).
По умолчанию сообщения выводятся в консоли. Файл журнала может быть полезен, если консоль недоступна (как в Windows), а также при устранении проблем с запуском.
Сведения о стандартном расположении каталога с журналом доступны в разделе Раздел 7.4 ― Каталоги StarDict (параметр log_dir). Файлы журнала StarDict имеют названия вида stardict-номер_процесса.log. Номера процессов нужны для создания уникальных файлов журнала, так как одновременно могут работать несколько экземпляров StarDict. Чтобы найти файл журнала, относящийся к последнему запущенному экземпляру StarDict, обратите внимание на время создания файла.
В этом разделе описывается алгоритм, используемый для выбора языка интерфейса в StarDict.
Извлечь переменную среды STARDICTLANG. Перейти к 3, если переменная определена.
Извлечь стандартную локаль пользователя (чтобы установить локаль по умолчанию: Панель управления ▸ Язык и региональные стандарты ▸ Региональные параметры ▸ Стандарты и форматы ▸ Язык). Если локаль не определена, использовать «en».
Назначить код языка переменной среды LANG.
Извлечь значение переменной среды LANGUAGE. Это расширение GNU. Значение может представлять собой разделённый двоеточиями список имён локалей. Если переменная определена, перейти к 8.
Значение переменной среды LC_ALL, LC_xxx или LANG. Точнее, первой из этих переменных, которая установлена в непустое значение. Так это определяется в POSIX. Значение представляет собой имя одной локали. Если определено, перейти к 8.
Зависящий от системы список предпочитаемых языков. Его значением может быть разделённый двоеточиями список имён локалей. Если определено, перейти к 8.
Зависящее от системы имя стандартной локали. Если определено, перейти к 8.
Обработать найденное значение как разделённый двоеточиями список кодов языков. Выбрать первый доступный язык. Если доступных языков нет, не выбирать перевод.
Наилучший способ указать язык интерфейса StarDict — определить переменную среды STARDICTLANG. Она должна содержать код языка. Список поддерживаемых языков доступен в $StarDictDataDir/locale.
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.
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.
Index of words available in the dictionary.
Main content of the dictionary ‒ articles.
Index of synonyms. Optional.
Cache for the index file. This file is created by StarDict to speedup dictionaries loading. You should not redistribute this file.
Cache for the synonyms file. This file is created by StarDict to speedup dictionaries loading. You should not redistribute this file.
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.
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.
Files of resource database. It contains resources like images, sound and video files used in the dictionary. Optional.
Cache for the resource index file. This file is created by StarDict to speedup resource database loading. You should not redistribute this file.
A directory containing dictionary resources. This is alternative to res.rifo, res.ridx, res.rdic collection of files. Optional.
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.
A word list forming a tree.
Main content of the dictionary ‒ articles.
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.