imagine-best-practices

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

When to use

使用场景

Use this skill whenever you are working on Imagine figures for scientific articles, especially when you need:
  • publication-oriented sizing (
    mm
    +
    dpi
    )
  • SVG-first figure components
  • chart/diagram/multi-panel/math patterns
  • deterministic scaffolding for new projects and figures
  • reliable PNG/SVG export and renderer debugging
当你在为科学论文制作Imagine图表时,均可使用该技能,尤其在你需要以下功能时:
  • 面向出版的尺寸设置(
    mm
    +
    dpi
  • 优先采用SVG格式的图表组件
  • 图表/示意图/多面板/数学公式样式
  • 为新项目和图表提供确定性脚手架
  • 可靠的PNG/SVG导出功能及渲染器调试

Scaffolding

脚手架

When creating projects and figures, load ./rules/scaffold-cli.md and ./rules/scaffold-templates.md first.
创建项目和图表时,请先加载./rules/scaffold-cli.md./rules/scaffold-templates.md

How to use

使用方法

Read individual rule files for focused implementation guidance:
  • rules/project-structure.md - Project folder and module conventions for Imagine
  • rules/manifest-and-variants.md - Figure manifest schema, variants, props, controls, sizing
  • rules/components-svg-only.md - SVG-first component patterns for clean vector export
  • rules/publication-quality.md - Paper-ready design checklist (size, typography, color, multi-panel)
  • rules/rendering-and-export.md - Render pipeline and export workflows
  • rules/troubleshooting.md - Common rendering and export failures
  • rules/scaffold-cli.md -
    new_project.mjs
    and
    new_figure.mjs
    usage
  • rules/scaffold-templates.md - Included templates and default kind mappings
  • rules/chart-patterns.md - D3 scale/axis/grid/legend chart patterns
  • rules/publication-chart-style.md - Chart typography, stroke, marker, and density standards
  • rules/diagram-primitives.md - Box/Arrow/Label/Callout usage
  • rules/layout-and-spacing.md - Diagram alignment and spacing heuristics
  • rules/multi-panel-guidelines.md - Panel labels, shared legends, spacing
  • rules/mathjax-and-rendering.md - MathJax behavior in render/export
  • rules/latex-authoring-tips.md - LaTeX writing patterns for figure text
  • rules/render-cli.md - Renderer CLI cookbook
  • rules/debugging.md - Renderer debugging playbook
阅读单个规则文件以获取针对性的实施指导:
  • rules/project-structure.md - Imagine的项目文件夹及模块规范
  • rules/manifest-and-variants.md - 图表清单架构、变体、属性、控件及尺寸设置
  • rules/components-svg-only.md - 优先采用SVG的组件样式,以实现清晰的矢量导出
  • rules/publication-quality.md - 符合论文要求的设计检查清单(尺寸、排版、色彩、多面板)
  • rules/rendering-and-export.md - 渲染流程及导出工作流
  • rules/troubleshooting.md - 常见渲染及导出问题排查
  • rules/scaffold-cli.md -
    new_project.mjs
    new_figure.mjs
    的使用方法
  • rules/scaffold-templates.md - 内置模板及默认类型映射
  • rules/chart-patterns.md - D3比例尺/坐标轴/网格/图例的图表样式
  • rules/publication-chart-style.md - 图表的排版、描边、标记及密度标准
  • rules/diagram-primitives.md - 框/箭头/标签/标注的使用方法
  • rules/layout-and-spacing.md - 示意图的对齐及间距规则
  • rules/multi-panel-guidelines.md - 多面板标签、共享图例及间距设置
  • rules/mathjax-and-rendering.md - MathJax在渲染/导出中的表现
  • rules/latex-authoring-tips.md - 图表文本的LaTeX撰写规范
  • rules/render-cli.md - 渲染器CLI使用手册
  • rules/debugging.md - 渲染器调试指南