情報アイコン
情報 / Info
当サイトは、Typst GmbHの許諾を得て、日本語コミュニティ「Typst Japan Community」がTypst v0.13.1の公式ドキュメントを翻訳したものです。誤訳や古い情報が含まれている可能性があるため、公式ドキュメントとの併用を推奨します。翻訳の改善やサイトの機能向上について、GitHubでのIssueやPull Requestを歓迎します。コミュニティにご興味のある方はDiscordサーバー「くみはんクラブ」にぜひご参加ください。
This site provides a Japanese translation of the Typst v0.13.1 documentation maintained by the "Typst Japan Community" with permission from Typst GmbH. We recommend using this alongside the official documentation. We welcome contributions through Issues and Pull Requests on our GitHub repository for both translation improvements and website enhancements. Feel free to join our Discord server "Kumihan Club".
言語アイコン
翻訳済み

このページは日本語に翻訳済みです。

heading
Element
ヘルプアイコン

セクションの見出し。

見出しを使うことで、文書をセクションとして構造化できます。 各見出しには1から始まる レベル があり、上限はありません。 このレベルは、以下に続く内容の論理的な役割(セクション、サブセクションなど)を示します。 最上位のレベルの見出しは、文書の最上位のレベルのセクションを示します(文書のタイトルではありません)。

Typstでは、見出しに自動的に番号をつけることができます。 番号付けを有効にするには、 見出しにどのような番号付けパターンまたは関数を用いて番号付けを行うかを指定してください。

番号付けとは別に、Typstはすべての見出しの目次を自動的に生成することもできます。 1つ以上の見出しをこの目次から除外するには、 outlinedパラメーターをfalseに設定してください。

#set heading(numbering: "1.a)")

= Introduction
In recent years, ...

== Preliminaries
To start, ...
Preview

構文

見出しには専用の構文があります。 行の先頭に等号を1つ以上入力し、その後にスペースを入力することで見出しを作成できます。 等号の数は、見出しの論理的なネストの深さを決定します。 offsetフィールドを設定すると、見出しの最初の深さを設定できます。

引数
ヘルプアイコン

level
Settable
ヘルプアイコン

1から始まる、見出しの絶対的なネストの深さ。 autoに設定した場合は、offset + depthから計算されます。

これは主にshowルールで利用する際に役立ちます (whereセレクターを使う場合や 表示された見出しのレベルに直接アクセスする場合など)。

デフォルト値:

auto

右矢印アイコン
例を表示
#show heading.where(level: 2): set text(red)

= Level 1
== Level 2

#set heading(offset: 1)
= Also level 2
== Level 3
Preview

depth
Settable
ヘルプアイコン

1から始まる、見出しの相対的なネストの深さ。 この値はoffsetと組み合わせて、実際のlevelを計算するのに用いられます。

これは見出し構文によって設定され、例えば== Headingは論理的な深さが2の見出しを作成しますが、 実際のレベルはoffset + 2になります。 見出しを手動で作成する場合、 通常は絶対レベルを設定するよりもこちらを使用することをお勧めします。

デフォルト値:

1

offset
Settable
ヘルプアイコン

各見出しのlevelの開始オフセットであり、 相対的なdepthを絶対的なlevelに変換するために使用されます。

デフォルト値:

0

右矢印アイコン
例を表示
= Level 1

#set heading(offset: 1, numbering: "1.1")
= Level 2

#heading(offset: 2, depth: 2)[
  I'm level 4
]
Preview

numbering
Settable
ヘルプアイコン

見出しを番号付けする方法。 番号付けパターンまたは関数を指定できます。

デフォルト値:

none

右矢印アイコン
例を表示
#set heading(numbering: "1.a.")

= A section
== A subsection
=== A sub-subsection
Preview

supplement
Settable
ヘルプアイコン

見出しに用いる補足語。

見出しを参照する際、補足語が参照番号の前に追加されます。

関数を指定した場合、参照された見出しが引数として渡され、 その関数は表示されるコンテンツを返す必要があります。

デフォルト値:

auto

右矢印アイコン
例を表示
#set heading(numbering: "1.", supplement: [Chapter])

= Introduction <intro>
In @intro, we see how to turn
Sections into Chapters. And
in @intro[Part], it is done
manually.
Preview

outlined
Settable
ヘルプアイコン

見出しを目次に表示するかどうか。

なお、このプロパティをtrueに設定すると、 PDFへのエクスポート時に、見出しがPDFの目次にしおりとしても表示されます。 この動作を変更するには、bookmarkedプロパティを使用してください。

デフォルト値:

true

右矢印アイコン
例を表示
#outline()

#heading[Normal]
This is a normal heading.

#heading(outlined: false)[Hidden]
This heading does not appear
in the outline.
Preview

bookmarked
Settable
ヘルプアイコン

エクスポートされたPDFの目次に見出しをしおりとして表示するかどうか。 PNGなどの他のエクスポート形式には影響しません。

デフォルト値のautoは、outlinedプロパティがtrueに設定されている見出し、 すなわちTypstの目次にも記載される見出しのみが、 PDFエクスポート時の目次に表示されることを示します。 このプロパティをtrue(しおりあり)またはfalse(しおりなし)に設定すると、 この動作を無視します。

デフォルト値:

auto

右矢印アイコン
例を表示
#heading[Normal heading]
This heading will be shown in
the PDF's bookmark outline.

#heading(bookmarked: false)[Not bookmarked]
This heading won't be
bookmarked in the resulting
PDF.
Preview

hanging-indent
Settable
ヘルプアイコン

見出しの最初の行を除くすべての行に適用されるインデント。

デフォルト値のautoでは、 見出しの先頭行に続く行が番号の幅に合わせてインデントされます。

デフォルト値:

auto

右矢印アイコン
例を表示
#set heading(numbering: "1.")
#heading[A very, very, very, very, very, very long heading]
Preview

body
Required
ヘルプアイコン
Positional
ヘルプアイコン

見出しのタイトル。

検索