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 :doc:`mise_a_jour`. 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. .. Capture d'écran à insérer : le menu des projets au premier lancement (n nouveau projet, i importer). Déposez _static/demarrage/menu-projets.png puis décommentez le bloc ci-dessous (retirez le préfixe « .. ») : .. .. image:: _static/demarrage/menu-projets.png .. :align: center .. :width: 90% 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 : #. ouvrez https://www.zotero.org/settings/keys/new ; #. cochez **Allow library access** et **Allow write access** ; #. 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). .. Capture d'écran à insérer : l'assistant, question de la clé Zotero (clé masquée), puis collection. Déposez _static/demarrage/assistant-zotero.png puis décommentez le bloc ci-dessous (retirez le préfixe « .. ») : .. .. image:: _static/demarrage/assistant-zotero.png .. :align: center .. :width: 90% **2. Sources.** Les bases à interroger, par leur numéro (voir :doc:`sources`). 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... .. Capture d'écran à insérer : l'assistant, liste numérotée des sources avec les cases [x]. Déposez _static/demarrage/assistant-sources.png puis décommentez le bloc ci-dessous (retirez le préfixe « .. ») : .. .. image:: _static/demarrage/assistant-sources.png .. :align: center .. :width: 90% **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 :doc:`recherche`). **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 :doc:`mots_cles`). 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 : .. code-block:: text 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.