@@ -172,11 +172,11 @@ For all assets, please use the Page Bundling method. It simplifies asset managem
172172
173173### Size Limits for Embedded Media
174174While there' s no hard-coded size limit, we enforce these practical constraints:
175- | Media Type | Recommended Max Size | Impact Beyond Limit |
176- |------------|----------------------|------------------------------- |
177- | Video | 50 MB | Slow builds, CI failures |
178- | Image | 5 MB | Hugo memory overflow. |
179- | PDF | 20 MB | Browser loading delays. |
175+ | Media Type | Recommended Max Size | Impact Beyond Limit |
176+ |------------|----------------------|------------------------------|
177+ | Video | 50 MB | Slow builds, CI failures |
178+ | Image | 5 MB | Hugo memory overflow |
179+ | PDF | 20 MB | Browser loading delays |
180180
181181
182182### How to Add an Image
@@ -194,27 +194,9 @@ The `usestatic` shortcode is **deprecated** and should not be used!
194194{{< /alert >}}
195195
196196### How to Add a Video
197- ` ` ` mermaid
198- graph LR
199- A[Add Video] --> B{Size >50MB?}
200- B -->|Yes| C[External Platform]
201- B -->|No| D[Page Bundling]
202- C --> E[Embed with URL]
203- D --> F[Local Reference]
204- ` ` `
205197
206- #### Best Practices for Video Storage
207- **Recommended Approach (Page Bundling ):**
198+ **Page Bundling (Recommended)**
208199` ` ` markdown
209- // Directory structure
210- content/
211- └── learning-paths/
212- └── org-uuid/
213- └── course-name/
214- ├── chapter.md
215- └── video-demo.mp4 // Same directory as Markdown
216-
217- // In chapter.md
218200<video controls width="100%">
219201 <source src="video-demo.mp4" type="video/mp4">
220202</video>
@@ -237,19 +219,10 @@ For optimal performance, we recommend hosting large videos on dedicated platform
237219- **Cloudflare Stream ** (Paid, enterprise-grade)
238220- **Vimeo** (Paid, professional features)
239221
240- #### Migration Guide
241- ` ` ` mermaid
242- flowchart LR
243- A[Identify Videos] --> B{Current Location}
244- B -->|static/ folder| C[Move to Page Bundle]
245- B -->|External URL| D[Verify accessibility]
246- C --> E[Update references]
247- D --> E
248- E --> F[Test locally]
249- F --> G[Publish via Release]
250- ` ` `
251222
252223#### Critical Considerations
224+ - Best practice: Page Bundling
225+
253226- Accessibility : Always include subtitle tracks (VTT format)
254227
255228- Thumbnails : Set custom posters with ` ` ` poster="image.jpg"` ` `
0 commit comments