Mercurial > libervia-backend
view INSTALL @ 72:f271fff3a713
MUC implementation: first draft
/!\ the experimental muc branche of wokkel must be used
- bridge: new roomJoined signal
- wix: contact list widget is now in a separate file, and manage different kinds of presentation
- wix: chat window now manage group chat (first draft, not working yet)
- wix: constants are now in a separate class, so then can be accessible from everywhere
- wix: new menu to join room (do nothing yet, except entering in a test room)
- new plugin for xep 0045 (MUC), use wokkel experimental MUC branch
- plugins: the profile is now given for get_handler, cause it can be used internally by a plugin (e.g.: xep-0045 plugin)
author | Goffi <goffi@goffi.org> |
---|---|
date | Sun, 21 Mar 2010 10:28:55 +1100 |
parents | 61124cb82fb7 |
children | 22cbd3837233 |
line wrap: on
line source
The following instructions are for GNU/Linux operating system. Instruction for other OS will come in the future. /!\ WARNING /!\ 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). ** DEPENDENCIES: To use SàT, you will need to install: - twisted (http://twistedmatrix.com/trac/) which is found in most distributions, at least core, web and words must be installed - progressbar (http://pypi.python.org/pypi/progressbar/2.2) which can be installed with easy_install - wokkel (http://wokkel.ik.nu/), please read instructions on website to download/install. You must apply the patch found at http://wokkel.ik.nu/ticket/56 - wxWidgets (www.wxwidgets.org) which is found in most distributions. The more recent the version is, the better. ** PATHS: You must have the main dir (with sat inside) and frontend in your PYTHONPATH. For exemple, if you have uncompressed the soft in /tmp/useless_soft: > export PYTHONPATH=$PYTHONPATH:/tmp/useless_soft:/tmp/useless_soft/frontends if you want to access jp, it can be a good idea to export its dir to your PATH variable: > export PATH=$PATH:/tmp/useless_soft/frontends/jp ** INSTRUCTIONS: Here are the instructions for the distribution I use (Kubuntu Karmic Koala), but instructions for other Gnu/Linux distributions must be really close. To install SàT on a *buntu distribution, you first need to install dependencies: > sudo aptitude install python-twisted python-twisted-core python-twisted-web python-twisted-word python-wxgtk2.8 You maybe need an updated repository for wxPython, take a look at http://wiki.wxpython.org/InstallingOnUbuntuOrDebian for more informations. progressbar can be installed with easy_install: > sudo easy_install progressbar Wokkel is a bit more complicated to install as we need to patch it: First be sure that mercurial is installed > sudo aptitude install mercurial then we go to a directory where we can clone the repository and patch the sources. If you don't want to code on wokkel, you can do it in /tmp: > cd /tmp > hg clone http://hg.ik.nu/wokkel now we need to download and use the patch: > cd wokkel/wokkel > wget http://wokkel.ik.nu/raw-attachment/ticket/56/patch > patch -p0 < patch now it's time to install: > cd .. > sudo python setup.py install Everything is fine ? Ok let's add the paths. If you use bash, you need probably to do something like > echo "export PYTHONPATH=$PYTHONPATH:~/sat:~/sat/frontends" >> ~/.bashrc > echo "export PATH=$PATH:~/sat/frontends/jp" >> ~/.bashrc of course, replace ~/sat with the path where you installed SàT, and if you use zsh, replace .bashrc by .zshrc. Restart a console or export manually the PATH. Now everything should be OK, you can launch SàT. You have to launch the daemon first: > cd ~/sat > ./sat You should be able to close you console or even X Window if you want. Then launch one (ore more) frontend. For exemple, to use Wix: > cd ~/sat/frontends/wix > ./wix enjoy =) And don't hesitate to give feedback.