> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/zh-tw/ge-shi-hua/15-margin-notes.md).

# 邊註

## 簡介

本文說明如何建立邊注，這是相較於註腳的一種常見替代方式，可用來加入補充資訊以支援文件主文。我們也有一個 [關於……的說明頁面 `todonotes` 套件](/latex/zh-tw/wen-yu-da/04-can-i-add-inline-or-margin-comments-to-the-pdf.md) 的說明頁面，它提供了本文所述方法的替代解決方案。

## \marginpar 指令

在不載入任何額外套件的情況下，你可以使用內建的 LaTeX `\marginpar` 指令來為你的文件加入邊注。其一般形式為 `\marginpar` 指令為

`\marginpar[*左側文字*]{*右側文字*}`

其中 `*左側文字*` 如果邊注出現在文件頁面的左側時將會使用，而 `*右側文字*` 如果出現在右側。更具體地說，邊注通常會放在頁面的「外側」——不過「外側」的意義取決於你所使用的文件類別，以及你是否指定了 `twoside` 套件選項：

* `book` 類別（`\documentclass{book})` 文件預設為雙面（版面設計）
* `report` 類別（`\documentclass{report}`）和 `article` 類別（`\documentclass{article}`）文件預設為單面。若要讓它們成為雙面，你必須指定 `twoside` 選項：
  * `\documentclass[twoside]{report}`，或
  * `\documentclass[twoside]{article}`

對於單面文件，排除由右至左書寫的語言，例如阿拉伯文時，「外側」永遠是文字區的右邊界；而對於雙面文件，左頁的外側是文字區的左邊界，右頁的外側則是文字區的右邊界。

### 反轉邊注的放置位置

指令 `\reversemarginpar` 會反轉邊注排版所在的一側；其效果可由指令 `\normalmarginpar`取消。正如 LaTeX 原始碼文件所述：「這些指令對雙欄輸出沒有作用。」

### 影響邊注排版的指令

邊注的排版 `\marginpar` 會使用數個尺寸指令，這些指令會儲存可視需要變更的值：

* `\marginparwidth`：決定邊注的寬度，因而決定邊注中排版行的長度。
* `\marginparsep`：設定邊注與文件正文之間的間距（距離）。
* `\marginparpush`：定義邊注之間的最小垂直間距 `\marginpar` 。

### 變更邊注的排版：右參差與左參差

預設情況下，邊注的文字會在一個框中排版，產生寬度為 `\marginparwidth`的排版行。當 TeX 引擎試圖找出「最佳」換行時，這可能會導致排版後的字詞之間出現不美觀的空隙。你可以使用指令 `\raggedright` 以及 `\raggedleft` 來改變文字的排版樣式。

### 範例

