lists.rst 10.4 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 9
lesquelles les publications sont ordonnées selon différents critères comme
l'année, les catégories, les équipes, les projets, *etc*. Un exemple 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**
101
        la liste peut être exportée au format BibTex, LaTeX, ODT ou PDF.
LE GAC Renaud's avatar
LE GAC Renaud committed
102 103 104 105 106

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


107 108 109 110 111 112 113
    .. note::
        Pour mettre en page une liste avec un logiciel de traitement de texte
        comme LibreOffice_ ou Microsoft Word, il suffit
        d'exporter la liste au format OpenDocument_ ODT et
        d'ouvrir le fichier avec le logiciel de traitement de texte.
        Noter que dans ce cas de figure, les équations ne sont pas interprétées.

LE GAC Renaud's avatar
LE GAC Renaud committed
114 115 116 117 118 119
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
120
    #. **moteur de rendu**
LE GAC Renaud's avatar
LE GAC Renaud committed
121
        est un patron qui définit comment utiliser les champs de la base de
LE GAC Renaud's avatar
LE GAC Renaud committed
122
        données pour représenter une référence bibliographique
LE GAC Renaud's avatar
LE GAC Renaud committed
123
    #. **section**
LE GAC Renaud's avatar
LE GAC Renaud committed
124
        associe une catégorie de publications avec un moteur de rendu
LE GAC Renaud's avatar
LE GAC Renaud committed
125
    #. **la liste elle-même**
LE GAC Renaud's avatar
LE GAC Renaud committed
126
         qui est un ensemble ordonné de sections
LE GAC Renaud's avatar
LE GAC Renaud committed
127 128 129

Les actions :

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

LE GAC Renaud's avatar
LE GAC Renaud committed
141 142 143
        ``Configurer les listes > moteurs de rendu``
        ``Configurer les listes > sections``
        ``Configurer les listes > listes``
LE GAC Renaud's avatar
LE GAC Renaud committed
144 145 146 147 148

créent ou modifient ces éléments.

Moteur de rendu
^^^^^^^^^^^^^^^
LE GAC Renaud's avatar
LE GAC Renaud committed
149 150 151 152 153 154 155 156 157 158 159

    .. _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
160 161 162 163

    * **moteur de rendu**
        le nom du moteur
    * **Patron**
LE GAC Renaud's avatar
LE GAC Renaud committed
164 165 166
        par exemple pour des articles publiés :

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

LE GAC Renaud's avatar
LE GAC Renaud committed
168 169 170
                {``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
171 172

        Dans cette construction, les champs de la base de données sont entre
LE GAC Renaud's avatar
LE GAC Renaud committed
173
        pair de crocher ``{...}`` et séparés les uns des autres par des caractères
LE GAC Renaud's avatar
LE GAC Renaud committed
174
        alphanumérique.
LE GAC Renaud's avatar
LE GAC Renaud committed
175
        Les champs de la base de données sont définis par le nom de la table
LE GAC Renaud's avatar
LE GAC Renaud committed
176
        et par le nom du champ. Les valeurs possibles sont explicitées dans
177
        l'annexe :ref:`dbfields`.
LE GAC Renaud's avatar
LE GAC Renaud committed
178 179 180

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

LE GAC Renaud's avatar
LE GAC Renaud committed
183
            .. tabularcolumns:: Lp{7cm}
LE GAC Renaud's avatar
LE GAC Renaud committed
184

LE GAC Renaud's avatar
LE GAC Renaud committed
185 186 187 188 189 190
            +--------------------------+-----------------------------------------------+
            | ``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
191
            |                          |les signataires du laboratoire soulignés       |
LE GAC Renaud's avatar
LE GAC Renaud committed
192 193 194
            +--------------------------+-----------------------------------------------+
            | ``remove_undef``         | enlève le terme *indéfini*                    |
            +--------------------------+-----------------------------------------------+
LE GAC Renaud's avatar
LE GAC Renaud committed
195

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

LE GAC Renaud's avatar
LE GAC Renaud committed
205 206 207 208 209 210 211 212 213 214
    .. _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
215 216 217 218 219 220 221 222 223 224 225

    * **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**
LE GAC Renaud's avatar
LE GAC Renaud committed
226
        ordonne les publications à partir des valeurs du champ spécifié.
LE GAC Renaud's avatar
LE GAC Renaud committed
227 228 229 230 231 232
        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
233 234 235 236 237 238 239
son organisé selon une arborescence. Par exemple :

    .. line-block::

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

LE GAC Renaud's avatar
LE GAC Renaud committed
241
ou
LE GAC Renaud's avatar
LE GAC Renaud committed
242

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

LE GAC Renaud's avatar
LE GAC Renaud committed
245 246 247 248
        ``section``
            ``équipe``
                ``année``
                    ``publications``
LE GAC Renaud's avatar
LE GAC Renaud committed
249 250


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

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

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