Typst模板制作完全指南：从基础到实战

Typst模板制作完全指南：从基础到实战

typst A new markup-based typesetting system that is powerful and easy to learn. 项目地址: https://gitcode.com/gh_mirrors/ty/typst

前言

在Typst排版系统中，模板是提升文档编写效率的核心工具。本文将系统性地介绍如何创建和使用Typst模板，从基础概念到实际应用场景，帮助您构建可复用的专业文档样式。

模板基础概念

函数式模板原理

Typst模板本质上是一个接收文档内容并返回格式化内容的函数。这种设计模式使得模板可以像普通函数一样被调用和组合。

#let amazed(term) = box[✨ #term ✨]

You are #amazed[beautiful]!

这个简单示例展示了：

1. 定义amazed函数接收一个参数
2. 返回带有修饰的内容块
3. 使用box防止内容被换行分割

命名参数与默认值

专业模板通常需要更灵活的配置选项，Typst支持命名参数和默认值：

#let amazed(term, color: blue) = {
  text(color, box[✨ #term ✨])
}

You are #amazed[beautiful]!
I am #amazed(color: purple)[amazed]!

全局样式应用

全文档显示规则

通过show:规则可以将模板应用于整个文档，无需显式包裹内容：

#let amazed(term, color: blue) = {
  text(color, box[✨ #term ✨])
}
#show: amazed
I choose to focus on the good...

样式嵌套技术

在模板函数内部可以嵌入set和show规则，实现层级样式控制：

#let template(doc) = [
  #set text(font: "Inria Serif")
  #show "something cool": [Typst]
  #doc
]

#show: template
I am learning something cool today.

会议论文模板实战

核心结构设计

将之前章节的会议论文样式转化为可重用模板：

#let conf(title, doc) = {
  set page(
    paper: "us-letter",
    margin: auto,
    header: align(right + horizon, title),
    columns: 2,
  )
  set par(justify: true)
  set text(font: "Libertinus Serif", size: 11pt)
  
  // 标题样式规则
  show heading.where(level: 1): it => block(
    align(center,
      text(13pt, weight: "regular", smallcaps(it.body))
  )
  
  doc
}

参数化设计要素

1. 标题作为位置参数
2. 文档内容自动传递
3. 使用代码块({})简化set规则编写

高级模板特性

结构化数据参数

支持作者列表等复杂数据结构：

authors: (
  (
    name: "Theresa Tungsten",
    affiliation: "Artos Institute",
    email: "tung@artos.edu",
  ),
  // 更多作者...
)

动态布局系统

根据作者数量自动调整网格布局：

let count = authors.len()
let ncols = calc.min(count, 3)
grid(
  columns: (1fr,) * ncols,
  row-gutter: 24pt,
  ..authors.map(author => [
    #author.name \
    #author.affiliation \
    #link("mailto:" + author.email)
  ]),
)

工程化实践

模块化组织

将模板分离到独立文件conf.typ中，主文档通过导入使用：

#import "conf.typ": conf
#show: conf.with(...)

预设参数技术

使用.with方法预设模板参数，简化调用：

#show: conf.with(
  title: [Towards Improved Modelling],
  authors: (...),
  abstract: lorem(80),
)

最佳实践建议

1. 样式分离：保持模板与内容分离
2. 参数设计：合理使用位置参数和命名参数
3. 响应式布局：根据内容动态调整样式
4. 文档注释：为模板添加使用说明

通过本指南，您已经掌握了Typst模板系统的核心概念和实践技巧。模板不仅能提升个人工作效率，更是团队协作和样式统一的重要工具。建议从简单模板开始，逐步构建适合自己工作流的模板库。

typst A new markup-based typesetting system that is powerful and easy to learn. 项目地址: https://gitcode.com/gh_mirrors/ty/typst