doc (installation): updated instructions for backend
This commit is contained in:
parent
47ec15cc46
commit
f85cdc7f37
1 changed files with 9 additions and 61 deletions
|
|
@ -9,10 +9,7 @@ Note that if you are using GNU/Linux, Salut à Toi may already be present on you
|
|||
|
||||
Salut à Toi is made of one backend, and several frontends. To use it, the first thing to do is to install the backend.
|
||||
|
||||
We recommand to use development version for now, until the release of
|
||||
0.7 version which will be "general public" version.
|
||||
|
||||
Also note that SàT is still using Python 2 (this will change for 0.8 version which will be Python 3 only), so all instructions below have to be made using python 2.
|
||||
We recommand to use development version for now, until the release of 0.8.
|
||||
|
||||
Development version
|
||||
-------------------
|
||||
|
|
@ -23,9 +20,8 @@ AUR, check sat-xmpp-hg (as well as other sat-\* packages).*
|
|||
You can install the latest development version using pip. You need to
|
||||
have the following dependencies installed first:
|
||||
|
||||
- Python 2 with development headers
|
||||
- Python 3 with development headers
|
||||
- Mercurial
|
||||
- VirtualEnv
|
||||
- libcairo 2 with development headers
|
||||
- libjpeg with development headers
|
||||
- libgirepository 1.0 with development headers
|
||||
|
|
@ -45,12 +41,12 @@ instance your home directory::
|
|||
|
||||
$ cd
|
||||
|
||||
And enter the following commands (note that *virtualenv2* may be named
|
||||
*virtualenv* on some distributions, just be sure it's Python **2** version)::
|
||||
And enter the following commands (here we install SàT with SVG support, which is needed to
|
||||
display SVG avatars on some frontends)::
|
||||
|
||||
$ virtualenv2 env
|
||||
$ source env/bin/activate
|
||||
$ pip install hg+https://repos.goffi.org/sat
|
||||
$ python3 -m venv sat
|
||||
$ source sat/bin/activate
|
||||
$ pip install hg+https://repos.goffi.org/sat_tmp hg+https://repos.goffi.org/sat#egg=sat[SVG]
|
||||
|
||||
Don't worry if you see the following message, SàT should work anyway::
|
||||
|
||||
|
|
@ -70,55 +66,7 @@ then, create the file ~/.config/sat/sat.conf containing:
|
|||
|
||||
Of course, replace ``~/sat_media`` with the actual path you have used.
|
||||
|
||||
.. following part is currently hidden until v0.7 is released
|
||||
|
||||
Last release
|
||||
------------
|
||||
|
||||
This release is really old and code has changed a lot since it.
|
||||
Furthermore, stable version is currently not maintained. We recommend to use current dev version until version 0.7 is released.
|
||||
|
||||
If you are willing to install last release anyway, here are the instructions.
|
||||
|
||||
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),
|
||||
`PyGObject <http://ftp.gnome.org/pub/GNOME/sources/pygobject/>`__ and
|
||||
developments version of libxml2 and libxslt (to compile lxml python
|
||||
library). On some ARM systems like Raspberry Pi or OLinuXino, it is also
|
||||
required to install libjpeg-dev and libffi-dev beforehand.
|
||||
|
||||
The environment variable SAT_INSTALL customises the installation, it
|
||||
contains flags separated by spaces:
|
||||
|
||||
- "nopreinstall" skip all preinstallation checks
|
||||
- "autodeb" automatically install missing packages on Debian based
|
||||
distributions
|
||||
|
||||
PyGobject is automatically installed on Debian based distributions if
|
||||
"autodeb" option is set. Indeed, on Debian based distribution, you can
|
||||
type:
|
||||
|
||||
| ``sudo apt-get install python-pip python-virtualenv python-dev libxml2-dev libxslt-dev libjpeg-dev libffi-dev zlib1g-dev``
|
||||
| ``virtualenv --system-site-packages sat``
|
||||
| ``source sat/bin/activate``
|
||||
| ``pip2 install -U setuptools``
|
||||
| ``SAT_INSTALL="autodeb" pip2 install sat``
|
||||
|
||||
After installing SàT, you need to install the media:
|
||||
|
||||
| ``mkdir -p /path/to/sat_media``
|
||||
| ``cd /path/to/sat_media``
|
||||
| ``wget ``\ ```ftp://ftp.goffi.org/sat_media/sat_media.tar.bz2`` <ftp://ftp.goffi.org/sat_media/sat_media.tar.bz2>`__
|
||||
| ``tar -jxvf sat_media.tar.bz2``
|
||||
|
||||
then, create a ~/.sat.conf file which contains:
|
||||
|
||||
| ``[DEFAULT]``
|
||||
| ``media_dir=/path/to/sat_media``
|
||||
|
||||
Of course, replace /path/to/sat_media with the actual path you want to
|
||||
use.
|
||||
You can check :ref:`configuration` for details
|
||||
|
||||
Usage
|
||||
=====
|
||||
|
|
@ -144,7 +92,7 @@ To know if backend is launched or not::
|
|||
You can check that SàT is installed correctly by trying jp (the backend need to be launched first, check below)::
|
||||
|
||||
$ jp --version
|
||||
jp 0.7.0D « La Commune » (rev 2dd53ffa4781 (default 2019-02-22 18:58 +0100) +110) Copyright (C) 2009-2019 Jérôme Poisson, Adrien Cossa
|
||||
jp 0.8.0D « La Cecília » (rev df26f1a9020a [M] (default 2020-04-14 21:01 +0200) +231) Copyright (C) 2009-2020 Jérôme Poisson, Adrien Cossa
|
||||
This program comes with ABSOLUTELY NO WARRANTY;
|
||||
This is free software, and you are welcome to redistribute it under certain conditions.
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue