[Tkabber-dev] r223 - trunk/plugins/bldjid

tkabber-svn at jabber.ru tkabber-svn at jabber.ru
Sat May 9 05:04:19 MSD 2009


Author: bigote
Date: 2009-05-09 05:04:18 +0400 (Sat, 09 May 2009)
New Revision: 223

Added:
   trunk/plugins/bldjid/README.ru
Modified:
   trunk/plugins/bldjid/ChangeLog
   trunk/plugins/bldjid/README
Log:
README is translated into Russian. Also, some small changes
are made to original README file.


Modified: trunk/plugins/bldjid/ChangeLog
===================================================================
--- trunk/plugins/bldjid/ChangeLog	2009-04-30 02:36:21 UTC (rev 222)
+++ trunk/plugins/bldjid/ChangeLog	2009-05-09 01:04:18 UTC (rev 223)
@@ -1,3 +1,16 @@
+2009-05-09  Serge Yudin  <xmpp:bigote at jabber.ru> <mailto:bigote at gmail.com>
+
+--- Version 0.5.19 of the plugin.
+--- Files added:
+	README.ru
+
+--- Files modified:
+    README, ChangeLog.
+
+--- Changes:
+	README is translated into Russian. Also, some small changes
+	are made to original README file.
+
 2009-04-30  Serge Yudin  <xmpp:bigote at jabber.ru> <mailto:bigote at gmail.com>
 
 --- Version 0.5.19 of the plugin.

Modified: trunk/plugins/bldjid/README
===================================================================
--- trunk/plugins/bldjid/README	2009-04-30 02:36:21 UTC (rev 222)
+++ trunk/plugins/bldjid/README	2009-05-09 01:04:18 UTC (rev 223)
@@ -102,6 +102,9 @@
 	If you don't want rooms where you don't have admin privileges
 	to be listed by /visit* commands, turn on this option (default setting).
 	Bldjid still will gather logs for such rooms, it just won't display them.
+	This behaviour could be useful if you'd like to know some JIDs
+	in some non-anonymous room -- just turn this option off temporarily
+	and do a search in that room.
 
 --- ::plugins::bldjid::options(verbosity_level)
 -	Minimum level means that there will be no repeated JIDs in each room list.
@@ -154,11 +157,11 @@
 	for logging during several days in a highly populated room
 	with Minimum verbosity level enabled). If you plan logging with Maximum
 	verbosity level you might probably want to set a bigger value.
-	If you change this setting to a smaller value after some time of use,
+-	If you change this setting to a smaller value after some time of use,
 	logs which length is higher than a new value will be trimmed down
 	losing the oldest records (after a new user enters the affected room,
 	which triggers adding a new element to log).
-	Please note that any non-integer or negative value is considered as 0.
+-	Please note that any non-integer or negative value is considered as 0.
 
 ================
 ####  MISC  ####

