Outils de recherche en sciences sociales numériques

Manuscrit d'un livre académique dirigé par Alexis Bibeau-Gagnon, Adrien Cloutier et Yannick Dufresne (Université Laval / CLESSN).

Ce livre présente une sélection d'outils numériques à l'intention des chercheurs et étudiants en sciences sociales. Il couvre la gestion de projet, les données, la bibliographie, la collecte, la visualisation, la rédaction et l'intelligence artificielle.

Statut : Manuscrit en cours d'évaluation éditoriale. Ce dépôt contient les sources du livre (format Quarto). Aucune version diffusable n'est disponible publiquement pour le moment.

Comment contribuer au projet du livre d'outils

Bienvenue ! Ce guide vous aidera à contribuer à notre projet de livre hébergé sur GitHub. Ne vous inquiétez pas si vous êtes nouveau sur Git ou GitHub ; ce guide étape par étape est conçu pour les débutants ayant une expérience technique limitée.

Table des matières

1. Prérequis
2. Installation de Git
3. Forker le dépôt
4. Cloner votre fork
5. Apporter des modifications localement
6. Valider vos modifications
7. Pousser les modifications sur GitHub
8. Créer une Pull Request
9. Compiler le livre complet
10. À propos du fichier .gitignore
11. Gestion de la bibliographie avec Zotero
12. Étapes suivantes

---

Prérequis

• Git : Un système de contrôle de version que nous utiliserons pour gérer les modifications.
• Compte GitHub : Si vous n'en avez pas, vous pouvez vous inscrire sur github.com.
• Éditeur de texte : Tout éditeur de texte simple comme Notepad, TextEdit, ou des éditeurs plus avancés comme Visual Studio Code.

Installation de Git

Installer Git

• Windows : Téléchargez et installez depuis git-scm.com/download/win.
• macOS : Téléchargez et installez depuis git-scm.com/download/mac.
• Linux : Installez via votre gestionnaire de paquets, par exemple, sudo apt-get install git.

Vérifier l'installation

Ouvrez votre invite de commande ou terminal et tapez :

git --version

Vous devriez voir la version de Git installée.

Forker le dépôt

1. Accédez au dépôt du livre.
2. Cliquez sur le bouton Fork dans le coin supérieur droit de la page.
3. Cela crée une copie du dépôt sous votre compte GitHub.

Cloner votre fork

