summaryrefslogtreecommitdiff
path: root/REQUIREMENTS
blob: dddc940c53a844988010d32040e779d166034c21 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
Ruby modules needed for rbot
============================

Core requirements
      tokyocabinet          for "tc" DB adaptor
                            http://1978th.net/tokyocabinet/
                            you can install Ruby bindings via "gem install tokyocabinet",
                            but this still requires libtokyocabinet to be installed system-wide
      bdb (berkeley db)      for "bdb" DB adaptor or converting from it
                            http://raa.ruby-lang.org/project/bdb/
                            (which requires libdb4.x or better, formerly from
                            www.sleepycat.com, now at
                            http://www.oracle.com/technology/products/berkeley-db/index.html)
                            Most of the time you don't need to compile anything.
                            If you're running Linux, your distribution should
                            have a libdb-ruby packaged (or similar).
                            For Windows instructions, check at the bottom
                            of this file.

      net/http 1.2+
      net/https             (for debian, this will also need libopenssl-ruby)
      socket
      uri

Useful but fallback provided
      ruby-gettext 1.8.0+   http://www.yotabanana.com/hiki/ruby-gettext.html?ruby-gettext
                            optional; if installed rbot can use localized messages
      htmlentities          http://htmlentities.rubyforge.org/
                            optional; if installed rbot will use it to decode
                            HTML entities; if missing, an internal table with
                            the most common HTML entities will be used instead
      hpricot               http://code.whytheluckystiff.net/hpricot/
                            optional, if installed rbot will used it to find
                            the first paragraph in HTML files; if missing,
                            regular expressions will be used instead


Plugin requirements
(these are all optional, if you don't have them, the plugins just won't
function)

bash, digg, slashdot, freshmeat, forecast:
      REXML
rss:
      rss
shortenurls:
      shorturl
time:
      tzinfo
translator:
      mechanize

External programs needed for rbot
=================================

Plugin requirements
(These are all optional)

cal plugin:
      cal(1)

figlet plugin:
      figlet(6)

fortune plugin:
      fortune(6)

host plugin:
      host(1)

spell plugin:
      ispell(1)


Running rbot on win32
=====================

You can install Ruby using the One-Click Ruby installer, available from
http://rubyinstaller.rubyforge.org/

You can find a precompiled version of the bdb package for ruby here
http://ftp.ruby-lang.org/pub/ruby/binaries/mingw/1.8/ext/bdb-0.5.1-i386-mingw32-1.8.tar.gz

When you unpack the archive (e.g. using WinZip or 7-Zip or any other tool
of your choice) you'll notice that it contains the following directory structure:
  usr
   +---local
         +---doc
         +---lib
and you have to move the doc and lib folders (and all their contents) in the folder
where you installed Ruby (typically C:\Ruby\)


Further instructions
====================

For further instructions, check http://ruby-rbot.org/rbot-trac/wiki/InstallGuide