moda-document-print

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

moda-document-print

PREREQUISITE — load
moda-core
once per session (step-0, write contract, free/metered map). Already loaded? Skip ahead. If you cannot load it, the non-negotiables: run

moda doctor --json

before anything;

moda brand list

before creating; every write carries the latest revision — on

stale_revision

, re-read and retry once (it heals); send the canvas link the moment it exists; stuck or failed?

moda ask "<question>"

— free and fast, never guess.

前提条件 —— 每个会话需加载一次
moda-core
（步骤0，编写合约、免费/计量映射）。已加载？直接跳过。若无法加载，需执行以下必做操作：先运行

moda doctor --json

；创建前先执行

moda brand list

；每次写入操作需携带最新版本号 —— 遇到

stale_revision

时，重新读取并重试一次即可恢复；画布链接生成后立即发送；遇到卡顿或失败？执行

moda ask "<问题>"

—— 免费且响应迅速，切勿自行猜测。

Sizes and defaults

尺寸与默认设置

All

--category prints

; sizes are canvas pixels at the piece's physical intent.

Piece	Size	Notes
Flyer / one-sheet	816×1056	US-Letter (A4: 794×1123)
Poster 18×24in	1350×1800	24×36in → 1800×2700; type scales with the sheet
Trifold brochure	1056×816 × 2 pages	3 panels per side — imposition in references/print.md
Menu	816×1056	often 2 pages; keep prices on one grid
Resume	816×1056	one page unless the user says otherwise
Certificate	1056×816	landscape Letter
Invitation	525×750	5×7in
Business card	375×225	3.5×2in + bleed; 2 pages (front, back)
Merch (t-shirt, sticker, mug)	see references/print.md	flat art, no bleed assumptions

A print piece is read up close — pack the page. Icons, rules, stat rows and cards carry structure; a screen-sparse layout looks empty in the hand.
Keep meaningful content ≥3mm (~12px at Letter scale) off every trimmed edge; let backgrounds and colour fields run to the edge.
A poster or flyer FOR a platform (an Instagram poster) is not this skill — the platform child owns the size and safe areas.

所有物料均属于

--category prints

；尺寸为对应实体物料的画布像素值。

物料类型	尺寸	说明
传单/单页	816×1056	美国信纸规格（A4规格为794×1123）
18×24英寸海报	1350×1800	24×36英寸海报对应尺寸为1800×2700；字体大小随纸张尺寸缩放
三折页手册	1056×816 × 2页	每面含3个折页面板 —— 拼版规则见references/print.md
菜单	816×1056	通常为2页；需将价格统一放在同一网格中
简历	816×1056	默认为1页，除非用户另有说明
证书	1056×816	横向信纸规格
邀请函	525×750	5×7英寸规格
名片	375×225	3.5×2英寸规格+出血位；共2页（正面、背面）
周边（T恤、贴纸、马克杯）	详见references/print.md	平面设计图，不预设出血位

打印物料需近距离阅读 —— 内容需紧凑排版。图标、分隔线、统计行和卡片可增强结构感；屏幕上看起来稀疏的布局，打印后会显得空洞。
重要内容需距离每个裁切边缘至少3毫米（约相当于信纸规格下的12像素）；背景和色块可延伸至边缘。
针对平台的海报或传单（如Instagram海报）不属于本技能范畴 —— 相关尺寸和安全区域由对应平台子模块负责。

Recipe — one printed piece

单份打印物料制作流程

moda canvas create --name "[Piece]" --intent "[one-line brief]" --size [WxH from the table] --pages [1 or 2] --category prints --brand [KIT]

— send the link immediately.

Read the source with your harness's file-reading tools; scope the piece to one dense page (or one page per side) before authoring anything.
Imagery: a poster or invitation usually earns a generated hero —
```
moda media generate-image --prompt "[subject, brand palette]" --model [MODEL]
```
; a menu or resume is a legitimate type-only piece. State the choice.
Author one apply per page/side:
```
moda canvas markup [CANVAS_REF] --file - --page [PAGE_ID]
```
(references/markup.md), with the kit's tokens.
```
moda canvas screenshot [CANVAS_REF]
```
— check edge clearance, fold panels, type floor, and that nothing critical sits in a trim zone; fix and re-screenshot.
```
moda export [CANVAS_REF] --format pdf -o [piece].pdf
```
— the default PDF is vector with selectable text and embedded fonts, crisp at any print scale. Do NOT pass
```
--flatten
```
unless the user asks for raster.
Read
```
warnings[]
```
and relay honestly:
```
pdf_links_flattened
```
(links are plain text in print — expected here),
```
font_substituted
```
(a face did not embed).

执行

