LaTeX et R Markdown

class: center, middle, inverse, title-slide

.title[
# LaTeX et R Markdown
]
.subtitle[
## Pratiques de la Recherche en Économie
]
.author[
### Florentine Oliveira
]
.date[
### 2024-11-15
]

---

layout: true

---
# Format d'un article de recherche

Les articles académiques en économie empirique suivent un format très **standardisé** :

- **Plan**: 
      - *Introduction*: motivation, présentation de la question de recherche, revue de littérature, contributions
      - *Contexte historique/institutionnel*: contexte spécifique au sujet, cadre économique et institutionnel
      - *Données*: description des sources de données, échantillon, statistiques descriptives
      - *Stratégie empirique modèle*: stratégie et hypothèses d'identification
      - *Résultats*: présentation des résultats principaux
      - *Tests de robustesse*: vérification de la validité des résultats
      - *Conclusion*: synthèse des contributions et implications
- **Bibliographie**: références précises et standardisées, intégrées dans le texte

- **Mise en page très sobre**:    
    - Pas de couleur, sauf pour les graphiques    
    - Police de caractère standardisée (Computer Modern ou Palatino)
    - Marges et interligne standards
    - Titres de sections apparents

---
# Pourquoi ne pas rédiger en Word ?

&nbsp;

- **Mise en page**: 
  - Word est moins adapté aux documents longs et complexes
  - `$\LaTeX$` et R Markdown permettent un contrôle plus précis et **automatisé** de la mise en page et la typographie

- **Gestion des références et bibliographies**: gestion de la bibliographie automatisée et directement intégrée sur `$\LaTeX$` et R Markdown

- **Collaboration**: `$\LaTeX$` et R Markdown sont compatibles avec les outils de contrôle de version comme Git, ce qui facilite le suivi des modifications et la collaboration

- **Intégration des analyses de données**: R Markdown permet d'intégrer du code directement dans le document

---
# LaTeX ?

.center[
 `$\LaTeX$` est un **langage** et un **système de composition de documents** (Wikipédia)
 ]

**Deux attributs principaux** 
- **Mise en page automatique** et conforme à des normes typographiques 
- **Mode Maths**: permet d'écrire des formules mathématiques complexes

**Fonctionnement** 
- **Syntaxe en texte brut** : le contenu et la mise en forme sont définis par des commandes `$\LaTeX$`
- **Compilation** : le code est *compilé* pour générer un PDF

**Modes d'édition** 
- **Éditeurs locaux**: travailler hors ligne avec *TeXworks*, *TeXShop*, *MiKTeX*
- **Éditeur en ligne: Overleaf**
 - Éditeur en ligne collaboratif permettant de créer, compiler et partager des documents `$\LaTeX$` sans installation
 - Particulièrement utile pour les projets en équipe

---
# Cette séance

&nbsp;

.pull-left[
1. Overleaf

&nbsp;&nbsp; 1.1. Présentation            
  &nbsp;&nbsp; 1.2. Structure de base d'un document            
  &nbsp;&nbsp; 1.3. Formattage du texte             
  &nbsp;&nbsp; 1.4. Math mode            
  &nbsp;&nbsp; 1.5. Figures            
  &nbsp;&nbsp; 1.6. Bibliographie            
  &nbsp;&nbsp; 1.7. Commentaires, compilation, téléchargement           
  &nbsp;&nbsp; 1.8. Avantages et inconvénients          
]

.pull-right[
2. R Markdown

&nbsp;&nbsp; 2.1. Présentation                
  &nbsp;&nbsp; 2.2. Syntaxe Markdown                
  &nbsp;&nbsp; 2.3. Chunks                
  &nbsp;&nbsp; 2.4. Figures                
  &nbsp;&nbsp; 2.5. Bibliographie                
  &nbsp;&nbsp; 2.6. Commentaires, compilation, téléchargement                
  &nbsp;&nbsp; 2.7. Avantages et inconvénients              
]

---
layout: false
class: center, middle, inverse

