# LaTeX で書く

編集できるソースで論文を組み立てます。構造、引用、数式、図のためのツールバーが付いています。

ジャーナルのレイアウトか、白紙の article から始めます。ソースエディタで書き、テキストの隣でコンパイルし、文と PDF 上のその位置との間を行き来します。

![Oleafly で開いた LaTeX の練習用文書。ソース、アウトライン、コンパイルされた PDF が並んでいます。](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-writing-dark-window-v2.png)

## 最初のページを作る

1. ライブラリで、**新規プロジェクト → テンプレートを使う → Blank document** を選びます。
2. プロジェクトに **ツールバーの練習** と名前を付けて、**プロジェクトを作成**を選びます。
3. `main.tex` を開きます。内容を下の例に置き換えます。
4. **再コンパイル**を選ぶか、macOS では ⌘Enter、Windows と Linux では Ctrl+Enter を押します。

```latex title="main.tex"
\documentclass{article}
\usepackage{amsmath,graphicx,hyperref}
\title{A Small Research Note}
\author{Alex Chen}
\date{}
\begin{document}
\maketitle
\section{Question}\label{sec:question}
How does the sample size affect the estimate?
\section{Method}
We repeat the measurement and compare the mean.
\begin{equation}\label{eq:mean}
  \bar{x}=\frac{1}{n}\sum_{i=1}^{n}x_i
\end{equation}
Equation~\ref{eq:mean} defines the estimate.
\end{document}
```

タイトル、2 つのセクション、番号付きの数式が表示されるはずです。この例には、下で扱う数式、図、リンクのツールが使うパッケージが含まれています。

[例のソースをダウンロード](/examples/writing-example.tex)

## すべてのツールバーのコントロールを調べる

