Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -51,3 +51,5 @@ data/donnes_entrees.csv
_targets/
/resources/rmarkdown/chunk*
**/*.quarto_ipynb

rv/library/
178 changes: 94 additions & 84 deletions _quarto.yml
Original file line number Diff line number Diff line change
@@ -1,22 +1,25 @@
project:
type: book
project:
type: website
output-dir: _public
# Comment first lines to make faster previews
render:
- index.qmd
- "01_R_Insee/*.qmd"
- "03_Fiches_thematiques/Fiche_import_fichiers_parquet.qmd"
- "02_Bonnes_pratiques/*.qmd"
- "03_Fiches_thematiques/*.qmd"
- "!04_misc/"
- "!cards/"
- "!rv/"

comments:
hypothesis: true

book:
# title: "`utilitR`"
# author: "Une documentation collaborative"
# date: last-modified
# description: "Documentation utilitR"
page-navigation: true
reader-mode: true
sharing: [twitter, linkedin]
website:
title: "utilitR"
favicon: resources/logo-utilitr.png
repo-url: https://github.com/InseeFrLab/utilitR
repo-actions: [edit, issue]
repo-branch: main

page-footer:
right: |
Expand All @@ -28,90 +31,97 @@ book:
repo-branch: main
favicon: resources/logo-utilitr.png

# Navigation : tout passe par la navbar en haut (menus déroulants), pas de sidebar.
navbar:
search: true
logo: resources/logo-utilitr.png
logo-alt: "Logo du projet utilitR"
background: white
collapse-below: lg
left:
- text: "Introduction"
href: 01_R_Insee/presentation_utilitr.qmd
- text: "Mener un projet statistique"
href: 03_Fiches_thematiques/Fiche_rprojects.qmd
menu:
- text: "Présentation du projet utilitR"
href: 01_R_Insee/presentation_utilitr.qmd
- text: "Comment utiliser la documentation utilitR"
href: 01_R_Insee/Fiche_utiliser_utilitR.qmd
- text: "Commencer son projet"
menu:
- text: "Utiliser les projets RStudio"
href: 03_Fiches_thematiques/Fiche_rprojects.qmd
- text: "Utiliser Git avec RStudio"
href: 03_Fiches_thematiques/Fiche_git_utilisation.qmd
- text: "Utiliser des packages R"
href: 01_R_Insee/Fiche_installer_packages.qmd
- text: "Comment choisir un package ?"
href: 03_Fiches_thematiques/Fiche_comment_choisir_un_package.qmd
- text: "Gérer les dépendances"
href: 03_Fiches_thematiques/Fiche_gerer_dependances.qmd
- text: "Se documenter sur R"
href: 03_Fiches_thematiques/Fiche_se_documenter.qmd
- text: "Résoudre un problème avec R"
href: 03_Fiches_thematiques/Fiche_resoudre_un_probleme.qmd
- text: "Chaîne de traitement avec targets"
href: 03_Fiches_thematiques/Fiche_targets.qmd
- text: "Importer des données"
href: 03_Fiches_thematiques/Fiche_import_fichiers_plats.qmd
- text: "Choisir son paradigme"
href: 03_Fiches_thematiques/Fiche_tidyverse.qmd
menu:
- text: "Importer des fichiers plats (csv, tsv, txt)"
href: 03_Fiches_thematiques/Fiche_import_fichiers_plats.qmd
- text: "Importer des tables SAS"
href: 03_Fiches_thematiques/Fiche_import_tables_sas.qmd
- text: "Importer des tableurs (Excel, Calc)"
href: 03_Fiches_thematiques/Fiche_import_tableurs.qmd
- text: "Lire et écrire des fichiers Parquet"
href: 03_Fiches_thematiques/Fiche_import_fichiers_parquet.qmd
- text: "Travailler avec des API"
href: 03_Fiches_thematiques/Fiche_api.qmd
- text: "Se connecter à une base de données"
href: 03_Fiches_thematiques/Fiche_connexion_bdd.qmd
- text: "Manipuler des données"
href: 03_Fiches_thematiques/Fiche_joindre_donnees.qmd
menu:
- text: "Manipuler avec le tidyverse"
href: 03_Fiches_thematiques/Fiche_tidyverse.qmd
- text: "Manipuler avec data.table"
href: 03_Fiches_thematiques/Fiche_datatable.qmd
- text: "Manipuler avec arrow"
href: 03_Fiches_thematiques/Fiche_arrow.qmd
- text: "Manipuler avec duckdb"
href: 03_Fiches_thematiques/Fiche_duckdb.qmd
- text: "Joindre des tables de données"
href: 03_Fiches_thematiques/Fiche_joindre_donnees.qmd
- text: "Manipuler des données textuelles"
href: 03_Fiches_thematiques/Fiche_donnees_textuelles.qmd
- text: "Utiliser des données d'enquêtes"
href: 03_Fiches_thematiques/Fiche_survey.qmd
- text: "Manipuler des données spatiales"
href: 03_Fiches_thematiques/Fiche_donnees_spatiales.qmd
- text: "Manipuler des données temporelles"
href: 03_Fiches_thematiques/Fiche_donnees_temporelles.qmd
- text: "L'analyse de données (ACP, ACM…)"
href: 03_Fiches_thematiques/Fiche_analyse_de_donnees.qmd
- text: "Produire des sorties"
href: 03_Fiches_thematiques/Fiche_graphiques.qmd
menu:
- text: "Faire des graphiques avec ggplot2"
href: 03_Fiches_thematiques/Fiche_graphiques.qmd
- text: "Produire des documents avec R Markdown"
href: 03_Fiches_thematiques/Fiche_rmarkdown.qmd
- text: "Rapports automatisés avec R Markdown"
href: 03_Fiches_thematiques/Fiche_rmarkdown_param_report.qmd
- text: "Bonnes pratiques"
href: 02_Bonnes_pratiques/01-qualite-code.qmd

sidebar:
style: "docked"
search: true
logo: resources/logo-utilitr.png


chapters:
- index.qmd
- part: "Introduction"
chapters:
- 01_R_Insee/presentation_utilitr.qmd
- 01_R_Insee/Fiche_utiliser_utilitR.qmd
- part: "Mener un projet statistique avec R"
chapters:
- 03_Fiches_thematiques/Fiche_rprojects.qmd
- 03_Fiches_thematiques/Fiche_git_utilisation.qmd
- 01_R_Insee/Fiche_installer_packages.qmd
- 03_Fiches_thematiques/Fiche_comment_choisir_un_package.qmd
- 03_Fiches_thematiques/Fiche_gerer_dependances.qmd
- 03_Fiches_thematiques/Fiche_se_documenter.qmd
- 03_Fiches_thematiques/Fiche_resoudre_un_probleme.qmd
- 03_Fiches_thematiques/Fiche_targets.qmd
- part: "Importer des données avec R"
chapters:
- 03_Fiches_thematiques/Fiche_import_fichiers_plats.qmd
- 03_Fiches_thematiques/Fiche_import_tables_sas.qmd
- 03_Fiches_thematiques/Fiche_import_tableurs.qmd
- 03_Fiches_thematiques/Fiche_import_fichiers_parquet.qmd
- 03_Fiches_thematiques/Fiche_api.qmd
- 03_Fiches_thematiques/Fiche_connexion_bdd.qmd
- part: "Choisir son paradigme d'analyse des données avec R"
chapters:
- 03_Fiches_thematiques/Fiche_tidyverse.qmd
- 03_Fiches_thematiques/Fiche_datatable.qmd
- 03_Fiches_thematiques/Fiche_arrow.qmd
- 03_Fiches_thematiques/Fiche_duckdb.qmd
- part: "Manipuler des données avec R"
chapters:
- 03_Fiches_thematiques/Fiche_joindre_donnees.qmd
- 03_Fiches_thematiques/Fiche_donnees_textuelles.qmd
- 03_Fiches_thematiques/Fiche_survey.qmd
- 03_Fiches_thematiques/Fiche_donnees_spatiales.qmd
- 03_Fiches_thematiques/Fiche_donnees_temporelles.qmd
- 03_Fiches_thematiques/Fiche_analyse_de_donnees.qmd
- part: "Produire des sorties avec R"
chapters:
- 03_Fiches_thematiques/Fiche_graphiques.qmd
- 03_Fiches_thematiques/Fiche_rmarkdown.qmd
- 03_Fiches_thematiques/Fiche_rmarkdown_param_report.qmd
- part: "Bonnes pratiques"
chapters:
- 02_Bonnes_pratiques/01-qualite-code.qmd
- 02_Bonnes_pratiques/02-structure-code.qmd
- part: "Éléments de configuration"
chapters:
- 01_R_Insee/Fiche_utiliser_Rstudio_AUSv3.qmd
- 03_Fiches_thematiques/Fiche_configurer_git.qmd
- 01_R_Insee/Fiche-personnaliser-R.qmd
- 01_R_Insee/Fiche_utiliser_ressources.qmd

# not sure what the following line does; those files are present
# bibliography: [references.bib, book.bib]
menu:
- text: "Qualité du code"
href: 02_Bonnes_pratiques/01-qualite-code.qmd
- text: "Structure des projets"
href: 02_Bonnes_pratiques/02-structure-code.qmd
- text: "Configuration"
menu:
- text: "Utiliser RStudio sur AUSv3"
href: 01_R_Insee/Fiche_utiliser_Rstudio_AUSv3.qmd
- text: "Configurer Git sur son poste"
href: 03_Fiches_thematiques/Fiche_configurer_git.qmd
- text: "Personnaliser la configuration de R"
href: 01_R_Insee/Fiche-personnaliser-R.qmd
- text: "Superviser sa session R"
href: 01_R_Insee/Fiche_utiliser_ressources.qmd

format:
html:
Expand Down
5 changes: 5 additions & 0 deletions css/style.scss
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,11 @@

$utilitr-color: #93bcbc;

// Navbar : moderne blue
$navbar-bg: #000091;
$navbar-fg: #ffffff;
$navbar-hl: #8585f6;

/*-- scss:rules --*/


