edgepress 2026.10.12 → 2026.10.13

package/tools/README.md

@@ -1,14 +1,14 @@
-# Development tools
-
-Tests and their media fixtures live in `../tests/`. The `.mjs` extension identifies Node ES modules; it does not make a script temporary.
-
-| Directory | Purpose |
-| --- | --- |
+# Development tools
+
+Tests and their media fixtures live in `../tests/`. The `.mjs` extension identifies Node ES modules; it does not make a script temporary.
+
+| Directory | Purpose |
+| --- | --- |
 | `assets/` | Icons, licensed font subsets and source asset derivatives |
-| `recordings/` | Real guest desktop demonstrations using FFmpeg, Playwright and guest X11 tools |
-| `verification/` | Browser and asset verification commands |
-| `reports/` | Current generated review evidence; `page-check.pdf` comes from `npm run check` |
-
+| `recordings/` | Real guest desktop demonstrations using FFmpeg, Playwright and guest X11 tools |
+| `verification/` | Browser and asset verification commands |
+| `reports/` | Current generated review evidence; `page-check.pdf` comes from `npm run check` |
+
 Run commands from the project root. Raw recordings and temporary manifests use ignored `tools/.recordings/`; intermediate verification output uses ignored `tools/.verification/`. Replaced historical reports are archived outside the checkout.
 
 `npm run fonts:sync` vendors pinned Noto WOFF2 Unicode subsets from Fontsource, verifies archive integrity, preserves OFL licenses and records file hashes under `static/edgepress/fonts/`. Normal builds use these committed files offline. The operator site's existing framework checkout also carries these assets; synchronize that directory when deliberately updating the font release.

package/tools/assets/generate-brand-assets.py

