老板要求:用真实的软件界面图,不要 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 消失」这个坑), 以后界面改了可以直接重出图。
44 lines
1.8 KiB
Markdown
44 lines
1.8 KiB
Markdown
# 官网截图生成
|
||
|
||
官网 `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 会留在图上。
|