Mercurial > libervia-backend
annotate INSTALL @ 2169:f472179305a1
tools(templates): workflow improvments:
- template theme can be specified in parenthesis: (some_theme)path/to/template.html. Withtout parenthesis, "default" is used
- static content are supposed to be in [theme]/static, error pages in [theme]/error/[err_code].html
- default page are used in some case (2 for now): if error page with specified code doesn't exists, a base page is used, and if a page doesn't exist for a theme, the same one for default theme is looked for
- CSS files are automatically found for HTML pages
- CSS files can be split, the'll be added in the template according to the page requested.
- theme CSS file is looked for, and if not found the default theme equivalent is looked for.
- each element of a path can be associated to a CSS file, and styles.css is always there. For instance if blog/articles.html is requested, the following CSS can be included: "styles.css", "blog.css", "blog_article.css". They all must be in /static
- if the automatic finding of CSS files is not wanted, css_files arguments can be used instead, with full relative path (i.e. including theme)
- CSS files can be merged and included inline with css_inline argument
- root_path can be specified, it will be used as a prefix for static files
- requested theme (which may differ from actual theme, e.g. if the template is not found and default one is used instead) is available in template with "theme" variable
- added getThemeAndRoot method to retrieve theme and theme root path from template
author | Goffi <goffi@goffi.org> |
---|---|
date | Sun, 05 Mar 2017 23:41:10 +0100 |
parents | 1128feb54180 |
children | e7bd2945518f |
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 |
1191 | 8 |
1202 | 9 The environment variable SAT_INSTALL customises the installation, it contains flags separated by spaces: |
10 - "nopreinstall" skips all preinstallation checks | |
11 - "autodeb" automatically installs missing packages on Debian-based distributions | |
12 - "nox" disables installation of X-based packages (WxWidgets), this is useful for servers | |
885 | 13 |
1935
1128feb54180
core: removed pyfeed and xe dependencies:
Goffi <goffi@goffi.org>
parents:
1410
diff
changeset
|
14 PyGobject is automatically installed on Debian-based distributions if "autodeb" option is set. Indeed, on Debian-based distribution, you can type (with the root account): |
885 | 15 |
16 # apt-get install python-pip python-dev libxml2-dev libxslt-dev | |
17 # SAT_INSTALL=autodeb pip install . | |
18 | |
19 On a *buntu, same commands with sudo: | |
20 | |
21 $ 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
|
22 $ sudo SAT_INSTALL=autodeb pip install . |
885 | 23 |
24 | |
25 After installing SàT, you need to install the media: | |
26 | |
27 $ mkdir -p ~/sat/media/destination/path | |
28 $ cd ~/sat/media/destination/path | |
29 wget ftp://ftp.goffi.org/sat_media/sat_media.tar.bz2 | |
30 tar -jxvf sat_media.tar.bz2 | |
31 | |
32 then, create a ~/.sat.conf file which contains: | |
33 | |
34 ### sat.conf ### | |
35 [DEFAULT] | |
36 media_dir=~/sat/media/destination/path | |
37 ### end sat.conf ### | |
38 | |
39 Of course, replace ~/sat/media/destination/path with the actual path you want to use. | |
1410
e2e75c3c7c7b
quick_frontend, primitivus: fixes a couple of issues:
souliane <souliane@mailoo.org>
parents:
1291
diff
changeset
|
40 Check the wiki for more information about this configuration file: http://wiki.goffi.org/wiki/Configuration/en |
885 | 41 |
42 You should now be able to launch sat: | |
43 - to launch the backend, enter | |
44 $ sat | |
45 - to stop the backend, enter: | |
46 $ sat stop | |
47 - to launch Primitivus, enter: | |
48 $ primitivus | |
49 then create a profile. | |
50 - to use jp, follow its help: | |
51 $ jp --help | |
52 | |
53 For Libervia, the web interface, check http://wiki.goffi.org/wiki/Libervia/en | |
54 | |
55 If you need help, come the SàT official XMPP room: sat@chat.jabberfr.org |