From d09de4b20d942f322608dd695c09d463fd017bc1 Mon Sep 17 00:00:00 2001 From: Étienne Loks Date: Thu, 29 Nov 2012 01:18:11 +0100 Subject: Begin french translation of documentation --- docs/fr/install.rst | 297 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 297 insertions(+) create mode 100644 docs/fr/install.rst (limited to 'docs/fr/install.rst') diff --git a/docs/fr/install.rst b/docs/fr/install.rst new file mode 100644 index 0000000..a61846d --- /dev/null +++ b/docs/fr/install.rst @@ -0,0 +1,297 @@ +.. -*- coding: utf-8 -*- + +============ +Installation +============ + +:Auteur: Étienne Loks +:date: 2012-10-08 +:Copyright: CC-BY 3.0 + +Ce document présente l'installation de Chimère. +Ce document a été mis à jour pour la version 2.0.0 de Chimère. + +Prerequis +********* + + - `apache `_ version 2.x + - `python `_ versions 2.6 ou 2.7 + - `django `_ >= version 1.4 + - `south `_ + - `postgres `_ >= version 8.x + - `gettext `_ + - `psycopg2 `_ + - `Python Imaging Library `_ + - `pyexiv2 `_ + - `Beautiful Soup `_ + - python-simplejson + - python-gdal + - `unidecode _ + - `lxml `_ + - `jquery `_ version 1.7.1 or better + - `jquery-ui `_ + - `Universal Feed Parser `_ + +geodjango fait parti de Django depuis la version 1.0 mas nécessite quelques +dépendances supplémentaires.:: + + - `geos `_ 3.0.x + - `proj.4 `_ 4.4 to 4.6 + - `posgis `_ versions 1.2.1 ou 1.3.x + - `gdal `_ + + +Optionnel (mais recommandé): + + - `tinymce `_ + - `gpsbabel `_ + - django-celery pour une meilleure gestion des imports importants. + +La manière la plus simple de satisfaire à ces pré-prequis est de les installer +par le biais des dépôts de votre distribution Linux préférée. Par exemple +pour Debian Wheezy:: + + apt-get install python python-django python-django-south \ + python-beautifulsoup tinymce apache2 libgeos-3.3.3 proj-bin gdal-bin \ + python-gdal python-lxml python-psycopg2 python-imaging gettext \ + postgresql-9.1 postgresql-9.1-postgis libjs-jquery libjs-jquery-ui \ + python-django-celery python-simplejson gpsbabel \ + python-pyexiv2 python-feedparser javascript-common + +Pour Debian Squeeze (il est nécessaire d'activer les backports):: + + apt-get install -t squeeze-backports python-django libjs-jquery + + apt-get install python python-django-south python-beautifulsoup tinymce \ + apache2 libgeos-3.2.0 proj-bin gdal-bin python-gdal python-lxml \ + python-psycopg2 python-imaging gettext postgresql-8.4 \ + postgresql-8.4-postgis libjs-jquery libjs-jquery-ui python-simplejson \ + gpsbabel python-pyexiv2 python-feedparser javascript-common + +Si ces paquets n'ont pas d'équivalents sur les dépôts de votre distribution +Linux référez vous aux sites web de ces applications. + +Configuration de la base de données +*********************************** + +Maintenant que postgres et postgis sont installés, vous avez besoin de créer +un nouvel utilisateur pour Chimère:: + + su postgres + createuser --echo --adduser --createdb --encrypted --pwprompt chimere-user + +Ensuite, vous avez besoin de créer la base de données et d'initialiser les types +géographiques (adaptez les chemins par rapport à vos besoins):: + + PG_VERSION=9.1 # 8.4 pour debian Squeeze + createdb --echo --owner chimere-user --encoding UNICODE chimere "Ma base de données Chimère" + createlang plpgsql chimere # seulement nécessaire sous Debian Squeeze + 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 + +Installer les sources +********************* + +Choisissez un chemin où installer Chimère:: + + INSTALL_PATH=/var/local/django + mkdir $INSTALL_PATH + +Depuis une archive +++++++++++++++++++ + +La dernière version « stable » est disponible dans ce `répertoire +`_. +Prenez garde à prendre la dernière version de la branche souhaitée +(par exemple la dernière version de la branche 1.0 est la version 1.0.2).:: + + wget http://www.peacefrogs.net/download/chimere -q -O -| html2text + (...) + [[ ]] chimere-1.0.0.tar.bz2 17-Nov-2010 16:51 53K + [[ ]] chimere-1.0.1.tar.bz2 17-Nov-2010 16:51 53K + [[ ]] chimere-1.0.2.tar.bz2 17-Nov-2010 16:51 53K + (...) + + wget http://www.peacefrogs.net/download/chimere/chimere-1.0.2.tar.bz2 + +Téléchargez, décompressez et bougez les fichiers dans un répertoire lisible +par l'utilisateur de votre server web (www-data pour Debian).:: + + cd $INSTALL_PATH + tar xvjf chimere-last.tar.bz2 + chown -R myusername:www-data chimere + +Depuis le dépôt git ++++++++++++++++++++ + +Une autre solution est d'obtenir les sources depuis le dépôt Git:: + + cd $INSTALL_PATH + git clone git://www.peacefrogs.net/git/chimere + cd chimere + git tag -l # list tagged versions + git checkout v2.0 # checkout the desired version + + +Créez un patron pour votre projet +********************************* + +Il y a un exemple de projet fourni « example_project ». Copiez le et modifiez +le (ou obtenez un autre projet basé sur Chimère):: + + cd $INSTALL_PATH/chimere + cp -ra example_project mychimere_project + +Le nom de votre projet est utilisé pour le nom de la bibliothèque Python +correspondant à votre projet. +En tant que bibliothèque Python, ce nom doit suivre les règles de nommage des +noms de variable Python : il doit comporter au moins une lettre et peut +comporter autant de nombres et de lettres que souhaité, le caractère « _ » est +accepté. N'utilisez pas de caractères accentués. Ne commencez pas par « _ » +car cela a une signification particulière en Python. + +Dans le répertoire de votre application Chimère créez un fichier +*local_settings.py* qui correspond à votre configuration. +Un fichier de base est fourni (*local_settings.py.example*) et des descriptions +courtes de fichiers les plus pertinents sont fournis en dessous (regardez les au +moins). La plupart de ces paramétrages sont initialisés dans le fichier +*settings.py*.:: + + cd $INSTALL_PATH/chimere/mychimere_project + cp local_settings.py.sample local_settings.py + vim local_settings.py + +:Fields: + + * DATABASES: paramètres relatifs à la base de données + * PROJECT_NAME: nom du projet + * SECRET_KEY: une clé secrète pour l'installation de votre application + Django. Cette clé est utilisée pour les signatures cryptographique de + l'application et doit être initialisé à une valeur unique et non + devinable. **Changez là !** + * ROOT_URLCONF: module python de configuration des urls pour votre projet. + quelque chose comme : 'mychimere_project.urls' + * EMAIL_HOST: SMTP du serveur de courriel pour envoyer des courriels + * TINYMCE_URL: url du chemin vers tinymce (le chemin par défaut est adapté + pour une installation sous Debian avec le paquet tinymce installé) + * JQUERY_JS_URLS: liste des adresses des fichiers javascript jquery et + jquery-ui (les valeurs par défaut sont appropriées pour une installation + sous Debian avec les paquets libjs-jquery et libjs-jquery-ui installés) + * JQUERY_CSS_URLS: liste des adresses des fichiers CSS jquery et + jquery-ui (les valeurs par défaut sont appropriées pour une installation + sous Debian avec les paquets libjs-jquery et libjs-jquery-ui installés) + * GPSBABEL: chemin de gpsbabel (la valeur par défaut est approprié pour + une installation sous Debian avec le paquet gpsbabel installé) + * TIME_ZONE: fuseau horaire local de cette installation + * LANGUAGE_CODE: code de langage pour cette installation + +Gérez les permissions du dossier de média:: + + cd $INSTALL_PATH/chimere/mychimere_project + chown -R user:www-data media + chmod -R g+w media + +Créez le fichier de log:: + + mkdir /var/log/django + touch /var/log/django/chimere.log + chown -R root:www-data /var/log/django/ + chmod -R g+w /var/log/django/ + +Regroupez les fichiers static dans un seul répertoire:: + + cd $INSTALL_PATH/chimere/mychimere_project + ./manage.py collectstatic + +Compilation des langages +************************ + +Si votre langage est disponible dans le dossier *chimere/locale/*, il est juste +nécessaire de le compiler. +Pour faire cela, il faut lancer la commande suivante (ici, **fr** est pour le +français, remplacez cela avec le code de langage approprié) :: + + cd $INSTALL_PATH/chimere/chimere/ + django-admin compilemessages + +Si votre langage n'est pas disponible, n'hésitez pas à créer le fichier **po** +par défaut et de le proposer (les contributions sont bienvenues). +La procédure est la suivante :: + +Il est d'abord nécessaire de créer le fichier po par défaut (bien sûr remplacez +**fr** par le langage que vous souhaitez créer) :: + + django-admin makemessages -l fr + +Il doit y avoir maintenant un fichier *django.po* dans le répertoire +*locale/fr/LC_MESSAGES*. Ensuite il est nécessaire de le compléter avec votre +traduction. + +Maintenant que votre fichier de traduction est complété, il suffit de le +compléter de la même manière que vous l'auriez fait si ce fichier était +initialement disponible. + +Initialisation de la base de données +************************************ + +Créez les tables de la base de données (toujours dans le répertoire de votre +projet):: + + cd $INSTALL_PATH/chimere/mychimere_project + ./manage.py syncdb + + +Vous aurez à rentrer les informations pour la création du compte administrateur +(les pages d'administration se trouvent à l'adresse : +http://where_is_chimere/admin/). Ensuite pour créer les tables de la base de +données gérés par Django-South :: + + ./manage.py migrate + +La base de données est en place, félicitations ! + +Si vous voulez remplir votre installation avec des données par défaut (ne le +faites pas sur une instance de Chimère contenant déjà des données !) :: + + ./manage.py loaddata ../chimere/fixtures/default_data.json + +Configuration du serveur web +**************************** + +Configuration d'Apache avec mod_wsgi +++++++++++++++++++++++++++++++++++++ + +Installez *mod_wsgi* pour Apache:: + + apt-get install libapache2-mod-wsgi + + +Créez et éditez la configuration de Chimère en fonction de votre installation :: + + 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 + vim /etc/apache2/sites-available/chimere + # create log dir + mkdir /var/log/apache2/chimere/ + chown www-data /var/log/apache2/chimere/ + +Adaptez les fichiers *mydjango.wsgi* (avec le chemin correct *sys* des +bibliothèques python de Chimère et le nom correct pour le module) et le fichier +*chimere* de Apache (avec le nom de serveur correct et les chemins corrects). + +Pour activer le site web rechargez Apache :: + + a2ensite chimere + /etc/init.d/apache2 reload + +Si vous avez des problèmes de dépôt de fichier avec des caractères Unicode dans +leurs noms activez la locale appropriée dans Apache. Sur un serveur Debian avec +UTF-8 comme codage par défaut, dans le fichier */etc/apache2/envvars* +décommentez la ligne suivante :: + + . /etc/default/locale + + -- cgit v1.2.3 From 29733981680ef96482ad7adb6fb6fc3f4cef685a Mon Sep 17 00:00:00 2001 From: Nawa Date: Thu, 29 Nov 2012 02:28:05 +0100 Subject: Documentation: new corrections --- docs/customisation.rst | 2 +- docs/fr/install.rst | 89 +++++++++++++++++++++++++------------------------- docs/import_export.rst | 72 ++++++++++++++++++++++------------------ docs/install.rst | 6 ++-- docs/upgrade.rst | 2 ++ 5 files changed, 91 insertions(+), 80 deletions(-) (limited to 'docs/fr/install.rst') diff --git a/docs/customisation.rst b/docs/customisation.rst index e6615db..05f1d35 100644 --- a/docs/customisation.rst +++ b/docs/customisation.rst @@ -8,7 +8,7 @@ Customisation :date: 2012-11-28 :Copyright: CC-BY 3.0 -This document presents the installation of Chimère. +This document presents the customisation of Chimère. It has been updated for version 2.0.0. diff --git a/docs/fr/install.rst b/docs/fr/install.rst index a61846d..404cf4c 100644 --- a/docs/fr/install.rst +++ b/docs/fr/install.rst @@ -9,9 +9,9 @@ Installation :Copyright: CC-BY 3.0 Ce document présente l'installation de Chimère. -Ce document a été mis à jour pour la version 2.0.0 de Chimère. +Il a été mis à jour pour la version 2.0.0 de Chimère. -Prerequis +Pré-requis ********* - `apache `_ version 2.x @@ -26,13 +26,13 @@ Prerequis - `Beautiful Soup `_ - python-simplejson - python-gdal - - `unidecode _ + - `unidecode `_ - `lxml `_ - `jquery `_ version 1.7.1 or better - `jquery-ui `_ - `Universal Feed Parser `_ -geodjango fait parti de Django depuis la version 1.0 mas nécessite quelques +geodjango fait partie de Django depuis la version 1.0 mas nécessite quelques dépendances supplémentaires.:: - `geos `_ 3.0.x @@ -51,25 +51,26 @@ La manière la plus simple de satisfaire à ces pré-prequis est de les installe par le biais des dépôts de votre distribution Linux préférée. Par exemple pour Debian Wheezy:: - apt-get install python python-django python-django-south \ - python-beautifulsoup tinymce apache2 libgeos-3.3.3 proj-bin gdal-bin \ - python-gdal python-lxml python-psycopg2 python-imaging gettext \ - postgresql-9.1 postgresql-9.1-postgis libjs-jquery libjs-jquery-ui \ - python-django-celery python-simplejson gpsbabel \ - python-pyexiv2 python-feedparser javascript-common + apt-get install apache2 python python-django python-django-south \ + postgresql-9.1 gettext python-psycopg2 python-imaging \ + python-pyexiv2 python-beautifulsoup python-simplejson python-gdal \ + javascript-common python-lxml libjs-jquery libjs-jquery-ui \ + python-feedparser libgeos-3.3.3 proj-bin postgresql-9.1-postgis \ + gdal-bin tinymce gpsbabel python-django-celery \ Pour Debian Squeeze (il est nécessaire d'activer les backports):: apt-get install -t squeeze-backports python-django libjs-jquery - apt-get install python python-django-south python-beautifulsoup tinymce \ - apache2 libgeos-3.2.0 proj-bin gdal-bin python-gdal python-lxml \ - python-psycopg2 python-imaging gettext postgresql-8.4 \ - postgresql-8.4-postgis libjs-jquery libjs-jquery-ui python-simplejson \ - gpsbabel python-pyexiv2 python-feedparser javascript-common + apt-get install apache2 python python-django python-django-south \ + postgresql-8.4 gettext python-psycopg2 python-imaging \ + python-pyexiv2 python-beautifulsoup python-simplejson python-gdal \ + javascript-common python-lxml libjs-jquery libjs-jquery-ui \ + python-feedparser libgeos-3.2.0 proj-bin postgresql-8.4-postgis \ + gdal-bin tinymce gpsbabel \ Si ces paquets n'ont pas d'équivalents sur les dépôts de votre distribution -Linux référez vous aux sites web de ces applications. +Linux, référez vous aux sites web de ces applications. Configuration de la base de données *********************************** @@ -114,8 +115,8 @@ Prenez garde à prendre la dernière version de la branche souhaitée wget http://www.peacefrogs.net/download/chimere/chimere-1.0.2.tar.bz2 -Téléchargez, décompressez et bougez les fichiers dans un répertoire lisible -par l'utilisateur de votre server web (www-data pour Debian).:: +Téléchargez, décompressez et déplacez les fichiers dans un répertoire lisible +par l'utilisateur de votre serveur web (www-data pour Debian).:: cd $INSTALL_PATH tar xvjf chimere-last.tar.bz2 @@ -129,15 +130,15 @@ Une autre solution est d'obtenir les sources depuis le dépôt Git:: cd $INSTALL_PATH git clone git://www.peacefrogs.net/git/chimere cd chimere - git tag -l # list tagged versions - git checkout v2.0 # checkout the desired version + git tag -l # lister les versions + git checkout v2.0 # choisir la version désirée Créez un patron pour votre projet ********************************* -Il y a un exemple de projet fourni « example_project ». Copiez le et modifiez -le (ou obtenez un autre projet basé sur Chimère):: +Il y a un exemple de projet fourni (*example_project*). Copiez-le et +modifiez-le (ou utilisez un autre projet basé sur Chimère):: cd $INSTALL_PATH/chimere cp -ra example_project mychimere_project @@ -146,15 +147,15 @@ Le nom de votre projet est utilisé pour le nom de la bibliothèque Python correspondant à votre projet. En tant que bibliothèque Python, ce nom doit suivre les règles de nommage des noms de variable Python : il doit comporter au moins une lettre et peut -comporter autant de nombres et de lettres que souhaité, le caractère « _ » est -accepté. N'utilisez pas de caractères accentués. Ne commencez pas par « _ » -car cela a une signification particulière en Python. +comporter autant de nombres et de lettres que souhaité, le caractère tiret bas +(« _ ») est accepté. N'utilisez pas de caractères accentués. Ne commencez pas +par « _ » car cela a une signification particulière en Python. Dans le répertoire de votre application Chimère créez un fichier *local_settings.py* qui correspond à votre configuration. Un fichier de base est fourni (*local_settings.py.example*) et des descriptions -courtes de fichiers les plus pertinents sont fournis en dessous (regardez les au -moins). La plupart de ces paramétrages sont initialisés dans le fichier +courtes des fichiers les plus pertinents sont données sous celui-ci (survolez-les au +minimum). La plupart de ces paramétrages sont initialisés dans le fichier *settings.py*.:: cd $INSTALL_PATH/chimere/mychimere_project @@ -163,27 +164,27 @@ moins). La plupart de ces paramétrages sont initialisés dans le fichier :Fields: - * DATABASES: paramètres relatifs à la base de données - * PROJECT_NAME: nom du projet - * SECRET_KEY: une clé secrète pour l'installation de votre application - Django. Cette clé est utilisée pour les signatures cryptographique de - l'application et doit être initialisé à une valeur unique et non - devinable. **Changez là !** - * ROOT_URLCONF: module python de configuration des urls pour votre projet. + * DATABASES : paramètres relatifs à la base de données + * PROJECT_NAME : nom du projet + * SECRET_KEY : une clé secrète pour l'installation de votre application + Django. Cette clé est utilisée pour les signatures cryptographiques de + l'application et doit être initialisée à une valeur unique et non + devinable. **Modifiez-là !** + * ROOT_URLCONF : module python de configuration des urls pour votre projet. quelque chose comme : 'mychimere_project.urls' - * EMAIL_HOST: SMTP du serveur de courriel pour envoyer des courriels - * TINYMCE_URL: url du chemin vers tinymce (le chemin par défaut est adapté + * EMAIL_HOST : SMTP du serveur de courriel pour envoyer des courriels + * TINYMCE_URL : url du chemin vers tinymce (le chemin par défaut est adapté pour une installation sous Debian avec le paquet tinymce installé) - * JQUERY_JS_URLS: liste des adresses des fichiers javascript jquery et + * JQUERY_JS_URLS : liste des adresses des fichiers javascript jquery et jquery-ui (les valeurs par défaut sont appropriées pour une installation sous Debian avec les paquets libjs-jquery et libjs-jquery-ui installés) - * JQUERY_CSS_URLS: liste des adresses des fichiers CSS jquery et + * JQUERY_CSS_URLS : liste des adresses des fichiers CSS jquery et jquery-ui (les valeurs par défaut sont appropriées pour une installation sous Debian avec les paquets libjs-jquery et libjs-jquery-ui installés) - * GPSBABEL: chemin de gpsbabel (la valeur par défaut est approprié pour + * GPSBABEL : chemin de gpsbabel (la valeur par défaut est appropriée pour une installation sous Debian avec le paquet gpsbabel installé) - * TIME_ZONE: fuseau horaire local de cette installation - * LANGUAGE_CODE: code de langage pour cette installation + * TIME_ZONE : fuseau horaire local de cette installation + * LANGUAGE_CODE : code de langage pour cette installation Gérez les permissions du dossier de média:: @@ -215,11 +216,11 @@ français, remplacez cela avec le code de langage approprié) :: django-admin compilemessages Si votre langage n'est pas disponible, n'hésitez pas à créer le fichier **po** -par défaut et de le proposer (les contributions sont bienvenues). +par défaut et à le proposer (les contributions sont bienvenues). La procédure est la suivante :: Il est d'abord nécessaire de créer le fichier po par défaut (bien sûr remplacez -**fr** par le langage que vous souhaitez créer) :: +**fr** [pour français] par le code du langage que vous souhaitez créer) :: django-admin makemessages -l fr @@ -228,7 +229,7 @@ Il doit y avoir maintenant un fichier *django.po* dans le répertoire traduction. Maintenant que votre fichier de traduction est complété, il suffit de le -compléter de la même manière que vous l'auriez fait si ce fichier était +compiler de la même manière que vous l'auriez fait si ce fichier était initialement disponible. Initialisation de la base de données diff --git a/docs/import_export.rst b/docs/import_export.rst index e8d283b..eb581ce 100644 --- a/docs/import_export.rst +++ b/docs/import_export.rst @@ -16,16 +16,19 @@ It has been updated for version 2.0.0. Importing --------- -In Chimère the import mechanism is based on **Import object**. Theses objects +In Chimère the import mechanism is based on **Import object**. These objects are stored in database to keep trace of imports and to facilitate the re-importation from the same source. In fact if possible the update of data from -a same type of source is managed. The ability to do such updates depends on the -existence of a unique id for each object on your source. +a same type of source is managed. + +.. Note:: + The ability to do such updates depends on the existence of a unique id + for each object on your source. To add an **Import object** you need to go to *Chimere > Imports* then **Add**. After that you'll have to select your source type and then the form depends on -the type of source. +this source type. Common fields ************* @@ -35,7 +38,7 @@ Common fields associated category will be use. - **SRID**: Chimère will try to identify automatically the correct projection from the given source. But sometimes the information is not present or cannot - be guessed (for instance a Shapefile that uses non standard proj file). In + be guessed (for instance a shapefile that uses non standard proj file). In this case Chimère will use WGS84 by default (the classic latitude/longitude) but it is not always correct. If you experience problems with items localisation you should put here the SRID associated to the projection of @@ -60,7 +63,7 @@ KML import file. You'll have to fill one of the two fields. - **Filter**: if you want to import only a specific *Folder* of your KML file put his name on this field. -- **Zipped file**: if your source is a KMLZ file (a zipped KML) check this case. +- **Zipped file**: if your source is a KMLZ file (a zipped KML), check this case. Shapefile import **************** @@ -68,9 +71,9 @@ Shapefile import .. image:: _static/chimere_admin_import_shapefile.png -- **Web address/source file (mandatory)**: your KML could be distant or a local - file. You'll have to fill one of the two fields. -- **Zipped file**: only zipped shapefile are accepted this checkbox have to be +- **Web address/source file (mandatory)**: your shapefile could be distant or a + local file. You'll have to fill one of the two fields. +- **Zipped file**: only zipped shapefiles are accepted so this checkbox has to be checked. GeoRSS import @@ -85,12 +88,17 @@ Simple GeoRSS and W3C GeoRSS are managed. CSV import ********** -As the format of the CSV file managed by Chimère could vary depending on the -property you have add on your Chimère instance we recommend you to first do -an export of some items in CSV with Chimère. The CSV format of the exported -file will meet Chimère requirements. By the way because of the geometry of -the item this format is not very convenient to add new content but could -be handy to update informations. +The format of the CSV file (number and order of columns) managed by Chimère +varies depending on the properties you have added on your Chimère instance. +So we recommend you to first do an export of some items in CSV with Chimère. +The CSV format of the exported file will meet Chimère requirements. + +By the way because of the geometry of the item this format is not very +convenient to add new content but could be handy to update informations. + +.. Warning:: + If you mean to update existing data by this import, do *not* modify the + geometry column. .. image:: _static/chimere_admin_import_CSV.png @@ -104,11 +112,11 @@ OpenStreetMap import .. image:: _static/chimere_admin_import_OSM.png -To import from OSM Chimère uses the XAPI API of OSM. +To import from OSM Chimère use the XAPI API of OSM. - **Web address (mandatory)**: XAPI url used to import data. This field should be filled with a default address. By default the MapQuest server is used as it - seems to be the more robust. If you experience problems with OSM import check + seems to be the more robust. If you experience problems with OSM import, check the availability of the XAPI server used and eventually change it. - **Filter area (mandatory)**: draw the bounding box you want to use for your OSM import. @@ -123,18 +131,18 @@ To import from OSM Chimère uses the XAPI API of OSM. Importing ********* -Once your new import item created. Select it in the import object list, select -the **Import** action and validated. +Once your new import item created, select it in the import object list, choose +the **Import** action and validate. -The import should be processing normally. If not an explicit error message -should be print in the state column of your import. +The import should be processing normally. If not, an explicit error message +should be printed in the state column of your import. Managing imported data ********************** All new imported items have the state **Imported**. To make them available on -the map you'll have to validate them. If you don't want an item to be visible on -the map instead of delete them it is recommended to set them to the state +the map you'll have to validate them. If you don't want some items to be visible on +the map, instead of deleting them it is recommended to set them to the state **Disabled**. .. Warning:: @@ -148,7 +156,7 @@ Export to CSV/KML/Shapefile *************************** Directly from the :ref:`geographic items list ` you -can export to the choose format. All you have to do is to select the desired +can export to the chosen format. All you have to do is to select the desired items, choose the appropriate action in the action list and validate. Export to OSM @@ -156,19 +164,19 @@ Export to OSM .. Warning:: If you are not sure of what you are doing with OSM export: don't do it! It is - really important to not mess with others data. + really important to not mess with others' data. .. Note:: Only export of OSM nodes are managed. OSM export is not that easily managed. First (if not yet done) you'll have to -define an import (:ref:`see above ` for details). This will permit +define an import (:ref:`see above ` for details). This will enable to determine: - the area concerned by your export. - the key/value tag to append to your new/updated items. - the subcategories concerned by your export. If you think that some items in - theses subcategories should not be in OSM database (because there are not + these subcategories should not be in OSM database (because there are not relevant or because of license issues) beforehand mark them as **Not for OSM** in the *import fields* of the :ref:`geographic items forms `. @@ -176,23 +184,23 @@ to determine: The OSM export in Chimère is designed to be the more preservative possible in regards to OSM database. That's why before any export an import is done. If -the new import has updated data theses new data will overload data in your +the new import has updated data, these new data will overload data in your Chimère (if you don't want that: don't do export). All pending imported items should have been treated before doing an export. To launch an export select the appropriate Import object in the imports list. Then select the **Export to OSM** action and validate. Then you'll be asked for your OSM username and password and the API you want to -use. If you use regularly Chimère to do export it is recommended to create an +use. If you regularly use Chimère to do export, it is recommended to create an OSM specific account for that. The test API is available to make export test. If you want to use the test API you'll have to create a specific account on the test platform. .. Warning:: - The data on the test platform are not synced with the main platform you are - not going to have the same data that you got with XAPI. + The data on the test platform are not synced with the main platform. You won't + have the same data than the ones you got with XAPI. -Once all this field filled you can (finally!) launch the export. +Once all this field filled, you can (finally!) launch the export. When exporting tags are automatically added/updated: diff --git a/docs/install.rst b/docs/install.rst index 9a5af1f..b68b365 100644 --- a/docs/install.rst +++ b/docs/install.rst @@ -138,15 +138,15 @@ Another solution is to get it from the git repository:: Create a custom project template ******************************** -There a default project provided *example_project*. Copy and modify it (or -get another project based on Chimère):: +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 +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. diff --git a/docs/upgrade.rst b/docs/upgrade.rst index d7c7233..e292235 100644 --- a/docs/upgrade.rst +++ b/docs/upgrade.rst @@ -8,6 +8,8 @@ Upgrade :date: 2012-10-08 :Copyright: CC-BY 3.0 +This document presents the upgrade of Chimère. +It has been updated for version 2.0.0. Before any upgrade backup the database and all your installation files (specially if you have made changes to them). -- cgit v1.2.3 From 43ff3b958fe3f60d48fc92d2fc2e42789cdccf5f Mon Sep 17 00:00:00 2001 From: Étienne Loks Date: Fri, 30 Nov 2012 00:27:24 +0100 Subject: Documentation: integration of Nawa's remarks --- docs/fr/install.rst | 9 +++++---- docs/install.rst | 8 ++++---- requirements.txt | 1 - 3 files changed, 9 insertions(+), 9 deletions(-) (limited to 'docs/fr/install.rst') diff --git a/docs/fr/install.rst b/docs/fr/install.rst index 404cf4c..9c72af0 100644 --- a/docs/fr/install.rst +++ b/docs/fr/install.rst @@ -26,7 +26,6 @@ Pré-requis - `Beautiful Soup `_ - python-simplejson - python-gdal - - `unidecode `_ - `lxml `_ - `jquery `_ version 1.7.1 or better - `jquery-ui `_ @@ -56,7 +55,7 @@ pour Debian Wheezy:: python-pyexiv2 python-beautifulsoup python-simplejson python-gdal \ javascript-common python-lxml libjs-jquery libjs-jquery-ui \ python-feedparser libgeos-3.3.3 proj-bin postgresql-9.1-postgis \ - gdal-bin tinymce gpsbabel python-django-celery \ + gdal-bin tinymce gpsbabel python-django-celery Pour Debian Squeeze (il est nécessaire d'activer les backports):: @@ -67,7 +66,9 @@ Pour Debian Squeeze (il est nécessaire d'activer les backports):: python-pyexiv2 python-beautifulsoup python-simplejson python-gdal \ javascript-common python-lxml libjs-jquery libjs-jquery-ui \ python-feedparser libgeos-3.2.0 proj-bin postgresql-8.4-postgis \ - gdal-bin tinymce gpsbabel \ + gdal-bin tinymce gpsbabel + +Le paquet *python-django-celery* n'existe pas pour Debian Squeeze. Si ces paquets n'ont pas d'équivalents sur les dépôts de votre distribution Linux, référez vous aux sites web de ces applications. @@ -213,7 +214,7 @@ Pour faire cela, il faut lancer la commande suivante (ici, **fr** est pour le français, remplacez cela avec le code de langage approprié) :: cd $INSTALL_PATH/chimere/chimere/ - django-admin compilemessages + django-admin compilemessages -l fr Si votre langage n'est pas disponible, n'hésitez pas à créer le fichier **po** par défaut et à le proposer (les contributions sont bienvenues). diff --git a/docs/install.rst b/docs/install.rst index 248ece9..f26da83 100644 --- a/docs/install.rst +++ b/docs/install.rst @@ -26,7 +26,6 @@ Prerequisites - `Beautiful Soup `_ - python-simplejson - python-gdal - - `unidecode `_ - `lxml `_ - `jquery `_ version 1.7.1 or better - `jquery-ui `_ @@ -56,7 +55,7 @@ Linux distribution repositories. For instance on Debian Wheezy:: python-pyexiv2 python-beautifulsoup python-simplejson python-gdal \ javascript-common python-lxml libjs-jquery libjs-jquery-ui \ python-feedparser libgeos-3.3.3 proj-bin postgresql-9.1-postgis \ - gdal-bin tinymce gpsbabel python-django-celery \ + gdal-bin tinymce gpsbabel python-django-celery On Debian Squeeze (you need to activate backports):: @@ -68,8 +67,9 @@ On Debian Squeeze (you need to activate backports):: python-pyexiv2 python-beautifulsoup python-simplejson python-gdal \ javascript-common python-lxml libjs-jquery libjs-jquery-ui \ python-feedparser libgeos-3.2.0 proj-bin postgresql-8.4-postgis \ - gdal-bin tinymce gpsbabel \ + gdal-bin tinymce gpsbabel +The package *python-django-celery* doesn't exist for Debian Squeeze. If these packages do not exist in your distribution's repository, please refer to the applications' websites. @@ -209,7 +209,7 @@ 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 + django-admin compilemessages -l fr If your language is not available, feel free to create the default po file and to submit it, contributions are well appreciated. Procedure is as follows: diff --git a/requirements.txt b/requirements.txt index b7d71a1..f458f31 100644 --- a/requirements.txt +++ b/requirements.txt @@ -5,7 +5,6 @@ pil lxml south==0.7.3 simplejson -unidecode feedparser django-extensions django-tinymce -- cgit v1.2.3 From 384a6157afe3172f7e42dd2ffb0dd22c2f939b2e Mon Sep 17 00:00:00 2001 From: Nawa Date: Fri, 30 Nov 2012 17:21:22 +0100 Subject: Documentation: new corrections, mainly on the french pages --- docs/fr/administration.rst | 10 +- docs/fr/customisation.rst | 8 +- docs/fr/import_export.rst | 233 +++++++++++++++++++++++++++++++++++++++++++++ docs/fr/install.rst | 86 ++++++++--------- docs/fr/upgrade.rst | 2 +- docs/import_export.rst | 2 +- docs/install.rst | 36 +++---- 7 files changed, 305 insertions(+), 72 deletions(-) create mode 100644 docs/fr/import_export.rst (limited to 'docs/fr/install.rst') diff --git a/docs/fr/administration.rst b/docs/fr/administration.rst index afd2b74..d4fb145 100644 --- a/docs/fr/administration.rst +++ b/docs/fr/administration.rst @@ -18,7 +18,7 @@ Présentation des pages d'administration Les pages d'administration sont accessible à l'adresse : http://where_is_your_chimere/admin/ -N'oubliez pas la barre oblique à la fin de l'adresse. +N'oubliez pas la barre oblique (slash) à la fin de l'adresse. Identification ************** @@ -32,17 +32,17 @@ passe fourni. Page principale *************** -Une fois identifié vous avez accès à la page principale d'administration. +Une fois identifié, vous avez accès à la page principale d'administration. Cela s'affiche ainsi : .. image:: _static/chimere_admin_01.png #. lien vers cette **Documentation**, vers le formulaire de **Changement de mot - de passe** et la déconnexion. -#. la liste des actions récemment faites avec ce compte + de passe** et la déconnexion ; +#. la liste des actions récemment faites avec ce compte ; #. un titre d'application, la plupart des actions vont se faire dans - l'application **Chimere**. + l'application **Chimere** ; #. un élément à l'intérieur de l'application. Depuis ces pages, vous pouvez *Ajouter* un nouvel élément ou consulter/**Changer** des éléments. Le lien **Ajouter** conduit au `Formulaire des éléments`_. Le lien **Modifier** diff --git a/docs/fr/customisation.rst b/docs/fr/customisation.rst index 7d00432..498cfad 100644 --- a/docs/fr/customisation.rst +++ b/docs/fr/customisation.rst @@ -8,7 +8,7 @@ Customisation :date: 2012-11-29 :Copyright: CC-BY 3.0 -Ce document présente l'installation de Chimère. +Ce document présente la personnalisation de Chimère. Ce document a été mis à jour pour la version 2.0.0 de Chimère. .. _managing-layers: @@ -22,7 +22,7 @@ en utilisant les pages d'administration de Chimère. Le nouveau calque est défini en utilisant une chaîne de code Javascript adéquate de la bibliothèque `Openlayers `_. Ce code Javascript -dois être une instance de *Openlayers Layer* sans point virgule final. +doit être une instance de *Openlayers Layer*, sans point virgule final. Par exemple définir un calque Bing peut être fait avec un code de ce type :: @@ -42,10 +42,10 @@ Personnaliser l'agencement et le design Si vous souhaitez simplement améliorer la feuille de style CSS, le plus simple est d'ajouter un lien vers une feuille de style supplémentaire dans vos *Zones* -cf. :ref:`managing-areas`. +(cf. :ref:`managing-areas`). Si vous souhaitez faire des changements plus importants dans l'agencement et la -présentation le (bien nommé) *example_project* peut être personnalisé pour +présentation le projet *example_project* peut être personnalisé pour correspondre à vos besoins. Chaque fichier de patron de page présent dans le dossier *chimere/templates* peut être copié dans votre dossier *monprojet/templates* puis modifié. diff --git a/docs/fr/import_export.rst b/docs/fr/import_export.rst new file mode 100644 index 0000000..eac21af --- /dev/null +++ b/docs/fr/import_export.rst @@ -0,0 +1,233 @@ +.. -*- coding: utf-8 -*- + +============= +Import/export +============= + +:Author: Étienne Loks +:date: 2012-11-28 +:Copyright: CC-BY 3.0 + +Ce document présente les fonctions d'import et d'export de Chimère. +Ce document a été mis à jour pour la version 2.0.0 de Chimère. + +.. _importing: + +Import +------ + +Dans Chimère, le mécanisme d'import est basé sur **Import object**. Ces objets sont +stockés dans une base de données pour garder trace des imports et pour faciliter la +ré-importation depuis une même source. En fait, si cela est possible, la mise à jour +de données depuis un même type de source est gérée, de préférence à une ré-importation. + +.. Note:: + La possibilité de réaliser de telles mises à jour est conditionnée à l'existence + d'une id unique pour chaque objet de la source. + +Pour ajouter un **Import object**, vous devez aller dans *Chimere > Imports* puis **Ajouter**. + +Après cela, vous aurez à sélectionner votre type de source. Le formulaire suivant dépend de +ce type de source. + +Champs communs à tous les types de source +***************************************** + +- **Name by default**: if no name can be identified to the newly imported object + this is the name that will be used. If this field is empty the name of the + associated category will be use. +- **SRID**: Chimère will try to identify automatically the correct projection + from the given source. But sometimes the information is not present or cannot + be guessed (for instance a shapefile that uses non standard proj file). In + this case Chimère will use WGS84 by default (the classic latitude/longitude) + but it is not always correct. If you experience problems with items + localisation you should put here the SRID associated to the projection of + your source. +- **Origin**: if not null this field will be associated to each item imported in + order to easily identify where the item came from. For OSM import the source + is automatically added. +- **License**: if not null this field will be associated to each item imported in + order to easily identify the license associated to the item. For OSM import + the license is automatically added. +- **Associated subcategories (mandatory)**: The selected subcategories will be + associated to newly imported items. + + +KML import +********** + +.. image:: _static/chimere_admin_import_KML.png + + +- **Web address/source file (mandatory)**: your KML could be distant or a local + file. You'll have to fill one of the two fields. +- **Filter**: if you want to import only a specific *Folder* of your KML file + put his name on this field. +- **Zipped file**: if your source is a KMLZ file (a zipped KML), check this case. + +Shapefile import +**************** + +.. image:: _static/chimere_admin_import_shapefile.png + + +- **Web address/source file (mandatory)**: your shapefile could be distant or a + local file. You'll have to fill one of the two fields. +- **Zipped file**: only zipped shapefiles are accepted so this checkbox has to be + checked. + +GeoRSS import +************* + +Simple GeoRSS and W3C GeoRSS are managed. + +.. image:: _static/chimere_admin_import_georss.png + +- **Web address (mandatory)**: only distant GeoRSS are managed. + +CSV import +********** + +The format of the CSV file (number and order of columns) managed by Chimère +varies depending on the properties you have added on your Chimère instance. +So we recommend you to first do an export of some items in CSV with Chimère. +The CSV format of the exported file will meet Chimère requirements. + +By the way because of the geometry of the item this format is not very +convenient to add new content but could be handy to update informations. + +.. Warning:: + If you mean to update existing data by this import, do *not* modify the + geometry column. + +.. image:: _static/chimere_admin_import_CSV.png + +- **Web address/source file (mandatory)**: your CSV file could be distant or a + local file. You'll have to fill one of the two fields. + +.. _osm-import: + +OpenStreetMap import +******************** + +.. image:: _static/chimere_admin_import_OSM.png + +To import from OSM Chimère use the XAPI API of OSM. + +- **Web address (mandatory)**: XAPI url used to import data. This field should + be filled with a default address. By default the MapQuest server is used as it + seems to be the more robust. If you experience problems with OSM import, check + the availability of the XAPI server used and eventually change it. +- **Filter area (mandatory)**: draw the bounding box you want to use for your + OSM import. +- **Filter type (mandatory)**: choose if you want to import way or nodes. +- **Filter tag (mandatory)**: choose the OSM key/value couple used to filter OSM + data. A link to the `OSM Map features page + `_ is provided to help you + find appropriate values. +- **Refresh button**: this button convert your choices to appropriate XAPI args. + You have to hit this button before validating the form. + +Importing +********* + +Once your new import item created, select it in the import object list, choose +the **Import** action and validate. + +The import should be processing normally. If not, an explicit error message +should be printed in the state column of your import. + +You can also launch imports with the CLI (ideal for crontab jobs). In the +project directory you only need to launch the command:: + + ./manage.py chimere_import + +- *import_id* is the import ID + +If you launch the command without *import_id* the list of imports available is +presented and you can choose one. + +Managing imported data +********************** + +All new imported items have the state **Imported**. To make them available on +the map you'll have to validate them. If you don't want some items to be visible on +the map, instead of deleting them it is recommended to set them to the state +**Disabled**. + +.. Warning:: + Be careful with duplicates between your existing data and imported data. This + is particularly important if you want to export your data to OSM. + +Exporting +--------- + +Export to CSV/KML/Shapefile +*************************** + +Directly from the :ref:`geographic items list ` you +can export to the chosen format. All you have to do is to select the desired +items, choose the appropriate action in the action list and validate. + +You can also launch exports with the CLI (ideal for crontab jobs). In the +project directory you only need to launch the command:: + + ./manage.py chimere_export \ + + +- *subcategory_id* is the ID of the chosen subcategory +- *CSV|KML|SHP* is the chosen format +- *marker|route* is to get marker or route +- *filename* is the output filename + +If you launch the command without arguments you will be prompted for the choice +to make for your export. + + +Export to OSM +************* + +.. Warning:: + If you are not sure of what you are doing with OSM export: don't do it! It is + really important to not mess with others' data. + +.. Note:: + Only export of OSM nodes are managed. + +OSM export is not that easily managed. First (if not yet done) you'll have to +define an import (:ref:`see above ` for details). This will enable +to determine: + +- the area concerned by your export. +- the key/value tag to append to your new/updated items. +- the subcategories concerned by your export. If you think that some items in + these subcategories should not be in OSM database (because there are not + relevant or because of license issues) beforehand mark them as **Not for OSM** + in the *import fields* of the :ref:`geographic items forms + `. + + +The OSM export in Chimère is designed to be the more preservative possible in +regards to OSM database. That's why before any export an import is done. If +the new import has updated data, these new data will overload data in your +Chimère (if you don't want that: don't do export). All pending imported items +should have been treated before doing an export. + +To launch an export select the appropriate Import object in the imports list. +Then select the **Export to OSM** action and validate. +Then you'll be asked for your OSM username and password and the API you want to +use. If you regularly use Chimère to do export, it is recommended to create an +OSM specific account for that. +The test API is available to make export test. If you want to use the test +API you'll have to create a specific account on the test platform. + +.. Warning:: + The data on the test platform are not synced with the main platform. You won't + have the same data than the ones you got with XAPI. + +Once all this field filled, you can (finally!) launch the export. + +When exporting tags are automatically added/updated: + +- *name*: get from the item name in Chimère. +- *source*: to identify Chimère as a source. diff --git a/docs/fr/install.rst b/docs/fr/install.rst index 9c72af0..d9acaa8 100644 --- a/docs/fr/install.rst +++ b/docs/fr/install.rst @@ -5,7 +5,7 @@ Installation ============ :Auteur: Étienne Loks -:date: 2012-10-08 +:date: 2012-11-28 :Copyright: CC-BY 3.0 Ce document présente l'installation de Chimère. @@ -14,25 +14,25 @@ Il a été mis à jour pour la version 2.0.0 de Chimère. Pré-requis ********* - - `apache `_ version 2.x - - `python `_ versions 2.6 ou 2.7 - - `django `_ >= version 1.4 - - `south `_ - - `postgres `_ >= version 8.x - - `gettext `_ - - `psycopg2 `_ + - `Apache `_ version 2.x + - `Python `_ versions 2.6 ou 2.7 + - `Django `_ >= version 1.4 + - `South `_ + - `Postgres `_ >= version 8.x + - `Gettext `_ + - `Psycopg2 `_ - `Python Imaging Library `_ - - `pyexiv2 `_ + - `Pyexiv2 `_ - `Beautiful Soup `_ - python-simplejson - python-gdal - - `lxml `_ - - `jquery `_ version 1.7.1 or better - - `jquery-ui `_ + - `Lxml `_ + - `Jquery `_ version 1.7.1 or better + - `Jquery-ui `_ - `Universal Feed Parser `_ -geodjango fait partie de Django depuis la version 1.0 mas nécessite quelques -dépendances supplémentaires.:: +geodjango fait partie de Django depuis la version 1.0 mais nécessite quelques +dépendances supplémentaires : - `geos `_ 3.0.x - `proj.4 `_ 4.4 to 4.6 @@ -40,7 +40,7 @@ dépendances supplémentaires.:: - `gdal `_ -Optionnel (mais recommandé): +Optionnel (mais recommandé) : - `tinymce `_ - `gpsbabel `_ @@ -48,36 +48,36 @@ Optionnel (mais recommandé): La manière la plus simple de satisfaire à ces pré-prequis est de les installer par le biais des dépôts de votre distribution Linux préférée. Par exemple -pour Debian Wheezy:: +pour Debian Wheezy :: apt-get install apache2 python python-django python-django-south \ postgresql-9.1 gettext python-psycopg2 python-imaging \ python-pyexiv2 python-beautifulsoup python-simplejson python-gdal \ - javascript-common python-lxml libjs-jquery libjs-jquery-ui \ - python-feedparser libgeos-3.3.3 proj-bin postgresql-9.1-postgis \ - gdal-bin tinymce gpsbabel python-django-celery + python-lxml libjs-jquery libjs-jquery-ui python-feedparser \ + libgeos-3.3.3 proj-bin postgresql-9.1-postgis gdal-bin \ + tinymce gpsbabel python-django-celery javascript-common -Pour Debian Squeeze (il est nécessaire d'activer les backports):: +Pour Debian Squeeze (il est nécessaire d'activer les backports) :: apt-get install -t squeeze-backports python-django libjs-jquery apt-get install apache2 python python-django python-django-south \ postgresql-8.4 gettext python-psycopg2 python-imaging \ python-pyexiv2 python-beautifulsoup python-simplejson python-gdal \ - javascript-common python-lxml libjs-jquery libjs-jquery-ui \ - python-feedparser libgeos-3.2.0 proj-bin postgresql-8.4-postgis \ - gdal-bin tinymce gpsbabel + python-lxml libjs-jquery libjs-jquery-ui python-feedparser \ + libgeos-3.2.0 proj-bin postgresql-8.4-postgis gdal-bin \ + tinymce gpsbabel javascript-common Le paquet *python-django-celery* n'existe pas pour Debian Squeeze. -Si ces paquets n'ont pas d'équivalents sur les dépôts de votre distribution -Linux, référez vous aux sites web de ces applications. +Si ces paquets n'ont pas d'équivalents dans les dépôts de votre distribution +Linux, référez-vous aux sites web de ces applications. Configuration de la base de données *********************************** Maintenant que postgres et postgis sont installés, vous avez besoin de créer -un nouvel utilisateur pour Chimère:: +un nouvel utilisateur pour Chimère :: su postgres createuser --echo --adduser --createdb --encrypted --pwprompt chimere-user @@ -94,7 +94,7 @@ géographiques (adaptez les chemins par rapport à vos besoins):: Installer les sources ********************* -Choisissez un chemin où installer Chimère:: +Choisissez un chemin où installer Chimère :: INSTALL_PATH=/var/local/django mkdir $INSTALL_PATH @@ -123,10 +123,10 @@ par l'utilisateur de votre serveur web (www-data pour Debian).:: tar xvjf chimere-last.tar.bz2 chown -R myusername:www-data chimere -Depuis le dépôt git +Depuis le dépôt Git +++++++++++++++++++ -Une autre solution est d'obtenir les sources depuis le dépôt Git:: +Une autre solution est d'obtenir les sources depuis le dépôt Git :: cd $INSTALL_PATH git clone git://www.peacefrogs.net/git/chimere @@ -139,7 +139,7 @@ Créez un patron pour votre projet ********************************* Il y a un exemple de projet fourni (*example_project*). Copiez-le et -modifiez-le (ou utilisez un autre projet basé sur Chimère):: +modifiez-le (ou utilisez un autre projet basé sur Chimère) :: cd $INSTALL_PATH/chimere cp -ra example_project mychimere_project @@ -171,7 +171,7 @@ minimum). La plupart de ces paramétrages sont initialisés dans le fichier Django. Cette clé est utilisée pour les signatures cryptographiques de l'application et doit être initialisée à une valeur unique et non devinable. **Modifiez-là !** - * ROOT_URLCONF : module python de configuration des urls pour votre projet. + * ROOT_URLCONF : module Python de configuration des urls pour votre projet. quelque chose comme : 'mychimere_project.urls' * EMAIL_HOST : SMTP du serveur de courriel pour envoyer des courriels * TINYMCE_URL : url du chemin vers tinymce (le chemin par défaut est adapté @@ -187,20 +187,20 @@ minimum). La plupart de ces paramétrages sont initialisés dans le fichier * TIME_ZONE : fuseau horaire local de cette installation * LANGUAGE_CODE : code de langage pour cette installation -Gérez les permissions du dossier de média:: +Gérez les permissions du dossier de média :: cd $INSTALL_PATH/chimere/mychimere_project chown -R user:www-data media chmod -R g+w media -Créez le fichier de log:: +Créez le fichier de log :: mkdir /var/log/django touch /var/log/django/chimere.log chown -R root:www-data /var/log/django/ chmod -R g+w /var/log/django/ -Regroupez les fichiers static dans un seul répertoire:: +Regroupez les fichiers static dans un seul répertoire :: cd $INSTALL_PATH/chimere/mychimere_project ./manage.py collectstatic @@ -221,12 +221,12 @@ par défaut et à le proposer (les contributions sont bienvenues). La procédure est la suivante :: Il est d'abord nécessaire de créer le fichier po par défaut (bien sûr remplacez -**fr** [pour français] par le code du langage que vous souhaitez créer) :: +**fr** par le code du langage que vous souhaitez créer) :: django-admin makemessages -l fr Il doit y avoir maintenant un fichier *django.po* dans le répertoire -*locale/fr/LC_MESSAGES*. Ensuite il est nécessaire de le compléter avec votre +*locale/fr/LC_MESSAGES*. Ensuite il faut le compléter avec votre traduction. Maintenant que votre fichier de traduction est complété, il suffit de le @@ -237,7 +237,7 @@ Initialisation de la base de données ************************************ Créez les tables de la base de données (toujours dans le répertoire de votre -projet):: +projet) :: cd $INSTALL_PATH/chimere/mychimere_project ./manage.py syncdb @@ -246,7 +246,7 @@ projet):: Vous aurez à rentrer les informations pour la création du compte administrateur (les pages d'administration se trouvent à l'adresse : http://where_is_chimere/admin/). Ensuite pour créer les tables de la base de -données gérés par Django-South :: +données gérées par Django-South :: ./manage.py migrate @@ -263,7 +263,7 @@ Configuration du serveur web Configuration d'Apache avec mod_wsgi ++++++++++++++++++++++++++++++++++++ -Installez *mod_wsgi* pour Apache:: +Installez *mod_wsgi* pour Apache :: apt-get install libapache2-mod-wsgi @@ -276,21 +276,21 @@ Créez et éditez la configuration de Chimère en fonction de votre installation cp $INSTALL_PATH/chimere/apache/apache-wsgi.conf \ /etc/apache2/sites-available/chimere vim /etc/apache2/sites-available/chimere - # create log dir + # créer le répertoire des logs mkdir /var/log/apache2/chimere/ chown www-data /var/log/apache2/chimere/ Adaptez les fichiers *mydjango.wsgi* (avec le chemin correct *sys* des -bibliothèques python de Chimère et le nom correct pour le module) et le fichier +bibliothèques Python de Chimère et le nom correct pour le module) et le fichier *chimere* de Apache (avec le nom de serveur correct et les chemins corrects). -Pour activer le site web rechargez Apache :: +Pour activer le site web, rechargez Apache :: a2ensite chimere /etc/init.d/apache2 reload Si vous avez des problèmes de dépôt de fichier avec des caractères Unicode dans -leurs noms activez la locale appropriée dans Apache. Sur un serveur Debian avec +leurs noms, activez la locale appropriée dans Apache. Sur un serveur Debian avec UTF-8 comme codage par défaut, dans le fichier */etc/apache2/envvars* décommentez la ligne suivante :: diff --git a/docs/fr/upgrade.rst b/docs/fr/upgrade.rst index 19d4c1d..38424ff 100644 --- a/docs/fr/upgrade.rst +++ b/docs/fr/upgrade.rst @@ -241,7 +241,7 @@ to backup your database. You can also make a copy of your current database into a new database and make the new installation to this new database. -The gdal binding for python is necessary to run the upgrade scripts (available +The gdal binding for Python is necessary to run the upgrade scripts (available in the python-gdal package in Debian). If you run the migration scripts in a production environnement stop the old diff --git a/docs/import_export.rst b/docs/import_export.rst index bc422b1..1032804 100644 --- a/docs/import_export.rst +++ b/docs/import_export.rst @@ -8,7 +8,7 @@ Import/export :date: 2012-11-28 :Copyright: CC-BY 3.0 -This document presents the administration of Chimère. +This document presents the import/export functionnalities of Chimère. It has been updated for version 2.0.0. .. _importing: diff --git a/docs/install.rst b/docs/install.rst index 3b8fd38..ea27efc 100644 --- a/docs/install.rst +++ b/docs/install.rst @@ -5,7 +5,7 @@ Installation ============ :Author: Étienne Loks -:date: 2012-10-08 +:date: 2012-11-28 :Copyright: CC-BY 3.0 This document presents the installation of Chimère. @@ -14,21 +14,21 @@ It has been updated for version 2.0.0. Prerequisites ************* - - `apache `_ version 2.x - - `python `_ versions 2.6 or 2.7 - - `django `_ >= version 1.4 - - `south `_ - - `postgres `_ >= version 8.x - - `gettext `_ - - `psycopg2 `_ + - `Apache `_ version 2.x + - `Python `_ versions 2.6 or 2.7 + - `Django `_ >= version 1.4 + - `South `_ + - `Postgres `_ >= version 8.x + - `Gettext `_ + - `Psycopg2 `_ - `Python Imaging Library `_ - - `pyexiv2 `_ + - `Pyexiv2 `_ - `Beautiful Soup `_ - python-simplejson - python-gdal - - `lxml `_ - - `jquery `_ version 1.7.1 or better - - `jquery-ui `_ + - `Lxml `_ + - `Jquery `_ version 1.7.1 or better + - `Jquery-ui `_ - `Universal Feed Parser `_ geodjango is a part of django since version 1.0 but it has some specific @@ -53,9 +53,9 @@ Linux distribution repositories. For instance on Debian Wheezy:: apt-get install apache2 python python-django python-django-south \ postgresql-9.1 gettext python-psycopg2 python-imaging \ python-pyexiv2 python-beautifulsoup python-simplejson python-gdal \ - javascript-common python-lxml libjs-jquery libjs-jquery-ui \ - python-feedparser libgeos-3.3.3 proj-bin postgresql-9.1-postgis \ - gdal-bin tinymce gpsbabel python-django-celery + python-lxml libjs-jquery libjs-jquery-ui python-feedparser \ + libgeos-3.3.3 proj-bin postgresql-9.1-postgis gdal-bin \ + tinymce gpsbabel python-django-celery javascript-common On Debian Squeeze (you need to activate backports):: @@ -65,9 +65,9 @@ On Debian Squeeze (you need to activate backports):: apt-get install apache2 python python-django python-django-south \ postgresql-8.4 gettext python-psycopg2 python-imaging \ python-pyexiv2 python-beautifulsoup python-simplejson python-gdal \ - javascript-common python-lxml libjs-jquery libjs-jquery-ui \ - python-feedparser libgeos-3.2.0 proj-bin postgresql-8.4-postgis \ - gdal-bin tinymce gpsbabel + python-lxml libjs-jquery libjs-jquery-ui python-feedparser \ + libgeos-3.2.0 proj-bin postgresql-8.4-postgis gdal-bin \ + tinymce gpsbabel javascript-common The package *python-django-celery* doesn't exist for Debian Squeeze. -- cgit v1.2.3 From fff82d3ba66485fdfc58297507ae1438bc9996ab Mon Sep 17 00:00:00 2001 From: Étienne Loks Date: Thu, 6 Dec 2012 20:57:18 +0100 Subject: Documentation: syntax fix --- docs/fr/install.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'docs/fr/install.rst') diff --git a/docs/fr/install.rst b/docs/fr/install.rst index d9acaa8..2788d72 100644 --- a/docs/fr/install.rst +++ b/docs/fr/install.rst @@ -12,7 +12,7 @@ Ce document présente l'installation de Chimère. Il a été mis à jour pour la version 2.0.0 de Chimère. Pré-requis -********* +********** - `Apache `_ version 2.x - `Python `_ versions 2.6 ou 2.7 @@ -163,7 +163,7 @@ minimum). La plupart de ces paramétrages sont initialisés dans le fichier cp local_settings.py.sample local_settings.py vim local_settings.py -:Fields: +:Champs: * DATABASES : paramètres relatifs à la base de données * PROJECT_NAME : nom du projet @@ -218,7 +218,7 @@ français, remplacez cela avec le code de langage approprié) :: Si votre langage n'est pas disponible, n'hésitez pas à créer le fichier **po** par défaut et à le proposer (les contributions sont bienvenues). -La procédure est la suivante :: +La procédure est la suivante : Il est d'abord nécessaire de créer le fichier po par défaut (bien sûr remplacez **fr** par le code du langage que vous souhaitez créer) :: -- cgit v1.2.3 From 7c1505cd72f25d43584f0abb2e05e332976bbc26 Mon Sep 17 00:00:00 2001 From: Étienne Loks Date: Mon, 10 Dec 2012 01:12:43 +0100 Subject: Documentation: french doc corrections --- docs/en/import_export.rst | 7 +++-- docs/fr/administration.rst | 54 +++++++++++++++++----------------- docs/fr/configuration.rst | 70 ++++++++++++++++++++++---------------------- docs/fr/customisation.rst | 10 +++---- docs/fr/import_export.rst | 47 ++++++++++++++--------------- docs/fr/install.rst | 52 ++++++++++++++++----------------- docs/fr/upgrade.rst | 73 +++++++++++++++++++++++----------------------- 7 files changed, 158 insertions(+), 155 deletions(-) (limited to 'docs/fr/install.rst') diff --git a/docs/en/import_export.rst b/docs/en/import_export.rst index 79a13bb..cbbff70 100644 --- a/docs/en/import_export.rst +++ b/docs/en/import_export.rst @@ -153,6 +153,8 @@ project directory you only need to launch the command:: If you launch the command without *import_id* the list of imports available is presented and you can choose one. +.. _manage-imported-data: + Managing imported data ********************** @@ -216,9 +218,8 @@ to determine: The OSM export in Chimère is designed to be the more preservative possible in regards to OSM database. That's why before any export an import is done. If -the new import has updated data, these new data will overload data in your -Chimère (if you don't want that: don't do re-imports so dont do exports). All -pending imported items should have been treated before doing an export. +the new import has updated data, treat them before doing an export (cf `manage +imported data `). To launch an export select the appropriate *Import* object in the imports list. Then select the **Export to OSM** action and validate. diff --git a/docs/fr/administration.rst b/docs/fr/administration.rst index e3f3992..d581986 100644 --- a/docs/fr/administration.rst +++ b/docs/fr/administration.rst @@ -15,7 +15,7 @@ Il a été mis à jour pour la version 2.0.0 de Chimère. Présentation des pages d'administration --------------------------------------- -Les pages d'administration sont accessible à l'adresse : +Les pages d'administration sont accessibles à l'adresse : http://where_is_your_chimere/admin/ N'oubliez pas la barre oblique (slash) à la fin de l'adresse. @@ -24,7 +24,7 @@ Identification ************** Tout d'abord vous avez à vous identifier avec l'identifiant et le mot de -passe fourni. +passe fournis. .. image:: static/chimere_admin_00.png @@ -57,14 +57,14 @@ Liste des éléments #. chemin dans le site d'administration. C'est un raccourci pratique pour revenir à la page principale. -#. lien pour créer un nouvel élément depuis la liste des éléments +#. lien pour créer un nouvel élément depuis la liste des éléments. #. recherche des éléments par mot (n'est pas disponible pour tous les types - d'éléments) + d'éléments). #. cette boite permet de filtrer les entrées actuelles avec des filtres (n'est pas disponible pour tous les types d'éléments) -#. les entêtes de cette table est cliquable. Cliquer sur une entête permet de - trier les éléments de manière ascendante et descendante. Un tri multi-entête - est possible (le nombre à droite de l'entête indique l'ordre de prise en +#. les en-têtes de cette table sont cliquables. Cliquer sur une en-tête permet + de trier les éléments de manière ascendante et descendante. Un tri multi-en-tête + est possible (le nombre à droite de l'en-tête indique l'ordre de prise en compte dans le tri). #. chaque élément peut être coché (pour lui appliquer une action) ou sélectionné (en cliquant sur la première colonne) pour voir son détail et éventuellement @@ -83,13 +83,13 @@ Formulaire des éléments #. pour certains éléments il y a des sous-éléments associés. Ces sous-éléments peuvent être modifiés directement dans ce formulaire. Lorsque plusieurs sous-éléments sont associés à un élément, ils peuvent être réagencés par - glissé-déposé. + glisser-déposer. #. le formulaire doit être validé par un de ces boutons. Ils parlent d'eux-même. États ***** -Les *États* sont des propriétés rattachés à chaque élément géographique dans +Les *États* sont des propriétés rattachées à chaque élément géographique dans Chimère. Pour administrer Chimère efficacement il est nécessaire de comprendre chacun de ces états. @@ -100,42 +100,42 @@ chacun de ces états. - **Modifié**: État d'une proposition de modification d'un élément par un utilisateur. - **Importé**: État d'un élément nouvellement importé. Les opérations d'import - et d'export nécessite que tous les élément avec l'état *importé* soient + et d'export nécessitent que tous les éléments avec l'état *importé* soient traités (validés, désactivés ou supprimés). Gestion des nouvelles --------------------- -Un système de nouvelle est disponible. +Un système de nouvelles est disponible. Tout ce que vous avez à faire est de cliquer sur le bouton *Ajouter* à côté de *Nouvelles*. Pour chaque nouvelle il est nécessaire de fournir un nom et un contenu. Le contenu peut contenir des balises HTML. La disponibilité est gérée avec une case à cocher. -Creation de catégories/sous-catégories +Création de catégories/sous-catégories -------------------------------------- Avant l'ajout de catégories, il est nécessaire de définir des icônes. Ces icônes -apparaissent sur la carte et sur la boite contenant les catégories sur la carte +apparaissent sur la carte et sur la boîte contenant les catégories sur la carte principale. Faites attention de bien redimensionner vos icônes. En effet les icônes vont -être présentés à leur taille réelle sur la carte. +être présentées à leur taille réelle sur la carte. Pour ajouter des icônes : cliquez sur le bouton **Ajout** à côté de *Icônes*. -Les catégories sont fait des conteneurs à sous-catégories. Il est juste +Les catégories sont en fait des conteneurs à sous-catégories. Il est juste nécessaire de fournir nom et ordre d'affichage. Pour ajouter des catégories : cliquez sur le bouton **Ajout** près des -catégories (cela devrait être clair maintenant, non ?). +catégories. Les champs concernant les sous-catégories sont : un nom, une icône, un ordre, un thème de couleur et un type d'élément. -La plupart des champs parlent d'eux-même. +La plupart des champs parlent d'eux-mêmes. Les thèmes de couleurs sont composés de plusieurs couleurs. -Les couleurs sont utilisés pour le tracé des trajets (si la sous-catégorie -contient des trajets). Si c'est une couleur de base cela peut être défini -par le nom en anglais (pare exemple *red* pour rouge, *blue* pour bleu, +Les couleurs sont utilisées pour le tracé des trajets (si la sous-catégorie +contient des trajets). Si c'est une couleur de base, cela peut être défini +par le nom en anglais (par exemple *red* pour rouge, *blue* pour bleu, *purple* pour violet) sinon vous pouvez donner le code couleur HTML RVB (par exemple *#9227c9*). Le type d'élément est le type d'élément que la sous-catégorie peut contenir : @@ -146,8 +146,8 @@ points d'intérêts, trajets ou les deux. Édition/modération des éléments ------------------------------- -L'étape de modération est relativement simple. Il fonctionne de la même manière -que ce soit avec les points d'intérêt ou les trajets. +L'étape de modération est relativement simple. Elle fonctionne de la même +manière avec les points d'intérêt ou avec les trajets. Le modérateur accède classiquement aux points d'intérêts (ou trajets) en cliquant sur leur nom dans la liste d'éléments. @@ -163,8 +163,8 @@ Il y a un certain nombre d'action disponible. C'est particulièrement utile pour garder des éléments que vous ne voulez pas voir apparaître sur la carte mais conserver en base de données. - **Gérer les éléments modifiés** pour gérer les propositions de modification - par les utilisateurs sur le site principal cf. to :ref:`managing-modified`. - Les éléments modifiés doivent ne peuvent être traités qu'un à la fois. + par les utilisateurs sur le site principal (cf. :ref:`managing-modified`). + Les éléments modifiés ne peuvent être traités qu'un par un. - **Export en...** pour exporter les éléments sélectionnés vers le format sélectionné. @@ -186,7 +186,7 @@ quelques champs supplémentaires. Les éléments multimédias sont listés à la fin du formulaire. Vous pouvez -librement ajouter, modifier, changer l'ordre (avec du glissé-déposé) de ces +librement ajouter, modifier, changer l'ordre (avec du glisser-déposer) de ces éléments. Si un élément n'est pas pertinent, le bouton **Supprimer** permet de le @@ -234,5 +234,5 @@ Ce formulaire est un tableau à 3 colonnes. l'élément de référence. .. Note:: - Pour rejeter toutes les modifications proposées, validez le formulaire avec - aucune case à cocher sélectionnée. + Pour rejeter toutes les modifications proposées, validez le formulaire sans + cocher aucune case. diff --git a/docs/fr/configuration.rst b/docs/fr/configuration.rst index cb3e3e3..f419a0d 100644 --- a/docs/fr/configuration.rst +++ b/docs/fr/configuration.rst @@ -11,8 +11,8 @@ Configuration Ce document présente l'installation de Chimère. Il a été mis à jour pour la version 2.0.0 de Chimère. -Votre session a à être initialisée avec ces variables d'environnements -en ligne de commande :: +Votre session doit être initialisée avec ces variables d'environnement +en ligne de commande : :: CHIMERE_PATH=/srv/chimere # changez avec votre répertoire d'installation CHIMERE_LOCALNAME=mychimere # changez avec le nom de votre projet @@ -26,7 +26,7 @@ La plupart de ces étapes sont faites dans les pages web d'administration. Si vous n'êtes pas familiarisé avec les pages d'administration de *type Django* vous pouvez dès maintenant regarder le premier paragraphe de -l':ref:`administration` où elle est présentée. +l':ref:`administration` où elles sont présentées. Pour accéder à ces pages vous avez à vous identifier avec un compte ayant pour état *équipe* ou *super-utilisateur*. @@ -38,11 +38,11 @@ Configurer le framework Sites Le framework *Sites* vous permet de servir le contenu pour différents domaines Internet. La plupart des installations serviront le contenu pour un seul domaine -mais ce domaine unique a à être configuré. +mais ce domaine unique doit être configuré. Pour cela allez dans les pages web d'administration *Sites > Sites*. Vous avez juste à changer *example.com* par votre nom de domaine. Si vous -oubliez de faire cela quelques fonctionnalités comme les flux RSS ne +oubliez de faire cela, quelques fonctionnalités comme les flux RSS ne fonctionneront pas correctement. .. _managing-areas: @@ -50,40 +50,40 @@ fonctionneront pas correctement. Gérer les zones --------------- -Une zone est la base de votre carte. Pour une zone il est définit : +Une zone est la base de votre carte. Pour une zone il est défini : * un nom : un libellé pour cette zone ; * une URN associée (*facultatif*) : le nom de la zone en tant que ressource Web. En pratique si la zone définie n'est pas celle par défaut, elle est utilisée à la fin de l'adresse Web de base pour pouvoir accéder à cette zone. Ce n'est pas obligatoire mais nécessaire en pratique pour chaque zone qui - n'est pas celle par défaut. + n'est pas celle par défaut ; * un message par défaut (*facultatif*) : ce message est affiché une fois par jour par utilisateur consultant la carte ; * un ordre (pour trier les zones) ; * une disponibilité ; * un état « *par défaut* ». La zone *par défaut* est vue par défaut. Une seul zone peut être *par défaut* : activez cet état sur une zone le désactive sur - toutes les autres. + toutes les autres ; * des catégories cochées par défaut (*facultatif*) ; * si les catégories sont affichées dynamiquement. Si les catégories sont affichées dynamiquement, l'utilisateur ne voit seulement que les catégories qui ont des éléments sur la portion de carte actuellement à l'écran ; * des restrictions sur les catégories (*facultatif*): si aucune restriction - n'est définie toutes les catégories sont disponibles ; + n'est définie, toutes les catégories sont disponibles ; * une feuille de style CSS externe (*facultatif*) : une adresse Web qui pointe vers une feuille de style CSS externe ; -* une restriction à la portion de carte : si restreint, l'utilisateur ne pourra +* une restriction à la portion de carte : si coché, l'utilisateur ne pourra pas faire glisser la carte en dehors de la portion de carte. À cause de - restrictions de la bibliothèque OpenLayers utilisée par Chimère, il n'y a pas + limitations de la bibliothèque OpenLayers utilisée par Chimère, il n'y a pas de restriction sur le zoom ; * une portion de carte : c'est la zone qui sera affichée par défaut en arrivant sur la carte. Si la restriction sur une portion de carte est activée, la - restriction portera sur cette portion. Laissez appuyé la touche *Control* + restriction portera sur cette portion. Laissez appuyée la touche *Control*, cliquez et glissez pour dessiner la portion de carte choisie. * calques disponibles (*facultatif* : OSM Mapnik est utilisé par défaut): les rendus OSM Mapnik, OSM MapQuest, OSM Transport Map, OSM CycleMap sont - disponibles par défaut. Vous pouvez ajouter des nouveaux calques (cf. + disponibles par défaut. Vous pouvez ajouter de nouveaux calques (cf. :ref:`managing-layers`). Les *Zones* sont personnalisables directement depuis l'interface @@ -92,21 +92,21 @@ d'administration dans *Chimere > Zones*. Comme il y a peu de chance que la zone définie par défaut vous convienne, il sera au minimum nécessaire de définir une zone par défaut. -Ajouter plusieurs zones peut être un moyen d'afficher vos données sous -différents jours. +Ajouter plusieurs zones peut être un moyen d'afficher vos données de différentes +manières. Gestion des utilisateurs ------------------------ -Si vous n'êtes pas le seul administrator/modérateur de cette installation de +Si vous n'êtes pas le seul administrateur/modérateur de cette installation de Chimère vous aurez à créer et gérer des comptes pour les autres utilisateurs. -Vous pouvez créer un nouvel administrateur en ligne de commande :: +Vous pouvez créer un nouvel administrateur en ligne de commande : :: ./manage.py createsuperuser Les mots de passe peuvent être changés en ligne de commande (utile si vous -avez oublié votre mot de passe) :: +avez oublié votre mot de passe) : :: ./manage.py changepassword username @@ -122,7 +122,7 @@ Ensuite complétez les autres informations. Cochez la case : *Statut équipe* (ou cet utilisateur ne sera pas capable d'accéder aux pages d'administration). -Si ce compte est un nouveau administrateur technique, cochez la case *Statut +Si ce compte est un nouvel administrateur technique, cochez la case *Statut superutilisateur* (cet utilisateur doit être digne de confiance !). Sinon vous allez devoir donner des permissions à ce nouvel utilisateur. Plutôt que d'assigner manuellement des permissions aux utilisateurs, il est plus simple @@ -132,7 +132,7 @@ Deux types de groupe sont proposés par défaut : les administrateurs de l'application et les modérateurs. Les groupes de modérateurs ont des droits limités à une seule zone (le nom -du groupe est *Nom de zone modération*). Ils ne voient que les éléments +du groupe est *Nom_de_zone modération*). Ils ne voient que les éléments qui concernent leur zone. Un utilisateur pouvant faire partie de plusieurs groupes, il peut modérer plusieurs zones. @@ -142,29 +142,29 @@ Détails des droits pour les groupes par défaut : +------------------------------------------+--------------------------+---------------------------------+------------+ | Élément (ajout/modification/suppression) | Administrateur technique | Administrateur de l'application | Modérateur | +==========================================+==========================+=================================+============+ -| User | Oui | Non | Non | +| Utilisateur | Oui | Non | Non | +------------------------------------------+--------------------------+---------------------------------+------------+ -| Group | Oui | Non | Non | +| Groupe | Oui | Non | Non | +------------------------------------------+--------------------------+---------------------------------+------------+ -| Property model | Oui | Non | Non | +| Modèle de propriété | Oui | Non | Non | +------------------------------------------+--------------------------+---------------------------------+------------+ | Import | Oui | Non | Non | +------------------------------------------+--------------------------+---------------------------------+------------+ -| Layer | Oui | Non | Non | +| Calque | Oui | Non | Non | +------------------------------------------+--------------------------+---------------------------------+------------+ -| News | Oui | Oui | Non | +| Nouvelles | Oui | Oui | Non | +------------------------------------------+--------------------------+---------------------------------+------------+ -| Area | Oui | Oui | Non | +| Zone | Oui | Oui | Non | +------------------------------------------+--------------------------+---------------------------------+------------+ -| Icon | Oui | Oui | Non | +| Icône | Oui | Oui | Non | +------------------------------------------+--------------------------+---------------------------------+------------+ -| Color/Color theme | Oui | Oui | Non | +| Couleurs/thème de couleur | Oui | Oui | Non | +------------------------------------------+--------------------------+---------------------------------+------------+ -| Category/Subcategory | Oui | Oui | Non | +| Catégorie/Sous-catégorie | Oui | Oui | Non | +------------------------------------------+--------------------------+---------------------------------+------------+ -| Point Of Interest | Oui | Oui | Oui | +| Point d'intérêt | Oui | Oui | Oui | +------------------------------------------+--------------------------+---------------------------------+------------+ -| Route | Oui | Oui | Oui | +| Trajet | Oui | Oui | Oui | +------------------------------------------+--------------------------+---------------------------------+------------+ @@ -173,7 +173,7 @@ Créer des modèles de propriété Une installation de base de Chimère permet d'associer un nom, des catégories, une description, des dates, des fichiers multimédias, des fichiers d'image -à chaque fichier géographique. +à chaque élément géographique. Vous souhaitez peut-être des champs personnalisés tels que des numéros de téléphone ou des horaires d'ouverture. Pour cela, il suffit d'ajouter un nouveau @@ -182,12 +182,12 @@ modèle de propriété (*Chimere/Modèle de propriété*). La page d'administration vous demande : * un nom ; -* un ordre (pour ordonner les propriétés entre-elles) ; +* un ordre (pour ordonner les propriétés entre elles) ; * une disponibilité pour l'utilisateur (cela peut être utilisé pour associer des propriétés cachées) ; * un état « Obligatoire » qui oblige à remplir ce champ dans les formulaires ; * les catégories auxquelles associer cette propriété (si aucune catégorie n'est - sélectionnée la propriété est disponible pour toutes les categories) ; + sélectionnée, la propriété est disponible pour toutes les categories) ; * le type : texte, texte long, mot de passe ou date. .. Warning:: @@ -197,6 +197,6 @@ La page d'administration vous demande : Les formulaires sont alors automatiquement mis à jour avec ce nouveau champ. En tant qu'administrateur, si vous ne souhaitez pas rendre disponible l'ajout -ou la modification des propriétés vous pouvez désactiver la gestion des modèles +ou la modification des propriétés, vous pouvez désactiver la gestion des modèles de propriété en mettant *CHIMERE_HIDE_PROPERTYMODEL* à la valeur *True* dans votre fichier *local_settings.py*. diff --git a/docs/fr/customisation.rst b/docs/fr/customisation.rst index 498cfad..016f9e4 100644 --- a/docs/fr/customisation.rst +++ b/docs/fr/customisation.rst @@ -1,8 +1,8 @@ .. -*- coding: utf-8 -*- -============= -Customisation -============= +================ +Personnalisation +================ :Auteur: Étienne Loks :date: 2012-11-29 @@ -24,7 +24,7 @@ Le nouveau calque est défini en utilisant une chaîne de code Javascript adéqu de la bibliothèque `Openlayers `_. Ce code Javascript doit être une instance de *Openlayers Layer*, sans point virgule final. -Par exemple définir un calque Bing peut être fait avec un code de ce type :: +Par exemple définir un calque Bing peut être fait avec un code de ce type : :: new OpenLayers.Layer.Bing({ name: "Aerial", @@ -45,7 +45,7 @@ est d'ajouter un lien vers une feuille de style supplémentaire dans vos *Zones* (cf. :ref:`managing-areas`). Si vous souhaitez faire des changements plus importants dans l'agencement et la -présentation le projet *example_project* peut être personnalisé pour +présentation, le projet *example_project* peut être personnalisé pour correspondre à vos besoins. Chaque fichier de patron de page présent dans le dossier *chimere/templates* peut être copié dans votre dossier *monprojet/templates* puis modifié. diff --git a/docs/fr/import_export.rst b/docs/fr/import_export.rst index db35bf3..fc2902e 100644 --- a/docs/fr/import_export.rst +++ b/docs/fr/import_export.rst @@ -55,8 +55,8 @@ Champs communs à tous les types de source afin d'identifier facilement d'où l'élément provient. Pour les imports OSM la source est ajoutée automatiquement. - **Licence** : si non nul, ce champ va être associé à chaque élément importé - afin d'identifier facilement la license de l'élément. Pour les imports OSM - la license est ajoutée automatiquement. + afin d'identifier facilement la licence de l'élément. Pour les imports OSM + la licence est ajoutée automatiquement. - **Sous-catégories (obligatoire)** : les sous-catégories sélectionnées seront associées automatiquement aux nouveaux éléments importés. @@ -67,7 +67,7 @@ Import KML .. image:: static/chimere_admin_import_KML.png -- **Adresse Web/fichier source (obligatoire)** : votre fichier KML peut être +- **Adresse Web / fichier source (obligatoire)** : votre fichier KML peut être local ou distant. Vous avez à remplir un des deux champs. - **Filtre**: si vous souhaitez importer seulement un dossier (**Folder**) du fichier KML mettez son nom dans ce champ. @@ -80,9 +80,9 @@ Import Shapefile .. image:: static/chimere_admin_import_shapefile.png -- **Adresse Web/fichier source (obligatoire)** : votre fichier Shapefile peut +- **Adresse Web / fichier source (obligatoire)** : votre fichier shapefile peut être local ou distant. Vous avez à remplir un des deux champs. -- **Fichier zippé**: seuls les fichiers Shapefile zippé sont acceptés aussi +- **Fichier zippé**: seuls les fichiers shapefile zippés sont acceptés aussi cette case devrait être cochée. Import GeoRSS @@ -141,7 +141,7 @@ Pour importer depuis OSM, Chimère utilise l'API XAPI d'OSM. à utiliser pour filtrer les données OSM. Un lien vers la `page de « Map features » OSM `_ est fourni pour vous aider à trouver les valeurs adaptées. -- **Bouton de rafraîchissement**: ce bouton converti vos choix en arguments +- **Bouton de rafraîchissement**: ce bouton convertit vos choix en arguments XAPI adaptés. N'oubliez pas de presser sur ce bouton avant de valider le formulaire. @@ -165,6 +165,8 @@ juste nécessaire de lancer la commande :: Si vous lancez l'import en ligne de commande sans l'identifiant d'import, la liste des imports disponibles est affichée et vous pouvez alors en choisir un. +.. _manage-imported-data: + Gérer les données importées *************************** @@ -180,8 +182,8 @@ d'apparaître comme nouveaux éléments. importées. C'est particulièrement important si vous souhaitez exporter vos données vers OSM. -Exporter --------- +Export +------ Exporter vers CSV/KML/Shapefile ******************************* @@ -227,21 +229,20 @@ déterminer : - la zone géographique concernée par votre export ; - la clé/valeur à ajouter à vos éléments (nouveaux ou mis à jour) ; -- les sous-catégories concernées par cet export. Si vosu pensez que certains +- les sous-catégories concernées par cet export. Si vous pensez que certains éléments dans ces sous-catégories ne devraient pas être dans la base de données OSM (car ils ne sont pas pertinents ou à cause de question de licence) - préalablement marquez les comme **À ne pas exporter vers OSM** dans les + marquez les préalablement comme **À ne pas exporter vers OSM** dans les *champs d'imports* des :ref:`formulaires concernant les éléments géographiques `. -L'export vers OSM dans Chimère est fait de telle sorte à être le plus +L'export vers OSM dans Chimère est fait de sorte à être le plus conservateur possible par rapport à la base de données OSM. C'est pour cela qu'avant tout export, un import est fait. Si le nouvel import a des données -mises à jour, les valeurs de ces nouvelles données écraseront les données -présentes dans votre Chimère (si vous ne souhaitez pas cela : ne faites pas -de ré-imports et de fait pas d'exports). Tous les éléments importés doivent -être traités avant de faire un export. +mises à jour, il est nécessaire de retraiter les nouvelles données importées +avant de faire un export (cf. :ref:`gérer les données importées +`). Pour lancer un export sélectionnez l'objet *Import* approprié dans la liste des imports. Ensuite sélectionnez l'action **Exporter vers OSM** et validez. @@ -249,19 +250,19 @@ Puis on vous demande votre identifiant OSM, votre mot de passe OSM et l'API que vous souhaitez utiliser. Si vous comptez faire des exports régulièrement avec Chimère, il est recommandé de créer un compte spécifique pour cela. L'API de test est disponible pour faire des tests d'export. Si vous souhaitez -utiliser l'API de test vous aurez à créer un compte spécifique sur la plateforme -de test. +utiliser l'API de test, vous aurez à créer un compte spécifique sur la +plateforme de test. .. Warning:: Les données sur la plateforme de test ne sont pas synchronisées avec la - plateforme principale. Vous n'aurez pas les mêmes données que les données - que vous aurez avec XAPI. + plateforme principale. Vous n'aurez pas les mêmes données que celles celles + importées avec XAPI. -Une fois que tout ces champs sont remplis, vous pouvez (enfin !) lancer +Une fois que tous ces champs sont remplis, vous pouvez (enfin !) lancer l'export. -Quand vous exportez des couples clés/valeurs sont automatiquement ajoutés/mis à -jour : +Quand vous exportez, des couples clés/valeurs sont automatiquement ajoutés/mis à +jour dans la base de données OSM : -- *name*: obtenu depuis le nom de l'élément dans Chimère. +- *name*: obtenu depuis le nom de l'élément dans Chimère ; - *source*: pour identifier Chimère comme une source. diff --git a/docs/fr/install.rst b/docs/fr/install.rst index 2788d72..841eae2 100644 --- a/docs/fr/install.rst +++ b/docs/fr/install.rst @@ -44,11 +44,11 @@ Optionnel (mais recommandé) : - `tinymce `_ - `gpsbabel `_ - - django-celery pour une meilleure gestion des imports importants. + - django-celery pour une meilleure gestion des imports importants La manière la plus simple de satisfaire à ces pré-prequis est de les installer par le biais des dépôts de votre distribution Linux préférée. Par exemple -pour Debian Wheezy :: +pour Debian Wheezy : :: apt-get install apache2 python python-django python-django-south \ postgresql-9.1 gettext python-psycopg2 python-imaging \ @@ -57,7 +57,7 @@ pour Debian Wheezy :: libgeos-3.3.3 proj-bin postgresql-9.1-postgis gdal-bin \ tinymce gpsbabel python-django-celery javascript-common -Pour Debian Squeeze (il est nécessaire d'activer les backports) :: +Pour Debian Squeeze (il est nécessaire d'activer les backports) : :: apt-get install -t squeeze-backports python-django libjs-jquery @@ -77,13 +77,13 @@ Configuration de la base de données *********************************** Maintenant que postgres et postgis sont installés, vous avez besoin de créer -un nouvel utilisateur pour Chimère :: +un nouvel utilisateur pour Chimère : :: su postgres createuser --echo --adduser --createdb --encrypted --pwprompt chimere-user Ensuite, vous avez besoin de créer la base de données et d'initialiser les types -géographiques (adaptez les chemins par rapport à vos besoins):: +géographiques (adaptez les chemins par rapport à vos besoins) : :: PG_VERSION=9.1 # 8.4 pour debian Squeeze createdb --echo --owner chimere-user --encoding UNICODE chimere "Ma base de données Chimère" @@ -105,7 +105,7 @@ Depuis une archive La dernière version « stable » est disponible dans ce `répertoire `_. Prenez garde à prendre la dernière version de la branche souhaitée -(par exemple la dernière version de la branche 1.0 est la version 1.0.2).:: +(par exemple la dernière version de la branche 1.0 est la version 1.0.2). :: wget http://www.peacefrogs.net/download/chimere -q -O -| html2text (...) @@ -117,7 +117,7 @@ Prenez garde à prendre la dernière version de la branche souhaitée wget http://www.peacefrogs.net/download/chimere/chimere-1.0.2.tar.bz2 Téléchargez, décompressez et déplacez les fichiers dans un répertoire lisible -par l'utilisateur de votre serveur web (www-data pour Debian).:: +par l'utilisateur de votre serveur web (www-data pour Debian). :: cd $INSTALL_PATH tar xvjf chimere-last.tar.bz2 @@ -126,7 +126,7 @@ par l'utilisateur de votre serveur web (www-data pour Debian).:: Depuis le dépôt Git +++++++++++++++++++ -Une autre solution est d'obtenir les sources depuis le dépôt Git :: +Une autre solution est d'obtenir les sources depuis le dépôt Git : :: cd $INSTALL_PATH git clone git://www.peacefrogs.net/git/chimere @@ -139,7 +139,7 @@ Créez un patron pour votre projet ********************************* Il y a un exemple de projet fourni (*example_project*). Copiez-le et -modifiez-le (ou utilisez un autre projet basé sur Chimère) :: +modifiez-le (ou utilisez un autre projet basé sur Chimère) : :: cd $INSTALL_PATH/chimere cp -ra example_project mychimere_project @@ -155,9 +155,9 @@ par « _ » car cela a une signification particulière en Python. Dans le répertoire de votre application Chimère créez un fichier *local_settings.py* qui correspond à votre configuration. Un fichier de base est fourni (*local_settings.py.example*) et des descriptions -courtes des fichiers les plus pertinents sont données sous celui-ci (survolez-les au -minimum). La plupart de ces paramétrages sont initialisés dans le fichier -*settings.py*.:: +courtes des variables les plus pertinentes sont données sous celui-ci +(survolez-les au minimum). La plupart de ces paramétrages sont initialisés dans +le fichier *settings.py*. :: cd $INSTALL_PATH/chimere/mychimere_project cp local_settings.py.sample local_settings.py @@ -172,7 +172,7 @@ minimum). La plupart de ces paramétrages sont initialisés dans le fichier l'application et doit être initialisée à une valeur unique et non devinable. **Modifiez-là !** * ROOT_URLCONF : module Python de configuration des urls pour votre projet. - quelque chose comme : 'mychimere_project.urls' + Cela devrait être quelque chose comme : 'mychimere_project.urls' * EMAIL_HOST : SMTP du serveur de courriel pour envoyer des courriels * TINYMCE_URL : url du chemin vers tinymce (le chemin par défaut est adapté pour une installation sous Debian avec le paquet tinymce installé) @@ -187,20 +187,20 @@ minimum). La plupart de ces paramétrages sont initialisés dans le fichier * TIME_ZONE : fuseau horaire local de cette installation * LANGUAGE_CODE : code de langage pour cette installation -Gérez les permissions du dossier de média :: +Gérez les permissions du dossier de média : :: cd $INSTALL_PATH/chimere/mychimere_project chown -R user:www-data media chmod -R g+w media -Créez le fichier de log :: +Créez le fichier de log : :: mkdir /var/log/django touch /var/log/django/chimere.log chown -R root:www-data /var/log/django/ chmod -R g+w /var/log/django/ -Regroupez les fichiers static dans un seul répertoire :: +Regroupez les fichiers static dans un seul répertoire : :: cd $INSTALL_PATH/chimere/mychimere_project ./manage.py collectstatic @@ -211,17 +211,17 @@ Compilation des langages Si votre langage est disponible dans le dossier *chimere/locale/*, il est juste nécessaire de le compiler. Pour faire cela, il faut lancer la commande suivante (ici, **fr** est pour le -français, remplacez cela avec le code de langage approprié) :: +français, remplacez cela avec le code de langage approprié) : :: cd $INSTALL_PATH/chimere/chimere/ django-admin compilemessages -l fr Si votre langage n'est pas disponible, n'hésitez pas à créer le fichier **po** par défaut et à le proposer (les contributions sont bienvenues). -La procédure est la suivante : +La procédure est explicité ci-dessous. Il est d'abord nécessaire de créer le fichier po par défaut (bien sûr remplacez -**fr** par le code du langage que vous souhaitez créer) :: +**fr** par le code du langage que vous souhaitez créer) : :: django-admin makemessages -l fr @@ -229,7 +229,7 @@ Il doit y avoir maintenant un fichier *django.po* dans le répertoire *locale/fr/LC_MESSAGES*. Ensuite il faut le compléter avec votre traduction. -Maintenant que votre fichier de traduction est complété, il suffit de le +Une fois le votre fichier de traduction complété, il suffit de le compiler de la même manière que vous l'auriez fait si ce fichier était initialement disponible. @@ -237,7 +237,7 @@ Initialisation de la base de données ************************************ Créez les tables de la base de données (toujours dans le répertoire de votre -projet) :: +projet) : :: cd $INSTALL_PATH/chimere/mychimere_project ./manage.py syncdb @@ -246,14 +246,14 @@ projet) :: Vous aurez à rentrer les informations pour la création du compte administrateur (les pages d'administration se trouvent à l'adresse : http://where_is_chimere/admin/). Ensuite pour créer les tables de la base de -données gérées par Django-South :: +données gérées par Django-South : :: ./manage.py migrate La base de données est en place, félicitations ! Si vous voulez remplir votre installation avec des données par défaut (ne le -faites pas sur une instance de Chimère contenant déjà des données !) :: +faites pas sur une instance de Chimère contenant déjà des données !) : :: ./manage.py loaddata ../chimere/fixtures/default_data.json @@ -263,7 +263,7 @@ Configuration du serveur web Configuration d'Apache avec mod_wsgi ++++++++++++++++++++++++++++++++++++ -Installez *mod_wsgi* pour Apache :: +Installez *mod_wsgi* pour Apache : :: apt-get install libapache2-mod-wsgi @@ -284,7 +284,7 @@ Adaptez les fichiers *mydjango.wsgi* (avec le chemin correct *sys* des bibliothèques Python de Chimère et le nom correct pour le module) et le fichier *chimere* de Apache (avec le nom de serveur correct et les chemins corrects). -Pour activer le site web, rechargez Apache :: +Pour activer le site web, rechargez Apache : :: a2ensite chimere /etc/init.d/apache2 reload @@ -292,7 +292,7 @@ Pour activer le site web, rechargez Apache :: Si vous avez des problèmes de dépôt de fichier avec des caractères Unicode dans leurs noms, activez la locale appropriée dans Apache. Sur un serveur Debian avec UTF-8 comme codage par défaut, dans le fichier */etc/apache2/envvars* -décommentez la ligne suivante :: +décommentez la ligne suivante : :: . /etc/default/locale diff --git a/docs/fr/upgrade.rst b/docs/fr/upgrade.rst index 8a13bf7..a092b4b 100644 --- a/docs/fr/upgrade.rst +++ b/docs/fr/upgrade.rst @@ -1,8 +1,8 @@ .. -*- coding: utf-8 -*- -======= -Upgrade -======= +=========== +Mise à jour +=========== :Auteur: Étienne Loks :date: 2012-11-29 @@ -12,13 +12,13 @@ Ce document présente la mise à jour de Chimère. Il a été mis à jour pour la version 2.0.0 de Chimère. .. Warning:: - Avant toute mise à jour la base de données et toutes vos fichiers - d'installation (en particulier si vous avez fait des changements sur - ceux-ci). + Avant toute mise à jour faites une sauvegarde de la base de données et de + tous vos fichiers d'installation (en particulier si vous avez fait des + changements sur ceux-ci). -La procédure de migration nécessite une connaissance de base de Git et la ligne -de commande Linux. Ce n'est *pas* une procédure facile. Un travail est en cours -pour faciliter les mises à jour des futures versions de Chimère (>2.0). +La procédure de migration nécessite une connaissance de base de Git et de la +ligne de commande Linux. Ce n'est *pas* une procédure facile. Un travail est en +cours pour faciliter les mises à jour des futures versions de Chimère (>2.0). Si plusieurs versions de Chimère ont été publiées depuis votre installation, vous devez répéter toutes les étapes de mise à jour. @@ -49,7 +49,7 @@ Version 1.2 -> 2.0 Debian Squeeze ++++++++++++++ -Activez les backports: http://backports-master.debian.org/Instructions/ +Activez les backports (http://backports-master.debian.org/Instructions/). Puis installez les nouvelles dépendances :: apt-get install -t squeeze-backports python-django python-django-south \ @@ -64,7 +64,7 @@ Debian Wheezy apt-get install python-django-south python-simplejson libjs-jquery-ui \ python-pyexiv2 python-feedparser javascript-common -Si vous envisagez de réaliser des imports importants envisagez l'installation +Si vous comptez réaliser des imports importants envisagez l'installation de `Celery `_. .. code-block:: bash @@ -74,9 +74,8 @@ de `Celery `_. Obtenir les nouvelles sources ----------------------------- -Tout d'abord vous avez à obtenir la nouvelle version du code source. -Pour la procédure d'installation, le code source doit être pris depuis -le dépôt Git. +Tout d'abord vous avez besoin de la nouvelle version du code source. +Pour la procédure d'installation, le code source doit être celui du dépôt Git. Pour simplifier les instructions suivantes, quelques variables d'environnement sont initialisées. @@ -116,7 +115,7 @@ Pour une précédente installation Git Pour une précédente installation depuis une archive *************************************************** -Supprimez d'abord votre ancienne installation et obtenez la version Git :: +Supprimez d'abord votre ancienne installation et obtenez la version Git : .. code-block:: bash @@ -147,7 +146,7 @@ jquery et gpsbabel) : JQUERY_URL = SERVER_URL + 'jquery/jquery-1.4.4.min.js' GPSBABEL = '/usr/bin/gpsbabel' - # simplification des trajets avec une tolérance de 5 metres + # simplification des trajets avec une tolérance de 5 mètres GPSBABEL_OPTIONS = 'simplify,crosstrack,error=0.005k' Version 1.2 -> 2.0 @@ -176,12 +175,12 @@ Un fichier *local_settings* est maintenant utilisé. Reportez vos anciens paramètres de *settings.py* vers *local_settings.py* (au minimum la configuration de votre base de données). Le paramètre *ROOT_URLCONF* doit être mis à la valeur -**nom_de_votre_projet.urls**. +« **nom_de_votre_projet.urls** ». logs .... Par défaut, des fichiers de *log* sont maintenant écrit dans le fichier : -*/var/log/django/chimere.log*. +« */var/log/django/chimere.log* ». .. code-block:: bash @@ -192,7 +191,8 @@ Par défaut, des fichiers de *log* sont maintenant écrit dans le fichier : Fichiers statiques .................. -Les fichiers statiques sont maintenant gérés avec *django.contrib.staticfiles*. +Les fichiers statiques sont maintenant gérés avec +« **django.contrib.staticfiles** ». .. code-block:: bash @@ -213,11 +213,11 @@ Configuration du serveur Web Si vous utilisez Apache et WSGI pour mettre à disposition votre Chimère, changez la configuration pour pointer vers le chemin correct de -configuration : **nom_de_votre_projet.settings**. +configuration : « **nom_de_votre_projet.settings** ». Changez la directive de votre serveur web pour qu'elle pointe vers le bon -répertoire statique de **votre_chemin_vers_chimere/chimere/static** en -**votre_chemin_vers_chimere/nom_de_votre_projet/static**. +répertoire statique de « **votre_chemin_vers_chimere/chimere/static** » en +« **votre_chemin_vers_chimere/nom_de_votre_projet/static** ». Version 2.0 -> master +++++++++++++++++++++ @@ -236,7 +236,7 @@ Version 1.1 -> 1.2 ****************** Les scripts de migration testent votre installation avant de faire des -changements vous n'aurez donc probablement pas de perte mais par précaution +changements. Vous n'aurez donc probablement pas de perte mais par précaution avant de les lancer n'oubliez pas de faire une sauvegarde de votre base de données. Vous pouvez aussi faire une copie de votre base de données actuelle dans une @@ -246,13 +246,13 @@ La bibliothèque GDAL pour Python est nécessaire pour faire fonctionner ces scripts (disponible avec le paquet *python-gdal* dans Debian). Si vous souhaitez lancer le script de migration dans un environnement de -production stoppez l'instance de Chimère avant d'exécuter le script de +production, stoppez l'instance de Chimère avant d'exécuter le script de migration. -Dans le fichier *settings.py* vérifiez que **chimere.scripts** fait parti +Dans le fichier *settings.py* vérifiez que **chimere.scripts** fait partie des *INSTALLED_APPS*. -Après cela dans le répertoire d'installation de Chimère exécutez simplement +Après cela, dans le répertoire d'installation de Chimère, exécutez simplement le script. .. code-block:: bash @@ -269,11 +269,12 @@ Django South est maintenant utilisé pour les migrations de base de données. cd $CHIMERE_APP_PATH ./manage.py syncdb - ./manage.py migrate chimere 0001 --fake # fake the database initialisation + ./manage.py migrate chimere 0001 --fake # simule l'initialisation de la base + # de données ./manage.py migrate chimere Un champ descriptif est maintenant disponible pour les points d'intérêts. Si -vous souhaitez bouger un ancien *modèle de propriété* vers ce nouveau champ, +vous souhaitez migrer un ancien *modèle de propriété* vers ce nouveau champ, un script est disponible. .. code-block:: bash @@ -313,21 +314,21 @@ Version 1.2 -> 2.0 -> master Forcer le rafraîchissement du cache du navigateur des utilisateurs ------------------------------------------------------------------ -Des changements importants au niveau des styles et du javascript sont fait entre -les différentes version. Cela peut provoquer des dysfonctionnements important -chez des utilisateurs dont le navigateur web a conservé les anciennes versions -de certains fichiers en cache. Il y a pas mal de moyens de forcer le +Des changements importants au niveau des styles et du javascript sont faits +entre les différentes versions. Cela peut provoquer des dysfonctionnements +importants chez des utilisateurs dont le navigateur web a conservé les anciennes +versions de certains fichiers en cache. Il y a plusieurs moyens de forcer le rafraîchissement de leur cache. Un de ceux-ci est de changer le chemin vers les -fichiers statiques. Pour faire cela éditez votre fichier *local_settings.py* et -changez :: +fichiers statiques. Pour faire cela, éditez votre fichier *local_settings.py* et +changez : :: STATIC_URL = '/static/' -en :: +en : :: STATIC_URL = '/static/v2.0.0/' -Changez alors la directive concernant les fichiers statiques sur le fichier de +Changez la directive concernant les fichiers statiques sur le fichier de configuration de votre serveur web. Redémarrez alors le serveur web pour appliquer les changements. -- cgit v1.2.3