changeset 3260:e9ecd133773b

doc (installation): updated instructions for backend
author Goffi <goffi@goffi.org>
date Sun, 19 Apr 2020 16:54:13 +0200
parents f300d78f08f3
children a9e8e925ad99
files doc/installation.rst
diffstat 1 files changed, 9 insertions(+), 61 deletions(-) [+]
line wrap: on
line diff
--- 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 <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 @@
 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.