From f665e85b68e2f6546290612e880586ce86047770 Mon Sep 17 00:00:00 2001 From: jpramil Date: Wed, 17 Jun 2026 10:03:50 +0000 Subject: [PATCH 1/5] Switch to website format output + blue navbar and remove sidebar --- .gitignore | 2 + _quarto.yml | 190 +++++++++++++++++++++++++++------------------------- 2 files changed, 101 insertions(+), 91 deletions(-) diff --git a/.gitignore b/.gitignore index 59103897..1e55e2ba 100644 --- a/.gitignore +++ b/.gitignore @@ -51,3 +51,5 @@ data/donnes_entrees.csv _targets/ /resources/rmarkdown/chunk* **/*.quarto_ipynb + +rv/library/ diff --git a/_quarto.yml b/_quarto.yml index e3bec698..5ef0ded1 100644 --- a/_quarto.yml +++ b/_quarto.yml @@ -1,117 +1,125 @@ -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: |
  • Code source
    • left: | This book was built with Quarto. - repo-url: https://github.com/InseeFrLab/utilitR - repo-actions: [edit,issue] - repo-branch: master - 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 - - 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 - - text: "Manipuler des données" - href: 03_Fiches_thematiques/Fiche_joindre_donnees.qmd - - text: "Produire des sorties" - href: 03_Fiches_thematiques/Fiche_graphiques.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: "Projet statistique" + 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" + 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: "Paradigmes" + 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: "Manipuler" + menu: + - 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" + 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: From d5057f186ed633d43380101b777af544ade688dc Mon Sep 17 00:00:00 2001 From: jpramil Date: Wed, 17 Jun 2026 10:04:56 +0000 Subject: [PATCH 2/5] blue navbar scss --- css/style.scss | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/css/style.scss b/css/style.scss index 5783d6d4..cd9925e9 100644 --- a/css/style.scss +++ b/css/style.scss @@ -2,6 +2,11 @@ $utilitr-color: #93bcbc; +// Navbar : moderne blue +$navbar-bg: #000091; +$navbar-fg: #ffffff; +$navbar-hl: #8585f6; + /*-- scss:rules --*/ From f791ae0c76406b164444f584df68d88c75701abf Mon Sep 17 00:00:00 2001 From: jpramil Date: Wed, 17 Jun 2026 10:22:15 +0000 Subject: [PATCH 3/5] debug _quarto.yml --- _quarto.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_quarto.yml b/_quarto.yml index 5ef0ded1..14e2bf13 100644 --- a/_quarto.yml +++ b/_quarto.yml @@ -5,8 +5,8 @@ project: render: - index.qmd - "01_R_Insee/*.qmd" -# - "02_Bonnes_pratiques/*.qmd" -# - "03_Fiches_thematiques/*.qmd" + - "02_Bonnes_pratiques/*.qmd" + - "03_Fiches_thematiques/*.qmd" - "!04_misc/" - "!cards/" - "!rv/" From 1d1349740429b3b28a7c14e9c4f1975d8f44d04f Mon Sep 17 00:00:00 2001 From: blasco Date: Wed, 17 Jun 2026 13:22:30 +0000 Subject: [PATCH 4/5] Changement des titres de la navbar --- _quarto.yml | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/_quarto.yml b/_quarto.yml index 14e2bf13..c4800fa6 100644 --- a/_quarto.yml +++ b/_quarto.yml @@ -40,7 +40,7 @@ website: href: 01_R_Insee/presentation_utilitr.qmd - text: "Comment utiliser la documentation utilitR" href: 01_R_Insee/Fiche_utiliser_utilitR.qmd - - text: "Projet statistique" + - text: "Commencer son projet" menu: - text: "Utiliser les projets RStudio" href: 03_Fiches_thematiques/Fiche_rprojects.qmd @@ -58,7 +58,7 @@ website: 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" + - text: "Importer des données" menu: - text: "Importer des fichiers plats (csv, tsv, txt)" href: 03_Fiches_thematiques/Fiche_import_fichiers_plats.qmd @@ -72,7 +72,7 @@ website: href: 03_Fiches_thematiques/Fiche_api.qmd - text: "Se connecter à une base de données" href: 03_Fiches_thematiques/Fiche_connexion_bdd.qmd - - text: "Paradigmes" + - text: "Manipuler des données" menu: - text: "Manipuler avec le tidyverse" href: 03_Fiches_thematiques/Fiche_tidyverse.qmd @@ -82,8 +82,6 @@ website: href: 03_Fiches_thematiques/Fiche_arrow.qmd - text: "Manipuler avec duckdb" href: 03_Fiches_thematiques/Fiche_duckdb.qmd - - text: "Manipuler" - menu: - text: "Joindre des tables de données" href: 03_Fiches_thematiques/Fiche_joindre_donnees.qmd - text: "Manipuler des données textuelles" @@ -96,7 +94,7 @@ website: 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" + - text: "Produire des sorties" menu: - text: "Faire des graphiques avec ggplot2" href: 03_Fiches_thematiques/Fiche_graphiques.qmd From 90461d6db6d5644cd4bf228f3d9819da28a6210b Mon Sep 17 00:00:00 2001 From: blasco Date: Wed, 17 Jun 2026 14:00:32 +0000 Subject: [PATCH 5/5] Suppression des tuiles ojs "Principales parties" --- index.qmd | 111 ------------------------------------------------------ 1 file changed, 111 deletions(-) diff --git a/index.qmd b/index.qmd index 13270199..1c6e5d33 100644 --- a/index.qmd +++ b/index.qmd @@ -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. - - - -
    - - -```{ojs} -//| echo: false -teaserList(keys) -``` - -```{ojs} -//| echo: false -function teaserList(docs, css = THEME_TEASERS) { - const id = DOM.uid().id; - return html`
    - ${getScopedStyle(`#${id}`, css)} -
    ${docs.map(doc => renderTeaser(doc))} - `; -} -``` - -```{ojs} -//| echo: false -function renderTeaser(doc) { - const { image, title, description, website, order } = doc; - - return ` - -
    -

    - -

    -
    -
    ${title}
    -
    ${description} -
    -
    -
    -     - `; -} -``` - - - -```{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 utilitr.", - "website": "/01_R_Insee/presentation_utilitr.html", - "order": 1 - }, - { - "image": "https://rgeo.linogaliana.fr/cards/wrangling/kidmatrix.png", - "title": "Mener un projet statistique avec ", - "description": "
    Un ensemble de fiches présentant comment se lancer dans un projet d'analyse de données avec
    .", - "website": "03_Fiches_thematiques/Fiche_rprojects.html", - "order": 2 - }, - { - "image": "https://rgeo.linogaliana.fr/cards/introduction/baby.png", - "title": "Import des données avec ", - "description": "
    Un ensemble de fiches présentant comment importer des données depuis .", - "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 ", - "description": "
    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 ", - "description": "
    Des fiches sur des opérations classiques pour manipuler des bases de données avec ", - "website": "03_Fiches_thematiques/Fiche_joindre_donnees.html", - "order": 5 - }, - { - "image": "https://rgeo.linogaliana.fr/cards/quarto/scroll.png", - "title": "Produire des sorties avec ", - "description": "
    Des fiches sur la manière de partager des sorties d'une analyse de données avec ", - "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": "
    Des fiches sur la manière de partager des sorties d'une analyse de données avec ", - "website": "02_Bonnes_pratiques/01-qualite-code.html", - "order": 7 - } -] -``` - ## Ressources utiles {.unnumbered} ### Convertir des codes SAS en `R` {.unnumbered}