Premier lancement

Au premier lancement, GdArt vous fait créer un projet, puis un assistant pose les questions une par une et remplit les fichiers du projet. Pour chaque question, Entrée garde la valeur proposée entre crochets.

Si vous avez déjà utilisé une ancienne version de GdArt, il propose d'abord de reprendre vos données : voir Venir d'une ancienne version.

Créer le projet

Un projet correspond à un thème de recherche : il a ses mots-clés, ses réglages et son avancement. Choisissez n (nouveau projet) et donnez-lui un nom, par exemple energie. Les caractères interdits dans un nom de dossier (/ \ : * ? " < > |) sont remplacés automatiquement.

L'assistant

1. Zotero. La clé personnelle permet à GdArt de lire votre bibliothèque (pour repérer les doublons) et d'y envoyer les articles retenus. Pour la créer :

  1. ouvrez https://www.zotero.org/settings/keys/new ;

  2. cochez Allow library access et Allow write access ;

  3. cliquez sur Save Key et copiez la clé.

GdArt vérifie la clé tout de suite. On peut aussi s'en passer (réponse -) : la recherche et le tri marchent, mais pas l'envoi dans Zotero.

L'assistant demande ensuite le nom de la collection Zotero du projet, s'il faut une sous-collection par recherche, et ce qu'il faut faire des articles déjà rangés ailleurs dans votre Zotero (les proposer quand même, ou non).

2. Sources. Les bases à interroger, par leur numéro (voir Les bases interrogées). OpenAlex est conseillé dans tous les cas.

Important

Une clé OpenAlex gratuite est indispensable en pratique (https://openalex.org/settings/api, il suffit d'une adresse e-mail). Sans clé : 100 requêtes par jour pour tout votre réseau (labo, université), vite épuisées. Avec clé : 1000 requêtes par jour, rien que pour vous.

En robotique, une clé IEEE Xplore gratuite (https://developer.ieee.org, puis Register et Get API key ; activation en quelques heures) donne accès directement à ICRA, IROS, RA-L, T-RO, T-ASE...

3. Recherche. Le nombre de résultats gardés par requête (les plus pertinents, 200 au plus) et les années de début et de fin.

4. Conférences et revues. Celles à fouiller en plus, pour que leurs articles ne soient pas noyés dans les résultats généraux : un groupe (ROBOTIQUE, IA...), un acronyme (ICRA, IROS, ICAPS...) ou le nom complet (voir 1. Chercher).

5. Tags. Le tag mis automatiquement sur chaque article envoyé (screened), et les touches des tags de lecture (c pour core...).

6. Mots-clés. Thème par thème, des listes de mots-clés, puis des mots d'exclusion facultatifs (voir Les mots-clés).

Où sont rangées les réponses

  • les clés vont dans GdArt/cles.yaml, dans votre dossier personnel : elles servent à tous vos projets, il n'y a pas à les redonner ;

  • les réglages du projet vont dans son config.yaml ;

  • les mots-clés dans son input.yaml.

On peut relancer l'assistant à tout moment avec le menu 0, ou modifier ces fichiers à la main : ils sont commentés.

Le menu

L'assistant terminé, le menu du projet s'affiche :

GdArt 1.0 : aide à l'état de l'art
Projet : energie   (/home/marie/GdArt/energie)

  [x] 0. Configurer              2 recherche(s), sources : openalex, hal, arxiv
      a. Aperçu                  combien de résultats par requête ?
  [x] 1. Chercher                54/54 interrogations
  [x] 2. Doublons                312 papiers à trier
  [.] 3. Tri des titres          120/312 triés, 41 gardés
  [ ] 4. Lecture                 0/41 lus, 0 retenus
  [ ] 5. Envoi Zotero            0/0 envoyés
  [ ] 6. Remontée des références articles cités par vos papiers « core »
      j. Journal                 fichier récapitulatif
      p. Projet                  ouvrir un autre projet, en créer un, importer
      q. Quitter

[x] : étape finie ; [.] : étape commencée ; [ ] : pas encore commencée. On tape le numéro ou la lettre, puis Entrée. Les étapes se font dans l'ordre, et chacune peut être reprise plus tard.