Description
Cette formation vise à initier les participants à la rédaction de documents techniques reproductibles en utilisant des outils modernes tels que Markdown et Quarto. Les apprenants découvriront les limites des traitements de texte traditionnels et apprendront à manipuler des données avec R et Python, tout en intégrant des graphiques et des statistiques. La formation inclut également des aspects avancés comme la personnalisation de documents, l'utilisation de modèles, ainsi que l'hébergement et l'automatisation via Git et GitHub.
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
- Présentation du projet pratique qui servira de fil conducteur tout au long de la formation
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
- Introduction à la manipulation de données en R en utilisant les bibliothèques dplyr et tidyr
- Utilisation de la fonction summary pour obtenir des statistiques descriptives de base
- Création de graphiques avec la bibliothèque ggplot2
Génération de résultats statistiques en Python
- Manipulation de données en Python en utilisant la bibliothèque pandas
- Utilisation de la méthode describe pour obtenir des statistiques descriptives de base
- Création de graphiques avec les bibliothèques matplotlib et seaborn
Mise en forme avancée
- Ajout d'équations mathématiques dans les documents
- Personnalisation avancée des tableaux en utilisant les bibliothèques kable et gt
- Ajout de références bibliographiques avec .bib
- Personnalisation de la mise en page des documents rendus avec CSS
Utilisation de modèles
- Création et utilisation de modèles HTML pour un rendu cohérent
- Création et utilisation de modèles PDF
- Création et utilisation de modèles Word
Hébergement et automatisation avancé
- Présentation de Git et GitHub pour la gestion de version et la collaboration.
- Déployer son rapport avec GitPages
- 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