# 文書の設定

用紙サイズ、余白、フォント、言語、行間、番号付けを、LaTeX のプリアンブル、Typst の set ルール、Markdown のフロントマターを編集するダイアログで変更します。

ページ設定の置き場所は、言語ごとに異なります。LaTeX ではクラスオプションとプリアンブルのコマンド、Typst では `#set` ルール、Markdown ではフロントマターです。 **文書の設定**は、そのすべてを 1 つのフォームで扱えるようにします。適用すると、Oleafly は変更を、あとで読んだり編集したりできる通常のソースとして、メインファイルに書き込みます。

エディタのツールバー右端の**文書の設定**ボタンで開くか、⌘K（Ctrl+K）パレットから**文書の設定**を実行します。ダイアログは、どのファイルを開いていても、常にプロジェクトのメインドキュメントを編集します。

## 項目

フォームには 4 つのセクションがあります。項目はエンジンによって異なります。

| セクション | LaTeX | Typst | Markdown |
| --- | --- | --- | --- |
| ページ | 用紙サイズ、段数、余白 | 用紙サイズ、余白、段数 | 文書の種類、ドキュメントクラス、用紙サイズ、段数、余白 |
| テキスト | 本文フォント、フォントサイズ、言語 | 本文フォント、フォントサイズ、言語、地域 | 本文フォント、フォントサイズ、言語 |
| 段落 | 行間 | 行揃え、行間 | 行間 |
| 番号付け | 番号を付ける階層、数式の番号付け | 見出しの番号付け、数式の番号付け | 節番号 |

選択肢の先頭は**既定**で、これを選ぶと設定が取り除かれ、クラス、テンプレート、エンジンの既定値が再び適用されます。テキスト欄を空にしても同じ結果になります。長さには `2.5cm`、`1in`、`11pt` のように単位を付けます。Typst の余白には `auto` も指定できます。Oleafly が使えない値には、欄の下に短い注意書きが表示され、修正するまで**適用**は押せません。

**本文フォント**は、入力に合わせてフォントを候補表示します。Typst プロジェクトでは、Typst が見つけられるすべてのフォントが一覧され、それぞれの出どころが示されます。プロジェクトの `fonts` フォルダ、コンピュータ、Typst 組み込みのフォントのいずれかです。LaTeX と Markdown のプロジェクトでは、コンピュータにインストールされているフォントが一覧されます。

**適用**を選ぶと変更が書き込まれ、 **キャンセル**を選ぶとファイルには手を加えません。メインファイルがエディタで開いている場合は、⌘Z（Ctrl+Z）を 1 回押すだけで変更全体を元に戻せます。

## 値の書き込み先

### LaTeX

- **用紙サイズ**、**段数**、**フォントサイズ**は、`\documentclass` のオプションになります。
- **余白**は geometry パッケージに書き込まれます。Oleafly は既存の `\geometry{…}` か geometry のオプションを編集するか、`\usepackage[margin=…]{geometry}` を追加します。
- **本文フォント**は `\setmainfont{…}` を書き込み、fontspec を読み込みます。latexmk のプロジェクトでは、XeLaTeX または LuaLaTeX のコンパイラが必要で、コンパイルメニューでどちらかを選ぶか、文書が `% !TeX program = xelatex` の行などでどちらかを求めるまで、この欄にその旨が表示されます。
- **言語**は、babel に言語を追加するか、文書が polyglossia を読み込んでいる場合は `\setdefaultlanguage` を使うか、`\usepackage[language]{babel}` を追加します。`english` のような babel の名前を使ってください。
- **行間**は、**1 行**、**1.5 行**、**2 行**、または `1.5` のような数値です。setspace パッケージを使います。文書がすでに `\linespread` を使っている場合は、それを使います。
- **番号を付ける階層**は `secnumdepth` を設定します。**なし**、**章のみ**、または番号付けの深さを、**節まで**から**小段落見出しまで**の中から選びます。
- **数式の番号付け**は、**節ごと**、**章ごと**、**小節ごと**に対して `\numberwithin{equation}{…}` を書き込みます。

### Typst

値はメインファイルの `#set` ルールに書き込まれます。ルールがない場合、Oleafly は先頭近くに追加します。

