# HG changeset patch # User Goffi # Date 1587308053 -7200 # Node ID e9ecd133773b772ac5502ba24002e8cecdec9881 # Parent f300d78f08f31d22087d03aecf4fdb99b1ff57a3 doc (installation): updated instructions for backend diff -r f300d78f08f3 -r e9ecd133773b doc/installation.rst --- a/doc/installation.rst Sun Apr 19 16:53:44 2020 +0200 +++ b/doc/installation.rst Sun Apr 19 16:54:13 2020 +0200 @@ -9,10 +9,7 @@ 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 @@ 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 @@ $ 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 @@ 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 `__ 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`` `__ - | ``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 @@ 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.