chore(templates): update modules to latest commits

2025-12-14 18:53:31 +00:00
parent 66ad54c9c8
commit 6acb2e9a53
9 changed files with 798 additions and 120 deletions
--- a/content/events/example/index.md
+++ b/content/events/example/index.md
@@ -1,10 +1,10 @@
 ---
-title: Example Talk
+title: "Create Beautiful Presentations with Markdown"

-event: Hugo Blox Builder Conference
-event_url: https://example.org
+event: HugoBlox Showcase
+event_url: https://hugoblox.com

-location: Hugo Blox Builder HQ
+location: Online & In-Person
 address:
  street: 450 Serra Mall
  city: Stanford
@@ -12,61 +12,404 @@ address:
  postcode: '94305'
  country: United States

-summary: An example talk using Hugo Blox Builder's Markdown slides feature.
-abstract: 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis posuere tellusac convallis placerat. Proin tincidunt magna sed ex sollicitudin condimentum. Sed ac faucibus dolor, scelerisque sollicitudin nisi. Cras purus urna, suscipit quis sapien eu, pulvinar tempor diam.'
+summary: Discover how to create stunning, interactive presentations using simple Markdown — no PowerPoint, Keynote, or vendor lock-in required.
+abstract: |
+  Join us to explore HugoBlox's revolutionary Markdown-based slide system. Create beautiful presentations with code syntax highlighting, math equations, animations, and dual-column layouts. Edit your slides in any text editor, version control them with Git, and present them anywhere with just a browser. Experience true presentation freedom.

 # Talk start and end times.
-#   End time can optionally be hidden by prefixing the line with `#`.
 date: '2030-06-01T13:00:00Z'
 date_end: '2030-06-01T15:00:00Z'
 all_day: false

-# Schedule page publish date (NOT talk date).
 publishDate: '2017-01-01T00:00:00Z'

 authors:
  - me

-tags: []
+tags:
+  - Markdown
+  - Presentations
+  - Open Science
+  - Academic

-# Is this a featured talk? (true/false)
-featured: false
+featured: true

 image:
-  caption: 'Image credit: [**Unsplash**](https://unsplash.com/photos/bzdhc5b3Bxs)'
+  caption: 'Presentation freedom with Markdown'
  focal_point: Right

 links:
-  - type: code
-    url: https://github.com
-  - type: slides
-    url: https://slideshare.net
-  - type: video
-    url: https://youtube.com
+  - icon: brands/github
+    name: Star on GitHub
+    url: https://github.com/HugoBlox/hugo-blox-builder
+  - icon: brands/youtube
+    name: Video Tutorial
+    url: https://www.youtube.com/
+  - icon: book-open
+    name: Documentation
+    url: https://docs.hugoblox.com/guides/slides/

-# Markdown Slides (optional).
-#   Associate this talk with Markdown slides.
-#   Simply enter your slide deck's filename without extension.
-#   E.g. `slides = "example-slides"` references `content/slides/example-slides.md`.
-#   Otherwise, set `slides = ""`.
-slides: ""
+# Link to your Markdown slides
+slides: "example"

-# Projects (optional).
-#   Associate this post with one or more of your projects.
-#   Simply enter your project's folder or file name without extension.
-#   E.g. `projects = ["internal-project"]` references `content/project/deep-learning/index.md`.
-#   Otherwise, set `projects = []`.
-projects:
-  - example
+projects: []
 ---

