diff --git a/modules/blox/layouts/_partials/views/slides-gallery.html b/modules/blox/layouts/_partials/views/slides-gallery.html
new file mode 100644
index 00000000..25dab71f
--- /dev/null
+++ b/modules/blox/layouts/_partials/views/slides-gallery.html
@@ -0,0 +1,203 @@
+{{/* Hugo Blox Slides Gallery View - Optimized for slide deck presentations */}}
+{{/* Features: 16:9 aspect ratio, play button overlay, slide count, tags, featured badge */}}
+
+{{ $item := .item }}
+{{ $link := $item.RelPermalink }}
+{{ $html_format := $item.OutputFormats.Get "HTML" }}
+{{ if not $html_format }}
+ {{ $html_format = $item.OutputFormats.Get "html" }}
+{{ end }}
+{{ with $html_format }}
+ {{ $link = .RelPermalink }}
+{{ end }}
+{{ $present_link := $link }}
+{{ $present_format := $item.OutputFormats.Get "present" }}
+{{ if not $present_format }}
+ {{ $present_format = $item.OutputFormats.Get "Present" }}
+{{ end }}
+{{ with $present_format }}
+ {{ $present_link = .RelPermalink }}
+{{ end }}
+{{ $resource := partial "functions/get_featured_image.html" $item }}
+{{ $index := .index }}
+{{ $featured_label := i18n "featured" | default "Featured" }}
+{{ $details_label := i18n "details" | default "Details" }}
+{{ $present_label := i18n "present_slides" | default "Present" }}
+{{ $present_fullscreen_label := i18n "present_fullscreen" | default "Present (fullscreen)" }}
+{{ $slides_label := i18n "slides" | default "Slides" }}
+
+{{/* Check if featured/pinned */}}
+{{ $isFeatured := or $item.Params.featured $item.Params.pinned }}
+
+{{/* Calculate slide count by counting "---" separators in content */}}
+{{ $content := $item.RawContent }}
+{{ $slideCount := 1 }}
+{{ $separators := findRE "(?m)^---$" $content }}
+{{ if $separators }}
+ {{ $slideCount = add (len $separators) 1 }}
+ {{/* Subtract 1 for front matter separator if content starts with --- */}}
+ {{ if hasPrefix $content "---" }}
+ {{ $slideCount = sub $slideCount 1 }}
+ {{ end }}
+{{ end }}
+
+{{/* Get summary - use description from front matter or truncate content */}}
+{{ $summary := $item.Description | default $item.Summary | default "" }}
+{{ $summary = $summary | plainify | truncate 160 }}
+
+
+ {{/* Featured Badge */}}
+ {{ if $isFeatured }}
+
+
+ {{ $featured_label }}
+
+ {{ else if ne .MediaType.SubType "gif" }}
+ {{ $image := .Fill "800x450 Center" }}
+ {{ $responsive := partial "functions/process_responsive_image.html" (dict
+ "image" $image
+ "mode" "responsive"
+ "sizes" (slice 400 600 800)
+ "formats" (slice "avif" "webp" "jpg")
+ ) }}
+ 
+ {{ else }}
+
+ {{ end }}
+ {{ else }}
+ {{/* Fallback: Decorative gradient with slide icon - smaller, cleaner */}}
+
+ {{ end }}
+
+ {{/* Play button overlay on hover */}}
+
+
+ {{/* Slide count badge */}}
+ {{ if gt $slideCount 1 }}
+
+ {{ $slideCount }} {{ $slides_label | lower }}
+
+ {{ end }}
+
+
+ {{/* Content Section */}}
+
+ {{/* Tags */}}
+ {{ if $item.Params.tags }}
+
+ {{ range first 3 $item.Params.tags }}
+
+ {{ . }}
+
+ {{ end }}
+ {{ if gt (len $item.Params.tags) 3 }}
+ +{{ sub (len $item.Params.tags) 3 }}
+ {{ end }}
+
+ {{ end }}
+
+ {{ $authors := slice }}
+ {{ with $item.Params.authors }}
+ {{ if reflect.IsSlice . }}
+ {{ $authors = . }}
+ {{ else }}
+ {{ $authors = slice . }}
+ {{ end }}
+ {{ end }}
+ {{ if gt (len $authors) 0 }}
+ {{ $author := index $authors 0 }}
+ {{ $profile := partial "functions/get_author_profile" $author }}
+ {{ $avatar := $profile.avatar }}
+ {{ $authorName := $author }}
+ {{ if $profile.has_data }}
+ {{ $authorName = $profile.title }}
+ {{ end }}
+
+
+ {{ if $avatar }}
+ {{ $avatar_48 := $avatar.Process "Fill 48x48 Center webp" }}
+
+ {{ else }}
+
+ {{ partial "functions/get_icon" (dict "name" "hero/user" "attributes" "class=\"w-4 h-4 text-zinc-500 dark:text-zinc-400\"") }}
+
+ {{ end }}
+
+
{{ $authorName }}
+
+ {{ end }}
+
+ {{/* Title */}}
+
+
+ {{/* Summary */}}
+
{{ if $summary }}{{ $summary }}{{ else }} {{ end }}
+
+ {{/* Footer: Venue, Year, Details + Present Links */}}
+
+
+ {{ with $item.Params.venue }}
+ {{ . }}
+ ·
+ {{ end }}
+
+
+
+
+
diff --git a/modules/blox/layouts/events/page.html b/modules/blox/layouts/events/page.html
index 4a5818be..c8984e5f 100644
--- a/modules/blox/layouts/events/page.html
+++ b/modules/blox/layouts/events/page.html
@@ -67,7 +67,6 @@
{{/* Set Alpine.js flag if author notes exist */}}
{{ if isset .Params "author_notes" }}
{{ .Store.Set "has_alpine" true }}
-
{{ end }}
{{ range $i, $slug := .Params.authors }}
@@ -138,117 +137,7 @@
{{/* EMBEDDED SLIDES SECTION - Replaces featured image for events with slides */}}
{{ if .Params.slides }}
- {{/* Enable Alpine.js for fullscreen functionality */}}
- {{ .Store.Set "has_alpine" true }}
-
- {{/* Construct slides URL */}}
- {{ $slides_page := site.GetPage (printf "/slides/%s" .Params.slides) }}
-
- {{ if $slides_page }}
-
- {{/* Slides iframe container - must contain button for fullscreen visibility */}}
-
-
-
- {{/* Fullscreen toggle button - must be inside fullscreen container */}}
-
-
-
- {{/* Slides metadata */}}
-
-
- {{ end }}
+ {{ partial "components/slides-embed.html" (dict "page" . "slides_slug" .Params.slides) }}
{{ else }}
{{/* Fallback to featured image if no slides */}}
{{ $featured := partial "functions/get_featured_image.html" . }}
diff --git a/modules/blox/layouts/list.html b/modules/blox/layouts/list.html
index 6bcacf79..548fb990 100644
--- a/modules/blox/layouts/list.html
+++ b/modules/blox/layouts/list.html
@@ -24,7 +24,6 @@
{{ range .Pages }}
{{ if isset .Params "author_notes" }}
{{ $.Store.Set "has_alpine" true }}
-
{{ break }}
{{ end }}
{{ end }}
diff --git a/modules/blox/layouts/single.html b/modules/blox/layouts/single.html
index fab49d43..8016f4b3 100644
--- a/modules/blox/layouts/single.html
+++ b/modules/blox/layouts/single.html
@@ -76,7 +76,6 @@
{{/* Set Alpine.js flag if author notes exist */}}
{{ if isset .Params "author_notes" }}
{{ .Store.Set "has_alpine" true }}
-
{{ end }}
{{ range $i, $slug := .Params.authors }}
diff --git a/modules/slides/assets/js/hugoblox-slides.js b/modules/slides/assets/js/hugoblox-slides.js
index 168fd92a..2d7444ca 100644
--- a/modules/slides/assets/js/hugoblox-slides.js
+++ b/modules/slides/assets/js/hugoblox-slides.js
@@ -11,6 +11,9 @@
import * as params from "@params";
+// Guard against null/undefined slides params - ensures decks render with sensible defaults
+const slides = params.slides || {};
+
// Enable core slide features.
var enabledPlugins = [RevealMarkdown, RevealSearch, RevealNotes, RevealMath.KaTeX, RevealZoom];
@@ -38,15 +41,17 @@ const keysToCamelCase = (o) => {
// reveal configurations can be included in front matter under slides.reveal
var pluginOptions = {};
-if (typeof params.slides.reveal_options !== "undefined") {
- pluginOptions = params.slides.reveal_options;
+if (typeof slides.reveal_options !== "undefined") {
+ pluginOptions = slides.reveal_options;
}
pluginOptions = keysToCamelCase(pluginOptions);
-//enable menu by default if not set
+// Menu disabled by default (reveal.js-menu@2.1.0 has ESM compatibility issues)
+// Menu plugin no longer maintained as of 2026-01 (last updated 6 years ago).
+// TODO: consider removing this plugin as it's unlikely to work with modern browsers.
if (typeof pluginOptions.menu_enabled === "undefined") {
- pluginOptions.menu_enabled = true;
+ pluginOptions.menu_enabled = false;
}
// configure menu if enabled
@@ -59,18 +64,18 @@ pluginOptions.plugins = enabledPlugins;
Reveal.initialize(pluginOptions);
// Disable Mermaid by default.
-if (typeof params.slides.diagram === "undefined") {
- params.slides.diagram = false;
+if (typeof slides.diagram === "undefined") {
+ slides.diagram = false;
}
// Configure Mermaid only if diagrams are enabled.
-if (params.slides.diagram) {
+if (slides.diagram) {
//mermaid options
// mermaid: front matter configuration can be used to set mermaid options
// You can also use directives (see mermaid documentation)
let mermaidOptions = {};
- if (typeof params.slides.diagram_options !== "undefined") {
- mermaidOptions = params.slides.diagram_options;
+ if (typeof slides.diagram_options !== "undefined") {
+ mermaidOptions = slides.diagram_options;
}
// `startOnLoad` must be false since diagrams are lazily rendered.
diff --git a/modules/slides/config/_default/hugo.yaml b/modules/slides/config/_default/hugo.yaml
new file mode 100644
index 00000000..01eaeeaf
--- /dev/null
+++ b/modules/slides/config/_default/hugo.yaml
@@ -0,0 +1,15 @@
+outputFormats:
+ Present:
+ mediaType: text/html
+ baseName: index
+ isHTML: true
+ permalinkable: true
+ path: present
+
+cascade:
+ - _target:
+ path: "/slides/**"
+ kind: "page"
+ outputs:
+ - HTML
+ - Present
diff --git a/modules/slides/layouts/slides/baseof.html b/modules/slides/layouts/slides/baseof.html
index 29239f0d..48369223 100644
--- a/modules/slides/layouts/slides/baseof.html
+++ b/modules/slides/layouts/slides/baseof.html
@@ -1,78 +1,46 @@
-
-
+{{/*
+ Slides Baseof - Landing page chrome only
+ Presentation output lives in baseof.present.html
+*/}}
+
+
+{{- $language_code := site.LanguageCode | default "en-us" -}}
+
+
-
- {{/* Asset versions */}}
- {{ $cdn_url_reveal := "https://cdn.jsdelivr.net/npm/reveal.js@5.0.4" }}
- {{ $mermaid_version := "9.1.3" }}
- {{ $mermaid_sri := "sha256-TIYL00Rhw/8WaoUhYTLX9SKIEFdXxg+yMWSLVUbhiLg=" }}
-
-
-
-
- {{ with site.Home.OutputFormats.Get "WebAppManifest" }}
-
- {{ end }}
-
-
-
-
-
-
-
{{ .Title }} | {{ site.Title }}
-
- {{/* Load Reveal CSS */}}
-
- {{- $theme := $.Param "slides.theme" | default "black" -}}
-
-
- {{/* Hugo Chroma Syntax Highlighter Initialization */}}
- {{ $hl_theme := $.Param "slides.highlight_style" | default "dracula" }}
- {{ $hl_theme_path := printf "css/libs/chroma/%s.css" $hl_theme }}
- {{ if not (fileExists (printf "assets/%s" $hl_theme_path)) }}
- {{ errorf "Hugo Chroma themes %s.css not found in `css/libs/chroma/`. See https://gohugo.io/commands/hugo_gen_chromastyles/" $hl_theme }}
- {{ else }}
- {{ $hl_theme_css := resources.Get $hl_theme_path | minify }}
-
- {{ end }}
-
- {{/* Load any Reveal CSS customizations */}}
- {{ $custom_reveal_css := printf "css/reveal_custom.css" }}
- {{ if (fileExists (printf "assets/%s" $custom_reveal_css)) }}
- {{ $css_custom := resources.Get "css/reveal_custom.css" }}
- {{ $style := slice $css_custom | resources.Concat "css/reveal_custom.css" | resources.Minify }}
-
- {{ end }}
+
{{ .Title }} | {{ site.Params.hugoblox.identity.name | default site.Title }}
+
+ {{ partial "site_head" . }}
+
-
- {{ block "main" . }}{{ end }}
-
- {{/* Load Reveal and built-in plugins. */}}
-
-
-
-
-
-
-
- {{/* Load third-party Reveal plugins. */}}
- {{ if $.Param "slides.reveal_options.menu_enabled" | default true}}
-
-
-
- {{ end }}
-
- {{/* Load Mermaid. */}}
- {{ if $.Param "slides.diagram" | default false}}
- {{ printf "" (printf "https://cdn.jsdelivr.net/npm/mermaid@%s/dist/mermaid.min.js" $mermaid_version) $mermaid_sri | safeHTML }}
- {{ end }}
-
- {{/* Initialize slides. */}}
- {{ $slidejs := resources.Get "js/hugoblox-slides.js" | js.Build (dict "params" (dict "slides" $.Params.slides )) }}
-
+
+ {{/* Landing page chrome */}}
+
+
+
+ {{ block "main" . }}{{ end }}
+
+
+
+ {{ partial "notification-container" . }}
+ {{ partial "functions/get_hook" (dict "hook" "body-end" "context" .) }}
diff --git a/modules/slides/layouts/slides/baseof.present.html b/modules/slides/layouts/slides/baseof.present.html
new file mode 100644
index 00000000..340e476c
--- /dev/null
+++ b/modules/slides/layouts/slides/baseof.present.html
@@ -0,0 +1,86 @@
+{{/*
+ Present Baseof - Presentation output only
+*/}}
+
+
+{{- $language_code := site.LanguageCode | default "en-us" -}}
+
+
+
+ {{/* Asset versions */}}
+ {{ $cdn_url_reveal := "https://cdn.jsdelivr.net/npm/reveal.js@5.0.4" }}
+ {{ $mermaid_version := "9.1.3" }}
+ {{ $mermaid_sri := "sha256-TIYL00Rhw/8WaoUhYTLX9SKIEFdXxg+yMWSLVUbhiLg=" }}
+
+
+
+
+
+
+ {{ with site.Home.OutputFormats.Get "WebAppManifest" }}
+
+ {{ end }}
+
+
+
+
+ {{ $landing_url := .Permalink }}
+ {{ with .OutputFormats.Get "HTML" }}
+ {{ $landing_url = .Permalink }}
+ {{ end }}
+
+
+
+
{{ .Title }} | {{ site.Params.hugoblox.identity.name | default site.Title }}
+
+ {{/* Load Reveal CSS */}}
+
+ {{- $theme := $.Param "slides.theme" | default "black" -}}
+
+
+ {{/* Hugo Chroma Syntax Highlighter */}}
+ {{ $hl_theme := $.Param "slides.highlight_style" | default "dracula" }}
+ {{ $hl_theme_path := printf "css/libs/chroma/%s.css" $hl_theme }}
+ {{ if fileExists (printf "assets/%s" $hl_theme_path) }}
+ {{ $hl_theme_css := resources.Get $hl_theme_path | minify }}
+
+ {{ end }}
+
+ {{/* Reveal print styles (paper or PDF) */}}
+
+
+
+
+ {{ block "main" . }}{{ end }}
+
+ {{/* Load Reveal and plugins */}}
+
+
+
+
+
+
+
+ {{/* Load Mermaid if enabled */}}
+ {{ if $.Param "slides.diagram" | default false}}
+ {{ printf "" (printf "https://cdn.jsdelivr.net/npm/mermaid@%s/dist/mermaid.min.js" $mermaid_version) $mermaid_sri | safeHTML }}
+ {{ end }}
+
+ {{/* Initialize Reveal */}}
+ {{ $slidejs := resources.Get "js/hugoblox-slides.js" | js.Build (dict "params" (dict "slides" $.Params.slides )) | fingerprint }}
+
+
+ {{ partial "functions/get_hook" (dict "hook" "body-end" "context" .) }}
+
+
+
diff --git a/modules/slides/layouts/slides/list.html b/modules/slides/layouts/slides/list.html
index e69de29b..7bca76f3 100644
--- a/modules/slides/layouts/slides/list.html
+++ b/modules/slides/layouts/slides/list.html
@@ -0,0 +1,212 @@
+{{ define "main" }}
+
+{{/* Enable Alpine.js for tag filtering */}}
+{{ .Store.Set "has_alpine" true }}
+
+{{/* Collect all unique tags from slides */}}
+{{ $allTags := slice }}
+{{ $featuredPages := slice }}
+{{ $regularPages := slice }}
+{{ $search_placeholder := i18n "slides_search_placeholder" | default "Search decks by title..." }}
+{{ $all_label := i18n "all" | default "All" }}
+{{ $no_decks_label := i18n "slides_no_decks" | default "No slide decks found" }}
+{{ $no_matches_label := i18n "slides_no_matches" | default "No decks match your filters" }}
+{{ $clear_filters_label := i18n "clear_filters" | default "Clear filters" }}
+
+{{ range .Pages }}
+ {{ if .Params.tags }}
+ {{ range .Params.tags }}
+ {{ $allTags = $allTags | append . }}
+ {{ end }}
+ {{ end }}
+ {{ if or .Params.featured .Params.pinned }}
+ {{ $featuredPages = $featuredPages | append . }}
+ {{ else }}
+ {{ $regularPages = $regularPages | append . }}
+ {{ end }}
+{{ end }}
+
+{{ $allTags = $allTags | uniq | sort }}
+
+{{/* Sort featured by date descending, then regular by date descending */}}
+{{ $featuredPages = sort $featuredPages ".Date" "desc" }}
+{{ $regularPages = sort $regularPages ".Date" "desc" }}
+{{ $sortedPages := $featuredPages | append $regularPages }}
+
+
+
+ {{/* Page Header */}}
+
+
{{ .Title }}
+ {{ with .Content }}
+
+ {{ . }}
+
+ {{ end }}
+
+
+ {{/* Search and Filter Bar */}}
+
+ {{/* Search input */}}
+
+
+ {{/* Tag Filter Chips */}}
+ {{ if $allTags }}
+
+
+ {{ range $allTags }}
+
+ {{ end }}
+
+ {{ end }}
+
+
+ {{/* Decks Grid */}}
+ {{ $view := .Params.view | default "slides-gallery" }}
+ {{ $config := dict
+ "columns" (.Params.columns | default 2)
+ "len" (len $sortedPages)
+ "fill_image" (.Params.fill_image | default true)
+ "show_date" (.Params.show_date | default true)
+ }}
+
+ {{ partial "functions/render_view" (dict "fragment" "start" "page" . "item" . "view" $view "config" $config) }}
+
+ {{ range $index, $item := $sortedPages }}
+ {{ $tags := $item.Params.tags | default (slice) }}
+ {{ $tagsJson := $tags | jsonify }}
+ {{ $authorList := slice }}
+ {{ with $item.Params.authors }}
+ {{ if reflect.IsSlice . }}
+ {{ $authorList = . }}
+ {{ else }}
+ {{ $authorList = slice . }}
+ {{ end }}
+ {{ end }}
+ {{ $authorNames := slice }}
+ {{ range $authorList }}
+ {{ $profile := partial "functions/get_author_profile" . }}
+ {{ $authorName := . }}
+ {{ if $profile.has_data }}
+ {{ $authorName = $profile.title }}
+ {{ end }}
+ {{ $authorNames = $authorNames | append $authorName }}
+ {{ end }}
+ {{ $searchParts := slice $item.Title }}
+ {{ with $item.Params.venue }}
+ {{ $searchParts = $searchParts | append . }}
+ {{ end }}
+ {{ if gt (len $authorNames) 0 }}
+ {{ $searchParts = $searchParts | append (delimit $authorNames " ") }}
+ {{ end }}
+ {{ if gt (len $tags) 0 }}
+ {{ $searchParts = $searchParts | append (delimit $tags " ") }}
+ {{ end }}
+ {{ $searchText := (delimit $searchParts " ") | lower }}
+
+
+ {{ partial "functions/render_view" (dict "page" $ "item" $item "view" $view "index" $index "config" $config) }}
+
+ {{ end }}
+
+ {{ partial "functions/render_view" (dict "fragment" "end" "page" . "item" . "view" $view) }}
+
+ {{/* Empty state */}}
+ {{ if eq (len $sortedPages) 0 }}
+
+
+
{{ $no_decks_label }}
+
+ {{ end }}
+
+ {{/* No matches empty state */}}
+
+
+
{{ $no_matches_label }}
+
+
+
+
+
+
+
+{{ end }}
diff --git a/modules/slides/layouts/slides/presenter.html b/modules/slides/layouts/slides/presenter.html
new file mode 100644
index 00000000..27ffc29c
--- /dev/null
+++ b/modules/slides/layouts/slides/presenter.html
@@ -0,0 +1,14 @@
+{{/*
+ Presenter Layout - Full-screen Reveal.js presentation
+ Uses parent page's slide content
+ Route: /slides/
/present/
+*/}}
+
+{{/* Get parent deck page (the actual slides content) */}}
+{{ $deckPage := .Parent }}
+{{ if not $deckPage }}
+ {{ $deckPage = . }}
+{{ end }}
+
+{{/* Render using modules/slides presentation layout */}}
+{{ partial "slides" (union (slice $deckPage) $deckPage.Pages) }}
diff --git a/modules/slides/layouts/slides/single.html b/modules/slides/layouts/slides/single.html
index 6bd27b18..134a872d 100644
--- a/modules/slides/layouts/slides/single.html
+++ b/modules/slides/layouts/slides/single.html
@@ -1,3 +1,335 @@
+{{/*
+ Smart Slides Single Layout
+ Landing page for slide decks.
+ Presentation output is rendered via the present output format.
+*/}}
+
{{ define "main" }}
-{{ partial "slides" (union (slice .Page) .Pages) }}
+
+{{ $present_format := .OutputFormats.Get "present" }}
+{{ $back_to_slides_label := i18n "back_to_slides" | default "Back to Slides" }}
+{{ $featured_label := i18n "featured" | default "Featured" }}
+{{ $slides_label := i18n "slides" | default "Slides" }}
+{{ $abstract_label := i18n "callout_abstract" | default "Abstract" }}
+{{ $topics_label := i18n "topics" | default "Topics" }}
+{{ $related_resources_label := i18n "related_resources" | default "Related Resources" }}
+{{ $present_fullscreen_label := i18n "present_fullscreen" | default "Present (fullscreen)" }}
+{{ $copy_link_label := i18n "copy_link" | default "Copy Link" }}
+{{ $copy_citation_label := i18n "copy_citation" | default "Copy citation" }}
+{{ $copied_label := i18n "btn_copied" | default "Copied" }}
+{{ $export_pdf_label := i18n "export_pdf_print" | default "Export PDF (print)" }}
+{{ $print_hint := i18n "slides_print_hint" | default "Opens in print mode - use browser Print > Save as PDF" }}
+{{ $how_to_cite_label := i18n "how_to_cite" | default "How to cite" }}
+{{ $citation_label := i18n "citation" | default "Citation" }}
+{{ $doi_label := i18n "btn_doi" | default "DOI" }}
+{{ $bibtex_label := i18n "bibtex" | default "BibTeX" }}
+{{ $download_cite_bib_label := i18n "download_cite_bib" | default "Download cite.bib" }}
+{{ $lecture_label := i18n "lecture" | default "Lecture" }}
+
+{{/* LANDING PAGE CONTENT */}}
+
+
+ {{/* Get slide metadata */}}
+ {{ $authors := .Params.authors | default (slice) }}
+ {{ $venue := .Params.venue }}
+ {{ $event := .Params.event }}
+ {{ $course := .Params.course }}
+ {{ $lecture := .Params.lecture_number }}
+ {{ $tags := .Params.tags | default (slice) }}
+ {{ $topics := .Params.topics | default $tags }}
+ {{ $description := .Params.abstract | default .Params.summary | default .Description }}
+ {{ $citation := .Params.citation }}
+
+ {{ $authorNames := slice }}
+ {{ $authorList := slice }}
+ {{ with $authors }}
+ {{ if reflect.IsSlice . }}
+ {{ $authorList = . }}
+ {{ else }}
+ {{ $authorList = slice . }}
+ {{ end }}
+ {{ end }}
+ {{ range $authorList }}
+ {{ $profile := partial "functions/get_author_profile" . }}
+ {{ $authorName := . }}
+ {{ if $profile.has_data }}
+ {{ $authorName = $profile.title }}
+ {{ end }}
+ {{ $authorNames = $authorNames | append $authorName }}
+ {{ end }}
+
+ {{/* Build links using HugoBlox standard structure */}}
+ {{ $builtLinks := partial "functions/build_links.html" (dict "page" . "is_list" false) }}
+
+ {{/* Filter links by type for Related Resources section */}}
+ {{ $resourceLinks := slice }}
+ {{ $citationLinks := slice }}
+ {{ range $builtLinks }}
+ {{ if in (slice "pdf" "preprint" "code" "video" "dataset" "demo" "site") .type }}
+ {{ $resourceLinks = $resourceLinks | append . }}
+ {{ else if in (slice "doi" "bibtex") .type }}
+ {{ $citationLinks = $citationLinks | append . }}
+ {{ end }}
+ {{ end }}
+
+ {{ $citation_copy := "" }}
+ {{ if $citation }}
+ {{ $citation_copy = $citation }}
+ {{ else }}
+ {{ range $citationLinks }}
+ {{ if and (eq $citation_copy "") (eq .type "doi") }}
+ {{ $citation_copy = .url }}
+ {{ else if and (eq $citation_copy "") (eq .type "bibtex") }}
+ {{ $citation_copy = .url }}
+ {{ end }}
+ {{ end }}
+ {{ end }}
+ {{ $has_citation_copy := ne $citation_copy "" }}
+
+ {{/* Calculate slide count */}}
+ {{ $content := .RawContent }}
+ {{ $slideCount := 1 }}
+ {{ $separators := findRE "(?m)^---$" $content }}
+ {{ if $separators }}
+ {{ $slideCount = add (len $separators) 1 }}
+ {{ if hasPrefix $content "---" }}
+ {{ $slideCount = sub $slideCount 1 }}
+ {{ end }}
+ {{ end }}
+
+
+
+ {{/* Back to library link */}}
+
+
+ {{ $back_to_slides_label }}
+
+
+ {{/* Main content card */}}
+
+
+ {{/* Hero section with gradient */}}
+
+ {{/* Featured badge */}}
+ {{ if or .Params.featured .Params.pinned }}
+
+
+ {{ $featured_label }}
+
+ {{ end }}
+
+
{{ .Title }}
+
+ {{/* Meta info */}}
+
+ {{ if gt (len $authorNames) 0 }}
+
+
+ {{ delimit $authorNames ", " }}
+
+ {{ end }}
+
+ {{ with $venue }}
+
+ {{ end }}
+
+ {{ with $event }}
+
+ {{ end }}
+
+ {{ if $course }}
+
+
+ {{ $course }}{{ with $lecture }} - {{ $lecture_label }} {{ . }}{{ end }}
+
+ {{ end }}
+
+
+
+ {{ .Date | time.Format "January 2006" }}
+
+
+
+
+ {{ $slideCount }} {{ $slides_label | lower }}
+
+
+
+
+ {{/* Content section */}}
+
+ {{/* Description/Abstract */}}
+ {{ with $description }}
+
+
{{ $abstract_label }}
+
{{ . }}
+
+ {{ end }}
+
+ {{/* Topics/Tags */}}
+ {{ if $topics }}
+
+
{{ $topics_label }}
+
+
+ {{ end }}
+
+ {{/* Related Resources - Use HugoBlox standard links */}}
+ {{ if $resourceLinks }}
+
+
{{ $related_resources_label }}
+
+
+ {{ end }}
+
+ {{/* Share Panel */}}
+
+ {{/* Open Presenter */}}
+ {{ with $present_format }}
+
+
+ {{ $present_fullscreen_label }}
+
+ {{ end }}
+
+ {{/* Copy Link */}}
+
+
+ {{/* Copy Citation */}}
+ {{ if $has_citation_copy }}
+
+ {{ end }}
+
+ {{/* Print PDF */}}
+ {{ with $present_format }}
+
+
+ {{ $export_pdf_label }}
+
+ {{ end }}
+
+
+ {{/* Citation Section - Use HugoBlox standard links + citation field */}}
+ {{ if or $citation $citationLinks }}
+
+
+
+ {{ with $citation }}
+
+
{{ $citation_label }}
+
{{ . }}
+
+ {{ end }}
+
+ {{/* DOI and BibTeX from standard links structure */}}
+ {{ range $citationLinks }}
+ {{ if eq .type "doi" }}
+
+ {{ else if eq .type "bibtex" }}
+
+ {{ end }}
+ {{ end }}
+
+
+ {{ end }}
+
+
+
+
+
+
+
The Presentation Framework for Researchers
+
+
+ Stop wrestling with PowerPoint.
+ Write slides in Markdown, version control your talks, and present code & math beautifully.
+
+
+
+ 🚀 Deploy in 60s (Free)
+ •
+ Live Demo
+ •
+ HugoBlox Studio (Visual Editor)
+
+
+
+
+ ▶︎ Watch Preview
+
+
+
+
+ Video coming soon...
+
+
+
+ 
+ 
+ 
+
+
+---
+
+## Why this template?
+
+Traditional slide software (PowerPoint, Keynote) locks your content in binary files, breaks code formatting, and makes version control a nightmare.
+
+- **📝 Markdown-first**: Write slides like you write papers. Focus on content, not pixel-perfect alignment.
+- **⚗️ Research-ready**: Native support for LaTeX math ($E=mc^2$), citations, and rich metadata (venue, DOI, authors).
+- **💻 Code-native**: Beautiful syntax highlighting for 100+ languages without screenshots.
+- **🎓 Deck Landing Pages**: Every presentation gets a dedicated searchable landing page with abstract and download links.
+- **🚀 Present Anywhere**: Browser-based presenter mode (Reveal.js) with speaker notes, timer, and offline support.
+
+---
+
+## Who it’s for
+
+- **Academics** presenting at conferences (share a URL, not a USB drive).
+- **Data Scientists** explaining complex analyses with real code snippets.
+- **Lecturers** creating course materials that students can actually search, read, and fork.
+- **Developers** who prefer their IDE over a GUI presentation tool.
+
+---
+
+## What you get (Free)
+
+- **Professional Presenter Mode**: Speaker notes, timer, and next-slide preview.
+- **Rich Metadata**: Associate events, co-authors, and related links with each deck.
+- **PDF Export**: One-click printable version for handouts.
+- **Mermaid Diagrams**: Draw flowcharts and sequence diagrams in text.
+- **Theming**: Light, dark, and custom themes included.
+- **Mobile Optimized**: Responsive gallery and slide viewer.
+
+---
+
+## Get started (recommended)
+
+### Option 1 — Online deployer (fastest)
+
+Deploy this template in ~60 seconds:
+
+- [Deploy in browser →](https://hugoblox.com/templates/markdown-slides/start?utm_source=github&utm_medium=readme)
+
+### Option 2 — HugoBlox Studio (visual editor in VS Code)
+
+- [Studio guide →](https://docs.hugoblox.com/guides/studio/?utm_source=github&utm_medium=readme)
+- [Studio AI automation plans (Free/Plus/Pro) →](https://hugoblox.com/pricing/?utm_source=github&utm_medium=readme)
+
+### Option 3 — HugoBlox CLI (developer workflow)
+
+Install:
+
+```bash
+npm install -g hugoblox@latest
+```
+
+Create a site:
+
+```bash
+hugoblox create site --template markdown-slides
+```
+
+[CLI docs →](https://docs.hugoblox.com/start/cli/?utm_source=github&utm_medium=readme)
+
+---
+
+## Customize in 10 minutes
+
+- **Create a deck**: `content/slides/my-talk/index.md`
+- **Slide syntax**: Use `---` to separate slides.
+- **Speaker notes**: Use `Note:` at the end of a slide.
+- **Theme**: Set `slides.theme: black` (or white, league, night, etc.) in frontmatter.
+- **Site Identity**: `config/_default/params.yaml`
+
+---
+
+## Want the Pro version? 💎
+
+If you want a version that feels meaningfully more premium (and helps fund open source + research):
+
+- [Premium templates →](https://hugoblox.com/templates/?utm_source=github&utm_medium=readme)
+- [HugoBlox Pro / Studio →](https://hugoblox.com/pricing?utm_source=github&utm_medium=readme)
+
+---
+
+## Community & support
+
+- **Docs**: [docs.hugoblox.com →](https://docs.hugoblox.com/?utm_source=github&utm_medium=readme)
+- **Discord**: [Join Discord →](https://discord.gg/z8wNYzb)
+- **Issues**: [Open an issue →](https://github.com/HugoBlox/kit/issues)
+
+---
+
+MIT © 2016–Present [George Cushen](https://neuralgeo.com/?utm_source=github&utm_medium=readme)
diff --git a/templates/markdown-slides/assets/media/authors/me.png b/templates/markdown-slides/assets/media/authors/me.png
new file mode 100644
index 00000000..5ebc1f3b
Binary files /dev/null and b/templates/markdown-slides/assets/media/authors/me.png differ
diff --git a/templates/markdown-slides/assets/media/icon.svg b/templates/markdown-slides/assets/media/icon.svg
new file mode 100644
index 00000000..920fae34
--- /dev/null
+++ b/templates/markdown-slides/assets/media/icon.svg
@@ -0,0 +1,6 @@
+
diff --git a/templates/markdown-slides/config/_default/hugo.yaml b/templates/markdown-slides/config/_default/hugo.yaml
new file mode 100644
index 00000000..fef73e9c
--- /dev/null
+++ b/templates/markdown-slides/config/_default/hugo.yaml
@@ -0,0 +1,62 @@
+# Configuration of Hugo
+# Documentation: https://gohugo.io/getting-started/configuration/
+
+# Website name (set in params.yaml under hugoblox.identity.name)
+title: ''
+# Website URL
+baseURL: 'https://example.com/'
+
+############################
+## LANGUAGE
+############################
+
+defaultContentLanguage: en
+hasCJKLanguage: false
+removePathAccents: true
+
+############################
+## ADVANCED
+############################
+
+build:
+ writeStats: true
+enableGitInfo: false
+summaryLength: 30
+pagination:
+ pagerSize: 12
+enableEmoji: true
+enableRobotsTXT: true
+footnotereturnlinkcontents: ^
+disableAliases: true
+outputs:
+ home: [HTML, RSS, headers, redirects]
+ section: [HTML, RSS]
+ page: [HTML]
+outputFormats:
+ HTML:
+ baseName: index
+ present:
+ baseName: index
+ isHTML: true
+ mediaType: text/html
+ permalinkable: true
+ path: present
+ rel: alternate
+
+permalinks:
+ slides: /slides/:contentbasename/
+imaging:
+ resampleFilter: lanczos
+ quality: 90
+ anchor: smart
+timeout: 600000
+taxonomies:
+ tag: tags
+markup:
+ _merge: deep
+ highlight:
+ lineNos: false
+security:
+ _merge: deep
+sitemap:
+ _merge: deep
diff --git a/templates/markdown-slides/config/_default/menus.yaml b/templates/markdown-slides/config/_default/menus.yaml
new file mode 100644
index 00000000..402eaa36
--- /dev/null
+++ b/templates/markdown-slides/config/_default/menus.yaml
@@ -0,0 +1,10 @@
+# Navigation Links
+# Simple navigation for a slides-focused site
+
+main:
+ - name: Home
+ url: /
+ weight: 10
+ - name: Browse Decks
+ url: /slides/
+ weight: 20
diff --git a/templates/markdown-slides/config/_default/module.yaml b/templates/markdown-slides/config/_default/module.yaml
new file mode 100644
index 00000000..aadb9dc5
--- /dev/null
+++ b/templates/markdown-slides/config/_default/module.yaml
@@ -0,0 +1,10 @@
+############################
+## HUGO MODULES
+## Install or uninstall themes and plugins here.
+## Docs: https://gohugo.io/hugo-modules/
+############################
+
+imports:
+ - path: github.com/HugoBlox/kit/modules/integrations/netlify
+ - path: github.com/HugoBlox/kit/modules/blox
+ - path: github.com/HugoBlox/kit/modules/slides
diff --git a/templates/markdown-slides/config/_default/params.yaml b/templates/markdown-slides/config/_default/params.yaml
new file mode 100644
index 00000000..8d32912b
--- /dev/null
+++ b/templates/markdown-slides/config/_default/params.yaml
@@ -0,0 +1,131 @@
+# ══════════════════════════════════════════════════════════════════════════════
+# MARKDOWN SLIDES - HUGO BLOX CONFIGURATION
+# A minimal template for hosting and sharing slide decks
+# Documentation: https://docs.hugoblox.com/
+# ══════════════════════════════════════════════════════════════════════════════
+hugoblox:
+ schema: "2.0"
+
+ # ────────────────────────────────────────────────────────────────────────────
+ # IDENTITY
+ # Customize your slide deck site branding
+ # ────────────────────────────────────────────────────────────────────────────
+ identity:
+ name: "My Slides"
+ organization: ""
+ type: person # person | organization
+ tagline: "Open-source slide decks"
+ description: "Markdown-based slide presentations. Write in Markdown, present anywhere, share with anyone."
+ social:
+ twitter: "" # Twitter/X handle for social cards
+
+ # ────────────────────────────────────────────────────────────────────────────
+ # THEME
+ # ────────────────────────────────────────────────────────────────────────────
+ theme:
+ mode: system # light | dark | system
+ pack: "default"
+ colors:
+ primary: ""
+ secondary: ""
+ neutral: ""
+
+ # ────────────────────────────────────────────────────────────────────────────
+ # TYPOGRAPHY
+ # ────────────────────────────────────────────────────────────────────────────
+ typography:
+ font: "sans" # sans | serif | native
+ size: "md" # sm | md | lg | xl
+
+ # ────────────────────────────────────────────────────────────────────────────
+ # LAYOUT
+ # ────────────────────────────────────────────────────────────────────────────
+ layout:
+ radius: "md"
+ spacing: "comfortable"
+
+ # ────────────────────────────────────────────────────────────────────────────
+ # HEADER
+ # ────────────────────────────────────────────────────────────────────────────
+ header:
+ enable: true
+ style: navbar-simple # Clean, minimal navbar
+ sticky: true
+ align: center
+ search: true # Enable search for larger deck collections
+ theme_toggle: true
+ theme_picker: false
+ language_switcher: false
+
+ # ────────────────────────────────────────────────────────────────────────────
+ # FOOTER
+ # ────────────────────────────────────────────────────────────────────────────
+ footer:
+ style: minimal
+ language_switcher: false
+ text: ""
+
+ # ────────────────────────────────────────────────────────────────────────────
+ # COPYRIGHT
+ # ────────────────────────────────────────────────────────────────────────────
+ copyright:
+ notice: "© {year} {name}"
+ license:
+ type: cc
+ allow_derivatives: true
+ share_alike: true
+ allow_commercial: false
+
+ # ────────────────────────────────────────────────────────────────────────────
+ # CONTENT
+ # Math is enabled by default for technical presentations
+ # ────────────────────────────────────────────────────────────────────────────
+ content:
+ math:
+ enable: true # Enable LaTeX math for technical decks
+ toc:
+ enable: false # Not needed for slides
+ reading_time:
+ enable: false # Not relevant for slides
+
+ # ────────────────────────────────────────────────────────────────────────────
+ # SEARCH
+ # ────────────────────────────────────────────────────────────────────────────
+ search:
+ enable: true
+ suggestions: []
+
+ # ────────────────────────────────────────────────────────────────────────────
+ # COMMENTS - Disabled by default
+ # ────────────────────────────────────────────────────────────────────────────
+ comments:
+ enable: false
+
+ # ────────────────────────────────────────────────────────────────────────────
+ # ANALYTICS - Add your tracking IDs
+ # ────────────────────────────────────────────────────────────────────────────
+ analytics:
+ google:
+ measurement_id: ""
+ plausible:
+ domain: ""
+
+ # ────────────────────────────────────────────────────────────────────────────
+ # LOCALE
+ # ────────────────────────────────────────────────────────────────────────────
+ locale:
+ date_format: "Jan 2, 2006"
+ time_format: "3:04 PM"
+
+ # ────────────────────────────────────────────────────────────────────────────
+ # SECURITY - Allow slides to be embedded in iframes
+ # ────────────────────────────────────────────────────────────────────────────
+ security:
+ frame_options: sameorigin
+
+ # ────────────────────────────────────────────────────────────────────────────
+ # PRO
+ # ────────────────────────────────────────────────────────────────────────────
+ pro:
+ hide_attribution: false
+ affiliate_code: ""
diff --git a/templates/markdown-slides/content/_index.md b/templates/markdown-slides/content/_index.md
new file mode 100644
index 00000000..286892fc
--- /dev/null
+++ b/templates/markdown-slides/content/_index.md
@@ -0,0 +1,77 @@
+---
+title: ''
+summary: ''
+date: 2025-01-01
+type: landing
+
+design:
+ spacing: '4rem'
+
+sections:
+ # Hero Section
+ - block: hero
+ content:
+ title: Markdown Slides
+ text: |-
+ **Open-source slide decks.**
+ Write in Markdown, present anywhere, share with anyone.
+ primary_action:
+ text: Browse Decks
+ url: '/slides/'
+ icon: play
+ secondary_action:
+ text: Create Your Own
+ url: https://hugoblox.com/templates/markdown-slides/start?utm_source=hugoblox&utm_medium=demo
+ design:
+ spacing:
+ padding: ['5rem', '0', '4rem', '0']
+ css_class: 'dark:bg-zinc-900'
+
+ - block: features
+ content:
+ title: Why Markdown Slides
+ text: 'Best for: lab meetings, course lectures, paper reading groups, and startup demos.'
+ items:
+ - name: Version-controlled research
+ description: Write decks like code, track diffs, and cite stable versions.
+ icon: hero/code-bracket
+ - name: Research-native media
+ description: Math, citations, syntax highlighting, and diagrams out of the box.
+ icon: hero/document-text
+ - name: Future-proof format
+ description: Most future-proof format - Markdown is LLM-native for human-first, AI-assisted workflows.
+ icon: hero/bolt
+
+ # Featured Decks Row
+ - block: collection
+ id: decks
+ content:
+ title: Featured Decks
+ text: ''
+ filters:
+ folders:
+ - slides
+ featured_only: true
+ sort_by: Date
+ sort_ascending: false
+ count: 3
+ design:
+ view: slides-gallery
+ columns: 2
+
+ - block: collection
+ id: recent
+ content:
+ title: Recent Decks
+ text: ''
+ filters:
+ folders:
+ - slides
+ exclude_featured: true
+ sort_by: Date
+ sort_ascending: false
+ count: 0
+ design:
+ view: slides-gallery
+ columns: 2
+---
diff --git a/templates/markdown-slides/content/slides/_index.md b/templates/markdown-slides/content/slides/_index.md
new file mode 100644
index 00000000..e0194096
--- /dev/null
+++ b/templates/markdown-slides/content/slides/_index.md
@@ -0,0 +1,12 @@
+---
+title: All Slide Decks
+description: Browse all available slide presentations
+view: slides-gallery
+columns: 2
+cascade:
+ outputs:
+ - HTML
+ - present
+---
+
+Browse all slide decks below. Click any deck to start the presentation.
diff --git a/templates/markdown-slides/content/slides/example/index.md b/templates/markdown-slides/content/slides/example/index.md
new file mode 100644
index 00000000..6e8161ac
--- /dev/null
+++ b/templates/markdown-slides/content/slides/example/index.md
@@ -0,0 +1,166 @@
+---
+title: "Markdown Slides Demo"
+date: 2025-12-15
+description: "A comprehensive demo of all Reveal.js features available in Hugo Blox"
+authors: ["me", "Hugo Blox Team"]
+tags: ["demo", "tutorial", "features"]
+venue: "Hugo Blox Tutorial"
+featured: true
+type: slides
+slides:
+ theme: black
+ highlight_style: dracula
+ diagram: true
+ reveal_options:
+ controls: true
+ progress: true
+ slideNumber: true
+ hash: true
+---
+
+# Markdown Slides
+
+### Write in Markdown. Present Anywhere.
+
+---
+
+## What You Can Do
+
+- Write slides in **pure Markdown**
+- Include **code**, **math**, and **diagrams**
+- Add **speaker notes** for presenter view
+- Use **progressive reveals** for storytelling
+- Customize **themes** and **transitions**
+
+---
+
+## Code Highlighting
+
+```python
+def fibonacci(n: int) -> int:
+ if n <= 1:
+ return n
+ return fibonacci(n-1) + fibonacci(n-2)
+
+# Calculate the 10th Fibonacci number
+print(fibonacci(10)) # Output: 55
+```
+
+---
+
+## Mathematical Equations
+
+Einstein's famous equation:
+
+$$E = mc^2$$
+
+The quadratic formula:
+
+$$x = \frac{-b \pm \sqrt{b^2-4ac}}{2a}$$
+
+---
+
+## Mermaid Diagrams
+
+```mermaid
+graph LR
+ A[Markdown] --> B[Hugo]
+ B --> C[Reveal.js]
+ C --> D[Beautiful Slides]
+```
+
+---
+
+## Progressive Reveals
+
+Build your narrative step by step:
+
+{{< fragment >}}First, introduce the concept{{< /fragment >}}
+
+{{< fragment >}}Then, add supporting details{{< /fragment >}}
+
+{{< fragment >}}Finally, deliver the conclusion{{< /fragment >}}
+
+---
+
+## Speaker Notes
+
+Press **S** to open presenter view!
+
+Note:
+- These notes are only visible in presenter mode
+- Perfect for talking points and reminders
+- Supports **Markdown** formatting
+- Add timing cues and references here
+
+---
+
+## Dual Column Layout
+
+
+
+
+
+### Benefits
+
+- Open source
+- Version control
+- No vendor lock-in
+- Works offline
+
+
+
+
+
+### Use Cases
+
+- Tech talks
+- Academic papers
+- Team updates
+- Training sessions
+
+
+
+
{{ .Title }}
+ {{ .Summary }}
+ Read more
+
+{{ end }}
+```
+
+---
+
+## Build Performance
+
+Hugo builds **thousands of pages in seconds**:
+
+{{< fragment >}}📄 10 pages → 50ms{{< /fragment >}}
+
+{{< fragment >}}📄 1,000 pages → 500ms{{< /fragment >}}
+
+{{< fragment >}}📄 10,000 pages → 5 seconds{{< /fragment >}}
+
+{{< fragment >}}**The fastest static site generator!**{{< /fragment >}}
+
+---
+
+## Deployment Options
+
+- **Netlify** - Git-based deploys
+- **Vercel** - Edge functions
+- **Cloudflare Pages** - Global CDN
+- **GitHub Pages** - Free hosting
+- **AWS S3** - Scalable storage
+
+---
+
+## When to Use Hugo
+
+✅ Documentation sites
+
+✅ Blogs and portfolios
+
+✅ Marketing landing pages
+
+✅ Conference websites
+
+✅ **Slide presentations!**
+
+---
+
+## Getting Started
+
+```bash
+# Install Hugo
+brew install hugo
+
+# Create a new site
+hugo new site mysite
+
+# Add content
+hugo new posts/hello-world.md
+
+# Start dev server
+hugo server -D
+```
+
+---
+
+## Resources
+
+- **Documentation**: [gohugo.io/documentation](https://gohugo.io/documentation/)
+- **Themes**: [themes.gohugo.io](https://themes.gohugo.io/)
+- **Community**: [discourse.gohugo.io](https://discourse.gohugo.io/)
+- **Hugo Blox**: [hugoblox.com](https://hugoblox.com)
+
+---
+
+## Thank You!
+
+### Questions?
+
+**Start building faster websites today** 🚀
+
+Note:
+Key takeaways:
+1. Static sites are more secure, faster, and cheaper
+2. Hugo is the fastest static site generator
+3. Perfect for content-focused websites
+4. Easy to deploy on any CDN
diff --git a/templates/markdown-slides/content/slides/ml-research-overview/index.md b/templates/markdown-slides/content/slides/ml-research-overview/index.md
new file mode 100644
index 00000000..1fcf0c13
--- /dev/null
+++ b/templates/markdown-slides/content/slides/ml-research-overview/index.md
@@ -0,0 +1,252 @@
+---
+title: "Machine Learning Research Overview"
+date: 2025-12-25
+description: "A research presentation on recent advances in deep learning and neural networks"
+authors: ["me", "Dr. Example Researcher"]
+tags: ["machine-learning", "research", "data-science"]
+topics: ["deep-learning", "transformers", "neural-networks"]
+venue: "ICML 2025"
+event: "International Conference on Machine Learning"
+citation: "Researcher, E., Smith, J., & Doe, J. (2025). Machine Learning Research Overview. ICML 2025."
+type: slides
+
+# HugoBlox standard links structure
+links:
+ - type: preprint
+ url: "https://arxiv.org/abs/example"
+ icon: hero/document-text
+ - type: code
+ url: "https://github.com/example/ml-research"
+ icon: hero/code-bracket
+
+# HugoBlox standard identifiers - auto-generates DOI link
+hugoblox:
+ ids:
+ doi: "10.1234/example.doi"
+
+slides:
+ theme: black
+ highlight_style: dracula
+ diagram: true
+ reveal_options:
+ controls: true
+ progress: true
+ slideNumber: true
+ hash: true
+---
+
+# Machine Learning
+## Research Overview 2025
+
+Dr. Example Researcher
+
+---
+
+## Agenda
+
+1. Background & Motivation
+2. Neural Network Fundamentals
+3. Transformer Architecture
+4. Experimental Results
+5. Future Directions
+
+---
+
+## The Deep Learning Revolution
+
+```mermaid
+graph TD
+ A[Traditional ML] --> B[Deep Learning]
+ B --> C[Computer Vision]
+ B --> D[NLP]
+ B --> E[Reinforcement Learning]
+ C --> F[Multimodal AI]
+ D --> F
+```
+
+---
+
+## Neural Network Basics
+
+A neuron computes:
+
+$$y = f\left(\sum_{i=1}^{n} w_i x_i + b\right)$$
+
+Where:
+- $x_i$ = inputs
+- $w_i$ = weights
+- $b$ = bias
+- $f$ = activation function
+
+---
+
+## Activation Functions
+
+**ReLU (Rectified Linear Unit):**
+
+$$f(x) = \max(0, x)$$
+
+**Sigmoid:**
+
+$$\sigma(x) = \frac{1}{1 + e^{-x}}$$
+
+**Softmax:**
+
+$$\text{softmax}(x_i) = \frac{e^{x_i}}{\sum_j e^{x_j}}$$
+
+---
+
+## Transformer Architecture
+
+{{< fragment >}}**Self-Attention Mechanism:**{{< /fragment >}}
+
+{{< fragment >}}$$\text{Attention}(Q, K, V) = \text{softmax}\left(\frac{QK^T}{\sqrt{d_k}}\right)V$${{< /fragment >}}
+
+{{< fragment >}}Enables parallel processing of sequences{{< /fragment >}}
+
+Note:
+- Q = Query matrix
+- K = Key matrix
+- V = Value matrix
+- d_k = dimension of keys
+
+---
+
+## Model Architecture
+
+```python
+class TransformerBlock(nn.Module):
+ def __init__(self, d_model, n_heads):
+ super().__init__()
+ self.attention = MultiHeadAttention(d_model, n_heads)
+ self.ffn = FeedForward(d_model)
+ self.norm1 = LayerNorm(d_model)
+ self.norm2 = LayerNorm(d_model)
+
+ def forward(self, x):
+ x = x + self.attention(self.norm1(x))
+ x = x + self.ffn(self.norm2(x))
+ return x
+```
+
+---
+
+## Experimental Setup
+
+
+
+
+
+### Dataset
+
+- **Size**: 1M samples
+- **Split**: 80/10/10
+- **Preprocessing**: Tokenization, normalization
+
+
+
+
+
+### Training
+
+- **Optimizer**: AdamW
+- **Learning rate**: 3e-4
+- **Batch size**: 256
+- **Epochs**: 100
+
+
+
+