par

要素関数

要素関数

要素関数はsetルールやshowルールでカスタマイズできます。

テキストコンテンツの論理的な区分。

Typstは インラインレベル の要素を自動的に段落にまとめます。 インラインレベルの要素には、テキスト、 水平方向の空白、 ボックス、インライン数式が含まれます。

段落を区切るには、空行（または明示的なparbreak）を使用します。 段落は、任意のブロックレベルの要素 （block、place、またはこれらのいずれかとして表示されるもの）によっても自動的に中断されます。

par要素は主にsetルールにおいて段落のプロパティに影響を与えるために使用されますが、 その引数を明示的に独立した段落として表示するためにも使用できます。 その場合、 その段落の本文にはブロックレベルのコンテンツを含めることはできません。

ボックスとブロック

上記の通り、通常、段落はインラインレベルのコンテンツのみを含みます。 しかし、boxでラップすることで、 あらゆる種類のブロックレベルのコンテンツを段落に組み込むことができます。

逆に、インラインレベルのコンテンツをblockでラップすることにより、 コンテンツを段落から分離できます。 この場合、そのコンテンツはどの段落にも属さなくなります。 なぜこれが重要なのか、また単にコンテンツの前後に段落区切りを追加することとどう異なるのかについては、 次のセクションをお読みください。

何が段落になるのか？

インラインレベルのコンテンツをドキュメントに追加すると、 Typstは自動的にそれを段落でラップします。 しかし、一般的なドキュメントには、見出しやキャプションなど、 意味的に段落の一部ではないテキストも含まれます。

Typstがインラインレベルのコンテンツを 段落でラップするルールは次の通りです。

• ドキュメントのルート（最上位）にある全てのテキストは段落でラップされます。

• コンテナ（blockなど）内のテキストは、 そのコンテナにブロックレベルのコンテンツが含まれている場合にのみ段落でラップされます。 コンテンツが全てインラインレベルである場合は、段落は作成されません。

組版された文書では、テキストが段落の一部になったかどうかはすぐにはわかりません。 しかし、いくつかの理由からこれは依然として重要です。

• first-line-indentなどの特定の段落スタイルは正式な段落に対してのみ適用され、 任意のテキストには適用されません。 同様に、parに対するshowルールももちろん段落に対してのみ適用されます。

• 段落とその他のテキストを適切に区別することは、 スクリーンリーダーなどの支援技術を利用する人々が文書を正しく読み進め、理解するのに役立ちます。 現在はTypstがアクセシブルなPDFをまだ出力しないため、 この仕組みはHTMLエクスポートにのみ適用されますが、 近い将来PDFへのサポートも計画されています。

• HTMLエクスポートでは、段落に対してのみ<p>タグが生成されます。

独自の再利用可能なコンポーネントを作成する際には、 Typstが段落を作成するかどうかを自分で制御できますし、制御すべきです。 テキストを単に段落区切りで囲むのではなく、 blockで囲むことで段落を作成させないようにできます。 逆に、コンテナ内のコンテンツの後にparbreakを追加することで、 たとえ1つの単語であっても段落にすることができます。 これは、非タイトリストがその項目を強制的に段落にさせるために行う手法の例です。

例

#set par(
  first-line-indent: 1em,
  spacing: 0.65em,
  justify: true,
)

We proceed by contradiction.
Suppose that there exists a set
of positive integers $a$, $b$, and
$c$ that satisfies the equation
$a^n + b^n = c^n$ for some
integer value of $n > 2$.

Without loss of generality,
let $a$ be the smallest of the
three integers. Then, we ...