annotate README @ 115:bd30a18690e7

English social contract: software is invariant (Florian and Rachelle)
author souliane <souliane@mailoo.org>
date Tue, 20 Oct 2015 10:11:27 +0200
parents c1b77f07f644
children b1c16cd53b62
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
1 Salut à Toi's website
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
2 (c) Jérôme Poisson aka Goffi 2012
23
2fdbf8ebb72b upgrade to Django 1.7.3
souliane <souliane@mailoo.org>
parents: 1
diff changeset
3 (c) Adrien Cossa aka Souliane 2015
0
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
4
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
5
0
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
6 ** LICENCE **
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
7
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
8 SàT website is free software: you can redistribute it and/or modify
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
9 it under the terms of the GNU Affero General Public License as
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
10 the Free Software Foundation, either version 3 of the License, or
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
11 (at your option) any later version.
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
12
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
13 SàT website is distributed in the hope that it will be useful,
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
16 GNU Affero General Public License for more details.
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
17
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
18 You should have received a copy of the GNU Affero General Public License
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
19 along with SàT website. If not, see <http://www.gnu.org/licenses/>.
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
20
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
21 ---
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
22
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
23 The third party projects are under compatible licences (see below)
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
24
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
25 ---
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
26
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
27 The media in /static/images and /static/videos comes from Salut à Toi project and are under Creative Commons licence CC By-SA
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
28 The media in /static/css comes from Twitter Boostrap (see below) and are under Apache licence 2.0, except sat_website.css which is under AGPL v3
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
29
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
30
0
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
31 ** ABOUT **
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
32
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
33 This is the source code of Salut à Toi's presentation website.
23
2fdbf8ebb72b upgrade to Django 1.7.3
souliane <souliane@mailoo.org>
parents: 1
diff changeset
34 Salut à Toi is a communication software base on XMPP. You can have more informations on http://salut-a-toi.org (the website ran by this code).
0
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
35
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
36
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
37 ** REQUIREMENTS **
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
38
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
39 To run the website you need:
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
40
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
41 - Django 1.7.3 or superior ( https://www.djangoproject.com )
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
42 - Django application "markdown_deux" ( https://github.com/trentm/django-markdown-deux )
94
c1b77f07f644 replace shipped file unicodecsv.py with the module of the same name
souliane <souliane@mailoo.org>
parents: 64
diff changeset
43 - Python module unicodecsv ( https://github.com/jdunck/python-unicodecsv )
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
44
1
a49aa1b823f6 added SàT archive download link (detect the last version)
Goffi <goffi@goffi.org>
parents: 0
diff changeset
45 ** SETTINGS **
a49aa1b823f6 added SàT archive download link (detect the last version)
Goffi <goffi@goffi.org>
parents: 0
diff changeset
46
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
47 Please check the local_settings.py file which is distributed in the sat_website directory.
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
48 This is a template describing and initialising all settings.
31
31d196cf3b34 add settings ASSO_MEMBERS_*, ASSO_FINANCE_* and LIBERVIA_DEMO_URL
souliane <souliane@mailoo.org>
parents: 29
diff changeset
49
24
c6a3ca0429dd add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents: 23
diff changeset
50
c6a3ca0429dd add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents: 23
diff changeset
51 ** RUNNING THE WEBSITE LOCALLY **
c6a3ca0429dd add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents: 23
diff changeset
52
c6a3ca0429dd add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents: 23
diff changeset
53 This is the basic procedure to run the website on your local machine using the Django built-in web server.
c6a3ca0429dd add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents: 23
diff changeset
54 Please make the difference between the project directory (e.g. ~/workspace/sat_website) and the app directory (e.g. ~/workspace/sat_website/sat_website).
c6a3ca0429dd add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents: 23
diff changeset
55
c6a3ca0429dd add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents: 23
diff changeset
56 First add these two lines to your shell .*rc file:
c6a3ca0429dd add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents: 23
diff changeset
57
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
58 export PYTHONPATH=$PYTHONPATH:<path_to_the_app_directory>
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
59 export DJANGO_SETTINGS_MODULE=settings
24
c6a3ca0429dd add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents: 23
diff changeset
60
c6a3ca0429dd add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents: 23
diff changeset
61 Create in the app directory a file settings.py containing these lines:
c6a3ca0429dd add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents: 23
diff changeset
62
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
63 try:
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
64 from local_settings import *
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
65 except ImportError:
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
66 pass
24
c6a3ca0429dd add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents: 23
diff changeset
67
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
68 You can overwrite settings in settings.py after these lines.
60
0d20fb28c32e many small changes:
souliane <souliane@mailoo.org>
parents: 58
diff changeset
69 In the project directory, enter this command to initialise the website (this has to be done only once):
24
c6a3ca0429dd add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents: 23
diff changeset
70
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
71 django-admin syncdb
60
0d20fb28c32e many small changes:
souliane <souliane@mailoo.org>
parents: 58
diff changeset
72
0d20fb28c32e many small changes:
souliane <souliane@mailoo.org>
parents: 58
diff changeset
73 If you modify some strings in the Django code, update the i18n .po files with:
0d20fb28c32e many small changes:
souliane <souliane@mailoo.org>
parents: 58
diff changeset
74
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
75 django-admin makemessages -a
60
0d20fb28c32e many small changes:
souliane <souliane@mailoo.org>
parents: 58
diff changeset
76
0d20fb28c32e many small changes:
souliane <souliane@mailoo.org>
parents: 58
diff changeset
77 After having completed your translations or after a pull from the repository, compile the .po files to their .mo equivalents (the later ones are not stored on the repository):
0d20fb28c32e many small changes:
souliane <souliane@mailoo.org>
parents: 58
diff changeset
78
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
79 django-admin compilemessages
24
c6a3ca0429dd add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents: 23
diff changeset
80
60
0d20fb28c32e many small changes:
souliane <souliane@mailoo.org>
parents: 58
diff changeset
81 Whenever you want to launch the web server:
24
c6a3ca0429dd add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents: 23
diff changeset
82
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
83 django-admin runserver
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
84
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
85 You can also specify the interface and port, for example:
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
86
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
87 django-admin runserver 192.168.2.1:8000
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
88
23
2fdbf8ebb72b upgrade to Django 1.7.3
souliane <souliane@mailoo.org>
parents: 1
diff changeset
89
0
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
90 ** CREDIT **
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
91
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
92 The following third party project are shipped with this source code:
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
93
26
3df49721008c upgrade to Bootstrap v3.3.1
souliane <souliane@mailoo.org>
parents: 24
diff changeset
94 - Bootstrap v3.3.1 (http://getbootstrap.com) | Copyright 2011-2014 Twitter, Inc. | MIT licence: https://github.com/twbs/bootstrap/blob/master/LICENSE
3df49721008c upgrade to Bootstrap v3.3.1
souliane <souliane@mailoo.org>
parents: 24
diff changeset
95 - jQuery v1.11.1 (http://jquery.org) | Copyright 2005-2014 jQuery Foundation, Inc. | MIT licence: jquery.org/license
0
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
96
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
97 In addition, this project uses Django to run.
0
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
98
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
99 Thanks to the authors/contributors of these projects
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
100
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
101
0
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
102 ** CONTACT **
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
103
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
104 Jérôme Poisson
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
105
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
106 e-mail: goffi@goffi.org
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
107 jid: goffi@jabberfr.org
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
108