pages/bot: write a long story...

This commit is contained in:
Aminda Suomalainen 2015-06-19 10:45:23 +03:00
parent 6672bb7974
commit b4a5667e98

View File

@ -10,32 +10,90 @@ excerpt: "A little about my IRC bot. Useful links, why it doesn't reply to me, h
* [Web interface](https://bot.mikaela.info)
* [Plugin documentation](https://bot.mikaela.info/plugindoc/)
The bot doesn't allow people to register by themselves and it might be
configured to A) only reply to identified users B) not reply on certain
channel to anyone C) reply only to owner at certain channel. This may
change without notice.
## Limnoria
Currently only ops on the channels it's on are registered and should be
identified by their nickserv account.
My bot is [Limnoria] which is currently the most popular [Supybot] fork
that is still under active development and it has merged in features of
another popular fork, [Gribble].
My role with [Limnoria] was Finnish translator and IRC support and I also
made minor changes to make some default configuration variables more sane.
Most of documentation since [Supybot] and before my leaving are also
written by me.
* [Blog: Leaving Limnoria]({% post_url 2015-03-25-leaving-bots-life %})
* [Blog: My background on Limnoria]({% post_url 2015-05-18-life-bot-background %})
[Supybot]:https://github.com/Supybot/Supybot
[Limnoria]:https://github.com/ProgVal/Limnoria
[Gribble]:https://github.com/nanotube/supybot_fixes
## Usage
### Quick start
Use `list` command to get list of plugins, `list <plugin>` to get list of
commands in plugin, `help <plugin> <command>` to get usage instructions
for \<command\> in \<plugin\>.`
If the bot tells you `(X more messages)`, use the `more` command to see
more output.
There are also default plugins which means that when you use only
`<command>` the command is automatically understood as `<plugin> <command>`
for example `tell` is configured to be `later tell` which tells text
to nick next time it's seen. If `command` exists only in one plugin,
it's gets turned to `<plugin> <command>` automatically.
In case command exists in multiple plugins, the bot will tell you that
the command exists in multiple plugins and asks you to specify the plugin
before it.
## Users
The bot doesn't allow anyone to register and I will register channel ops
manually on the channels the bot is on. Users are primarily identified by
NickServ account, but on networks where there are no services it's required
to use hostmasks.
Requirements for getting account:
* being op on channel where the bot is on or similar good reason
* having NickServ account
* or on networks where there are no services hostmask that you can be
identified with
* static host
* identd
## Identifying
The bot requires users to have password, but I always set the password
as something from pwgen as I primarily identify users based on NickServ
account or hostmask.
* If you have a password, `/msg <bot> user identify username password`
* Passwords can be asked for me if needed, after getting one, change
it immediately with `/msg <bot> user set password OLDPASSWORD NEWPASSWORD`
* If you use NickServ account:
* Use the `auth` command.
* `/cycle` so extended-join sends your account name to the bot.
* `/kick <bot>` so the bot will automatically rejoin and send whox
requests to the channel receiving your NickServ account.
* [Other methods / Official documentation](https://limnoria-doc.readthedocs.org/en/latest/use/getting_started.html#making-supybot-recognize-you)
## Channels
List of the channels where the bot is on can be seen with /whois. However
this list doesn't include secret/private channels (mode +sp).
The bot can also be requested to join other channels, but I reserve the
right to not join it anywhere or to not register specific channel ops
to the bot. It doesn't have open registration.
Do you have an account, but you aren't identified? As you are ignored
unless you are identified, you can trigger message on the IRCd including
your NickServ account by using one of the following methods:
* `/cycle` so extended-join sends your account name to the bot.
* `/kick` so the bot will automatically rejoin and send whox requests to
the channel receiving your NickServ account.
to the bot.
## What does the bot do?
Currently the bot is primarily spamming my channel with new items in some
Currently the bot is primarily spamming my channels with new items in some
RSS feeds. You can find list of the feeds added to the bot at
[the web documentation for RSS plugin](https://bot.mikaela.info/plugindoc/RSS/),
but listing the feeds automatically announced on the channel isn't