Typst项目中使用网格布局实现附录标题对齐的技术方案

在Typst文档排版系统中，自定义标题样式是一个常见需求。本文针对附录标题的特殊排版要求，详细介绍了一种基于网格布局的解决方案。

问题背景

在学术文档或技术手册中，附录部分通常需要特殊的标题格式。典型的附录标题由"Appendix"前缀和字母编号（如A、B等）组成，后跟标题文本。用户希望实现以下效果：

1. 前缀与标题文本之间有适当间距
2. 多行标题时保持对齐美观

初始尝试与问题

用户最初尝试使用#h()函数增加间距，但导致了程序崩溃。随后改用box容器方案，虽然解决了单行标题的问题，但在多行标题情况下出现了对齐异常。

技术解决方案

经过Typst开发团队的分析，推荐使用网格布局(grid)来实现这一需求。具体实现代码如下：

#show heading.where(level: 1): it => {
  grid(
    columns: 2,
    gutter: 1em,
    align(right, counter(heading).display()),
    text(size: 12pt, weight: "regular", it.body),
  )
}

实现原理

1. 网格布局：创建两列网格，第一列用于显示前缀，第二列显示标题文本
2. 间距控制：通过gutter参数精确控制列间距
3. 前缀对齐：使用align(right,...)实现前缀右对齐
4. 文本样式：通过text函数自定义标题文本的字体大小和粗细

版本兼容性说明

需要注意的是，在Typst的不同版本中，标题的实现方式有所变化：

• 开发版本已修复了#h()函数的崩溃问题
• 新版本中par的悬挂缩进属性不再影响标题样式

最佳实践建议

1. 对于正式项目，建议使用稳定版本的Typst
2. 复杂标题样式推荐使用网格布局而非简单的间距调整
3. 可以通过counter(heading)动态获取标题编号
4. 使用where选择器针对特定级别标题应用样式

效果展示

该方案最终实现了完美的附录标题排版效果：

• 前缀"Appendix A"右对齐
• 标题文本左对齐
• 多行情况下保持整齐的对齐
• 可自定义的前缀与标题间距

这种网格布局方案不仅适用于附录标题，也可推广到其他需要特殊格式的标题场景，为Typst用户提供了灵活而强大的排版工具。