Passage sous Quarto

mentioned in issue #32

Note, au cas où, avez-vous connaissance du thème INRAE de Quarto mentionnée sur le forum de la DipSO ?

created branch 34-passage-sous-quarto to address this issue

mentioned in merge request !16 (merged)

mentioned in issue #20 (closed)

@marine.marjou J'ai vu que tu rassemblais tout dans un seul fichier. Je crains que n'avoir qu'un fichier QMD par session rende difficile la modification du fichier. As-tu pu tester {{< include fichier.qmd>}} ?

Points à aborder :

comment découper la présentation :
- un fichier qmd pour chaque colonne ?
- si colonne d'une seule slide on reste dans le fichier principal ? OUI
- le découpage actuel par colonne n'est pas le même qu'initialement OK
comment nomme-t-on les fichiers ?
- proposition : [n° de la colonne]_[titre de la colonne]
inclure les notes ? ==> NON
Exemple à montrer
- colonne "Premières pratiques en local" > "initialisation d'un dépôt git"
  - 3 diapo pour 3 façon de faire
  - Plusieurs sous onglets par slide
  - Sur une slide plusieurs onglets = plusieurs façon de faire
- "Ajouter des fichiers et leur modification sur le dépôt"
  - ajout d'un encart exercice
  - l'exercice porte sur le .gitignore alors qu'on a pas encore vu ce que c'était... proposer un exercice avec une simple modification d'un fichier (txt, r, autre ?) ?
  - suppression des slides qui expliquent le pas à pas de l'exercice => ??

Hello, je débarque suite à notre réunion ;) En parcourant rapidement les support, je vois qu'il y aura en effet un peu de boulot pour passer sur Quarto... je peux donner un coup de main si vous voulez !!

Notamment pourquoi pas en utilisant un thème INRAE https://github.com/davidcarayon/quarto-inrae-extension Exemple de ce que ça donne : https://statire.github.io/bulledr/01-bonnes_pratiques/

Et comme il s'agit de recueillir plusieurs slides au même endroit (avec une sorte de page d'accueil comme vous l'avez actuellement), vous pourriez peut-être en faire carrément un site web quarto avec un listings comme migale l'a fait ? Ce qui vous permettrait après sur le site d'avoir aussi des onglets avec la liste des formateurs ou d'autres contenus ?

https://documents.migale.inrae.fr

Salut David, c'est moi qui m'occupe du passage sous quarto ;) Et en effet, j'avais en tête de tester le thème INRAE sur la présentation.

J'ai tout d'abord testé dans un nouveau projet avec la commande quarto use template davidcarayon/quarto-inrae-extension et là ça fonctionne correctement (alors j'ai télécharger le dossier quarto-inrae-extension, mais pour que cela fonctionne j'ai déplacé le dossier _extensions à la racine de mon projet, il y a sans doute mieux à faire).

Ensuite j'ai voulu tester pour ajouter le thème à la présentation de la formation. J'ai suivi les lignes de commande à renseigner mais ça n'as pas l'air de fonctionner. J'ai testé le quarto add davidcarayon/quarto-inrae-extension, bien que ce ne soit pas recommandé je n'ai pas d'autre solution puisque je suis sur un projet déjà existant. J'ai renseigné les paramètres suivant : format: inrae-revealjs mais j'ai le message d'erreur suivant :

ERROR: Unable to read the extension 'inrae'.
Please ensure that you provided the correct id and that the extension is installed.

À savoir que j'ai également testé de charger l'ensemble du dossier quarto-inrae-extension à la racine de la présentation et de déplacer le dossier _extensions mais rien n'y fait j'ai le même message d'erreur.

Si tu as des tips je suis preneuse !

Et concernant notre page d'accueil actuel, on a ouvert l'issue #36. Et je comptais également proposer (dans un premier temps juste pour montrer au collègue le visuel qu'on peut avoir) une page d'accueil au format quarto website (ou blog à voir). Et oui pourquoi pas utiliser le thème INRAE ( #36 (comment 265785))

Salut Marine !

Bravo pour ce boulot !

En fait j'ai pour habitude de mettre "non recommandé" pour la version add car c'est en effet souvent compliqué de positionner le dossier d'extensions au bon endroit. Ton message d'erreur indique bien qu'il n'a pas réussi à trouver ce fameux dossier _extensions.

