Difference between revisions of "Service/meeting"

Latest revision as of 00:30, 3 June 2012

Hostnames

meeting.sugarlabs.org
meeting.treehouse.su

Hosted on

Machine/jita

Administrative contact

meeting AT sugarlabs DOT org

Sysadmins

Notes

IRC bot with plugins and perl CGI access to IRC logs in local MySQL db using modified ilbot webui.

IRC bot

This new bot replaces the older Mootbot with Supybot.

Home	`/srv/supybot`
Daemon	`/etc/init.d/supybot`
Logs	`/srv/supybot/log`
Config	`/srv/supybot/bot.conf` `/etc/logrotate.d/supybot`

Everything, except owner related configuration, should happen via IRC interface with using flush command to save changes immediately.

Supybot plugins:

MeetBot in /srv/supybot/plugins/MeetBot
Handle meetings.
MyLogger in /srv/supybot/plugins/MyLogger
Keep IRC logs in MySQL database.
Lingvo in /srv/supybot/plugins/Lingvo
Online translation on IRC.

Web logs

Home	`/srv/ilbot`
Config	`/etc/httpd/conf.d/meeting.sugarlabs.org.conf` `/etc/httpd/conf.d/meeting.treehouse.su.conf` `/srv/ilbot/cgi/database.conf`

Upgrade notes

yum	`supybot`
git	`/srv/supybot/plugins/MeetBot` `/srv/supybot/plugins/MyLogger` `/srv/supybot/plugins/Lingvo` `/srv/ilbot`

After pulling new ilbot changes from Git repository, clean up disk cache:

rm -rf /tmp/FileCache/irclog

Sources

Repositories:

supybot-lingvo plugin.
supybot-mylogger plugin.

Downstream repositories:

ilbot.
MeetBot.

Upstream repositories:

ilbot.
MeetBot.

Usage

Bot is named meeting. It supports many useful features, read the Supybook to learn them.

Join the bot

To join the bot to your IRC channel, email your request.

Logging

The bot supports keeping logs for further browsing on meeting.sugarlabs.org. This feature is disabled by default, to enable it, email your request.

Handling meetings

The bot has MeetBot plugin to handle meeting on channels it joined to. Read MeetBot tutorial to learn how to handle meetings.

Meeting logs are stored on meeting.sugarlabs.org (even if logging is disabled). Go to channel page and click Meetings link (rightmost switch in toolbar).

Multi-lingual relaying

Translation is provided by Apertium project. If it is not good, please consider possibility to improve it.

Translation is not good in all cases.
Be patent, keep special words untranslated and avoid short phrases while chatting with people on translation channels.

The bot supports language translation relaying. It is plugin implementation of transbot.

It is about implicit translation for particular IRC channel into several languages. People being in satellite channels, like #sugar-ru, can type posts in Russian, all theses posts will be translated into English and posted to #sugar. The same works in opposite direction.

The easiest way to try it is web client. On login screen, choose one of sugar channels and the language you want to type posts in. Language might be Default that means that you need to type in default language for IRC channel from the list. After being logged in, you can all time open new Sugar channel using combo boxes on the leftmost side of upper toolbar.

IRC command interface

Translation process might be managed from IRC commands sent to meeting nick.

List channels that can be translated (primal channels) with current translation status:

meeting: lingvo list [channel]

List supported languages:

meeting: lingvo langs

Open new translation channel:

meeting: lingvo join [primal-channel] lang

By default, empty translation channels will be closed in 3 days. To prevent it:

meeting: lingvo pin [translation-channel]
meeting: lingvo unpin [translation-channel]

List all nicks that take part in conversation, i.e., nicks from the primal channel and nicks from all translation channels:

meeting: lingvo nicks [channel]

If command output is too big, use more command to get the rest of output:

meeting: more

Keep special phrases untranslated

While keeping phrases untranslated, the system tries to be as obvious as possible.

To not process translation where it doesn't make sense, warp the text into the double quotes. To pass entirely post untranslated, start it from the double quotes (there is no need in ending the post by second double quote).

Other cases where text won't be translated:

channel names (words started from # symbol),
nick names.

@@ Line 1: / Line 1: @@
-{{TOCright}}
+<noinclude>
+[[Category:Service|IRC]]
+</noinclude>
 == Hostnames ==
-''In progress''
+* meeting.sugarlabs.org
+* meeting.treehouse.su
 == Hosted on ==
-[[Machine/treehouse|Treehouse]]
+[[Machine/jita]]
 == Administrative contact ==
-* [[User:alsroot|Aleksey Lim]]
+* meeting AT sugarlabs DOT org
 == Sysadmins ==
 * [[User:alsroot|Aleksey Lim]]
+* [[User:dogi|Stefan Unterhauser]]
 == Notes ==
-[http://sourceforge.net/projects/supybot/ IRC] bot with plugins and static HTTP access to IRC logs.
+[http://sourceforge.net/projects/supybot/ IRC] bot with plugins and perl CGI access to IRC logs in local MySQL db using [http://git.sugarlabs.org/projects/ilbot modified] ilbot webui.
+=== IRC bot ===
+This new bot replaces the older [http://wiki.laptop.org/go/User:Dogi/meeting Mootbot] with Supybot.
+{| class="wikitable"
+|-
+!scope="row" | Home
+|{{Code|/srv/supybot}}
+|-
+!scope="row" | Daemon
+|{{Code|/etc/init.d/supybot}}
+|-
+!scope="row" | Logs
+|{{Code|/srv/supybot/log}}
+|-
+!scope="row" | Config
+|{{Code|/srv/supybot/bot.conf}}
+{{Code|/etc/logrotate.d/supybot}}
+|-
+|}
+Everything, except owner related configuration, should happen via [http://supybook.fealdia.org/devel/#_administrative_tasks IRC interface] with using {{Code|flush}} command to save changes immediately.
+Supybot plugins:
+* [http://git.sugarlabs.org/sl-tweaks/meetbot MeetBot] in {{Code|/srv/supybot/plugins/MeetBot}}<br>Handle meetings.
+* [http://git.sugarlabs.org/sl-tweaks/supybot-mylogger MyLogger] in {{Code|/srv/supybot/plugins/MyLogger}}<br>Keep IRC logs in MySQL database.
+* [http://git.sugarlabs.org/sl-tweaks/supybot-lingvo Lingvo] in {{Code|/srv/supybot/plugins/Lingvo}}<br>Online translation on IRC.
+=== Web logs ===
+{| class="wikitable"
+|-
+!scope="row" | Home
+|{{Code|/srv/ilbot}}
+|-
+!scope="row" | Config
+|
+{{Code|/etc/httpd/conf.d/meeting.sugarlabs.org.conf}}<br>
+{{Code|/etc/httpd/conf.d/meeting.treehouse.su.conf}}<br>
+{{Code|/srv/ilbot/cgi/database.conf}}
+|-
+|}
 == Upgrade notes ==
-No need in manual configuration, all happens via Puppet.
+{| class="wikitable"
+|-
+!scope="row" | yum
+|{{Code|supybot}}
+|-
+!scope="row" | git
+|
+{{Code|/srv/supybot/plugins/MeetBot}}<br>
+{{Code|/srv/supybot/plugins/MyLogger}}<br>
+{{Code|/srv/supybot/plugins/Lingvo}}<br>
+{{Code|/srv/ilbot}}
+|-
+|}
+After pulling new ilbot changes from Git repository, clean up disk cache:
+ rm -rf /tmp/FileCache/irclog
+== Sources ==
+Repositories:
+* [http://git.sugarlabs.org/sl-tweaks/supybot-lingvo supybot-lingvo] plugin.
+* [http://git.sugarlabs.org/sl-tweaks/supybot-mylogger supybot-mylogger] plugin.
+Downstream repositories:
+* [http://git.sugarlabs.org/sl-tweaks/ilbot ilbot].
+* [http://git.sugarlabs.org/sl-tweaks/meetbot MeetBot].
+Upstream repositories:
+* [http://github.com/moritz/ilbot/ ilbot].
+* [http://wiki.debian.org/MeetBot#Code MeetBot].
+== Usage ==
-All, except nick, directly related to bot parameters can be setup only on initialization stage. Later bot can be configured from [http://ubottu.com/stdin/supydocs/commands.html IRC] interface (preferable) or changing ''/srv/supybot/bin.conf''.
+{{:{{PAGENAME}}/Usage}}