# 1. Overleaf

---
background-image: url(imgs/Overleaf_Logo.png)
background-position: 95% 10%
background-size: 7%

# 1. Overleaf

## 1.1. Présentation

&nbsp;

- Selon le site internet d'Overleaf,

- "an online `$\LaTeX$` editor that's easy to use. No installation, real-time collaboration, version control, hundreds of LaTeX templates, and more."
  
  
- **Éditeur Latex** en ligne, collaboratif en temps réel

- Principe identique à *google docs*, mais syntaxe `$\LaTeX$`

---
# Interface

Console, compilation fichier PDF, téléchargement, collaboration, fichiers, structure du document

---
# 1. Overleaf

## 1.2. Structure de base d'un document

**Préambule**

Le préambule est la partie du document LaTeX avant la commande `\begin{document}`. Il inclut:

1. La définition de la classe de document : `\documentclass{...}`  
  - `article` : pour les articles académiques ou de courts rapports  
  - `report` : pour les rapports plus longs, avec chapitres  
  - `book` : pour les livres, thèses, etc  
  - `beamer` : pour les présentations

2. Les packages ajoutent des fonctionnalités supplémentaires:      
  - `\usepackage{amsmath}` : pour des formules mathématiques avancées  
  - `\usepackage{graphicx}` : pour inclure des images  
  - `\usepackage{xcolor}` : pour utiliser des couleurs   
  
3. Les commandes spécifiques pour configurer le document

---
# 1. Overleaf

## 1.2. Structure de base d'un document

---
# 1. Overleaf
## 1.3. Formatage du texte : saut de ligne

---
# 1. Overleaf
## 1.3. Formatage du texte : indentation

---
# 1. Overleaf
## 1.3. Formatage du texte : section et sous-section

---
# 1. Overleaf
## 1.3. Formatage du texte : texte en italique, gras et couleur

---
# 1. Overleaf
## 1.3. Formatage du texte : listes à puces et numerotées

---
# 1. Overleaf
## 1.4. Math mode

Pour écrire une équation, il suffit de mettre l'expression mathématique entre `$...$`.

Pour des équations centrées et numérotées, utilisez l'environnement `equation`.

.pull-left[
| Opérateur **arithmétiques**  | Description               |
|------------------------------|---------------------------|
| `+` / `-`                    | Addition / Soustraction   |
| `*`                          | Multiplication            |
| `\frac{num.}{denum.}`        | Fraction                  |
| `^`                          | Exposant                  |
| `_`                          | Indice                    |
]

.pull-right[
| Opérateur **logiques** | Description |
|-------------------------|--------------------------------------|
| `<` / `>` | Strictement inférieur / supérieur à |
| `\ge` / `\le` | Supérieur / inférieur ou égal à |
| `=` | Égal à |
| `\neq` | Différent de |
]

&nbsp;

**NB1: l'environnement `equation` est un environnement mathématique, il n'y a donc pas besoin de mettre des `$`**

**NB2: Pour ne pas numéroter les équations de l'environnement `equation`, utiliser `\begin{equation*}` au lieu de `\begin{equation}`**

---
# 1. Overleaf
## 1.4. Math mode

---
# 1. Overleaf
## 1.5. Figures et Subfigures

Pour insérer une figure, on utilise l'environnement `figure`.

Plusieurs éléments:
- `\caption{Titre de la figure}`: titre de la figure
  - 🚨 les figures sont numérotées automatiquement selon leur ordre d'apparition dans le document
- `\label{fig1}`: nom de la figure pour référence dans le texte avec la commande `\ref{fig1}`
-  `\centering` pour centrer la figure sur la page
- `\includegraphics[width=9cm]{fig1.png}`: commande qui charge le fichier image 
  - entre `[ ]` est définie la taille de l'image
  - entre `{ }` le nom (ou chemin) de l'image

---
# 1. Overleaf
## 1.5. **Figures** et Subfigures

---
# 1. Overleaf
## 1.5. Figures et **Subfigures**