> 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/vi/dinh-dang/14-footnotes.md).

# Chú thích cuối trang

## Giới thiệu các lệnh chú thích cuối trang chính của LaTeX

Theo Wikipedia, chú thích cuối trang được phát minh bởi một thợ in người Anh tên là [Richard Jugge](https://en.wikipedia.org/wiki/Note_\(typography\)#History) (\*khoảng\*1514–1577). Biện pháp văn chương lâu đời này được LaTeX hỗ trợ và trong bài viết trợ giúp này, chúng tôi giải thích các lệnh chính liên quan đến chú thích cuối trang và cung cấp nhiều ví dụ để minh họa cách dùng của chúng.

### Lệnh \footnote

Tính năng `\footnote` là lệnh cốt lõi của LaTeX để tạo chú thích cuối trang và có hai dạng:

* `\footnote{*text for footnote*}`: Lệnh này chèn một số mũ (được tạo tự động), gọi là ký hiệu *ký hiệu*, vào văn bản tài liệu và đồng thời tạo chú thích cuối trang tương ứng ở cuối trang, chứa phần chú thích cuối trang tương ứng *ký hiệu* và `*text for footnote*`.
* `\footnote[*number*]{*text for footnote*}`: Dạng lệnh này sử dụng giá trị tùy chọn `*number*` để tạo ký hiệu chú thích cuối trang dạng số mũ *ký hiệu*; nó cũng chèn chú thích cuối trang tương ứng ở cuối trang, chứa ký hiệu nhận dạng chú thích cuối trang (`*number*`) và `*text for footnote*`.

#### Ví dụ: sử dụng lệnh \footnote

Sau đây là một ví dụ minh họa hai biến thể của `\footnote`:

* `\footnote{Ký hiệu chú thích cuối trang được tạo tự động hoạt động tốt!}` tự động dàn trang giá trị số (dạng chỉ số trên) (1) cho ký hiệu chú thích cuối trang, trong khi
* `\footnote[42]{...có phải đó là câu trả lời cho mọi thứ không?}` dùng 42 làm giá trị của ký hiệu chú thích cuối trang và, như bạn có thể thấy, nó không tăng số nguyên dùng để tự động tạo ký hiệu: chú thích cuối trang thứ ba có giá trị ký hiệu là 2.

```latex
Tôi đang viết để minh họa việc sử dụng các ký hiệu chú thích cuối trang được tạo tự động\footnote{Ký hiệu chú thích cuối trang được tạo tự động hoạt động tốt!} và các chú thích cuối trang dùng giá trị ký hiệu do lệnh cung cấp\footnote[42]{...có phải đó là câu trả lời cho mọi thứ không?}.

Bây giờ, tôi sẽ dùng một ký hiệu chú thích cuối trang được tạo tự động khác\footnote{Bây giờ, các ký hiệu chú thích cuối trang là 1, 42, nhưng rồi lại quay về 2? Điều đó sẽ gây nhầm lẫn nếu con số được tạo tự động cũng lên tới 42!}.
```

[Mở ví dụ này trong Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Demonstrating+the+footnote+command\&snip=%5Cdocumentclass%7Barticle%7D%0A%25+Using+the+geometry+package+with+a+small%0A%25+page+size+to+create+the+article+graphic%0A%5Cusepackage%5Bpaperheight%3D6in%2C%0A+++paperwidth%3D5in%2C%0A+++top%3D10mm%2C%0A+++bottom%3D20mm%2C%0A+++left%3D10mm%2C%0A+++right%3D10mm%5D%7Bgeometry%7D%0A%5Cbegin%7Bdocument%7D%0AI%27m+writing+to+demonstrate+use+of+automatically-generated+footnote+markers%5Cfootnote%7BAutomatically+generated+footnote+markers+work+fine%21%7D+and+footnotes+which+use+a+marker+value+provided+to+the+command%5Cfootnote%5B42%5D%7B...is+that+the+answer+to+everything%3F%7D.+%0A%0ANow%2C+I+will+use+another+automatically-generated+footnote+marker%5Cfootnote%7BNow%2C+footnote+markers+are+1%2C+42%2C+but+then+back+to+2%3F+That+will+be+confusing+if+the+automatically-generated+number+also+reaches+42%21%7D.%0A%5Cend%7Bdocument%7D)

Ví dụ này tạo ra kết quả sau:

![Ví dụ cơ bản về chú thích cuối trang](/files/9e77c5b061ab242cb375f2408b530d69497b9b51)

### Lưu trữ giá trị hiện tại của ký hiệu chú thích cuối trang: bộ đếm LaTeX

LaTeX sử dụng cái gọi là [*biến đếm*](/latex/vi/dinh-dang/10-counters.md) để lưu giá trị hiện tại của các ký hiệu chú thích cuối trang. Trên thực tế, LaTeX cung cấp và sử dụng hai biến bộ đếm tùy theo nơi chú thích cuối trang được dùng:

* `footnote`: biến bộ đếm cho chú thích cuối trang trong văn bản chính của tài liệu
* `mpfootnote`: biến bộ đếm cho chú thích cuối trang trong một `minipage` môi trường

Mỗi khi `\footnote{*text*}` phiên bản của lệnh đó được dùng, biến bộ đếm tương ứng được tăng thêm 1. Với `\footnote[*number*]{*text*}` phiên bản này, biến bộ đếm tương ứng được *không* tăng lên.

Bạn có thể tạo thêm các biến bộ đếm và dùng chúng để tạo chú thích cuối trang, như được minh họa trong [ví dụ bên dưới](#example-from-latex2e-unofficial-reference-manual).

### Các lệnh \footnotemark và \footnotetext

Ngoài `\footnote`, LaTeX còn cung cấp các lệnh:

* `\footnotemark` lệnh này dàn trang ký hiệu chú thích cuối trang, và
* `\footnotetext` lệnh này dàn trang phần văn bản chú thích cuối trang

Cả hai lệnh đều nhận một *tùy chọn* đối số đặt trong dấu ngoặc vuông (`[...]`):

* `\footnotemark[*number*]`: dàn trang một ký hiệu chú thích cuối trang tại vị trí lệnh được dùng nhưng không tạo/dàn trang chú thích cuối trang tương ứng ở cuối trang.
  * `[*number*]` là *tùy chọn* đối số, chỉ định rằng giá trị `*number*` nên được dùng cho ký hiệu chú thích cuối trang.
  * Nếu bạn dùng lệnh này *không có* đối số tùy chọn, viết nó là `\footnotemark`, thì dạng lệnh này tạo ký hiệu chú thích cuối trang bằng một biến nội bộ của LaTeX gọi là một [biến đếm](/latex/vi/dinh-dang/10-counters.md)—biến này được tăng lên 1 khi giá trị `*number*` giá trị *không* được cung cấp.
* `\footnotetext[*number*]{*text for footnote*}`: dàn trang phần văn bản chú thích cuối trang (`*text for footnote*`) tương ứng với ký hiệu được tạo bởi `\footnotemark`.
  * `[*number*]` là *tùy chọn* đối số trước đó, đối số này chỉ định ký hiệu chú thích cuối trang tương ứng cho `*text for footnote*`.
  * Nếu bạn dùng lệnh này *không có* đối số tùy chọn `*number*` , tức là viết nó là `\footnotetext{*text for footnote*}`, thì dạng lệnh này tạo một chú thích cuối trang có ký hiệu tương ứng với `\footnotemark`.

#### Ví dụ: sử dụng \footnotemark và \footnotetext

Tính năng `\footnotemark` và `\footnotetext` các lệnh này thường được dùng cùng nhau để tạo chú thích cuối trang trong bảng, hoặc ở các vị trí khác, nơi `\footnote` lệnh chuẩn không hoạt động, hoặc không phải là giải pháp tốt/tối ưu nhất—một số ứng dụng được minh họa trong bài viết này (xem [ở đây](#example-from-latex2e-unofficial-reference-manual) và [ở đây](#footnotes-with-multiple-references)).

```latex
Tôi đang viết để kiểm tra các lệnh \verb|\footnotemark| và \verb|\footnotetext|.
Bạn có thể chèn một ký hiệu chú thích cuối trang bằng cách dùng \verb|\footnotemark|\footnotemark{}
lệnh và sau đó, khi bạn sẵn sàng, dàn trang phần văn bản chú thích cuối trang bằng cách viết
\verb|\footnotetext{Đây là chú thích cuối trang.}|. \footnotetext{Đây là chú thích cuối trang.}

Hãy làm thêm một lần nữa để xem kết quả\footnotemark{} mà tôi sẽ bình luận trong
chú thích cuối trang\footnotetext{Cụ thể, tôi sẽ viết nhận xét trong chú thích này.}.
```

[Mở ví dụ này trong Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=footnotemark+and+footnotetext+demo\&snip=%5Cdocumentclass%7Barticle%7D%0A%25+Using+the+geometry+package+with+a+small%0A%25+page+size+to+create+the+article+graphic%0A%5Cusepackage%5Bpaperheight%3D6in%2C%0A+++paperwidth%3D5in%2C%0A+++top%3D10mm%2C%0A+++bottom%3D20mm%2C%0A+++left%3D10mm%2C%0A+++right%3D10mm%5D%7Bgeometry%7D%0A%5Cbegin%7Bdocument%7D%0AI%27m+writing+to+test+the+%5Cverb%7C%5Cfootnotemark%7C+and+%5Cverb%7C%5Cfootnotetext%7C+commands.+%0AYou+can+insert+a+footnote+marker+using+the+%5Cverb%7C%5Cfootnotemark%7C%5Cfootnotemark%7B%7D%0Acommand+and+later%2C+when+you%27re+ready%2C+typeset+the+footnote+text+by+writing+%0A%5Cverb%7C%5Cfootnotetext%7BHere%27s+the+footnote.%7D%7C.+%5Cfootnotetext%7BHere%27s+the+footnote.%7D%0A%0ALet%27s+do+one+more+to+see+the+result%5Cfootnotemark%7B%7D+which+I%27ll+comment+on+within+the%0Afootnote%5Cfootnotetext%7BSpecifically%2C+I%27d+write+comments+in+this+one.%7D.%0A%5Cend%7Bdocument%7D)

Ví dụ này tạo ra kết quả sau:

![Sử dụng chú thích cuối trang trong Overleaf](/files/c67fe3d1194773eda5a6333eab996dcacab601df)

### Các lệnh chú thích cuối trang khác của LaTeX

Ngoài các lệnh chúng ta đã tìm hiểu:

* `\footnote[*number*]{*text for footnote*}`
* `\footnotemark[*number*]`
* `\footnotetext[*number*]{*text for footnote*}`

LaTeX còn cung cấp một số lệnh bổ sung liên quan đến chú thích cuối trang mà chúng ta sẽ liệt kê nhưng không tìm hiểu chi tiết. Các mô tả sau được lấy từ tài liệu mã nguồn LaTeX2e:

* `\footnotesize`: Lệnh thay đổi kích thước cho chú thích cuối trang.
* `\footins`: Khoảng cách giữa văn bản chính và chú thích cuối trang. Đường kẻ phân tách chú thích cuối trang khỏi văn bản xuất hiện trong khoảng này. Khoảng này nằm phía trên thanh chống có chiều cao `\footnotesep` nằm ở đầu chú thích cuối trang đầu tiên.
* `\footnoterule`: Macro để vẽ đường kẻ phân tách chú thích cuối trang khỏi văn bản. Nó được thực thi ngay sau một `\vspace` của `\skip\footins`. Nó nên chiếm không gian dọc bằng 0—tức là nó nên là một khoảng lùi âm để bù cho mọi khoảng dương mà nó chiếm.
* `\footnotesep`: Chiều cao của một thanh chống được đặt ở đầu mỗi chú thích cuối trang.

## Ví dụ và ứng dụng của chú thích cuối trang

### Chú thích cuối trang với nhiều tham chiếu

Ví dụ sau minh họa một cách để tạo nhiều tham chiếu đến cùng một chú thích cuối trang. Bằng cách dùng `\footnotemark[\value{footnote}]` bạn có thể chèn một số mũ tương ứng với *hiện tại* giá trị của `footnote` [bộ đếm](/latex/vi/dinh-dang/10-counters.md) nhưng không tăng `footnote` giá trị bộ đếm (để biết thêm về bộ đếm, xem [bài viết trợ giúp này của Overleaf](/latex/vi/dinh-dang/10-counters.md)).

```latex
Tôi đang viết để kiểm tra\footnote{Chú thích cuối trang hoạt động tốt!} một số tính năng của chú thích cuối trang.
Bạn có thể chèn ký hiệu chú thích cuối trang\footnotemark{} bằng cách dùng \verb|\footnotemark|
lệnh và sau đó dùng lệnh \verb|\footnotetext| để dàn trang phần chú thích
bằng cách viết \verb|\footnotetext{Văn bản của chú thích cuối trang thứ hai.}|
\footnotetext{Văn bản của chú thích cuối trang thứ hai.}.

Tôi có thể dùng cùng một chú thích cuối trang\footnotemark{} nhiều hơn
một lần\footnotemark[\value{footnote}].

\footnotetext{Một chú thích cuối trang có hai tham chiếu.}
```

[Mở ví dụ này trong Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Two+references+to+footnotes\&snip=%5Cdocumentclass%7Barticle%7D%0A%25+Using+the+geometry+package+with+a+small%0A%25+page+size+to+create+the+article+graphic%0A%5Cusepackage%5Bpaperheight%3D6in%2C%0A+++paperwidth%3D5in%2C%0A+++top%3D10mm%2C%0A+++bottom%3D20mm%2C%0A+++left%3D10mm%2C%0A+++right%3D10mm%5D%7Bgeometry%7D%0A%5Cbegin%7Bdocument%7D%0AI%27m+writing+to+test%5Cfootnote%7BFootnotes+work+fine%21%7D+several+footnote+features.+%0AYou+can+insert+the+footnote+marker%5Cfootnotemark%7B%7D+using+the+%5Cverb%7C%5Cfootnotemark%7C%0Acommand+and+later+use+the+%5Cverb%7C%5Cfootnotetext%7C+command+to+typeset+the+footnote%0Atext+by+writing+%5Cverb%7C%5Cfootnotetext%7BText+of+second+footnote.%7D%7C%0A%5Cfootnotetext%7BText+of+second+footnote.%7D.%0A%0AI+can+use+the+same+footnote%5Cfootnotemark%7B%7D+more+than+%0Aonce%5Cfootnotemark%5B%5Cvalue%7Bfootnote%7D%5D.%0A%0A%5Cfootnotetext%7BA+footnote+with+two+references.%7D%0A%5Cend%7Bdocument%7D)

Ví dụ này tạo ra kết quả sau:

![Sử dụng nhiều tham chiếu chú thích cuối trang](/files/4707a4f51258069dcb57fa4578a5a21c0cef3c79)

### Thay đổi kiểu đánh số

Giá trị hiện tại của số chú thích cuối trang được lưu trong một biến LaTeX gọi là `footnote` [*bộ đếm*](/latex/vi/dinh-dang/10-counters.md) và có thể được dàn trang bằng lệnh `\thefootnote`. Bạn có thể thay đổi định dạng dàn trang của các ký hiệu chú thích cuối trang bằng cách sửa đổi `\thefootnote` lệnh; ví dụ, `\renewcommand{\thefootnote}{\roman{footnote}}` sẽ dàn trang các ký hiệu bằng số La Mã viết thường. Bạn có thể dùng `\renewcommand{\thefootnote}{...}` trong phần tiền đề để thay đổi kiểu đánh số của chú thích cuối trang trong văn bản chính của tài liệu.

Các kiểu ký hiệu khác có thể dùng là:

* `\arabic{*biến đếm*}`: dàn trang `*biến bộ đếm*` bằng chữ số Ả Rập.
* `\Roman{*biến đếm*}`: dàn trang `*biến bộ đếm*` bằng số La Mã viết hoa.
* `\alph{*biến đếm*}`: dàn trang `*biến bộ đếm*` bằng chữ cái Alphabet viết thường.
* `\Alph{*biến đếm*}`: dàn trang `*biến bộ đếm*` bằng chữ cái Alphabet viết hoa.
* `\fnsymbol{*counter variable*}`: dàn trang `*biến bộ đếm*` sử dụng một [bộ 9 ký hiệu đặc biệt](/latex/vi/dinh-dang/10-counters.md#accessing-and-printing-counter-values).

Để biết thông tin nền về việc tạo, dùng và sửa đổi bộ đếm, xem [bài viết này trên Overleaf về bộ đếm](/latex/vi/dinh-dang/10-counters.md#accessing-and-printing-counter-values).

Đây là một ví dụ sử dụng `\renewcommand{\thefootnote}{\roman{footnote}}`:

```latex
Tôi đang viết để kiểm tra\footnote{Chú thích cuối trang hoạt động tốt!} một số tính năng của chú thích cuối trang.
Bạn có thể chèn ký hiệu chú thích cuối trang\footnotemark{} bằng cách dùng \verb|\footnotemark|
lệnh và sau đó dùng lệnh \verb|\footnotetext| để dàn trang phần chú thích
bằng cách viết \verb|\footnotetext{Văn bản của chú thích cuối trang thứ hai.}|
\footnotetext{Văn bản của chú thích cuối trang thứ hai.}.

Tôi có thể dùng cùng một chú thích cuối trang\footnotemark{} nhiều hơn
một lần\footnotemark[\value{footnote}].

\footnotetext{Một chú thích cuối trang có hai tham chiếu.}

\renewcommand{\thefootnote}{\roman{footnote}}
Bây giờ là một ký hiệu chú thích cuối trang sử dụng số La Mã viết thường\footnote{Ký hiệu chú thích cuối trang này dùng số La Mã viết thường.}.
```

[Mở ví dụ này trong Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Changing+footnote+numbering+style\&snip=%5Cdocumentclass%7Barticle%7D%0A%25+Using+the+geometry+package+with+a+small%0A%25+page+size+to+create+the+article+graphic%0A%5Cusepackage%5Bpaperheight%3D6in%2C%0A+++paperwidth%3D5in%2C%0A+++top%3D10mm%2C%0A+++bottom%3D20mm%2C%0A+++left%3D10mm%2C%0A+++right%3D10mm%5D%7Bgeometry%7D%0A%5Cbegin%7Bdocument%7D%0AI%27m+writing+to+test%5Cfootnote%7BFootnotes+work+fine%21%7D+several+footnote+features.+%0AYou+can+insert+the+footnote+marker%5Cfootnotemark%7B%7D+using+the+%5Cverb%7C%5Cfootnotemark%7C%0Acommand+and+later+use+the+%5Cverb%7C%5Cfootnotetext%7C+command+to+typeset+the+footnote%0Atext+by+writing+%5Cverb%7C%5Cfootnotetext%7BText+of+second+footnote.%7D%7C%0A%5Cfootnotetext%7BText+of+second+footnote.%7D.%0A%0AI+can+use+the+same+footnote%5Cfootnotemark%7B%7D+more+than+%0Aonce%5Cfootnotemark%5B%5Cvalue%7Bfootnote%7D%5D.%0A%0A%5Cfootnotetext%7BA+footnote+with+two+references.%7D%0A%0A%5Crenewcommand%7B%5Cthefootnote%7D%7B%5Croman%7Bfootnote%7D%7D%0ANow+a+footnote+marker+using+lowercase+Roman+numerals%5Cfootnote%7BThis+footnote+marker+uses+lowercase+Roman+numerals.%7D.%0A%5Cend%7Bdocument%7D)

Ví dụ này tạo ra kết quả sau:

![Thay đổi kiểu đánh số chú thích cuối trang](/files/815615d56144630aee2cddd9f496bdf3c80cacab)

### Chú thích cuối trang trong môi trường minipage

Chú thích cuối trang trong một `minipage` môi trường hoạt động khác vì các lệnh `\footnote` và `\footnotetext` được định nghĩa lại tạm thời để chú thích cuối trang:

* được đặt ở cuối `minipage`, không phải ở trang chính của tài liệu
* được gán nhãn/đánh số bằng một cơ chế khác với chú thích trong văn bản—trong một `minipage` các chú thích cuối trang dùng một bộ đếm gọi là `mpfootnote`

Sau đây là một ví dụ về chú thích cuối trang trong một `minipage`:

```latex
Đây là phần mở đầu của một đoạn văn bản ngay trước khi chúng ta chuyển sang môi trường \texttt{minipage}. Đây là một chú thích trong trang\footnote{Chú thích trước một minipage}.

\vspace{10pt}
\begin{minipage}{0.7\textwidth}
Đây là văn bản trong môi trường \texttt{minipage}. Đây là chú thích \texttt{minipage} đầu tiên\footnote{Chú thích minipage thứ nhất.}. Và đây là một chú thích \texttt{minipage} khác\footnote{Chú thích minipage thứ hai.}.
\end{minipage}
\vspace{10pt}

Đây là phần mở đầu của một đoạn văn bản chuẩn ngay sau khi chúng ta kết thúc môi trường \texttt{minipage}. Đây là một chú thích trong trang\footnote{Chú thích sau một minipage}.
```

[Mở ví dụ này trong Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Footnotes+in+a+minipage\&snip=%5Cdocumentclass%7Barticle%7D%0A%25+Using+the+geometry+package+with+a+small%0A%25+page+size+to+create+the+article+graphic%0A%5Cusepackage%5Bpaperheight%3D6in%2C%0A+++paperwidth%3D5in%2C%0A+++top%3D10mm%2C%0A+++bottom%3D20mm%2C%0A+++left%3D10mm%2C%0A+++right%3D10mm%5D%7Bgeometry%7D%0A%5Cbegin%7Bdocument%7D%0AThis+is+the+start+of+a+paragraph+of+text+just+before+we+switch+to+a+%5Ctexttt%7Bminipage%7D+environment.+This+is+an+in-page+footnote%5Cfootnote%7BFootnote+before+a+minipage%7D.%0A%0A%5Cvspace%7B10pt%7D%0A%5Cbegin%7Bminipage%7D%7B0.7%5Ctextwidth%7D%0AThis+is+text+in+a+%5Ctexttt%7Bminipage%7D+environment.+Here+is+the+first+%5Ctexttt%7Bminipage%7D+footnote%5Cfootnote%7BFirst+minipage+footnote.%7D.+And+another+%5Ctexttt%7Bminipage%7D+footnote%5Cfootnote%7BSecond+minipage+footnote.%7D.%0A%5Cend%7Bminipage%7D%0A%5Cvspace%7B10pt%7D%0A%0AThis+is+the+start+of+a+standard+paragraph+of+text+just+after+we+finished+a+%5Ctexttt%7Bminipage%7D+environment.+This+is+an+in-page+footnote%5Cfootnote%7BFootnote+after+a+minipage%7D.%0A%5Cend%7Bdocument%7D)

Ví dụ này tạo ra kết quả sau:

![Sử dụng chú thích cuối trang trong một minipage](/files/799f47d011e1192b2147edcde73cff0f8828aecf)

### Thay đổi ký hiệu chú thích cuối trang của minipage

Như ví dụ trên cho thấy, trong một `minipage` các ký hiệu chú thích cuối trang là chữ cái viết thường; tuy nhiên, `\renewcommand` có thể được dùng để định nghĩa lại cách `mpfootnote` giá trị bộ đếm được dàn trang. Ví dụ, để dàn trang `minipage` các ký hiệu chú thích cuối trang dưới dạng chữ số Ả Rập:

```latex
\renewcommand{\thempfootnote}{\arabic{mpfootnote}}
```

như được cho thấy trong ví dụ sau:

```latex
\renewcommand{\thempfootnote}{\arabic{mpfootnote}}
\begin{minipage}{0.7\textwidth}
Đây là văn bản trong môi trường \texttt{minipage}. Đây là chú thích \texttt{minipage} đầu tiên\footnote{Chú thích minipage thứ nhất.}. Và đây là một chú thích \texttt{minipage} khác\footnote{Chú thích minipage thứ hai.}.
\end{minipage}
```

[Mở ví dụ này trong Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Changing+minipage+footnote+marker\&snip=%5Cdocumentclass%7Barticle%7D%0A%25+Using+the+geometry+package+with+a+small%0A%25+page+size+to+create+the+article+graphic%0A%5Cusepackage%5Bpaperheight%3D6in%2C%0A+++paperwidth%3D5in%2C%0A+++top%3D10mm%2C%0A+++bottom%3D20mm%2C%0A+++left%3D10mm%2C%0A+++right%3D10mm%5D%7Bgeometry%7D%0A%5Cbegin%7Bdocument%7D%0A%5Crenewcommand%7B%5Cthempfootnote%7D%7B%5Carabic%7Bmpfootnote%7D%7D%0A%5Cbegin%7Bminipage%7D%7B0.7%5Ctextwidth%7D%0AThis+is+text+in+a+%5Ctexttt%7Bminipage%7D+environment.+Here+is+the+first+%5Ctexttt%7Bminipage%7D+footnote%5Cfootnote%7BFirst+minipage+footnote.%7D.+And+another+%5Ctexttt%7Bminipage%7D+footnote%5Cfootnote%7BSecond+minipage+footnote.%7D.%0A%5Cend%7Bminipage%7D%0A%5Cend%7Bdocument%7D)

Ví dụ này tạo ra kết quả sau:

![Thay đổi ký hiệu chú thích cuối trang của minipage](/files/11227be2f563064fbd168b5cc3cce56746bc1cc2)

## Chú thích cuối trang trong bảng

Các phần sau xem xét một số chủ đề liên quan đến việc dùng chú thích cuối trang trong bảng.

### Có nên dùng chú thích cuối trang trong bảng không?

Tính năng [Danh sách Câu hỏi thường gặp cho TeX](https://texfaq.org/) có một mục về [chú thích cuối trang trong bảng](https://texfaq.org/FAQ-footintab) trong đó nhận xét rằng việc dùng chú thích cuối trang trong bảng không được xem là thực hành dàn trang tốt nhất: lý tưởng thì, *ghi chú bảng* nên được dùng thay cho *chú thích cuối trang trong bảng*. Việc dùng ghi chú bảng hay chú thích cuối trang trong bảng có thể được quy định bởi các tệp lớp/kiểu tài liệu bạn bắt buộc phải dùng, hoặc tùy bạn lựa chọn: dù thế nào, LaTeX cũng cung cấp nhiều giải pháp bạn có thể dùng.

### Ví dụ: \footnote không hoạt động trong môi trường tabular

Tính năng `\footnote` lệnh không hoạt động bên trong môi trường tabular, như ví dụ sau minh họa. Lưu ý ví dụ này dùng `hologo` gói LaTeX để dàn trang tên của nhiều bộ máy TeX khác nhau.

```latex
\begin{table}
  \centering
    \begin{tabular}{lcc}
     \midrule
     \TeX{} engine & Native UTF-8 support & Unicode math support\\
     \midrule
       \hologo{pdfTeX} & Không\footnote{Một phần hỗ trợ UTF-8 thông qua các lệnh hạt nhân của \LaTeX{}.} & Không\\
       \Hologo{XeTeX} & Có & Có\\
       \Hologo{LuaTeX} & Có & Có\\
       \midrule
     \end{tabular}
    \caption[\TeX{} các tính năng của bộ máy]{
      So sánh tính năng của bộ máy \TeX{}\footnote{Bản nháp. Sẽ bổ sung thêm các so sánh tính năng khác.}.}
\end{table}
```

[Mở ví dụ này trong Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+of+table+footnotes+not+working\&snip=%5Cdocumentclass%7Barticle%7D%0A%25+Using+the+geometry+package+with+a+small%0A%25+page+size+to+create+the+article+graphic%0A%5Cusepackage%5Bpaperheight%3D6in%2C%0A+++paperwidth%3D5in%2C%0A+++top%3D10mm%2C%0A+++bottom%3D20mm%2C%0A+++left%3D10mm%2C%0A+++right%3D10mm%5D%7Bgeometry%7D%0A%5Cusepackage%7Bhologo%7D+%25+for+TeX+engine+logos%0A%5Cusepackage%7Bbooktabs%7D+%25+for+nice+tables%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Btable%7D%0A++%5Ccentering%0A++++%5Cbegin%7Btabular%7D%7Blcc%7D%0A+++++%5Cmidrule+%0A+++++%5CTeX%7B%7D+engine+%26+Native+UTF-8+support+%26+Unicode+math+support%5C%5C%0A+++++%5Cmidrule%0A+++++++%5Chologo%7BpdfTeX%7D+%26+No%5Cfootnote%7BSome+UTF-8+support+via+%5CLaTeX%7B%7D+kernel+commands.%7D+%26+No%5C%5C%0A+++++++%5CHologo%7BXeTeX%7D+%26+Yes+%26+Yes%5C%5C%0A+++++++%5CHologo%7BLuaTeX%7D+%26+Yes+%26+Yes%5C%5C%0A+++++++%5Cmidrule+%0A+++++%5Cend%7Btabular%7D%0A++++%5Ccaption%5B%5CTeX%7B%7D+engine+features%5D%7B%25%0A++++++%5CTeX%7B%7D+engine+feature+comparison%5Cfootnote%7BDraft+version.+Additional+feature+comparisons+will+be+added.%7D.%7D%0A%5Cend%7Btable%7D%0A%5Cend%7Bdocument%7D)

Ví dụ này tạo ra kết quả sau, cho thấy sự hiện diện của dấu chú thích cuối trang trong ô bảng và chú thích, nhưng không có văn bản chú thích cuối trang tương ứng:

![Thiếu văn bản chú thích cuối trang trong môi trường tabular](/files/2433cfb5f928855b10f0038cd77d1ff6efa38e0b)

Một giải pháp một phần là đặt `tabular` bên trong một `minipage` môi trường:

```latex
\begin{minipage}{\textwidth}
  \centering
    \begin{tabular}{lcc}
     \midrule
     \TeX{} engine & Native UTF-8 support & Unicode math support\\
     \midrule
       \hologo{pdfTeX} & Không\footnote{Một phần hỗ trợ UTF-8 thông qua các lệnh hạt nhân của \LaTeX{}.} & Không\\
       \Hologo{XeTeX} & Có & Có\\
       \Hologo{LuaTeX} & Có & Có\\
       \midrule
     \end{tabular}
\end{minipage}
```

[Mở ví dụ này trong Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+of+tabular+in+a+minipage\&snip=%5Cdocumentclass%7Barticle%7D%0A%25+Using+the+geometry+package+with+a+small%0A%25+page+size+to+create+the+article+graphic%0A%5Cusepackage%5Bpaperheight%3D6in%2C%0A+++paperwidth%3D5in%2C%0A+++top%3D10mm%2C%0A+++bottom%3D20mm%2C%0A+++left%3D10mm%2C%0A+++right%3D10mm%5D%7Bgeometry%7D%0A%5Cusepackage%7Bhologo%7D+%25+for+TeX+engine+logos%0A%5Cusepackage%7Bbooktabs%7D+%25+for+nice+tables%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bminipage%7D%7B%5Ctextwidth%7D%0A++%5Ccentering%0A++++%5Cbegin%7Btabular%7D%7Blcc%7D%0A+++++%5Cmidrule+%0A+++++%5CTeX%7B%7D+engine+%26+Native+UTF-8+support+%26+Unicode+math+support%5C%5C%0A+++++%5Cmidrule%0A+++++++%5Chologo%7BpdfTeX%7D+%26+No%5Cfootnote%7BSome+UTF-8+support+via+%5CLaTeX%7B%7D+kernel+commands.%7D+%26+No%5C%5C%0A+++++++%5CHologo%7BXeTeX%7D+%26+Yes+%26+Yes%5C%5C%0A+++++++%5CHologo%7BLuaTeX%7D+%26+Yes+%26+Yes%5C%5C%0A+++++++%5Cmidrule+%0A+++++%5Cend%7Btabular%7D%0A%5Cend%7Bminipage%7D%0A%5Cend%7Bdocument%7D)

Ví dụ này tạo ra kết quả sau:

![Bảng tabular LaTeX trong một minipage để sửa chú thích cuối trang](/files/52a0dc5d364c47dc4306eb9b37b01d0d1686ad54)

Lưu ý rằng bạn cũng có thể viết `\renewcommand{\thempfootnote}{\arabic{mpfootnote}}` để có `minipage` các ký hiệu chú thích cuối trang của bảng được dàn trang bằng chữ số Ả Rập thay vì chữ cái viết thường.

### Ví dụ từ sổ tay tham khảo không chính thức của LaTeX2e

Tính năng [sổ tay tham khảo không chính thức của LaTeX2e](https://latexref.xyz/index.html) có một ví dụ thú vị trong phần [Chú thích cuối trang trong một bảng](https://latexref.xyz/Footnotes-in-a-table.html). Thông thường, chú thích cuối trang của bảng trong một `minipage` được đặt ở cuối `minipage`, như các ví dụ trên đã cho thấy. Ví dụ sau, từ [sổ tay tham khảo không chính thức của LaTeX2e](https://latexref.xyz/Footnotes-in-a-table.html) sử dụng `\footnotemark` và `\footnotetext` các lệnh, cùng với một bộ đếm mới (`mpFootnoteValueSaver`) để đảm bảo các chú thích cuối trang của bảng xuất hiện ở cuối trang tài liệu, được tính như một phần của các chú thích cuối trang chuẩn của tài liệu.

Khi bảng được dàn trang, mã LaTeX `\setcounter{mpFootnoteValueSaver}{\value{footnote}}` đặt giá trị của `mpFootnoteValueSaver` thành giá trị hiện tại của `footnote` giá trị bộ đếm; điều này bảo đảm các chú thích cuối trang được tạo trong bảng sử dụng các giá trị ký hiệu được đồng bộ với chuỗi chú thích cuối trang của tài liệu chính (số thứ tự). Sau khi bảng được dàn trang, hãy lưu ý cách `mpFootnoteValueSaver` được tăng thêm 1 thông qua mã `\stepcounter{mpFootnoteValueSaver}`.

```latex
\newcounter{mpFootnoteValueSaver}
\begin{center}
  \begin{minipage}{\textwidth}
    \setcounter{mpFootnoteValueSaver}{\value{footnote}} \centering
     \begin{tabular}{l|l}
       \textsc{Woman}             &\textsc{Relationship} \\ \hline
       Mona                       &Đã có đôi\footnotemark  \\
       Diana Villiers             &Người vợ sau này  \\
       Christine Hatherleigh Wood &Vị hôn thê\footnotemark
     \end{tabular}
  \end{minipage}%  dấu phần trăm giữ văn bản chú thích cuối trang gần với minipage
  \stepcounter{mpFootnoteValueSaver}%
    \footnotetext[\value{mpFootnoteValueSaver}]{%
      Không biết nhiều ngoài việc bà ấy đã qua đời.}%
  \stepcounter{mpFootnoteValueSaver}%
    \footnotetext[\value{mpFootnoteValueSaver}]{%
      Mối quan hệ vẫn chưa được giải quyết trong XXI.}
\end{center}
```

[Mở ví dụ này trong Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+of+custom+table+footnotes\&snip=%5Cdocumentclass%7Barticle%7D%0A%25+Using+the+geometry+package+with+a+small%0A%25+page+size+to+create+the+article+graphic%0A%5Cusepackage%5Bpaperheight%3D6in%2C%0A+++paperwidth%3D5in%2C%0A+++top%3D10mm%2C%0A+++bottom%3D20mm%2C%0A+++left%3D10mm%2C%0A+++right%3D10mm%5D%7Bgeometry%7D%0A%5Cusepackage%7Bhologo%7D+%25+for+TeX+engine+logos%0A%5Cusepackage%7Bbooktabs%7D+%25+for+nice+tables%0A%5Cbegin%7Bdocument%7D%0A%5Cnewcounter%7BmpFootnoteValueSaver%7D%0A%5Cbegin%7Bcenter%7D%0A++%5Cbegin%7Bminipage%7D%7B%5Ctextwidth%7D%0A++++%5Csetcounter%7BmpFootnoteValueSaver%7D%7B%5Cvalue%7Bfootnote%7D%7D+%5Ccentering%0A+++++%5Cbegin%7Btabular%7D%7Bl%7Cl%7D%0A+++++++%5Ctextsc%7BWoman%7D+++++++++++++%26%5Ctextsc%7BRelationship%7D+%5C%5C+%5Chline+%0A+++++++Mona+++++++++++++++++++++++%26Attached%5Cfootnotemark++%5C%5C+%0A+++++++Diana+Villiers+++++++++++++%26Eventual+wife++%5C%5C++%0A+++++++Christine+Hatherleigh+Wood+%26Fiance%5Cfootnotemark+%0A+++++%5Cend%7Btabular%7D%0A++%5Cend%7Bminipage%7D%25++percent+sign+keeps+footnote+text+close+to+minipage%0A++%5Cstepcounter%7BmpFootnoteValueSaver%7D%25%0A++++%5Cfootnotetext%5B%5Cvalue%7BmpFootnoteValueSaver%7D%5D%7B%25%0A++++++Little+is+known+other+than+her+death.%7D%25%0A++%5Cstepcounter%7BmpFootnoteValueSaver%7D%25%0A++++%5Cfootnotetext%5B%5Cvalue%7BmpFootnoteValueSaver%7D%5D%7B%25%0A++++++Relationship+is+unresolved+in+XXI.%7D%0A%5Cend%7Bcenter%7D%0A%5Cend%7Bdocument%7D)

Ví dụ này tạo ra kết quả sau:

![Tạo chú thích cuối trang trong bảng trong LaTeX](/files/27681f7d279a284a3eae4e3fdec184733e64085a)

### Ví dụ: chú thích cuối trang trong bảng qua gói tablefootnote

Một lựa chọn là [`tablefootnote` gói](https://ctan.org/pkg/tablefootnote?lang=en) vốn là [được nhắc đến trên tex.stackexchange](https://tex.stackexchange.com/a/35669) và được tham chiếu trong Danh sách Câu hỏi thường gặp cho TeX [mục về chú thích cuối trang trong bảng](https://texfaq.org/FAQ-footintab). Ví dụ sau minh họa `tablefootnote` gói:

```latex
\documentclass{article}
% Sử dụng gói geometry với một
% kích thước trang nhỏ để tạo hình minh họa của bài viết
\usepackage[paperheight=6in,
   paperwidth=5in,
   top=10mm,
   bottom=20mm,
   left=10mm,
   right=10mm]{geometry}
\usepackage{hologo} % cho logo bộ máy TeX
\usepackage{booktabs} % cho các bảng đẹp
\usepackage{tablefootnote} % cho chú thích cuối trang trong bảng
\begin{document}
\begin{table}
  \centering
    \begin{tabular}{lcc}
     \midrule
     \TeX{} engine & Native UTF-8 support & Unicode math support\\
     \midrule
       \hologo{pdfTeX} & Không\tablefootnote{Một phần hỗ trợ UTF-8 thông qua các lệnh hạt nhân của \LaTeX{}.} & Không\\
       \Hologo{XeTeX} & Có & Có\\
       \Hologo{LuaTeX} & Có & Có\\
       \midrule
     \end{tabular}
    \caption[\TeX{} các tính năng của bộ máy]{
      \TeX{} so sánh tính năng của bộ máy\tablefootnote{Bản nháp. Sẽ bổ sung thêm các so sánh tính năng khác.}.}
\end{table}
\end{document}
```

[Mở `\tablefootnote` ví dụ gói trong Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+of+tablefootnote+package\&snip=%5Cdocumentclass%7Barticle%7D%0A%25+Using+the+geometry+package+with+a+small%0A%25+page+size+to+create+the+article+graphic%0A%5Cusepackage%5Bpaperheight%3D6in%2C%0A+++paperwidth%3D5in%2C%0A+++top%3D10mm%2C%0A+++bottom%3D20mm%2C%0A+++left%3D10mm%2C%0A+++right%3D10mm%5D%7Bgeometry%7D%0A%5Cusepackage%7Bhologo%7D+%25+for+TeX+engine+logos%0A%5Cusepackage%7Bbooktabs%7D+%25+for+nice+tables%0A%5Cusepackage%7Btablefootnote%7D+%25+for+table+footnotes%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Btable%7D%0A++%5Ccentering%0A++++%5Cbegin%7Btabular%7D%7Blcc%7D%0A+++++%5Cmidrule+%0A+++++%5CTeX%7B%7D+engine+%26+Native+UTF-8+support+%26+Unicode+math+support%5C%5C%0A+++++%5Cmidrule%0A+++++++%5Chologo%7BpdfTeX%7D+%26+No%5Ctablefootnote%7BSome+UTF-8+support+via+%5CLaTeX%7B%7D+kernel+commands.%7D+%26+No%5C%5C%0A+++++++%5CHologo%7BXeTeX%7D+%26+Yes+%26+Yes%5C%5C%0A+++++++%5CHologo%7BLuaTeX%7D+%26+Yes+%26+Yes%5C%5C%0A+++++++%5Cmidrule+%0A+++++%5Cend%7Btabular%7D%0A++++%5Ccaption%5B%5CTeX%7B%7D+engine+features%5D%7B%25%0A++++++%5CTeX%7B%7D+engine+feature+comparison%5Ctablefootnote%7BDraft+version.+Additional+feature+comparisons+will+be+added.%7D.%7D%0A%5Cend%7Btable%7D%0A%5Cend%7Bdocument%7D)

Ví dụ này tạo ra kết quả sau:

![Ví dụ về gói tablefootnote](/files/c26f53bbc05e2c6f74657a9a3f5bfd1ad5ee2326)

## Ghi chú bảng: một lựa chọn thay thế cho chú thích cuối trang

Tính năng [`threeparttable` gói](https://ctan.org/pkg/threeparttable) cung cấp một cơ chế để tạo ghi chú bảng *ghi chú*—một lựa chọn thay thế cho việc dùng chú thích cuối trang trong bảng. The [`threeparttabl**ex**` gói](https://ctan.org/pkg/threeparttablex) triển khai một tiện ích ghi chú bảng để dùng với gói [gói longtable](https://ctan.org/pkg/longtable).

### Ví dụ: tạo ghi chú bảng bằng gói threeparttable

Tính năng [tài liệu gói threeparttable](http://mirrors.ctan.org/macros/latex/contrib/threeparttable/threeparttable.pdf) rất ngắn gọn, vì vậy chúng ta sẽ không lặp lại ở đây mà thay vào đó sẽ đưa ra một ví dụ về cách dùng:

```latex
\begin{table}
  \begin{threeparttable}[b]
   \caption[\TeX{} các tính năng của bộ máy]{So sánh tính năng của bộ máy \TeX{}\tnote{1}}
   \centering
   \begin{tabular}{lcc}
     \midrule
     \TeX{} engine & Native UTF-8 support & Unicode math support\\
     \midrule
       \hologo{pdfTeX} & Không\tnote{2}& Không\\
       \Hologo{XeTeX} & Có & Có\\
       \Hologo{LuaTeX} & Có & Có\\
       \midrule
     \end{tabular}
     \begin{tablenotes}
       \item [1] Đây là một bản nháp sớm.
       \item [2] Một phần hỗ trợ UTF-8 thông qua các lệnh hạt nhân của \LaTeX{}.
     \end{tablenotes}
  \end{threeparttable}
\end{table}
```

[Mở `threeparttable` ví dụ này trong Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=threeparttable+package+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%25+Using+the+geometry+package+with+a+small%0A%25+page+size+to+create+the+article+graphic%0A%5Cusepackage%5Bpaperheight%3D6in%2C%0A+++paperwidth%3D5in%2C%0A+++top%3D10mm%2C%0A+++bottom%3D20mm%2C%0A+++left%3D10mm%2C%0A+++right%3D10mm%5D%7Bgeometry%7D%0A%5Cusepackage%7Bhologo%7D+%25+for+TeX+engine+logos%0A%5Cusepackage%7Bbooktabs%7D+%25+for+nice+tables%0A%5Cusepackage%7Bthreeparttable%7D+%25+to+use+table+notes%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Btable%7D%0A++%5Cbegin%7Bthreeparttable%7D%5Bb%5D%0A+++%5Ccaption%5B%5CTeX%7B%7D+engine+features%5D%7B%5CTeX%7B%7D+engine+feature+comparison%5Ctnote%7B1%7D%7D%0A+++%5Ccentering%0A+++%5Cbegin%7Btabular%7D%7Blcc%7D%0A+++++%5Cmidrule+%0A+++++%5CTeX%7B%7D+engine+%26+Native+UTF-8+support+%26+Unicode+math+support%5C%5C%0A+++++%5Cmidrule%0A+++++++%5Chologo%7BpdfTeX%7D+%26+No%5Ctnote%7B2%7D%26+No%5C%5C%0A+++++++%5CHologo%7BXeTeX%7D+%26+Yes+%26+Yes%5C%5C%0A+++++++%5CHologo%7BLuaTeX%7D+%26+Yes+%26+Yes%5C%5C%0A+++++++%5Cmidrule+%0A+++++%5Cend%7Btabular%7D%0A+++++%5Cbegin%7Btablenotes%7D%0A+++++++%5Citem+%5B1%5D+This+is+an+early+draft.%0A+++++++%5Citem+%5B2%5D+Some+UTF-8+support+via+%5CLaTeX%7B%7D+kernel+commands.%0A+++++%5Cend%7Btablenotes%7D%0A++%5Cend%7Bthreeparttable%7D%0A%5Cend%7Btable%7D%0A%5Cend%7Bdocument%7D)

Ví dụ này tạo ra kết quả sau

![Ví dụ Overleaf về ghi chú bảng trong LaTeX](/files/6cf0aa4b5e15f332a2a8552db1cc09c65fa48b1c)

### Các thảo luận trên tex.stackexchange

Chú thích cuối trang trong bảng cũng được thảo luận trên tex.stackexchange và nhiều giải pháp khác nhau được nêu trong các chủ đề, chẳng hạn như chủ đề sau đây mà độc giả có thể muốn tìm hiểu:

* [chú thích cuối trang cho bảng trong LaTeX](https://stackoverflow.com/questions/2888817/footnotes-for-tables-in-latex), và
* [chú thích cuối trang trong bảng](https://tex.stackexchange.com/questions/35615/footnote-in-table/35669).

## Đọc thêm

Để biết thêm thông tin, xem:

* [Ghi chú lề](/latex/vi/dinh-dang/15-margin-notes.md)
* [Kích cỡ trang và lề](/latex/vi/dinh-dang/07-page-size-and-margins.md)
* [Đầu trang và chân trang](/latex/vi/dinh-dang/02-headers-and-footers.md)
* [Siêu liên kết](/latex/vi/cau-truc-tai-lieu/09-hyperlinks.md)
* [Bộ đếm](/latex/vi/dinh-dang/10-counters.md)
* [Danh sách](/latex/vi/kien-thuc-co-ban-ve-latex/04-lists.md)
* [Kích thước phông chữ, họ phông và kiểu chữ](/latex/vi/phong-chu/01-font-sizes-families-and-styles.md)
* [In đậm, in nghiêng và gạch chân](/latex/vi/kien-thuc-co-ban-ve-latex/03-bold-italics-and-underlining.md)
* [Kiểu chữ](/latex/vi/phong-chu/02-font-typefaces.md)
* [Ngắt dòng và khoảng trắng](/latex/vi/dinh-dang/05-line-breaks-and-blank-spaces.md)
* [Quản lý trong một dự án lớn](/latex/vi/cau-truc-tai-lieu/07-management-in-a-large-project.md)
* [Các dự án LaTeX nhiều tệp](/latex/vi/cau-truc-tai-lieu/08-multi-file-latex-projects.md)
* [Phần giới thiệu về LaTeX2ε không quá ngắn](http://www.ctan.org/tex-archive/info/lshort/)


---

# 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/vi/dinh-dang/14-footnotes.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.