@@ -1,160 +1,160 @@
-"""Build EdgePress brand derivatives. Functional icons are sourced separately from Lucide.
-
-Requires Pillow. The mascot PNG passed on the command line stays untouched as
-the generated master; this script only makes derivative assets from it.
-"""
-
-from __future__ import annotations
-
-import argparse
-import shutil
-from pathlib import Path
-
-from PIL import Image, ImageDraw, ImageFont
-
-
-INK = (55, 65, 59, 255)
-PALE = (247, 240, 225)
-ACCENT = (228, 128, 99)
-def alpha_bbox(image: Image.Image):
-    alpha = image.getchannel("A").point(lambda value: 255 if value > 8 else 0)
-    return alpha.getbbox()
-
-
-def contained(image: Image.Image, size: tuple[int, int], padding: int = 0) -> Image.Image:
-    image = image.copy()
-    image.thumbnail((size[0] - padding * 2, size[1] - padding * 2), Image.Resampling.LANCZOS)
-    layer = Image.new("RGBA", size, (0, 0, 0, 0))
-    layer.alpha_composite(image, ((size[0] - image.width) // 2, (size[1] - image.height) // 2))
-    return layer
-
-
-def font(size: int, bold: bool = False, cjk: bool = False):
-    candidates = (
-        [r"C:\Windows\Fonts\msyhbd.ttc", r"C:\Windows\Fonts\msyh.ttc"] if cjk else
-        [r"C:\Windows\Fonts\seguisb.ttf", r"C:\Windows\Fonts\segoeui.ttf"] if bold else
-        [r"C:\Windows\Fonts\segoeui.ttf", r"C:\Windows\Fonts\arial.ttf"]
-    )
-    for candidate in candidates:
-        if Path(candidate).exists():
-            return ImageFont.truetype(candidate, size=size)
-    return ImageFont.load_default()
-
-
-def wrap_text(draw: ImageDraw.ImageDraw, text: str, font_face, max_width: int) -> list[str]:
-    words = text.split()
-    lines: list[str] = []
-    current = ""
-    for word in words:
-        candidate = word if not current else current + " " + word
-        if current and draw.textlength(candidate, font=font_face) > max_width:
-            lines.append(current)
-            current = word
-        else:
-            current = candidate
-    if current:
-        lines.append(current)
-    return lines
-
-
-def share_image(master: Image.Image, brand: str) -> Image.Image:
-    canvas = Image.new("RGBA", (1200, 630), (250, 247, 238, 255))
-    draw = ImageDraw.Draw(canvas)
-    if brand == "edgepress":
-        title = "EdgePress"
-        title_font = font(64, bold=True)
-        body_font = font(31)
-        body_lines = ["Build for the edge.", "Publish with clarity."]
-        detail = "Markdown posts, editable pages, themes, and Workers."
-        art_size, art_x = (600, 540), 600
-    elif brand == "blackbear":
-        title = "技述｜JS.GRIPE"
-        title_font = font(51, bold=True, cjk=True)
-        body_font = font(27)
-        body_lines = ["Technical field notes,", "research, and open source."]
-        detail = "Practice and ideas from JS.GRIPE."
-        art_size, art_x = (580, 580), 620
-    else:
-        title = "技术网"
-        title_font = font(74, bold=True, cjk=True)
-        body_font = font(31, cjk=True)
-        body_lines = ["记录服务器运维、技术学习", "与问题解决过程。"]
-        detail = "可复现、可回看的技术笔记"
-        art_size, art_x = (580, 580), 620
-
-    mascot = contained(master, art_size, 0)
-    canvas.alpha_composite(mascot, (art_x + (art_size[0] - mascot.width) // 2, (630 - mascot.height) // 2))
-    draw = ImageDraw.Draw(canvas)
-    draw.rounded_rectangle((76, 92, 124, 100), radius=4, fill=ACCENT)
-    draw.text((76, 129), title, font=title_font, fill=(36, 56, 45, 255))
-    y = 235 if brand == "edgepress" else 225
-    for line_text in body_lines:
-        draw.text((78, y), line_text, font=body_font, fill=(49, 94, 73, 255))
-        y += 58 if brand == "edgepress" else 50
-    detail_font = font(23, cjk=brand == "panda")
-    for line_text in wrap_text(draw, detail, detail_font, 540):
-        draw.text((80, y + 20), line_text, font=detail_font, fill=(99, 111, 100, 255))
-        y += 35
-    return canvas.convert("RGB")
-
-
-def generate(master_path: Path, avatar_path: Path, home_path: Path, output_dir: Path, icons_dir: Path | None, favicon_dir: Path | None, brand: str):
-    output_dir.mkdir(parents=True, exist_ok=True)
-    if icons_dir:
-        icons_dir.mkdir(parents=True, exist_ok=True)
-    if favicon_dir:
-        favicon_dir.mkdir(parents=True, exist_ok=True)
-    master_path = master_path.resolve()
-    master_target = output_dir / "mascot.png"
-    if master_path != master_target.resolve():
-        shutil.copyfile(master_path, master_target)
-    master = Image.open(master_target).convert("RGBA")
-
-    mascot = master.copy()
-    mascot.thumbnail((768, 1152), Image.Resampling.LANCZOS)
-    mascot.save(output_dir / "mascot.webp", format="WEBP", quality=88, method=4)
-
-    avatar_master = Image.open(avatar_path).convert("RGBA")
-    avatar = contained(avatar_master.crop(alpha_bbox(avatar_master)), (512, 512), 20)
-    avatar.save(output_dir / "avatar.png", optimize=True)
-    if home_path.resolve() != (output_dir / "home-hero.png").resolve():
-        shutil.copyfile(home_path, output_dir / "home-hero.png")
-    home = Image.open(home_path).convert("RGBA")
-    home.save(output_dir / "home-hero.webp", format="WEBP", quality=88, method=4)
-    small_home = home.copy()
-    small_home.thumbnail((768, 512), Image.Resampling.LANCZOS)
-    small_home.save(output_dir / "home-hero-768.webp", format="WEBP", quality=88, method=4)
-    share = share_image(home, brand)
-    share.save(output_dir / "og-image.png", optimize=True)
-    share.save(output_dir / "og-image.webp", format="WEBP", quality=88, method=6)
-
-    if icons_dir:
-        raise ValueError("Use npm run icons:sync for licensed Lucide SVG icons; omit --icons-dir here")
-
-    if favicon_dir:
-        favicon = Image.new("RGBA", (512, 512), (0, 0, 0, 0))
-        ImageDraw.Draw(favicon).ellipse((4, 4, 508, 508), fill=(246, 236, 215, 255))
-        favicon.alpha_composite(contained(avatar, (512, 512), 18))
-        for size in (16, 32, 48, 64):
-            favicon.resize((size, size), Image.Resampling.LANCZOS).save(favicon_dir / f"favicon-{size}.png", optimize=True)
-        favicon.save(favicon_dir / "favicon.ico", format="ICO", sizes=[(16, 16), (32, 32), (48, 48), (64, 64)])
-        touch = Image.new("RGBA", (180, 180), (244, 235, 218, 255))
-        touch.alpha_composite(avatar.resize((168, 168), Image.Resampling.LANCZOS), (6, 6))
-        touch.save(favicon_dir / "apple-touch-icon.png", optimize=True)
-
-
-def main():
-    parser = argparse.ArgumentParser()
-    parser.add_argument("--master", required=True, type=Path)
-    parser.add_argument("--avatar-master", required=True, type=Path)
-    parser.add_argument("--home-master", required=True, type=Path)
-    parser.add_argument("--output-dir", required=True, type=Path)
-    parser.add_argument("--icons-dir", type=Path)
-    parser.add_argument("--favicon-dir", type=Path)
-    parser.add_argument("--brand", required=True, choices=("panda", "blackbear", "edgepress"))
-    args = parser.parse_args()
-    generate(args.master, args.avatar_master, args.home_master, args.output_dir, args.icons_dir, args.favicon_dir, args.brand)
-
-
-if __name__ == "__main__":
-    main()
+"""Build EdgePress brand derivatives. Functional icons are sourced separately from Lucide.
+
+Requires Pillow. The mascot PNG passed on the command line stays untouched as
+the generated master; this script only makes derivative assets from it.
+"""
+
+from __future__ import annotations
+
+import argparse
+import shutil
+from pathlib import Path
+
+from PIL import Image, ImageDraw, ImageFont
+
+
+INK = (55, 65, 59, 255)
+PALE = (247, 240, 225)
+ACCENT = (228, 128, 99)
+def alpha_bbox(image: Image.Image):
+    alpha = image.getchannel("A").point(lambda value: 255 if value > 8 else 0)
+    return alpha.getbbox()
+
+
+def contained(image: Image.Image, size: tuple[int, int], padding: int = 0) -> Image.Image:
+    image = image.copy()
+    image.thumbnail((size[0] - padding * 2, size[1] - padding * 2), Image.Resampling.LANCZOS)
+    layer = Image.new("RGBA", size, (0, 0, 0, 0))
+    layer.alpha_composite(image, ((size[0] - image.width) // 2, (size[1] - image.height) // 2))
+    return layer
+
+
+def font(size: int, bold: bool = False, cjk: bool = False):
+    candidates = (
+        [r"C:\Windows\Fonts\msyhbd.ttc", r"C:\Windows\Fonts\msyh.ttc"] if cjk else
+        [r"C:\Windows\Fonts\seguisb.ttf", r"C:\Windows\Fonts\segoeui.ttf"] if bold else
+        [r"C:\Windows\Fonts\segoeui.ttf", r"C:\Windows\Fonts\arial.ttf"]
+    )
+    for candidate in candidates:
+        if Path(candidate).exists():
+            return ImageFont.truetype(candidate, size=size)
+    return ImageFont.load_default()
+
+
+def wrap_text(draw: ImageDraw.ImageDraw, text: str, font_face, max_width: int) -> list[str]:
+    words = text.split()
+    lines: list[str] = []
+    current = ""
+    for word in words:
+        candidate = word if not current else current + " " + word
+        if current and draw.textlength(candidate, font=font_face) > max_width:
+            lines.append(current)
+            current = word
+        else:
+            current = candidate
+    if current:
+        lines.append(current)
+    return lines
+
+
+def share_image(master: Image.Image, brand: str) -> Image.Image:
+    canvas = Image.new("RGBA", (1200, 630), (250, 247, 238, 255))
+    draw = ImageDraw.Draw(canvas)
+    if brand == "edgepress":
+        title = "EdgePress"
+        title_font = font(64, bold=True)
+        body_font = font(31)
+        body_lines = ["Build for the edge.", "Publish with clarity."]
+        detail = "Markdown posts, editable pages, themes, and Workers."
+        art_size, art_x = (600, 540), 600
+    elif brand == "blackbear":
+        title = "技述｜JS.GRIPE"
+        title_font = font(51, bold=True, cjk=True)
+        body_font = font(27)
+        body_lines = ["Technical field notes,", "research, and open source."]
+        detail = "Practice and ideas from JS.GRIPE."
+        art_size, art_x = (580, 580), 620
+    else:
+        title = "技术网"
+        title_font = font(74, bold=True, cjk=True)
+        body_font = font(31, cjk=True)
+        body_lines = ["记录服务器运维、技术学习", "与问题解决过程。"]
+        detail = "可复现、可回看的技术笔记"
+        art_size, art_x = (580, 580), 620
+
+    mascot = contained(master, art_size, 0)
+    canvas.alpha_composite(mascot, (art_x + (art_size[0] - mascot.width) // 2, (630 - mascot.height) // 2))
+    draw = ImageDraw.Draw(canvas)
+    draw.rounded_rectangle((76, 92, 124, 100), radius=4, fill=ACCENT)
+    draw.text((76, 129), title, font=title_font, fill=(36, 56, 45, 255))
+    y = 235 if brand == "edgepress" else 225
+    for line_text in body_lines:
+        draw.text((78, y), line_text, font=body_font, fill=(49, 94, 73, 255))
+        y += 58 if brand == "edgepress" else 50
+    detail_font = font(23, cjk=brand == "panda")
+    for line_text in wrap_text(draw, detail, detail_font, 540):
+        draw.text((80, y + 20), line_text, font=detail_font, fill=(99, 111, 100, 255))
+        y += 35
+    return canvas.convert("RGB")
+
+
+def generate(master_path: Path, avatar_path: Path, home_path: Path, output_dir: Path, icons_dir: Path | None, favicon_dir: Path | None, brand: str):
+    output_dir.mkdir(parents=True, exist_ok=True)
+    if icons_dir:
+        icons_dir.mkdir(parents=True, exist_ok=True)
+    if favicon_dir:
+        favicon_dir.mkdir(parents=True, exist_ok=True)
+    master_path = master_path.resolve()
+    master_target = output_dir / "mascot.png"
+    if master_path != master_target.resolve():
+        shutil.copyfile(master_path, master_target)
+    master = Image.open(master_target).convert("RGBA")
+
+    mascot = master.copy()
+    mascot.thumbnail((768, 1152), Image.Resampling.LANCZOS)
+    mascot.save(output_dir / "mascot.webp", format="WEBP", quality=88, method=4)
+
+    avatar_master = Image.open(avatar_path).convert("RGBA")
+    avatar = contained(avatar_master.crop(alpha_bbox(avatar_master)), (512, 512), 20)
+    avatar.save(output_dir / "avatar.png", optimize=True)
+    if home_path.resolve() != (output_dir / "home-hero.png").resolve():
+        shutil.copyfile(home_path, output_dir / "home-hero.png")
+    home = Image.open(home_path).convert("RGBA")
+    home.save(output_dir / "home-hero.webp", format="WEBP", quality=88, method=4)
+    small_home = home.copy()
+    small_home.thumbnail((768, 512), Image.Resampling.LANCZOS)
+    small_home.save(output_dir / "home-hero-768.webp", format="WEBP", quality=88, method=4)
+    share = share_image(home, brand)
+    share.save(output_dir / "og-image.png", optimize=True)
+    share.save(output_dir / "og-image.webp", format="WEBP", quality=88, method=6)
+
+    if icons_dir:
+        raise ValueError("Use npm run icons:sync for licensed Lucide SVG icons; omit --icons-dir here")
+
+    if favicon_dir:
+        favicon = Image.new("RGBA", (512, 512), (0, 0, 0, 0))
+        ImageDraw.Draw(favicon).ellipse((4, 4, 508, 508), fill=(246, 236, 215, 255))
+        favicon.alpha_composite(contained(avatar, (512, 512), 18))
+        for size in (16, 32, 48, 64):
+            favicon.resize((size, size), Image.Resampling.LANCZOS).save(favicon_dir / f"favicon-{size}.png", optimize=True)
+        favicon.save(favicon_dir / "favicon.ico", format="ICO", sizes=[(16, 16), (32, 32), (48, 48), (64, 64)])
+        touch = Image.new("RGBA", (180, 180), (244, 235, 218, 255))
+        touch.alpha_composite(avatar.resize((168, 168), Image.Resampling.LANCZOS), (6, 6))
+        touch.save(favicon_dir / "apple-touch-icon.png", optimize=True)
+
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--master", required=True, type=Path)
+    parser.add_argument("--avatar-master", required=True, type=Path)
+    parser.add_argument("--home-master", required=True, type=Path)
+    parser.add_argument("--output-dir", required=True, type=Path)
+    parser.add_argument("--icons-dir", type=Path)
+    parser.add_argument("--favicon-dir", type=Path)
+    parser.add_argument("--brand", required=True, choices=("panda", "blackbear", "edgepress"))
+    args = parser.parse_args()
+    generate(args.master, args.avatar_master, args.home_master, args.output_dir, args.icons_dir, args.favicon_dir, args.brand)
+
+
+if __name__ == "__main__":
+    main()

package/tools/assets/video-preview.mjs

@@ -0,0 +1,15 @@
+import {execFile} from 'node:child_process';
+import {promisify} from 'node:util';
+import {writeFile} from 'node:fs/promises';
+import {basename, resolve} from 'node:path';
+const run = promisify(execFile);
+const file = process.argv[2];
+if (!file || !/\.(?:mp4|webm|ogv|ogg)$/i.test(file)) throw new Error('Usage: node tools/assets/video-preview.mjs path/to/video.mp4 [frame-seconds] (requires FFmpeg)');
+const video = resolve(file), poster = video + '.poster.jpg';
+const {stdout} = await run('ffprobe', ['-v','error','-select_streams','v:0','-show_entries','format=duration:stream=width,height','-of','json',video]);
+const info = JSON.parse(stdout), duration = Number(info.format.duration), {width, height} = info.streams[0];
+const time = Number(process.argv[3] ?? Math.min(1, duration / 2));
+if (!(Number.isFinite(time) && time >= 0 && time < duration)) throw new Error('Preview time must be inside the video');
+await run('ffmpeg', ['-v','error','-y','-ss',String(time),'-i',video,'-frames:v','1','-vf','scale=min(960\\,iw):-2','-q:v','3',poster]);
+await writeFile(video + '.json', JSON.stringify({duration, width, height, poster: basename(poster)}, null, 2) + '\n');
+console.log('Created ' + basename(poster) + ' and ' + basename(video) + '.json');

package/tools/recordings/demo-workbench.mjs

@@ -1,57 +1,57 @@
-// Recording-only workbench. Commands execute the real standalone EdgePress CLI;
-// Geany edits the actual generated file. Nothing is installed into production.
-import assert from 'node:assert/strict';
-import {readFile,writeFile,mkdir,rm,cp} from 'node:fs/promises';
-import {resolve,sep,extname} from 'node:path';
-import {spawn} from 'node:child_process';
-import {pathToFileURL} from 'node:url';
+// Recording-only workbench. Commands execute the real standalone EdgePress CLI;
+// Geany edits the actual generated file. Nothing is installed into production.
+import assert from 'node:assert/strict';
+import {readFile,writeFile,mkdir,rm,cp} from 'node:fs/promises';
+import {resolve,sep,extname} from 'node:path';
+import {spawn} from 'node:child_process';
+import {pathToFileURL} from 'node:url';
 import {guest,guestPath,typeCommand,editFile,openApp,activate} from './vm-desktop.mjs';
-import {parse,stringify} from 'yaml';
-
-export async function workbench({artifact,packageRoot,photoPath,locale,context,embedding=false}){
- const upstream=resolve(packageRoot),root=resolve(artifact,(embedding?'embedding-example-':'edgepress-example-')+locale);
- assert.ok(root.startsWith(resolve(artifact)+sep));await rm(root,{recursive:true,force:true});await mkdir(root,{recursive:true});
- const cli=resolve(upstream,'src/cli.js');
- async function run(args){return new Promise((done,reject)=>{const child=spawn(process.execPath,[cli,...args],{cwd:root,windowsHide:true,env:{...process.env,WRANGLER_SEND_METRICS:'false'}});let output='';child.stdout.on('data',value=>output+=value);child.stderr.on('data',value=>output+=value);child.once('error',reject);child.once('exit',code=>code===0?done(output):reject(Error(output)));});}
- await run(['init']);
+import {parse,stringify} from 'yaml';
+
+export async function workbench({artifact,packageRoot,photoPath,locale,context,embedding=false}){
+ const upstream=resolve(packageRoot),root=resolve(artifact,(embedding?'embedding-example-':'edgepress-example-')+locale);
+ assert.ok(root.startsWith(resolve(artifact)+sep));await rm(root,{recursive:true,force:true});await mkdir(root,{recursive:true});
+ const cli=resolve(upstream,'src/cli.js');
+ async function run(args){return new Promise((done,reject)=>{const child=spawn(process.execPath,[cli,...args],{cwd:root,windowsHide:true,env:{...process.env,WRANGLER_SEND_METRICS:'false'}});let output='';child.stdout.on('data',value=>output+=value);child.stderr.on('data',value=>output+=value);child.once('error',reject);child.once('exit',code=>code===0?done(output):reject(Error(output)));});}
+ await run(['init']);
  const chinese=locale!=='en',title=embedding?(chinese?'散步中的瞬间':'Photos from our walk'):(chinese?'海边的下午':'An afternoon by the water');
- const settings=parse(await readFile(resolve(root,'config.yml'),'utf8'));settings.site.title=chinese?'我的写作空间':'My writing space';settings.site.description=chinese?'用文字和照片记录生活。':'Stories and photographs from everyday life.';settings.site.navigation=settings.site.navigation.filter(item=>['home','posts','search'].includes(item.key));settings.site.footerNavigation=[];settings.plugins.consent.services=[];await writeFile(resolve(root,'config.yml'),stringify(settings));
- await writeFile(resolve(root,'edgepress.config.mjs'),'export default '+JSON.stringify({paths:{content:'content',static:'static',theme:'themes/default',output:'dist',cache:'.recording-cache'},permalink:'/:year/:month/:slug/',i18n:{defaultLocale:locale,languagePacks:[chinese?'en':'zh-CN']},plugins:['plugins/consent/index.js']})+';\n');
- if(chinese){await cp(resolve(root,'languages/packs/zh-CN.json'),resolve(root,'languages/base/zh-CN.json'));await cp(resolve(root,'languages/base/en.json'),resolve(root,'languages/packs/en.json'));}
- // Use a small, real writing site so the recording starts at its article list.
- await rm(resolve(root,'content/posts'),{recursive:true,force:true});await mkdir(resolve(root,'content/posts'),{recursive:true});
- await rm(resolve(root,'content/pages'),{recursive:true,force:true});await mkdir(resolve(root,'content/pages/home'),{recursive:true});
- await writeFile(resolve(root,'content/pages/home',locale.toLowerCase()+'.json'),JSON.stringify({title:settings.site.title,lang:locale,slug:'home',homepage:true,blocks:[{columns:1,cells:[[{type:'hero',eyebrow:chinese?'生活里的小事':'Notes from everyday life',title:settings.site.title,text:settings.site.description}]]},{columns:1,cells:[[{type:'post-list',title:chinese?'最近的文章':'Recent stories',category:'uncategorized',count:3}]]}]},null,2)+'\n');
- if(embedding){settings.plugins.consent.services=[{id:'ishare',provider:'oembed',backendUrl:'https://ishare.js.gripe',enabled:true,name:chinese?'爱分享':'ishare',purpose:chinese?'在你同意后显示作者分享的图片与视频。':'Show the author’s shared photos and videos after you agree.',dataCategories:chinese?'请求的媒体和 IP 地址。':'Requested media and IP address.',recipient:'ishare',retention:chinese?'直到发布者删除。':'Until the publisher deletes it.',privacyUrl:'https://ishare.js.gripe/privacy/'}];await writeFile(resolve(root,'config.yml'),stringify(settings));}
- await mkdir(resolve(root,'content/assets/photos'),{recursive:true});await cp(photoPath,resolve(root,'content/assets/photos/seaside.jpg'));
- let file=null,port;
- const terminalTitle='EdgePress '+locale;
- const {loadConfig}=await import(pathToFileURL(resolve(upstream,'src/config.js')));const {readDocuments}=await import(pathToFileURL(resolve(upstream,'src/content.js')));
- const rc=resolve(root,'.recording-bashrc');
- const shellRoot="'"+guestPath(root).replaceAll("'","'\\''")+"'";
- await writeFile(rc,'export PATH=/opt/recording/node_modules/.bin:/usr/local/bin:/usr/bin:/bin\ncd -- '+shellRoot+'\nexport WRANGLER_SEND_METRICS=false\nexport PS1="❯ "\n');
- await guest(['ln','-s','/opt/recording/node_modules',guestPath(resolve(root,'node_modules'))]);
+ const settings=parse(await readFile(resolve(root,'config.yml'),'utf8'));settings.site.title=chinese?'我的写作空间':'My writing space';settings.site.description=chinese?'用文字和照片记录生活。':'Stories and photographs from everyday life.';settings.site.navigation=settings.site.navigation.filter(item=>['home','posts','search'].includes(item.key));settings.site.footerNavigation=[];settings.plugins.consent.services=[];await writeFile(resolve(root,'config.yml'),stringify(settings));
+ await writeFile(resolve(root,'edgepress.config.mjs'),'export default '+JSON.stringify({paths:{content:'content',static:'static',theme:'themes/default',output:'dist',cache:'.recording-cache'},permalink:'/:year/:month/:slug/',i18n:{defaultLocale:locale,languagePacks:[chinese?'en':'zh-CN']},plugins:['plugins/consent/index.js']})+';\n');
+ if(chinese){await cp(resolve(root,'languages/packs/zh-CN.json'),resolve(root,'languages/base/zh-CN.json'));await cp(resolve(root,'languages/base/en.json'),resolve(root,'languages/packs/en.json'));}
+ // Use a small, real writing site so the recording starts at its article list.
+ await rm(resolve(root,'content/posts'),{recursive:true,force:true});await mkdir(resolve(root,'content/posts'),{recursive:true});
+ await rm(resolve(root,'content/pages'),{recursive:true,force:true});await mkdir(resolve(root,'content/pages/home'),{recursive:true});
+ await writeFile(resolve(root,'content/pages/home',locale.toLowerCase()+'.json'),JSON.stringify({title:settings.site.title,lang:locale,slug:'home',homepage:true,blocks:[{columns:1,cells:[[{type:'hero',eyebrow:chinese?'生活里的小事':'Notes from everyday life',title:settings.site.title,text:settings.site.description}]]},{columns:1,cells:[[{type:'post-list',title:chinese?'最近的文章':'Recent stories',category:'uncategorized',count:3}]]}]},null,2)+'\n');
+ if(embedding){settings.plugins.consent.services=[{id:'ishare',provider:'oembed',backendUrl:'https://ishare.js.gripe',enabled:true,name:chinese?'爱分享':'ishare',purpose:chinese?'在你同意后显示作者分享的图片与视频。':'Show the author’s shared photos and videos after you agree.',dataCategories:chinese?'请求的媒体和 IP 地址。':'Requested media and IP address.',recipient:'ishare',retention:chinese?'直到发布者删除。':'Until the publisher deletes it.',privacyUrl:'https://ishare.js.gripe/privacy/'}];await writeFile(resolve(root,'config.yml'),stringify(settings));}
+ await mkdir(resolve(root,'content/assets/photos'),{recursive:true});await cp(photoPath,resolve(root,'content/assets/photos/seaside.jpg'));
+ let file=null,port;
+ const terminalTitle='EdgePress '+locale;
+ const {loadConfig}=await import(pathToFileURL(resolve(upstream,'src/config.js')));const {readDocuments}=await import(pathToFileURL(resolve(upstream,'src/content.js')));
+ const rc=resolve(root,'.recording-bashrc');
+ const shellRoot="'"+guestPath(root).replaceAll("'","'\\''")+"'";
+ await writeFile(rc,'export PATH=/opt/recording/node_modules/.bin:/usr/local/bin:/usr/bin:/bin\ncd -- '+shellRoot+'\nexport WRANGLER_SEND_METRICS=false\nexport PS1="❯ "\n');
+ await guest(['ln','-s','/opt/recording/node_modules',guestPath(resolve(root,'node_modules'))]);
  await openApp(['xterm','-T',terminalTitle,'-fa','Monospace','-fs','16','-bg','#17212c','-fg','#e8edf2','-geometry','106x30+60+40','-e','bash','--rcfile',guestPath(rc)],terminalTitle);
- await new Promise(done=>setTimeout(done,800));
- async function findPost(){const documents=await readDocuments(await loadConfig(root));const article=documents.find(item=>item.kind==='posts'&&item.title===title);if(article)file=article.file;return article;}
- async function createPost(){await run(['new','post',title]);const article=await findPost();assert.ok(article);return file;}
- async function newPost(){await typeCommand(root,terminalTitle,"edgepress new post '"+title+"'");for(let attempt=0;attempt<30;attempt++){const article=await findPost();if(article)return;await new Promise(done=>setTimeout(done,300));}throw Error('CLI did not create the post');}
- async function editPost(body){assert.ok(file);const front=(await readFile(file,'utf8')).split('---')[1];await editFile(root,file,'---'+front+'---\n\n'+body+'\n');}
- async function startServer({omitWait=task=>task()}={}){
-  const {createServer}=await import('node:net');const socket=createServer();await new Promise(done=>socket.listen(0,'127.0.0.1',done));port=socket.address().port;await new Promise(done=>socket.close(done));
-  await typeCommand(root,terminalTitle,'edgepress server --port '+port);
-  await new Promise(done=>setTimeout(done,1600));
-  await omitWait(async()=>{for(let attempt=0;attempt<180;attempt++){try{const response=await fetch('http://127.0.0.1:'+port+'/',{signal:AbortSignal.timeout(1200)});if(response.ok)return;}catch{}await new Promise(done=>setTimeout(done,500));}throw Error('Guest preview did not become ready');});
- }
- async function dispose(){for(const title of [terminalTitle,'Geany']){try{const ids=await guest(['xdotool','search','--onlyvisible','--name',title]);for(const id of ids.split(/\s+/)){const pid=await guest(['xdotool','getwindowpid',id]);if(/^\d+$/.test(pid))await guest(['kill','-TERM',pid]);}}catch{}}}
- const content=chinese?'## 海边的下午\n\n走到海边时，雨刚停。潮水很轻，远处的山还藏在云里。\n\n![雨后的海岸](/photos/seaside.jpg)\n\n下次还想沿着这条路走远一点。':'## An afternoon by the water\n\nThe rain had just stopped. Small waves reached the shore, and the mountains were still tucked into the clouds.\n\n![The coast after the rain](/photos/seaside.jpg)\n\nNext time, I want to follow this path a little farther.';
- await context.route('https://edgepress-demo.test/**',async route=>{
-  try{
-  assert.ok(port,'Start the real guest preview before opening the website');
-  const request=route.request(),url=new URL(request.url()),response=await fetch('http://127.0.0.1:'+port+url.pathname+url.search);
-  const headers=Object.fromEntries(response.headers);delete headers['content-encoding'];delete headers['content-length'];
-  return await route.fulfill({status:response.status,headers,body:Buffer.from(await response.arrayBuffer())});
-  }catch(error){if(!route.request().isNavigationRequest())return route.abort();throw error;}
- });
+ await new Promise(done=>setTimeout(done,800));
+ async function findPost(){const documents=await readDocuments(await loadConfig(root));const article=documents.find(item=>item.kind==='posts'&&item.title===title);if(article)file=article.file;return article;}
+ async function createPost(){await run(['new','post',title]);const article=await findPost();assert.ok(article);return file;}
+ async function newPost(){await typeCommand(root,terminalTitle,"edgepress new post '"+title+"'");for(let attempt=0;attempt<30;attempt++){const article=await findPost();if(article)return;await new Promise(done=>setTimeout(done,300));}throw Error('CLI did not create the post');}
+ async function editPost(body){assert.ok(file);const front=(await readFile(file,'utf8')).split('---')[1];await editFile(root,file,'---'+front+'---\n\n'+body+'\n');}
+ async function startServer({omitWait=task=>task()}={}){
+  const {createServer}=await import('node:net');const socket=createServer();await new Promise(done=>socket.listen(0,'127.0.0.1',done));port=socket.address().port;await new Promise(done=>socket.close(done));
+  await typeCommand(root,terminalTitle,'edgepress server --port '+port);
+  await new Promise(done=>setTimeout(done,1600));
+  await omitWait(async()=>{for(let attempt=0;attempt<180;attempt++){try{const response=await fetch('http://127.0.0.1:'+port+'/',{signal:AbortSignal.timeout(1200)});if(response.ok)return;}catch{}await new Promise(done=>setTimeout(done,500));}throw Error('Guest preview did not become ready');});
+ }
+ async function dispose(){for(const title of [terminalTitle,'Geany']){try{const ids=await guest(['xdotool','search','--onlyvisible','--name',title]);for(const id of ids.split(/\s+/)){const pid=await guest(['xdotool','getwindowpid',id]);if(/^\d+$/.test(pid))await guest(['kill','-TERM',pid]);}}catch{}}}
+ const content=chinese?'## 海边的下午\n\n走到海边时，雨刚停。潮水很轻，远处的山还藏在云里。\n\n![雨后的海岸](/photos/seaside.jpg)\n\n下次还想沿着这条路走远一点。':'## An afternoon by the water\n\nThe rain had just stopped. Small waves reached the shore, and the mountains were still tucked into the clouds.\n\n![The coast after the rain](/photos/seaside.jpg)\n\nNext time, I want to follow this path a little farther.';
+ await context.route('https://edgepress-demo.test/**',async route=>{
+  try{
+  assert.ok(port,'Start the real guest preview before opening the website');
+  const request=route.request(),url=new URL(request.url()),response=await fetch('http://127.0.0.1:'+port+url.pathname+url.search);
+  const headers=Object.fromEntries(response.headers);delete headers['content-encoding'];delete headers['content-length'];
+  return await route.fulfill({status:response.status,headers,body:Buffer.from(await response.arrayBuffer())});
+  }catch(error){if(!route.request().isNavigationRequest())return route.abort();throw error;}
+ });
  return {title,content,createPost,newPost,editPost,startServer,dispose,activateTerminal:()=>activate(terminalTitle),async publishedPath(){const article=await findPost();assert.ok(article);return article.path;}};
-}
+}