diff options
| -rw-r--r-- | docs/administration.rst | 8 | ||||
| -rw-r--r-- | docs/fr/administration.rst | 232 |
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. |