Update docs/user to add the citations chapter.

docs/user/citations.rst

+.. include:: hyperlinks.txt
+
+
+Les citations
+-------------
+
+Pour les articles dont les notices sont stockées dans *inspirehep.net*
+le nombre de citations de chaque article est mise à jour régulièrement.
+Limbra interoge *insirehep.net* afin de stocker l'évolution
+du nombre de citations en fonction du temps pour chaque article.
+Cette procédure est automatisée. Elle a lieu tous les deux à trois jours.
+
+Plusieurs actions sont disponible pour manipuler cette information:
+
+    * ``Rapports > citations``
+        génére des graphes globaux pour le laboratoire, pour une equipe, *etc*
+        
+    * ``Rapports > top citations``
+        génère une table avec les articles les plus citées.
+        Cette action permet aussi d'extraire des données au format CSV
+        pour des analyses détaillées.
+        
+    * ``taches planifiées > citations``
+        permet de voir le compte rendu de la dernières mise 
+        à jour du nombre de citations par article.
+
+    .. attention::
+        Les estimateurs liés au nombre de citations doivent être 
+        interprétés avec beaucoup de précautions. 
+
+Les estimateurs globaux
+^^^^^^^^^^^^^^^^^^^^^^^
+
+Démarrer l'action :
+
+    .. index::
+        pair: Rapports; citations
+
+    .. line-block::
+
+        ``Rapports > citations``
+
+L'interface est similaire à celle de l'action ``Rapports > graphes`` 
+par exemple. 
+Le *Selector*, à droite, permet de définir les paramètres spécifiques à
+cette exécution. Il comprend six conditions :
+
+    * **Année**
+        le graphe est réduit aux enregistrements publiés dans l'année,
+        quand le premier champ est défini, ou pour chaque année d'une
+        période, quand les deux champs sont définis. Toutes les publications
+        sont utiliseé quand les deux champs sont vides.
+    * **Equipe**
+        le graphe est réduit aux enregistrements appartenant à l'équipe.
+    * **Projet**
+        le graphe est réduit aux enregistrements appartenant au projet.
+    * **Rôle**
+        le graphe est réduit aux enregistrement pour lequel le rôle des
+        auteurs corresponds à celui spécifié.
+    * **Graphe**
+        sélectionne le graphe que l'on veut construire.
+        Les valeurs possibles sont *Vue générale*, *Somme des citations*,
+        *Moyenne des citations par article* et *H-index*.
+    * **Format**
+        le graphe peut être exporté au format HTML, PDF ou PNG.
+
+Pour lancer la fabrication du graphe, entrer une condition puis taper
+sur la touche ``ENTER`` ou cliquer sur le bouton ``Go``.
+Le résultat apparaît dans le panneau central.
+
+
+La *Vue générale*, illustrée sur la :numref:`fig-citations-overview`, 
+compte le nombre d'articles en fonction du nombre de citations. 
+Son aussi calculer les estimateurs classiques :
+
+    * la somme total des citations
+    * le nombre moyen de citations par articles
+    * le facteur *h-index* 
+
+    .. _fig-citations-overview:
+
+    .. figure:: images/citations_overview.png
+       :align: center
+       :width: 80%
+
+       Histogram qui montre le nombre d'artclies en fonction
+       du nombre de citations.
+
+La *somme totale des citations* en fonction du temps est illusté sur la
+:numref:`fig-citations-sum`.
+Le deuxième graphe montre la différence du nombre de citations entre deux 
+*scans*. Attention, l'axe des *y* ne commence pas à zéro pour le premier plot.
+
+    .. _fig-citations-sum:
+
+    .. figure:: images/citations_sum.png
+       :align: center
+       :width: 80%
+
+       La somme totale des citations en fonctions du temps.
+
+La *nombre moyen de citation par article* en fonction du temps est illusté 
+sur la :numref:`fig-citations-avg`.
+Attention, l'axe des *y* ne commence pas à zéro.
+
+    .. _fig-citations-avg:
+
+    .. figure:: images/citations_avg.png
+       :align: center
+       :width: 80%
+
+       Le nombre moyen de citations par article en fonctions du temps.
+
+L'évolation du  *facteur h* en fonction du temps est illusté 
+sur la :numref:`fig-citations-h-index`.
+Attention, l'axe des *y* ne commence pas à zéro.
+
+    .. _fig-citations-h-index:
+
+    .. figure:: images/citations_h_index.png
+       :align: center
+       :width: 80%
+
+       Le facteur *h* en fonctions du temps.
+
+
+Les publications les plus citées
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Démarrer l'action :
+
+    .. index::
+        pair: Rapports; top citations
+
+    .. line-block::
+
+        ``Rapports > top citations``
+
+L'interface est similaire à celle de l'action ``Rapports > graphes`` 
+par exemple. 
+Le *Selector*, à droite, permet de définir les paramètres spécifiques à
+cette exécution. Il comprend cinq conditions :
+
+    * **Année**
+        la liste est réduite aux enregistrements publiés dans l'année,
+        quand le premier champ est défini, ou pour chaque année d'une
+        période, quand les deux champs sont définis. Toutes les publications
+        sont utiliseé quand les deux champs sont vides.
+    * **Equipe**
+        la liste est réduite aux enregistrements appartenant à l'équipe.
+    * **Projet**
+        la liste est réduite aux enregistrements appartenant au projet.
+    * **Rôle**
+        la liste est réduite aux enregistrement pour lequel le rôle des
+        auteurs corresponds à celui spécifié.
+    * **top**
+        définit le nombre de publications avec le plus grand nombre de 
+        citations qui seront cités dans la liste.
+        Il permet de construire le *top 10* ou *top 50* par exemple.
+
+Pour construire la liste, entrer une condition puis taper
+sur la touche ``ENTER`` ou cliquer sur le bouton ``Go``.
+Le résultat apparaît dans le panneau central.
+
+La figure montre un example de *top 10*
+
+    .. _fig-citations-top-10:
+
+    .. figure:: images/citations_top_10.png
+       :align: center
+       :width: 80%
+
+       La liste des 10 publication avec le plus grand nombre de citations.
+
+Extraction des données pour une analyse détaillée
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 
+
+L'action ``Rapports > top citations`` permet aussi d'extraire des données
+au format CSV afin d'effectué des analyses détaillées.
+
+La table contient les information suivante :
+
+    * domaine scientifique
+    * équipe
+    * projet
+    * référence de la publication
+    * nombre de citations
+    * année de la publication
+    
+Après avoir généré la liste, l'extraction s'effectue en deux temps:
+
+    1. selectioner les colonnes de la table que vous voulez extraire.
+       Pour cela il suffit de cliquer sur la fléche qui apparait quand le
+       curseur de la souris survole l'entête d'une colonne.
+    2. positioner le curseur sur la table, cliquer sur le bouton droit,
+       puis cliquer dans le menu sur la ligne ``Exporter en CSV...``.
+       
\ No newline at end of file

