thePR0M3TH3ANandClaude Opus 4.7
23a16c8e89
Adds a 📖 Docs link to the sidebar footer (next to GitHub + artstr.org) that opens a Read-the-Docs-style two-pane modal: topic sidebar on the left, rendered markdown on the right. Content (src/help/*.md, 11 files): - index.md — overview + nav - template.md — Template tab explainer - designer.md — Designer tab explainer - cover.md — Case cover wrap - disc.md — Disc-label sheet - jewel.md — Jewel-case insert - customart.md — Custom art - slide.md — Slide - deck.md — Slide deck - pixelart.md — Pixel art - book.md — Book Designer (links out to the deeper BOOK_DESIGNER_TUTORIAL.md + spec on GitHub) Implementation: - _DOCS_TOPICS registry maps slug → { title, group, file }. Sidebar groups headings under "Start here", "App tabs", "Template-mode layouts". - loadDocsTopic(slug) fetches `help/<slug>.md` (force-cache), renders via the already-vendored marked, caches the rendered HTML for session-instant re-visits, and updates the URL hash via history.replaceState so deep links work. - #/help/<slug> hash route auto-opens the modal at that topic on page load + on hashchange. - Esc closes; backdrop click closes; internal `#/help/foo` links in page content load via the dispatcher (no page bounce); external http(s) links get target="_blank" + noopener. Styling: - Inherits the rest of the modal aesthetic (var(--line), var(--accent), system font for chrome, Georgia serif for body text). Dark-mode-aware backdrops on code / blockquote / table blocks. - Two-pane layout collapses to a narrower sidebar on <720px viewports. Files live in src/help/ (not docs/) because Vercel's outputDirectory is "src" — the production site only serves files under src/. The canonical deeper docs (BOOK_DESIGNER_TUTORIAL, FEATURE specs) stay in docs/ and are linked-out from the in-app pages. Co-Authored-By: Claude Opus 4.7 <[email protected]>
4.2 KiB
Book
Multi-page reflowable book with cover, designed pages, reflow chapters, masters, PDF export, and full-screen Reader Mode.
Hands-on walkthrough: see
BOOK_DESIGNER_TUTORIAL.md. Spec: seeBOOK_DESIGNER_FEATURE.md.
Starting
When you enter Book mode with no pages, four starter cards appear (US Trade / A5 / A4 / Square). Clicking one seeds a default master with a text-frame, a starter chapter, and a Title page.
A 5th card appears when you have a slide deck loaded — Convert deck to book turns each slide into a designed page (letterbox-fit into the trim).
The two main views
- Pages overview — every manifest entry as a tile (designed pages + reflow chapters). Drag to reorder. Hover for per-tile actions (proof PDF, duplicate, delete, master picker).
- Cover — wraparound spread editor. Front / spine / back panels selected via the layer-target dropdown.
Plus two per-entry views:
- Designed page editor — same flat-canvas tools as Custom Art,
scoped to one
book-page:<id>target. Master layers render underneath at 55% opacity. - Chapter editor — markdown-on-left, paginated preview on right. CodeMirror with markdown syntax + smart Enter for list continuation.
Masters
Reusable underlays. A master with a text-frame layer becomes a valid reflow target — the chapter's prose flows into that frame. Header / footer text on the master can use tokens that resolve per page:
{page-number},{page-count},{physical-page-count}{book-title},{book-author}{chapter-title},{chapter-number}
Markdown features in chapters
- GFM headings / lists / blockquotes / code / tables / task lists.
- Nested lists (up to depth 6).
[^N]footnote refs +[^N]: definitionfor footnote bodies (renders as Unicode superscript + chapter-end Footnotes section).^[term]invisible index markers.[link text](#chapter-3)cross-references — auto-appended with(p. N)at render time.- Magic tokens on their own line:
{toc}— auto-generated table of contents with page numbers.{index}— alphabetical index of every^[term]marker.
Publishing
Sidecar-architecture: each surface publishes as its own Nostr event.
| Surface | Event | d-tag |
|---|---|---|
| Designed page | kind-30078 casewrap-page (role: 'interior') |
book-page:<entry-id> |
| Master | kind-30078 casewrap-page (role: 'master') |
book-master:<master-id> |
| Cover | kind-30078 casewrap-page (role: 'cover-spread') |
book-cover:<title-slug> |
| Chapter (public) | kind-30023 NIP-23 article | chapter:<title-slug> |
| Chapter (private) | kind-30078 encrypted envelope | book-chapter:<entry-id> |
| Manifest | kind-30078 casewrap-book |
book:<title-slug> |
The manifest references its sidecars via {kind, pubkey, dTag}
coords + emits matching link tags so external clients can
resolve them.
Publish each surface first (via the per-editor Publish buttons), then the manifest (top-bar Publish).
Private path
Toggle the sidebar 🔒 Private chip. Every subsequent publish (manifest + sidecars) goes through the encrypted envelope path (AES-256-GCM, key wrapped to your own pubkey via NIP-44 / NIP-04). Re-opens decrypt automatically.
Reader Mode + embed
- ▶ Read opens a full-screen page-flip viewer with TOC sidebar, keyboard nav, click-to-flip, and prefetch.
- The published manifest's
naddrworks in the embed iframe via?book=<naddr>(cut-down Reader Mode without TOC).
PDF export
The Export PDF… modal exposes:
- Page range (All / from–to).
- Include cover spread.
- Include bleed margin.
- Crop marks (L-marks at trim corners).
- Single vs split output (interior + cover separate).
- Filename pattern.
Reflowed prose using Times / Helvetica / Courier-family fonts emits as real PDF text (vector, selectable, searchable). Other fonts fall back to vector raster + warning.
📄 Proof PDF in any editor toolbar exports just that single page / chapter — useful for a printer paper-and-colour proof before committing to the full book.