slides-to-site

Slides to Site

Convert a Google Slides presentation into a psd401.ai presentation page. Reads the full presentation via gws slides, collects metadata from the user, and generates a properly formatted markdown file.

Constants

• psd401.ai repo: /Users/hagelk/non-ic-code/psd401.ai
• Presentations dir: /Users/hagelk/non-ic-code/psd401.ai/src/content/presentations/
• Thumbnails dir: /Users/hagelk/non-ic-code/psd401.ai/public/images/thumbnails/

Workflow

Process each presentation URL the user provides. After each one, ask if they have more. When done, commit and push.

Step 1: Parse the Google Slides URL

Extract the presentation ID from the user-provided URL argument ($ARGUMENTS).

Supported URL formats:

• https://docs.google.com/presentation/d/PRESENTATION_ID/edit → extract PRESENTATION_ID
• https://docs.google.com/presentation/d/PRESENTATION_ID/pub → extract PRESENTATION_ID
• https://docs.google.com/presentation/d/e/2PACX-.../pub → this is a published URL; extract the 2PACX-... portion after /e/
• Just a bare presentation ID

Validate the extracted ID is non-empty. If no URL was provided, ask the user for one.

Step 2: Read the Presentation Content

Run:

gws slides presentations get --params '{"presentationId": "PRESENTATION_ID"}' --format json

Parse the JSON response to extract:

• Title: from title field at the top level
• All slide text: walk slides[].pageElements[].shape.text.textElements[].textRun.content and concatenate
• Speaker notes: from slides[].slideProperties.notesPage.pageElements[].shape.text.textElements[].textRun.content

If gws fails with an auth error, tell the user:

Auth issue detected. Run: gws auth login -s slides,drive
Then try again.

Step 3: Ask User for Metadata

Use AskUserQuestion to collect all metadata in a single prompt. Show the extracted title as a default. Ask for:

I extracted the presentation content. Here's what I need from you:

**Title**: {extracted_title} (press Enter to keep, or type a new one)
**Date** the presentation was/will be given (YYYY-MM-DD):
**Presenters** (comma-separated names):
**Audience** (e.g., "PSD Community", "PSD Staff", "WTA Conference", "WSSDA Conference"):
**Type** (e.g., "School Board Presentation", "Public Workshop", "PD Session", "Conference Session"):
**Description** (1-2 sentences — or type "auto" and I'll generate one from the content):
**Slug** (kebab-case filename, suggested: {auto_slug}) — press Enter to accept or type a new one: