QuickReference

Publisher promotes any /... page hierarchy to production by copying it without the /Development prefix so work-in-progress stays isolated.

Every text-based attachment is rewritten so `"/"` links become live paths, and optional rules in `development-translation.sjs` can further transform each file.

Practice publishes generate release notes plus a deletions script preview without touching the live site; the real publish copies files and appends removal commands into `process-deletions.sjs` for manual execution.

Actions

• Check for Page Differences – Compares timestamps and hashes between the /Development tree and its published counterpart so you can see what will change.
• Reverse Publish – Copies the published page back into /Development to recover live edits or restart from a known-good state.
• Publish Page (practice) – Runs the full translation/diff pipeline, writes detailed release notes, but skips copying so you can verify the impact.
• Publish Page (for real) – Performs the same checks and then copies the files, applies path rewrites, generates release notes, and refreshes the published page.

Special files

• development-translation.sjs – Optional script invoked per text file; receives the file contents as `data` and must return the transformed string.
• publish-config.json – JSON blob for exclusions, e.g. `{"excludedFiles":"do-not-publish.me"}`; also expands the standard exclusion list.
• do-not-release.txt – Presence blocks publishing and should describe why the page is locked.
• process-deletions.sjs – Auto-generated script listing live files to delete after you verify them; run manually once you are satisfied.
• release-notes.html.fragment – Captures the accordion-style log of each publish run for auditing.

Usage tips

• Publish from the root /... page you want to release; sub pages are handled automatically.
• Always inspect the practice-mode release notes before running the real publish so you catch unexpected deletions or TODO markers.
• Keep the generated deletions script in source control (or review it) before executing so you have an audit trail of removed files.