![LLaMA のエディタのみ表示での LaTeX ツールバー。コントロールは、コード / ビジュアルと元に戻すに始まり、書式、引用、表、数式、記号、コードインテリジェンスと続きます。](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-editor-dark-window-v2.png#view=344,77,838,48)

書式バーは文書の上にあります。既存のテキストを選択すると、それを囲みます。新しい内容を置きたい場所にカーソルを置くこともできます。ほとんどの挿入ツールはプレースホルダーを選択状態にするので、すぐに上書きして入力できます。幅が狭いペインでは、コントロールが**その他の書式設定**（`…`）に移ります。

### コード / ビジュアル

ツールバーの先頭にあるスイッチは、ファイルの表示方法を切り替えます。**コード**は LaTeX のソースを表示します。**ビジュアル**は、見出し、書式、数式、その他のマークアップをその場で描画し、カーソルがある行ではソースに戻して表示します。新しいプロジェクトはコードで開き、各プロジェクトは最後に使っていたモードを記憶します。[ビジュアル編集](/docs/editor/#visual-editing)を参照してください。

### 元に戻す

左向きの曲線の矢印をクリックするか、⌘Z / Ctrl+Z を押します。直前の編集を取り消します。

### やり直す

右向きの曲線の矢印をクリックするか、**⌘Shift+Z / Ctrl+Shift+Z** を押します。取り消した編集をもう一度適用します。

### 見出し → 部

見出しメニューから**部**を選ぶと、`\part{Part}` が挿入されます。見出しのテキストを自分のタイトルに置き換えます。

### 見出し → 章

見出しメニューから**章**を選ぶと、`\chapter{Chapter}` が挿入されます。見出しのテキストを自分のタイトルに置き換えます。`report` や `book` のような、章を単位とするクラスを使ってください。

### 見出し → 節

見出しメニューから**節**を選ぶと、`\section{Section}` が挿入されます。見出しのテキストを自分のタイトルに置き換えます。

### 見出し → 小節

見出しメニューから**小節**を選ぶと、`\subsection{Subsection}` が挿入されます。見出しのテキストを自分のタイトルに置き換えます。

### 見出し → 小々節

見出しメニューから**小々節**を選ぶと、`\subsubsection{Subsubsection}` が挿入されます。見出しのテキストを自分のタイトルに置き換えます。

### 見出し → 段落見出し

見出しメニューから**段落見出し**を選ぶと、`\paragraph{Paragraph}` が挿入されます。見出しのテキストを自分のタイトルに置き換えます。

### 太字

「sample size」を選んで**太字**をクリックするか、編集中に ⌘B / Ctrl+B を押します。`\textbf{sample size}` になります。

### 斜体

用語を選んで**斜体**をクリックするか、⌘I / Ctrl+I を押します。`\textit{term}` になります。

### 下線

テキストを選んで**下線**をクリックします。`\underline{text}` になります。

### インラインコード

ファイル名や識別子を選んで、コードのアイコンをクリックします。`\texttt{filename}` になります。

### 箇条書き

**箇条書き**を選ぶと、`itemize` 環境が挿入されます。各項目を `\item` の後ろに入力します。Enter でリストが続き、空の項目で Enter を押すとリストを抜けます。

### 番号付きリスト

**番号付きリスト**を選ぶと、`enumerate` 環境が挿入されます。各手順を `\item` の後ろに追加します。番号はコンパイル時に LaTeX が付けます。

### 引用ブロックを挿入

新しい行にカーソルを置いて、引用符のアイコンをクリックします。出典付きの引用のための `quote` 環境が挿入されます。

### リンクを挿入

リンクのアイコンをクリックし、`url` を置き換えてから、`link text` を置き換えます。`\href{url}{link text}` になります。プリアンブルで `hyperref` を読み込んでください。

### 引用

引用ピッカーを開き、プロジェクトの参考文献を検索して、使いたい項目を選びます。選んだ参考文献のキーを使った引用が挿入されます。先に[参考文献と引用](/docs/citations/)で資料を追加してください。

### 相互参照を挿入

タグのアイコンをクリックし、練習用文書では `label` を `eq:mean` に置き換えます。`\ref{eq:mean}` になり、コンパイル後に数式番号に解決されます。

### 脚注を挿入

単語の後ろにカーソルを置いて、脚注のアイコンをクリックします。`\footnote{note text}` になるので、注のテキストを置き換えます。

`\label{...}` を、セクションの見出し、数式、図のキャプションの後ろに置き、その正確なラベルを参照します。[補完とホバープレビュー](/docs/autocomplete/)は、文を離れずに参照先を見つける助けになります。

### 図を挿入

画像をファイルツリーに読み込み、画像のアイコンをクリックして、`image-filename` をそのプロジェクト内のパスに置き換えます。キャプションとラベルを編集します。`\includegraphics[width=0.8\textwidth]{...}` を含む、中央揃えの `figure` が挿入されます。

### 表を挿入

表のグリッドを開き、行数と列数を選びます。キャプションとセルを入力します。左揃えの `tabular` を含む `table` が挿入されます。セルは `&` で、行は `\\` で区切ります。

### 図を描く

TikZ モードで[ダイアグラムコンポーザー](/docs/figures-diagrams/)を開きます。キャンバスに描くか TikZ のコードを編集してから、**TikZ として挿入**を選ぶと、カーソル位置にダイアグラムが入ります。

### 画像から LaTeX へ

画像の文字起こしボタンをクリックして、数式やテキストのスクリーンショットを選びます。LaTeX を書くのに、ツール用のモデル（別のモデルを選ばない限り、ローカルの Ollama モデル）を使います。モデルを選んでいない状態で、Ollama が動いていないか、画像を読めるモデルがない場合は、代わりにアシスタントのモデルを使い、画像はそのプロバイダに送られます。挿入された式を確認して、コンパイルしてください。

### align 環境

新しい行に挿入します。1 行に 1 つの数式を書き、揃える位置に `&`、行の間に `\\` を置きます。`align` 環境が挿入されます。`amsmath` を読み込んでください。

### equation 環境

新しい行に挿入し、begin 行と end 行の間に式を入力します。番号付きのディスプレイ数式が挿入されます。

### 分数

数式の中で使います。選択した分子を置き換え、次に分母を置き換えます。`\frac{numerator}{denominator}` になります。

### 記号

記号ピッカーを開き、記号を探して選択します。カーソル位置にその LaTeX コマンドが挿入されます。数学記号は数式環境の中で使ってください。

簡単な表なら、2 列 3 行を選び、キャプションを **Measurements**、セルを `Run & Value`、`1 & 0.42`、`2 & 0.47` にします。コンパイルして配置を確認します。もっと大きなデータセットなら、エディタで右クリックして **CSV / XLSX から表を作成…** を選び、[データファイルから表を読み込みます](/docs/writing/tables-equations/#import-a-table-from-a-data-file)。

### コードインテリジェンス → 定義へ移動

対応しているコマンド、参照、引用にカーソルを置いて、このアクションを選びます。その定義かソースの場所が開きます。

### コードインテリジェンス → 参照を検索

プロジェクトのシンボルにカーソルを置きます。それを使っている場所を一覧します。

### コードインテリジェンス → シンボルの名前を変更

対応しているシンボルを選んで、新しい名前を入力します。一致するプロジェクト内の参照をまとめて変更する準備をします。

### LaTeX パッケージ

バーの右端にあるパッケージのアイコンです。CTAN を検索し、パッケージがすでに読み込まれているか、インストールされているかを確認し、**プリアンブルに追加**を選ぶと、その `\usepackage` 行が書き込まれます。[パッケージ](/docs/packages/#latex-packages)を参照してください。

### 文書の分析

文書の見出し、図、表、数式、ラベル、引用、to-do を、それぞれの行へのリンク付きで一覧し、投稿フォーム用にタイトル、著者、キーワード、概要をコピーします。[文書の分析](/docs/document-insights/)を参照してください。

### 文書の設定

プリアンブルを代わりに編集して、用紙サイズ、余白、段数、フォント、言語、行間、番号付けを変更します。文書クラスや学会のスタイルが制御している値はグレーアウトされ、その下に理由が表示されます。[文書の設定](/docs/document-settings/)を参照してください。

### プロジェクト情報

バーの右にある**プロジェクト情報**を開きます。文書の統計を確認できます。文章を選択すると、その選択範囲を調べられます。

### 検索

コードモードで虫眼鏡をクリックするか、⌘F / Ctrl+F を押します。現在のファイルを検索します。複数のファイルには、サイドバーの「プロジェクトを検索」を使います。

### PDF へ移動（SyncTeX）

ソースにカーソルを置き、エンジンが対応している場合は、矢印をクリックします。コンパイルされた PDF の対応する位置へ移動します。

[コードインテリジェンス](/docs/code-intelligence/)では言語ツールを説明しています。[SyncTeX](/docs/synctex/)では、双方向の移動を扱っています。

## 長い原稿を書く

メインファイルは小さく保ち、セクションを `sections/method.tex` のようなファイルに分けます。`\input{sections/method}` で取り込みます。エクスプローラー、アウトライン、検索、補完が、作業中にそれらのファイルをつなぎ合わせます。

参考文献を追加するには[参考文献ガイド](/docs/citations/)を、プロットとダイアグラムには[図のガイド](/docs/figures-diagrams/)を使います。ビルドが失敗したら、**ログ**を開いてファイルと行をたどり、再コンパイルする前に、最初の関連するエラーを直します。

## 結果を共有する

コンパイルし、PDF を確認して、[プリフライト](/docs/preflight/)を実行します。読むためには PDF を、編集が必要な共同執筆者にはソースの ZIP を書き出します。[書き出し形式](/docs/export/)では、Word、HTML、Markdown、文書ごとの変換も扱っています。

## エディタのみのレイアウト

ソースに広い領域が欲しいときは、プロジェクトのレイアウトメニューから**エディタのみ**を選びます。書式ツールは文書の上に残り、次のコンパイルでは分割レイアウトに戻せます。

![エディタのみのレイアウトでの LaTeX ソースエディタと書式ツールバー。](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-editor-dark-window-v2.png)