55 lines
1.6 KiB
Markdown
55 lines
1.6 KiB
Markdown
Lita::Adapters::Tox
|
|
===================
|
|
|
|
[](http://badge.fury.io/rb/lita-tox)
|
|
[](https://travis-ci.org/braiden-vasco/lita-tox)
|
|
[](https://coveralls.io/github/braiden-vasco/lita-tox)
|
|
|
|
[Tox](https://tox.chat) adapter for the [Lita](http://lita.io) chat bot.
|
|
|
|
|
|
Usage
|
|
-----
|
|
|
|
At first, see the documentation for Lita: http://docs.lita.io/
|
|
|
|
### Installation
|
|
|
|
**libtoxcore** should be compiled manually at your computer or server.
|
|
Follow the instructions in
|
|
[that file](https://github.com/irungentoo/toxcore/blob/2ab3b14731061cc04d3ccc50a35093c11d018298/INSTALL.md)
|
|
|
|
When **libtoxcore** is installed, add **lita-tox**
|
|
to your Lita instance's Gemfile:
|
|
|
|
```ruby
|
|
gem 'lita-tox', '~> 0.3.0'
|
|
```
|
|
|
|
### Configuration
|
|
|
|
`config.robot.name` will be used as Tox user name
|
|
|
|
Mentions in Tox usually use user name, Tox clients usually allow mentioning
|
|
by writing first letters of user name and pressing `<Tab>`, so don't use
|
|
`config.robot.mention_name`
|
|
|
|
#### Optional attributes
|
|
|
|
- `savedata_filename` (String) - Path to file where Tox state will be stored (if provided)
|
|
- `status` (String) - Tox user status
|
|
|
|
#### Example
|
|
|
|
This is an example `lita_config.rb` file:
|
|
|
|
```ruby
|
|
Lita.configure do |config|
|
|
config.robot.name = 'Lita chat bot'
|
|
|
|
config.robot.adapter = :tox
|
|
|
|
config.adapters.tox.savedata_filename = 'savedata'
|
|
config.adapters.tox.status = "Send me \"#{config.robot.name}: help\""
|
|
end
|
|
```
|