以下是一個使用數個 `\marginpar` 指令來示範上述部分功能的範例。此範例也載入了 [`geometry`](https://ctan.org/pkg/geometry) 套件，以建立較小的頁面尺寸，並載入 [`hyperref`](https://ctan.org/pkg/hyperref) 套件，它提供了 `\url` 指令，用於在註腳中註明文字來源。

```latex
\documentclass[twoside]{article} % 注意：使用 twoside 選項
\usepackage[a4paper, marginparwidth=75pt, total={10cm, 10cm}]{geometry} % 建立較小的頁面
\usepackage{hyperref} % 使用 \url 指令（在註腳中）
\usepackage{marginnote}
\begin{document}
\section{Lorem Ipsum}
\footnote{來源文字：Wikipedia (\url{https://en.wikipedia.org/wiki/Lorem_ipsum})}但我必須向你解釋，這種將享樂斥為惡、將痛苦頌為善的錯誤觀念是如何產生的。為此，我會向你完整說明這個體系，並闡述這位偉大真理探求者、幸福人類的建築師的真正教誨。 \marginpar[註 1：左側文字]{註 1：頁面右側文字，採左右對齊。} 沒有人會拒絕、厭惡或迴避快樂本身，因為它是快樂；人們之所以如此，是因為那些不懂得如何理性追求快樂的人，會遭遇極其痛苦的後果。也沒有人會愛、追求或渴望去獲得痛苦本身，因為它是痛苦；但有時情況會出現，使勞苦與痛楚能為他帶來某種巨大的快樂。  \marginpar[註 2：左側文字]{\raggedright 註 2：頁面右側文字，並非左右對齊，而是使用 \texttt{\string\raggedright}。} 舉一個瑣碎的例子，我們當中有誰曾經從事繁重的體力勞動，除了為了從中獲得某些好處之外？但誰有權責備一個人，因為他選擇享受沒有令人厭惡後果的快樂，或避開不會帶來任何相應快樂的痛苦呢？ [33] 另一方面，我們以正義的憤慨譴責並厭惡那些被當下快樂的魅力所誘騙、所腐化，並因欲望而目盲的人，以致無法預見即將來臨的痛苦與麻煩；同樣應受譴責的，還有那些因意志薄弱而未盡其責的人，這也就是說，他們是因逃避勞苦與痛苦而失職。這些情況都非常單純，也很容易辨別。當我們有空閒時，當我們的選擇能力不受束縛，而且沒有任何事物妨礙我們去做自己最喜歡的事時，每一種快樂都應受到歡迎，每一種痛苦都應避免。 \marginpar[\raggedleft 註 3：頁面左側文字，並非左右對齊，而是使用 \texttt{\string\raggedleft}]{註 3：頁面左側文字}但在某些情況下，出於責任的要求或業務的義務，往往會發生必須摒棄快樂、接受煩擾的情形。因此，智者在這些事情上總是遵循這個選擇原則：他會捨棄某些快樂，以求得其他更大的快樂；或者忍受痛苦，以避免更嚴重的痛苦。
\end{document}
```

在此開啟 `\marginpar` Overleaf 中的範例

此範例會產生以下（兩頁）的輸出：

第 1 頁：

![\marginpar 指令的範例](/files/bedb118faa9d870449bb546afbfb02c1f6a2b7ee)

第 2 頁：

![\marginpar 指令的範例](/files/1ae4cd5169ebb3cb1a7a00e716591ab448ff02d4)

### mparhack 套件：修正錯誤的邊欄

在內部，LaTeX 會將邊注處理為文件中的一種「浮動」元件——類似於 LaTeX 處理浮動圖與表的方式。由於它們屬於「浮動體」，由 `\marginpar` 所產生的邊注偶爾會出現在錯誤的邊欄。這個 [`mparhack` 套件](https://mirror.ox.ac.uk/sites/ctan.org/macros/latex/contrib/mparhack/mparhack.pdf) 套件是為了解決這個問題而寫的，因此如果你遇到這種情況，使用它或許值得一試。

## 替代 \marginpar 的方法：marginnote 套件

該 [`marginnote` 套件](https://www.ctan.org/pkg/marginnote) 提供了 \marginpar 的一個多用途替代方案 `\marginpar` 來完成的。 `marginnote` 使用非浮動機制來實作邊注，這與 `\marginpar` 的運作方式不同： `marginnote` 它解決了一些問題，但正如其文件所指出的，也可能引入其他問題。

### 範例

以下範例示範 `\marginnote` 指令時，也必須載入 `marginnote` 套件中可用的顏色與粗細參數：

```latex
\documentclass{article}
\usepackage[a5paper, total={3in, 6in}]{geometry} % 建立較小的頁面
\usepackage{hyperref} % 使用 \url 指令（在註腳中）
\usepackage{marginnote}
\begin{document}
\section{Lorem Ipsum}
\footnote{來源文字：Wikipedia (\url{https://en.wikipedia.org/wiki/Lorem_ipsum})}但我必須向你解釋，這種將享樂斥為惡、將痛苦頌為善的錯誤觀念是如何產生的。為此，我會向你完整說明這個體系，並闡述這位偉大真理探求者、幸福人類的建築師的真正教誨。 \marginnote{這是一則邊注，相對於它被排版的那一行，已向下移動 2 公分。}[2cm] 沒有人會拒絕、厭惡或迴避快樂本身，因為它是快樂；人們之所以如此，是因為那些不懂得如何理性追求快樂的人，會遭遇極其痛苦的後果。也沒有人會愛、追求或渴望去獲得痛苦本身，因為它是痛苦；但有時情況會出現，使勞苦與痛楚能為他帶來某種巨大的快樂。 \reversemarginpar\marginnote{這是另一則邊注，但相對於它被排版的那一行，已向上移動 2 公分。它也位於左邊界。}[-2cm] 舉一個瑣碎的例子，我們當中有誰曾經從事繁重的體力勞動，除了為了從中獲得某些好處之外？但誰有權責備一個人，因為他選擇享受沒有令人厭惡後果的快樂，或避開不會帶來任何相應快樂的痛苦呢？ [33] 另一方面，我們以正義的憤慨譴責並厭惡那些被當下快樂的魅力所誘騙、所腐化，並因欲望而目盲的人，以致無法預見即將來臨的痛苦與麻煩；同樣應受譴責的，還有那些因意志薄弱而未盡其責的人，這也就是說，他們是因逃避勞苦與痛苦而失職。這些情況都非常單純，也很容易辨別。當我們有空閒時，當我們的選擇能力不受束縛，而且沒有任何事物妨礙我們去做自己最喜歡的事時，每一種快樂都應受到歡迎，每一種痛苦都應避免。但在某些情況下，出於責任的要求或業務的義務，往往會發生必須摒棄快樂、接受煩擾的情形。因此，智者在這些事情上總是遵循這個選擇原則：他會捨棄某些快樂，以求得其他更大的快樂；或者忍受痛苦，以避免更嚴重的痛苦。
\end{document}
```

在 Overleaf 中開啟此範例

此範例會產生以下輸出：

![使用 marginnote 套件](/files/8917af60493bf4bcf3a377592b6367ec9d3ff7a7)

上述範例也載入了 `geometry` 套件，以建立較小的頁面尺寸，並載入 `hyperref` 套件，它提供了 `\url` 指令，用於在註腳中註明文字來源。匯入之後 `marginnote` 套件，方法是在其中的 `\usepackage{marginnote}` 你可以使用 `\marginnote` 指令，如範例文字中的兩個實例所示：

* `\marginnote{這是一則邊注，相對於它被排版的那一行，已向下移動 2 公分。}[2cm]`
* `\marginnote{這是另一則邊注，但相對於它被排版的那一行，已向上移動 2 公分。它也位於左邊界。}[-2cm]`

在這些範例中，我們在方括號內使用第二個參數 `[ ]` ，它會決定相對於使用該指令之行的垂直對齊。第一個 `\margingnote` 命令使用 `[2cm]` 用來將邊注向下移動 2 公分 *往頁面下方*，第二個則使用 `[-2cm]` 用來將邊注向下移動 2 公分 *往頁面上方*.

第二個 `\marginnote` 指令是在 `\reversemarginpar` 被使用之後運作，因此它會被放置在此單面文件的左邊界：

```latex
\reversemarginpar\marginnote{這是另一則邊注，但相對於它被排版的那一行，已向上移動 2 公分。它也位於左邊界。}[-2cm]
```

## 延伸閱讀

更多資訊請參見

* [該 `marginnote` 套件文件所述](http://www.ctan.org/pkg/marginnote)
* [該 `mparhack` 套件文件所述](http://www.ctan.org/pkg/mparhack)
* [頁面大小與邊界](/latex/zh-tw/ge-shi-hua/07-page-size-and-margins.md)
* [註腳](/latex/zh-tw/ge-shi-hua/14-footnotes.md)
* [LaTeX 中的長度](/latex/zh-tw/ge-shi-hua/01-lengths-in-latex.md)
* [單面與雙面文件](/latex/zh-tw/ge-shi-hua/08-single-sided-and-double-sided-documents.md)
* [多欄](/latex/zh-tw/ge-shi-hua/09-multiple-columns.md)
* [頁首與頁尾](/latex/zh-tw/ge-shi-hua/02-headers-and-footers.md)
* [段落格式](/latex/zh-tw/ge-shi-hua/04-articles-how-to-change-paragraph-spacing-in-latex.md)
* [粗體、斜體與底線](/latex/zh-tw/latex-ji-chu/03-bold-italics-and-underlining.md)
* [字型大小、字族與樣式](/latex/zh-tw/zi-xing/01-font-sizes-families-and-styles.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/zh-tw/ge-shi-hua/15-margin-notes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.