presently 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3991c95331fdcabd96b64dd78833690a52468f2a1e570eddf3234fd5e9bfa7ac
-  data.tar.gz: 816e1de43c33929e12424659455e116891294d79dcc3d2ea41cc8df9b13317dd
+  metadata.gz: 806fa6100505250fcb875b1d751bd96df78108d835bb60ad65c0484e0850e296
+  data.tar.gz: 723cdf3db680519971054969cff462752b85b7df67cab51c0bc50f8585c00890
 SHA512:
-  metadata.gz: bc5afae0aaeb288b51b4ccd6c8e66a562acd44898a49a3777299865ccff1a400258e88dd1fa3950071db8949b107fa076eac2d5042ccdd847e11d8d395801892
-  data.tar.gz: e0b1a9f6e5743beecdb4745469335c5ed8ad154e74bd5fdf2c745f54ce83532c1d81af3014c67ff8c9480e878b09a21e0df50cf73805e2a5676c0516a8ef807a
+  metadata.gz: 12e369d511548176c671fbd42718cd136d3d628f173d0c6901f36c805fa87612067765ca1a29d808ec806b223c11ce2f2ea0c59d879b6eb97fa13e27828fd935
+  data.tar.gz: 10b3df45c9ed1e72e2dd01bae21daef286cea851e2f5630f7684b0de32771295bbce64a05ee81a028d20992ccb5235151277d2c3515df8cb469253d78d5b2a30

data/bake/presently/slides.rb

@@ -33,6 +33,40 @@ def notes(slides_root: "slides")
 	return nil
 end
 
+# Print a timing breakdown grouped by speaker.
+#
+# Loads every slide in the slides directory and groups them by the `speaker`
+# front matter key. For each speaker, prints each of their slides with its
+# individual duration, followed by a total. Slides with no `speaker` key are
+# grouped under `(no speaker)`. Slides are listed in presentation order.
+#
+# @parameter slides_root [String] The slides directory. Default: `slides`.
+def speakers(slides_root: "slides")
+	require "presently"
+	
+	presentation = Presently::Presentation.load(slides_root)
+	
+	# Group slides by speaker, preserving presentation order within each group.
+	groups = {}
+	presentation.slides.each do |slide|
+		key = slide.speaker || "(no speaker)"
+		(groups[key] ||= []) << slide
+	end
+	
+	groups.each do |speaker, slides|
+		total_seconds = slides.sum(&:duration)
+		puts "#{speaker} — #{format_duration(total_seconds)}"
+		
+		slides.each do |slide|
+			puts "  #{format_duration(slide.duration)}  #{slide.title}  (#{File.basename(slide.path)})"
+		end
+		
+		puts
+	end
+	
+	return nil
+end
+
 # Renumber slide files sequentially with a consistent step size.
 #
 # Renames all `.md` files in the slides directory to have sequential
@@ -89,3 +123,13 @@ def renumber(slides_root: "slides", step: 10)
 	
 	puts "Renumbered #{renames.length} slides."
 end
+
+private
+
+# Format a number of seconds as `M:SS`.
+# @parameter seconds [Integer]
+# @returns [String]
+def format_duration(seconds)
+	seconds = seconds.to_i
+	"%d:%02d" % [seconds / 60, seconds % 60]
+end

data/lib/presently/presenter_view.rb

@@ -101,6 +101,7 @@ module Presently
 		# @parameter slide [Slide | Nil] The current slide.
 		def render_timing(builder, slide)
 			progress = (@controller.slide_progress * 100).round(1)
+			next_slide = @controller.next_slide
 			builder.tag(:div, class: "timing", style: "--slide-progress: #{progress}%") do
 				pacing = @controller.pacing
 				pacing_class = case pacing
@@ -153,6 +154,21 @@ module Presently
 							builder.text("Slide: #{format_duration(slide.duration)}")
 						end
 					end
