Mercurial > sat_legacy_website
annotate README @ 62:b09c26afea5f
fixes typos and small changes
| author | souliane <souliane@mailoo.org> |
|---|---|
| date | Sat, 16 May 2015 09:41:11 +0200 |
| parents | 0d20fb28c32e |
| children | 1fb1e233d63f |
| rev | line source |
|---|---|
| 0 | 1 Salut à Toi's website |
| 2 (c) Jérôme Poisson aka Goffi 2012 | |
| 23 | 3 (c) Adrien Cossa aka Souliane 2015 |
| 0 | 4 |
| 5 ** LICENCE ** | |
| 6 | |
| 7 SàT website is free software: you can redistribute it and/or modify | |
| 8 it under the terms of the GNU Affero General Public License as | |
| 9 the Free Software Foundation, either version 3 of the License, or | |
| 10 (at your option) any later version. | |
| 11 | |
| 12 SàT website is distributed in the hope that it will be useful, | |
| 13 but WITHOUT ANY WARRANTY; without even the implied warranty of | |
| 14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
| 15 GNU Affero General Public License for more details. | |
| 16 | |
| 17 You should have received a copy of the GNU Affero General Public License | |
| 18 along with SàT website. If not, see <http://www.gnu.org/licenses/>. | |
| 19 | |
| 20 --- | |
| 21 | |
| 22 The third party projects are under compatible licences (see below) | |
| 23 | |
| 24 --- | |
| 25 | |
| 26 The media in /static/images and /static/videos comes from Salut à Toi project and are under Creative Commons licence CC By-SA | |
| 27 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 | |
| 28 | |
| 29 ** ABOUT ** | |
| 30 | |
| 31 This is the source code of Salut à Toi's presentation website. | |
| 23 | 32 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 | 33 |
|
1
a49aa1b823f6
added SàT archive download link (detect the last version)
Goffi <goffi@goffi.org>
parents:
0
diff
changeset
|
34 ** SETTINGS ** |
|
a49aa1b823f6
added SàT archive download link (detect the last version)
Goffi <goffi@goffi.org>
parents:
0
diff
changeset
|
35 |
|
a49aa1b823f6
added SàT archive download link (detect the last version)
Goffi <goffi@goffi.org>
parents:
0
diff
changeset
|
36 The following values can be set in site's settings.py: |
|
a49aa1b823f6
added SàT archive download link (detect the last version)
Goffi <goffi@goffi.org>
parents:
0
diff
changeset
|
37 |
|
58
746e53efc188
allow large media files (screencasts) to be stored on an external server
souliane <souliane@mailoo.org>
parents:
40
diff
changeset
|
38 # External URL pointing the external media files |
|
746e53efc188
allow large media files (screencasts) to be stored on an external server
souliane <souliane@mailoo.org>
parents:
40
diff
changeset
|
39 MEDIA_EXTERNAL_URL = 'ftp://ftp.goffi.org/media' |
|
746e53efc188
allow large media files (screencasts) to be stored on an external server
souliane <souliane@mailoo.org>
parents:
40
diff
changeset
|
40 |
| 39 | 41 # External URL pointing the projects archives directory |
|
58
746e53efc188
allow large media files (screencasts) to be stored on an external server
souliane <souliane@mailoo.org>
parents:
40
diff
changeset
|
42 PROJECTS_EXTERNAL_URL = 'ftp://ftp.goffi.org' |
| 39 | 43 |
| 44 # Internal path to the projects archives directory | |
| 45 PROJECTS_INTERNAL_PATH = '/var/www/projects' | |
|
31
31d196cf3b34
add settings ASSO_MEMBERS_*, ASSO_FINANCE_* and LIBERVIA_DEMO_URL
souliane <souliane@mailoo.org>
parents:
29
diff
changeset
|
46 |
| 39 | 47 # List of couples with the project directory name and the project name (set to None if it's the same) |
| 48 PROJECTS_NAMES = [('sat', None), ('sat_media', None), ('urwid-satext', 'urwid_satext'), ('sat_pubsub', None), ('libervia', None)] | |
|
31
31d196cf3b34
add settings ASSO_MEMBERS_*, ASSO_FINANCE_* and LIBERVIA_DEMO_URL
souliane <souliane@mailoo.org>
parents:
29
diff
changeset
|
49 |
| 39 | 50 # Extension used to name the project archives |
| 51 ARCHIVE_SUFFIX = '.tar.bz2' | |
|
31
31d196cf3b34
add settings ASSO_MEMBERS_*, ASSO_FINANCE_* and LIBERVIA_DEMO_URL
souliane <souliane@mailoo.org>
parents:
29
diff
changeset
|
52 |
|
31d196cf3b34
add settings ASSO_MEMBERS_*, ASSO_FINANCE_* and LIBERVIA_DEMO_URL
souliane <souliane@mailoo.org>
parents:
29
diff
changeset
|
53 # URL to Libervia online demo |
|
31d196cf3b34
add settings ASSO_MEMBERS_*, ASSO_FINANCE_* and LIBERVIA_DEMO_URL
souliane <souliane@mailoo.org>
parents:
29
diff
changeset
|
54 LIBERVIA_DEMO_URL = 'https://www.libervia.org' |
|
31d196cf3b34
add settings ASSO_MEMBERS_*, ASSO_FINANCE_* and LIBERVIA_DEMO_URL
souliane <souliane@mailoo.org>
parents:
29
diff
changeset
|
55 |
| 39 | 56 # Actual and target number of members |
|
31
31d196cf3b34
add settings ASSO_MEMBERS_*, ASSO_FINANCE_* and LIBERVIA_DEMO_URL
souliane <souliane@mailoo.org>
parents:
29
diff
changeset
|
57 ASSO_MEMBERS_ACTUAL = 3400 |
|
31d196cf3b34
add settings ASSO_MEMBERS_*, ASSO_FINANCE_* and LIBERVIA_DEMO_URL
souliane <souliane@mailoo.org>
parents:
29
diff
changeset
|
58 ASSO_MEMBERS_TARGET = 6000 |
|
31d196cf3b34
add settings ASSO_MEMBERS_*, ASSO_FINANCE_* and LIBERVIA_DEMO_URL
souliane <souliane@mailoo.org>
parents:
29
diff
changeset
|
59 |
| 39 | 60 # Actual and target amount to finance the association (in euros) |
|
31
31d196cf3b34
add settings ASSO_MEMBERS_*, ASSO_FINANCE_* and LIBERVIA_DEMO_URL
souliane <souliane@mailoo.org>
parents:
29
diff
changeset
|
61 ASSO_FINANCE_ACTUAL = 40000 |
|
31d196cf3b34
add settings ASSO_MEMBERS_*, ASSO_FINANCE_* and LIBERVIA_DEMO_URL
souliane <souliane@mailoo.org>
parents:
29
diff
changeset
|
62 ASSO_FINANCE_TARGET = 60000 |
|
31d196cf3b34
add settings ASSO_MEMBERS_*, ASSO_FINANCE_* and LIBERVIA_DEMO_URL
souliane <souliane@mailoo.org>
parents:
29
diff
changeset
|
63 |
| 39 | 64 # Subscription amounts as defined in the Rules of Procedure |
|
31
31d196cf3b34
add settings ASSO_MEMBERS_*, ASSO_FINANCE_* and LIBERVIA_DEMO_URL
souliane <souliane@mailoo.org>
parents:
29
diff
changeset
|
65 ASSO_SUBSCR_AMOUNTS = (0, 10, 20, 30, 50, 80, 100) |
|
31d196cf3b34
add settings ASSO_MEMBERS_*, ASSO_FINANCE_* and LIBERVIA_DEMO_URL
souliane <souliane@mailoo.org>
parents:
29
diff
changeset
|
66 |
| 60 | 67 # Path the CSV file where all the subscriptions are written |
| 68 ASSO_SUBSCR_CSV = "/home/souliane/sat_website_subscriptions.csv" | |
| 69 | |
|
58
746e53efc188
allow large media files (screencasts) to be stored on an external server
souliane <souliane@mailoo.org>
parents:
40
diff
changeset
|
70 # Bank account information |
|
746e53efc188
allow large media files (screencasts) to be stored on an external server
souliane <souliane@mailoo.org>
parents:
40
diff
changeset
|
71 ASSO_IBAN = u"FR76 1027 8060 4300 0207 3220 109" |
|
746e53efc188
allow large media files (screencasts) to be stored on an external server
souliane <souliane@mailoo.org>
parents:
40
diff
changeset
|
72 ASSO_BIC = u"CMCIFR2A" |
|
746e53efc188
allow large media files (screencasts) to be stored on an external server
souliane <souliane@mailoo.org>
parents:
40
diff
changeset
|
73 |
|
40
dfe7139dae0a
add links to the statutes and rules of the association in the adhesion form
souliane <souliane@mailoo.org>
parents:
39
diff
changeset
|
74 # URL to the Statutes and Rules of the association |
|
dfe7139dae0a
add links to the statutes and rules of the association in the adhesion form
souliane <souliane@mailoo.org>
parents:
39
diff
changeset
|
75 ASSO_URL_STATUTES = 'http://repos.goffi.org/sat_docs/raw-file/tip/association/statuts.pdf' |
|
dfe7139dae0a
add links to the statutes and rules of the association in the adhesion form
souliane <souliane@mailoo.org>
parents:
39
diff
changeset
|
76 ASSO_URL_RULES = 'http://repos.goffi.org/sat_docs/raw-file/tip/association/r%C3%A8glement%20int%C3%A9rieur.pdf' |
|
dfe7139dae0a
add links to the statutes and rules of the association in the adhesion form
souliane <souliane@mailoo.org>
parents:
39
diff
changeset
|
77 |
| 60 | 78 # Import another settings file that can override these settings (for example to daily update the stats when you don't want a script to directly modify this file) |
| 79 from sys import path | |
| 80 path.append('/home/souliane') | |
| 81 from sat_website_external_settings import * | |
|
1
a49aa1b823f6
added SàT archive download link (detect the last version)
Goffi <goffi@goffi.org>
parents:
0
diff
changeset
|
82 |
| 23 | 83 Note that the Django application "markdown_deux" ( https://github.com/trentm/django-markdown-deux ) is required. |
|
24
c6a3ca0429dd
add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents:
23
diff
changeset
|
84 For more information, check the local_settings.py file which is distributed in the sat_website directory. |
|
c6a3ca0429dd
add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents:
23
diff
changeset
|
85 |
|
c6a3ca0429dd
add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents:
23
diff
changeset
|
86 ** RUNNING THE WEBSITE LOCALLY ** |
|
c6a3ca0429dd
add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents:
23
diff
changeset
|
87 |
|
c6a3ca0429dd
add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents:
23
diff
changeset
|
88 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
|
89 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
|
90 |
|
c6a3ca0429dd
add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents:
23
diff
changeset
|
91 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
|
92 |
|
c6a3ca0429dd
add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents:
23
diff
changeset
|
93 export PYTHONPATH=$PYTHONPATH:<path_to_the_app_directory> |
|
c6a3ca0429dd
add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents:
23
diff
changeset
|
94 export DJANGO_SETTINGS_MODULE=settings |
|
c6a3ca0429dd
add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents:
23
diff
changeset
|
95 |
|
c6a3ca0429dd
add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents:
23
diff
changeset
|
96 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
|
97 |
|
c6a3ca0429dd
add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents:
23
diff
changeset
|
98 try: |
|
c6a3ca0429dd
add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents:
23
diff
changeset
|
99 from local_settings import * |
|
c6a3ca0429dd
add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents:
23
diff
changeset
|
100 except ImportError: |
|
c6a3ca0429dd
add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents:
23
diff
changeset
|
101 pass |
|
c6a3ca0429dd
add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents:
23
diff
changeset
|
102 |
| 60 | 103 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
|
104 |
|
c6a3ca0429dd
add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents:
23
diff
changeset
|
105 django-admin syncdb |
| 60 | 106 |
| 107 If you modify some strings in the Django code, update the i18n .po files with: | |
| 108 | |
|
24
c6a3ca0429dd
add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents:
23
diff
changeset
|
109 django-admin makemessages -a |
| 60 | 110 |
| 111 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): | |
| 112 | |
|
24
c6a3ca0429dd
add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents:
23
diff
changeset
|
113 django-admin compilemessages |
|
c6a3ca0429dd
add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents:
23
diff
changeset
|
114 |
| 60 | 115 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
|
116 |
|
c6a3ca0429dd
add local_settings.py and instructions to run the website locally
souliane <souliane@mailoo.org>
parents:
23
diff
changeset
|
117 django-admin runserver |
| 23 | 118 |
| 0 | 119 ** CREDIT ** |
| 120 | |
| 121 The following third party project are shipped with this source code: | |
| 122 | |
| 26 | 123 - Bootstrap v3.3.1 (http://getbootstrap.com) | Copyright 2011-2014 Twitter, Inc. | MIT licence: https://github.com/twbs/bootstrap/blob/master/LICENSE |
| 124 - jQuery v1.11.1 (http://jquery.org) | Copyright 2005-2014 jQuery Foundation, Inc. | MIT licence: jquery.org/license | |
| 0 | 125 |
| 126 In addition, this project use Django to run. | |
| 127 | |
| 128 Thanks to the authors/contributors of these projects | |
| 129 | |
| 130 ** CONTACT ** | |
| 131 | |
| 132 Jérôme Poisson | |
| 133 | |
| 134 e-mail: goffi@goffi.org | |
| 135 jid: goffi@jabberfr.org | |
| 136 |