TranSQL v0.92 by Frog
=====================

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

TranSQL работает с несколькими конфигурациями (словарями) - для каждой можно
задать SQL сервер, таблицы и поля по которым производится выборка. При поиске
возможен автоматический выбор словаря.

TranSQL может быть спрятан в system tray (по ESC, либо Minimize/Close) и
вызывается по  клику на иконке или по нажатию "горячей клавиши". По правому
клику иконки вызывается меню (Quick/About).

В общем случае соответствующие заданному слову данные ищутся через SELECT ..
WHERE field='слово'
Однако, если в слове встречается символ "%" или "_" - поиск производится через
SELECT .. WHERE field LIKE 'слово'.
В последнем случае символ подчеркивания "_" замещает любой одиночный символ,
знак "%" замещает последовательность любого числа символов ("?ожка",
"%граммировани?", "?indows" и т.д.).

Результаты поиска разделяются (если их несколько) строкой с символом  "-".
Результаты можно прокручивать при помощи мыши и клавиш курсора, а также из
строчки поиска - через Ctrl+курсоры.

Размер окна можно менять. Если окно находится близко к краю экрана, оно
автоматически к нему прижимается. 

TranSQL работает только с MySQL (через библиотеку libmysql.dll). Mysqld должен
быть установлен либо локально, либо на удаленном сервере.
Несколько словарей (в виде готовом для импорта в базу) можно скачать со
страницы Алексея Семенова - http://www.enlight.ru/ptkdic

Все параметры (как общие, так и для каждой конфигурации) описываются в
текстовом файле TRANSQL.INI и считываются программой при ее старте.


Описание TRANSQL.INI 
--------------------

Если какое-либо ключевое слово отсутствует, то используется значение по
умолчанию. Ошибка не выдается.

В секции [General options] описываются:

hotkey=Ctrl+T

Горячая комбинация клавиш по которой вызывается программа (сочетание Ctrl Alt
Shift , буква, цифра, Fxx)

startintray=yes

Поведение окна программы после старта: помещение только в system tray (yes),
либо сразу показ окна (no).

stayontop=no

Должно ли окно быть всегда поверх остальных (yes).

desktopdocking=10

Расстояние от краев экрана (в пикселах) при достижении которого окно
автоматически прижимается к самому краю. 0 - не прижимается.

openclicktype=lsingleclick

Определяет по какому click'y мышкой открывается окно.
 lsingleclick - одинарный по левой кнопке
 ldoubleclick - двойной по левой кнопке
 msingleclick - одинарный по средней кнопке
 mdoubleclick - двойной по средней кнопке

hideonclose=yes

Определяет реакцию на нажатие [X]. Либо программа завершает работу (no), либо
сворачивается в system tray, как и при нажатии на [_] или ESC (yes).

divider= ****
Определяет строку используемую для разделения результатов поиска


В остальных секциях описываются конфигурации. Например, несколько словарей (см.
пример .INI файла в архиве):

[Название словаря]
host=название машины с mysqld (mysql.xxx.ru , localhost и т.п.)
username=имя пользователя mysql
password=пароль mysql
database=имя базы mysql
port=порт mysql (обычно 3306)
encoding=кодировка русских букв в базе (koi8r,cp1251,alt)
queryselect=часть mysql запроса до WHERE field включительно.
queryinsert=пока не используется
queryupdate=пока не используется
autoselect=условие при котором будет автоматически выбрана эта конфигурация
(имеет значение только в режиме Auto). На данный момент есть два условия:
englishpresent (если в слове которое вы ищете есть хотя бы один символ a-zA-Z)
и russianpresent (если есть хотя бы один символ а-яА-Я, исключая ё,Ё).
Например, если для данной конфигурации указано autoselect=russianpresent,
то она будет использоваться при поиске слова с русскими буквами.


...


КАК ЗАКАЧАТЬ СЛОВАРЬ В БАЗУ?
----------------------------

Несколько словарей доступны на http://www.enlight.ru/ptkdic (спасибо Алексею
Семенову). Они в виде .sql файлов (набор sql команд) и для того чтобы поместить
их в базу необходимо набрать нечто вроде:

mysql -u username -p dbname < filename 

И, конечно, ничто не мешает вам создавать собственные словари (и выкладывать их
для общей пользы :)

============================================================================

Благодарности: StarGuest, Riddle, Ksu, Alexey Semenov.

http://www.enlight.ru/frog
E-Mail: frog@enlight.ru