2  Fichiers et code đŸ’»

2.1 Dropbox

Nous utilisons Dropbox au CAPP pour stocker et partager entre nous diverses informations sur nos projets.

Le chapitre 4 du livre d’outils pose deux rùgles :

  • Ne jamais conserver un fichier uniquement sur son ordinateur. Un disque dur peut tomber en panne, un ordinateur peut ĂȘtre perdu ou volĂ© : tout fichier qui n’existe qu’en local est Ă  risque.
  • Ne jamais placer un repo Git dans un dossier synchronisĂ©, comme Dropbox, OneDrive ou Google Drive. Ces services synchronisent les fichiers en continu, ce qui entre en conflit avec les opĂ©rations de Git et gĂ©nĂšre des erreurs et des doublons (chapitre 4).

Le CAPP est parfois tentaculaire, et il est facile de perdre ses fichiers si l’on ne prend pas le temps de bien les organiser. Au CAPP, on applique ces deux rùgles ainsi :

  1. Les repos Git, et seulement eux, vivent hors de Dropbox, tous au mĂȘme niveau dans le dossier «CAPP» créé Ă  vos premiĂšres Ă©tapes. C’est Git, par GitHub, qui en assure la sauvegarde et le partage (voir Git et GitHub). Ne dĂ©placez jamais un repo Ă  l’intĂ©rieur d’un autre repo.
  2. Les donnĂ©es ne vont jamais dans un repo ni sur GitHub : leur place est dans tube. Voir OĂč vont les donnĂ©es. Pour travailler sur des donnĂ©es qui ne sont pas encore dans tube, rangez leurs dossiers partagĂ©s Dropbox (_SharedFolder_
) dans un dossier «CAPP» de votre Dropbox, comme vos repos dans le dossier «CAPP» hors de Dropbox.
  3. Tout le reste (documents, travail personnel, etc.) vit idĂ©alement dans Dropbox ou dans un autre service synchronisĂ©. Rien d’autre que les repos Git ne devrait se trouver uniquement sur votre ordinateur.

Si vous n’ĂȘtes pas sĂ»rs d’oĂč mettre un dossier ou fichier, demandez de l’aide!

Voici un exemple d’arborescence :

CAPP/                             # hors de Dropbox : les repos Git
├── projet-a/                     # le code du projet A
└── projet-b/                     # le code du projet B

Dropbox/
├── CAPP/                         # les dossiers partagĂ©s
│   ├── _SharedFolder_projet-a/   # donnĂ©es du projet A pas encore dans tube
│   └── _SharedFolder_projet-b/   # documents du projet B
└── Personnel/                    # vos cours, vos notes, etc.

❗IMPORTANT❗

Si vous vous impliquez un certain temps au CAPP, la nĂ©cessitĂ© de payer individuellement pour Dropbox se fera ressentir. Vous devez vous y prĂ©parer. Voici quelques considĂ©rations Ă  garder Ă  l’esprit :

  1. Il est trĂšs important d’entreposer vos donnĂ©es sur un cloud comme Google Drive, OneDrive ou Dropbox. Autrement, si vous perdez votre ordinateur et ne faites pas de sauvegardes externes trĂšs rĂ©guliĂšres de l’ensemble de vos travaux, tout votre travail pourrait ĂȘtre perdu.
  2. Pour travailler sur des projets en Ă©quipe, Dropbox est rĂ©guliĂšrement utilisĂ© par plusieurs Ă©quipes de travail dans le monde acadĂ©mique. Si ce n’est pas maintenant, il est fort probable qu’un peu plus tard dans votre carriĂšre vous deviez acheter la version payante. MĂȘme Google Drive ne suffira plus si vous faites beaucoup de recherche, surtout quantitative.
  3. Dropbox gratuit possĂšde seulement 2 Go de mĂ©moire. C’est beaucoup moins que les 15 Go de Google Drive.
  4. Dropbox Plus compte 2 To. C’est 1000 fois plus que la version gratuite, donc il est rĂ©aliste de rester avec Dropbox Plus pour l’essentiel de sa carriĂšre acadĂ©mique.
  5. Dropbox Plus coute 155,88 $ par annĂ©e avant taxes, soit environ 179 $ taxes incluses (12,99 $ par mois avec l’abonnement annuel; prix de 2026, en dollars canadiens).
  6. Il y a gĂ©nĂ©ralement une dĂ©pendance au sentier (path dependency) : quand vous payez pour la premiĂšre fois pour Dropbox Plus, vous devez ĂȘtre prĂ©parĂ©s Ă  payer un montant annuel potentiellement jusqu’à la fin de votre vie. Autrement, vos fichiers ne seront plus entreposĂ©s sur le cloud et vous pourrez les perdre Ă  tout moment.

2.2 Git et GitHub

Éventuellement, vous serez appelĂ© Ă  «pusher» votre travail en ligne sur GitHub pour qu’il soit ensuite consultable et modifiable par vos collĂšgues. Le chapitre 4 du livre d’outils explique, pas Ă  pas, comment utiliser Git et GitHub dans un projet de recherche.

