The man was a stranger

Branch: refs/heads/main Home: https://github.com/dreamwidth/dreamwidth Commit: e99dca7ebc7913a29891f49c248a54c5454d9cdb https://github.com/dreamwidth/dreamwidth/commit/e99dca7ebc7913a29891f49c248a54c5454d9cdb Author: Mark Smith mark@dreamwidth.org Date: 2026-06-10 (Wed, 10 Jun 2026)

Changed paths: M doc/BML-MIGRATION.md

Log Message:

Update the BML→TT migration guide for the Foundation-restyle era (#3583)

• Update the BML→TT migration guide for the Foundation-restyle era

Replace the "no visible change" scope rule with the current one (faithful behavior, markup restyled to Foundation, validated with before/after screenshots) and document the patterns and gotchas learned from the /tools/memories and /manage/moodthemes conversions: Foundation grid/button recipes, form.checkbox semantics, recursive BLOCK/INCLUDE templates, extracting inline head JS to htdocs/js (and the build-static.sh concat-URL gotcha), ML keys referenced from shared Perl modules, porting-time hardening wins, per-worker cache staleness during live testing, and a new §13 on taking and embedding screenshots with bin/dev/screenshot.

Co-Authored-By: Claude Opus 4.8 noreply@anthropic.com

• Fix inaccuracies found while auditing the migration guide

Verified every claim in the guide against the code; three were wrong or stale. The cheatsheet said error.tt takes a string-or-arrayref message, but the template prints [% message %] raw, so an arrayref renders as ARRAY(0x…). The deadphrases section predated the texttool changes: strings now auto-load from shipped .text files (no load step), and deadphrases.dat is applied by the explicit texttool.pl deadphrases command, not by load. And site.root / site.imgroot are not defined in the site.* constants namespace at all — they silently render as empty strings, which happens to produce working root-relative URLs; the guide now says so instead of presenting them as real values. Also points at t/ml.t from the pre-push checklist.

Co-Authored-By: Claude Opus 4.8 noreply@anthropic.com

• Correct the site.root note: real per-request value, empty only in dev

The previous commit claimed site.root / site.imgroot are undefined and render as empty strings. Wrong: the site.* namespace has two sources -- static keys are compile-time constants ($site_constants), and root, imgroot, jsroot, shoproot, and statroot are set per-request by DW::Template::Plugin (unresolvable constants-namespace keys defer to a runtime stash lookup, which finds the plugin's hash). They only render empty in the dev container because the dev config blanks $LJ::SITEROOT et al; on production site.root is the absolute base URL.

Co-Authored-By: Claude Opus 4.8 noreply@anthropic.com

Branch: refs/heads/main Home: https://github.com/dreamwidth/dreamwidth Commit: 383328592e5c59c4dfad94b7d49bda6807aa5dc9 https://github.com/dreamwidth/dreamwidth/commit/383328592e5c59c4dfad94b7d49bda6807aa5dc9 Author: Mark Smith mark@dreamwidth.org Date: 2026-06-10 (Wed, 10 Jun 2026)

Changed paths: A .claude/skills/screenshot-dev-page/SKILL.md A bin/dev/screenshot A bin/dev/screenshot.js

Log Message:

Add bin/dev/screenshot dev-server screenshot tool + skill (#3578)

bin/dev/screenshot renders a page from the local Starman dev server to a PNG with headless Google Chrome, for visually checking how a change looks (e.g. after a BML->TT migration). It self-bootstraps on first run: installs Chrome from Google's signed apt repo (per the packaging policy) and puppeteer-core into /opt/dw-screenshot, ensures Starman is up (--restart to pick up new routes), optionally logs in via /mobile/login (--user/--password) to capture authenticated pages, and writes a full-page PNG. bin/dev/screenshot.js is the puppeteer driver. Neither is .pl/.pm/.t so they're outside tidyall/00-compile.

.claude/skills/screenshot-dev-page documents the workflow for future sessions (run inside the devcontainer via docker exec, copy the PNG out, the Starman-restart and auth gotchas).

Co-authored-by: Claude Opus 4.8 noreply@anthropic.com

To unsubscribe from these emails, change your notification settings at https://github.com/dreamwidth/dreamwidth/settings/notifications