Expand Down
111 changes: 0 additions & 111 deletions index.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -55,117 +55,6 @@ Si c'est le cas, `utilitR` ne vous aidera pas beaucoup, mais des liens vers des
:::


## Principales parties {.unnumbered}

Les principales parties de la documentation, organisées sous
forme thématique.



<br>


```{ojs}
//| echo: false
teaserList(keys)
```

```{ojs}
//| echo: false
function teaserList(docs, css = THEME_TEASERS) {
const id = DOM.uid().id;
return html`<div id="${id}">
${getScopedStyle(`#${id}`, css)}
<div class=listing-grid>${docs.map(doc => renderTeaser(doc))}
`;
}
```

```{ojs}
//| echo: false
function renderTeaser(doc) {
const { image, title, description, website, order } = doc;

return `
<a href="${website}" class="grid-item-link" target="_blank" rel="noopener">
<div class="card">
<p class="card-img-top">
<img class="thumbnail-image card-img" src="${image}" style="height: auto;">
</p>
<div class="card-body post-contents">
<h5 class="no-anchor card-title listing-title" data-anchor-id="introduction-aux-méthodes-quantitatives-avec-fa-brands-r-project">${title}</h5>
<div class="card-text listing-description delink">${description}
</div>
</div>
</div>
</a>
`;
}
```



