withしたい（`with`）

// h = block要素の一部を設定した関数
#let h = block.with(
  fill: luma(90%),  // 背景色を追加
  inset: 1em,       // 内側のスペースを追加
  above: 1em,  // 見出しの上にスペースを追加
  below: 1em,  // 見出しの下にスペースを追加
)

// h関数を適用
h[ここは背景色とスペースが追加されたブロック要素で表示]

// h関数をさらに適用
h.with(fill: luma(150%))[ここはさらに背景色が濃くなったブロック要素で表示]

withメソッドで、関数を部分的に適用した新しい関数を作成できます。 blockのようなビルトイン関数を部分的に適用して、特定の設定を再利用できます。

#show heading: block.with(...)

// 上のshowルールと同じ意味
#let h = block.with(...)
#show heading: h

withメソッドは#showルールを組み合わせて、文書を装飾を変更ことができます。

テンプレートしたい

// 関数をインポート: template(title, author, ..., body)
#import "settings.typ": template

// 全体にtemplate関数を適用
#show: template.with(
  title: "すばらしいタイトル",
  author: "すばらしい著者",
  // その他の引数
)

// ここから本文
= 文書のタイトル

本文がここに入ります。
フォント、ページサイズ、段落スタイルが自動的に適用されます。

withメソッドはすべての関数で利用できます。そのため、ユーザ定義関数を部分的に適用して、ドキュメント全体の設定をまとめることもできます。

上記のサンプルでは設定ファイル（settings.typ）からtemplate関数をインポートしたあと、 template.with(...)で初期値を設定して、 #show: template.with(...)でページ全体に適用しています。

注釈

テンプレート設計のポイントは、ドキュメント全体の設定をまとめた関数を定義することです。そのためには、「何が設定で」「何が装飾か」を明確に分けることが重要です。また、ドキュメントの本文を受け取ることができるように、関数の最後の引数をcontent型にする必要があります。慣習でbodyという変数名を使うことが多いようですが、content型であれば何でもいいと思います。

参考

// ある関数を定義
#let f(title, body) = {...}

// bodyを引数に設定
f(title: "タイトル", [本文])

// bodyは関数の外に配置できる
f(title: "タイトル")[
  本文
]

// withでtitleを固定した新しい関数を作成
#show: f.with(title: "タイトル")

本文（ここに書いた文章が、マークアップも含めてすべてf関数のbody引数に渡される）


// （おそらく）以下と同じ意味
#let g = f.with(title: "タイトル")

g[本文（ここに書いた文章が以下略）]

設定ファイルしたい

// Filename: settings.typ

#let config(
    title: none,
    author: none,
    date: none,
    body
) = {
  // フォント設定
  set text(
    font: ("Hiragino Kaku Gothic Pro", "Hiragino Sans"),
    lang: "ja",
    size: 10pt,
  )

  // ページレイアウト
  set page(
    paper: "a4",
    numbering: none,
  )

  // 段落スタイル
  set par(
    justify: false,
    first-line-indent: 0pt,
    leading: 0.65em,
    spacing: 1em,
  )

  // 本文を表示
  body
}

まず、ドキュメント全体の設定をまとめたファイル（settings.typ）を作成し、設定用の関数（config）を定義します。

設定ファイルとして分離することで、ドキュメント設定の管理・保守が簡単になります。

また、複数のドキュメントで同じテンプレートを再利用できるため、ドキュメントの規模が増えても、一貫したフォーマットが保てます。

withしたい（with）

テンプレートしたい

設定ファイルしたい

withしたい（`with`）