55 lines
2.0 KiB
Markdown
55 lines
2.0 KiB
Markdown
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 :
|
|
> ```yaml
|
|
> filters:
|
|
> - nutshell
|
|
> ```
|
|
|
|
> [!example]- Exemple
|
|
> ```markdown
|
|
> ---
|
|
> 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
|
|
> ```
|
|
|