diff README @ 24:c6a3ca0429dd

add local_settings.py and instructions to run the website locally
author souliane <souliane@mailoo.org>
date Sat, 17 Jan 2015 21:37:19 +0100
parents 2fdbf8ebb72b
children 3df49721008c
line wrap: on
line diff
--- a/README	Sat Jan 17 21:36:25 2015 +0100
+++ b/README	Sat Jan 17 21:37:19 2015 +0100
@@ -40,6 +40,34 @@
 	SAT_DL_PATH = 'ftp://ftp.goffi.org/sat/sat.tar.bz2' #if set, this link will be used instead of the joined dl_prefix + filename
 
 Note that the Django application "markdown_deux" ( https://github.com/trentm/django-markdown-deux ) is required.
+For more information, check the local_settings.py file which is distributed in the sat_website directory.
+
+** RUNNING THE WEBSITE LOCALLY **
+
+This is the basic procedure to run the website on your local machine using the Django built-in web server.
+Please make the difference between the project directory (e.g. ~/workspace/sat_website) and the app directory (e.g. ~/workspace/sat_website/sat_website).
+
+First add these two lines to your shell .*rc file:
+
+export PYTHONPATH=$PYTHONPATH:<path_to_the_app_directory>
+export DJANGO_SETTINGS_MODULE=settings
+
+Create in the app directory a file settings.py containing these lines:
+
+try:
+    from local_settings import *
+except ImportError:
+    pass
+
+In the project directory, enter these commands to initialise the website:
+
+django-admin syncdb
+django-admin makemessages -a
+django-admin compilemessages
+
+All the preceeding instructions had to be done just once, now you only need to type this command (again in the project directory) whenever you want to launch the web server:
+
+django-admin runserver
 
 ** CREDIT **