+					
+					# Speaker display — only shown when front matter includes a `speaker` key.
+					if (current_speaker = slide&.speaker)
+						builder.tag(:span, class: "speaker-info") do
+							builder.tag(:span, class: "speaker-label"){builder.text("🎤")}
+							builder.text(" #{current_speaker}")
+							
+							# Show upcoming speaker only when they differ from the current one.
+							if (next_speaker = next_slide&.speaker) && next_speaker != current_speaker
+								builder.tag(:span, class: "next-speaker") do
+									builder.text(" → #{next_speaker}")
+								end
+							end
+						end
+					end
 				end
 			end
 		end

data/lib/presently/slide.rb

@@ -213,6 +213,12 @@ module Presently
 			@front_matter&.fetch("transition", nil)
 		end
 		
+		# The name of the speaker presenting this slide.
+		# @returns [String | Nil] The speaker name from front_matter, or `nil` if not specified.
+		def speaker
+			@front_matter&.fetch("speaker", nil)
+		end
+		
 		# The line range to focus on for code slides.
 		# @returns [Array(Integer, Integer) | Nil] The `[start, end]` line numbers (1-based), or `nil`.
 		def focus

data/lib/presently/version.rb

@@ -5,5 +5,5 @@
 
 # @namespace
 module Presently
-	VERSION = "0.4.0"
+	VERSION = "0.6.0"
 end

data/public/_static/index.css

@@ -675,6 +675,23 @@ html[data-transition="morph"]::view-transition-new(slide-container) {
 	margin-left: auto;
 }
 
+.timing-info .speaker-info {
+	display: flex;
+	align-items: center;
+	gap: 0.25rem;
+	font-size: 0.9rem;
+	background: rgba(255, 255, 255, 0.08);
+	border: 1px solid rgba(255, 255, 255, 0.12);
+	border-radius: 6px;
+	padding: 0.2rem 0.6rem;
+	white-space: nowrap;
+}
+
+.timing-info .next-speaker {
+	opacity: 0.6;
+	font-style: italic;
+}
+
 /* Notes */
 .notes {
 	background: var(--surface);

data/readme.md

@@ -29,6 +29,14 @@ Please see the [project documentation](https://socketry.github.io/presently/) fo
 
 Please see the [project releases](https://socketry.github.io/presently/releases/index) for all releases.
 
+### v0.6.0
+
+  - Add `bake presently:slides:speakers` task to print a timing breakdown grouped by speaker. Each speaker's slides are listed in presentation order with individual and total durations, making it easy to balance talk time in multi-speaker presentations. Slides without a `speaker` key are grouped under `(no speaker)`.
+
+### v0.5.0
+
+  - Add optional `speaker` front matter key to slides. When present, the current speaker's name is shown in the timing bar. If the next slide has a different speaker, a handoff indicator (e.g. `→ Next Speaker`) is shown alongside, giving presenters an at-a-glance cue for tag-team talks.
+
 ### v0.4.0
 
   - Add `bake presently:slides:notes` task to extract all presenter notes into a single Markdown document, with each slide's file path as a heading. Useful for reviewing or sharing speaker notes outside of the presentation.

data/releases.md

@@ -1,5 +1,13 @@
 # Releases
 
+## v0.6.0
+
+  - Add `bake presently:slides:speakers` task to print a timing breakdown grouped by speaker. Each speaker's slides are listed in presentation order with individual and total durations, making it easy to balance talk time in multi-speaker presentations. Slides without a `speaker` key are grouped under `(no speaker)`.
+
+## v0.5.0
+
+  - Add optional `speaker` front matter key to slides. When present, the current speaker's name is shown in the timing bar. If the next slide has a different speaker, a handoff indicator (e.g. `→ Next Speaker`) is shown alongside, giving presenters an at-a-glance cue for tag-team talks.
+
 ## v0.4.0
 
   - Add `bake presently:slides:notes` task to extract all presenter notes into a single Markdown document, with each slide's file path as a heading. Useful for reviewing or sharing speaker notes outside of the presentation.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: presently
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Samuel Williams