# Layout: `agenda` — 议程/目录页 > 幻灯片尺寸: 13.333 × 7.5 英寸 | 边距: 0.6 英寸 | 内容宽: 12.133 英寸 --- ## 用途 报告目录、会议议程、章节索引页。当前章节高亮，其余章节降调显示。 --- ## ASCII 线框图 ### 变体 A：竖向列表（3-6 项） ``` ┌─────────────────────────────────────────────────────────────┐ │ [标题：如"报告目录"] y=0.25 │ │ ▬▬ (accent 装饰线) y=0.90 │ │ │ │ ┌──┐ 01 宏观经济环境分析 p.04 - 15 │ │ │ │ [描述文字，2行，text_muted] │ │ └──┘ │ │ │ │ ┌██┐ 02 ▶ 资产配置策略（当前） p.16 - 27 ←高亮 │ │ │██│ [描述文字，primary色，加粗] │ │ └██┘ │ │ │ │ ┌──┐ 03 固定收益市场 p.28 - 39 │ │ └──┘ │ │ ┌──┐ 04 权益资产展望 p.40 - 52 │ │ └──┘ │ │ ┌──┐ 05 风险管理与压力测试 p.53 - 60 │ │ └──┘ │ └─────────────────────────────────────────────────────────────┘ ``` ### 变体 B：两列布局（5-8 项） ``` ┌─────────────────────────────────────────────────────────────┐ │ [标题] │ │ ▬▬ │ │ │ │ ┌──┐ 01 宏观经济 ┌██┐ 02 ▶资产配置（当前） │ │ └──┘ p.04-15 └██┘ p.16-27 │ │ │ │ ┌──┐ 03 固定收益 ┌──┐ 04 权益资产 │ │ └──┘ p.28-39 └──┘ p.40-52 │ │ │ │ ┌──┐ 05 风险管理 ┌──┐ 06 附录 │ │ └──┘ p.53-60 └──┘ p.61-70 │ │ │ └─────────────────────────────────────────────────────────────┘ ``` --- ## 精确坐标标注 ### 变体 A（竖向列表，最多 6 项） **固定元素** | 元素 | x | y | w | h | 字号 | 颜色 | 对齐 | |------|---|---|---|---|------|------|------| | 页面标题 | 0.60 | 0.25 | 12.133 | 0.60 | title_size-2 | text_dark | 左 | | 装饰线 | 0.60 | 0.90 | 2.00 | 0.04 | — | accent | — | **列表项布局计算** ``` list_start_y = 1.20 available_h = 6.00 # 7.5 - 1.20 - 0.30(bottom margin) item_h = available_h / N # N=5时 item_h=1.20", N=6时 item_h=1.00" 每项最小高度 = 0.90"（够放2行文字） 建议最多 6 项 ``` **单列表项结构（以 N=5, item_h=1.20" 为例）** | 元素 | x | y（相对本项顶部，`item_y`） | w | h | 字号 | 颜色 | 备注 | |------|---|---|---|---|------|------|------| | 编号色块（方形） | 0.60 | item_y+0.15 | 0.40 | 0.40 | — | — | 非激活=secondary，激活=primary | | 编号文字 | 0.60 | item_y+0.15 | 0.40 | 0.40 | caption_size | text_light / text_dark | 居中 | | 章节编号文字（"01"） | 1.15 | item_y+0.15 | 0.60 | 0.40 | body_size | text_muted | 左 | | 章节标题 | 1.80 | item_y+0.15 | 8.50 | 0.45 | subtitle_size | text_dark→primary（激活） | 左，激活时粗体 | | 页码 | 10.50 | item_y+0.15 | 1.80 | 0.40 | body_size | text_muted | 右 | | 描述文字 | 1.80 | item_y+0.65 | 9.00 | 0.45 | body_size-1 | text_muted | 左 | | 分隔细线 | 0.60 | item_y+item_h-0.02 | 12.133 | 0.02 | — | border | — | **激活项（active_index）额外元素**: - 色块: `primary`（非激活为 `secondary`） - 标题: `primary`，bold=True - 左侧 accent 竖条: x=0.58, y=item_y, w=0.04, h=item_h-0.02, fill=accent - 行背景: 轻微高亮矩形（x=0.60, y=item_y, w=12.133, h=item_h-0.02, fill=secondary, 透明度低） ### 变体 B（两列布局，4-8 项） **每列宽计算** ``` col_w = (12.133 - 0.40) / 2 = 5.867" # 两列各5.867"，中间间距0.40" col_x[0] = 0.60 col_x[1] = 0.60 + 5.867 + 0.40 = 6.867 row_count = ceil(N / 2) available_h = 5.80 # 1.20 ~ 7.00 row_h = available_h / row_count ``` **单格结构（以 col_x, row_y 为基准）** | 元素 | x | y | w | h | 字号 | 颜色 | |------|---|---|---|---|------|------| | 格内色块（圆角矩形） | col_x | row_y | 5.867 | row_h-0.20 | — | card_bg / secondary | | 编号色块 | col_x+0.15 | row_y+0.20 | 0.45 | 0.45 | — | primary / secondary | | 编号文字 | col_x+0.15 | row_y+0.20 | 0.45 | 0.45 | caption_size | text_light | 居中 | | 章节标题 | col_x+0.75 | row_y+0.20 | 4.70 | 0.50 | body_size+2 | text_dark / primary | 左 | | 页码 | col_x+0.75 | row_y+0.75 | 4.70 | 0.35 | caption_size | text_muted | 左 | | 描述 | col_x+0.75 | row_y+1.10 | 4.70 | 0.40 | caption_size | text_muted | 左，可选 | --- ## 数据接口 ```python data = { "title": str, # 页面标题，如 "报告目录" "active_index": int, # 当前激活章节（0-indexed），-1 表示无激活 "variant": "list" | "grid", # 布局变体 "items": [ { "number": str, # 编号，如 "01", "02"（2字符） "title": str, # 章节标题（15字以内） "desc": str, # 可选，描述（25字以内） "page_range": str, # 可选，页码范围，如 "p.04-15" }, ... # 最多 8 项（list变体最多6项） ], } ``` --- ## 实现伪代码 ```python def layout_agenda(slide, data, theme): m = theme["margin"] sw, sh = 13.333, 7.5 cw = sw - 2 * m set_slide_bg(slide, theme["bg_light"]) add_text(slide, data["title"], x=m, y=0.25, w=cw, h=0.60, font_size=theme["title_size"]-2, color=theme["text_dark"], bold=True, font_name=theme["header_font"]) add_rect(slide, m, 0.90, 2.0, 0.04, fill=theme["accent"]) items = data["items"] N = len(items) active = data.get("active_index", -1) if data.get("variant", "list") == "list": list_y = 1.20 item_h = max(0.90, (sh - list_y - 0.30) / N) for i, item in enumerate(items): iy = list_y + i * item_h is_active = (i == active) # 激活行高亮背景 if is_active: add_rect(slide, m, iy, cw, item_h-0.02, fill=theme["secondary"], alpha=30) # 左侧 accent 竖线 add_rect(slide, m-0.02, iy, 0.04, item_h-0.02, fill=theme["accent"]) # 编号色块 block_color = theme["primary"] if is_active else theme["secondary"] add_rect(slide, m, iy+0.15, 0.40, 0.40, fill=block_color) add_text(slide, item["number"], x=m, y=iy+0.15, w=0.40, h=0.40, font_size=theme["caption_size"], color=theme["text_light"] if is_active else theme["text_dark"], align="center", bold=True, font_name=theme["body_font"]) # 章节标题 title_color = theme["primary"] if is_active else theme["text_dark"] add_text(slide, item["title"], x=1.20, y=iy+0.15, w=8.50, h=0.45, font_size=theme["subtitle_size"], color=title_color, bold=is_active, font_name=theme["header_font"]) # 页码 if item.get("page_range"): add_text(slide, item["page_range"], x=10.50, y=iy+0.15, w=1.80, h=0.40, font_size=theme["body_size"], color=theme["text_muted"], align="right", font_name=theme["body_font"]) # 描述 if item.get("desc"): add_text(slide, item["desc"], x=1.20, y=iy+0.65, w=9.30, h=0.45, font_size=theme["body_size"]-1, color=theme["text_muted"], font_name=theme["body_font"]) # 分隔线 add_rect(slide, m, iy+item_h-0.02, cw, 0.02, fill=theme["border"]) ``` --- ## 设计要点 1. **激活章节** 用三种视觉手段叠加：左侧 accent 竖线 + 行背景浅色 + 标题 primary 加粗 2. **编号色块** 激活时 `primary`，非激活时 `secondary`（浅色），颜色差异明显 3. **页码** 右对齐，浅色，非核心信息，不抢焦点 4. **分隔线** 很细（0.02"），`border` 色，营造整洁感不显突兀 5. **列表变体** 最多 6 项；超过 6 项改用 `grid` 变体 --- ## 测试数据示例 ```python data = { "title": "报告目录", "active_index": 1, # 第二章节为当前阅读位置 "variant": "list", "items": [ {"number": "01", "title": "宏观经济环境分析", "desc": "GDP增长、通胀、货币政策", "page_range": "p.04-15"}, {"number": "02", "title": "资产配置策略", "desc": "大类资产配置建议与逻辑", "page_range": "p.16-27"}, {"number": "03", "title": "固定收益市场", "desc": "利率走势与债券策略", "page_range": "p.28-39"}, {"number": "04", "title": "权益资产展望", "desc": "A股与港股配置机会", "page_range": "p.40-52"}, {"number": "05", "title": "风险管理与压力测试", "desc": "尾部风险与情景分析", "page_range": "p.53-60"}, ], } ```