Rzine

Pour la diffusion et le partage de ressources
sur la pratique de R en sciences humaines et sociales

Journées annuelles du réseau Mate-shs - 17 mai 2022

Hugues Pecout, Timothée Giraud & al.

Genèse du projet











Projet exploratoire de la FR CIST

Initié par 5 membres de la Fédération de Recherche partageant
une envie commune : produire collectivement de la documentation sur R.

Objectif : Contribuer à l’apprentissage et à la pratique de R en SHS, en favorisant le partage, la production et la diffusion de ressources.

Faire le bilan pour innover

Communauté d’utilisateur.rice.s et ressources disponibles sur R ?

Points forts

    • Communauté internationale très active
    • Des acteurs français notables
    • Langage commun à plusieurs disciplines
    • Beaucoup de ressources en libre accès
    • De très bonnes initiatives existent

Émergence de deux axes de travail

Prendre en compte l’existant

Rzine.fr

Du renfort

5 ingénieur·e·s ont rejoint le projet Rzine

Organisation

Organisation

Organisation

Rzine.fr









Valoriser et partager l’existant

Rzine.fr

Construit avec R :



Et libre !

    • Code source partagé sur le de
    • Code source sous licence
    • Un nom de domaine qui appartient au
    • Site hébergé par l’université

4 types de contenu

Qui dessinent les contours de la pratique de R en SHS

+ de 300 ressources

Site statique et participatif

La collection Rzine









Partager des méthodes et analyses reproductibles réalisées avec R

Caractéristiques ?


    • Collection ouverte à tou·te·s
    • Périmètre interdisciplinaire (SHS et sciences territoriales)
    • Format de publication notebook (Rmarkdown)
    • Publications soumises à comité de lecture
    • Processus de relecture transparent sur GitHub/GitLab
    • Processus de d’édition sur GitHub/GitLab
    • Publications open source (licences MIT & CC BY-SA 4.0)
    • Informations + données nécessaires à la reproductibilité fournies
    • Stockage et diffusion assurés (DOI, HAL, Nakala ?)

Un type de publication : la fiche Rzine

Pour quoi faire ?

1. Offrir un espace de publication innovant qui permet à tout·te·s de valoriser, partager et diffuser ses méthodes et analyses réalisées avec R.

2. Participer à la montée en compétence collective de la pratique de R en SHS et favoriser les échanges entre disciplines.

3. Contribuer à la diffusion de méthodes innovantes ou restées confidentielles, et des bonnes pratiques en matière de reproductibilité.

4. Participer à la démocratisation de l’utilisation de la programmation lettrée (R Markdown) et des logiciels décentralisés de versionnage (Git) en SHS.

L’ouverture de la science ne se limite pas aux données et aux articles !

Une fiche Rzine ?


Document qui présente une méthodologie, un type d’analyse, une fonctionnalité, ou encore le traitement d’un certain type de données réalisé avec R, de façon reproductible et didactique afin d’en faciliter son application pratique.

Une fiche peut être fortement axée sur un aspect technique ou méthodologique, mais elle doit impérativement s’ancrer dans une thématique des sciences humaines et sociales.

Rédiger une fiche

  • Règles de mise en page et de soumission expliquées dans ce document

  • Modèle de mise en page (rmarkdown) fourni par le package Rzine 
    • # install.packages("remotes")
remotes::install_gitlab("rzine/package", host = "https://gitlab.huma-num.fr/", force = TRUE)

# Générer une fiche vierge (POSSIBLE en CLIC-BOUTON avec RSTUDIO)
rmarkdown::draft(file = "index.Rmd", template = "readrzine", package = "rzine", create_dir = FALSE, edit = FALSE)

    Processus de relecture et d’édition

    Premières fiches publiées


    drawing drawing drawing drawing

    À vous de jouer !



    Documentation : Publier une fiche Rzine


    Soumission : contact@rzine.fr

    @rzine_shs

    Merci de votre attention


    Diapositives libres (CC BY-SA 4.0)

    Slides : https://huguespecout.github.io/projet_rzine/#/

    Code source : https://github.com/HuguesPecout/projet_rzine


    Contact


    @rzine_shs

    Exercice !












    R, Rstudio & package Rzine

    A. Installez le package Rzine 

    install.packages("remotes")
remotes::install_gitlab("rzine/package", host = "https://gitlab.huma-num.fr/", force = TRUE)
library("rzine")

    Sur Windows, il peut être nécessaire d’installer rtools pour utiliser le package remotes.

    B. Créez un projet Rstudio

    Dans la barre de menu Rstudio, cliquez sur File/New Project/New Directory/New Project….

    C. Générez une fiche vierge : 

    rmarkdown::draft(file = "index.Rmd", 
                 template = "readrzine", 
                 package = "rzine", 
                 create_dir = FALSE, 
                 edit = FALSE)

    En clic-bouton : File/New File/R Markdown/From Template, choisir ‘readrzine - Template pour fiche rzine’

    Fichiers & répertoires associés à une fiche

    drawing

    Tricotez (knitez) !

    drawing

    Sortie HTML

    drawing

    À vous de jouer !



    Documentation : Publier une fiche Rzine


    Soumission : contact@rzine.fr

    @rzine_shs