The stickiness of my heading broke and I don't know why

Questions
1

Hello everyone,

I suppose this is similar to this topic but several typst updates later and a fix about this very issue.

I’m in this situation where the heading is an orphan. I don’t understand how this happens since headings are sticky by default…

Screenshot of my situation, where the heading is an orphan|690rule : x448
Screenshot of my situation, where the heading is an orphan|690rule : x4481358×882 72.3 KB

Just in case, I made sure the headings are sticky : #show heading: set block(sticky: true) but this did nothing.

I also don’t see anything that could break the stickiness in my level 2 heading rule :

#show heading.where(level: 2): it => {
  v(1.5em)
  align(center)[
    #text(
      size: 12pt,
      weight:"regular",
    )[#smallcaps[#it.body]]]
    }

So I don’t know what I am doing wrong here… Do you know what’s going on ?

Thanks in advance !

2

Hi @qntnlq,

if you use it.body your heading is no longer surrounded by a block, so it can’t be sticky anymore. You need to either use it directly or surround your heading manually with a block again.

#show heading.where(level: 2): set align(center)
#show heading.where(level: 2): it => block({
  v(1.5em)
  text(
    size: 12pt,
    weight:"regular",
  )[#smallcaps[#it.body]]
})
1 Like
3

Didn’t see that one coming.
It definitely works with #it. So thank you very much, problem solved !

I have a pretty noob question, though : what are the pros and cons of using #it or #it.body ?
I must admit I mostly used #it.body because I’d seen many people use it, without questioning the implications much.

4

it is the element itself, in this case the full heading (and the name it is just a convention). If you hover over it in the Typst web application or in Tinymist you can see it’s content.

image
image323×304 25.6 KB

it.body is only the body part of the heading.

image
image322×126 14 KB

The detail that a heading is surrounded by a block is unfortunately currently not visible and you just have to know :(.

I can’t give pros/cons as it depends on what you want to do.

1 Like
5

If you output the heading again (you use it) then other/older show rules for heading will also apply to that. Including the built-in rule that produces a block, and the numbering, and the title.

If you want to change how the numbering is placed, then you can’t use it. Because you want to place the numbering yourself, in a different way.

If you want previous show rules on heading to still apply, then you can’t use it.body. Because then there’s no old heading element left to run those rules on.

1 Like