diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
index ab001e2..a02193c 100644
--- a/.devcontainer/devcontainer.json
+++ b/.devcontainer/devcontainer.json
@@ -1,12 +1,8 @@
{
- "image": "mcr.microsoft.com/devcontainers/go:1",
- "features": {
- "ghcr.io/devcontainers/features/hugo:1": {
- "extended": true,
- "version": "0.152.2"
- },
- "ghcr.io/devcontainers/features/node:1": {}
- },
+ "name": "HugoBlox Codespace",
+ "image": "ghcr.io/HugoBlox/hugo-blox-dev:hugo0.152.2",
+ "updateContentCommand": "pnpm install --frozen-lockfile --prefer-offline",
+ "postCreateCommand": "pnpm --version && hugo version",
"customizations": {
"vscode": {
"extensions": [
@@ -14,9 +10,16 @@
]
}
},
- "postCreateCommand": "pnpm install --no-frozen-lockfile && hugo --logLevel debug && pnpm dlx pagefind --source 'public' --verbose",
- "postAttachCommand": "(code --command workbench.view.extension.hugoblox-studio || true) && hugo server --disableFastRender -D --port 1313",
+ "mounts": [
+ "source=pnpm-store,target=/home/vscode/.local/share/pnpm,type=volume"
+ ],
+ "remoteUser": "vscode",
"forwardPorts": [
1313
- ]
-}
\ No newline at end of file
+ ],
+ "portsAttributes": {
+ "1313": {
+ "label": "Hugo Server"
+ }
+ }
+}
diff --git a/README.md b/README.md
index 1e0649c..f12e659 100644
--- a/README.md
+++ b/README.md
@@ -2,71 +2,103 @@
[](https://hugoblox.com/templates/academic-cv/start/?utm_source=github&utm_medium=readme)
-Build an Academic CV and Resumรฉ That Stands Out
+The Portfolio That Works While You Sleep
- Your unfair advantage in academia and tech.
- Showcase your work, boost your citations, and land your dream job at places like Meta, Google, and Stanford.
+ Your unfair advantage in academia.
+ Stop sending PDFs into the void. Build a living portfolio that boosts citations and lands offers.
+ Trusted by 250,000+ researchers at MIT, Stanford, and Google.
- ๐ Deploy Your Free CV in 60s
+ ๐ Launch Free (60s)
โข
Live Demo
โข
- โจ Upgrade to Pro
+ Visual Editor
- Trusted by 250,000+ researchers, students, and educators worldwide.
-
-
-
-
- 
-
-
- 
-
+
+
---
-## Your Career Starts Here
+## Why This Template?
-The Academic CV template is designed for impact. Whether you're an AI researcher, a recent graduate, or a seasoned professor, this is the last resumรฉ you'll ever need.
+Most CVs are static PDFs that get lost in the pile. This is an **intelligent portfolio** that works 24/7 to advance your career.
-- **โ๏ธ Showcase Your Expertise:** Easily write content with Markdown, Jupyter, or RStudio. Display your publications, talks, and projects in a stunning, professional layout.
-- **๐ Boost Your Citations:** Automatic BibTeX import and SEO-optimized pages mean your work gets discovered more easily, increasing your research impact.
-- **๐ผ Land Your Dream Job:** Create a memorable online presence that impresses recruiters from top tech firms and prestigious universities.
-- **๐ Launch in Minutes:** No coding required. The Hugo Blox Builder lets you customize everything with drag-and-drop sections.
+- **๐ฎ Future-Proof:** Your content lives in simple **Markdown**. No database to break, no lock-in.
+- **๐ค AI-Ready:** Optimized for search engines and LLMs, so your work is found and cited.
+- **โก Zero Maintenance:** Auto-import citations from BibTeX and focus on research.
+- **โ๏ธ Edit Visually:** Use **HugoBlox Studio** in VS Code โ no coding needed. Full capabilities in Pro.
- 
+
+
+*HugoBlox Studio: Drag-and-drop page builder inside VS Code.*
+
+> "My citations went up 3x after switching to this template. The citation auto-sync feature is a lifesaver."
+> โ **Dr. Zhang**, AI Research Scientist, Meta
+
---
-## Level Up with Pro Templates
+## Who This Is For
-Ready to take your career to the next level? Our Pro templates offer exclusive designs and features to help you stand out even more.
+- Students and grads applying to top labs and industry roles
+- Researchers who want a living, citable portfolio
+- Faculty/PIs showcasing publications, talks, and group news
-
+---
-| Feature | Academic CV (Free) | Academic CV Pro & Resumรฉ Pro |
-| -------------------- | ------------------------ | -------------------------------- |
-| **Design** | Professional & clean | **Exclusive premium designs** |
-| **Layouts** | Standard resumรฉ sections | **Advanced layouts & timelines** |
-| **Call to Action** | Simple contact link | **Prominent CTA buttons** |
-| **First Impression** | Strong | **Unforgettable** |
+## Features
+
+| Feature | Benefit |
+| :--- | :--- |
+| **Markdown, Jupyter, RStudio** | Write in the tools you already use. |
+| **Auto-Update Citations** | Drop in a BibTeX file; formatted lists generated automatically. |
+| **Visual Editor** | Drag-and-drop blocks to build pages in minutes. |
+| **Global CDN** | Blazing fast load times (100/100 Lighthouse scores). |
+| **Privacy First** | You own your data. Host for free on GitHub Pages. |
+
+---
+
+## Notebook โ Posts and Slides
+
+- Publish your actual `.ipynb` as beautiful long-form posts โ code, outputs, and narrative kept intact.
+- Slides in Markdown with Reveal.js: math, syntax highlight, diagrams, speaker notes.
+- Coming soon: **Notebook โ Slides (beta)**. Request early access in Discord.
+
+Learn more: docs on [Notebooks](https://docs.hugoblox.com/reference/markdown/#-notebooks) and [Slides](https://docs.hugoblox.com/guides/slides/).
+
+---
+
+## Why Go Pro (from $8/m)
+
+- Enhanced HugoBlox Studio visual editor โ save 10โ20 hours setting up and polishing
+- Premium CV & Resumรฉ designs โ make an unforgettable first impression
+- Pro blocks, remove attribution, and priority support
+
+---
+
+## Free vs Pro
+
+| Feature | Academic CV (Free) | Academic CV Pro & Resumรฉ Pro |
+| --- | --- | --- |
+| Design | Professional & clean | Premium designs |
+| Layouts | Standard sections | Advanced timelines & layouts |
+| Courses/Lectures | Basic | Fully-Featured |
+| First Impression | Strong | Unforgettable |
+| Discord Support | Community | Priority |
-
- ๐ Get the Pro Pass โ Includes all Pro templates for a one-time price.
+ ๐ Upgrade to Pro
โจ Deploy Academic CV Pro
โข
๐ Deploy Resumรฉ Pro
@@ -74,52 +106,46 @@ Ready to take your career to the next level? Our Pro templates offer exclusive d
---
-## What Researchers Say
+## Get Started
-> โHugo Blox saved me 40+ hours on my lab site. BibTeX integration auto-updates publications โ **our citations are up 3ร**.โ
-> โ **Dr. Sarah Yang**, AI Researcher
+### Option 1: No-Code (Fastest)
+Launch a fully hosted site in your browser. No software to install.
----
+๐ [**Launch in Browser (Free)**](https://hugoblox.com/templates/academic-cv/start?utm_source=github&utm_medium=readme)
-## Get Started in Minutes
+### Option 2: Studio (Visual Editor)
+1) Install [HugoBlox Studio](https://marketplace.visualstudio.com/items?itemName=hugoblox.hugoblox-studio) for VS Code
+2) Open this project and edit visually
-### Recommended (Fastest)
-
-Deploy your site to GitHub Pages in just 60 seconds with our browser-based starter.
-
-๐ Start with the Academic CV Template
-
-### Prefer the Command Line?
-
-Use the local quickstart:
+### Option 3: CLI (Developers)
+1) Install [Hugo](https://docs.hugoblox.com/start/cli/)
+2) Create your site with the CLI:
```bash
-# 1. Install Hugo Extended โ https://docs.hugoblox.com/getting-started/install-hugo/
-# 2. Clone this starter
-git clone https://github.com/HugoBlox/theme-academic-cv my-site
-cd my-site
-
-# 3. Run locally
-pnpm install && hugo server
+npx hugoblox create site --template academic-cv
```
-For more guides, visit our documentation at **https://docs.hugoblox.com/**.
-
---
-## Join the Community
+## FAQ
-Join thousands of creators in our vibrant community to ask questions, share your work, and help us improve.
+- Do I need to know Hugo? No โ you can edit visually or write Markdown.
+- Can I host for free? Yes โ GitHub Pages/Netlify are supported.
+- Can I export/migrate later? Yes โ your site is just files.
+- Can I cancel Pro anytime? Yes.
-- ๐ฌ Discord
-- ๐ Docs & Guides
-- ๐ฆ X / Twitter
-- โญ Star on GitHub
+---
+
+## Community & Support
+
+- ๐ฌ [**Discord Community**](https://discord.gg/z8wNYzb)
+- ๐ [**Documentation**](https://docs.hugoblox.com/?utm_source=github&utm_medium=readme)
+- ๐ฆ [**Follow on X**](https://x.com/BuildLore)
+- โญ [**Star on GitHub**](https://github.com/HugoBlox/hugo-blox-builder)
---
MIT ยฉ 2016-Present [George Cushen](https://georgecushen.com)
-
diff --git a/config/_default/module.yaml b/config/_default/module.yaml
index 8124ccf..a2c0449 100644
--- a/config/_default/module.yaml
+++ b/config/_default/module.yaml
@@ -7,6 +7,7 @@
imports:
- path: github.com/HugoBlox/hugo-blox-builder/modules/blox-plugin-netlify
- path: github.com/HugoBlox/hugo-blox-builder/modules/blox-tailwind
+ - path: github.com/HugoBlox/hugo-blox-builder/modules/blox-plugin-reveal
# Install any Hugo Blox within the `hugo-blox/blox/` folder
mounts:
diff --git a/config/_default/params.yaml b/config/_default/params.yaml
index fa396c7..1e1bdff 100644
--- a/config/_default/params.yaml
+++ b/config/_default/params.yaml
@@ -185,7 +185,7 @@ hugoblox:
# โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
comments:
enable: false
- provider: "" # giscus | disqus | commento
+ provider: "" # giscus | disqus
giscus:
repo: ""
repo_id: ""
@@ -193,8 +193,6 @@ hugoblox:
category_id: ""
disqus:
shortname: ""
- commento:
- url: ""
# โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
# ANALYTICS
diff --git a/content/_index.md b/content/_index.md
index cf4c56f..5d70dc6 100644
--- a/content/_index.md
+++ b/content/_index.md
@@ -30,7 +30,7 @@ sections:
# Name heading sizing to accommodate long or short names
name:
- size: balanced # Options: compact (long names), balanced (default), display (short names)
+ size: md # Options: xs, sm, md, lg (default), xl
# Avatar customization
avatar:
diff --git a/content/events/example/index.md b/content/events/example/index.md
index ec335bd..9b51d71 100644
--- 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
+
+```
+
+**Fragment Animations:**
+```markdown
+{{}}Appear on click!{{}}
+```
+
+**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
+
+
Left content
+
Right content
+
+
+
+
+### Left Column
+
+- Point A
+- Point B
+- Point C
+
+
+
+
+
+### Right Column
+
+- Detail 1
+- Detail 2
+- Detail 3
+
+
+
+
+
+
+
+### Main Content (2/3 width)
+
+This column takes up twice the space of the right column.
+
+```python
+def example():
+ return "code works too"
+```
+
+
+
+
+
+### Sidebar (1/3 width)
+
+> **Note**
+> Key points in smaller column
+
+
+
+
+
+
+
+
+
+
+
+
+
+### Results
+
+- 95% accuracy
+- 10x faster inference
+- Lower memory usage
+
+{{< fragment >}}**Breakthrough!**{{< /fragment >}}
+
+
+
+