如何为Typst文档的页眉与页脚添加背景色？

问题描述 #

需要为Typst文档的页眉、页脚区域设置背景色，当前文档主体为米白色（rgb("#F2F0EF")）符合需求，但尝试多种方法均未成功设置页眉页脚背景色，包括：

• 使用rect元素指定fill属性
• 配置set page的background参数

尝试的代码片段如下：

错误代码1：嵌套错误的rect元素 #

rect(rect(
  width: 100%,
  height: 100%,
  fill: aqua
))

错误代码2：set page参数语法错误 #

#let title-page(title: none, author: none,
  date: none, name: none, body) = {
  
  set page(fill: rgb("#20746c"), margin: (top: 1.5in, rest: 1.5in))
  set text(font: "Source Sans Pro", size: 14pt)
  set heading(numbering: "1.1.1")
  line(start: (0%, 0%), end: (8.5in, 0%), stroke: (thickness: 2pt))
  
  align(center)[
    #text(size: 48pt, fill: white, strong(title)) 
    #v(1em)
    #text(size: 24pt, fill: white, strong(name))
    #v(1em)
    #text(size: 24pt, author) 
    #v(2em)
    #text(size: 16pt, date)
  ]

  pagebreak()
  // 此处错误：将rect直接作为set page的参数，语法不符合要求
  set page(fill: rgb("#F2F0EF"), margin: auto, 
  rect(
  width: 100%,
  height: 100%,
  fill: aqua))
  

  align(horizon, outline(indent: auto))
  
  body
}

错误代码3：背景元素定位错误 #

#set page(
  background: (
    box(fill: blue, width: 100%, height: 2cm, y: 100% - 2cm),  // 定位错误，顶部背景位置不对
    box(fill: blue, width: 100%, height: 2cm, y: 0cm),  // 定位错误，底部背景位置不对
  )
)

错误原因分析 #

1. 嵌套rect元素：无意义的嵌套，且未定位到页眉页脚区域，仅生成全屏矩形，无法实现需求。
2. set page参数错误：将rect直接写入set page的参数列表，违反Typst语法，set page的background需接收元素数组而非直接放置元素。
3. 背景定位错误：Typst页面坐标系以左上角为原点（(0%,0%)），向下为y轴正方向，原代码的y轴坐标导致背景元素位置颠倒。

正确实现方案 #

通过set page的background参数添加定位准确的box元素，同时匹配页面边距避免正文与背景重叠：

// 全局页面配置：主体米白色，页眉页脚背景色
set page(
  fill: rgb("#F2F0EF"), // 页面主体底色
  // 页边距与页眉页脚高度对应，避免正文重叠
  margin: (top: 2cm, bottom: 2cm, left: 1.5cm, right: 1.5cm),
  background: (
    // 页眉背景：顶部全屏，高度等于上边距
    box(
      fill: rgb("#20746c"), // 页眉背景色
      width: 100%,
      height: 2cm,
      x: 0%,
      y: 0% // 定位到页面顶部
    ),
    // 页脚背景：底部全屏，高度等于下边距
    box(
      fill: rgb("#20746c"), // 页脚背景色
      width: 100%,
      height: 2cm,
      x: 0%,
      y: 100% - 2cm // 定位到页面底部上方2cm处
    )
  )
)

// 标题页单独配置（若需）
#let title-page(title: none, author: none, date: none, name: none, body) = {
  // 覆盖全局页面设置，标题页使用纯色背景
  set page(
    fill: rgb("#20746c"),
    margin: (top: 1.5in, rest: 1.5in),
    background: () // 标题页无需页眉页脚背景
  )
  set text(font: "Source Sans Pro", size: 14pt)
  set heading(numbering: "1.1.1")
  line(start: (0%, 0%), end: (8.5in, 0%), stroke: (thickness: 2pt))
  
  align(center)[
    #text(size: 48pt, fill: white, strong(title)) 
    #v(1em)
    #text(size: 24pt, fill: white, strong(name))
    #v(1em)
    #text(size: 24pt, fill: white, author) 
    #v(2em)
    #text(size: 16pt, fill: white, date)
  ]
  
  pagebreak()
  reset page // 恢复全局页面配置
  align(horizon, outline(indent: auto))
  body
}

// 调用标题页并添加正文
#title-page(
  title: "我的Typst文档",
  author: "文档作者",
  date: "2024年5月",
  name: "文档副标题"
)[
  #heading(1) 正文第一章
  这是文档正文内容，页面主体为米白色，页眉页脚已设置指定背景色。
  #heading(2) 正文小节
  继续添加更多正文内容，页眉页脚背景会自动应用到所有后续页面。
]

关键要点 #

• set page的fill是页面底层底色，background是叠加在其上的元素，页眉页脚背景会覆盖主体底色。
• 页眉页脚的高度需与页面margin的top/bottom值一致，确保正文内容不会侵入背景区域。
• 标题页需单独设置时，用set page覆盖全局配置，完成后用reset page恢复全局设置。

内容的提问来源于stack exchange，提问作者Pss