lists.rst 6.51 KB
Newer Older
LE GAC Renaud's avatar
LE GAC Renaud committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 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 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191
.. include:: hyperlinks.txt

Les listes
-----------

Un des buts de cette application et de produire des listes dans
lesquelles les publications sont ordonné selon différent critères comme
l'année, les catégories, les équipes, les projets, *etc*.

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**
        liste utilisée pour les dialogues de gestion. Elles 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


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

    .. code-block:: c

        Rapport > listes

Le panneau de droite est maintenant divisé en deux partie comme le montre la
: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 à
cette exécution. Il comprends sept conditions :

    * **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**
        la liste est réduite au enregistrements appartenant à l'équipe.
    * **Projet**
        la liste est réduite au enregistrements appartenant au projet.
    * **Catégorie**
        la liste est réduite au enregistrements appartenant à une catégorie.
    * **Auteur**
        la liste est réduite au enregistrements pour lesquels le champ
        auteur contient la valeur spécifiée.
    * **Liste**
        la liste prédéfinie que l'on veut fabriquer.
    * **Format**
        la liste est produite au format PDF ou LaTeX.

    .. 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**
        est un patron qui définit comment utiliser le champs de la base de
        donnée pour représenté une référence bibliographique
    * **section**
        associe une catégorie de publications avec un moteur de rendu
    * **la liste elle-même**
         qui est une ensemble ordonné de sections

Les actions :

    .. code-block:: c

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

créent ou modifient ces éléments.

Moteur de rendu
^^^^^^^^^^^^^^^
un moteur de rendu est défini par quatre variables:

    * **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
        pair de crocher ``{...}`` et séparés les uns de autres par des caractère
        alphanumérique.
        Les champs de la base de donnée sont définis par le nom de la table
        et par le nom du champ. Les valeurs possible sont explicitées dans
        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
        polir. Quatre fonctions sont disponible :

                ===================== ===========================================
                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*
                ===================== ===========================================
    * **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
et triées selon certain critères.

Une section est définie par six variables:

    * **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


L'arborescence est construites à partir des informations
sur les catégories, les équipes, les pays, les projets, les revues, les status
et le temps (année). Le nombre de niveau est limité à quatre.

Les variables les plus importantes, pour définir une liste, sont:

    * **Liste**
        le nom de la liste
    * **Définition**
    * **Sections**
        une liste de noms de section séparé par une virgule
    * **Trié par**
        définit l'arborescence.