thibaud frere commited on
Commit
6941040
·
1 Parent(s): 9294a56
Files changed (1) hide show
  1. app/src/content/article.mdx +22 -21
app/src/content/article.mdx CHANGED
@@ -28,17 +28,14 @@ import AvailableBlocks from "./chapters/available-blocks.mdx";
28
  import GettingStarted from "./chapters/getting-started.mdx";
29
 
30
  <Sidenote>
31
- Welcome to this single‑page **research article template**. It helps you publish **clear**, **modern**, and **interactive technical writing** with **minimal setup**. Grounded in **web‑native scholarship**, it favors **interactive explanations**, careful notation, and **inspectable examples** over static snapshots.
32
-
33
- It offers a **ready‑to‑publish, all‑in‑one workflow** so you can **focus on ideas** rather than infrastructure.
34
  <Fragment slot="aside">
35
  Reading time: 20–25 minutes.
36
  </Fragment>
37
- Use it as a **practical baseline**: **start simple**, **iterate** on structure and style, and keep content **maintainable** for future readers and collaborators.
38
-
39
  </Sidenote>
40
 
41
-
42
  #### Features
43
 
44
  <Sidenote>
@@ -48,9 +45,9 @@ import GettingStarted from "./chapters/getting-started.mdx";
48
  <span className="tag">Syntax highlighting</span>
49
  <span className="tag">Citations & footnotes</span>
50
  <span className="tag">Automatic build</span>
51
- <span className="tag">Table of content</span>
52
  <span className="tag">Dark theme</span>
53
- <span className="tag">HTML fragments</span>
54
  <span className="tag">Plotly ready</span>
55
  <span className="tag">D3.js ready</span>
56
  <span className="tag">SEO Friendly</span>
@@ -63,30 +60,34 @@ import GettingStarted from "./chapters/getting-started.mdx";
63
  <span className="tag">Embed gradio apps</span>
64
  </div>
65
  <Fragment slot="aside">
66
- If you have questions or remarks open a discussion on the <a href="https://huggingface.co/spaces/tfrere/research-blog-template/discussions?status=open&type=discussion">Community tab</a>!
67
  </Fragment>
68
  </Sidenote>
69
 
70
  ## Introduction
71
- 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.
72
-
73
- 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.
74
 
75
- Not every contribution fits a PDF. Treat demos, visualizations, and interactive writeups 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.
76
 
77
  This project is heavily inspired by [**Distill**](https://distill.pub) (2016–2021), which championed clear, web‑native scholarship.
78
 
79
- {/* ### Notable examples of excellent scientific articles
80
 
 
 
81
  A short, curated list of well‑designed and often interactive work:
82
 
83
- - **Distill The Building Blocks of Interpretability**: [distill.pub/2018/building-blocks](https://distill.pub/2018/building-blocks/)
84
- - **R2D3 — A Visual Introduction to Machine Learning (Part 1)**: [r2d3.us/visual-intro-to-machine-learning-part-1](http://www.r2d3.us/visual-intro-to-machine-learning-part-1/)
85
- - **Seeing Theory An interactive introduction to probability and statistics**: [seeing-theory.brown.edu](https://seeing-theory.brown.edu/)
86
- - **ConvNetJS Neural networks in the browser**: [cs.stanford.edu/people/karpathy/convnetjs](http://cs.stanford.edu/people/karpathy/convnetjs/)
87
- - **Explorable Explanations — Collection**: [explorableexplanations.com](http://explorableexplanations.com/)
88
- - **Distill — Why Momentum Really Works**: [distill.pub/2017/momentum](https://distill.pub/2017/momentum/)
89
- */}
 
 
 
 
90
 
91
  <GettingStarted />
92
 
 
28
  import GettingStarted from "./chapters/getting-started.mdx";
29
 
30
  <Sidenote>
31
+ Welcome to this **single‑page** research article template. It helps you publish **clear**, **modern**, and **interactive** technical writing with **minimal setup**. Grounded in web‑native scholarship, it favors interactive explanations, clear notation, and inspectable examples over static snapshots.
32
+
33
+ It offers a **ready‑to‑publish**, **all‑in‑one** workflow so you can focus on ideas rather than infrastructure.
34
  <Fragment slot="aside">
35
  Reading time: 20–25 minutes.
36
  </Fragment>
 
 
37
  </Sidenote>
38
 
 
39
  #### Features
40
 
41
  <Sidenote>
 
45
  <span className="tag">Syntax highlighting</span>
46
  <span className="tag">Citations & footnotes</span>
47
  <span className="tag">Automatic build</span>
48
+ <span className="tag">Table of contents</span>
49
  <span className="tag">Dark theme</span>
50
+ <span className="tag">HTML Embeds</span>
51
  <span className="tag">Plotly ready</span>
52
  <span className="tag">D3.js ready</span>
53
  <span className="tag">SEO Friendly</span>
 
60
  <span className="tag">Embed gradio apps</span>
61
  </div>
62
  <Fragment slot="aside">
63
+ If you have questions, remarks or suggestions, open a discussion on the <a href="https://huggingface.co/spaces/tfrere/research-blog-template/discussions?status=open&type=discussion">Community tab</a>!
64
  </Fragment>
65
  </Sidenote>
66
 
67
  ## Introduction
68
+ The web enables what static PDFs can’t: **interactive diagrams**, **progressive notation**, and **exploratory views** that reveal how ideas behave. This template makes **interactive artifacts**—figures, math, code and **inspectable experiments**—first‑class alongside prose, so readers **build intuition** rather than skim results.
 
 
69
 
70
+ If you write technical blogs or research notes, you’ll get a **readyto‑publish workflow** with clear notation, optimized media, and **automatic builds**. **Start below and iterate quickly.**
71
 
72
  This project is heavily inspired by [**Distill**](https://distill.pub) (2016–2021), which championed clear, web‑native scholarship.
73
 
74
+ ### Notable examples of excellent scientific articles
75
 
76
+
77
+ <Sidenote>
78
  A short, curated list of well‑designed and often interactive work:
79
 
80
+ - [Growing Neural Cellular Automata](https://distill.pub/2020/growing-ca/)
81
+ - [Activation Atlas](https://distill.pub/2019/activation-atlas/)
82
+ - [Handwriting with a Neural Network](https://distill.pub/2016/handwriting/)
83
+ - [The Building Blocks of Interpretability](https://distill.pub/2018/building-blocks/)
84
+
85
+ <Fragment slot="aside">
86
+ I'm always excited to discover more great examples—please share your favorites in the <a href="https://huggingface.co/spaces/tfrere/research-blog-template/discussions?status=open&type=discussion">Community tab</a>!
87
+ </Fragment>
88
+ </Sidenote>
89
+
90
+
91
 
92
  <GettingStarted />
93