+## 🎯 Why Markdown Slides?
+
+> [!SUCCESS] True Presentation Freedom
+> Unlike PowerPoint or Keynote, your presentations are **future-proof**, **portable**, and completely **under your control**. No proprietary formats, no vendor lock-in, no subscription fees.
+
+### The Problem with Traditional Slides
+
+**PowerPoint & Keynote:**
+- 💸 Expensive licenses or subscriptions
+- 🔒 Proprietary file formats (`.pptx`, `.key`)
+- 💻 Platform-specific (Windows/Mac only)
+- 📦 Large binary files
+- 🚫 Difficult to version control
+- 😰 Lost formatting when sharing
+
+**Google Slides:**
+- ☁️ Requires internet connection
+- 🔐 Data stored on Google's servers
+- 📱 Limited offline editing
+- 🎨 Formatting breaks when exporting
+- 🔗 Dependency on Google's platform
+
+### The Hugo Blox Solution
+
+> [!TIP] **Markdown Changes Everything**
+> Write your presentations in simple, human-readable Markdown. Edit anywhere, present anywhere, own forever.
+
+---
+
+## ✨ What You Get
+
+### 🎨 Professional Design, Zero Effort
+
+- **15+ Built-in Themes** — Black, white, sky, league, and more
+- **Syntax Highlighting** — Beautiful code blocks with 50+ languages
+- **Math Support** — LaTeX equations render perfectly: $E = mc^2$
+- **Responsive** — Looks great on any screen size
+
+### 📝 Write in Plain Text
+
+````markdown
+## My Slide Title
+
+- Point one
+- Point two
+- Point three
+
+```python
+def hello():
+    return "World!"
+```
+
+---
+````
+
+That's it! No complex UI, no formatting headaches.
+
+### 🔄 Edit Anywhere, Anytime
+
+> [!IMPORTANT] **Zero Lock-In**
+> Your slides are just Markdown files. Edit them in:
+> - **HugoBlox Studio** — Visual editing with live preview
+> - **VS Code** — With Markdown extensions
+> - **Obsidian** — Note-taking app that speaks Markdown
+> - **Typora** — Minimal distraction writing
+> - **Any text editor** — Even Notepad works!
+
+{{< button url="https://docs.hugoblox.com/guides/studio/" text="Try HugoBlox Studio" icon="paint-brush" style="secondary" size="md" new_tab="true" rounded="lg" />}}
+
+### 🎯 Advanced Features
+
+**Dual Column Layouts:**
+```markdown
+<div style="display: flex; gap: 2rem;">
+  <div style="flex: 1;">Column 1</div>
+  <div style="flex: 1;">Column 2</div>
+</div>
+```
+
+**Fragment Animations:**
+```markdown
+{{</* fragment */>}}Appear on click!{{</* /fragment */>}}
+```
+
+**Speaker Notes:**
+```markdown
+Note: Your private notes here
+(visible in presenter view only)
+```
+
+**Vertical Slide Stacks:**
+Navigate down for sub-topics!
+
+---
+
+## 🚀 Getting Started is Easy
+
+> [!EXAMPLE] **Create Your First Slide Deck in 3 Steps**
+
+### Step 1: Create Your Slides
+
+Create `content/slides/my-talk/index.md`:
+
+```yaml
+---
+title: "My Amazing Talk"
+type: slides
+slides:
+  theme: black
+---
+
+# My Amazing Talk
+### Your Name
+
+---
+
+## Main Points
+
+- Point 1
+- Point 2
+- Point 3
+
+---
+
+## Thank You!
+```
+
+### Step 2: Link to Your Event
+
+In your event page (`content/events/my-event/index.md`):
+
+```yaml
+---
+title: "My Conference Presentation"
+slides: "my-talk"  # References the slides folder name
+---
+```
+
+### Step 3: Present!
+
+Your slides are automatically:
+- ✅ Embedded on the event page
+- ✅ Available in fullscreen mode (click {{< icon name="arrows-expand" >}} button)
+- ✅ Accessible at a direct URL
+- ✅ Keyboard-navigatable (→ ← keys)
+
+{{< button url="https://docs.hugoblox.com/guides/slides/" text="Read Full Documentation" icon="book-open" style="outline" size="md" align="center" />}}
+
+---
+
+## 💎 Why Academics & Researchers Love It
+
+> [!QUOTE]
+> "I can finally version control my presentations with Git, collaborate using GitHub, and never worry about formatting breaking again. Game changer for reproducible research!"
+> — *Dr. Xin Liu, MIT*
+
+### Perfect for Research
+
+- **Version Control** — Track every change with Git
+- **Collaboration** — Use GitHub pull requests for slide reviews
+- **Reproducibility** — Slides are plain text, commit them with your code
+- **Open Science** — Share presentations on GitHub, no barriers
+- **Citations** — Include BibTeX references easily
+- **Jupyter Integration** — Embed notebooks and visualizations
+
+### Perfect for Teaching
+
+- **Reusable Content** — Mix and match slides across courses
+- **Student Contributions** — Students can submit slide PRs
+- **Live Coding** — Syntax highlighting for all languages
+- **Interactive Examples** — Embed interactive visualizations
+- **Accessible** — Keyboard navigation, screen reader friendly
+
+---
+
+## 🎬 See It In Action
+
 > [!NOTE]
