lists.rst 8.18 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 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 132 133 134 135 136 137 138 139 140 141

    .. _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
142 143 144 145 146 147 148 149 150 151 152

    * **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
153
        pair de crocher ``{...}`` et séparés les uns des autres par des caractères
LE GAC Renaud's avatar
LE GAC Renaud committed
154 155
        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
156
        et par le nom du champ. Les valeurs possibles sont explicitées dans
LE GAC Renaud's avatar
LE GAC Renaud committed
157 158 159 160 161
        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
162
        polir. Quatre fonctions sont disponibles :
LE GAC Renaud's avatar
LE GAC Renaud committed
163

LE GAC Renaud's avatar
LE GAC Renaud committed
164 165 166 167 168 169 170 171 172 173 174
            .. tabularcolumns:: Lp{7cm}
            +--------------------------+-----------------------------------------------+
            | ``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, |
            |                          |les signataire du laboratoire sous-ligné       |
            +--------------------------+-----------------------------------------------+
            | ``remove_undef``         | enlève le terme *indéfini*                    |
            +--------------------------+-----------------------------------------------+
LE GAC Renaud's avatar
LE GAC Renaud committed
175

LE GAC Renaud's avatar
LE GAC Renaud committed
176 177 178 179 180 181 182
    * **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
183
et triées selon certains critères.
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 191 192 193 194
    .. _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
195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226

    * **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
227
L'arborescence est construite à partir des informations
LE GAC Renaud's avatar
LE GAC Renaud committed
228
sur les catégories, les équipes, les pays, les projets, les revues, les status
LE GAC Renaud's avatar
LE GAC Renaud committed
229
et le temps (année). Le nombre de niveaux est limité à quatre.
LE GAC Renaud's avatar
LE GAC Renaud committed
230

231 232 233 234 235 236 237 238 239 240 241
    .. _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
242
Les variables les plus importantes, pour définir une liste, sont :
LE GAC Renaud's avatar
LE GAC Renaud committed
243

244 245
    * **Général**
        le nom et la définition de la liste
LE GAC Renaud's avatar
LE GAC Renaud committed
246 247 248
    * **Sections**
        une liste de noms de section séparé par une virgule
    * **Trié par**
249 250 251
        définit l'arborescence.
    * **Substitution**
    * **Header/Footer**