diff options
| -rw-r--r-- | docs/en/import_export.rst | 7 | ||||
| -rw-r--r-- | docs/fr/administration.rst | 54 | ||||
| -rw-r--r-- | docs/fr/configuration.rst | 70 | ||||
| -rw-r--r-- | docs/fr/customisation.rst | 10 | ||||
| -rw-r--r-- | docs/fr/import_export.rst | 47 | ||||
| -rw-r--r-- | docs/fr/install.rst | 52 | ||||
| -rw-r--r-- | docs/fr/upgrade.rst | 73 |
7 files changed, 158 insertions, 155 deletions
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 <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 <http://openlayers.org/>`_. 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 <https://wiki.openstreetmap.org/wiki/Map_Features>`_ 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 <geographic-items-management>`. -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 +<manage-imported-data>`). 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 <http://tinymce.moxiecode.com/>`_ - `gpsbabel <http://www.gpsbabel.org/>`_ - - 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 <http://www.peacefrogs.net/download/chimere/>`_. 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 <http://celeryproject.org/>`_. .. code-block:: bash @@ -74,9 +74,8 @@ de `Celery <http://celeryproject.org/>`_. 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. |