Description
Cette formation vise à enseigner la rédaction de documents techniques reproductibles en utilisant des outils modernes comme Markdown et Quarto. Elle aborde les limitations des traitements de texte traditionnels et introduit la syntaxe Markdown pour la mise en forme de documents. Les participants apprendront à intégrer du code R et Python pour générer des résultats statistiques, ainsi qu'à personnaliser leurs documents avec des options avancées. Destinée aux professionnels et chercheurs, cette formation inclut un projet pratique pour appliquer les concepts et favoriser l'apprentissage collaboratif.
Objectifs
- Comprendre la syntaxe et la structure d'un document Quarto
- Maîtriser l'insertion de code R et Python dans un document Quarto pour générer des résultats statistiques
- Savoir intégrer et mettre en forme du texte, des équations, des tableaux, des graphiques
- Être capable de générer des rapports aux formats HTML, PDF et Word
- Apprendre à utiliser des modèles pour personnaliser ses documents
- Automatiser la production de rapports statistiques récurrents
Récapitulatif
Public
Toute personne intéressée à apprendre à automatiser la génération de rapports statistiques
Prérequis
Connaissances en statistiques
Avoir suivi une formation à R et/ou Python ou pratiquer régulièrement ces langages
Connaissance d'un environnement de développement et de GIT
Être familier avec la rédaction de documents techniques
Méthodes et modalités pédagogiques
Formation réalisée en Présentiel, Distanciel ou Dual-Learning selon la formule retenue.
Moyens et supports pédagogiques
Mise à disposition d'un poste de travail sur nos formations en Présentiel.
Mise à disposition de nos environnements de visio sur nos formations en Distanciel
Remise d'une documentation pédagogique numérique pendant la formation
La formation est constituée d'apports théoriques, d'exercices pratiques et de réflexions
Dans le cas d'une formation sur site Entreprise, le client s'engage à avoir toutes les ressources pédagogiques nécessaires (salle, équipements, accès internet, TV ou Paperboard...) au bon déroulement de l'action de formation conformément aux prérequis indiqués dans le programme de formation
Modalités de suivi et d'évaluations
Auto-positionnement des stagiaires avant la formation
Émargement des stagiaires et formateur par 1/2 journée
Exercices de mise en pratique ou quiz de connaissances tout au long de la formation permettant de mesurer la progression des stagiaires
Auto-évaluation des acquis de la formation par les stagiaires
Questionnaire de satisfaction à chaud et à froid à l'issue de la formation
Programme détaillé
Introduction à la rédaction de documents techniques reproductibles
- Limites des outils WYSIWYG (Word, Google Docs...) : Discussion sur les limitations des outils de traitement de texte traditionnels en termes de reproductibilité, de collaboration et de contrôle de version.
- Introduction au projet fil rouge : Présentation du projet pratique qui servira de fil conducteur tout au long de la formation pour appliquer les concepts appris.
Découverte de la syntaxe Markdown
- Mise en forme du texte (titres, listes, gras, italique, liens, images...) : Apprentissage des éléments de base de la mise en forme de texte avec Markdown.
- Insertion de blocs de code : Introduction à l'ajout de blocs de code dans les documents Markdown pour inclure des exemples de code.
- Atelier Pratique : rédaction d'un document Markdown simple : Exercice pratique pour rédiger un document simple en utilisant Markdown.
Premiers pas avec Quarto
- Installation et configuration de Quarto : Guide étape par étape pour installer et configurer Quarto.
- Structure d'un document .qmd : Explication de la structure d'un document Quarto Markdown.
- Options des métadonnées YAML : Introduction aux métadonnées YAML pour configurer des options spécifiques du document.
- Rendu dans différents formats : Exploration des options de rendu de Quarto dans divers formats tels que HTML, PDF et Word.
Intégration de code R et/ou Python
Insertion de chunks de code
- Options des chunks (cache, warning, message, figure...) : Détails sur les options disponibles pour les chunks de code dans Quarto pour contrôler leur comportement et leur affichage.
- Affichage et masquage du code et des résultats : Techniques pour afficher ou masquer le code et les résultats dans les documents rendus.
Génération de résultats statistiques en R
- Manipulation de données avec dplyr et tidyr : Introduction à la manipulation de données en R en utilisant les bibliothèques dplyr et tidyr.
- Statistiques descriptives avec summary : Utilisation de la fonction summary pour obtenir des statistiques descriptives de base.
- Graphiques avec ggplot2 : Création de graphiques avec la bibliothèque ggplot2.
Génération de résultats statistiques en Python
- Manipulation de données avec pandas : Introduction à la manipulation de données en Python en utilisant la bibliothèque pandas.
- Statistiques descriptives avec describe : Utilisation de la méthode describe pour obtenir des statistiques descriptives de base.
- Graphiques avec matplotlib et seaborn : Création de graphiques avec les bibliothèques matplotlib et seaborn.
Exercices d'application
- Mise en pratique des concepts appris à travers des exercices spécifiques pour renforcer les compétences en rédaction de documents techniques reproductibles.
Mise en forme et automatisation
Mise en forme avancée
- Insertion d'équations : Ajout d'équations mathématiques dans les documents.
- Personnalisation des tableaux avec kable et gt : Personnalisation avancée des tableaux en utilisant les bibliothèques kable et gt.
- Ajout de références bibliographiques avec .bib : Intégration de références bibliographiques à l'aide de fichiers .bib.
- Définition de la mise en page avec du CSS : Personnalisation de la mise en page des documents rendus avec CSS.
Utilisation de modèles
- Modèles HTML : Création et utilisation de modèles HTML pour un rendu cohérent.
- Modèles PDF : Création et utilisation de modèles PDF.
- Modèles Word : Création et utilisation de modèles Word.
Hébergement et automatisation (avance)
- Introduction à Git et GitHub : Présentation de Git et GitHub pour la gestion de version et la collaboration.
- Déployer son rapport avec GitPages : Utilisation de GitPages pour héberger les rapports en ligne.
- Délivrer son rapport en continu (CI/CD) : Mise en place de l'intégration et du déploiement continus pour automatiser la génération et la publication des rapports.
Projet fil rouge
- Spécifications d'un rapport statistique automatisé : Définition des spécifications du projet pratique.
- Implémentation en binômes : Travail en binômes pour développer et implémenter le projet.
- Restitution et retours : Présentation des projets, retour d'expérience et feedback.