update

.gitattributes

@@ -1,5 +1,11 @@
 *.png filter=lfs diff=lfs merge=lfs -text
 *.jpg filter=lfs diff=lfs merge=lfs -text
+*.jpeg filter=lfs diff=lfs merge=lfs -text
+*.gif filter=lfs diff=lfs merge=lfs -text
+*.mp3 filter=lfs diff=lfs merge=lfs -text
+*.mp4 filter=lfs diff=lfs merge=lfs -text
+*.mov filter=lfs diff=lfs merge=lfs -text
+*.avi filter=lfs diff=lfs merge=lfs -text
 *.wav filter=lfs diff=lfs merge=lfs -text
 *.csv filter=lfs diff=lfs merge=lfs -text
 *.json filter=lfs diff=lfs merge=lfs -text

app/src/components/Hero.astro

@@ -41,7 +41,7 @@ const pdfFilename = `${slugify(pdfBase)}.pdf`;
   <div class="meta-container">
     {authors.length > 0 && (
       <div class="meta-container-cell">
-        <h3>Authors</h3>
+        <h3>Author {authors.length > 1 ? 's' : ''}</h3>
         <p>{authors.join(', ')}</p>
       </div>
     )}

app/src/components/Note.astro

@@ -19,6 +19,7 @@ const hasHeader = (emoji && String(emoji).length > 0) || (title && String(title)
   .note__emoji { font-size: 24px; line-height: 1; }
   .note__title { font-size: 13px; letter-spacing: .2px; }
   .note__content { color: var(--text-color); font-size: 0.95rem; }
-  .note__content > p:last-of-type { margin-bottom: 0 !important; }
+  /* Ensure the very last slotted element has no bottom margin */
+  .note .note__content > :global(*:last-child) { margin-bottom: 0 !important; }
 </style>
 

app/src/content/article.mdx

@@ -4,11 +4,9 @@ title: "Bringing paper to life:\n A modern template for\n scientific writing
 subtitle: "A modern, MDX-first research article template with math, citations and interactive figures."
 description: "A modern, MDX-first research article template with math, citations and interactive figures."
 authors:
-  - "John Doe"
-  - "Alice Martin"
-  - "Robert Brown"
+  - "Thibaud Frere"
 affiliation: "Hugging Face"
-published: "Aug 28, 2025"
+published: "Sep. 01, 2025"
 tags:
   - research
   - template
@@ -70,15 +68,14 @@ import GettingStarted from "./chapters/getting-started.mdx";
 </Sidenote>
 
 ## Introduction
-The web enables explanations that static PDFs cannot: **reactive diagrams**, **progressive notation**, and **exploratory views** that show how ideas behave. Use **interactive fragments** so readers can **hover**, **scrub**, and **inspect**—building **intuition**, not just reading results.
+The web affords explanations that static PDFs cannot: **reactive diagrams**, progressive notation, and exploratory views that reveal how ideas behave. Use **interactive fragments** so readers can hover, scrub, and inspect—building **intuition** rather than merely reading results.
 
-Careful notation, **thoughtful visual encodings**, and **small, manipulable experiments** deepen understanding. By making these artifacts **first‑class** alongside **text, math, and code**, this template helps readers grasp **mechanisms, limits, and trade‑offs**.
+Precise notation, thoughtful visual encodings, and small, **manipulable experiments** deepen understanding. Treat these artifacts as **first‑class** alongside text, math, and code to help readers grasp mechanisms, limits, and trade‑offs.
 
-Not every contribution fits a PDF. Treat demos, visualizations, and interactive write‑ups as **scholarship**: **cite** them, **version** them, and **ship** them with clear, **inspectable examples** that expose **intermediate states** and link to sources so readers can **verify** claims and **reproduce** results.
+Not every contribution fits a PDF. Treat demos, visualizations, and interactive write‑ups as scholarship: cite and version them, and ship clear, inspectable examples that expose intermediate states and link to sources so readers can verify and reproduce results.
 
 This project is heavily inspired by [**Distill**](https://distill.pub) (2016–2021), which championed clear, web‑native scholarship.
 
-
 {/* ### Notable examples of excellent scientific articles
 
 A short, curated list of well‑designed and often interactive work:

app/src/content/chapters/available-blocks.mdx

@@ -4,6 +4,7 @@ import audioDemo from '../assets/audio/audio-example.wav';
 import HtmlEmbed from '../../components/HtmlEmbed.astro';
 import Sidenote from '../../components/Sidenote.astro';
 import Wide from '../../components/Wide.astro';
+import Note from '../../components/Note.astro';
 import FullWidth from '../../components/FullWidth.astro';
 import Accordion from '../../components/Accordion.astro';
 
@@ -20,9 +21,10 @@ All the following blocks are available in the article.mdx file. You can also cre
   <a className="button" href="#citations-and-notes">Citations & notes</a>
   <a className="button" href="#placement">Placement</a>
   <a className="button" href="#accordion">Accordion</a>
+  <a className="button" href="#note">Note</a>
   <a className="button" href="#minimal-table">Minimal table</a>
   <a className="button" href="#audio">Audio</a>
-  <a className="button" href="#embeds">Embeds</a>
+  <a className="button" href="#htmlembeds">HtmlEmbeds</a>
 </div>
 
 ### Math
@@ -283,6 +285,37 @@ greet("Astro");
 ````
 
 
+### Note
+
+Small contextual callout for tips, caveats, or emphasis.
+
+Props (optional)
+- `title`: short title displayed in the header.
+- `emoji`: emoji displayed before the title.
+- `class`: extra classes for custom styling.
+
+<Note title="Heads‑up" emoji="💡">
+  Use notes to surface context without breaking reading flow.
+</Note>
+
+<Note>
+  Plain note without header. Useful for short clarifications.
+</Note>
+
+<small className="muted">Example</small>
+```mdx
+import Note from '../../components/Note.astro'
+
+<Note title="Heads‑up" emoji="💡">
+  Use notes to surface context without breaking reading flow.
+</Note>
+
+<Note>
+  Plain note without header. Useful for short clarifications.
+</Note>
+```
+
+
 ### Minimal table
 
 | Method | Score |

app/src/content/chapters/getting-started.mdx

@@ -1,4 +1,5 @@
 import Sidenote from '../../components/Sidenote.astro';
+import Note from '../../components/Note.astro';
 
 ## Getting Started
 
@@ -35,14 +36,15 @@ npm run build
 
 ### Deploy
 
-The recommended way is to **duplicate this Space on Hugging Face** rather than cloning it directly:
+The recommended way is to **duplicate this Space** on **Hugging Face** rather than cloning it directly:
 
-1. Open the template Space: **[🤗 science-blog-template](https://huggingface.co/spaces/tfrere/science-blog-template)** and click "Duplicate this Space".
-2. Give it a name, choose visibility, and keep the SDK as **Docker** (this project includes a `Dockerfile`).
-3. Then push your changes to your new Space repo. **Every push automatically triggers a build and deploy** on Spaces.
+1. Open the template Space: **[🤗 science-blog-template](https://huggingface.co/spaces/tfrere/science-blog-template)** and click **"Duplicate this Space"**.
+<Note>💡 It runs on a **free** CPU basic instance.</Note>
+2. Give it a name, choose visibility, and **keep the SDK as Docker**.
+3. Then push your changes to your new Space repo.<br/>**Every push automatically triggers a build and deploy** on Spaces.
 
 ```bash
-git clone git@hf.co:spaces/<your-username>/<your-space>.git
+git clone git@hf.co:spaces/<your-username>/<your-space>
 cd <your-space>
 # Make edits locally, then:
 git add .

app/src/content/chapters/writing-your-content.mdx

@@ -28,7 +28,7 @@ title: "This is the main title"
 subtitle: "This will be displayed just below the banner"
 description: "A modern, MDX-first research article template with math, citations, and interactive figures."
 authors:
-  - "John Doe"
+  - "Thibaud Frere"
   - "Alice Martin"
   - "Robert Brown"
 affiliation: "Hugging Face"