diff --git a/hal/templates/hal/aide.html b/hal/templates/hal/aide.html index b028b051886be0e6e170b25e4985907d38ed3b11..86f38c34ba4558bdbfa03de982847a37494086a1 100644 --- a/hal/templates/hal/aide.html +++ b/hal/templates/hal/aide.html @@ -17,64 +17,162 @@ <h3>Aide Haltools</h3> <br/> -<br/> -<h4 align="justify">Cette page explique comment bien utiliser les différents outils de cette application.</h4> -<br/> +<h4 align="justify">Principes et différents outils de cette application.</h4> + <br/> <h4 align="left"> <b><u>Sommaire</u></b> <br/> -<a href="#dblp_2_hal">Dblp_2_Hal</a> <br/> -<a href="#dblp_2_xml">Create XML (from DBLP)</a> <br/> +<br/> +<a href="#recup_data">Récupération des données</a> <br/> +<a href="#fix_data">Correction des données</a> <br/> +<a href="#imports">Imports dans HAL et en préprod</a> <br/> +<br/> +<a href="#bibtex_2_hal">Bibtex_2_Hal</a> <br/> +<a href="#create_xml">Create XML</a> <br/> <a href="#text_2_hal">Text_2_Hal</a> <br/> -<a href="#text_2_xml">Create XML (from text)</a> <br/> <a href="#modif_text">Modify Text</a> <br/> -<a href="#format_text_rg">Format Text from Research Gate</a> <br/> + <a href="#list_domains">Liste des domaines</a> <br/> </h4> + +<p align="left"><b><u><a id="recup_data"></a>Récupération des données</u></b></p> +Les données sur les publications peuvent être transmises au format bibtex ou au format texte<br/> <br/> -<p align="left"><b><u><a id="dblp_2_hal"></a>Dblp_2_Hal</u></b></p> -<p align="justify"> -Cet outil permet d'importer un contenu de <a href="https://dblp.uni-trier.de/" target="_blank">DBLP</a> au format Bibtex dans la base HAL ou dans la base de préproduction de HAL. + + + <div class="row"> + <div class="col-lg-6"> + + <u>Au format Bibtex</u><br/> + Les données sont assez structurées. Ces infos sont récupérées :<br/> + + + <ul> + <li>type de publis</li> + <li>titre</li> + <li>auteurs</li> + <li>journaux et conférences</li> + <li>nb de pages</li> + <li>volume</li> + <li>date</li> + <li>doi</li> + </ul> + + </div> + <div class="col-lg-6"> + <i> + @inproceedings{DBLP:conf/scsc/CongoTH18,<br/> + author = {Faical Y. P. Congo and + Mamadou K. Traor{\'{e}} and + David R. C. Hill},<br/> + title = {Computation operations caching for numerical repeatability},<br/> + booktitle = {Proceedings of the 50th Computer Simulation Conference, SummerSim<br/> + 2018, Bordeaux, France, July 09-12, 2018},<br/> + pages = {28:1--28:12},<br/> + year = {2018},<br/> + ...<br/> + }</i> + </div> + </div> + + +Cependant, selon les sources du Bibtex, les auteurs sont formatés de façon différentes. +Il est nécessaire de spécifier une source pour différencier les auteurs, récupérer les +villes et pays des conférences (nécessaires pour HAL) +<br/> +Pour l'instant, la seule source est DBLP +<br/> +<br/> +<u>Au format Texte</u><br/> +Les données sont très peu structurées. Mais le format standard +d'une publication se présente ainsi : +<ul> + <li>auteurs séparés par une virgule</li> + <li>titre entre guillemets</li> + <li>le journal ou la conf puis le nb de pages, le volume, le DOI, l'année, ..., séparés par des virgules</li> +</ul> + +<br/> +En formatant les données avec l'outil <a href="#modif_text">modify_text</a>, il est possible d'obtenir un format standard qui peut être importé.<br/> +Il est alors possible de récupérer les données suivantes : +<ul> + <li>type de publis</li> + <li>titre</li> + <li>auteurs</li> + <li>journaux et conférences</li> + <li>nb de pages</li> + <li>volume</li> + <li>date</li> + <li>doi</li> +</ul> <br/> -Pour information, la base DBLP ne récupère que certaines publications (articles, conférences, posters, ouvrages) et n'est donc pas exhaustif sur le travail du chercheur. +Le fromat attendu est le suivant :<br/> +RI1 - COQUILLARD P., HILL D., "Object-oriented Simulation of Scots Pine Growth interactions", Simulation, July 24-26, 1995, Ottawa, CANADA, pp. 917-923, Vol.65.<br/> +O1 - HILL D., "Analyse Orientée-Objets et Modélisation par Simulation", Addison-Wesley, 1993<br/> +CI1 - Gourgand M., HILL D., "Petri Nets Modelling on Transputers", SCS European Simulation Symposium ESS 90, Ghent, BELGIUM, Nov 8-10, 1990, pp. 143-148.<br/> <br/> -Pour récupérer ce contenu, dans DBLP, rechercher l'auteur et cliquez sur le lien <u>bibtex</u> dans <u>export bibliography</u> +La numérotation avant le tiret sert à indiquer le type de publi <br/> +- RI : revues internationales<br/> +- RN : revues nationales<br/> +- CI : conférences internationales<br/> +- CN : conférences nationales<br/> +- O : ouvrages<br/> +- CO : chapitres d'ouvrages<br/> +- P : posters<br/> </p> <br/> + +<p align="left"><b><u><a id="fix_data"></a>Correction des données</u></b></p> +<br/> +Quelle que soit la source, il est intéressant de simuler un dépôt et de +contrôler et corriger les résultats avant de faire un vrai dépôt. <br/> +Le résultat indique tout d'abord quelles sont les publis déja présentes dans HAL et lesquelles +sont susceptibles d'être déposées. <br/> +<br/> +Dans la première partie des résultats sont indiqués le nombre de publications recensées dan la source, +puis les publications déja existantes dans HAL (une requête est lancée avec le titre) puis les dépôts +et les tentatives de dépôts s'étant soldées par un echec (problèmes de dépôts).<br/> +A noter qu'en mode simulation, aucun dépôt n'est fait et tous les potentiels dépôts se retrouvent +dans la catégorie "problèmes de dépôts". +</p> + <p align="center"> -<img src="{% static 'img/dblp_hal_help1.png' %}" > </p> +<img src="{% static 'img/aide_res_corr1.png' %}" > </p> <br/> <p align="justify"> -Une page présentant le contenu des publis au format bibtex s'ouvre et vous pouvez cliquer sur le lien <u>download as .bib file</u> pour télécharger ce fichier. -<br/><br/> -Copiez-collez le contenu de ce fichier dans l'emplacement prévu nommé <b>contenu bibtex</b> -<br/><br/> -Renseignez les différents champs (ceux avec une étoile sont obligatoires) -<br/><br/> -La <b>forme auteur</b> correspond à la dénomination littérale de l'auteur dans le fichier bibtex. -<br> -Cette forme peut être simple : <i>Jean Mailfert</i> ou plus complexe en cas d'accent ou de tiret : <i>S{\'{e}}bastien Cipi{\`{e}}re}</i> -</br><br/> -Le <b>nom</b> et <b>prénom</b> du chercheur correspondent à ce que vous souhaitez voir apparaître dans HAL -<br/><br/> -Le <b>login Hal</b> et l<b>'idHal</b> du chercheur doivent vous être fournis par l'auteur lui-même dans le cas d'un dépôt sur la base HAL. -<br/><br/> -Le <b>numéro de structure</b> correspond à son identifiant (id). Rentrez le nom de la structure sur la base AuréHAL pour l'obtenir et rentrez le tel quel (Ex : 490706) -<br/><br/> -Les <b>domaines</b> sont généralement fournis par le chercheur et s'appliquent à toutes les publications. +Dans la seconde partie des résultats sont indiqués sous forme de tableaux les données telles qu'elles +ont été récupérées.<br/> +Il est alors possible de vérifier la justesse des données récupérées. <br/> +Si un nombre de pages ou un volume n'apparait pas alors qu'il devrait être présent, +il manque sans doute une virgule avant ou après la donnée. <br/> <br/> -Cliquez <a href="#trav_equip">ici</a> pour en avoir la liste. +La ville, le pays et son acronyme doivent apparaître pour les conférences seulement, pour les autres +types de publis, la valeur par défaut est un champ vide ou la valeur "inconnue".<br/> <br/> -Au moins un domaine est nécessaire pour un import dans la base (Hal ou préprod) +Le champ "TODO" indique quelle sera l'action effectuée : <br/> +- E : une publi existe déjà avec le même titre dans HAL et aucun dépôt ne sera fait.<br/> +- D : la publi peut être déposée <br/> +- 2 : la publi existe déjà avec le même titre dans HAL en plusieurs exemplaires et aucun dépôt ne sera fait. <br/> + +</p> +<p align="center"> + <img src="{% static 'img/aide_res_corr2.png' %}" > </p> + <br/> + <p align="justify"> + <br/> + + + +<p align="left"><b><u><a id="imports"></a>Imports dans HAL et en préprod</u></b></p> <br/> Concernant le <b>choix des dépôts</b>: <br/> <ul> <li> - Vous pouvez choisir de laisser décocher pour ne pas déposer (et donc simuler les dépôts) afin d'obtenir une grille des résultats tels qu'ils seront rentrés en base. + Vous pouvez choisir de ne pas déposer (et donc simuler les dépôts) afin d'obtenir une grille des résultats tels qu'ils seront rentrés en base. </li> <li> Vous pouvez cocher la case <b>Base de préproduction</b>, ce qui importera les publis dans la <a href="https://hal.halpreprod.archives-ouvertes.fr/" target="_blank">base de préproduction</a>. @@ -86,15 +184,61 @@ Concernant le <b>choix des dépôts</b>: </li> </ul> <br/> -Une bonne pratique si on n'est pas sur du résultat est de commencer en laissant tout décoché pour simuler les dépôts et voir ce qui sera rentré. +Une bonne pratique si on n'est pas sur du résultat est de commencer en simulant les dépôts pour voir ce qui sera déposé. <br/> -Il est alors possible de corriger les erreurs dans le contenu du bibtex (DBLP peut aussi se tromper). +Il est alors possible de corriger les erreurs dans le contenu de la source. <br> Ensuite seulement, faire des dépôts. <br/><br/> +En cas d'erreur, il est toujours possible de supprimer des dépôts dont on est propriétaire mais il faut les sélectionner +un par un ce qui peut être un peu long pour un import d'une centaine de publications.<br/> La base de préproduction peut être intéressante pour présenter au chercheur les résultats tels qu'ils apparaitront sur HAL en lui fournissant ses identifiants sur la base de préproduction. </p> <br/> + + +<br/> +<p align="left"><b><u><a id="bibtex_2_hal"></a>Bibtex_2_Hal</u></b></p> +<p align="justify"> +Cet outil permet d'importer un contenu au format Bibtex d'une source <a href="https://dblp.uni-trier.de/" target="_blank">DBLP</a> dans la base HAL ou dans la base de préproduction de HAL. +<br/> +<br/> +Renseignez les différents champs (ceux avec une étoile sont obligatoires) +<br/><br/> +La <b>forme auteur</b> correspond à la dénomination littérale de l'auteur dans le fichier bibtex. +<br> +Cette forme peut être simple : <i>Jean Mailfert</i> ou plus complexe en cas d'accent ou de tiret : <i>S{\'{e}}bastien Cipi{\`{e}}re}</i> +</br><br/> +Le <b>nom</b> et <b>prénom</b> du chercheur correspondent à ce que vous souhaitez voir apparaître dans HAL +<br/><br/> +Le <b>login Hal</b> et l<b>'idHal</b> du chercheur doivent vous être fournis par l'auteur lui-même dans le cas d'un dépôt sur la base HAL. +<br/><br/> +Le <b>numéro de structure</b> correspond à son identifiant (id). Rentrez le nom de la structure sur la base AuréHAL pour l'obtenir et rentrez le tel quel (Ex : 490706) +<br/><br/> +Les <b>domaines</b> sont généralement fournis par le chercheur et s'appliquent à toutes les publications. +<br/> +Cliquez <a href="#trav_equip">ici</a> pour en avoir la liste. +<br/> +Au moins un domaine est nécessaire pour un import dans la base (Hal ou préprod) +<br/> +<br/> +<u>Source DBLP</u> <br/> +Pour information, la base DBLP ne récupère que certaines publications (articles, conférences, posters, ouvrages) et n'est donc pas exhaustive sur le travail du chercheur. +<br/> +Pour récupérer ce contenu dans DBLP, rechercher l'auteur et cliquez sur le lien <u>bibtex</u> dans <u>export bibliography</u> +</p> +<br/> +<p align="center"> +<img src="{% static 'img/dblp_hal_help1.png' %}" > </p> +<br/> +<p align="justify"> +Une page présentant le contenu des publis au format bibtex s'ouvre et vous pouvez cliqu6333333er sur le lien <u>download as .bib file</u> pour télécharger ce fichier. +<br/><br/> +Copiez-collez le contenu de ce fichier dans l'emplacement prévu nommé <b>contenu bibtex</b> +<br/> +<br/> +</p> +<br/> <br/> <p align="left"><b><u><a id="dblp_2_xml"></a>Create XML (from DBLP)</u></b></p> @@ -121,11 +265,6 @@ TODO </p> <br/> -<p align="left"><b><u><a id="format_text_rg"></a>Format Text from Research Gate</u></b></p> -<p align="justify"> -TODO -</p> -<br/> <p align="left"><b><u><a id="list_domains"></a>Liste des domaines</u></b></p> <p align="justify"> @@ -197,23 +336,21 @@ info.info-wb - informatique/Web<br/> <br/> - <div class="row"> - - <div class="col-lg-6"> - <br/> - <img src="{% static 'img/logo_limos.png' %}" width="100" > - <br/> - </div> - <div class="col-lg-6"> - <br/> - <img src="{% static 'img/logo_hal.png' %}" width="100" > - <br/> - - </div> - </div> + <div class="row"> + + <div class="col-lg-6" align="center"> + <br/> + <img src="{% static 'img/logo_limos.png' %}" width="100" > + <br/> + </div> + <div class="col-lg-6" align="center"> + <br/> + <img src="{% static 'img/logo_hal.png' %}" width="100" > + <br/> + </div> + </div> {% endblock %} - diff --git a/staticfiles/img/aide_res_corr1.png b/staticfiles/img/aide_res_corr1.png new file mode 100644 index 0000000000000000000000000000000000000000..fa3605509ea19f438f06b1a61b1e5be8e12afebd Binary files /dev/null and b/staticfiles/img/aide_res_corr1.png differ diff --git a/staticfiles/img/aide_res_corr2.png b/staticfiles/img/aide_res_corr2.png new file mode 100644 index 0000000000000000000000000000000000000000..b74f11d2034614f1f6eab7a23329b99318db3f55 Binary files /dev/null and b/staticfiles/img/aide_res_corr2.png differ