重置Typst页边距后出现分页问题，求解决方案及原理

一、禁用分页的解决方法 #

• 在重置页边距的set page指令前，添加pagebreak(prevent: true)强制禁止分页：

  set page(margin: 0)
  block([#set align(center)
         #text(size: 32pt, weight: "bold") "标题"
         #v(12pt)
         #text(size: 14pt) "作者：XXX"
         #text(size: 14pt) "机构：XXX"], fill: darkblue)
  pagebreak(prevent: true) // 强制阻止分页
  set page(margin: (top: 2cm, bottom: 2cm, left: 2.5cm, right: 2.5cm))
  // 后续文档内容
  lorem(100)
  

• 或者将标题块和页边距重置放在同一个page作用域内，用show规则限定范围：

  show: page => page(margin: 0) {
    block([#set align(center)
           #text(size: 32pt, weight: "bold") "标题"
           #v(12pt)
           #text(size: 14pt) "作者：XXX"
           #text(size: 14pt) "机构：XXX"], fill: darkblue)
    set page(margin: (top: 2cm, bottom: 2cm, left: 2.5cm, right: 2.5cm))
  }
  // 后续文档内容
  lorem(100)
  

二、其他实现思路 #

• 使用rect元素手动绘制背景块，结合offset调整位置覆盖页边距：

  set page(margin: (top: 2cm, bottom: 2cm, left: 2.5cm, right: 2.5cm))
  // 计算背景块宽度：页面宽度 = 左页边距 + 内容宽度 + 右页边距
  let page-width = measure(width: 100%).width + 2.5cm + 2.5cm
  rect(
    width: page-width,
    height: auto,
    fill: darkblue,
    offset(x: -2.5cm), // 向左偏移左页边距宽度
    [
      #set align(center)
      #text(size: 32pt, weight: "bold", white) "标题"
      #v(12pt)
      #text(size: 14pt, white) "作者：XXX"
      #text(size: 14pt, white) "机构：XXX"
      #v(16pt) // 增加内边距避免内容贴边
    ]
  )
  // 后续文档内容
  lorem(100)
  

• 利用header区域自定义标题栏，结合set header和block实现跨边距背景：

  set page(margin: (top: 2cm, bottom: 2cm, left: 2.5cm, right: 2.5cm))
  set header(
    block(
      width: 100% + 2.5cm + 2.5cm,
      offset(x: -2.5cm),
      fill: darkblue,
      [
        #set align(center)
        #text(size: 32pt, weight: "bold", white) "标题"
        #v(12pt)
        #text(size: 14pt, white) "作者：XXX"
        #text(size: 14pt, white) "机构：XXX"
        #v(16pt)
      ]
    )
  )
  // 后续文档内容
  lorem(100)
  

三、分页产生的原因解释 #

Typst的set page指令是全局作用域变更，当你先设置margin:0渲染标题块后，再重置页边距为page-config.margin时，Typst会将这个页边距变更视为新的页面配置起点。由于标题块是在旧页边距（0）下渲染的，重置页边距后，Typst会重新计算当前页面的内容布局，判断当前剩余空间是否能容纳后续内容，若旧页边距下的内容高度加上新页边距的顶部空间超过了页面高度，就会触发自动分页。简单来说，两次set page的配置切换导致布局计算中断，触发了分页逻辑。

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