zball

Typesetter 文档

图表与打印

插图

#!figure 区域声明插图:src 指向图片,正文段落成为图注;图注自动编号并可被引用:

#!figure(src: "photo.jpg", alt: "说明文字", label: "fig-a")
图注居中排布,编号与公式编号同源。
#figure!@fig-a所示……
  • scale: 0.5 把显示宽度定为版心的一半;不指定时按原始尺寸排入、过宽自动收敛到版心
  • w: 400, h: 300 直接声明图片固有尺寸,跳过加载探测(静态构建友好)
  • 加载失败渲染带 alt 的占位框,文档不停摆

float: "right"(或 "left")让插图浮动到版心一侧,正文按 TeX parshape 语义环绕:前若干行以收窄宽度断行、越过浮动框底部后自动恢复整幅;收窄行照常两端对齐。图注进入浮动框内,与图一起构成原子单元。

表格

#!table 区域以 | 分列,align 逐列指定 l/c/r 对齐,单元格支持完整行内标记与公式:

#!table(cols: 2, align: "cl", label: "tbl-a")
恒等式 | 名称
$e^(i pi) + 1 = 0$ | 欧拉恒等式
#table!
恒等式名称
$e^(i pi) + 1 = 0$欧拉恒等式
$a^2 + b^2 = c^2$勾股定理

分页打印

文章页右上角的「打印」按钮把当前文档送入分页引擎:布局按带切分、贪心装页——孤行寡行回退、标题不落页尾、代码逻辑行/显示公式/图与图注为原子带,不会被页边界切开。随后调起浏览器打印对话框,「另存为 PDF」即得排版一致的 PDF;分页只移动页边界,绝不重排断行,打印稿与屏幕逐行一致。