Changes

Jump to navigation Jump to search
3,362 bytes added ,  19:55, 5 December 2011
Line 1: Line 1: −
[[http://wiki.sugarlabs.org/go/Service/IRC_bot Support]]
+
Bot is named ''meeting''. It supports many useful features, read the [http://supybook.fealdia.org/devel/ Supybook] to learn them.
 +
 
 +
=== Join the bot ===
 +
 
 +
To join the bot to your IRC channel, email your [[Service/meeting#Administrative_contact|request]].
 +
 
 +
=== Logging ===
 +
 
 +
The bot supports keeping logs for further browsing on [http://meeting.sugarlabs.org/ meeting.sugarlabs.org]. This feature is disabled by default, to enable it, email your [[Service/meeting#Administrative_contact|request]].
 +
 
 +
=== Handling meetings ===
 +
 
 +
The bot has MeetBot plugin to handle meeting on channels it joined to. Read MeetBot [http://meetbot.debian.net/Manual.html#tutorial tutorial] to learn how to handle meetings.
 +
 
 +
Meeting logs are stored on [http://meeting.sugarlabs.org/ 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 [http://apertium.org Apertium] project. If it is not good, please consider possibility to [http://wiki.apertium.org/wiki/Contributing_to_an_existing_pair improve] it.
 +
 
 +
{{Note/warning|Translation is not good in all cases.|Be patent, [[#Keep special phrases untranslated|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 [https://fedorahosted.org/transbot/wiki/testing 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 [[Service/chat/Usage|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 {{Code|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.

Navigation menu