Работа в консоли с помощью SL


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


Опции поиска

   Чтобы найти слово, используйте команду (поиск по умолчанию):
      sl слово

   То же самое делает опция -u (--usually):
      sl -u слово
   Если вы указали какие-либо опции командной строки, то поиск по умолчанию производиться не будет, если вы в явном виде не укажите опцию поиска, например:
      sl -t --output-format=native -u alien

   Чтобы найти словосочетание, необходимо заключить его в кавычки:
      sl "несколько слов"

   Чтобы найти первое же слово, которое начинается на введенные символы, используйте опцию -f (--first-concurrence):
      sl -f первые_буквы_слова
   Поиск в этом режиме так же запускается автоматически, если не было найдено ни одного слова при обычном поиске.

   Чтобы применить расширенный поиск, воспользуйтесь опцией -c (--word-combinations):
      sl -c слово
   Будут найдены все возможные словосочетания с этим словом.

   Если вы забыли слово, то вы можете использовать опцию -l (--list):
      sl -l первые_буквы_слова
   Первыми буквами слова могут быть, например hell. После этого программа напечатает все слова, которые начинаются с этих символов. Среди них обязательно будет искомое слово, такое как hello. Если вы все же не нашли требуемого, то сократите количество символов на один с конца (так hell превратиться в hel).

   Если вы не знаете точного написания слова, то можете попытаться найти слово, написание которого, как вам кажется, наиболее правильное, используя опцию -i (--ill-defined):
      sl -i countr
   Среди списка слов окажется нужное вам слово, например counter. Эту опцию так же возможно использовать следующим образом:
      sl -p 50 -i countr
   Дополнительный аргумент (-p (--percent) 50) представляет собой указание процента несовпадающих символов. По умолчанию - 40, это оптимальное значение.

   Если вы установили набор звуков, можете прослушать произношение слова, используя опцию -s (--sound):
      sl -s набор:слово
   Параметр набор - это имя установленного набора звуков, например, en. В переводе слова (при различных) в квадратных скобках так же указывается, какой именно запрос необходимо составить, чтобы передать его данной опции.


Опции справки

   Опция --help выводит на экран краткую справку.

   Опция --version выводит на экран версию программы.

   Опция --debug выводит отладочную информацию.


Опции управления словарями

   Опция --connect подключает указанный словарь для использования:
      sl --connect "dict"

   Опция --disconnect отключает указанный словарь (слова в нем искаться не будут):
      sl --disconnect "dict"

   Опция --print-info выводит список всех словарей и список подключенных словарей:
      sl --print-info

   Вы можете добавить собственный локальный словарь, воспользовавшись опцией --install:
      sl --install "file"
   Затем, если вы хотите подключить его, воспользуйтесь опцией --connect, как показано выше.
   Добавляемый словарь должен быть проиндексирован или в нем должнен присутствовать тег [noindex]. В противном случая словарный файл считается некорректным. О том, как проиндексировать файл вручную, написано ниже.

   Можно так же удалить установленный словарь, используя опцию --remove:
      sl --remove "dict"
   Перед удалением необходимо отключить словарь.

   Опция --use-list устанавливает список словарей, в которых должен производиться поиск. Поиск происходит не зависимо от того, подключен словарь или нет. Для разделения словарей используются символы "|", весь список же заключается в одиночные ковычки:
      sl --use-list 'dict1|dict2|dict3' ...
   Эта опция используется графическими оболочками для того, чтобы пользователь мог устанавливать собственный порядок вызова словарей вместо используемого по умолчанию ("подключенные" словари).
   Опция --print-index индексирует указанный файл:
      sl --print-index "file"
   Программа выводит на стандартный вывод (экран) определенного вида списко - это индекс указанного словаря. О его формате написано в главе Формат словарей SL. После записи индекса нужно еще раз проиндексировать словарь, поскольку после записи первого индекса относительное смещение внутри файла изменится. Новый индекс нужно записать поверх старого.
   Типичный алгоритм индексации и установки словаря выглядит следующим образом:
      sl --print-index dict > /tmp/dict1
      cat dict >> /tmp/dict1
      sl --print-index /tmp/dict1 > /tmp/dict2
      cat dict >> /tmp/dict2
      mv /tmp/dict2 dict
      sl --install dict
   Алгоритм, возможно, покажется вам сложным, он вызван техническими особенностями реализации системы. Однако, если вы устанавливаете словарь из Интернета, используя LLRepo, все эти операции выполняются в автоматическом режиме.
   Если вы не хотите использовать индексацию, в начале файла пропишите тег [noindex].


Опции настроек

   Опция --output-format=html|text|native устанавливает формат вывода программы. По умолчанию используется text. Дополнительно доступные опции выводят перевод в виде отформатированного HTML-кода (опция html, используется, например, в оболочках) или в том виде, в каком они записаны в самом файле (native).

   Опция --use-terminal-escapes=yes|no устанавливает разрешение на использование ESC-последовательностей терминала для цветового форматирования. По умолчанию разрешено, если стандартный вывод является терминалом, опция же используется для принудительной установки разрешения. В случае, если вы запускаете SL на другой UNIX-системе (не Linux), эти последовательности могут работать некорректно. В таком случае, пропишите следующую строку в ваш файл .bashrc, находящийся в домашнем каталоге:
      alias sl='sl --use-terminal-escapes=no'
   Этот же метод можно использовать для любой тонкой настройки опций SL
   Опция -t (--show-time) заставляет программу показывать время, затраченное на поиск.


Переменные окружения

   При использовании в консоли можно экспортировать переменную окружения COLUMNS, тогда вывод программы (для режима text) будет выравниваться по ширине всей консоли:
      export COLUMNS
   Для того, чтобы не пришлось постоянно выполнять эту команду перед использованием SL, вы можете так же прописать ее в файл .bashrc.
   SL определяет домашний каталог пользователя через переменную HOME. Изменив ее, можно заставить искать другой каталог настроек .sl, по умолчанию хранящийся в домашнем каталоге пользователя. В данном каталоге находится несколько символических ссылок на подключенные словари. Сами же словари, по умолчанию (если вы не меняли префикс инсталляции) находятся в каталоге /usr/share/sl/dicts (звуки находятся рядом, /usr/share/sl/sounds).