cours/quarto extension nutshell.md
Oscar Plaisant 602a41e7f8 update
2024-12-25 22:30:24 +01:00

2.0 KiB

up:: quarto extensions link:: https://github.com/schochastics/quarto-nutshell, https://ncase.me/nutshell/ #s/informatique #s/blog

Nutshell est un système pour faire des inclusions de texte dépliables.

[!info]- Fonctionnalités Nutshell permet de faire des "liens" qui, quand clique dessus, déplient une bulle qui contient plus de détails

  • cacher des sections dans un lien repliable
  • cacher des paragraphes dans un lien repliable
  • inclusions d'autres sites (wikipedia, youtube...)
  • "sections invisibles" : des sections qui ne sont pas affichées là où elles sont, mais là où un lien nutshell y fait référence
  • 🔗 ajouter un boutton qui permet d'intégrer les replis dans un autre site web !

[!info]- Utiliser nutshell dans quarto Il faut préciser qu'on utilise le filtre nutshell dans le frontmatter yaml du document :

filters:
  - nutshell

[!example]- Exemple

---
title: "Nutshell: Expandable Explanations"
author: "David Schoch"
format: html
filters:
  - nutshell
---


## [:What is Nutshell?](#what-is-nutshell)
Nutshell is a tool to make "expandable explanations", like this! This lets your readers learn only the details they need, just-in-time, always-in-context.

Unlike links, Nutshell lets you include only the snippet you need, not the whole page. Plus, instead of being lost in a jungle of new tabs, your reader stays on one page, keeping their flow of reading. Even if you interrupt a sentence, Nutshell recaps the sentence afterwards, so your reader never loses context.

You can find more information on the nutshell [webpage](https://ncase.me/nutshell/) 

## Test

This is a senseless paragraph

## Testing Links

- [:link to senseless paragraph](#test)  
- [:link to wikipedia article](https://en.wikipedia.org/wiki/Nutshell)
- [:link to invisible sections](#x-invisible)

## :x invisible

Use `## :x header` to include an invisible secion that can be linked to via nutshell