Upgrade documentation

8 files changed, 81 insertions, 30 deletions

diff --git a/docs/en/configuration.rst b/docs/en/configuration.rst
index e5870bb..2a7f4d0 100644
--- a/docs/en/configuration.rst
+++ b/docs/en/configuration.rst
@@ -5,7 +5,7 @@ Configuration
 =============
 
 :Author: Étienne Loks
-:date: 2012-10-08
+:date: 2013-02-01
 :Copyright: CC-BY 3.0
 
 This document presents the first steps to configure your Chimère.
@@ -32,15 +32,6 @@ To access these pages you have to identify with an account with *staff* and
 
 A *superuser* account is created at the initialization of the database.
 
-Configuring the Sites framework
--------------------------------
-
-*Sites* framework allow you to serve the same content on different domains.
-Most of you will probably use only one domain but this unique domain has to
-be configured. This is done in the web administration interface in *Sites > Sites*.
-You only need to change *example.com* by your domain name. If you forget to
-do that, some functionalities such as RSS feeds will not work properly.
-
 .. _managing-areas:
 
 Managing areas
diff --git a/docs/en/import_export.rst b/docs/en/import_export.rst
index 6dd1d7a..9144938 100644
--- a/docs/en/import_export.rst
+++ b/docs/en/import_export.rst
@@ -5,7 +5,7 @@ Import/export
 =============
 
 :Author: Étienne Loks
-:date: 2012-11-28
+:date: 2013-02-01
 :Copyright: CC-BY 3.0
 
 This document presents the import/export functionnalities of Chimère.
@@ -49,6 +49,11 @@ Common fields
   be reconciled with the :ref:`amendment form <managing-modified>`. If you don't
   want to use this form and then overwrite with the data from the external
   source, check this option.
+- **Get description from source**: If this case is checked, the importer will
+  try to get the description from the source file. This option is only available
+  for certain file formats.
+- **Default description**: A default description to be added to new items. This
+  field is only available when **Get description from source** is not checked.
 - **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.
diff --git a/docs/en/install.rst b/docs/en/install.rst
index 7ba376b..ff8ac46 100644
--- a/docs/en/install.rst
+++ b/docs/en/install.rst
@@ -5,7 +5,7 @@ Installation
 ============
 
 :Author: Étienne Loks
-:date: 2012-11-28
+:date: 2013-02-01
 :Copyright: CC-BY 3.0
 
 This document presents the installation of Chimère.
@@ -292,3 +292,12 @@ line::
     . /etc/default/locale
 
 
+Configuring the Sites framework
+*******************************
+
+*Sites* framework allow you to serve the same content on different domains.
+Most of you will probably use only one domain but this unique domain has to
+be configured. This is done in the web administration interface in *Sites > Sites*.
+You only need to change *example.com* by your domain name. If you forget to
+do that, some functionalities such as RSS feeds will not work properly.
+
diff --git a/docs/en/upgrade.rst b/docs/en/upgrade.rst
index ef9d0d1..6dce286 100644
--- a/docs/en/upgrade.rst
+++ b/docs/en/upgrade.rst
@@ -5,7 +5,7 @@ Upgrade
 =======
 
 :Author: Étienne Loks
-:date: 2012-10-08
+:date: 2013-02-01
 :Copyright: CC-BY 3.0
 
 This document presents the upgrade of Chimère.
@@ -198,6 +198,12 @@ Move old static files to the new static directory:
     rm -rf $CHIMERE_PATH/chimere/static/icons
     rm -rf $CHIMERE_PATH/chimere/static/upload
 
+Update permissions for media directory:
+
+.. code-block:: bash
+
+    chown www-data -R $CHIMERE_APP_PATH/media/
+
 
 Webserver configuration
 .......................
@@ -295,6 +301,7 @@ Version 1.2 -> 2.0 -> master
     cd $CHIMERE_PATH/chimere
     django-admin compilemessages
 
+
 Forcing the refresh of visitor's web browser cache
 --------------------------------------------------
 
@@ -307,8 +314,20 @@ that edit your local_settings.py and change::
 
 to::
 
-    STATIC_URL = '/static/v2.0.0/'
+    STATIC_URL = '/static-v2.0.0/'
 
 Then change the webserver directive to point to your new path.
 Restart the web server to apply this changes.
 
