CLIMMRC(5)

ИМЯ
~/.climm/climmrc - Файл настроек для climm

Описание
Эта страница описывает файл настроек для climm. Он состоит из нескольких частей, которые начинаются с [часть], где часть - имя раздела. Имена файлов или директорий заданы относительно базовой директории, обычно это ~/.climm/.

CONNECTIONS
Раздел Соединений описывает соединение с ICQ. Обычно, их два, которые относятся друг к другу: соединение с ICQ сервером, и соединение для прослушивания один-на-один соединений. У Вас так же может быть соединение удаленного управления: это обозначает что открыт FIFO, и строки считанные из него интерпретируются так же, как введенные пользователем.

type type [auto]
    Устанавливает тип соединения на type, который может быть как icq5 для подключения к ICQ v5 серверу, или icq8 для подключения к ICQ v8 серверу, или peer для соединения, прослушивающего один-на-один подключение. Если задано auto , то соединение устанавливается при загрузке. Если у Вас не несколько UIN'ов, будет удобно установить эту опцию в описании Вашего UIN'а, который вы используете.

version номер
    Устанавливает версию протокола для соединения на номер. Учтите, что для серверного соединения поддерживаются только версии 5, 7 и 8 , и для одни-на-один соединений только 6, 7 и 8 . FIFO удаленного управления версии не имеет.

server сервер
    Устанавливает сервер, к которому подключаться на сервер. По умолчанию login.icq.com. Не используется для 1-на-1 соединений. Для FIFO удаленного управления, тут указывается путь к этому FIFO.

port порт
    Устанавливает порт, к которому подключаться на сервере на порт, или первый порт для попытки прослушивания 1-на-1 соединений на порт.

uin UIN
    Устанавливает UIN, с которым логиниться на UIN. Не используется для 1-на-1 соединений и FIFO удаленного соединения.

password [пароль]
    Устанавливает пароль, с которым логиниться на пароль. Не используется для 1-на-1 соединений. Если отсутствует, пароль спрашивается при старте программы. Замечание: пользователи BeOS не могут убирать эту опцию.

status номер
    Устанавливает режим, с которым логиниться на номер. Возможные режимы:

    0   Online

    1   Ушел

    5   Недоступен

    17  Занят

    19  Не беспокоить

    32  Готов пообщаться

    256 Невидимый
    Для один-на-один соединений, это используется для настроек прямого соединения:

    1   Мы за файрволом и не можем получить соединение. Даже не пытайтесь.

    2   Мы за файрволом, но используем SOCKS и можем получить соединение.

    4   Мы вообще не за файрволом. Это по умолчанию.
    FIFO удаленного соединения не используют эту настройку.

GENERAL
Этот раздел включает опции для SOCKS 5, которые могут быть перемещены в свою секцию или общие опции для переопределения.

s5_use номер
    Установите номер на 0 для выкл. и 1 для вкл.

s5_host хост
    Соединяет с socks 5 прокси на хост.

s5_port порт
    Соединяет с socks 5 прокси на порт порт.

s5_auth номер
    Установите номер на 0 если не надо аутентификации и 1 если надо.

s5_name имя
    Идентифицировать пользователя как имя на socks 5 прокси.

s5_pass пароль
    Подтвердить подлинность паролем пароль на socks 5 прокси.

Теперь опции:

encoding file <кодировка>
    Указывает кодировку используемую в этом файле как кодировку. climm всегда будет записывать этот файл в UTF-8.

encoding local <кодировка>
    Указывает кодировку пользовательского терминала в кодировку. Это переопределит кодировку полученную из переменных окружения.
    Замечание: Используйте это в случае если локализация поломана, и видно как символы в из диапазона iso-8859-1 печатаются в виде шестнадцатеричных кодов и ширина символов не может быть больше определена с помощью wcwidth(). Таким образом, всегда используйте LC_CTYPE установки локализации для переопределения используемой кодировки.

encoding remote <кодировка>
    Установить кодировку для использования в метаданных на сервере, включая пароль, в кодировка. Эта кодировка так же используется для коммуникации с другими контактами, которые не понимаю UTF-8 сообщений, если не установлена специальная кодировка для этого контакта. Эта опция считается устаревшей, так как с climm 0.5 используется глобальная опция кодировки .

format <номер>
    Устанавливает формат этого конфиг файла в номер. Текущий формат 2, но формат 1 так же может использоваться.

