lists.rst 10.1 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
l'année, les catégories, les équipes, les projets, *etc*. Un example de
LE GAC Renaud's avatar
LE GAC Renaud committed
10
liste est montré sur la :numref:`fig-out-lists`.
11 12 13 14 15 16 17 18 19 20

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

LE GAC Renaud's avatar
LE GAC Renaud committed
22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57
Par défaut, les neuf listes de la :numref:`table-lists` ont été implémentées.

    .. tabularcolumns:: p{6cm}p{8cm}

    .. _table-lists:

    .. table:: Les listes implémentées par défaut.

        +--------------------------------------+-------------------------------------------+
        | *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*                               | liste utilisée pour les dialogues de      |
        |                                      | gestion. Elle est très similaire à 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                                 |
        +--------------------------------------+-------------------------------------------+
LE GAC Renaud's avatar
LE GAC Renaud committed
58 59 60 61 62 63


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

LE GAC Renaud's avatar
LE GAC Renaud committed
64 65 66
    .. index::
        pair: Rapports; listes

LE GAC Renaud's avatar
LE GAC Renaud committed
67
    .. line-block::
LE GAC Renaud's avatar
LE GAC Renaud committed
68

LE GAC Renaud's avatar
LE GAC Renaud committed
69
        ``Rapports > listes``
LE GAC Renaud's avatar
LE GAC Renaud committed
70

LE GAC Renaud's avatar
LE GAC Renaud committed
71
Le panneau de droite est maintenant divisé en deux parties comme le montre la
LE GAC Renaud's avatar
LE GAC Renaud committed
72 73 74 75 76 77 78 79 80 81 82
: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
83
cette exécution. Il comprend sept conditions :
LE GAC Renaud's avatar
LE GAC Renaud committed
84 85 86 87 88 89

    * **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
90
        la liste est réduite aux enregistrements appartenant à l'équipe.
LE GAC Renaud's avatar
LE GAC Renaud committed
91
    * **Projet**
LE GAC Renaud's avatar
LE GAC Renaud committed
92
        la liste est réduite aux enregistrements appartenant au projet.
LE GAC Renaud's avatar
LE GAC Renaud committed
93
    * **Catégorie**
LE GAC Renaud's avatar
LE GAC Renaud committed
94
        la liste est réduite aux enregistrements appartenant à une catégorie.
LE GAC Renaud's avatar
LE GAC Renaud committed
95
    * **Auteur**
LE GAC Renaud's avatar
LE GAC Renaud committed
96
        la liste est réduite aux enregistrements pour lesquels le champ
LE GAC Renaud's avatar
LE GAC Renaud committed
97 98 99 100
        auteur contient la valeur spécifiée.
    * **Liste**
        la liste prédéfinie que l'on veut fabriquer.
    * **Format**
LE GAC Renaud's avatar
LE GAC Renaud committed
101
        la liste peut être exportée au format BibTex, CSV, HTML, LaTeX ou PDF.
LE GAC Renaud's avatar
LE GAC Renaud committed
102 103 104 105 106 107 108 109 110 111 112 113 114 115 116

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

LE GAC Renaud's avatar
LE GAC Renaud committed
117
    #. **moteur de rendu**
LE GAC Renaud's avatar
LE GAC Renaud committed
118 119
        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
120
    #. **section**
LE GAC Renaud's avatar
LE GAC Renaud committed
121
        associe une catégorie de publications avec un moteur de rendu
LE GAC Renaud's avatar
LE GAC Renaud committed
122
    #. **la liste elle-même**
LE GAC Renaud's avatar
LE GAC Renaud committed
123
         qui est un ensemble ordonné de sections
LE GAC Renaud's avatar
LE GAC Renaud committed
124 125 126

Les actions :

LE GAC Renaud's avatar
LE GAC Renaud committed
127 128 129 130 131 132 133 134 135
    .. 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
136
    .. line-block::
LE GAC Renaud's avatar
LE GAC Renaud committed
137

LE GAC Renaud's avatar
LE GAC Renaud committed
138 139 140
        ``Configurer les listes > moteurs de rendu``
        ``Configurer les listes > sections``
        ``Configurer les listes > listes``
LE GAC Renaud's avatar
LE GAC Renaud committed
141 142 143 144 145

créent ou modifient ces éléments.

Moteur de rendu
^^^^^^^^^^^^^^^
LE GAC Renaud's avatar
LE GAC Renaud committed
146 147 148 149 150 151 152 153 154 155 156

    .. _fig-form-renderers:

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

       Le formulaire pour créer un nouveau moteur de rendu.