```{ojs}
//| echo: false
import { THEME_TEASERS, ICON_LIKE, getScopedStyle } from "@mootari/notebook-teasers"
```


```{ojs}
//| echo: false
keys = [
{
"image": "https://inseefrlab.github.io/formation-bonnes-pratiques-git-R/cards/version-sensibilisation/cats.png",
"title": "Introduction",
"description": "Des éléments de présentation du projet <code>utilitr</code>.",
"website": "/01_R_Insee/presentation_utilitr.html",
"order": 1
},
{
"image": "https://rgeo.linogaliana.fr/cards/wrangling/kidmatrix.png",
"title": "Mener un projet statistique avec <i class=\"fa-brands fa-r-project\"></i>",
"description": "<br>Un ensemble de fiches présentant comment se lancer dans un projet d'analyse de données avec <i class=\"fa-brands fa-r-project\"></i><br>.",
"website": "03_Fiches_thematiques/Fiche_rprojects.html",
"order": 2
},
{
"image": "https://rgeo.linogaliana.fr/cards/introduction/baby.png",
"title": "Import des données avec <i class=\"fa-brands fa-r-project\"></i>",
"description": "<br>Un ensemble de fiches présentant comment importer des données depuis <i class=\"fa-brands fa-r-project\"></i>.",
"website": "03_Fiches_thematiques/Fiche_import_fichiers_plats.html",
"order": 3
},
{
"image": "https://rgeo.linogaliana.fr/cards/wrangling/kidmatrix.png",
"title": "Choisir son paradigme d'analyse de données avec <i class=\"fa-brands fa-r-project\"></i>",
"description": "<br>Des fiches générales pour présenter les principaux écosystèmes d'analyse de données.",
"website": "03_Fiches_thematiques/Fiche_tidyverse.html",
"order": 4
},
{
"image": "https://rgeo.linogaliana.fr/cards/wrangling/kidmatrix.png",
"title": "Manipuler des données avec <i class=\"fa-brands fa-r-project\"></i>",
"description": "<br>Des fiches sur des opérations classiques pour manipuler des bases de données avec <i class=\"fa-brands fa-r-project\"></i>",
"website": "03_Fiches_thematiques/Fiche_joindre_donnees.html",
"order": 5
},
{
"image": "https://rgeo.linogaliana.fr/cards/quarto/scroll.png",
"title": "Produire des sorties avec <i class=\"fa-brands fa-r-project\"></i>",
"description": "<br>Des fiches sur la manière de partager des sorties d'une analyse de données avec <i class=\"fa-brands fa-r-project\"></i>",
"website": "03_Fiches_thematiques/Fiche_graphiques.html",
"order": 6
},
{
"image": "https://inseefrlab.github.io/formation-bonnes-pratiques-git-R/cards/version-full/eagle.png",
"title": "Bonnes pratiques",
"description": "<br>Des fiches sur la manière de partager des sorties d'une analyse de données avec <i class=\"fa-brands fa-r-project\"></i>",
"website": "02_Bonnes_pratiques/01-qualite-code.html",
"order": 7
}
]
```

## Ressources utiles {.unnumbered}

### Convertir des codes SAS en `R` {.unnumbered}
Expand Down