lists.rst 7.32 KB
Newer Older
LE GAC Renaud's avatar
LE GAC Renaud committed
1 2
.. include:: hyperlinks.txt

LE GAC Renaud's avatar
LE GAC Renaud committed
3

LE GAC Renaud's avatar
LE GAC Renaud committed
4 5 6 7
Les listes
-----------

Un des buts de cette application et de produire des listes dans
LE GAC Renaud's avatar
LE GAC Renaud committed
8
lesquelles les publications sont ordonné selon différents critères comme
9 10 11 12 13 14 15 16 17 18 19 20
l'année, les catégories, les équipes, les projets, *etc*. Un example de
liste est montré sur la :numref:`fig-out-lists`

    .. _fig-out-lists:

    .. figure:: images/out-lists.png
       :align: center
       :width: 90%

       La liste des articles pour l'équipe *Astronomie neutrino et gamma*
       en 2015.

LE GAC Renaud's avatar
LE GAC Renaud committed
21 22 23 24 25 26 27 28 29 30 31 32 33 34 35

Par défaut, neuf listes ont été implémentées:

    * **catégorie AERES / année**
        les publications sont ordonnées par catégorie AERES
        puis pour chaque catégorie par année.
    * **catégorie AERES / projet / année**
        les publications sont ordonnées par catégorie AERES
        puis pour chaque catégorie par projet puis pour chaque projet par année.
    * **catégorie usuelle / année**
    * **catégorie usuelle / équipe / année**
    * **catégorie usuelle / projet / année**
    * **CRAC**
        format adapté pour remplir un CRAC
    * **EAOM**
LE GAC Renaud's avatar
LE GAC Renaud committed
36
        liste utilisée pour les dialogues de gestion. Elle est très similaire
LE GAC Renaud's avatar
LE GAC Renaud committed
37 38 39 40 41 42 43 44 45 46 47 48
        à la liste *catégorie AERES / projet / année*
    * **HDR / équipe / année**
        la liste des Habilitations à diriger les recherche par équipe puis
        par année
    * **PhD / équipe / année**
        la liste des Doctorats par équipe puis par année


Exécuter une liste prédéfinie
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Pour fabriquer une liste, démarrer l'action :

LE GAC Renaud's avatar
LE GAC Renaud committed
49 50 51
    .. index::
        pair: Rapports; listes

LE GAC Renaud's avatar
LE GAC Renaud committed
52
    ::
LE GAC Renaud's avatar
LE GAC Renaud committed
53

LE GAC Renaud's avatar
LE GAC Renaud committed
54
        Rapports > listes
LE GAC Renaud's avatar
LE GAC Renaud committed
55

LE GAC Renaud's avatar
LE GAC Renaud committed
56
Le panneau de droite est maintenant divisé en deux parties comme le montre la
LE GAC Renaud's avatar
LE GAC Renaud committed
57 58 59 60 61 62 63 64 65 66 67
:numref:`fig-home-lists`.

    .. _fig-home-lists:

    .. figure:: images/home-lists.png
       :align: center
       :width: 90%

       Fabriquer une liste.

La *Selector*, à droite, permet de définir les paramètres spécifiques à
LE GAC Renaud's avatar
LE GAC Renaud committed
68
cette exécution. Il comprend sept conditions :
LE GAC Renaud's avatar
LE GAC Renaud committed
69 70 71 72 73 74

    * **Année**
        la liste est réduite aux enregistrements publiés dans l'année,
        quand le premier champ est défini, ou pendant une période couvrant
        plusieurs années, quand les deux champs sont définis.
    * **Equipe**
LE GAC Renaud's avatar
LE GAC Renaud committed
75
        la liste est réduite aux enregistrements appartenant à l'équipe.
LE GAC Renaud's avatar
LE GAC Renaud committed
76
    * **Projet**
LE GAC Renaud's avatar
LE GAC Renaud committed
77
        la liste est réduite aux enregistrements appartenant au projet.
LE GAC Renaud's avatar
LE GAC Renaud committed
78
    * **Catégorie**
LE GAC Renaud's avatar
LE GAC Renaud committed
79
        la liste est réduite aux enregistrements appartenant à une catégorie.
LE GAC Renaud's avatar
LE GAC Renaud committed
80
    * **Auteur**
LE GAC Renaud's avatar
LE GAC Renaud committed
81
        la liste est réduite aux enregistrements pour lesquels le champ
LE GAC Renaud's avatar
LE GAC Renaud committed
82 83 84 85
        auteur contient la valeur spécifiée.
    * **Liste**
        la liste prédéfinie que l'on veut fabriquer.
    * **Format**
86
        la liste est produite au format BibTex, CSV, HTML, LaTeX ou PDF.
LE GAC Renaud's avatar
LE GAC Renaud committed
87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102

    .. note::
        le choix de la *liste* et de l'*année* sont les
        conditions les plus importantes.

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é.


Créer une liste
^^^^^^^^^^^^^^^

Une liste est composée de trois éléments qui sont imbriqués les uns dans les
autres :

    * **moteur de rendu**
LE GAC Renaud's avatar
LE GAC Renaud committed
103 104
        est un patron qui définit comment utiliser les champs de la base de
        donnée pour représenter une référence bibliographique
LE GAC Renaud's avatar
LE GAC Renaud committed
105 106 107
    * **section**
        associe une catégorie de publications avec un moteur de rendu
    * **la liste elle-même**
