Textslide DSL
用 ASCII 纯文本描述 slide 的版式布局,配合内容块规格,交付可直接实现的高保真文字版稿。
术语定义
| 术语 | 英文 | 说明 |
|---|---|---|
| 高保真文字版稿 | high-fidelity textual slide spec | 完整的 slide 规格说明,可直接还原成 PPT |
| 内容块规格 | content block spec | 每个布局区域(A/B/C…)的详细定义 |
基本约定
- •一页 slide = 一个 ASCII 块(代码块包裹)
- •符号:
-画横线(行边界),|画竖线(列边界) - •每行字符数相同,竖线列固定,保证对齐
- •单元格内容:文本直接写,图片/图表用
caption: XXX - •可用前缀标记区域:
A: ...、B: ... - •相对大小:跨列数 = 相对宽度,跨行数 = 相对高度
输出要求
每个 slide 设计必须包含三部分:
- •ASCII 布局草图 — 版式结构(textslide DSL)
- •内容块规格 — 每个 A/B/C… 区域的详细定义
- •参考链接和素材来源 — 布局灵感、设计参考、素材 URL
交付目标:拿到这个文字版规格,可以在不二次设计的情况下,还原出 80–90% 一致的 PPT。
内容块规格结构
对每个 Block(A/B/C…),写一个「内容块规格」:
| 字段 | 说明 |
|---|---|
| Block ID | A / B / C … |
| Role | 区域在信息结构里的作用:标题 / 主视觉 / 关键要点 / 辅助说明 / 底部说明等 |
| Content type | 内容类型(见下表) |
| Content | 若是文字:最终可复制的文案(包含换行和 bullet 结构) |
| Spec | 若是非文字:可据此还原的详细说明(元素、层级、逻辑关系、风格) |
| References | 参考 URL(标注是配色/构图/风格参考) |
| Constraints | 额外约束(留白、品牌色、动画等,可选) |
Content type 枚举
- •
text paragraph— 段落 - •
bullet points— 要点列表 - •
infographic— 信息图 - •
chart— 图表(bar/line/pie…) - •
photography— 照片 - •
icon set/pictogram— 图标集 - •
logo— 标识 - •
code block— 代码块
非文字内容的详细说明要求
对于图表、信息图、照片等非文字内容,Spec 应包括:
- •图表:维度、指标、示例数据、对比关系
- •信息图:步骤/模块数量,每个模块的标题+短描述,层级关系
- •照片:主体(人物/场景)、构图、气氛、风格(纪实/科技感等)、避免/必须包含的元素
布局示例
单列:标题 + 正文
text
-------------------------------------------------------- |Slide title: DSL for slides | -------------------------------------------------------- |- all layout in plain text | |- easy to version control | |- supports relative block sizes | --------------------------------------------------------
标题占 1 行,正文占多行 → 正文区域更高。
两列:左宽右窄
text
---------------------------------------------------------------- |Slide title (A) |caption: overview (B) | ---------------------------------------------------------------- |- point 1 | | |- point 2 | | |- point 3 | | ----------------------------------------------------------------
左列宽度 ≈ 2fr,右列宽度 ≈ 1fr。
三列跨区:A/A/B + C/D/B
text
---------------------------------------------------------------- |A: summary |A: summary (cont.) |B: big number panel | ---------------------------------------------------------------- |C: text block |D: text block |B: extra notes | ----------------------------------------------------------------
- •
A跨两列(宽度 = C+D 总宽) - •
B跨两行(高度 = A+C 或 A+D)
嵌套布局
text
------------------------------------------------------------------ |A: Hero title & overview |B: caption: main graphic | ------------------------------------------------------------------ |C: key points & explanation |E: caption: detail chart | |C: more details / notes |----------------------------| |C: more details / notes (cont.) |F: notes |G: notes | ------------------------------------------------------------------
右下角 E/F/G 为内部细分区域,渲染时可用嵌套 Grid 实现。
完整示例:产品概览页
1. ASCII 布局(textslide)
text
---------------------------------------------------------------- |A: slide title: 产品概览 | ---------------------------------------------------------------- |B: key message block |C: caption: hero graphic | | |(infographic / illustration)| ---------------------------------------------------------------- |D: supporting points (3 bullets) |E: logo / footer note | ----------------------------------------------------------------
2. 内容块规格(Content Block Specs)
Block A
- •Role: 主标题
- •Content type: text
- •Content (copy-paste):
code
产品概览:一句话说明我们是谁、做什么
Block B
- •Role: 左侧关键信息说明
- •Content type: text paragraph + inline emphasis
- •Content (copy-paste):
code
我们提供一套面向中小团队的自动化数据分析平台,帮助非技术成员在不写代码的前提下, 也能完成从「数据接入 → 清洗建模 → 可视化看板」的完整流程。**核心价值:减少 70% 以上重复报表工作**, 并让业务团队对数据结果「看得懂、改得快」。
Block C
- •Role: 右侧主视觉 / 信息图
- •Content type: infographic
- •Spec:
- •结构:三段式流程图,从左到右:
- •数据源(图标:数据库 + Excel + 第三方系统)
- •我们的平台(一个带 logo 的矩形模块,上下注释「自动建模」「智能推荐图表」)
- •输出(图标:仪表盘 / 图表 / 报告)
- •视觉层级:
- •平台模块要最醒目(颜色更实 / 对比更强)
- •输入和输出用相对淡一点的图标
- •强调文案(可放在平台模块中或下方小标注):
- •「No code」「Auto-modeling」「One-click dashboard」
- •Style: 扁平、简洁、偏产品官网风格,不要过多渐变与拟物
- •结构:三段式流程图,从左到右:
Block D
- •Role: 支撑要点(3 条 bullet points)
- •Content type: bullet points
- •Content (copy-paste):
code
- 将报表制作时间平均缩短 70% - 支持主流数据源一键接入(MySQL / Postgres / CSV / SaaS) - 面向非技术团队设计,培训成本低,上手快
Block E
- •Role: 页脚 / logo + 版权信息
- •Content type: text + small logo
- •Spec:
- •左侧放公司 logo(白底 / 透明背景)
- •右侧文字 (copy-paste):
code
© 2025 Company Name. All rights reserved.
3. 参考链接与来源
- •Infographic 风格参考(流程图结构):
- •
https://dribbble.com/...(流程型 SaaS 产品概览)
- •
- •Dashboard 输出样式参考(仅做构图灵感,不直接照抄):
- •
https://dribbble.com/...
- •
- •Logo 使用规范:见品牌手册第 3 页(如有)
协作说明模版
向设计同事发送需求时可用:
之后我这边希望你交付的是一个高保真的文字版 slide 规格说明,我只负责实现,不再做二次设计。每一页 slide 请包含三部分:
- •ASCII 示例(布局草图) — 使用 textslide DSL 画出本页的格子布局(A/B/C…)
- •内容块规格 — 对每个 A/B/C… 都写清楚 Role、Content type、最终文案或详细 Spec
- •参考链接和素材来源 — 每个非纯文字的 block 附 1–3 个参考 URL
目标是:我拿到这个文字版规格,就可以在不二次设计的情况下,还原出与你预期 80–90% 一致的 PPT。