Peut-être une solution : placer un _quarto.yml minimal à la racine du projet (cf. Quarto projects pour que tous les qmd soient exécutés avec un quarto render. Normalement, ça devrait bien détecter le dossier d'extension à la racine.

Sinon, est-ce que l'option de repartir avec un repo vide from scratch avec le use template, puis copier-coller le contenu des formations est inenvisageable ?

Alors j'ai testé ta première solution et c'est bon ça marche !! Dans mon _quarto.yml (que j'ai placé à la racine du projet) je lui indique quel fichier qmd lire et ça me prend bien en compte le thème !

Par contre chose étrange, avant de créer le fichier yml au moment de lancer la présentation ma présentation se lançait correctement dans mon navigateur (ou dans le viewer de Rstudio). Maintenant ça me met une erreur 404, en revanche j'ai bien accès à la présentation à jour lorsque je lance le fichier html dans mon dossier de sortie... Peut être un problème de lecture de chemin ?

Dans tout les cas merci de ton aide

Top ! c'était bien cela.

En effet, quand tu passes dans une optique "projet" quarto, les contenu issu du render se mettent tout dans un nouveau dossier (qu'il faut définir comme "public" pour simplifier le deploy Gitlab pages d'ailleurs).

---
project:
  type: default
  output-dir: public
---

Y'a moyen que Rstudio n'arrive pas à suivre.

Je n'utilises plus trop Rstudio mais il me semble que dans le cadre d'un projet quarto je privilégiais un quarto preview dans le terminal

mentioned in issue #36

mentioned in issue #41 (closed)

mentioned in issue #57

mentioned in issue #48

mentioned in issue #50 (closed)

Je viens de parcourir tout le support de la session 1, c'est vraiment super classe , bravo @marine.marjou

Pour ce qui était "en parallèle" avant, je n'ai pas d'avis très tranché sur quelle approche adapter pour les moments quand les onglets ne suffisent pas pour couvrir les 3 outils. Quelques remarques quand même :

je trouve que faire une diapo de sommaire, c'est un peu lourd, et ça risque peut-être plus de perdre les gens qu'autre chose
ça vaudrait la peine de mettre plus en valeur (gras, une autre couleur…) les mots "rStudio", "VScode" ou "ligne de commande" quand on est sur une diapo spécifique à ça
pour être un plus lisible sur le fait qu'une diapo est spécifique à un outil, on peut imaginer mettre sur cette diapo un logo de l'outil en question, avec une petite explication diapo 4. Reste à trouver comment on peut mettre une image sur certaines diapos spécifiques.

Quelques remarques en vrac :

Diapo 20, j'ai l'impression que le premier onglet (ligne de commande) n'a pas le bon lien pour windows (qui à priori devrait être le même que dans l'onglet "RStudio"). Actuellement le lien pointe en dur sur une release (la 2.39.1), c'est pas top
Diapo 52, il y a "repo history" au milieu, j'ai l'impression que ça ne devrait pas être là
Diapos 77 et 78, est-ce ce qui listé ne devrait pas être cliquable ?

En tout cas, ça gère la fougère

Merci pour ton retour :

diapo 20 : c'est modifié, je ne sais pas d'où sort ce lien
diapo 52 : c'est "normal", lorsqu'on intègre une image dans quarto, tout ce qui est entre les crochets sera affiché comme légende de l'image. J'ai oublié de supprimer pour cette image
diapo 77,78 : j'ai modifié

on peut imaginer mettre sur cette diapo un logo de l'outil en question

J'ai intégré le logo R et VScode, ça rend pas mal ;)

Bonjour,

Quelle est la commande pour générer la présentation ?

J'ai essayé cd 01_initiation; quarto render, mais ça marche pas.

J'ai essayé cd 01_initiation; quarto preview index.qmd ou quarto preview 01_initiation/index.qmd , mais j'ai cette erreur

ERROR: Unable to read the extension 'inrae'.
Please ensure that you provided the correct id and that the extension is installed.

@marine.marjou comment on installe le thème inrae ?

mentioned in commit 2aa6cb3a

mentioned in commit 60dcc9b3

J'ai téléchargé depuis ton lien FileSender. Comme tu le disais, c'est bien que l'on puisse distribuer ainsi dans un seul fichier HTML. C'est pratique.

La présentation est propre, c'est beau !

J'ai vu des coquilles. Le plus simple est que je modifie dans ta branche. Je te fais une MR à moins que tu préfères que je modifie directement (et quand).

Je n'aime pas l'animation entre chaque diapo, ça fait clignoter mes yeux.

Session 1
- diapo 16 : je changerais bien le titre en « Tous les états du système de fichiers », pour marquer un peu plus le fait que l'on ne verra pas tous ces états dans cette session
- diapos 23, 24, 25 : les onglets portent sur des étapes à passer. Je préfère qu'ils soient répartis dans des diapos différentes, pour garder la navigation au clavier. Passer de la souris au clavier est gênant et je trouve plus logique que les onglets soient gardés pour des alternatives. Ne peut-on pas garder les onglets pour ces étapes (Initialisation par création, Initialisation d'un projet existant, Intégration/vérification, Attention) ? Ensuite on arrive bien sur la diapo 26 « Consultation ».
- diapo 27 : je préfère séparer en deux diapos « Définition .gitignore », « Créer un fichier .gitignore »
- diapos 73, 74 : idem diapos 23, 24, 25
- ~~diapo 76 : cliquer sur le lien ne l'ouvre pas dans un nouvel onglet~~ modifié dans mon commit
- diapo 76 : c'est nouveau ? je ne fais pas de R, il faudra me montrer ces exercices
Session 2
- diapo 51 : le caractère « : » est renvoyé à la ligne. Il faudra utiliser   à la place de l'espace avant les ponctuations doubles.

Passage sous Quarto

Designs

Child items ...

Activity