标题：Indent items in bibliography with typst

随着开源排版系统 Typst 在学术写作领域的迅速崛起，越来越多用户开始从 LaTeX 或 Word 转向这一轻量级工具。与 LaTeX 相比，Typst 语法更简洁，编译速度更快，但其生态仍在快速完善中。近期，关于“如何在 Typst 中为参考文献条目添加缩进”的话题在社区引发热议——这一点看似简单，却直接影响论文的格式规范性。本文将详细解析 Typst 中实现参考文献悬挂缩进（即第一行顶格、后续行缩进）的几种主流方法，帮助用户轻松应对 APA、MLA 等常见引用格式要求。

为什么要关注参考文献缩进？

在正式出版物中，参考文献列表通常采用“悬挂缩进”（hanging indent）格式：每条文献的第一行左对齐，从第二行起整体向右缩进固定距离（常见为 0.5 英寸或 1.27 厘米）。这种排版方式使作者姓名与文献标题清晰区分，便于读者快速定位。无论是学术论文、学位论文还是期刊稿件，多数出版社都对此有明确要求。Typst 自带的参考文献渲染工具虽然功能强大，但默认样式并不包含缩进，用户需要手动调整。

方法一：通过样式函数全局设定

Typst 中的 bibliography 函数支持通过 style 参数引用自定义样式文件。如果你使用内置的 "apa"、"ieee" 等样式，可以在样式文件中添加缩进规则。例如，创建一个 my-style.csl 文件（Typst 兼容 CSL 样式），在其中设置：

<layout>
  <hanging-indent>hanging-indent=1.27cm</hanging-indent>
  ...
</layout>

然后在主文档中调用：

#bibliography("refs.bib", style: "my-style.csl")

但此方法对 CSL 语法熟悉度要求较高，且 Typst 对 CSL 的支持仍在优化中。更简便的方式是利用 Typst 的 show 规则。

方法二：使用 show 规则与 par 属性

这是目前社区推荐的通用方案。在文档头部添加如下代码：

#show bibliography: set par(first-line-indent: 0pt, hanging-indent: 1.27cm)
  • first-line-indent: 0pt 让第一行无额外缩进；
  • hanging-indent: 1.27cm 使从第二行开始向右缩进 1.27 厘米。

请注意，bibliography 是一个特殊的环境（block），该规则会作用于其中所有段落。若你的参考文献条目包含多个段落（正常情况下每条只占一段），此方法可以精确满足需求。

方法三：手动设置条目样式

如果只需要对个别条目调整，或者希望更精细地控制每条文献的格式，可以借助 citing 函数和 list 环境。例如，先禁用自动编号，然后手动构建列表：

#set page(margin: 2cm)
#show bibliography: set block(spacing: 8pt)

#bibliography("refs.bib", full: true)

在此基础上，通过 show ref 自定义每条内容的输出。但该方式复杂度较高，一般不建议用于整篇文档。

常见问题与注意事项

  1. 缩进单位兼容性：Typst 默认采用 cm、in、pt 等单位，1 英寸 = 2.54 厘米。建议在文档开头统一设定 #set page 的边距，避免缩进与页面布局冲突。
  2. 与中文排版配合：中文论文的参考文献缩进要求与英文基本一致，但需注意中文字符的宽度。使用 1.27cm 或 2em 均可，2em 在中文中相当于两个汉字的宽度，视觉效果更均衡。
  3. 版本差异：Typst 仍在快速迭代，0.11 及更高版本已原生支持 hanging-indent 属性。若使用旧版本，请升级到最新版或改用 text-indent 配合负值模拟。
  4. 多栏布局：若参考文献分栏，缩进值可能需要按栏宽比例调整。可用 #set columns(2) 后单独设定缩进，或使用 context 动态计算。

实战示例：APA 第七版格式

以下是一个完整的 APA 格式参考文献段落示例（假设已加载参考文献数据库）：

#show bibliography: set par(
  first-line-indent: 0pt,
  hanging-indent: 1.27cm,
  leading: 0.5em      // 行间距
)

#bibliography("references.bib", style: "apa")

编译后每条文献都会自动呈现符合 APA 规范的悬挂缩进，且条目之间保留合理间距。

结语

Typst 凭借其直观的语法和强大的函数式定制能力，使得参考文献格式调整变得异常灵活。对于“悬挂缩进”这一经典需求，用户仅需几行代码即可全局生效，无需像 LaTeX 那样手动加载复杂包或编写样式文件。随着 Typst 社区贡献的样式库日益丰富，未来我们有望直接通过一行 #bibliography(style: "apa-hanging") 解决问题。在此之前，掌握上述方法足以应对绝大多数出版场合。无论是撰写毕业论文、投稿期刊还是整理个人书单，让 Typst 帮你一键规范参考文献排版，省时又省心。