Mise en page des mémos

Les mémos sont générés par nbdev qui utilise quarto qui lui-même utilise pandoc.

Il faut donc se reporter à Quarto pour ce qui est des possibilités de présentation:

Style

Note

Note that there are five types of callouts, including: note, warning, important, tip, and caution.

Tip With Caption

This is an example of a callout with a caption.

This is an example of a ‘folded’ caution callout that can be expanded by the user. You can use collapse="true" to collapse it by default or collapse="false" to make a collapsible callout that is expanded by default.

Gestion des images

Les images mises dans le dossier notebooks/memos/images sont visibles par le site générés.

Logo AN
![Logo AN](images/picto-potentiel-financier.png)

On peut aussi insérer une image avec l’URL complète:

Logo AN
![Logo AN](https://leximpact.an.fr/icons/picto-impact-strates.png)

Cacher / montrer

#| hide cache tout, complètement

# | echo: false cache le code et affiche la sortie

#hide_input

#| echo: true

#| output: false affiche le code et cache la sortie

print("output: false")

Sortir du cadre

By default, elements are position in the body of the document and are allowed to span the content of the document, like the below. But if you’d like, you can extend content slightly outside the bounds of the body by creating a div with the .column-body-outset class. For example:

#| column: page
print("Your code")

Diagrammes

Depuis août 2022, NBDev V2 apporte un support des diagrammes par Quarto : https://quarto.org/docs/authoring/diagrams.html

Mais il faut mettre à jour la pipeline de déploiement des Notebook.

flowchart LR
  A[Hard edge] --> B(Round edge)
  B --> C{Decision}
  C --> D[Result one]
  C --> E[Result two]

Graphiques

Les graphiques réalisés avec plotly dans les notebooks ne s’affichent pas par défaut dans les html. Ceci est dû à un paramétrage par défaut du renderer de plotly créé par l’extension de VSCode Jupyter Notebook Renderers qui n’est pas compatible avec quarto. Pour résoudre le problème il faut paramétrer les graphiques en ajoutant au début de notebook:

import plotly.io as pio
pio.renderers.default = "notebook"