文書ツール
文書の設定
用紙サイズ、余白、フォント、言語、行間、番号付けを、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
「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
「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
「Markdown」セクション値は、Pandoc が PDF をビルドするときに読み取る YAML のフロントマターに書き込まれます。type、documentclass、papersize、段数用の classoption、余白用の geometry、mainfont、fontsize、lang、linestretch、numbersections です。 文書の種類では論文、レポート・学位論文、書籍、スライド、ポスター、手紙、履歴書を選べ、文書がどうビルドされるかが決まります。文書の種類を参照してください。 ドキュメントクラスでは article、report、book、scrartcl、scrreprt、memoir を選べます。 言語には en-US のようなタグを指定します。
フォントを設定していない場合、Oleafly は、韓国語、アラビア語、デーヴァナーガリーなど、文書にある文字体系ごとにフォントを選びます。言語は、中国語の文字にどのフォントを使うかも決めます。ja は日本語のフォント、zh は簡体字中国語、zh-TW は繁体字中国語です。ほかの言語のテキストを参照してください。
ファイルにまだフロントマターがない場合は、ダイアログにその旨が表示され、 適用すると先頭にブロックが追加されます。閉じる --- の行がないフロントマターは、先に手作業で直す必要があります。
読み取り専用の項目
「読み取り専用の項目」セクション値によっては、ほかの何かに管理されているものがあります。ダイアログでは、そうした値が灰色で表示され、その下に理由が示されます。
- …クラスで設定:
acmart、IEEEtran、llncs、beamerなどのクラスは、独自に余白を固定します。用紙サイズ、フォントサイズ、段数、行間、言語も固定するクラスがあります。どのクラスかは、ダイアログ上部の注意書きに表示されます。 - …スタイルで設定:NeurIPS、ICML、ICLR、CVPR、ACL などの学会スタイルのパッケージは、用紙サイズと余白を設定します。どのスタイルが管理しているかは、ダイアログ上部の注意書きに表示されます。
- ソースで余白が辺ごとに設定されています:文書が、1 つの
margin値ではなく、左、右、上、下の余白を個別に指定しています。 - 条件分岐のブロック内で設定:値が
\if…のコードの中にあるため、ここで変更するとロジックが壊れるおそれがあります。 - テンプレートで設定:Typst で、値を持つ
#setルールにifの条件があるか、テンプレートのコードによくあるように..の引数を渡しているため、ダイアログでは手を加えません。 - ソース内の式で設定:値が書かれているのではなく計算されているため、ソースを直接編集してください。
Typst の文書がテンプレートを適用している場合は、テンプレート内で設定された値は表示されないことと、ここで設定した値がテンプレートより優先されることが、上部の注意書きに表示されます。LaTeX では、プリアンブルの一部がほかのファイルにあるときに、同様の注意書きが表示されます。