--- a/doc/administration.rst Mon Dec 02 17:48:02 2013 +0100
+++ b/doc/administration.rst Mon Dec 02 18:17:21 2013 +0100
@@ -2,9 +2,9 @@
Administration
**************
-Django et ses modules d'extensions propose de nombreuses commande d'administration. Le but est ici d'en lister les plus utiles pour l'administration de l'application.
-L`accès à ces commandes se fait par le script ``manage.py`` situee dans le répertoire ``src`` de l'application.
-Il est bien sur indispensable d'activer l'environement virtuel de l'application (cf. :ref:`deployment-virtualenv`) avant de lancer ce script.
+Django et ses modules d'extensions propose de nombreuses commandes d'administration. Le but est ici d'en lister les plus utiles pour l'administration de l'application.
+L`accès à ces commandes se fait par le script ``manage.py`` situé dans le répertoire ``src`` de l'application.
+Il est bien sur indispensable d'activer l'environnement virtuel de l'application (cf. :ref:`deployment-virtualenv`) avant de lancer ce script.
Le reste des commandes est documenté soit à l'adresse suivante : https://docs.djangoproject.com/en/1.5/ref/django-admin/, soit directement en invoquant la commande avec l'option ``--help`` i.e.::
cd src
@@ -21,7 +21,7 @@
python manage.py collectstatic
La première permet la mise à jour du schéma de la base de donnée et de lancer les éventuelles migration de données.
-La deuxième sert à mettre à jour les resources statiques.
+La deuxième sert à mettre à jour les ressources statiques.
Commande d'administration
@@ -62,15 +62,15 @@
-h, --help show this help message and exit
-Cette commande importe des notices en format rdf speecifique au projet dans l'application. Elle prend comme argument une liste de chemin vers les fichiers à importer.
+Cette commande importe des notices en format rdf spécifique au projet dans l'application. Elle prend comme argument une liste de chemin vers les fichiers à importer.
Les options suivantes sont disponibles:
* ``-b BATCH_SIZE`` : contrôle la taille des lots lors de l'import.
- Augmenter la taille des lots peut améliorer les performances lors de l'import mais augmente la consomation mémoire.
- (valeur par défaut: 50)
+ Augmenter la taille des lots peut améliorer les performances lors de l'import mais augmente la consommation mémoire.
+ (Valeur par défaut: 50)
* ``-p`` : ne tente pas d'effacer les notices lors de l'import.
- L'import d'une notice existante (même identifiant) proviquera une erreur et l'arrêt de l'import
+ L'import d'une notice existante (même identifiant) provoquera une erreur et l'arrêt de l'import
* ``-i`` : met à jour l'index des notices lors de l'import.
@@ -87,7 +87,7 @@
Donc en cas d'erreur d'import il est possible que certaine notice ait été indexée mais ne se retrouve pas finalement en base.
Il est à noté que dans ce cas, ces notices apparaîtrons dans la page de liste des notices.
- #. Pour des imports massif, il est souvent plus interessant de desactiver l'indexation à la volée et de lancer si c'est possible une mise à jour de l'index (cf. `update_index`_) et sinon sa reconstruction. (cf. `rebuild_index`_)
+ #. Pour des imports massif, il est souvent plus intéressant de désactiver l'indexation à la volée et de lancer si c'est possible une mise à jour de l'index (cf. `update_index`_) et sinon sa reconstruction. (cf. `rebuild_index`_)
.. _admin-dump-record:
@@ -130,15 +130,15 @@
Les options suivantes sont disponibles:
- * ``-b BATCH`` : tailles des lots de notices par requête de base de données. La valeur de ce paramêtre dépend des performances et capacité du serveur de base de données et de la machine d'export.
- * ``-l LIMIT`` : nombre maximum de notices à exporter. -1 (le défaut) exporte toute les notices.
+ * ``-b BATCH`` : tailles des lots de notices par requête de base de données. La valeur de ce paramètre dépend des performances et capacité du serveur de base de données et de la machine d'export.
+ * ``-l LIMIT`` : nombre maximum de notices à exporter. -1 (le défaut) exporte toutes les notices.
* ``-s SKIP`` : nombre de notice à ignorer avant de commencer l'export. O par défaut. Rappel: Lors de l'export les notices sont classées par leur identifiant (tri syntaxique ascendant).
Avec l'option ``-l``, cette option permet l'export des notices en lots.
* ``-j``, ``-z`` : permet la compression à la volée des données. La compression se fait au fur et à mesure de l'export.
Les points suivants sont à noter:
- #. Toute erreur interompt immédiatement l'export.
+ #. Toute erreur interrompt immédiatement l'export.
#. En cas d'erreur, l'export est immédiatement interrompu et le fichier produit ne sera pas valide.
En particulier, dans le cas où une option de compression a été activé, l'archive partielle crée peut s'avérer illisible.
@@ -189,7 +189,7 @@
--version show program's version number and exit
-h, --help show this help message and exit
-Commande utilisée pour reconstruire l'index Elasticsearch. L'age d'une notice est calculé à partir de sa date de mise à jour.
+Commande utilisée pour reconstruire l'index Elasticsearch. L’âge d'une notice est calculé à partir de sa date de mise à jour.
Cette date est la date d'import de la notice si elle n'a pas été mise à jour dans l'application, et sa date de création si elle a été créée dans l'application.
Cette commande est fournie par le module Django ``Haystack``. Sa documentation se trouve à l'adresse suivante : http://django-haystack.readthedocs.org/en/v2.1.0/management_commands.html
@@ -237,19 +237,19 @@
--version show program's version number and exit
-h, --help show this help message and exit
-Commande utilisée pour mettre à jour l'index Elasticsearch. L'age d'une notice est calculé à partir de sa date de mise à jour.
+Commande utilisée pour mettre à jour l'index Elasticsearch. L’âge d'une notice est calculé à partir de sa date de mise à jour.
Cette date est la date d'import de la notice si elle n'a pas été mise à jour dans l'application, et sa date de création si elle a été créée dans l'application.
Cette commande est fournie par le module Django ``Haystack``. Sa documentation se trouve à l'adresse suivante : http://django-haystack.readthedocs.org/en/v2.1.0/management_commands.html
-console d'administration
+Console d'administration
========================
Le back-office offre une console d'administration donnant accès en particulier à la gestion des utilisateurs.
On y accède par le lien ``admin`` dans l'en-tête des pages si on est connecté en tant qu'administrateur ou bien en allant directement à l'adresse ``<racine du site>/p4l/admin/``.
-gestion des utilisateurs
+Gestion des utilisateurs
------------------------
L'administration des utilisateurs se fait à l'adresse suivante : ``<racine du site>/p4l/admin/p4l/user/``.
@@ -264,8 +264,8 @@
Le champ ``Permission de l'utilisateur`` doit donc comporter toutes les entrées de la forme ``p4l | <object> | <permission>``.
-Pour faciliter la gestion de ces permissions, le plus simple est de créer un groupe ``utilisateurs``. On affectera à ce groupe toutes les permissions sur les objects de l'application ``p4l``.
-il suffira ensuite de mettre les utilisateurs dans ce groupe (champ ``Groupes`` dans l'interface d'édition des utilisateurs). L'utilisateur héritera alors des parmissions du groupe.
+Pour faciliter la gestion de ces permissions, le plus simple est de créer un groupe ``utilisateurs``. On affectera à ce groupe toutes les permissions sur les objets de l'application ``p4l``.
+il suffira ensuite de mettre les utilisateurs dans ce groupe (champ ``Groupes`` dans l'interface d'édition des utilisateurs). L'utilisateur héritera alors des permissions du groupe.
Lancement d'un script
@@ -279,8 +279,8 @@
Cependant les trois suivants seront les plus utiles:
* `args`: soit une séquence d'arguments de programme, soit une chaine de caractères
- * `cwd`: le chemin du reepertoire de travail. Par défaut : ``None``
- * `env`: dictionnire donnant les variables d'evironement positinnées durant l'éxeecution du script.
+ * `cwd`: le chemin du répertoire de travail. Par défaut : ``None``
+ * `env`: dictionnire donnant les variables d'environnement positionnées durant l'exécution du script.
Il est recommandé que ``args`` soit une liste d'arguments et non une simple chaîne de caractères.
@@ -297,15 +297,15 @@
Plusieurs points sont à noter:
- * L'utilisation de cette fonctionnalité est à priori réservé pour une application installé sous Unix. (cela peut fonctionner sous Windows, mais cela n'a pas été testé)
+ * L'utilisation de cette fonctionnalité est à priori réservé pour une application installé sous Unix. (Cela peut fonctionner sous Windows, mais cela n'a pas été testé)
* La fermeture de la fenêtre du navigateur ne stoppe pas la commande
* En particulier si la session de l'utilisateur expire ou bien que la fenêtre du browser est fermée, il n'y a plus possibilité de stopper le processus à partir d'un browser.
- Le processus devra être interompu par les moyens habituels directement sur le serveur
- * La commande est lancée dans le contexte du serveur web. Elle est donc executé par l'utilisateur du serveur web et hérite de ces droits d'accès.
+ Le processus devra être interrompu par les moyens habituels directement sur le serveur
+ * La commande est lancée dans le contexte du serveur web. Elle est donc exécuté par l'utilisateur du serveur web et hérite de ces droits d'accès.
* Tout démarrage du serveur web stoppe la commande.
- * La commande partage les ressources du serveurs web. Attention donc à ne pas lancer des commandes trop gourmandes en ressources, cela peut avoir des conséquences sur la stabilité du serveur web et sa disponibilité.
+ * La commande partage les ressources du serveur web. Attention donc à ne pas lancer des commandes trop gourmandes en ressources, cela peut avoir des conséquences sur la stabilité du serveur web et sa disponibilité.
* L'affichage de la sortie de la commande dans le browser se fait ligne par ligne.
Si la sortie de la commande ne comporte pas de caractère de retour à la ligne (``"\n"``) rien ne s'affichera avant la fin de la commande.
* Les sorties erreur et standard sont affichée ensemble sans différentiation.
-
\ No newline at end of file
+