thibaud frere commited on
Commit
e904bd4
·
1 Parent(s): 9e27095
app/src/components/Accordion.astro CHANGED
@@ -134,6 +134,12 @@ const wrapperClass = ["accordion", className].filter(Boolean).join(" ");
134
  padding: 12px 4px 4px;
135
  }
136
 
 
 
 
 
 
 
137
  /* Separator between header and content when open (edge-to-edge) */
138
  .accordion[open] .accordion__content-wrapper::before {
139
  content: "";
 
134
  padding: 12px 4px 4px;
135
  }
136
 
137
+ /* Ensure the very last slotted element has no bottom spacing */
138
+ .accordion .accordion__content > :global(*:last-child) {
139
+ padding-bottom: 0 !important;
140
+ margin-bottom: 0 !important;
141
+ }
142
+
143
  /* Separator between header and content when open (edge-to-edge) */
144
  .accordion[open] .accordion__content-wrapper::before {
145
  content: "";
app/src/content/chapters/available-blocks.mdx CHANGED
@@ -158,58 +158,19 @@ Here are a few variations using the same bibliography:
158
  [^f1]: Footnote attached to the sentence above.
159
  ```
160
 
 
161
 
162
- ### Placement
163
 
164
- #### Asides
165
-
166
- <Aside>
167
- This paragraph presents a **key idea** concisely.
168
- <Fragment slot="aside">
169
- **Side note** for brief context or a definition.
170
- </Fragment>
171
- </Aside>
172
 
173
  <small className="muted">Example</small>
174
  ```mdx
175
- import Aside from '../components/Aside.astro'
176
-
177
- <Aside>
178
- Main paragraph with the core idea.
179
- <Fragment slot="aside">Short side note.</Fragment>
180
- </Aside>
181
- ```
182
-
183
- Use these helpers to expand content beyond the main column when needed. They will always be centered and displayed above every other content.
184
 
185
- #### Wide example
186
-
187
- <Wide>
188
- <div className="demo-wide">demo wide</div>
189
- </Wide>
190
-
191
- <small className="muted">Example</small>
192
- ```mdx
193
- import Wide from '../components/Wide.astro'
194
-
195
- <Wide>
196
- Your content here...
197
- </Wide>
198
- ```
199
-
200
- #### Full-bleed example
201
-
202
- <FullBleed>
203
- <div className="demo-full-bleed">demo full-bleed</div>
204
- </FullBleed>
205
-
206
- <small className="muted">Example</small>
207
- ```mdx
208
- import FullBleed from '../components/FullBleed.astro'
209
 
210
- <FullBleed>
211
- Your content here...
212
- </FullBleed>
213
  ```
214
 
215
 
@@ -359,7 +320,7 @@ You can embed external content in your article using **iframes**. For example, *
359
  <iframe src="https://trackio-documentation.hf.space/?project=fake-training-750735&metrics=train_loss,train_accuracy&sidebar=hidden&lang=en" width="100%" height="600" frameborder="0"></iframe>
360
  ```
361
 
362
- #### gradio
363
 
364
  You can also embed **gradio** apps.
365
 
 
158
  [^f1]: Footnote attached to the sentence above.
159
  ```
160
 
161
+ ### Separator
162
 
163
+ Use `---` on its own line to insert a horizontal separator between sections. This is a standard Markdown “thematic break”. Don’t confuse it with the `---` used at the very top of the file to delimit the frontmatter.
164
 
165
+ ---
 
 
 
 
 
 
 
166
 
167
  <small className="muted">Example</small>
168
  ```mdx
169
+ Intro paragraph.
 
 
 
 
 
 
 
 
170
 
171
+ ---
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
172
 
173
+ Next section begins here.
 
 
174
  ```
175
 
176
 
 
320
  <iframe src="https://trackio-documentation.hf.space/?project=fake-training-750735&metrics=train_loss,train_accuracy&sidebar=hidden&lang=en" width="100%" height="600" frameborder="0"></iframe>
321
  ```
322
 
323
+ #### Gradio
324
 
325
  You can also embed **gradio** apps.
326
 
app/src/content/chapters/getting-started.mdx CHANGED
@@ -35,8 +35,25 @@ A [slug-title].pdf and thumb.jpg are also generated at build time. You can find
35
 
36
  ### Deploy
37
 
38
- The recommended way is to **clone this [🤗 Hugging Face Space](https://huggingface.co/spaces/tfrere/science-blog-template)**.
39
 
40
- Once you have cloned the Space, **just push your changes** to your repository.
 
 
41
 
42
- **Every push automatically triggers a build and deploy** — no extra configuration needed.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
35
 
36
  ### Deploy
37
 
38
+ The recommended way is to **duplicate this Space on Hugging Face** rather than cloning it directly:
39
 
40
+ 1. Open the template Space: **[🤗 science-blog-template](https://huggingface.co/spaces/tfrere/science-blog-template)** and click "Duplicate this Space".
41
+ 2. Give it a name, choose visibility, and keep the SDK as **Docker** (this project includes a `Dockerfile`).
42
+ 3. A new Space repository will be created under your account.
43
 
44
+ Then push your changes to your new Space repo:
45
+
46
+ ```bash
47
+ git clone https://huggingface.co/spaces/<your-username>/<your-space>
48
+ cd <your-space>
49
+ # Make edits locally, then:
50
+ git add .
51
+ git commit -m "Update content"
52
+ git push
53
+ ```
54
+
55
+ **Every push automatically triggers a build and deploy** on Spaces.
56
+
57
+ Notes for Docker Spaces:
58
+ - This project exposes port `8080` via Nginx; the Space front matter includes `app_port: 8080` so the service can be probed correctly.
59
+ - No extra configuration is required; the `Dockerfile` builds the Astro site and serves it.
app/src/content/chapters/writing-your-content.mdx CHANGED
@@ -72,17 +72,6 @@ Below is an image imported via Astro and optimized at build time:
72
  ```
73
 
74
 
75
- Use `---` on its own line to insert a horizontal separator between sections. This is a standard Markdown “thematic break”. Don’t confuse it with the `---` used at the very top of the file to delimit the frontmatter.
76
-
77
- <small className="muted">Example</small>
78
- ```mdx
79
- Intro paragraph.
80
-
81
- ---
82
-
83
- Next section begins here.
84
- ```
85
-
86
 
87
  ### Chapters
88
 
@@ -131,3 +120,59 @@ Use the **color picker** below to see how the primary color affects the theme.
131
  Here is a suggestion of **color palettes** for your **data visualizations** that align with your **brand identity**. These palettes are generated from your `--primary-color`.
132
 
133
  <HtmlFragment src="palettes.html" />
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
72
  ```
73
 
74
 
 
 
 
 
 
 
 
 
 
 
 
75
 
76
  ### Chapters
77
 
 
120
  Here is a suggestion of **color palettes** for your **data visualizations** that align with your **brand identity**. These palettes are generated from your `--primary-color`.
121
 
122
  <HtmlFragment src="palettes.html" />
123
+
124
+
125
+ ### Placement
126
+
127
+ Use these helpers when you need to step outside the main content flow: **Asides** for contextual side notes, **Wide** to extend beyond the main column, and **Full-bleed** for full-width, immersive sections.
128
+
129
+ #### Asides
130
+
131
+ <Aside>
132
+ This paragraph presents a **key idea** concisely.
133
+ <Fragment slot="aside">
134
+ **Side note** for brief context or a definition.
135
+ </Fragment>
136
+ </Aside>
137
+
138
+ <small className="muted">Example</small>
139
+ ```mdx
140
+ import Aside from '../components/Aside.astro'
141
+
142
+ <Aside>
143
+ Main paragraph with the core idea.
144
+ <Fragment slot="aside">Short side note.</Fragment>
145
+ </Aside>
146
+ ```
147
+
148
+ Use these helpers to expand content beyond the main column when needed. They will always be centered and displayed above every other content.
149
+
150
+ #### Wide example
151
+
152
+ <Wide>
153
+ <div className="demo-wide">demo wide</div>
154
+ </Wide>
155
+
156
+ <small className="muted">Example</small>
157
+ ```mdx
158
+ import Wide from '../components/Wide.astro'
159
+
160
+ <Wide>
161
+ Your content here...
162
+ </Wide>
163
+ ```
164
+
165
+ #### Full-bleed example
166
+
167
+ <FullBleed>
168
+ <div className="demo-full-bleed">demo full-bleed</div>
169
+ </FullBleed>
170
+
171
+ <small className="muted">Example</small>
172
+ ```mdx
173
+ import FullBleed from '../components/FullBleed.astro'
174
+
175
+ <FullBleed>
176
+ Your content here...
177
+ </FullBleed>
178
+ ```