Le README d’un dĂ©pĂŽt fait foi. Il est la source de vĂ©ritĂ© pour tout ce que le dĂ©pĂŽt contient : installation, usage, structure, procĂ©dures. Si la trousse et un README se contredisent, suivez le README et signalez l’écart.

Voici quelques informations de base sur nos outils de stockage de données.

  • Github sert au stockage de codes, de textes et de tout fichier devant ĂȘtre modifiĂ© par plus d’une personne;
  • Github n’aime pas que l’on entrepose des informations trop lourdes sur ses serveurs
 Des repo trop costauds seront aussi plus longs Ă  tĂ©lĂ©charger.
  • Pour bien saisir la logique de Git et de GitHub, nous vous conseillons de visionner les tutoriels Git and GitHub for Poets de la chaine YouTube The Coding Train. Voici le lien du premier vidĂ©o: https://www.youtube.com/watch?v=BCQHnlnPusY&t=3s. Ce genre de vidĂ©o vous apprendra notamment Ă  minimiser le risque d’erreurs sur Git. Notez bien la formule magique Ă  inscrire dans votre terminal (oui, nous utilisons le terminal!):
    1. git add -A
    2. git commit -m â€œĂ©crire ici la description du commit”
    3. git pull
    4. git push

Important: malheureusement, apprendre une formule magique n’est jamais une solution miracle. Il est plutĂŽt nĂ©cessaire de comprendre les commandes et de pouvoir faire ce que l’on veut, peu importe les circonstances. Dans certains cas, la formule ci-dessus pourrait ĂȘtre inappropriĂ©e!

  • Quand on fait un pull aprĂšs un certain temps dans un repo, il est tout aussi important de taper ces codes dans le terminal, mĂȘme si nous n’avons rien modifiĂ© depuis longtemps. Parfois, un fichier cachĂ© a Ă©tĂ© modifiĂ© (.RData, .Rhistory ou .DS_Store). En «commitant» comme ça, on s’assure de ne pas avoir de conflits.

Le flux de travail Git (illustration de nikkiandchris.io).
  • Le fichier texte (cachĂ©, c’est pourquoi il est invisible) .gitignore est nĂ©cessaire, comme son nom l’indique, pour ignorer la mise en ligne de certains fichiers Ă  l’intĂ©rieur de notre repository Github. Par exemple, les fichiers pdf et png sont ignorĂ©s par le .gitignore : ils doivent donc prĂ©fĂ©rablement ĂȘtre entreposĂ©s dans un _SharedFolder, sur Dropbox. Les dossiers dĂ©butant par _SharedFolder y sont aussi ignorĂ©s, par prĂ©caution, mĂȘme s’ils ne doivent jamais se trouver dans un repo. La taille de fichier maximale recommandĂ©e par GitHub est de 50 MB.
  • Votre travail personnel (par exemple, les dossiers relatifs Ă  vos cours) va dans votre Dropbox, hors de vos repos : il reste ainsi sauvegardĂ©, sans ĂȘtre publiĂ© en ligne ni partagĂ© avec vos collĂšgues.

Pour en savoir plus, je vous invite aussi à consulter la «cheat sheet» sur Git dans la section Cheat sheets.

2.3 Nos packages R

Le CAPP et Ellipse dĂ©veloppent des packages R pour les tĂąches qui reviennent d’un projet Ă  l’autre. On les installe depuis GitHub, par exemple : remotes::install_github("ellipse-science/tube"). Pour les dĂ©pĂŽts privĂ©s, il faut avoir accĂšs Ă  l’organisation (voir PremiĂšres Ă©tapes) et un token personnel.

  • tube : accĂšs Ă  l’entrepĂŽt de donnĂ©es d’Ellipse sur AWS (Radar+, Agora+, dimensions, dictionnaires). ellipse_connect(), ellipse_discover(), ellipse_query(), ellipse_publish(). Voir OĂč vont les donnĂ©es et Valider l’état des donnĂ©es dans tube.
  • sondr : nettoyage, fusion et analyse de donnĂ©es de sondage. read_survey(), clean_likert_numeric_vector(), sav_to_codebook(), generate_survey_ids().
  • clessnverse : fonctions utilitaires de la CLESSN pour les textes, les dictionnaires et les graphiques. run_dictionary(), clean_corpus(), rm_accents(), theme_clean_light().
  • globales (privĂ©) : Ă©tudes Ă©lectorales nationales de plusieurs pays, tĂ©lĂ©chargĂ©es et chargĂ©es en une commande. get_es(), list_es(), es_codebook(), es_cite().
  • inferclientllmtool (privĂ©) : client de notre serveur d’infĂ©rence : classification de textes, entitĂ©s nommĂ©es, traduction, transcription audio, modĂšles Ollama. infer_connect(), infer_classify_df(), infer_translate(), infer_ollama_chat().
  • pplmatch : associe les intervenants des dĂ©bats parlementaires (Communes et AssemblĂ©e nationale) aux fiches des dĂ©puté·es. pplmatchCA(), pplmatchQC().

La documentation de clessnverse et de sondr est aussi sur ellipse.science, dans le Catalogue des procédures.

Les jeux pas encore transfĂ©rĂ©s dans tube se lisent avec d’autres packages : voir Anciens hubs.