Mercurial > sat_legacy_website
annotate README @ 68:c46cd6dbf407
add link to radio recording at "Ici et maintenant"
| author | souliane <souliane@mailoo.org> |
|---|---|
| date | Wed, 27 May 2015 14:25:15 +0200 |
| parents | 1fb1e233d63f |
| children | c1b77f07f644 |
| 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 |
| 64 | 5 |
| 0 | 6 ** LICENCE ** |
| 7 | |
| 8 SàT website is free software: you can redistribute it and/or modify | |
| 9 it under the terms of the GNU Affero General Public License as | |
| 10 the Free Software Foundation, either version 3 of the License, or | |
| 11 (at your option) any later version. | |
| 12 | |
| 13 SàT website is distributed in the hope that it will be useful, | |
| 14 but WITHOUT ANY WARRANTY; without even the implied warranty of | |
| 15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
| 16 GNU Affero General Public License for more details. | |
| 17 | |
| 18 You should have received a copy of the GNU Affero General Public License | |
| 19 along with SàT website. If not, see <http://www.gnu.org/licenses/>. | |
| 20 | |
| 21 --- | |
| 22 | |
| 23 The third party projects are under compatible licences (see below) | |
| 24 | |
| 25 --- | |
| 26 | |
| 27 The media in /static/images and /static/videos comes from Salut à Toi project and are under Creative Commons licence CC By-SA | |
| 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 | |
| 29 | |
| 64 | 30 |
| 0 | 31 ** ABOUT ** |
| 32 | |
| 33 This is the source code of Salut à Toi's presentation website. | |
| 23 | 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 | 35 |
| 64 | 36 |
| 37 ** REQUIREMENTS ** | |
| 38 | |
| 39 To run the website you need: | |
| 40 | |
| 41 - Django 1.7.3 or superior ( https://www.djangoproject.com ) | |
| 42 - Django application "markdown_deux" ( https://github.com/trentm/django-markdown-deux ) | |
| 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 | 46 Please check the local_settings.py file which is distributed in the sat_website directory. |
| 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 | 57 export PYTHONPATH=$PYTHONPATH:<path_to_the_app_directory> |
| 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 | 62 try: |
| 63 from local_settings import * | |
| 64 except ImportError: | |
| 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 | 67 You can overwrite settings in settings.py after these lines. |
| 60 | 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 | 70 django-admin syncdb |
| 60 | 71 |
| 72 If you modify some strings in the Django code, update the i18n .po files with: | |
| 73 | |
| 64 | 74 django-admin makemessages -a |
| 60 | 75 |
| 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): | |
| 77 | |
| 64 | 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 | 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 | 82 django-admin runserver |
| 83 | |
| 84 You can also specify the interface and port, for example: | |
| 85 | |
| 86 django-admin runserver 192.168.2.1:8000 | |
| 87 | |
| 23 | 88 |
| 0 | 89 ** CREDIT ** |
| 90 | |
| 91 The following third party project are shipped with this source code: | |
| 92 | |
| 26 | 93 - Bootstrap v3.3.1 (http://getbootstrap.com) | Copyright 2011-2014 Twitter, Inc. | MIT licence: https://github.com/twbs/bootstrap/blob/master/LICENSE |
| 94 - jQuery v1.11.1 (http://jquery.org) | Copyright 2005-2014 jQuery Foundation, Inc. | MIT licence: jquery.org/license | |
| 0 | 95 |
| 64 | 96 In addition, this project uses Django to run. |
| 0 | 97 |
| 98 Thanks to the authors/contributors of these projects | |
| 99 | |
| 64 | 100 |
| 0 | 101 ** CONTACT ** |
| 102 | |
| 103 Jérôme Poisson | |
| 104 | |
| 105 e-mail: goffi@goffi.org | |
| 106 jid: goffi@jabberfr.org | |
| 107 |