Improve layout of multi-line headings

[deffi]

Example document:

#set heading(numbering: "1.1")

= One
== One point one: #lorem(20)

Result (Typst 0.8):

It seems like this could be improved by aligning subsequent lines with the text of the first line, not with the number

This is how LaTeX renders the same thing:

And MS Word 2016:

See also #2411 (similar issue, but for the outline instead of the heading)

[tingerrr]

This, as well as #2411, could be fixed by making headings show as stack(dir: ltr, numbering, body) by default as well as doing the same for outline.entry.

EDIT: This solution is blocked by #2422, but can be worked around using a grid for now.

[laurmaedje]

The stack solution doesn't work correctly at the moment because a horizontal stack, in contrast to a grid, doesn't correctly size its children to fit the width. This means that the body will overflow into the right margin. This should be fixed.

[Enivex]

Isn't this largely a matter of personal preference, and something that would vary from template to template?

I'm honestly not a fan of having text aligned to a different vertical line than the margin. That being said, I would never choose titles this long in the first place.

[tingerrr]

For now, you can use:

#show heading: it => if it.numbering != none {
  grid(columns: 2, gutter: 0.3em, counter(heading).display(it.numbering), it.body)
} else {
  it.body
}

Which is faithful to the default show rule. A similar thing can be done for outline.entry in #2411.

[deffi]

Isn't this largely a matter of personal preference, and something that would vary from template to template?

It may be a matter of personal preference, or it may be a matter of (corporate/academic) style guidelines. So I agree that this should be configurable; I wasn't trying to imply that the way LaTeX or Word are doing it is the only correct one.

I'm honestly not a fan of having text aligned to a different vertical line than the margin.

Not even in bullet lists? I think that aligning the text to the right of the bullets is by far the most common layout here. An outline (cf. #2411) seems pretty similar to a (nested) numbered list, and many authors are also applying that layout to the headings themselves.

That being said, I would never choose titles this long in the first place.

This, too, would probably depend on the context. A very quick survey of some textbooks and technical documentation within my reach indicates that titles which exceed the length of a line aren't terribly uncommon.

[haenoe]

Hey! Big Typst fan here - thank you all for your tremendous work. I would love to help the project and contribute.
Therefore my question: Is this issue still relevant?

After looking a bit around the codebase my first idea was to solve it using the same technique applied by the #enum(), which internally uses a grid (see here) to correctly separate the numbering/symbol from the content.
Does this make sense in this case here (and in the context of #outline() (see #2411)?

Thank you!

[tingerrr]

Go ahead and implement it, I think it's a better default than the current solution. We don't lose any flexibility so this should be fine. It comes down to laurenz if it will be accepted.

[laurmaedje]

Solved by #3459