Теперь остальные опции:

verbose уровень
    Устанавливает уровень вывода информации при загрузке на уровень.

auto_away время
    Устанавливает время для перехода в режим Ушел на время секунд. Установите 0 чтобы отключить.

Screen_width ширина
    Устанавливает ширину экрана на ширина. Если не поставлено, то 0, 80 будет использовано. Используется редко, т.к. ширина может быть уменьшена во время работы.

set delbs on|off
    Если установлено on, то клавиша delete будет как backspace. Если off, то останется сама собой.

set funny on|off
    Включить или отключить "funny" сообщения.

set color on|off
    Включить или отключить использование цветов.

set hermit on|off
    Если стоит on, то игнорировать все сообщения пользователей, кроме тех, кто в вашем контакт-листе. Эта опция считается устаревшей, так как с climm 0.5 используется глобальная опция ignore в on с тем же эффектом.

set log on|off
    Включить или отключить журнал. Эта опция считается устаревшей, так как с climm 0.5 используется глобальная опция logmess в on с тем же эффектом.

set logonoff on|off
    Когда включен журнал, включить или отключить запись в журнал смены online/offline режимов. Эта опция считается устаревшей, так как с climm 0.5 используется глобальная опция logmess и logchange в on с тем же эффектом.

set auto on|off
    Включить или отключить автоответы.

set uinprompt on|off
    Включить или отключить использование ника, от которого вам пришло сообщение в строке.

set autosave on|off
    Вкл. или выкл. автоматическое сохранение climmrc.

set autofinger on|off
    Вкл. или выкл. автоматический опрос данных(fingering) для новых UINs. Disable or enable the automatic fingering of new UINs.

set linebreak тип
    Устанавливает тип обрезки линий входящих сообщений на тип, который может быть simple просто переносить линии как обычно, break перенос линии перед каждым сообщением, indent перенос линии и делать отступ в сообщении и smart переносить линии, если они больше экрана.

set tabs simple|cycle|cycleall
    Эта опция считается устаревшей, так как с climm 0.5 используется улучшенная версия авто дополнения, которая включает в себя все предыдущие.

set silent <type>
    Подавляет некоторый вывод информации, то есть изменение статуса для on и изменение статуса, подключения и отключения для complete. Эта опция считается устаревшей, так как с climm 0.5 используется глобальная опция showchange and showonoff в on с тем же эффектом.

options <options>
    Устанавливает глобальную опцию. Смотри opt для детальной информации.

chat <номер>
    Установить чат-группу в номер. Используйте -1 чтобы отключить, и 49 для climm (по умолчанию).

autoupdate  <уровень>
    Текущий уровень прошедшего автоматического обновлении конфигурации. Это значение будет увеличиваться каждый раз когда кофигурация будет обновлена. Не устанавливайте это в 0 для отключения, так как на самом деле все обновления будут переделаны.

Наконец, еще кое-что:

color схема nr
    Выбрать цветовую схему номер nr.

color use color
    Выбрать цвет color для use. use может быть none, server, client, message, contact, sent, ack, error, debug или incoming, когда color может быть black, red, green, yellow, blue, magenta, cyan, white, none, или bold или комбинация из (bold, должна быть последним, чтобы произвело действие), или любая строка, заставляющая пользовательский терминал выбирать нужные цвета.

logplace файл|дир
    Устанавливает файл, в который записывается лог в файл, или директорию, в которую писать логи в дир. Учтите, считается за путь если содержит /.

sound on|beep|off|event
    Указывает что происходит когда генерируется звуковой сигнал. Включить или отключить звуковой сигнал. Если ни on или beep будет генерировать звуковой сигнал, off будет ничего не делать, в то время как event будет запускать скрипт для событий.

event <script>
    устанавливает script для запуска при наступлении событий. Он вызывается со следующими аргументами:
    1. Тип IM, в текущей версии только icq.
    2. UIN контакта к которому относится событие, или 0.
    3. Ник контакта к которому относится событие, или пустая строка.
    4. Строка global.
    5. Тип события, которое может быть msg, on, off, beep or status, где on и off для входящих и уходящих контактов. Этот список может быть неполным.
    6. Для сообщений - тип сообщения, для уходящих контактов - предыдущий статус, и для входящих контактов или при изменении статуса - новый статус, в любом другом случае 0.
    7. Текст сообщения.
    8. Имя и версия клиента ICQ контакта.
    Замечание: из соображений безопасности, одиночные кавычки могут быть заменены на двойные кавычки, и текст сообщения может быть обрезан.