1. Naviguez vers votre dépôt forké sur GitHub (il devrait être github.com/VOTRE-NOM-D'UTILISATEUR/livre-outils).

2. Cliquez sur le bouton Code et copiez l'URL.

3. Ouvrez votre invite de commande ou terminal.

4. Naviguez vers le répertoire où vous souhaitez stocker le projet, par exemple :

   cd Documents

5. Clonez votre dépôt forké :

   git clone https://github.com/VOTRE-NOM-D'UTILISATEUR/livre-outils.git

   Remplacez VOTRE-NOM-D'UTILISATEUR par votre nom d'utilisateur GitHub.

Apporter des modifications localement

1. Accédez au dossier du projet :

   cd livre-outils

2. Ouvrez le fichier que vous souhaitez modifier à l'aide de votre éditeur de texte. Par exemple :

   • Utiliser RStudio :

     rstudio chapitre_1.qmd

3. Apportez vos modifications et enregistrez le fichier.

Valider vos modifications

1. Revenez à votre invite de commande ou terminal.

2. Vérifiez l'état de vos modifications :

   git status

3. Ajoutez vos modifications pour les valider :

   git add chapitre_1.qmd

4. Validez vos modifications avec un message :

   git commit -m "Correction des fautes de frappe dans le chapitre 1"

Pousser les modifications sur GitHub

Envoyez vos modifications validées vers votre dépôt GitHub :

git push origin main

Si vous obtenez une erreur concernant la branche inexistante, vous devrez peut-être définir la branche distante :

git push --set-upstream origin main

Créer une Pull Request

1. Allez sur votre dépôt forké sur GitHub.

2. Cliquez sur l'onglet Pull Requests.

3. Cliquez sur New Pull Request.

4. Assurez-vous que vous comparez votre branche main à la branche main du dépôt original.

5. Cliquez sur Create Pull Request.

6. Ajoutez un titre descriptif et un commentaire sur vos modifications.

7. Cliquez à nouveau sur Create Pull Request pour soumettre.

Compiler le livre complet

Pourquoi compiler le livre complet ?

Ce projet est un livre Quarto, pas une collection de documents indépendants. Il est essentiel de toujours compiler le livre dans son ensemble et jamais les chapitres individuellement.

La commande à utiliser

Pour compiler le livre en PDF, ouvrez votre terminal dans le dossier du projet et exécutez :

quarto render index.qmd --to pdf

Ou simplement :

quarto render

Le PDF final sera généré dans le dossier _book/.

⚠️ NE PAS compiler les chapitres individuellement !

Prévisualiser pendant l'édition

Pour voir vos modifications en temps réel pendant que vous éditez :

quarto preview

Cela ouvre le livre dans votre navigateur et se met à jour automatiquement quand vous sauvegardez vos changements.

À propos du fichier .gitignore

Qu'est-ce que le .gitignore ?

Le fichier .gitignore indique à Git quels fichiers et dossiers ne doivent pas être suivis dans le dépôt. Cela garde le projet propre et évite de partager des fichiers inutiles ou problématiques.

Ce qui est ignoré dans ce projet

Le .gitignore est configuré pour exclure :

• _book/ : Le dossier contenant le PDF compilé (peut être regénéré)
• .quarto/ : Cache interne de Quarto
• *_files/ et *_cache/ : Dossiers créés par erreur lors de rendus de chapitres individuels
• Fichiers LaTeX temporaires : .aux, .log, .toc, .out, etc.
• Fichiers système : .DS_Store (macOS), Thumbs.db (Windows)
• Fichiers Office temporaires : ~$*.docx, ~$*.xlsx, etc.

Gestion de la bibliographie avec Zotero

Cette section explique comment gérer les références bibliographiques du livre. Toutes les citations dans le texte (format @auteur_annee) sont automatiquement compilées en une bibliographie à la fin du livre. La source unique de vérité pour toutes les références est la bibliothèque de groupe Zotero CLESSN, qui est automatiquement exportée vers le fichier livre-outils.bib.

Installation et configuration de Zotero

Dans cette section, vous serez amené à installer Zotero ainsi que Better BibTeX, une extension de Zotero servant à générer et maintenir à jour des fichiers .bib à partir de Zotero.

Zotero

• Installer Zotero

• Installer Zotero Connector

• Une fois Zotero installé, créer un compte Zotero. Prenez note de votre identifiant et partagez-le avec un mainteneur du projet pour qu'il vous ajoute sur le groupe Zotero CLESSN.

• Allez dans vos courriels et suivez les directives pour joindre le groupe Zotero CLESSN.

Better BibTeX

• La prochaine étape sera d'installer Better BibTeX. Pour ce faire, allez dans l'onglet tools > Add-ons ensuite cliquez sur l'icône de paramètre et faites Install Add-on From File. Sélectionnez le fichier .xpi que vous avez téléchargé.

IMPORTANT

• Une fois l'add-on installé, allez dans les paramètres de Better BibTeX en allant dans l'onglet Zotero > Settings > Onglet Better BibTeX > Open Better BibTeX preferences...

• Dans la section Citation Key Format, collez ceci: authEtal2.fold.lower.replace(find=".",replace=_) + len + shortyear | veryshorttitle + shortyear

Génération du fichier .bib

Dans Zotero, vous devriez maintenant voir le groupe Zotero CLESSN dans les Group Libraries.

Il est important de comprendre que tout changement que vous faites dans Zotero sera automatiquement synchronisé avec le groupe Zotero CLESSN. Si vous supprimez une référence, elle sera supprimée pour tout le monde!

Clic-droit sur la collection livre-outils > Export Collection, choisissez le format Better BibLaTeX et cochez la case [x] Keep updated. Faites OK et sauvegardez le fichier dans le repo du projet livre-outils. Ce dossier sera constamment mis à jour avec les changements que vous faites dans Zotero et sera synchronisé avec le projet GitHub quand vous ferez vos pull requests.

Vous remarquerez qu'il y a déjà un fichier .bib dans le dossier. Vous pouvez le supprimer et le remplacer par le fichier que vous venez de générer.

Utilisation de Zotero lors de l'écriture

Lors de l'écriture, vous n'avez qu'à écrire @ dans votre éditeur pour faire sortir la palette de référencement.

Ajouter des références à Zotero

Il y a différentes façons d'ajouter des références au groupe Zotero CLESSN.

• Drag & drop à partir de votre librairie personnelle
• Drag & drop les PDF que vous avez sur votre ordinateur dans la collection livre-outils. Zotero va essayer de trouver les métadonnées automatiquement.
• Si il ne réussit pas, vous pourrez ajouter la référence en cliquant sur la baguette magique en haut à gauche du symbole " + " vert. L'outil de baguette magique est utile si vous possédez le DOI ou le ISBN de l'article/livre que vous devez ajouter. Dans les rares cas où Zotero ne trouve rien à propos de votre référence, vous pourrez remplir les différents champs manuellement.
• Utiliser le connecteur à l'intérieur de votre fureteur web. Zotero va aussi tenter de télécharger l'article directement et l'inclure dans la collection appropriée.

Autres avantages de Zotero

• Centralisation des PDFs
• Organisation des lectures par projet
• Annotations et notes directement dans Zotero
• Recherche rapide dans votre bibliothèque

Étapes suivantes

• Attendre la revue : La branche main est protégée — toute PR doit être approuvée par au moins un mainteneur avant d'être fusionnée. Soyez patient, la revue peut prendre quelques jours.
• Répondre aux commentaires : Si des modifications sont demandées, apportez-les localement, validez, poussez, et elles seront automatiquement mises à jour dans votre pull request.
• Restez engagé : N'hésitez pas à contribuer davantage ou à poser des questions si vous avez des doutes.

---

Besoin d'aide ?

Si vous rencontrez des problèmes ou avez des questions, veuillez contacter les mainteneurs du projet. Nous sommes là pour vous aider à apprendre et à contribuer !

Ressources supplémentaires

• Guides GitHub
• Vidéos sur les bases de Git

---

Merci pour votre contribution !