mirror of
https://github.com/dong-nz/cv.git
synced 2026-11-22 16:10:40 +07:00
video: point explanations at the diagram, extend scenes for readable dwell
Explanations become Callout chips (kit.tsx): a leader line draws from the target element, the chip fades in only after the line completes, timed to the scene beat. The fixed bottom bullet row in SceneChrome is deleted. Leaders stop at element outer edges; chips sit fully outside each visual group (Pipeline push callout narrowed clear of the group box). Timeline 62s -> 81s (2425 frames): every callout holds >=150 frames after it appears; scene beats unchanged, hold time added at each scene end. .vtt cue times, EN+VI chapter times, README take minimums (24s/17s) and spec-v7 scene table, no-overlap and dwell rules follow the new boundaries. Re-rendered public/media/how-it-works.mp4.
This commit is contained in:
1 parent
aad36e38fc
commit
e02fe19bbe
13 files changed
+209
-100
No files matched your search
@@ -18,20 +18,20 @@ Decisions (owner-approved 2026-10-28):
|
||||
|
||||
`video/` is a standalone pnpm workspace member (Remotion 4 + React 19 + zod 4). The SPA never imports it; its only output is the committed media in `public/media/`.
|
||||
|
||||
- 1920×1080 @ 30 fps, 1860 frames = **62 s**, H.264 CRF 23 → 1.5 MB, `+faststart` via Remotion defaults.
|
||||
- 1920×1080 @ 30 fps, 2425 frames = **81 s**, H.264 CRF 23 → 1.5 MB, `+faststart` via Remotion defaults. (Extended from 62 s 2026-10-29: every callout chip must hold ≥150 frames / 5 s after it finishes appearing — the 62 s cut switched scenes while text was still mid-read.)
|
||||
- Visual language mirrors the site's dark palette (`src/index.css` `:root` values copied into `video/src/theme.ts` — the project cannot import site CSS).
|
||||
- Timeline source of truth: `video/src/timeline.ts` (`SCENES`). The chapter list in the `howItWorks` UI group and both `.vtt` tracks mirror these boundaries; changing the timeline means updating all four.
|
||||
|
||||
|Scene|Frames|Seconds|Content|
|
||||
|---|---|---|---|
|
||||
|Title|0–165|0–5.5|"This site's CMS is a git repository."|
|
||||
|DataLayer|165–420|5.5–14|Structure documents + per-language dictionaries + manifests → joined once at build time → bilingual rendered page|
|
||||
|LiveEdit|420–960|14–32|`?edit` typed into the URL → Basic-auth dialog → inline heading edit → save bar: PUT contents/projects.json, commit on branch, 409 → three-way rebase|
|
||||
|GitStorage|960–1290|32–43|Repository file tree with the edited JSON highlighted, commit diff card, master/preview-branch graph, `?edit=preview`, merge = publish|
|
||||
|Pipeline|1290–1650|43–55|push → master → GitHub Actions group box (named on screen: `GitHub Actions · .github/workflows/deploy.yml`) → build · resume · deploy cards reached strictly in order — each connector draws only after the previous card has appeared, its arrowhead only after its line completes — then a downward arrow from the deploy job to the updated live page; infra guard card (deploy-infra.yml) follows the deploy beat|
|
||||
|Outro|1650–1860|55–62|"Edit on the live site. Stored in git. Live on merge to master."|
|
||||
|DataLayer|165–585|5.5–19.5|Structure documents + per-language dictionaries + manifests → joined once at build time → bilingual rendered page; callouts on the manifests rule and the same-components bilingual render|
|
||||
|LiveEdit|585–1285|19.5–42.8|`?edit` typed into the URL → Basic-auth dialog → inline heading edit → save bar: PUT contents/projects.json, commit on branch, 409 → three-way rebase; four callouts point at URL bar, auth gate, pencil control, save bar|
|
||||
|GitStorage|1285–1705|42.8–56.8|Repository file tree with the edited JSON highlighted, commit diff card, master/preview-branch graph, `?edit=preview`, merge = publish; callouts on JSON-in-repo, the preview branch node, history/rollback|
|
||||
|Pipeline|1705–2215|56.8–73.8|push → master → GitHub Actions group box (named on screen: `GitHub Actions · .github/workflows/deploy.yml`) → build · resume · deploy cards reached strictly in order — each connector draws only after the previous card has appeared, its arrowhead only after its line completes — then a downward arrow from the deploy job to the updated live page; infra guard card (deploy-infra.yml) follows the deploy beat; callouts on push-as-publish-button and the live-site result|
|
||||
|Outro|2215–2425|73.8–80.8|"Edit on the live site. Stored in git. Live on merge to master."|
|
||||
|
||||
**Scene composition** (reviewed 2026-10-28 from rendered stills; the first render hugged every diagram to the right edge): each scene's visual group is centered on x=960 inside a strict band — title row y 80–175 (left), visual band y ~200–760 (centered), bullet row y 790+ (left). The four groups span x 420–1500 (DataLayer), 580–1340 (LiveEdit stage), 480–1410 (GitStorage), 449–1471 (Pipeline: push card + GitHub Actions group box). Same review fixed: absolute stage anchors in LiveEdit wrapped by a positioned div, never by `Fade` (Fade's `transform` becomes the containing block and anchors them after the skeleton); repository tree rows at 14px so no line wraps or overflows the panel; the "merge = publish" badge moved clear of the merge curve; the infra card widened to 440px. A second review (same day) applied a strict chain rule to every scene with connectors — DataLayer, GitStorage, Pipeline: an element appears only after the connector that reaches it has finished drawing, and an arrowhead appears only after its own line completes. `markerEnd` is gated on the stroke being ≥90 % drawn (SVG renders `markerEnd` even at full dash offset, so ungated heads floated in the air before their lines); GitStorage's branch/merge node circles are gated with `appear()` on their curve completing (master line and its node stay static — the published base predates the edit); DataLayer re-timed to documents → arrows → join panel → browser; Pipeline's three job cards sit in a dashed group box naming the runner on screen, `GitHub Actions · .github/workflows/deploy.yml`, and both caption tracks name the GitHub Actions pipeline in that scene's cue. Verified beat-by-beat from rendered stills.
|
||||
**Scene composition** (reviewed 2026-10-28 from rendered stills; the first render hugged every diagram to the right edge): each scene's visual group is centered on x=960 inside a strict band — title row y 80–175 (left), visual band y ~200–760 (centered). **Explanations are `Callout` chips that point at the diagram element they explain** (kit.tsx): a leader line draws from the element, the chip fades in only after the line completes, and the callout is timed to its beat — so every explanation follows the diagram in order instead of sitting in a fixed bottom text row; the old `SceneChrome` bullet row is deleted. **No-overlap rule** (2026-10-29 review): a leader line ends at the target element's outer edge — it never crosses into a panel, card or stage — and a chip sits fully outside its scene's visual-group bounding box (Pipeline's push callout narrowed to 230px so it clears the group box at x 689; LiveEdit's URL-bar and pencil leaders now stop at the stage border at x 1342 / 578). Two callouts per scene minimum (DataLayer: manifests rule → browser "same components, both languages"; LiveEdit: `?edit` URL → auth gate → inline-edit pencil → save-as-commit; GitStorage: JSON-in-repo → branch node → history/rollback; Pipeline: push-is-the-publish-button → live-site receipt). The four groups span x 420–1500 (DataLayer), 580–1340 (LiveEdit stage), 480–1410 (GitStorage), 449–1471 (Pipeline: push card + GitHub Actions group box). Same review fixed: absolute stage anchors in LiveEdit wrapped by a positioned div, never by `Fade` (Fade's `transform` becomes the containing block and anchors them after the skeleton); repository tree rows at 14px so no line wraps or overflows the panel; the "merge = publish" badge moved clear of the merge curve; the infra card widened to 440px. A second review (same day) applied a strict chain rule to every scene with connectors — DataLayer, GitStorage, Pipeline: an element appears only after the connector that reaches it has finished drawing, and an arrowhead appears only after its own line completes. `markerEnd` is gated on the stroke being ≥90 % drawn (SVG renders `markerEnd` even at full dash offset, so ungated heads floated in the air before their lines); GitStorage's branch/merge node circles are gated with `appear()` on their curve completing (master line and its node stay static — the published base predates the edit); DataLayer re-timed to documents → arrows → join panel → browser; Pipeline's three job cards sit in a dashed group box naming the runner on screen, `GitHub Actions · .github/workflows/deploy.yml`, and both caption tracks name the GitHub Actions pipeline in that scene's cue. Verified beat-by-beat from rendered stills.
|
||||
|
||||
## 3. Render commands
|
||||
|
||||
@@ -65,7 +65,7 @@ pnpm --dir video render-captured # with video/inputs/take-*.mp4 present (§6)
|
||||
|
||||
## 6. Captured variant (open, owner-side)
|
||||
|
||||
`video/captured.json` + `--propsFile` flips the LiveEdit and Pipeline stages from animated mocks to real screen recordings (`video/inputs/take-edit.mp4` ≥18 s, `take-pipeline.mp4` ≥12 s; recording instructions in `video/README.md`). The composition is complete; only the two takes are owner-supplied raw material. Re-render afterwards and commit the new MP4.
|
||||
`video/captured.json` + `--propsFile` flips the LiveEdit and Pipeline stages from animated mocks to real screen recordings (`video/inputs/take-edit.mp4` ≥24 s, `take-pipeline.mp4` ≥17 s — each take must cover its now-longer stage; recording instructions in `video/README.md`). The composition is complete; only the two takes are owner-supplied raw material. Re-render afterwards and commit the new MP4.
|
||||
|
||||
## 7. Known limits
|
||||
|
||||
|
||||
@@ -3,17 +3,17 @@ WEBVTT
|
||||
00:00:00.000 --> 00:00:05.400
|
||||
This site's CMS is a git repository.
|
||||
|
||||
00:00:05.500 --> 00:00:13.900
|
||||
00:00:05.500 --> 00:00:19.400
|
||||
Everything the site shows is a JSON document: structure documents, per-language dictionaries and field manifests — joined once at build time.
|
||||
|
||||
00:00:14.000 --> 00:00:31.900
|
||||
00:00:19.500 --> 00:00:42.700
|
||||
?edit turns the live site into the editor. HTTP Basic at the nginx proxy is the only gate; every save is a commit through the GitHub Contents API.
|
||||
|
||||
00:00:32.000 --> 00:00:42.900
|
||||
00:00:42.800 --> 00:00:56.700
|
||||
Content lives as JSON in the repository: branches are previews, and merging to master publishes.
|
||||
|
||||
00:00:43.000 --> 00:00:54.900
|
||||
00:00:56.800 --> 00:01:13.700
|
||||
Merging to master runs the GitHub Actions pipeline — build, resume PDFs, deploy — from commit to live in minutes.
|
||||
|
||||
00:00:55.000 --> 00:01:02.000
|
||||
00:01:13.800 --> 00:01:20.800
|
||||
Edit on the live site. Stored in git. Live on merge to master.
|
||||
Binary file not shown.
@@ -3,17 +3,17 @@ WEBVTT
|
||||
00:00:00.000 --> 00:00:05.400
|
||||
Hệ thống quản trị nội dung của trang này chính là một repository git.
|
||||
|
||||
00:00:05.500 --> 00:00:13.900
|
||||
00:00:05.500 --> 00:00:19.400
|
||||
Mọi thứ trang hiển thị đều là tài liệu JSON: cấu trúc, từ điển theo từng ngôn ngữ và manifest trường — ghép một lần lúc build.
|
||||
|
||||
00:00:14.000 --> 00:00:31.900
|
||||
00:00:19.500 --> 00:00:42.700
|
||||
?edit biến chính trang đang xem thành trình soạn thảo. HTTP Basic ở nginx là cánh cửa duy nhất; mỗi lần lưu là một commit qua GitHub Contents API.
|
||||
|
||||
00:00:32.000 --> 00:00:42.900
|
||||
00:00:42.800 --> 00:00:56.700
|
||||
Nội dung nằm trong repository dưới dạng JSON: nhánh là bản xem trước, merge vào master là công bố.
|
||||
|
||||
00:00:43.000 --> 00:00:54.900
|
||||
00:00:56.800 --> 00:01:13.700
|
||||
Merge vào master chạy pipeline GitHub Actions — build, tạo resume PDF, triển khai — từ commit đến khi live chỉ vài phút.
|
||||
|
||||
00:00:55.000 --> 00:01:02.000
|
||||
00:01:13.800 --> 00:01:20.800
|
||||
Sửa ngay trên trang thật. Lưu trong git. Live khi merge vào master.
|
||||
@@ -21,9 +21,9 @@
|
||||
"chapters": [
|
||||
{ "time": "0:00", "label": "Intro" },
|
||||
{ "time": "0:05", "label": "Content as documents" },
|
||||
{ "time": "0:14", "label": "Live editing" },
|
||||
{ "time": "0:32", "label": "Git as the content store" },
|
||||
{ "time": "0:43", "label": "Automatic deployment" },
|
||||
{ "time": "0:55", "label": "Closing" }
|
||||
{ "time": "0:19", "label": "Live editing" },
|
||||
{ "time": "0:42", "label": "Git as the content store" },
|
||||
{ "time": "0:56", "label": "Automatic deployment" },
|
||||
{ "time": "1:13", "label": "Closing" }
|
||||
]
|
||||
}
|
||||
@@ -21,9 +21,9 @@
|
||||
"chapters": [
|
||||
{ "time": "0:00", "label": "Giới thiệu" },
|
||||
{ "time": "0:05", "label": "Nội dung là tài liệu JSON" },
|
||||
{ "time": "0:14", "label": "Chỉnh sửa trực tiếp" },
|
||||
{ "time": "0:32", "label": "Git là kho nội dung" },
|
||||
{ "time": "0:43", "label": "Triển khai tự động" },
|
||||
{ "time": "0:55", "label": "Kết" }
|
||||
{ "time": "0:19", "label": "Chỉnh sửa trực tiếp" },
|
||||
{ "time": "0:42", "label": "Git là kho nội dung" },
|
||||
{ "time": "0:56", "label": "Triển khai tự động" },
|
||||
{ "time": "1:13", "label": "Kết" }
|
||||
]
|
||||
}
|
||||
+8
-6
@@ -22,8 +22,8 @@ screen recorder:
|
||||
|
||||
| File (drop into `video/inputs/`) | Beat | Minimum length |
|
||||
|---|---|---|
|
||||
| `take-edit.mp4` | open the live site → append `?edit` → Basic-auth sign-in → edit one heading inline → Save | 18 s |
|
||||
| `take-pipeline.mp4` | GitHub Actions run: build → generate-resume → deploy, then the updated live page | 12 s |
|
||||
| `take-edit.mp4` | open the live site → append `?edit` → Basic-auth sign-in → edit one heading inline → Save | 24 s |
|
||||
| `take-pipeline.mp4` | GitHub Actions run: build → generate-resume → deploy, then the updated live page | 17 s |
|
||||
|
||||
Record at 1920×1080, browser zoom 100%, dark theme. Trim so each take starts
|
||||
clean (no cursor scrubbing). Then:
|
||||
@@ -34,8 +34,10 @@ pnpm --dir video render-captured
|
||||
|
||||
Raw takes are gitignored — the rendered MP4 is the committed artifact.
|
||||
|
||||
## Timeline (source of truth: `src/Explainer.tsx`)
|
||||
## Timeline (source of truth: `src/timeline.ts`)
|
||||
|
||||
30 fps · 1860 frames · 62 s. Scene boundaries drive the chapter list and the
|
||||
`.vtt` caption tracks in `public/media/` — if the timeline changes, those and
|
||||
the `howItWorks` UI group's chapters must change with it.
|
||||
30 fps · 2425 frames · 81 s. Scene durations include ≥5 s of hold time after
|
||||
the last callout so every on-screen explanation is readable before the cut.
|
||||
Scene boundaries drive the chapter list and the `.vtt` caption tracks in
|
||||
`public/media/` — if the timeline changes, those and the `howItWorks` UI
|
||||
group's chapters (EN + VI) must change with it.
|
||||
+54
-17
@@ -1,6 +1,6 @@
|
||||
import React from 'react';
|
||||
import { useCurrentFrame } from 'remotion';
|
||||
import { appear } from './motion';
|
||||
import { appear, drawIn } from './motion';
|
||||
import { theme } from './theme';
|
||||
|
||||
export const Fade: React.FC<{ start: number; y?: number; children: React.ReactNode }> = ({
|
||||
@@ -15,13 +15,7 @@ export const Fade: React.FC<{ start: number; y?: number; children: React.ReactNo
|
||||
);
|
||||
};
|
||||
|
||||
export const SceneChrome: React.FC<{
|
||||
index: string;
|
||||
title: string;
|
||||
bullets: string[];
|
||||
bulletStart?: number;
|
||||
}> = ({ index, title, bullets, bulletStart = 60 }) => (
|
||||
<>
|
||||
export const SceneChrome: React.FC<{ index: string; title: string }> = ({ index, title }) => (
|
||||
<div style={{ position: 'absolute', top: 80, left: 120 }}>
|
||||
<Fade start={4}>
|
||||
<div style={{ fontSize: 20, letterSpacing: '0.22em', color: theme.accent }}>{index}</div>
|
||||
@@ -32,18 +26,61 @@ export const SceneChrome: React.FC<{
|
||||
</div>
|
||||
</Fade>
|
||||
</div>
|
||||
<div style={{ position: 'absolute', left: 120, bottom: 90, maxWidth: 700 }}>
|
||||
{bullets.map((b, i) => (
|
||||
<Fade key={i} start={bulletStart + i * 40}>
|
||||
<div style={{ display: 'flex', gap: 14, marginBottom: 16 }}>
|
||||
<span style={{ color: theme.accent, fontSize: 22, lineHeight: 1.45 }}>▸</span>
|
||||
<span style={{ fontSize: 23, color: theme.textSecondary, lineHeight: 1.45 }}>{b}</span>
|
||||
</div>
|
||||
</Fade>
|
||||
))}
|
||||
);
|
||||
|
||||
// A callout that points at a diagram element: the leader line draws only after
|
||||
// the target has appeared, and the chip only after the line completes — the
|
||||
// scene's explanations therefore follow the diagram beat by beat instead of
|
||||
// sitting in a fixed text row. `target` is the anchor on the element, `anchor`
|
||||
// the chip-side end of the line.
|
||||
export const Callout: React.FC<{
|
||||
target: [number, number];
|
||||
anchor: [number, number];
|
||||
chip: { x: number; y: number; width: number };
|
||||
start: number;
|
||||
accent?: boolean;
|
||||
children: string;
|
||||
}> = ({ target, anchor, chip, start, accent, children }) => {
|
||||
const frame = useCurrentFrame();
|
||||
const line = drawIn(frame, start, 12);
|
||||
const chipOn = appear(frame, start + 12);
|
||||
return (
|
||||
<>
|
||||
<svg width={1920} height={1080} style={{ position: 'absolute', inset: 0, pointerEvents: 'none' }}>
|
||||
<line
|
||||
x1={target[0]}
|
||||
y1={target[1]}
|
||||
x2={anchor[0]}
|
||||
y2={anchor[1]}
|
||||
stroke={accent ? theme.accent : theme.borderStrong}
|
||||
strokeWidth={1.5}
|
||||
pathLength={1}
|
||||
strokeDasharray={1}
|
||||
strokeDashoffset={line}
|
||||
/>
|
||||
</svg>
|
||||
<div
|
||||
style={{
|
||||
position: 'absolute',
|
||||
left: chip.x,
|
||||
top: chip.y,
|
||||
width: chip.width,
|
||||
opacity: chipOn,
|
||||
transform: `translateY(${(1 - chipOn) * 10}px)`,
|
||||
background: theme.surface,
|
||||
border: `1px solid ${accent ? theme.accent : theme.borderStrong}`,
|
||||
borderRadius: 8,
|
||||
padding: '8px 12px',
|
||||
fontSize: 15,
|
||||
color: theme.textSecondary,
|
||||
lineHeight: 1.45,
|
||||
}}
|
||||
>
|
||||
{children}
|
||||
</div>
|
||||
</>
|
||||
);
|
||||
};
|
||||
|
||||
export const Panel: React.FC<{
|
||||
width: number;
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
import React from 'react';
|
||||
import { AbsoluteFill, interpolate, useCurrentFrame } from 'remotion';
|
||||
import { ArrowDefs, BrowserFrame, Fade, Label, Mono, PageSkeleton, Panel, SceneBackground, SceneChrome } from '../kit';
|
||||
import { ArrowDefs, BrowserFrame, Callout, Fade, Label, Mono, PageSkeleton, Panel, SceneBackground, SceneChrome } from '../kit';
|
||||
import { appear, drawIn } from '../motion';
|
||||
import { theme } from '../theme';
|
||||
|
||||
@@ -22,16 +22,7 @@ export const DataLayer: React.FC = () => {
|
||||
return (
|
||||
<AbsoluteFill style={{ background: theme.bg, fontFamily: theme.sans }}>
|
||||
<SceneBackground />
|
||||
<SceneChrome
|
||||
index="01 · CONTENT AS DOCUMENTS"
|
||||
title="Everything the site shows is a JSON document"
|
||||
bullets={[
|
||||
'Structure documents — language-neutral ids and order',
|
||||
'Per-language dictionaries — EN and VI text, joined at build time',
|
||||
'Field manifests — a missing key fails the build, never the page',
|
||||
]}
|
||||
bulletStart={70}
|
||||
/>
|
||||
<SceneChrome index="01 · CONTENT AS DOCUMENTS" title="Everything the site shows is a JSON document" />
|
||||
|
||||
{DOCS.map((d, i) => (
|
||||
<Fade key={d.path} start={30 + i * 28} y={22}>
|
||||
@@ -112,6 +103,25 @@ export const DataLayer: React.FC = () => {
|
||||
<div style={{ position: 'absolute', left: 0, right: 0, bottom: 0, height: 3, background: theme.accent, opacity: pageOn }} />
|
||||
</BrowserFrame>
|
||||
</Fade>
|
||||
|
||||
<Callout
|
||||
target={[600, 672]}
|
||||
anchor={[600, 693]}
|
||||
chip={{ x: 420, y: 695, width: 380 }}
|
||||
start={110}
|
||||
>
|
||||
Field manifests claim every field a page renders — a missing key fails the build, never a silent half-render.
|
||||
</Callout>
|
||||
|
||||
<Callout
|
||||
target={[1502, 350]}
|
||||
anchor={[1537, 340]}
|
||||
chip={{ x: 1540, y: 315, width: 340 }}
|
||||
start={200}
|
||||
accent
|
||||
>
|
||||
EN and VI render through the same components — the join happened once, at build time.
|
||||
</Callout>
|
||||
</AbsoluteFill>
|
||||
);
|
||||
};
|
||||
@@ -1,6 +1,6 @@
|
||||
import React from 'react';
|
||||
import { AbsoluteFill, interpolate, useCurrentFrame } from 'remotion';
|
||||
import { ArrowDefs, Fade, Label, Mono, Panel, SceneBackground, SceneChrome } from '../kit';
|
||||
import { ArrowDefs, Callout, Fade, Label, Mono, Panel, SceneBackground, SceneChrome } from '../kit';
|
||||
import { appear, drawIn } from '../motion';
|
||||
import { theme } from '../theme';
|
||||
|
||||
@@ -25,16 +25,7 @@ export const GitStorage: React.FC = () => {
|
||||
return (
|
||||
<AbsoluteFill style={{ background: theme.bg, fontFamily: theme.sans }}>
|
||||
<SceneBackground />
|
||||
<SceneChrome
|
||||
index="03 · GIT AS THE STORAGE"
|
||||
title="A content edit is a file edit"
|
||||
bullets={[
|
||||
'Drafts live on a branch; master stays the published site',
|
||||
'A branch preview is a URL: ?edit=preview',
|
||||
'History, review and rollback come from git, free of charge',
|
||||
]}
|
||||
bulletStart={70}
|
||||
/>
|
||||
<SceneChrome index="03 · GIT AS THE STORAGE" title="A content edit is a file edit" />
|
||||
|
||||
<Panel width={470} style={{ left: 480, top: 200 }}>
|
||||
<div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'baseline' }}>
|
||||
@@ -129,6 +120,34 @@ export const GitStorage: React.FC = () => {
|
||||
</span>
|
||||
</div>
|
||||
</Fade>
|
||||
|
||||
<Callout
|
||||
target={[478, 300]}
|
||||
anchor={[455, 262]}
|
||||
chip={{ x: 130, y: 230, width: 320 }}
|
||||
start={40}
|
||||
>
|
||||
Content is plain JSON documents in the repository — no database, no admin panel.
|
||||
</Callout>
|
||||
|
||||
<Callout
|
||||
target={[1253, 460]}
|
||||
anchor={[1447, 435]}
|
||||
chip={{ x: 1450, y: 400, width: 340 }}
|
||||
start={110}
|
||||
accent
|
||||
>
|
||||
Drafts live on a branch — ?edit=preview opens the same site on that branch.
|
||||
</Callout>
|
||||
|
||||
<Callout
|
||||
target={[700, 655]}
|
||||
anchor={[700, 685]}
|
||||
chip={{ x: 480, y: 690, width: 380 }}
|
||||
start={125}
|
||||
>
|
||||
History, review and rollback come from git, free of charge.
|
||||
</Callout>
|
||||
</AbsoluteFill>
|
||||
);
|
||||
};
|
||||
@@ -1,6 +1,6 @@
|
||||
import React from 'react';
|
||||
import { AbsoluteFill, OffthreadVideo, staticFile, useCurrentFrame } from 'remotion';
|
||||
import { BrowserFrame, Fade, Label, Mono, PageSkeleton, SceneBackground, SceneChrome } from '../kit';
|
||||
import { BrowserFrame, Callout, Fade, Label, Mono, PageSkeleton, SceneBackground, SceneChrome } from '../kit';
|
||||
import { appear, typed } from '../motion';
|
||||
import { theme } from '../theme';
|
||||
|
||||
@@ -46,17 +46,7 @@ export const LiveEdit: React.FC<{ captured: boolean }> = ({ captured }) => {
|
||||
return (
|
||||
<AbsoluteFill style={{ background: theme.bg, fontFamily: theme.sans }}>
|
||||
<SceneBackground />
|
||||
<SceneChrome
|
||||
index="02 · LIVE EDITING"
|
||||
title="?edit turns the live site into the editor"
|
||||
bullets={[
|
||||
'The page you are looking at becomes the editor — same components visitors see',
|
||||
'HTTP Basic at the nginx proxy is the only gate',
|
||||
'Text, tags, records and settings edit inline on the preview',
|
||||
'Every save is a commit through the GitHub Contents API',
|
||||
]}
|
||||
bulletStart={70}
|
||||
/>
|
||||
<SceneChrome index="02 · LIVE EDITING" title="?edit turns the live site into the editor" />
|
||||
|
||||
<BrowserFrame
|
||||
width={760}
|
||||
@@ -168,6 +158,44 @@ export const LiveEdit: React.FC<{ captured: boolean }> = ({ captured }) => {
|
||||
</>
|
||||
)}
|
||||
</BrowserFrame>
|
||||
|
||||
<Callout
|
||||
target={[1342, 232]}
|
||||
anchor={[1367, 228]}
|
||||
chip={{ x: 1370, y: 205, width: 330 }}
|
||||
start={150}
|
||||
accent
|
||||
>
|
||||
?edit attaches edit mode — the very page being viewed becomes the editor.
|
||||
</Callout>
|
||||
|
||||
<Callout
|
||||
target={[578, 450]}
|
||||
anchor={[505, 450]}
|
||||
chip={{ x: 140, y: 420, width: 360 }}
|
||||
start={215}
|
||||
>
|
||||
HTTP Basic at the nginx proxy is the only gate — the site itself carries no accounts system.
|
||||
</Callout>
|
||||
|
||||
<Callout
|
||||
target={[578, 242]}
|
||||
anchor={[505, 252]}
|
||||
chip={{ x: 140, y: 235, width: 360 }}
|
||||
start={325}
|
||||
>
|
||||
Text, tags, records and settings edit inline — pencil-triggered, commit on blur, Vietnamese-IME safe.
|
||||
</Callout>
|
||||
|
||||
<Callout
|
||||
target={[700, 762]}
|
||||
anchor={[700, 795]}
|
||||
chip={{ x: 600, y: 800, width: 420 }}
|
||||
start={465}
|
||||
accent
|
||||
>
|
||||
Every save is a commit through the GitHub Contents API; a 409 conflict three-way rebases and keeps your edit.
|
||||
</Callout>
|
||||
</AbsoluteFill>
|
||||
);
|
||||
};
|
||||
@@ -1,6 +1,6 @@
|
||||
import React from 'react';
|
||||
import { AbsoluteFill, OffthreadVideo, staticFile, useCurrentFrame } from 'remotion';
|
||||
import { ArrowDefs, BrowserFrame, Fade, Label, Mono, PageSkeleton, Panel, SceneBackground, SceneChrome } from '../kit';
|
||||
import { ArrowDefs, BrowserFrame, Callout, Fade, Label, Mono, PageSkeleton, Panel, SceneBackground, SceneChrome } from '../kit';
|
||||
import { appear, drawIn } from '../motion';
|
||||
import { theme } from '../theme';
|
||||
|
||||
@@ -29,16 +29,7 @@ export const Pipeline: React.FC<{ captured: boolean }> = ({ captured }) => {
|
||||
return (
|
||||
<AbsoluteFill style={{ background: theme.bg, fontFamily: theme.sans }}>
|
||||
<SceneBackground />
|
||||
<SceneChrome
|
||||
index="04 · AUTO DEPLOYMENT"
|
||||
title="Merge to master — the pipeline ships it"
|
||||
bullets={[
|
||||
'GitHub Actions runs deploy.yml: build · resume PDFs · deploy',
|
||||
'nginx.conf / compose.yaml changes redeploy the stack itself',
|
||||
'No CMS, no manual upload: push to master is the publish button',
|
||||
]}
|
||||
bulletStart={70}
|
||||
/>
|
||||
<SceneChrome index="04 · AUTO DEPLOYMENT" title="Merge to master — the pipeline ships it" />
|
||||
|
||||
<Fade start={10}>
|
||||
<Panel width={210} style={{ left: 449, top: 210 }}>
|
||||
@@ -129,6 +120,25 @@ export const Pipeline: React.FC<{ captured: boolean }> = ({ captured }) => {
|
||||
)}
|
||||
</BrowserFrame>
|
||||
</Fade>
|
||||
|
||||
<Callout
|
||||
target={[555, 322]}
|
||||
anchor={[555, 347]}
|
||||
chip={{ x: 449, y: 350, width: 230 }}
|
||||
start={30}
|
||||
accent
|
||||
>
|
||||
No CMS, no manual upload — the push to master is the publish button.
|
||||
</Callout>
|
||||
|
||||
<Callout
|
||||
target={[1457, 560]}
|
||||
anchor={[1467, 545]}
|
||||
chip={{ x: 1470, y: 500, width: 330 }}
|
||||
start={245}
|
||||
>
|
||||
From commit to live in minutes — the updated page is the receipt.
|
||||
</Callout>
|
||||
</AbsoluteFill>
|
||||
);
|
||||
};
|
||||
@@ -8,13 +8,16 @@ export type ExplainerProps = z.infer<typeof explainerProps>;
|
||||
|
||||
// Scene timeline (30 fps). These boundaries are the source of truth for the
|
||||
// chapter list and the .vtt caption tracks on the site page.
|
||||
// Dwell rule: every callout chip stays on screen at least 150 frames (5 s)
|
||||
// before its scene switches — a ~25-word chip needs a calm read, not a glance.
|
||||
// Scene beats are unchanged; the added frames are hold time at the end.
|
||||
export const SCENES = [
|
||||
{ id: 'title', from: 0, duration: 165 },
|
||||
{ id: 'data', from: 165, duration: 255 },
|
||||
{ id: 'edit', from: 420, duration: 540 },
|
||||
{ id: 'git', from: 960, duration: 330 },
|
||||
{ id: 'pipeline', from: 1290, duration: 360 },
|
||||
{ id: 'outro', from: 1650, duration: 210 },
|
||||
{ id: 'data', from: 165, duration: 420 },
|
||||
{ id: 'edit', from: 585, duration: 700 },
|
||||
{ id: 'git', from: 1285, duration: 420 },
|
||||
{ id: 'pipeline', from: 1705, duration: 510 },
|
||||
{ id: 'outro', from: 2215, duration: 210 },
|
||||
] as const;
|
||||
|
||||
export const TOTAL_FRAMES = 1860;
|
||||
export const TOTAL_FRAMES = 2425;
|
||||
Reference in new issue
Block a user