Le formulaire de saisie d'un moteur de rendu est montré sur la
:numref:`fig-form-renderers`. Il est composé de quatre champs :
LE GAC Renaud's avatar
LE GAC Renaud committed
157 158 159 160

    * **moteur de rendu**
        le nom du moteur
    * **Patron**
LE GAC Renaud's avatar
LE GAC Renaud committed
161 162 163
        par exemple pour des articles publiés :

            .. line-block::
LE GAC Renaud's avatar
LE GAC Renaud committed
164

LE GAC Renaud's avatar
LE GAC Renaud committed
165 166 167
                {``publications.title``}, {``publications.first_author``} et al.,
                {``collaborations.collaboration``}, {``publishers.abbreviation``}
                {``publications.volume``} ({``publications.year``}) {``publications.pages``}
LE GAC Renaud's avatar
LE GAC Renaud committed
168 169

        Dans cette construction, les champs de la base de données sont entre
LE GAC Renaud's avatar
LE GAC Renaud committed
170
        pair de crocher ``{...}`` et séparés les uns des autres par des caractères
LE GAC Renaud's avatar
LE GAC Renaud committed
171 172
        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
173
        et par le nom du champ. Les valeurs possibles sont explicitées dans
LE GAC Renaud's avatar
LE GAC Renaud committed
174
        l'annexe :ref:`schema`.
LE GAC Renaud's avatar
LE GAC Renaud committed
175 176 177

    * **Post-processing**
        Quand la référence bibliographique est construite il est possible de la
LE GAC Renaud's avatar
LE GAC Renaud committed
178
        polir. Quatre fonctions sont disponibles :
LE GAC Renaud's avatar
LE GAC Renaud committed
179

LE GAC Renaud's avatar
LE GAC Renaud committed
180
            .. tabularcolumns:: Lp{7cm}
LE GAC Renaud's avatar
LE GAC Renaud committed
181

LE GAC Renaud's avatar
LE GAC Renaud committed
182 183 184 185 186 187
            +--------------------------+-----------------------------------------------+
            | ``clean``                | nettoie les espaces et les virgules           |
            +--------------------------+-----------------------------------------------+
            | ``highlight_my_authors`` | les auteurs du laboratoire sont sous-lignés   |
            +--------------------------+-----------------------------------------------+
            | ``highlight_my_speaker`` |l'orateur, membre du laboratoire, est en gras, |
LE GAC Renaud's avatar
LE GAC Renaud committed
188
            |                          |les signataires du laboratoire sous-ligné      |
LE GAC Renaud's avatar
LE GAC Renaud committed
189 190 191
            +--------------------------+-----------------------------------------------+
            | ``remove_undef``         | enlève le terme *indéfini*                    |
            +--------------------------+-----------------------------------------------+
LE GAC Renaud's avatar
LE GAC Renaud committed
192

LE GAC Renaud's avatar
LE GAC Renaud committed
193 194 195 196 197 198 199
    * **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
200
et triées selon certains critères.
LE GAC Renaud's avatar
LE GAC Renaud committed
201

LE GAC Renaud's avatar
LE GAC Renaud committed
202 203 204 205 206 207 208 209 210 211
    .. _fig-form-sections:

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

       Le formulaire pour créer une nouvelle section.

Le formulaire de saisie d'une section est montré sur la
:numref:`fig-form-sections`. Il est composé de six champs :
LE GAC Renaud's avatar
LE GAC Renaud committed
212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229

    * **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
LE GAC Renaud's avatar
LE GAC Renaud committed
230 231 232 233 234 235 236
son organisé selon une arborescence. Par exemple :

    .. line-block::

        ``section``
            ``année``
                ``publications``
LE GAC Renaud's avatar
LE GAC Renaud committed
237

LE GAC Renaud's avatar
LE GAC Renaud committed
238
ou
LE GAC Renaud's avatar
LE GAC Renaud committed
239

LE GAC Renaud's avatar
LE GAC Renaud committed
240
    .. line-block::
LE GAC Renaud's avatar
LE GAC Renaud committed
241

LE GAC Renaud's avatar
LE GAC Renaud committed
242 243 244 245
        ``section``
            ``équipe``
                ``année``
                    ``publications``
LE GAC Renaud's avatar
LE GAC Renaud committed
246 247


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

252 253 254 255 256 257 258 259 260 261 262
    .. _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
263
Les variables les plus importantes, pour définir une liste, sont :
LE GAC Renaud's avatar
LE GAC Renaud committed
264

265 266
    * **Général**
        le nom et la définition de la liste
LE GAC Renaud's avatar
LE GAC Renaud committed
267 268 269
    * **Sections**
        une liste de noms de section séparé par une virgule
    * **Trié par**
270 271 272
        définit l'arborescence.
    * **Substitution**
    * **Header/Footer**