docs/user/graphs.rst

@@ -106,7 +106,7 @@ Le panneau de droite est maintenant divisé en deux parties comme le montre la
 
        Construire un graphe.
 
-La *Selector*, à droite, permet de définir les paramètres spécifiques à
+Le *Selector*, à droite, permet de définir les paramètres spécifiques à
 cette exécution. Il comprend huits conditions :
 
     * **Année**
@@ -132,7 +132,8 @@ cette exécution. Il comprend huits conditions :
     * **Format**
         le graphe peut être exporté au format HTML, PDF ou PNG.
 
-Pour lancer la fabrication du graphe, cliquer sur le bouton ``Go``.
+Pour lancer la fabrication du graphe, taper
+sur la touche ``ENTER`` ou cliquer sur le bouton ``Go``.
 Le résultat apparaît dans le panneau central.
 
 Créer un nouveau graphe

docs/user/index.rst

@@ -20,6 +20,7 @@ Guide utilisateur
     lists
     metrics
     graphs
+    citations
     roles
     check_validate
     workflow

docs/user/lists.rst

@@ -100,8 +100,10 @@ cette exécution. Il comprend sept conditions :
     * **Format**
         la liste peut être exportée au format BibTex, LaTeX, ODT ou PDF.
 
-Pour lancer la fabrication de la liste cliquer sur le bouton ``Go``.
-Le résultat apparaît dans le panneau central quand le format HTML est sélectionné.
+Pour lancer la fabrication de la liste taper
+sur la touche ``ENTER`` ou cliquer sur le bouton ``Go``.
+Le résultat apparaît dans le panneau central quand le format HTML 
+est sélectionné.
 
 
     .. note::

docs/user/metrics.rst

@@ -95,7 +95,8 @@ cette exécution. Il comprend quatre conditions :
         le choix de la *métrique* et de l'*année* sont les
         conditions les plus importantes.
 
-Pour lancer la fabrication de la métrique, cliquer sur le bouton ``Go``.
+Pour lancer la fabrication de la métrique, taper
+sur la touche ``ENTER`` ou cliquer sur le bouton ``Go``.
 Le résultat apparaît dans le panneau central.
 
     .. note::