Added: trunk/plugins/bldjid/README.ru
===================================================================
--- trunk/plugins/bldjid/README.ru	                        (rev 0)
+++ trunk/plugins/bldjid/README.ru	2009-05-09 01:04:18 UTC (rev 223)
@@ -0,0 +1,176 @@
+Этот плагин задумывался в помощь администраторам конференций.
+
+В первую очередь, его цель -- помочь вам банить нехороших людей
+во всех конференциях, где у вас есть соответствующие права,
+дабы не тратить на них своё драгоценное время.
+
+===================
+####  КОМАНДЫ  ####
+===================
+
+Использование:
+---	Показать краткую справку с примерами команд:
+/bldhelp
+
+---	Забанить JID в комнатах, где у вас есть админские права:
+/bldjid JID
+Причина бана (необязательна).
+
+---	Разбанить JID в таких комнатах:
+/unbldjid JID
+
+Добавлена команда, которой очень не хватало в Ткаббере:
+забанить пользователя в текущей комнате по его/её джиду,
+при этом пользователь может в комнате отсутствовать.
+
+---	Использование:
+/banjid JID
+Причина бана (необязательна).
+
+---	Если вы в хорошем настроении (например, у вас день рождения)
+	и вас тянет на добрые дела, вы можете устроить амнистию --
+	разбанить всех забаненных в какой-либо из своих комнат.
+	Для этого выполните в ней следующую команду:
+/amnesty
+и после подтверждения все забаненные в ней люди будут разбанены.
+Настоятельно советую не пользоваться этой командой в комнатах,
+где вы не хозяин, а только администратор.
+
+Добавлены новые команды, которые могут быть полезны,
+когда у вас выключена опция ::muc::options(gen_enter_exit_msgs).
+
+---	Показать всех посетителей данной комнаты
+/visitors
+
+---	Показать посетителей в комнатах, названия которых подходят к *room*
+/visitors room
+
+---	Показать визиты человека, чей ник или джид подходит к *nick*
+/visited nick
+
+---	Показать визиты, сделанные *nick*, в комнаты, которые подходят к *room*
+/visited nick
+room
+
+--- В результате выполнения этих команд в окне текущего чата выведется
+	нумерованный список. Из него можно выбрать кандидата на бан для команд,
+	описанных выше, таким образом:
+/banjid ?n?
+причина
+
+и
+
+/bldjid ?n?
+причина
+
+где ?n? -- это целое число от 0 до последнего элемента в списке.
+
+--- В плагине есть возможность перенаправлять вывод команд /visit* and /bldhelp
+	в специальное окно-монитор. Подробности в разделе "Настройки" ниже.
+
+--- Показывать/скрывать окно-монитор можно с помощью сочетания клавиш <Control-m>.
+
+--- Чтобы очистить текущее окно-монитор (лог посещений и даже результаты
+	последнего поиска не пропадут), воспользуйтесь командой:
+/clearmon
+
+--- Для всех этих команд работает автодополнение:
+	напишите первые несколько букв команды и понажимайте клавишу табуляции.
+-	Точно так же автодополнение работает для джидов, если вы дописываете их вручную
+	в качестве аргумента для команд /bldjid, /banjid, /unban, /unbldjid
+	после генерации списка посетителей с помощью любой из команд /visit*.
+-	Если после команды вы не вводите начало джида, то автодополнение начнёт
+	перебирать сначала ники и только потом джиды (если поиск дал результаты).
+	Так что если вы решили пользоваться автодополнением, введите по крайней мере
+	первые две-три буквы джида, чтобы не пришлось перебирать все ники
+	(правда, ники, начинающиеся с этих букв, тоже будут показаны).
+	В будущем я постараюсь исправить это поведение.
+-   Помните, что автодополнение джидов не будет работать, если вы ещё не создали
+	ни одного списка посетителей, то есть, не выполнили команду /visit* ни разу.
+
+=====================
+####  НАСТРОЙКИ  ####
+=====================
+
+Для плагина имеются настройки, которые можно найти тут:
+Tkabber -> Customize -> Plugins -> Bldjid
+
+--- ::plugins::bldjid::options(enable_jids_gathering)
+	Включает сбор джидов посетителей.
+
+--- ::plugins::bldjid::options(filter_admin_rooms)
+	Если вы не хотите, чтобы в результаты поиска командами /visit*
+	попадали комнаты, где у вас нет админских прав, включите эту опцию
+	(по умолчанию включено). Плагин всё равно будет собирать джиды или ники,
+	он просто не будет их показывать. Эта особенность может оказаться полезной,
+	если вы хотите узнать джиды посетителей неанонимных комнат --
+	временно выключите эту опцию и сделайте поиск в нужной комнате.
+
+--- ::plugins::bldjid::options(verbosity_level)
+-	Минимальный уровень "надоедливости" означает, что в лог будет попадать
+	лишь первое вхождение для каждого джида. Если точнее, то для каждой пары
+	ник/джид, потому что пользователь может зайти с того же джида, сменив ник,
+	или даже поменять ник, уже находясь в комнате.
+	К каждой записи о входе будет добавлен тайм-штамп (время захода),
+	чтобы было проще отслеживать историю заходов.
+-	Максимальный уровень означает, что будет отмечен каждый заход каждого посетителя.
+
+--- ::plugins::bldjid::options(matching_rules)
+	Правила совпадений при поиске.
+-	"Точное совпадение" обязывает вас вводить при поиске полный джид комнаты
+	(если хотите получить релевантные результаты).
+-	Поэтому по умолчанию поставлено "Нестрогое совпадение", что позволяет вам
+	вводить лишь название комнаты, а то и его часть.
+	То же самое относится и к никам.
+
+--- ::plugins::bldjid::options(custom_separator)
+	Разделитель полей для вывода команд /visit*. Значение по умолчанию -- "||".
+
+--- ::plugins::bldjid::options(redirect_output)
+	Перенаправление вывода. По умолчанию выключено.
+	Эта опция позволяет показывать вывод команд /visit* и /bldhelp
+	в специальном окне-мониторе, расположенном под окошком редактирования
+	текста сообщений текущего чата.
+	Его можно показывать/скрывать с помощью сочетания клавиш <Ctrl-m>.
+-	Закрывая этот монитор, вы не потеряете результаты поиска.
+	Вы можете банить и разбанивать посетителей с помощью автодополнения,
+	если помните их джиды, или же с помощью номеров в списке.
+	История результатов поиска никуда не девается, пока вы не очистите её
+	командой /clearmon. Помните, что для "бана по номеру" используется
+	_последний_ результат поиска, так что пользуйтесь им осторожнее,
+	чтобы не забанить невиновного :) Перед тем как банить, лучше вызовите
+	лишний раз команду /visit*, чтобы получить свежий список.
+-	Вы можете прокручивать окно монитора вверх и вниз с помощью сочетаний клавиш
+	Alt-Shift-PgUp и Alt-Shift-PgDown соответственно.
+-	Монитор нельзя показывать/скрывать, если редирект выключен.
+
+--- ::plugins::bldjid::options(send_chat_messages)
+	Отправка в чат "умных" сообщений. По умолчанию выключена.
+	Если её включить, кроме просто сбора джидов, в чат будут слаться сообщения
+	о входе посетителей. В отличие от стандартных, отсылаемых по опции
+	::muc::options(gen_enter_exit_msgs), эти шлются по одному на пару "ник/джид".
+	Естественно, что они будут слаться лишь при установленном
+	"Минимальном" уровне надоедливости.
+
+--- ::plugins::bldjid::options(log_length)
+	Устанавливает максимальный размер длины лога для каждой комнаты.
+	0 означает отсутствие ограничений.
+	Если вы хотите поставить верхний предел для лога, введите какое-нибудь значение
+	(1000 будет достаточно, чтобы вести лог в течение нескольких дней
+	в весьма оживлённой комнате и при установленном Минимальном уровне
+	надоедливости). Если вы хотите включить Максимальный уровень, возможно,
+	вам потребуется увеличить размер лога.
+-	Если через некоторое время использования вы решили уменьшить размер лога,
+	то, если новый размер окажется меньше существующего, старые записи потеряются
+	(после того, как в комнату войдёт новый посетитель, либо кто-нибудь сменит ник --
+	эти события служат триггером для смены размера).
+-	Учтите, что нецелые и отрицательные значения этой настройки трактуются как 0.
+
+==================
+####  РАЗНОЕ  ####
+==================
+
+Название плагина происходит от русского слова "блджад", записанного латиницей
+как "bldjad", в сочетании с "JID." См. http://lurkmore.ru/Блджад
+Также его можно толковать как акроним: "Ban Lousy Dorks (by) JID".
+Значительная часть кода плагина укра^W взята из плагина "Urlcmd" и модуля muc.tcl.



More information about the Tkabber-dev mailing list