# 用 LaTeX 寫作

從可編輯的原始碼建構論文，並用工具列處理結構、引用、公式與圖片。

從期刊版面或空白的論文開始。在原始碼編輯器中寫作、在文字旁邊編譯，並在一個句子與它在 PDF 中的位置之間跳轉。

![Oleafly 中的 LaTeX 練習文件，原始碼、大綱與編譯後的 PDF 並排顯示](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-writing-dark-window-v2.png)

## 完成你的第一頁

1. 在專案庫中，選擇 **「新增專案 → 使用範本 → Blank document」**。
2. 將專案命名為 **「Toolbar practice」**，然後選擇 **「建立專案」**。
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}
```

你應該會看到標題、兩個章節與一個編號公式。這個範例提供了下方公式、圖片與連結工具所用到的套件。

[下載範例原始碼](/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` 換成它的專案路徑。編輯圖說與標籤。插入置中的 `figure`，內含 `\includegraphics[width=0.8\textwidth]{...}`。

### 插入表格

開啟表格格線並選擇列數與欄數。填入表格說明與儲存格。插入含靠左對齊 `tabular` 的 `table`；用 `&` 分隔儲存格，用 `\\` 分隔列。

### 繪製圖表

以 TikZ 模式開啟[圖表編排器](/docs/figures-diagrams/)。在畫布上繪製或編輯 TikZ 程式碼，然後選擇 **「以 TikZ 插入」**，把圖表放在游標處。

### 影像轉 LaTeX

點擊影像轉寫按鈕，並選擇公式或文字的截圖。它會用工具所用的模型來寫出 LaTeX，除非你另外選擇，否則那是本機的 Ollama 模型。如果你沒有選擇，而且 Ollama 沒有執行或沒有能讀取圖片的模型，它就會改用助理的模型，圖片也會送到那個供應商。檢查插入的運算式並編譯它。

### align 環境

在新的一行插入；每列寫一個公式，在對齊點放 `&`，列與列之間用 `\\`。插入 `align` 環境；需要載入 `amsmath`。

### equation 環境

在新的一行插入，並在 begin 與 end 行之間輸入運算式。插入編號的行間公式。

### 分數

在數學式中使用；先替換選取的分子，再替換分母。`\frac{numerator}{denominator}`。

### 符號

開啟符號選擇器，找到符號並選取它。會在游標處插入它的 LaTeX 指令。數學符號請在數學環境內使用。

想快速做一個表格，請選擇兩欄三列，然後使用圖說 **「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)。

### 文件分析

列出文件的標題、圖片、表格、公式、標籤、引用與待辦事項，每一項都連結到它所在的行，並可複製標題、作者、關鍵字與摘要，用於投稿表單。請參閱[文件分析](/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)