index.qmd

---
title: "Some particles"
format: 
  html:
    template-partials: 
      - title-block.html
toc: true
title-block-banner: true
subtitle: "A quarto doc with some crazy particles in the header background"
author: Yan Holtz
date: "September 2024"
---

This doc showcases how to use `particle.js` to get a nice header in your quarto document.

let's dive in.

# What is particle.js

It's a javascript library that draws stunning particles in a HTML document.

You can check it on [github](https://github.com/VincentGarreau/particles.js/), and play with this [little tool](https://vincentgarreau.com/particles.js/) to find the configuration that is right for you.

# How to use it in Quarto?

It is possible thanks to a "template partials". It's a quarto option that allows to replace the code of a section of the document. 

The `title-block` partial can be used to customize the header, and inject some particles in it!

For more explanation, check the gallery of [Quarto tips and tricks](https://www.productive-r-workflow.com/quarto-tricks)!