annotate INSTALL @ 471:6cd04adddaea

core: exceptions moved to core plugin group blog: group blog now manage public microblogs
author Goffi <goffi@goffi.org>
date Wed, 04 Apr 2012 00:06:44 +0200
parents 094050fe461e
children 8022cca26595
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
238
83d2bc0abf2a version, README, CHANGELOG and INSTALL updates
Goffi <goffi@goffi.org>
parents: 212
diff changeset
1 ***
83d2bc0abf2a version, README, CHANGELOG and INSTALL updates
Goffi <goffi@goffi.org>
parents: 212
diff changeset
2 Below are the old manual instructions for installation, you can install SàT automatically using easy_install or pip. The full instructions are available on the wiki: http://wiki.goffi.org/wiki/Salut_%C3%A0_Toi
83d2bc0abf2a version, README, CHANGELOG and INSTALL updates
Goffi <goffi@goffi.org>
parents: 212
diff changeset
3 ***
83d2bc0abf2a version, README, CHANGELOG and INSTALL updates
Goffi <goffi@goffi.org>
parents: 212
diff changeset
4
83d2bc0abf2a version, README, CHANGELOG and INSTALL updates
Goffi <goffi@goffi.org>
parents: 212
diff changeset
5
24
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
6 The following instructions are for GNU/Linux operating system. Instruction for other OS will come in the future.
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
7
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
8 /!\ WARNING /!\
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
9 SàT is at a very early developpement stage, and is not intended for end user yet. You need to understand a minimum what you do to install it. Anyway, you can contact me if you need help (but I'm really busy, so don't expect a quick and accurate answer).
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
10
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
11 ** DEPENDENCIES:
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
12
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
13 To use SàT, you will need to install:
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
14 - twisted (http://twistedmatrix.com/trac/) which is found in most distributions, at least core, web and words must be installed
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
15 - progressbar (http://pypi.python.org/pypi/progressbar/2.2) which can be installed with easy_install
188
22cbd3837233 updated INSTALL instruction (wokkel MUC branch merge)
Goffi <goffi@goffi.org>
parents: 24
diff changeset
16 - wokkel (http://wokkel.ik.nu/). /!\ the MUC branch (http://hg.ik.nu/ralphm/wokkel-muc-client-support-24-2) must be merged, please read instructions below
212
800db401585e fixed INSTALL instructions
Goffi <goffi@goffi.org>
parents: 210
diff changeset
17 - wxWidgets (http://www.wxwidgets.org) which is found in most distributions. The more recent the version is, the better.
800db401585e fixed INSTALL instructions
Goffi <goffi@goffi.org>
parents: 210
diff changeset
18 - urwid (http://excess.org/urwid/) which can be installed with easy_install
800db401585e fixed INSTALL instructions
Goffi <goffi@goffi.org>
parents: 210
diff changeset
19 - BeautifulSoup (http://www.crummy.com/software/BeautifulSoup/) which can be installed with easy_install
458
094050fe461e core: fixed Params class name in load_default_params
Goffi <goffi@goffi.org>
parents: 238
diff changeset
20 - Mutagen (http://code.google.com/p/mutagen/) which can be installed with easy_install
24
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
21
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
22 ** PATHS:
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
23
210
9face609f83c misc minor typos fixes, dev version
Goffi <goffi@goffi.org>
parents: 188
diff changeset
24 You must have the main dir (with sat inside) and frontend in your PYTHONPATH. For example, if you have uncompressed the soft in /tmp/useless_soft:
24
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
25
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
26 > export PYTHONPATH=$PYTHONPATH:/tmp/useless_soft:/tmp/useless_soft/frontends
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
27
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
28 if you want to access jp, it can be a good idea to export its dir to your PATH variable:
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
29
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
30 > export PATH=$PATH:/tmp/useless_soft/frontends/jp
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
31
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
32
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
33 ** INSTRUCTIONS:
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
34
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
35 Here are the instructions for the distribution I use (Kubuntu Karmic Koala), but instructions for other Gnu/Linux distributions must be really close.
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
36 To install SàT on a *buntu distribution, you first need to install dependencies:
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
37
212
800db401585e fixed INSTALL instructions
Goffi <goffi@goffi.org>
parents: 210
diff changeset
38 > sudo aptitude install python-twisted python-twisted-core python-twisted-web python-twisted-words python-wxgtk2.8
24
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
39
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
40 You maybe need an updated repository for wxPython, take a look at http://wiki.wxpython.org/InstallingOnUbuntuOrDebian for more informations.
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
41
212
800db401585e fixed INSTALL instructions
Goffi <goffi@goffi.org>
parents: 210
diff changeset
42 ProgressBar and BeautifulSoup and Urwid can be installed with easy_install, or throught apt:
800db401585e fixed INSTALL instructions
Goffi <goffi@goffi.org>
parents: 210
diff changeset
43 > sudo aptitude install python-progressbar python-beautifulsoup python-urwid
24
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
44
188
22cbd3837233 updated INSTALL instruction (wokkel MUC branch merge)
Goffi <goffi@goffi.org>
parents: 24
diff changeset
45 Wokkel is a bit more complicated to install as we need to merge two branches:
24
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
46
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
47 First be sure that mercurial is installed
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
48 > sudo aptitude install mercurial
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
49
188
22cbd3837233 updated INSTALL instruction (wokkel MUC branch merge)
Goffi <goffi@goffi.org>
parents: 24
diff changeset
50 then we go to a directory where we can clone the repositories and merge. If you don't want to code on wokkel, you can do it in /tmp:
24
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
51
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
52 > cd /tmp
188
22cbd3837233 updated INSTALL instruction (wokkel MUC branch merge)
Goffi <goffi@goffi.org>
parents: 24
diff changeset
53 > hg clone http://hg.ik.nu/wokkel wokkel
24
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
54
188
22cbd3837233 updated INSTALL instruction (wokkel MUC branch merge)
Goffi <goffi@goffi.org>
parents: 24
diff changeset
55 now we pull the other branch:
22cbd3837233 updated INSTALL instruction (wokkel MUC branch merge)
Goffi <goffi@goffi.org>
parents: 24
diff changeset
56 > cd wokkel
22cbd3837233 updated INSTALL instruction (wokkel MUC branch merge)
Goffi <goffi@goffi.org>
parents: 24
diff changeset
57 > hg pull -f http://hg.ik.nu/ralphm/wokkel-muc-client-support-24-2
24
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
58
188
22cbd3837233 updated INSTALL instruction (wokkel MUC branch merge)
Goffi <goffi@goffi.org>
parents: 24
diff changeset
59 time to merge and commit:
22cbd3837233 updated INSTALL instruction (wokkel MUC branch merge)
Goffi <goffi@goffi.org>
parents: 24
diff changeset
60 > hg merge wokkel-muc-client-support-24
22cbd3837233 updated INSTALL instruction (wokkel MUC branch merge)
Goffi <goffi@goffi.org>
parents: 24
diff changeset
61 > hg commit -m "Merged wokkel's MUC branch"
24
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
62
188
22cbd3837233 updated INSTALL instruction (wokkel MUC branch merge)
Goffi <goffi@goffi.org>
parents: 24
diff changeset
63 finally,we can install:
24
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
64
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
65 > sudo python setup.py install
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
66
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
67 Everything is fine ? Ok let's add the paths.
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
68
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
69 If you use bash, you need probably to do something like
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
70 > echo "export PYTHONPATH=$PYTHONPATH:~/sat:~/sat/frontends" >> ~/.bashrc
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
71 > echo "export PATH=$PATH:~/sat/frontends/jp" >> ~/.bashrc
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
72
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
73 of course, replace ~/sat with the path where you installed SàT, and if you use zsh, replace .bashrc by .zshrc.
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
74 Restart a console or export manually the PATH.
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
75
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
76 Now everything should be OK, you can launch SàT. You have to launch the daemon first:
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
77 > cd ~/sat
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
78 > ./sat
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
79
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
80 You should be able to close you console or even X Window if you want.
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
81
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
82 Then launch one (ore more) frontend. For exemple, to use Wix:
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
83 > cd ~/sat/frontends/wix
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
84 > ./wix
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
85
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
86 enjoy =)
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
87 And don't hesitate to give feedback.
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
diff changeset
88