Typstでの文字のsizeとサイズの話

Typstの初期状態ではrawの text.size は 0.8em になっていて、通常テキストの80％のサイズで追随するようになっています。従って、この状態から

show raw: set text(size: 1.25em)

を実行するとrawの text.size がちょうど 1em となり、同じサイズで追随するはずです。#Typst https://t.co/hZpvXZnx33

— 某ZR（ざんねん🙃） (@zr_tex8r) 2025年9月9日

この​「フォントサイズが実際にどう決まるのか」​という件について、もう少し詳しく説明する。

フォントサイズはどう扱われるか

まずはフォントサイズに関する基本的な事項を確認する。

• Typstでのテキストのフォントサイズは「textエレメントのsizeパラメタ」（以降ではこれをtext.sizeと書く¹ことにする）の値に一致する。
• このtext.sizeパラメタはlength型の値をとる。
• text.sizeパラメタの値を変更したい場合はset規則を用いる。
  例：set text(size: 20pt)
• Typstの各種のエレメント（rawエレメント、math.equationエレメント、……）は種類ごとに異なる独立した「textエレメントのパラメタ」を保持していて、当然その中にはtext.sizeも含まれる。
• rawエレメントのテキストのフォントサイズは「rawのtext.size」の値に一致する。
• 「rawのtext.size」の値を変更したい場合はshow-set規則を用いる。
  例：show raw: set text(size: 20pt)
• エレメント独自の方ではない本来のパラメタのことを本記事では「メインのパラメタ」と呼ぶことにする。

以上の事項を確認するための例を示す。

// Typstの既定のフォント設定だと"フォント自体の見かけの大きさ"が
// 不揃いであり紛らわしいので, 同じ系統のフォントに合わせる.
#set text(font: "Harano Aji Mincho")
#show raw: set text(font: "Harano Aji Gothic")

#set text(size: 14pt) // フォントサイズを設定
#show raw: set text(size: 14pt) // "rawのフォントサイズ"を設定
☃は素敵。// 14pt
`☃は素敵。`// 14pt

// text.sizeと"rawのtest.size"は独立して設定可能.
#set text(size: 10pt)
#show raw: set text(size: 20pt)
☃は素敵。// 10pt
`☃は素敵。`// 20pt

em部分はどう扱われるか

Typstのlength型は、絶対的な長さ（abs）とフォントサイズ相対の長さ（em）からなる複合的な値²（例えば4pt+2em）である。length型の値を「実際の長さ」として解釈する場合にはem部分の値は「現在コンテキストのtext.sizeの値」として換算される（text.sizeが11ptであれば4pt+2emは26ptと解釈される）。一方で、set規則やshow-set規則でtext.sizeパラメタの値を設定する際に「現在コンテキスト」を参照するのは望ましくないだろう。

text.sizeの設定の際にはem部分は以下のように扱われる。

• set規則やshow-set規則でtext.sizeに「Apt+Eem」を設定すると、実際には「『現在のtext.sizeの値』を E 倍して Apt を加算した値」に更新される。
• 例えば「現在のtext.size」が8pt+2emであるときにset text(size: 5pt+0.5em)を実行すると、text.sizeの値は(8pt+2em)*0.5+5pt、つまり³9pt+1emに更新される。
• em部分が「現在のコンテキスト」に基づいて“解決”されるのではないことに注意。更新後の値も一般的にはem部分を持つ。
• ただし、前述の規則から導かれる性質として、現在値がem部分を持たない場合は、どんな値を設定しても更新後の値は決してem部分を持たない。例えば現在値が11ptのときにset text(size: 5pt+0.5em)を実行すると10.5ptに更新される。
• メインのtext.sizeの初期値は11ptである。従って先述の規則により、メインのtext.sizeは決してem部分を持たない。

text.sizeの値から「実際のフォントサイズ」を求める際にはem部分は以下のように扱われる。

• メインのtext.sizeはem部分を持たないのでその扱いを考える必要はない。メインのtext.sizeは常に絶対的な長さでこれがそのまま「実際のフォントサイズ」となる。
• rawのtext.sizeはem部分を持つ。これは当該のrawエレメントを含むすぐ外側のコンテキストの「実際のフォントサイズ」に換算される。
• 例えば、rawのtext.sizeが4pt+0.5emであり現在のフォントサイズが11ptである場合、rawエレメントの「実際のフォントサイズ」は9.5ptとなる。

text.sizeの初期値は以下の通りである。

• メインのtext.size： 11pt
• rawのtext.size： 0.8em

ここまで述べた規則を考慮すれば、メインとrawのフォントサイズを完全に把握することができるはずである。

実際にフォントサイズはどう扱われるか

さて今まで散々「規則」を述べてきたわけであるが、Typstの動作がそれと一致していなければ意味がない。そこで実際のTypstの動作を確認したいわけであるが、それには「現在のフォントサイズ」を調べる手段が必要である。

Typstの「現在のフォントサイズ」を調べる

Typstのコードモードにおいてtext.sizeという式を書くと現在のコンテキストにおけるtext.sizeの値が取得できるはずである。ただし実際の動作としてはこれで取得できる値はem部分を解決した後の「現在のフォントサイズ」のようである。ともかく、以下のマークアップで「現在のフォントサイズ」を知ることができる。

#context [#repr(text.size)]

ただしrawエレメントについてはその特質上「rawの中でコードモードに移行する」ことができないので、「現在のフォントサイズ」を知るには少しトリックが必要である。以下のようなコードを利用する。

#show raw: _ => repr(text.size)

すなわちshow規則を利用して「rawの中でコードモードに移行する」ことを無理やり実現するわけ⁴である。このshow規則が有効な状態で​`x`​と書くと、“x”の代わりに「rawでの現在のフォントサイズ」が出力される。

合わせると、以下のようにcurrentを定義⁵すると#currentでメイン・raw内の「現在のフォントサイズ」が出力されることになる。

#let current = context {
  show raw: it => repr(text.size)
  [#repr(text.size) / `x`]
}

Typstの「フォントサイズの規則」を調べる

動作確認用に以下の文書コードを用意した。

// 現在フォントサイズを表示するやつ
#let current = context {
  show raw: it => repr(text.size)
  [#repr(text.size) / `x`]
}

//// 実験用コード

// raw/text.size = 0.8em
#show raw: set text(size: 8pt+2.5em)
// raw/text.size = 8pt+2em
#show raw: set text(size: 5pt+0.5em)
// raw/text.size = 9pt+1em
#show raw: set text(size: 2em-13pt)
// raw/text.size = 5pt+2em

// text.size = 11pt
#current // "11pt / 27pt"となるはず

#set text(size: 20pt)
// text.size = 20pt
#current // "20pt / 45pt"となるはず

このコードの要点は以下の通りである。

• rawのtext.sizeへの設定を何度か繰り返すことで、設定の規則が自分の想定通りになっていることを確認する。
• メインのtext.sizeの2通りの設定の下でメイン・rawの現在フォントサイズを調べることで、rawのtext.sizeが内部的にはem部分を持っている（そこはメインのフォントサイズに換算される）ことを確認する。

実際にTypstでコンパイルすると以下の出力が得られた。

このコードの範囲では、全て想定通りに動作していることが判った😊

まとめ

Typstはナニカより簡単😍（簡単😭）