+Configuring the Sites framework
+-------------------------------
+
+Version 1.2 -> 2.0
+******************
+
+*Sites* framework allow you to serve the same content on different domains.
+Most of you will probably use only one domain but this unique domain has to
+be configured. This is done in the web administration interface in *Sites > Sites*.
+You only need to change *example.com* by your domain name. If you forget to
+do that, some functionalities such as RSS feeds will not work properly.
+
diff --git a/docs/fr/configuration.rst b/docs/fr/configuration.rst
index f419a0d..1ea8f50 100644
--- a/docs/fr/configuration.rst
+++ b/docs/fr/configuration.rst
@@ -5,7 +5,7 @@ Configuration
 =============
 
 :Auteur: Étienne Loks
-:date: 2012-11-29
+:date: 2013-02-01
 :Copyright: CC-BY 3.0
 
 Ce document présente l'installation de Chimère.
@@ -33,17 +33,6 @@ pour état *équipe* ou *super-utilisateur*.
 
 Un compte *super-utilisateur* est créé à l'initialisation de la base de données.
 
-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 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
-fonctionneront pas correctement.
 
 .. _managing-areas:
 
diff --git a/docs/fr/import_export.rst b/docs/fr/import_export.rst
index beca4e7..4da40dd 100644
--- a/docs/fr/import_export.rst
+++ b/docs/fr/import_export.rst
@@ -5,7 +5,7 @@ Import/export
 =============
 
 :Author: Étienne Loks
-:date: 2012-11-28
+:date: 2013-02-01
 :Copyright: CC-BY 3.0
 
 Ce document présente les fonctions d'import et d'export de Chimère.
@@ -51,6 +51,12 @@ Champs communs à tous les types de source
   gestion des modifications <managing-modified>`. Si vous ne souhaitez pas avoir
   à faire ce rapprochement et alors écraser les données existantes avec les
   données de la source externe, cochez cette option.
+- **Obtenir la description depuis la source** : si cette case est cochée,
+  l'importeur va essayer d'obtenir une description depuis le fichier source.
+  Cette option n'est valable que pour certains formats.
+- **Description par défaut** : Une description par défaut à ajouter aux nouveaux
+  éléments. Ce champ n'est disponible que lorsque **Obtenir la description
+  depuis la source** n'est pas coché.
 - **Origine** : si non nul, ce champ va être associé à chaque élément importé
   afin d'identifier facilement d'où l'élément provient. Pour les imports OSM
   la source est ajoutée automatiquement.
diff --git a/docs/fr/install.rst b/docs/fr/install.rst
index da6dd05..9a33e7c 100644
--- a/docs/fr/install.rst
+++ b/docs/fr/install.rst
@@ -5,7 +5,7 @@ Installation
 ============
 
 :Auteur: Étienne Loks
-:date: 2012-11-28
+:date: 2013-02-01
 :Copyright: CC-BY 3.0
 
 Ce document présente l'installation de Chimère.
@@ -302,3 +302,15 @@ décommentez la ligne suivante : ::
     . /etc/default/locale
 
 
+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 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
+fonctionneront pas correctement.
+
diff --git a/docs/fr/upgrade.rst b/docs/fr/upgrade.rst
index b43ccd3..32d37b8 100644
--- a/docs/fr/upgrade.rst
+++ b/docs/fr/upgrade.rst
@@ -5,7 +5,7 @@ Mise à jour
 ===========
 
 :Auteur: Étienne Loks
-:date: 2012-11-29
+:date: 2013-02-01
 :Copyright: CC-BY 3.0
 
 Ce document présente la mise à jour de Chimère.
@@ -210,6 +210,11 @@ Déplacez vos anciens fichiers statiques vers le nouveau répertoire :
     rm -rf $CHIMERE_PATH/chimere/static/icons
     rm -rf $CHIMERE_PATH/chimere/static/upload
 
+Mettre à jour les permissions des répertoires media :
+
+.. code-block:: bash
+
+    chown www-data -R $CHIMERE_APP_PATH/media/
 
 Configuration du serveur Web
 ............................
@@ -329,9 +334,24 @@ changez : ::
 
 en : ::
 
-    STATIC_URL = '/static/v2.0.0/'
+    STATIC_URL = '/static-v2.0.0/'
 
 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.
 
+Configurer le framework Sites
+-----------------------------
+
+Version 1.2 -> 2.0
+******************
+
+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 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
+fonctionneront pas correctement.
+