Mercurial > libervia-backend
annotate INSTALL @ 1369:dd1a148bd3d8
plugin text commands: docstring parsing for commands, and better /help command:
- docstring are parsed according to http://wiki.goffi.org/wiki/Coding_style/en#Text_commands, a data dictionary is filled accordingly
- /help command can now show detailed help for a specific command
| author | Goffi <goffi@goffi.org> |
|---|---|
| date | Thu, 19 Mar 2015 14:02:37 +0100 |
| parents | 0db0013c59dd |
| children | e2e75c3c7c7b |
| rev | line source |
|---|---|
| 885 | 1 You can install SàT automatically using easy_install or pip, and it is available in several GNU/Linux distributions. The full instructions are available on the wiki: http://wiki.goffi.org/wiki/Salut_%C3%A0_Toi |
| 1202 | 2 Below is are installation instructions, but please check the wiki which may be more up-to-date. |
| 885 | 3 |
|
587
952322b1d490
Remove trailing whitespaces.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
548
diff
changeset
|
4 *** |
| 885 | 5 |
| 1202 | 6 You can automatically install SàT and its dependencies using easy_install or pip. You will however need to install Python's headers (needed to build some packages), WxPython which is available in most Gnu/Linux distributions, PyGObject and developments version of libxml2 and libxslt (to compile lxml python library). |
| 885 | 7 |
| 1202 | 8 NOTE: pyfeed and xe are mandatory dependencies, they should be on http://pypi.python.org (PYthon Package Index, the official repository for Python projects) and so being automatically installed; but they are not yet there (their author should do it soon), so you have to install them manually until then. |
|
1203
6e08ee45bf0a
misc: updated urls of pyxe an pyfeed
Matteo Cypriani <mcy@lm7.fr>
parents:
1202
diff
changeset
|
9 You can download them respectively on http://home.avvanta.com/%7Esteveha/pyfeed-0.7.4.tar.gz and http://home.avvanta.com/%7Esteveha/xe-0.7.4.tar.gz, then decompress them and do « python setup.py install » on both. |
| 1202 | 10 An other way is to use the (insecure) pip options --process-dependency-links and --allow-all-external when installing sat, options which will soon be (or already are) removed from pip. |
| 1191 | 11 |
| 12 | |
| 1202 | 13 The environment variable SAT_INSTALL customises the installation, it contains flags separated by spaces: |
| 14 - "nopreinstall" skips all preinstallation checks | |
| 15 - "autodeb" automatically installs missing packages on Debian-based distributions | |
| 16 - "nox" disables installation of X-based packages (WxWidgets), this is useful for servers | |
| 885 | 17 |
| 1202 | 18 WxPython and PyGobject are automatically installed on Debian-based distributions if "autodeb" option is set. Indeed, on Debian-based distribution, you can type (with the root account): |
| 885 | 19 |
| 20 # apt-get install python-pip python-dev libxml2-dev libxslt-dev | |
| 21 # SAT_INSTALL=autodeb pip install . | |
| 22 | |
| 23 On a *buntu, same commands with sudo: | |
| 24 | |
| 25 $ sudo apt-get install python-pip python-dev libxml2-dev libxslt-dev | |
|
1100
2be46f391cfa
setup: SAT_INSTALL environment variable handles "clean" and "purge" options
souliane <souliane@mailoo.org>
parents:
885
diff
changeset
|
26 $ sudo SAT_INSTALL=autodeb pip install . |
| 885 | 27 |
| 28 | |
| 29 After installing SàT, you need to install the media: | |
| 30 | |
| 31 $ mkdir -p ~/sat/media/destination/path | |
| 32 $ cd ~/sat/media/destination/path | |
| 33 wget ftp://ftp.goffi.org/sat_media/sat_media.tar.bz2 | |
| 34 tar -jxvf sat_media.tar.bz2 | |
| 35 | |
| 36 then, create a ~/.sat.conf file which contains: | |
| 37 | |
| 38 ### sat.conf ### | |
| 39 [DEFAULT] | |
| 40 media_dir=~/sat/media/destination/path | |
| 41 ### end sat.conf ### | |
| 42 | |
| 43 Of course, replace ~/sat/media/destination/path with the actual path you want to use. | |
| 44 | |
| 45 You should now be able to launch sat: | |
| 46 - to launch the backend, enter | |
| 47 $ sat | |
| 48 - to stop the backend, enter: | |
| 49 $ sat stop | |
| 50 - to launch Primitivus, enter: | |
| 51 $ primitivus | |
| 52 then create a profile. | |
| 53 - to use jp, follow its help: | |
| 54 $ jp --help | |
| 55 | |
| 56 For Libervia, the web interface, check http://wiki.goffi.org/wiki/Libervia/en | |
| 57 | |
| 58 If you need help, come the SàT official XMPP room: sat@chat.jabberfr.org |