- `#set page(paper: …, margin: …, columns: …)`
- `#set text(font: …, size: …, lang: …, region: …)`
- `#set par(justify: …, leading: …)`。**行揃え**は**両端揃え**または**左揃え**です
- `#set heading(numbering: …)`。`1.`、`1.1`、`1.a`、`I.`、`A.` などのパターンを使います
- `#set math.equation(numbering: …)`。`(1)`、`(1.1)`、`1` を使います

**言語**には `en` のような 2 文字か 3 文字のコードを、 **地域**には `GB` のような 2 文字のコードを指定します。

Typst プロジェクトには、 **ビルドバリアント**セクションもあります。バリアントは、文書が `sys.inputs` で読み取る、名前付きの値のセットです。たとえば下書き用のビルドや最終版用のビルドです。 **バリアントを追加**を選んで名前を付け、 **値を追加**で値を 1 つずつ追加します。ビルドに使うバリアントは、コンパイルメニューの**バリアント（このプロジェクト）** で選びます。

### Markdown

値は、Pandoc が PDF をビルドするときに読み取る YAML のフロントマターに書き込まれます。`type`、`documentclass`、`papersize`、段数用の `classoption`、余白用の `geometry`、`mainfont`、`fontsize`、`lang`、`linestretch`、`numbersections` です。 **文書の種類**では**論文**、**レポート・学位論文**、**書籍**、**スライド**、**ポスター**、**手紙**、**履歴書**を選べ、文書がどうビルドされるかが決まります。[文書の種類](/docs/writing/markdown/#document-types)を参照してください。 **ドキュメントクラス**では `article`、`report`、`book`、`scrartcl`、`scrreprt`、`memoir` を選べます。 **言語**には `en-US` のようなタグを指定します。

フォントを設定していない場合、Oleafly は、韓国語、アラビア語、デーヴァナーガリーなど、文書にある文字体系ごとにフォントを選びます。**言語**は、中国語の文字にどのフォントを使うかも決めます。`ja` は日本語のフォント、`zh` は簡体字中国語、`zh-TW` は繁体字中国語です。[ほかの言語のテキスト](/docs/writing/markdown/#text-in-other-languages)を参照してください。

ファイルにまだフロントマターがない場合は、ダイアログにその旨が表示され、 **適用**すると先頭にブロックが追加されます。閉じる `---` の行がないフロントマターは、先に手作業で直す必要があります。

## 読み取り専用の項目

値によっては、ほかの何かに管理されているものがあります。ダイアログでは、そうした値が灰色で表示され、その下に理由が示されます。

- **…クラスで設定**：`acmart`、`IEEEtran`、`llncs`、`beamer` などのクラスは、独自に余白を固定します。用紙サイズ、フォントサイズ、段数、行間、言語も固定するクラスがあります。どのクラスかは、ダイアログ上部の注意書きに表示されます。
- **…スタイルで設定**：NeurIPS、ICML、ICLR、CVPR、ACL などの学会スタイルのパッケージは、用紙サイズと余白を設定します。どのスタイルが管理しているかは、ダイアログ上部の注意書きに表示されます。
- **ソースで余白が辺ごとに設定されています**：文書が、1 つの `margin` 値ではなく、左、右、上、下の余白を個別に指定しています。
- **条件分岐のブロック内で設定**：値が `\if…` のコードの中にあるため、ここで変更するとロジックが壊れるおそれがあります。
- **テンプレートで設定**：Typst で、値を持つ `#set` ルールに `if` の条件があるか、テンプレートのコードによくあるように `..` の引数を渡しているため、ダイアログでは手を加えません。
- **ソース内の式で設定**：値が書かれているのではなく計算されているため、ソースを直接編集してください。

Typst の文書がテンプレートを適用している場合は、テンプレート内で設定された値は表示されないことと、ここで設定した値がテンプレートより優先されることが、上部の注意書きに表示されます。LaTeX では、プリアンブルの一部がほかのファイルにあるときに、同様の注意書きが表示されます。

## 関連ページ

- [パッケージ](/docs/packages/)：ほかの LaTeX や Typst のパッケージを追加する
- [コンパイル](/docs/compiling/)：XeLaTeX や LuaLaTeX を選び、Typst のビルドバリアントを選ぶ
- [文書の分析](/docs/document-insights/)：文書の内容を確認する
