Skip to content

Build speaker and schedule JSON-LD from Sessionize - #168

Merged
matrixise merged 2 commits into
mainfrom
sessionize-structured-data
Nov 18, 2026
Merged

matrixise merged 2 commits into
mainfrom
sessionize-structured-data

Conversation

@matrixise

Copy link
Copy Markdown
Contributor

Problem

The JSON-LD on /schedule/, /grid/ and /speakers/ was generated from data/sessions.yml, data/speakers.yml and data/schedule.yml, which still contained the template's placeholder content (e.g. "The Future of Python: What's Coming in 3.15 and Beyond" by "Anna Ravenscroft"). Search engines were being fed invented talks and speakers, while the visible pages show the real programme via the Sessionize embeds.

Changes

Structured data from Sessionize

  • New layouts/partials/sessionize-data.html fetches the Sessionize JSON endpoint (params.sessionizeApiUrl, "All data" view) at build time via resources.GetRemote, like the Tito integration (Load Tito widget on homepage only and source ticket prices from Tito #164). If Sessionize is unreachable, a WARN is logged and the structured data is omitted. The build does not fail.
  • /schedule/ and /grid/: an @graph with one EducationalEvent per accepted session (43). Each has its exact startDate/endDate, the room as location (containedInPlace the venue @id), performer references and a superEvent link to #main-event.
  • /speakers/: ItemList of 49 Person nodes (tagline as jobTitle, bio, photo, sameAs links, performerIn back to their sessions).
  • Homepage Event: all speakers listed as performer.
  • All of it is built with dict + jsonify | safeJS instead of string templating, so quotes and emoji in titles and bios are escaped correctly.
  • Removed data/speakers.yml, data/sessions.yml, data/schedule.yml, and the unused keynotes.html / speaker-card.html partials that read them. Also dropped the EventSeries block.

Time zone fix

  • eventStartDate/eventEndDate used +01:00, but Dublin is on GMT (+00:00) in November, so search engines saw the event starting at 08:00 local time. The end time is now aligned with the last session in Sessionize (Lightning Talks, 19:05).

Small fixes from the site audit

  • Footer: slice . 0 7 rendered [<full sha> 0 7]; now substr . 0 7.
  • Homepage: removed the stale "CFP closed · 30 August 2026" badge. Its markup also left a <span> unclosed.
  • Venue page title: "Venue" instead of "Venue: Confirmed".

Docs: CLAUDE.md updated (data model, structured data layers, time zone note). docs/STRUCTURED-DATA.md gets a note pointing to the new setup.

Verification

  • hugo --minify builds with no warnings related to this change.
  • JSON-LD parsed for every page: 43 sessions, 49 speakers, no dangling @id references (every performer resolves to a Person, every performerIn to a session). Times are emitted as 2026-11-21T09:00:00+00:00. No placeholder names are left.
  • With an invalid HUGO_PARAMS_SESSIONIZEAPIURL: a warning is logged, there is no schedule/speaker JSON-LD and no performer, and the build succeeds.
  • scripts/check-csp.py passes (no new client-side domains).

After deploy: check /schedule/ with the Google Rich Results Test.

🤖 Generated with Claude Code

The schedule and speakers JSON-LD was generated from data/*.yml, which
still held the template's placeholder talks and speakers, so search
engines were fed invented sessions a few days before the event.

- Add partials/sessionize-data.html: fetch the Sessionize JSON "All
  data" endpoint (params.sessionizeApiUrl) at build time; a Sessionize
  outage logs a warning and omits the structured data
- /schedule/ and /grid/: one EducationalEvent per accepted session
  (exact start/end, room, performers, superEvent), built with
  dict + jsonify
- /speakers/: ItemList of Person (tagline, bio, photo, sameAs,
  performerIn)
- Homepage Event: list all speakers as performer
- Remove data/speakers.yml, sessions.yml, schedule.yml and the unused
  keynotes.html / speaker-card.html partials that depended on them
- Fix event times: Dublin is on GMT (+00:00) in November, not +01:00;
  end time aligned with the last session (19:05)
- Footer: show the short commit SHA (substr instead of slice, which
  rendered "[<sha> 0 7]")
- Homepage: drop the stale "CFP closed" badge (it also left an
  unclosed <span>)
- Venue page title: "Venue" instead of "Venue: Confirmed"
- Update CLAUDE.md and docs/STRUCTURED-DATA.md
@netlify

netlify Bot commented Nov 18, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for pycon-ireland-2026 ready!

Name Link
🔨 Latest commit 268da0c
🔍 Latest deploy log https://app.netlify.com/projects/pycon-ireland-2026/deploys/6afe0aaf79f09a31df1adb86
😎 Deploy Preview https://deploy-preview-168--pycon-ireland-2026.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

- Use schema.org EducationEvent: "EducationalEvent" (inherited from the
  previous partial) is not a schema.org type, so every session node and
  its properties were invalid
- Add the venue address to each session location (required by Google
  for physical events)
- Add image (speaker photos, site image as fallback) and offers (the
  conference tickets from Tito) to each session
- Expose speakerPhotos from sessionize-data.html
@matrixise
matrixise merged commit b83d755 into main Nov 18, 2026
6 checks passed
@matrixise
matrixise deleted the sessionize-structured-data branch November 18, 2026 20:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant