diff options
Diffstat (limited to 'docs/_build/html/_sources/install.txt')
| -rw-r--r-- | docs/_build/html/_sources/install.txt | 77 |
1 files changed, 40 insertions, 37 deletions
diff --git a/docs/_build/html/_sources/install.txt b/docs/_build/html/_sources/install.txt index f05e5f0..248ece9 100644 --- a/docs/_build/html/_sources/install.txt +++ b/docs/_build/html/_sources/install.txt @@ -78,7 +78,7 @@ Database configuration ********************** Now that postgres and postgis are installed, you need to create a new user for -chimere:: +Chimère:: su postgres createuser --echo --adduser --createdb --encrypted --pwprompt chimere-user @@ -92,8 +92,8 @@ the paths accordingly to your needs):: psql -d chimere -f /usr/share/postgresql/$PG_VERSION/contrib/postgis-1.5/postgis.sql psql -d chimere -f /usr/share/postgresql/$PG_VERSION/contrib/postgis-1.5/spatial_ref_sys.sql -Install the sources -******************* +Installing the sources +********************** Choose a path to install your Chimère:: @@ -105,8 +105,7 @@ From an archive The last "stable" version is available in this `directory <http://www.peacefrogs.net/download/chimere/>`_. Take care of getting the last version in the desired X.Y branch (for instance -the last version for the 1.0 branch is version 1.0.2. -Extract it to the desired destination path:: +the last version for the 1.0 branch is version 1.0.2).:: wget http://www.peacefrogs.net/download/chimere -q -O -| html2text (...) @@ -127,7 +126,7 @@ readable directory:: From the git repository +++++++++++++++++++++++ -Another solution is to get the last git version:: +Another solution is to get it from the git repository:: cd $INSTALL_PATH git clone git://www.peacefrogs.net/git/chimere @@ -136,26 +135,26 @@ Another solution is to get the last git version:: git checkout v2.0 # checkout the desired version -Create a custom project template -******************************** +Creating a custom project template +********************************** -There a default project is provided (example_project). Copy and modify it (or -get another project based on Chimere):: +There, a default project is provided (*example_project*). Copy and modify +it (or get another project based on Chimère):: cd $INSTALL_PATH/chimere cp -ra example_project mychimere_project Your project name is used for the name of the Python package of your template. As a Python package it should follow the rule of Python variable name: -it must be at least one letter and can have a string of numbers, letters and -underscores ("_") to any length. Don't begin the name by "_" because it has -special significance in Python. +it must contain at least one letter and can have a string of numbers, letters and +underscores ("_") to any length. Don't use accentuated letters. Don't begin the +name by "_" because it has special significance in Python. -In your chimere application directory create local_settings.py to fit to your +In your Chimère application directory create *local_settings.py* to fit to your configuration. -A base template is provided (local_settings.py.example) and short descriptions of -the more relevant fields are given below (at least check them). Most of these -settings are initialized in settings.py. :: +A base template is provided (*local_settings.py.example*) and short descriptions +of the more relevant fields are given below (at least check them). Most of +these settings are initialized in *settings.py*. :: cd $INSTALL_PATH/chimere/mychimere_project cp local_settings.py.sample local_settings.py @@ -167,18 +166,20 @@ settings are initialized in settings.py. :: * PROJECT_NAME: name of the project * SECRET_KEY: a secret key for a particular Django installation. This is used to provide cryptographic signing, and should be set to a unique, - unpredictable value. Change it! + unpredictable value. **Change it!** * ROOT_URLCONF: url configuration for your project something like: 'mychimere_project.urls' * EMAIL_HOST: smtp of an email server to send emails * TINYMCE_URL: url to tinymce path (default is appropriate for a Debian - installation with tinymce activated) - * JQUERY_JS_URLS: list of Jquery and Jquery-ui urls (default is appropriate - for a Debian installation with Jquery and Jquery-ui activated) - * JQUERY_CSS_URLS: list of Jquery and Jquery-ui urls (default is appropriate - for a Debian installation with Jquery and Jquery-ui activated) + installation with tinymce package installed) + * JQUERY_JS_URLS: list of jquery and jquery-ui javascript urls (default is + appropriate for a Debian installation with libjs-jquery libjs-jquery-ui + packages installed) + * JQUERY_CSS_URLS: list of jquery and jquery-ui CSS urls (default is + appropriate for a Debian installation with libjs-jquery libjs-jquery-ui + packages installed) * GPSBABEL: path to gpsbabel (default is appropriate for a Debian - installation with gpsbabel installed) + installation with gpsbabel package installed) * TIME_ZONE: local time zone for this installation * LANGUAGE_CODE: language code for this installation @@ -203,9 +204,9 @@ Regroup static files in one path:: Compiling languages ******************* -If your language is available in the locale directory of chimere, you will just -need to get it compiled. This can be done with (here, **fr** stands for french. -Replace it with the appropriate language code):: +If your language is available in the directory *chimere/locale/*, you will just +need to get it compiled. This can be done with the following command (here, +**fr** stands for French, replace it with the appropriate language code):: cd $INSTALL_PATH/chimere/chimere/ django-admin compilemessages @@ -227,14 +228,14 @@ would have if the language file was already available. Database initialisation *********************** -Create the appropriate tables (still being in chimère application directory):: +Create the appropriate tables (still being in your Chimère project directory):: cd $INSTALL_PATH/chimere/mychimere_project ./manage.py syncdb You will be prompted for the creation of an administrator account -(administration can be found at: http://where_is_chimere/admin). Then you have -to create tables managed with south:: +(administration can be found at: http://where_is_chimere/admin/). Then you have +to create tables managed with Django-South:: ./manage.py migrate @@ -251,23 +252,25 @@ Webserver configuration Apache configuration with mod_wsgi ++++++++++++++++++++++++++++++++++ -Install mod_wsgi for apache:: +Install *mod_wsgi* for Apache:: apt-get install libapache2-mod-wsgi -TODO: adapt apache-wsgi.conf - Create and edit a configuration for Chimère:: - cp $INSTALL_PATH/chimere/apache/django.wsgi $INSTALL_PATH/chimere/apache/mydjango.wsgi + cp $INSTALL_PATH/chimere/apache/django.wsgi \ + $INSTALL_PATH/chimere/apache/mydjango.wsgi vim $INSTALL_PATH/chimere/apache/mydjango.wsgi - cp $INSTALL_PATH/chimere/apache/apache-wsgi.conf /etc/apache2/sites-available/chimere + cp $INSTALL_PATH/chimere/apache/apache-wsgi.conf \ + /etc/apache2/sites-available/chimere vim /etc/apache2/sites-available/chimere # create log dir mkdir /var/log/apache2/chimere/ + chown www-data /var/log/apache2/chimere/ -Adapt the files *mydjango.wsgi* (with the correct sys path) and Apache *chimere*. +Adapt the files *mydjango.wsgi* (with the correct sys path and the correct +module) and Apache *chimere* (with the correct servername and correct paths). To activate the website, reload apache:: @@ -276,7 +279,7 @@ To activate the website, reload apache:: If you encounter problem with the upload of files with Unicode chars in their names, activate the appropriate locale in Apache. On a Debian server with UTF-8 -as default encoding in the file */etc/apache2/envvars*, uncomment the following +as default encoding, in the file */etc/apache2/envvars* uncomment the following line:: . /etc/default/locale |