presently 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 643836e8c5dc04796f1d19608f000c44899b6e862d912cfc227d259fdad4513c
-  data.tar.gz: 84a5e2b009f1d2c70b6909aa0a07c435a77f523ff0d2d3fb6601126861fb9581
+  metadata.gz: 806fa6100505250fcb875b1d751bd96df78108d835bb60ad65c0484e0850e296
+  data.tar.gz: 723cdf3db680519971054969cff462752b85b7df67cab51c0bc50f8585c00890
 SHA512:
-  metadata.gz: 4a4053492995b0539792e82020b769496590249dfe9c61baf05a61dc9732a76da8f699bb7d1bf121c4acf4691782bf1d0c0d99b4924b846c40a381b3dd852b75
-  data.tar.gz: 85ddc51941cd49ead066025ca245627a4d4a50c478a43044ab0c799266874b1401579b64b0e8c23bed7d5957325ae517933e570004c349b175651f065ef81a2d
+  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/version.rb

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

data/readme.md

@@ -29,6 +29,10 @@ 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.

data/releases.md

@@ -1,5 +1,9 @@
 # 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.

metadata

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