annotate README @ 70:d6bf5414c6c4

French translation fixed by Samuel
author souliane <souliane@mailoo.org>
date Wed, 27 May 2015 14:50:51 +0200
parents 1fb1e233d63f
children c1b77f07f644
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 )
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
43
1
a49aa1b823f6 added SàT archive download link (detect the last version)
Goffi <goffi@goffi.org>
parents: 0
diff changeset
44 ** SETTINGS **
a49aa1b823f6 added SàT archive download link (detect the last version)
Goffi <goffi@goffi.org>
parents: 0
diff changeset
45
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
46 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
47 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
48
24
c6a3ca0429dd add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents: 23
diff changeset
49
c6a3ca0429dd add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents: 23
diff changeset
50 ** RUNNING THE WEBSITE LOCALLY **
c6a3ca0429dd add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents: 23
diff changeset
51
c6a3ca0429dd add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents: 23
diff changeset
52 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
53 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
54
c6a3ca0429dd add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents: 23
diff changeset
55 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
56
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
57 export PYTHONPATH=$PYTHONPATH:<path_to_the_app_directory>
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
58 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
59
c6a3ca0429dd add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents: 23
diff changeset
60 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
61
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
62 try:
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
63 from local_settings import *
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
64 except ImportError:
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
65 pass
24
c6a3ca0429dd add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents: 23
diff changeset
66
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
67 You can overwrite settings in settings.py after these lines.
60
0d20fb28c32e many small changes:
souliane <souliane@mailoo.org>
parents: 58
diff changeset
68 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
69
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
70 django-admin syncdb
60
0d20fb28c32e many small changes:
souliane <souliane@mailoo.org>
parents: 58
diff changeset
71
0d20fb28c32e many small changes:
souliane <souliane@mailoo.org>
parents: 58
diff changeset
72 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
73
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
74 django-admin makemessages -a
60
0d20fb28c32e many small changes:
souliane <souliane@mailoo.org>
parents: 58
diff changeset
75
0d20fb28c32e many small changes:
souliane <souliane@mailoo.org>
parents: 58
diff changeset
76 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
77
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
78 django-admin compilemessages
24
c6a3ca0429dd add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents: 23
diff changeset
79
60
0d20fb28c32e many small changes:
souliane <souliane@mailoo.org>
parents: 58
diff changeset
80 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
81
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
82 django-admin runserver
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
83
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
84 You can also specify the interface and port, for example:
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
85
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
86 django-admin runserver 192.168.2.1:8000
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
87
23
2fdbf8ebb72b upgrade to Django 1.7.3
souliane <souliane@mailoo.org>
parents: 1
diff changeset
88
0
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
89 ** CREDIT **
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
90
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
91 The following third party project are shipped with this source code:
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
92
26
3df49721008c upgrade to Bootstrap v3.3.1
souliane <souliane@mailoo.org>
parents: 24
diff changeset
93 - 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
94 - 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
95
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
96 In addition, this project uses Django to run.
0
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
97
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
98 Thanks to the authors/contributors of these projects
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
99
64
1fb1e233d63f update README
souliane <souliane@mailoo.org>
parents: 60
diff changeset
100
0
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
101 ** CONTACT **
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
102
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
103 Jérôme Poisson
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
104
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
105 e-mail: goffi@goffi.org
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
106 jid: goffi@jabberfr.org
9305c6458e2f initial commit
Goffi <goffi@goffi.org>
parents:
diff changeset
107