LE GAC Renaud's avatar
LE GAC Renaud committed
108
         qui est un ensemble ordonné de sections
LE GAC Renaud's avatar
LE GAC Renaud committed
109 110 111

Les actions :

LE GAC Renaud's avatar
LE GAC Renaud committed
112 113 114 115 116 117 118 119 120
    .. index::
        pair: Configurer les listes; moteurs de rendu

    .. index::
        pair: Configurer les listes; sections

    .. index::
        pair: Configurer les listes; listes

LE GAC Renaud's avatar
LE GAC Renaud committed
121
    ::
LE GAC Renaud's avatar
LE GAC Renaud committed
122 123 124 125 126 127 128 129 130

        Configurer les listes > moteurs de rendu
        Configurer les listes > sections
        Configurer les listes > listes

créent ou modifient ces éléments.

Moteur de rendu
^^^^^^^^^^^^^^^
LE GAC Renaud's avatar
LE GAC Renaud committed
131
un moteur de rendu est défini par quatre variables :
LE GAC Renaud's avatar
LE GAC Renaud committed
132 133 134 135 136 137 138 139 140 141 142

    * **moteur de rendu**
        le nom du moteur
    * **Patron**
        par exemple pour des articles publiés : ::

            {publications.title}, {publications.first_author} et al.,
            {collaborations.collaboration}, {publishers.abbreviation}
            {publications.volume} ({publications.year}) {publications.pages}

        Dans cette construction, les champs de la base de données sont entre
LE GAC Renaud's avatar
LE GAC Renaud committed
143
        pair de crocher ``{...}`` et séparés les uns des autres par des caractères
LE GAC Renaud's avatar
LE GAC Renaud committed
144 145
        alphanumérique.
        Les champs de la base de donnée sont définis par le nom de la table
LE GAC Renaud's avatar
LE GAC Renaud committed
146
        et par le nom du champ. Les valeurs possibles sont explicitées dans
LE GAC Renaud's avatar
LE GAC Renaud committed
147 148 149 150 151
        le schéma de la base de données.
        Ce dernier est consultable via l'action ``Aide > documentations``.

    * **Post-processing**
        Quand la référence bibliographique est construite il est possible de la
LE GAC Renaud's avatar
LE GAC Renaud committed
152
        polir. Quatre fonctions sont disponibles :
LE GAC Renaud's avatar
LE GAC Renaud committed
153 154 155 156 157 158 159 160

                ===================== ===========================================
                clean                 nettoie les espaces et les virgules
                hightlight_my_authors les auteurs du laboratoire sont sous-lignés
                hightlight_my_speaker l'orateur, membre du laboratoire, est en gras,
                                      les signataire du laboratoire sous-ligné
                remove_undef          enlève le terme *indéfini*
                ===================== ===========================================
LE GAC Renaud's avatar
LE GAC Renaud committed
161

LE GAC Renaud's avatar
LE GAC Renaud committed
162 163 164 165 166 167 168
    * **Defintion**


Section
^^^^^^^
Une section contient les publications d'une certaines catégories. Elles seront
représentées par une référence bibliographique construire par un moteur de rendu
LE GAC Renaud's avatar
LE GAC Renaud committed
169
et triées selon certains critères.
LE GAC Renaud's avatar
LE GAC Renaud committed
170

LE GAC Renaud's avatar
LE GAC Renaud committed
171
Une section est définie par six variables :
LE GAC Renaud's avatar
LE GAC Renaud committed
172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203

    * **Section**
        le nom de la section.
    * **Moteur de rendu**
        le moteur de rendu attaché à cette section.
    * **Code des catégories**
        le(s) code AERES des publications, séparés par une virgule.
    * **Conditions**
        opérations logiques, appliquées uniquement sur les champs de la table
        ``publications``, écrite en langage naturel.
    * **Trier par**
        ordonne les publications à partie des valeurs du champ spécifié.
        Il doit appartenir à la table ``publications``.
    * **Définition**

Liste
^^^^^
Une liste est une collection de sections dans lesquelles les publications
son organisé selon une arborescence. Par exemple : ::

    section
        année
            publications

ou ::

    section
        équipe
            année
                publications


LE GAC Renaud's avatar
LE GAC Renaud committed
204
L'arborescence est construite à partir des informations
LE GAC Renaud's avatar
LE GAC Renaud committed
205
sur les catégories, les équipes, les pays, les projets, les revues, les status
LE GAC Renaud's avatar
LE GAC Renaud committed
206
et le temps (année). Le nombre de niveaux est limité à quatre.
LE GAC Renaud's avatar
LE GAC Renaud committed
207

208 209 210 211 212 213 214 215 216 217 218
    .. _fig-form-lists:

    .. figure:: images/form-lists.png
       :align: center
       :width: 50%

       Le formulaire pour créer une nouvelle list.

Le formulaire de saisie, pour créer une nouvelle liste, est montré sur
la :numref:`fig-form-lists`. Il comprend cinq onglets :

LE GAC Renaud's avatar
LE GAC Renaud committed
219
Les variables les plus importantes, pour définir une liste, sont :
LE GAC Renaud's avatar
LE GAC Renaud committed
220

221 222
    * **Général**
        le nom et la définition de la liste
LE GAC Renaud's avatar
LE GAC Renaud committed
223 224 225
    * **Sections**
        une liste de noms de section séparé par une virgule
    * **Trié par**
226 227 228
        définit l'arborescence.
    * **Substitution**
    * **Header/Footer**