summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorÉtienne Loks <etienne.loks@peacefrogs.net>2012-11-29 17:39:12 +0100
committerÉtienne Loks <etienne.loks@peacefrogs.net>2012-11-29 17:39:12 +0100
commit32cbf101cefcb4928a751429c09f00d544893037 (patch)
tree473e3fdddc3e0464b8a4b5d0278d8a6ca44fe419 /docs
parent56e54747f66c3a58c941f9e0479edd9b1c889ff8 (diff)
downloadChimère-32cbf101cefcb4928a751429c09f00d544893037.tar.bz2
Chimère-32cbf101cefcb4928a751429c09f00d544893037.zip
Documentation: french translation of "administration".
* First version of french version of "administration" file. * Minor change on english "administration" file.
Diffstat (limited to 'docs')
-rw-r--r--docs/administration.rst8
-rw-r--r--docs/fr/administration.rst232
2 files changed, 238 insertions, 2 deletions
diff --git a/docs/administration.rst b/docs/administration.rst
index fa95012..72fd116 100644
--- a/docs/administration.rst
+++ b/docs/administration.rst
@@ -146,7 +146,7 @@ There is a some actions available in the action list.
- **Delete** to delete selected items. A confirmation step is displayed.
- **Validate** to set the status *Available* to selected items.
-- **Disable** to set teh status *Disabled* to selected items. This is useful to
+- **Disable** to set the status *Disabled* to selected items. This is useful to
keep items you don't want to be exposed on the map.
- **Managed modified items** to manage the amendment made by end users on the
main site cf. to :ref:`managing-modified`. Modified item has to be treated
@@ -156,6 +156,9 @@ There is a some actions available in the action list.
To modify an item, classically you have to click on his name.
Then you access to a form to freely modify the item.
+
+.. image:: _static/chimere_admin_modify_item.png
+
In this form there is all data available to the end user form plus some extra
fields.
- The *Import fields* only make sense with data imported from an external
@@ -200,4 +203,5 @@ This form is a table with three columns.
validation, the value of the modified item will replace the value of the
reference item.
-To reject all modification validate the form with no checkbox checked.
+.. Note::
+ To reject all modification validate the form with no checkbox checked.
diff --git a/docs/fr/administration.rst b/docs/fr/administration.rst
new file mode 100644
index 0000000..dd8c856
--- /dev/null
+++ b/docs/fr/administration.rst
@@ -0,0 +1,232 @@
+.. -*- coding: utf-8 -*-
+.. _administration:
+
+==============
+Administration
+==============
+
+:Auteur: Étienne Loks
+:date: 2012-11-29
+: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.
+
+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.
+
+Identification
+**************
+
+Tout d'abord vous avez à vous identifier avec l'identifiant et le mot de
+passe fourni.
+
+.. image:: _static/chimere_admin_00.png
+
+
+Page principale
+***************
+
+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
+#. un titre d'application, la plupart des actions vont se faire dans
+ 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**
+ conduit à la `Liste des éléments`_. La `Liste des éléments`_ est également
+ disponible en cliquant sur le libellé de l'élément.
+
+
+Liste des éléments
+******************
+
+.. image:: _static/chimere_admin_02.png
+
+#. 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
+#. recherche des éléments par mot (n'est pas disponible pour tous les types
+ 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
+ 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
+ le modifier ou le supprimer.
+
+Formulaire des éléments
+***********************
+
+.. image:: _static/chimere_admin_03.png
+
+#. les champs pour l'élément sélectionné (ou vide si c'est un nouvel élément)
+ sont affichés dans ce formulaire. Parfois certains champs sont en lecture
+ seule et d'autres sont cachés. Les champs obligatoires ont leur intitulé en
+ gras. Les changements sur ces champs ne sont effectifs qu'une fois le
+ formulaire validé.
+#. 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é.
+#. 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
+Chimère. Pour administrer Chimère efficacement il est nécessaire de comprendre
+chacun de ces états.
+
+- **Proposé**: État d'un élément nouvellement proposé par un utilisateur. Cet
+ élément n'est pas visible sur la carte.
+- **Disponible**: État d'un élément visible sur la carte.
+- **Désactivé**: État d'un élément écarté.
+- **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
+ traités (validés, désactivés ou supprimés).
+
+
+Gestion des nouvelles
+---------------------
+
+Un système de nouvelle 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
+--------------------------------------
+
+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
+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.
+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
+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 ?).
+
+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.
+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,
+*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 :
+points d'intérêts, trajets ou les deux.
+
+.. _geographic-items-management:
+
+É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.
+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.
+
+Un champ de recherche est disponible pour rechercher par nom mais il est
+généralement plus intéressant de filtrer par état et sous-catégories.
+
+Il y a un certain nombre d'action disponible.
+
+- **Supprimer** pour supprimer les éléments sélectionnés. Une étape de
+ confirmation est affichée.
+- **Valider** pour donner le status *Disponible* aux éléments sélectionnés.
+- **Désactiver** pour donner le status *Désactivé* aux éléments sélectionnés.
+ 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.
+- **Export en...** pour exporter les éléments sélectionnés vers le format
+ sélectionné.
+
+
+Pour modifier un élément, classiquement, vous cliquez sur son nom pour accéder
+ensuite à un formulaire pour modifier librement l'élément.
+
+.. image:: _static/chimere_admin_modify_item.png
+
+Sur ce formulaire il y a tous les éléments disponibles à l'utilisateur plus
+quelques champs supplémentaires.
+- Les champs *Imports* ne sont pertinent que pour les données importées depuis
+ une source externe ou pour les données destinées à être exportées vers OSM
+ cf. à la :ref:`section import <importing>` de cette documentation.
+- Les *Éléments associés* sont des champs en lecture seule qui listent les
+ éléments associés à l'élément courant (élément de référence d'une
+ modification, fichier associé à un trajet).
+
+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
+éléments.
+
+Si un élément n'est pas pertinent, le bouton **Supprimer** permet de le
+supprimer.
+
+.. Warning::
+ N'oubliez pas de valider vis changements avec un des boutons d'enregistrement
+ disponibles à la fin du formulaire (notamment il est assez facile d'oublier
+ de confirmer les changements faits aux éléments multimédias).
+
+.. _managing-modified:
+
+Managing end user amendment
+---------------------------
+
+Des propositions de modification peuvent être faits sur le site principal par
+les utilisateurs.
+
+Dans Chimère, une proposition de modification est un nouvel élément avec l'état
+**Modifié** qui dispose d'un lien vers l'élément de référence.
+
+.. Note::
+ Si vous êtes identifié en tant qu'administrateur et que vous faites des
+ changements sur la carte avec le « formulaire utilisateur » les changements
+ vont être directement pris en compte.
+
+Un formulaire spécifique a été développé pour faciliter le traitement de ces
+éléments modifiés.
+
+Vous pouvez accéder à ce formulaire spécifique avec l'action *Gérer les éléments
+modifiés*.
+
+.. image:: _static/chimere_admin_modified_management.png
+
+Ce formulaire est un tableau à 3 colonnes.
+
+#. La première colonne affiche les informations de l'élément de référence.
+#. La seconde colonne affiche les informations que propose l'utilisateur.
+#. La troisième colonne est une liste de cases à cocher. Après validation, pour
+ chaque ligne cochée, la valeur de l'élément modifié remplacera la valeur de
+ 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.