Files
xiaoyin-markdown/tools/screenshots/README.md
T
Jidekin f53abeb0c8 feat(site): 官网换成真实界面截图(4 张)+ 截图生成工具
老板要求:用真实的软件界面图,不要 CSS 画的效果图。

做法:把仓库里**真实的渲染层**跑起来截 —— src/renderer 下的
index.html / style.css / app.js / markdown.js 一字未改,只用
tools/screenshots/mock-api.js 把 Windows 侧的文件、剪贴板、对话框接口换成假数据,
再用无头 Chrome + CDP 在 1440x900@2x 下渲染。

产出 4 张(压到 1600 宽 JPEG q88,共 508KB):
  site/img/app-light.jpg  浅色分栏:文件树 + 源码 + 实时预览 + 章节大纲 + 状态栏
  site/img/app-dark.jpg   深色主题
  site/img/app-find.jpg   查找「安装包」:正文全标黄、当前标橙、计数 2/4
  site/img/app-read.jpg   阅读模式

页面改动:
  · HERO 的假窗口 → 真实截图(保留窗口标题栏样式)
  · 深色区块的假代码窗 → 真实深色截图
  · 新增「这些都是真实界面」区块,放查找/阅读两张 + 说明
  · 清掉改版后失效的假窗口 CSS(-1213 字节)

tools/screenshots/ 里留了完整流程(含「等 2.8 秒让 toast 消失」这个坑),
以后界面改了可以直接重出图。
2026-11-19 21:56:45 +08:00

44 lines
1.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 官网截图生成
官网 `site/index.html` 里那几张「真实界面」图是这么来的:
用**仓库里真实的渲染层**(`src/renderer/{index.html,style.css,app.js,markdown.js}`)跑起来截图,
只把 Windows 侧的文件/剪贴板接口换成 `mock-api.js` 里的假数据 ——
界面、排版、渲染引擎全是线上那份代码,不是画的效果图。
## 步骤
```bash
# 1. 复制渲染层 + 挂上 mock
rm -rf /tmp/shots/app && mkdir -p /tmp/shots/app
cp src/renderer/* /tmp/shots/app/
# 在 index.html 里把 <script src="mock-api.js"> 插到 app.js 之前
cp tools/screenshots/mock-api.js /tmp/shots/app/
# 2. 起静态服务
cd /tmp/shots/app && python3 -m http.server 8901 &
# 3. 起无头 Chrome(开 CDP)
CH=$(ls ~/.cache/ms-playwright/chromium-*/chrome-linux64/chrome | head -1)
$CH --headless=new --no-sandbox --hide-scrollbars --disable-gpu \
--force-device-scale-factor=2 --remote-debugging-port=9222 \
--window-size=1440,900 about:blank &
# 4. 截 4 张(浅色分栏 / 深色 / 查找高亮 / 阅读模式)
node tools/screenshots/take.mjs
# 5. 压成网页尺寸(1600 宽,JPEG q88)
python3 - <<'PY'
from PIL import Image; import os
for s, d in {'shot-split':'app-light','shot-dark':'app-dark',
'shot-find':'app-find','shot-read':'app-read'}.items():
im = Image.open(f'/tmp/shots/out/{s}.png').convert('RGB')
w, h = im.size; tw = 1600
im.resize((tw, round(h*tw/w)), Image.LANCZOS).save(
f'site/img/{d}.jpg', 'JPEG', quality=88, optimize=True, progressive=True)
PY
```
> 截图里打开的是一篇样例「周报」文档,内容在 `mock-api.js` 的 `DOC` 常量里,改文案就改那里。
> 注意 `take.mjs` 里打开文件后要等 ~2.8 秒再截 —— 否则底部的「已打开」toast 会留在图上。