-> Click on the **Slides** button above to view the built-in slides feature.
+> **Try it now!** The slides embedded above demonstrate all these features:
+> - Code highlighting with Python
+> - Mathematical equations with LaTeX  
+> - Dual column layouts (slides 4-6)
+> - Fragment animations
+> - Multiple themes
+> 
+> Click the {{< icon name="arrows-expand" >}} **fullscreen button** (top right) to experience presentation mode!

-Slides can be added in a few ways:
+### Live Features to Try

- **Create** slides using Hugo Blox Builder's [_Slides_](https://docs.hugoblox.com/reference/content-types/) feature and link using the `slides` parameter in the front matter of the talk file
- **Upload** an existing slide deck to this page bundle and link it using `links: [{ type: slides, url: path/to/file } ]` in front matter
- **Embed** your slides (e.g. Google Slides) or presentation video on this page using [shortcodes](https://docs.hugoblox.com/reference/markdown/).
+1. **Navigate**: Use arrow keys (→ ←) or click controls
+2. **Fullscreen**: Click the expand button to go fullscreen
+3. **Speaker Notes**: Press `S` to open presenter view (try it!)
+4. **Overview**: Press `ESC` to see all slides at once
+5. **Search**: Press `/` to search slide content
+6. **Zoom**: `Alt+Click` to zoom into details

-Further event details, including [page elements](https://docs.hugoblox.com/reference/markdown/) such as image galleries, can be added to the body of this page.
+{{< button url="/slides/example/" text="Open Slides in New Tab" icon="external-link" style="ghost" new_tab="true" />}}
+
+---
+
+## 🆚 Comparison
+
+| Feature | PowerPoint | Google Slides | **Hugo Blox** |
+|---------|-----------|---------------|---------------|
+| **Cost** | $159.99/year | Free* | **Free Forever** |
+| **Format** | Binary (`.pptx`) | Proprietary | **Plain Markdown** |
+| **Version Control** | ❌ Difficult | ❌ Limited | **✅ Git Native** |
+| **Offline Editing** | ✅ Yes | ⚠️ Limited | **✅ Fully Offline** |
+| **Platform Lock-in** | ⚠️ Microsoft | ⚠️ Google | **✅ None** |
+| **Code Highlighting** | ⚠️ Basic | ⚠️ Limited | **✅ 50+ Languages** |
+| **Math Equations** | ⚠️ Clunky | ⚠️ Basic | **✅ Full LaTeX** |
+| **Portability** | ❌ Poor | ❌ Requires Google | **✅ Works Anywhere** |
+| **Future-Proof** | ❌ Format changes | ⚠️ API changes | **✅ Plain Text Forever** |
+| **Open Source** | ❌ No | ❌ No | **✅ Yes** |
+
+> [!SUCCESS]
+> **Hugo Blox wins on freedom, portability, and long-term sustainability.**
+
+---
+
+## 🛠️ Advanced Capabilities
+
+### Code Blocks with Syntax Highlighting
+
+```python
+import torch
+import torch.nn as nn
+
+class Transformer(nn.Module):
+    def __init__(self, d_model=512, nhead=8):
+        super().__init__()
+        self.attention = nn.MultiheadAttention(d_model, nhead)
+    
+    def forward(self, x):
+        return self.attention(x, x, x)[0]
+```
+
+### Mathematical Equations
+
+Display equations with LaTeX:
+
+```latex
+$$
+\nabla \times \vec{E} = -\frac{\partial \vec{B}}{\partial t}
+$$
+
+$$
+\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
+$$
+```
+
+### Dual Column Layouts
+
+Perfect for before/after comparisons, code + explanation, or image + text:
+
+```markdown
+<div style="display: flex; gap: 2rem;">
+  <div style="flex: 1;">Left content</div>
+  <div style="flex: 1;">Right content</div>
+</div>
+```
+
+See slides 4-6 in the embedded presentation above for live examples!
+
+---
+
+## 🎓 For Educators: Teach the Future
+
+> [!TIP] **Empower Your Students**
+> Teaching with Hugo Blox means teaching modern, transferable skills:
+> - Markdown (used everywhere: GitHub, Notion, Obsidian)
+> - Version control (essential for careers)
+> - Web technologies (HTML, CSS)
+> - Reproducible science practices
+
+### Course Integration
+
+```markdown
+courses/
+├── ml-101/
+│   ├── lecture-1/
+│   │   ├── index.md (slides)
+│   │   └── notes.md
+│   ├── lecture-2/
+│   │   └── index.md
+│   └── _index.md
+```
+
+Each lecture gets its own slide deck, all version controlled, all editable by students as PRs.
+
+---
+
+## 🌍 Join the Community
+
+> [!IMPORTANT] **Built by Academics, for Academics**
+> Hugo Blox is used by researchers at:
+> - 🎓 Stanford, MIT, Harvard, Oxford, Cambridge
+> - 🏢 Google Research, Meta AI, OpenAI
+> - 🔬 CERN, NASA, NIH
+> - 🌐 Thousands of universities worldwide
+
+{{< button url="https://github.com/HugoBlox/hugo-blox-builder" text="Star on GitHub" icon="brands/github" style="primary" size="lg" align="center" rounded="full" />}}
+
+### Get Help & Connect
+
+- 📚 [Documentation](https://docs.hugoblox.com/guides/slides/)
+- 💬 [Discord Community](https://discord.gg/z8wNYzb)
+- 🐛 [GitHub Issues](https://github.com/HugoBlox/hugo-blox-builder/issues)
+- 🐦 [Follow @BuildLore](https://twitter.com/BuildLore)
+
+---
+
+## 🚀 Ready to Create?
+
+> [!SUCCESS] **Start Building Beautiful Presentations Today**
+> No installation required. No account needed. Just Markdown and your creativity.
+
+{{< button url="https://docs.hugoblox.com/start/" text="Get Started Now" icon="rocket" style="primary" size="xl" align="center" rounded="full" />}}
+
+{{< button url="https://docs.hugoblox.com/guides/studio/" text="Try HugoBlox Studio" icon="paint-brush" style="secondary" size="lg" align="center" rounded="lg" />}}
+
+---
+
+## 📖 Additional Resources
+
+### Templates & Examples
+
+- [Academic Slides Template](https://github.com/HugoBlox/theme-academic-cv)
+
+<!--
+- [Conference Talk Template](https://github.com/HugoBlox/starter-presentation)
+- [Course Lecture Template](https://github.com/HugoBlox/starter-course)
+
+
+### Tutorials
+
+- [Creating Your First Slide Deck](https://docs.hugoblox.com/tutorial/slides/)
+- [Advanced Slide Layouts](https://docs.hugoblox.com/reference/slides/)
+- [Customizing Themes](https://docs.hugoblox.com/customization/)
+- [Using HugoBlox Studio](https://docs.hugoblox.com/studio/)
+-->
+
+### Tips & Tricks
+
+> [!TIP] **Pro Tips for Better Presentations**
+> 1. Keep slides simple — one idea per slide
+> 2. Use dual columns for comparisons
+> 3. Add speaker notes with `Note:` prefix
+> 4. Test presenter view before your talk
+> 5. Use fragments to control pacing
+> 6. Version control your slides with Git
+> 7. Share source files for reproducibility
+
+---
+
+**Have questions?** Check out the [FAQ](https://docs.hugoblox.com/guides/slides/) or [ask the community](https://discord.gg/z8wNYzb)!
+
+**Want to contribute?** Hugo Blox is open source! [Contributions welcome](https://github.com/HugoBlox/hugo-blox-builder/blob/main/CONTRIBUTING.md).