moda canvas create --name "[物料名称]" --intent "[一行简短说明]" --size [表格中的宽×高] --pages [1或2] --category prints --brand [品牌套件]

—— 立即发送生成的画布链接。

使用工具读取源文件；在开始创作前，将物料范围限定为单页紧凑内容（或每面一页）。
图像素材：海报或邀请函通常需要生成主视觉图 —— 执行
```
moda media generate-image --prompt "[主题、品牌调色板]" --model [模型]
```
；菜单或简历可仅使用文字排版。需说明选择的方案。
为每页/每面执行一次标记操作：
```
moda canvas markup [CANVAS_REF] --file - --page [PAGE_ID]
```
（详见references/markup.md），使用品牌套件的标记符。
执行
```
moda canvas screenshot [CANVAS_REF]
```
—— 检查边缘留白、折页面板、最小字体大小，确保关键内容不在裁切区域内；如有问题，修复后重新截图。
执行
```
moda export [CANVAS_REF] --format pdf -o [物料名称].pdf
```
—— 默认生成的PDF为矢量格式，包含可选文本和嵌入字体，在任何打印尺寸下都清晰。除非用户要求，否则请勿添加
```
--flatten
```
参数。
读取
```
warnings[]
```
并如实告知用户：
```
pdf_links_flattened
```
（打印版中链接为纯文本 —— 此为预期情况）、
```
font_substituted
```
（某款字体未嵌入）。

Recipe — trifold brochure

三折页手册制作流程

Create TWO landscape Letter pages (1056×816),
```
--category prints
```
.
Panel order is NOT reading order: outside page is panels 5-6-1, inside page is 2-3-4 — the imposition map is in references/print.md. Author to the map.
Author each side in one apply; keep a ~6px gutter of quiet either side of each fold line so no headline lands on a crease.
Screenshot, verify panel-by-panel against the reading order, then export PDF.

创建2页横向信纸规格（1056×816）的画布，设置
```
--category prints
```
。
面板顺序并非阅读顺序：外页面板顺序为5-6-1，内页为2-3-4 —— 拼版映射见references/print.md。需按照该映射进行创作。
为每面执行一次标记操作；在每条折痕两侧保留约6像素的留白区域，避免标题落在折痕上。
截图，逐面板核对阅读顺序，然后导出PDF。

Examples

示例

"a poster for our concert" → single-piece recipe at 18×24in.
"a trifold brochure for the open house" → trifold recipe, imposed correctly.
"make my resume look designed" → single-piece recipe at 816×1056, type-only.
"business cards for the team" → 2 pages (front/back) with bleed, PDF out.
"a t-shirt for the conference" → merch row: flat art, brand marks at real scale.

“为我们的音乐会制作海报” → 采用单份物料流程，尺寸为18×24英寸。
“为开放日制作三折页手册” → 采用三折页流程，正确拼版。
“优化我的简历排版” → 采用单份物料流程，尺寸为816×1056，仅使用文字排版。
“为团队制作名片” → 2页（正面/背面）含出血位，输出PDF。
“为会议制作T恤” → 属于周边类：平面设计图，品牌标识按实际尺寸放置。

Errors

错误处理

Any typed error → load moda-core and read its recovery reference. The trap here is a flattened PDF: the raster default is for screens, so print exports omit

--flatten

stale_revision

heals — re-read and retry once.

任何输入错误 → 加载moda-core并查看其恢复参考文档。此处常见陷阱是生成扁平化PDF：默认的光栅化设置适用于屏幕，因此打印导出时请勿添加

--flatten

参数。遇到

stale_revision

错误可恢复 —— 重新读取并重试一次即可。

Make it recurring

批量重复制作

An event series — a monthly menu, a recurring certificate run — is the cheapest return reason Moda has: save the proven piece with moda-templates, then let moda-automate fill in the blanks each cycle.

See also: moda-document — reports, one-pagers, multi-page documents · moda-core — the contract, recovery, everything Moda can do.

系列活动 —— 月度菜单、定期证书制作 —— 是Moda性价比最高的应用场景：使用moda-templates保存已验证的物料模板，然后通过moda-automate在每个周期自动填充内容。

另见：moda-document —— 报告、单页文档、多页文档 · moda-core —— 合约、错误恢复、Moda所有功能。

References

参考文档

Doc	Load when
references/print.md	sizes, bleed, print density, the trifold imposition map, merch
references/document-design.md	scope, density, page balance
references/export.md	vector vs flattened PDF, warnings

文档	加载时机
references/print.md	尺寸、出血位、打印密度、三折页拼版映射、周边设计
references/document-design.md	内容范围、排版密度、页面平衡
references/export.md	矢量PDF vs 扁平化PDF、警告信息