auto режим строка
    Устанавливает автоответы для режимов режим на строка. Эта опция может быть повторена для всех режимов away, na, dnd, occ, и inv для режим.

STRINGS
Этот раздел содержит информацию о переименовании команд и алиасы.

alter <старая> <новая>
    Переименовать команду старая на новая. Старая команда может быть использована до тех пор, пока она не конфликтует некоторым новая имя. Для возможных команд, смотрите climmcmds(7). Эта опция может быть повторена сколько угодно раз.
    Замечание: эта опция устаревшая, используйте вместо нее alias .

alias [auto[expand]] <alias> <expansion>
    Определяет алиас по имени alias который разворачивается в expansion. Если загаданы ключевые слова auto или autoexpand , разворачивание алиаса так же происходит когда нажат пробел или Enter сразу после алиаса. Если строка %s находится в expansion, то каждая %s заменяется на аргумент алиаса когда тот вызывается, в противном случае аргументы будут дополнены к expansion. Если строка %r находится в expansion, то каждая %r заменяется на ник, или если ник недоступен, на UIN, контакта который последним отослал Вам сообщение, или пустая строка в противном случае. Если строка %a находится в expansion, то каждая %a заменяется на ник, или если ник недоступен, на UIN, контакта которому Вы последнему отослал сообщение, или пустая строка в противном случае.
    Это впервые появилось в climm 0.4.10. Авто-расширяемые алиасы в climm 0.5.0.4.

GROUP
Секция Group описывает группы контактов и можем быть повторена столько раз сколько требуется. Замечание: формат 2 сохраняется в файл BASE/status, но в BASE/climmrc. Могут быть следующий команды:

server <тип> <uin>
    Определяет соединение с сервером для контактной группы принадлежащей к одному из типов тип, которые в текущей версии могут быть icqv8 для ICQ серверов соединений версии 8 или icqv5 для ICQ серверов соединений версии 5, для UIN uin. Если эта команда отсутствует, то берется первое активное серверное соединение.

label <метка>
    Установка метки на эту группу контактов в метка. Если это contacts-<type>-<uin>, тогда это контакт лист для этого серверного соединения. Замечание: для формата 2 файла BASE/status, это устаревшее значение, так как контакты распределены по серверным соединениям соответственно с настройками в их секции Contacts.

id <id>
    Установка id контактной группы в id. 0 обозначает что id не определен. Это будет установлено при обновлении контакт листа с сервера или на сервер.

options <options>...
    Определяет опции для этой группы контактов. Смотри opt для детальной информации.

entry <id> <uin>
    Добавляет контакт с UIN uin как id id в группу контактов. Замечание: учтите что id устарело начиная с climm 0.5 и всегда установлено в 0. Вместо этого id устанавливается в секции Contacts .

CONTACTS (устаревший формат)
Этот раздел содержит контакт-лист. Этот формат считается устаревшим.

[*][~][^] uin ник
    Пользователь с UIN'ом uin будет отображаться ником ник. Если * задано, пользователь может видеть вас когда вы невидимы. Если ~ задано, то вы будете для него всегда offline. Если ^ задано, то игнорировать этого пользователя. Если uin повторяется несколько раз, то все, кроме первого, считаются иначе называемыми.

CONTACTS
Секция Contacts содержит контакты для одного соединения с сервером. Она повторяется для каждого соединения с сервером Замечание: это записывается в файл BASE/status, не в BASE/climmrc. Могут быть следующий команды:

server <type> <uin>
    Определяет контакта лист для соединения с сервером, с тем же синтаксисом что и в секции Group .

entry <id> <uin> <nick>...
    Добавляет пользователя с uin и id в этот контакт лист, с ником и возможными множественными алиасам nick.

options <options>...
    Определяет опцию для предыдущего контакта. Смотри команду opt для детальной информации.

СМОТРИТЕ ТАКЖЕ
climm(1), climmcmds(7)

Автор
Эта страница была написана James Morrison <ja2morrison@student.math.uwaterloo.ca>. И была переписана для нового синтаксиса файла конфигураций Rüdiger Kuhlmann <climm@ruediger-kuhlmann.de>. Это руководство было переведено "Pest" <pezt@mail.ru>. Дополнено Maxim Komar <komar@ukr.net>.