> 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/bai-thuyet-trinh/02-powerdot.md).

# Powerdot

**Powerdot** là một lớp trình bày mạnh mẽ cho LaTeX. Nó cung cấp một số tính năng giúp người trình bày dễ dàng tạo các trang chiếu trông chuyên nghiệp trong thời gian ngắn. Bài viết này giải thích cách sử dụng `powerdot`.

## Giới thiệu

Trong **powerdot**, để tạo một trang chiếu mới, văn bản và hình ảnh tương ứng phải được đặt trong một môi trường đặc biệt. Xem ví dụ dưới đây.

```latex
\documentclass[paper=smartboard]{powerdot}
\title{Bài thuyết trình Powerdot}
\author{Overleaf}
\date{\today}

\begin{document}

\maketitle

\begin{slide}{Tiêu đề trang chiếu}
  \begin{itemize}
  \item Đây là một mục
  \item Mục thứ hai
  \item Mục thứ ba
  \end{itemize}
\end{slide}
\end{document}
```

&#x20;[Mở phần cơ bản này `powerdot` ví dụ này trong Overleaf](https://www.overleaf.com/docs?engine=latex_dvipdf\&snip_name=Minimal+Powerdot+example\&snip=%5Cdocumentclass%5Bpaper%3Dsmartboard%5D%7Bpowerdot%7D%0A%5Ctitle%7BPowerdot+Presentation%7D%0A%5Cauthor%7BOverleaf%7D%0A%5Cdate%7B%5Ctoday%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cmaketitle%0A%0A%5Cbegin%7Bslide%7D%7BSlide+Title%7D%0A++%5Cbegin%7Bitemize%7D%0A++%5Citem+This+is+an+item%0A++%5Citem+Second+item%0A++%5Citem+Third+item%0A++%5Cend%7Bitemize%7D%0A%5Cend%7Bslide%7D%0A%5Cend%7Bdocument%7D)

Mở ví dụ ở trên sẽ tạo một dự án sinh ra hai trang chiếu này:

![OLPowerdot1f.png](/files/8696444bcde87055f8bf332e694c78a8cdc321a0)

![OLPowerdot2f.png](/files/93cd74adbd945cc221863c9263d08e5c9c108c84)

Lệnh đầu tiên trong một `powerdot` tài liệu phải là nạp `powerdot` lớp; ví dụ:

```latex
\documentclass[paper=smartboard]{powerdot}
```

trong đó `[paper=smartboard]` đặt kích thước của các trang chiếu trình bày. Xem các [`powerdot` tài liệu](http://mirrors.ctan.org/macros/latex/contrib/powerdot/doc/powerdot.pdf) để có thêm `paper` giá trị tùy chọn. Sau đó, dữ liệu thông thường (tác giả, tiêu đề và ngày) có thể được đưa vào phần mở đầu. Trong tài liệu, các lệnh `\maketitle` và `\section` sẽ tạo một trang chiếu mới để hiển thị thông tin tương ứng.

Ở giữa các thẻ `\begin{slide}` và `\end{slide}` nội dung của một trang chiếu mới phải được gõ vào. Có thể đặt tiêu đề cho trang chiếu như một tham số tùy chọn trong dấu ngoặc nhọn ngay sau lệnh mở. Trong ví dụ, tiêu đề là "Tiêu đề trang chiếu".

**Lưu ý**: Để biên dịch một `powerdot` tài liệu (ví dụ: trên Overleaf) bạn cần dùng `latex` trình biên dịch `pdflatex` hoặc `xelatex`.

## Cách dùng cơ bản

Có thể thêm một số tham số bổ sung vào lệnh khai báo lớp.

```latex
\documentclass[
    mode=print,
    paper=smartboard,
    orient=landscape
]{powerdot}

% Siêu dữ liệu của bài thuyết trình
\title{Bài thuyết trình Powerdot}
\author{Overleaf}
\date{\today}

\begin{document}
\maketitle

% phần: tiêu đề chiếm toàn bộ trang chiếu
\section{Mục đầu tiên}

\begin{slide}{Tiêu đề trang chiếu}
    \begin{itemize}
    \item Đây là một mục
    \item Mục thứ hai
    \item Mục thứ ba
    \end{itemize}
\end{slide}

\begin{slide}{Trang chiếu số 2}
    Đây là nội dung của trang chiếu 2.
    Toán $x=2\pi r$.
\end{slide}
\end{document}
```

&#x20;[Mở `powerdot` tài liệu trong Overleaf](https://www.overleaf.com/docs?engine=latex_dvipdf\&snip_name=Powerdot+document+example\&snip=%5Cdocumentclass%5B%0A++++mode%3Dprint%2C%0A++++paper%3Dsmartboard%2C%0A++++orient%3Dlandscape%0A%5D%7Bpowerdot%7D%0A%0A%25+Presentation+metadata%0A%5Ctitle%7BPowerdot+Presentation%7D%0A%5Cauthor%7BOverleaf%7D%0A%5Cdate%7B%5Ctoday%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0A+++++%0A%25+section%3A+title+takes+up+full+slide%0A%5Csection%7BFirst+section%7D%0A+++++++++++%0A%5Cbegin%7Bslide%7D%7BSlide+Title%7D%0A++++%5Cbegin%7Bitemize%7D%0A++++%5Citem+This+is+an+item%0A++++%5Citem+Second+item%0A++++%5Citem+Third+item%0A++++%5Cend%7Bitemize%7D%0A%5Cend%7Bslide%7D%0A+++++++++++++++++++++++++++++++++++++++++%0A%5Cbegin%7Bslide%7D%7BSlide+N+2%7D%0A++++This+is+the+content+of+slide+2.%0A++++Math+%24x%3D2%5Cpi+r%24.%0A%5Cend%7Bslide%7D%0A%5Cend%7Bdocument%7D)

Trong ví dụ này, một số tùy chọn được đặt trong dấu ngoặc vuông trong lệnh `\documentclass[...]{powerdot}`:

**mode=print**

Chế độ này có thể dùng để in các trang chiếu, nó xóa các lớp phủ và hiệu ứng chuyển tiếp. Còn có các chế độ khác: chế độ mặc định cho bài trình bày; và handout tạo ra bản tổng quan đen trắng của các trang chiếu, in hai trang chiếu mỗi trang.

**paper=smartboard**

Đây là kích thước giấy dùng cho một bài trình bày trên bảng thông minh hoặc màn hình rộng. Các kích thước giấy khác là screen (tỉ lệ 4/3), a4paper và letterpaper.

**orient=landscape**

Hướng của tài liệu. Các giá trị có thể là landscape và portrait

**Lưu ý**: Nếu muốn khám phá một ví dụ đầy đủ hơn, hãy mở dự án sau trong Overleaf:

&#x20;[Mở một phần lớn hơn `powerdot` ví dụ này trong Overleaf](https://www.overleaf.com/project/new/template/19031?id=63931899\&templateName=Powerdot+Presentation+Example\&latexEngine=latex_dvipdf\&texImage=texlive-full%3A2020.1\&mainFile=main.tex)

## Thêm ghi chú

Trong `powerdot` có thể thêm ghi chú vào các trang chiếu để hỗ trợ người thuyết trình.

```latex
\documentclass[
    display=notes,
    mode=print,
    paper=smartboard,
    orient=landscape
]{powerdot}

% Siêu dữ liệu của bài thuyết trình
\title{Bài thuyết trình Powerdot}
\author{Overleaf}
\date{\today}

\begin{document}
\maketitle

% phần: tiêu đề chiếm toàn bộ trang chiếu
\section{Mục đầu tiên}

\begin{slide}{Tiêu đề trang chiếu}
    \begin{itemize}
    \item Đây là một mục
    \item Mục thứ hai
    \item Mục thứ ba
    \end{itemize}
\end{slide}
\begin{note}{Về các mục}
    Lưu ý rằng các danh sách mục có thể được tùy chỉnh.
\end{note}
\end{document}
```

&#x20;[Mở `powerdot` ví dụ này trong Overleaf](https://www.overleaf.com/docs?engine=latex_dvipdf\&snip_name=Powerdot+example+with+notes\&snip=%5Cdocumentclass%5B%0A++++display%3Dnotes%2C%0A++++mode%3Dprint%2C%0A++++paper%3Dsmartboard%2C%0A++++orient%3Dlandscape%0A%5D%7Bpowerdot%7D%0A%0A%25+Presentation+metadata%0A%5Ctitle%7BPowerdot+Presentation%7D%0A%5Cauthor%7BOverleaf%7D%0A%5Cdate%7B%5Ctoday%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0A+++++%0A%25+section%3A+title+takes+up+full+slide%0A%5Csection%7BFirst+section%7D%0A+++++++++++%0A%5Cbegin%7Bslide%7D%7BSlide+Title%7D%0A++++%5Cbegin%7Bitemize%7D%0A++++%5Citem+This+is+an+item%0A++++%5Citem+Second+item%0A++++%5Citem+Third+item%0A++++%5Cend%7Bitemize%7D%0A%5Cend%7Bslide%7D%0A%5Cbegin%7Bnote%7D%7BAbout+items%7D%0A++++Mention+that+lists+of+items+can+be+customised.%0A%5Cend%7Bnote%7D%0A%5Cend%7Bdocument%7D)

Để tạo một ghi chú, môi trường `note` phải được dùng ngay bên dưới trang chiếu tương ứng. Cú pháp giống như trong `trang chiếu` môi trường, bạn cũng có thể đặt tiêu đề cho ghi chú.

Để chỉ hiển thị các ghi chú, tùy chọn `display=notes` được truyền cho lệnh khai báo lớp tài liệu. Các giá trị khác cho tham số này là: `slidesnotes` in cả ghi chú và trang chiếu, và `các slide` chỉ in các trang chiếu.

**Lưu ý**: Nếu muốn khám phá một ví dụ đầy đủ hơn, hãy mở dự án sau trong Overleaf:

&#x20;[Mở một phần lớn hơn `powerdot` ví dụ này trong Overleaf](https://www.overleaf.com/project/new/template/19031?id=63931899\&templateName=Powerdot+Presentation+Example\&latexEngine=latex_dvipdf\&texImage=texlive-full%3A2020.1\&mainFile=main.tex)

## Kiểu dáng và bảng màu

Sự xuất hiện của một bài trình bày powerdot có thể được thay đổi bằng các kiểu dáng và bảng màu. Kiểu dáng thay đổi diện mạo tổng thể của bài trình bày, còn bảng màu xác định tập màu được dùng trong một kiểu dáng.

```latex
\documentclass[
    style=sailor,
    paper=smartboard
]{powerdot}

\pdsetup{palette=Chocolate}

...
```

![PowerdotEx4Chocolate.PNG](/files/70a81d685a2ae2acfe7443840b930f18125e049d)

Có thể truyền thêm một số tùy chọn `\documentclass` trong ví dụ trước để thay đổi diện mạo của các trang chiếu:

**style=sailor**

Đặt kiểu sailor.

Các tùy chọn khác như `palette` có thể được đưa vào `\pdsetup{...}`.

**\pdsetup{palette=Chocolate}**

Đặt bảng màu chocolate.

Xem [hướng dẫn tham khảo](#reference-guide) để xem danh sách các kiểu dáng và bảng màu hiện có.

&#x20;[Mở một ví dụ của gói powerdot trong Overleaf](https://www.overleaf.com/project/new/template/19031?id=63931899\&templateName=Powerdot+Presentation+Example\&latexEngine=latex_dvipdf\&texImage=texlive-full%3A2020.1\&mainFile=main.tex)

## Hiệu ứng chuyển tiếp

Có thể thêm hiệu ứng chuyển tiếp vào bài trình bày powerdot để làm cho nó hấp dẫn hơn về mặt thị giác.

```latex
\documentclass[
    style=sailor,
    display=slides,
    paper=smartboard,
    orient=landscape,
]{powerdot}

\pdsetup{trans=Split}
...
```

![PowerdotEx5.png](/files/fac66a391034ea4d66207a8535e55f5b5e454a47)

Trong ví dụ này, một hiệu ứng chuyển tiếp có tên `Split` được thêm vào bài trình bày bằng lệnh

```latex
\pdsetup{trans=Split}
```

Nó hiển thị trang chiếu mới bằng cách tách nó ra và tạo ảnh động cho từng nửa xuất hiện trên màn hình. Các hiệu ứng này phụ thuộc vào trình xem PDF và được hỗ trợ bởi các tùy chọn phổ biến nhất, ở chế độ toàn màn hình.

Các hiệu ứng chuyển tiếp khác có thể là

* `Blinds`
* `Box`
* `Wipe`
* `Dissolve`
* `Glitter`
* `Replace`
* `Fly`
* `Push`
* `Cover`
* `Uncover`
* `Fade`

&#x20;[Mở một ví dụ của gói powerdot trong Overleaf](https://www.overleaf.com/project/new/template/19031?id=63931899\&templateName=Powerdot+Presentation+Example\&latexEngine=latex_dvipdf\&texImage=texlive-full%3A2020.1\&mainFile=main.tex)

## Lớp phủ

Có thể dùng các lệnh đặc biệt để chỉ tiết lộ một số phần tử của trang chiếu thay vì toàn bộ nội dung. Có hai cách để thực hiện điều này.

|                                                                                                                                                                                                                                                                                                    |                                                                     |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| `latex<br>\begin{slide}{Tiêu đề trang chiếu}<br>Bạn có thể thấy danh sách các mục bên dưới. \pause \\<br>Có các lệnh để làm chúng xuất hiện tuần tự<br> \begin{itemize}[type=1]<br> \item<2> Đây là một mục<br> \item<3> Mục thứ hai<br> \item<4> Mục thứ ba<br> \end{itemize}<br>\end{slide}<br>` | ![PowerdotEx6.gif](/files/7294a48ff760f2415926974fac6b2b791027868c) |

Hai lệnh liên quan đến lớp phủ là:

* `\pause` lệnh này sẽ hiển thị văn bản sau lệnh cho đến lớp phủ tiếp theo,
* `\begin{itemize}[type=1]` tham số bổ sung cho phép dùng lớp phủ trong `itemize` và `enumerate` môi trường. Cũng có thể dùng `\pause` lệnh ở đây hoặc, như trong ví dụ, truyền một tham số bổ sung cho từng `mục`. Tham số bổ sung này xác định lớp phủ nào sẽ hiển thị mục hiện tại. Ví dụ, mục đầu tiên chỉ xuất hiện ở lớp phủ thứ hai.

Ví dụ về các cú pháp khác có thể có cho các tham số bổ sung trong lệnh `\item` là:

* `\item<-2>`. Mục này sẽ xuất hiện ở tất cả các lớp phủ trừ lớp thứ hai.
* `\item<2->`. Mục này sẽ xuất hiện ở tất cả các lớp phủ từ lớp thứ hai trở đi.
* `\item<2-5>`. Mục này được in từ lớp phủ thứ hai đến lớp phủ thứ năm.

&#x20;[Mở một ví dụ của gói powerdot trong Overleaf](https://www.overleaf.com/project/new/template/19031?id=63931899\&templateName=Powerdot+Presentation+Example\&latexEngine=latex_dvipdf\&texImage=texlive-full%3A2020.1\&mainFile=main.tex)

## Văn bản nguyên dạng trên trang chiếu

Một số nội dung trong một `powerdot` bài trình bày cần các lệnh đặc biệt. Ví dụ, để thêm văn bản nguyên dạng vào một trang chiếu, một tham số bổ sung phải được thêm vào `trang chiếu` môi trường.

```latex
\documentclass[
    style=sailor,
    display=slides,
    paper=smartboard,
    orient=landscape,
]{powerdot}

\usepackage{listings}
\lstnewenvironment{code}{%
\lstset{frame=single,escapeinside=`',
  backgroundcolor=\color{yellow!20},
  basicstyle=\footnotesize \ttfamily}
}{}

\begin{document}
\begin{slide}[method=direct]{Trang chiếu 2}
 Các bước 1 và 2:
 \begin{code}
    tính a;

    tính b;
 \end{code}
\end{slide}
\end{document}
```

&#x20;[Mở `powerdot` tài liệu trong Overleaf](https://www.overleaf.com/docs?engine=latex_dvipdf\&snip_name=Verbatim+code+in+Powerdot\&snip=%5Cdocumentclass%5B%0A++++style%3Dsailor%2C%0A++++display%3Dslides%2C%0A++++paper%3Dsmartboard%2C%0A++++orient%3Dlandscape%2C%0A%5D%7Bpowerdot%7D%0A%0A%5Cusepackage%7Blistings%7D%0A%5Clstnewenvironment%7Bcode%7D%7B%25%0A%5Clstset%7Bframe%3Dsingle%2Cescapeinside%3D%60%27%2C%0A++backgroundcolor%3D%5Ccolor%7Byellow%2120%7D%2C%0A++basicstyle%3D%5Cfootnotesize+%5Cttfamily%7D%0A%7D%7B%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bslide%7D%5Bmethod%3Ddirect%5D%7BSlide+2%7D%0A+Steps+1+and+2%3A%0A+%5Cbegin%7Bcode%7D%0A++++compute+a%3B%0A%0A++++compute+b%3B%0A+%5Cend%7Bcode%7D%0A%5Cend%7Bslide%7D%0A%5Cend%7Bdocument%7D)

![PowerdotEx7.png](/files/efdc922a97f440f193b6cda542aeaa708e376d83)

Tham số trong ngoặc vuông, `method=direct` là bắt buộc để thêm văn bản nguyên dạng vào một trang chiếu, nhưng không cho phép lớp phủ. Một tùy chọn khác là dùng `method=file` cho phép văn bản nguyên dạng và lớp phủ, nhưng có thể chậm nếu nhiều trang chiếu dùng phương pháp này.

&#x20;[Mở một ví dụ của gói powerdot trong Overleaf](https://www.overleaf.com/project/new/template/19031?id=63931899\&templateName=Powerdot+Presentation+Example\&latexEngine=latex_dvipdf\&texImage=texlive-full%3A2020.1\&mainFile=main.tex)

## Hướng dẫn tham khảo

Dưới đây liệt kê tất cả các **powerdot** kiểu dáng chính thức và tất cả các bảng màu có sẵn cho các kiểu dáng tương ứng.

|           | trang chính                                                       | trang bên trong                                                   | bảng màu                                                                                               |
| --------- | ----------------------------------------------------------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| simple    | ![Style1P1.png](/files/d2726d017e6a4b7d5adebed3482e04cd1629c3f9)  | ![Style1P2.png](/files/284330359dea809ea0baa30fdb2a48c53036039f)  |                                                                                                        |
| tycja     | ![Style2P1.png](/files/ece9a431010849805138158842e451ea57266bce)  | ![Style2P2.png](/files/101c3e099a67bda8289fe13befb4ae73331ca6b8)  |                                                                                                        |
| ikeda     | ![Style3P1.png](/files/65f1ed6f1b88437fee569dac5fa4a82a9f3dd242)  | ![Style3P2.png](/files/1440ad5c2874d90f02e73cbb1e3dfe17944ccf42)  |                                                                                                        |
| fyma      | ![Style4P1.png](/files/2462cf69cb1f05b88855559fca2aab7d5f06ab2b)  | ![Style4P2.png](/files/dd5bef4e688f888b51e45d96abba57af968c90a7)  | xanh dương, xanh lá, xám, nâu, cam                                                                     |
| ciment    | ![Style5P1.png](/files/419f54db8bf4cb0eaa1d8f97d77ad0bb81db9204)  | ![Style5P2.png](/files/2874279524175cf937a3ec10c68bd510e94b55e4)  |                                                                                                        |
| elcolors  | ![Style6P1.png](/files/63621d244acf45fef9e04b25f6bdfba1443cde2f)  | ![Style6P2.png](/files/61b9c11a25c8506bed49a1e90645ddfb6b86b5ae)  |                                                                                                        |
| aggie     | ![Style7P1.png](/files/cfa1f27b17cab43832c47f230b16d076408a1e8b)  | ![Style7P2.png](/files/13e39d87745844856f5d17e8390efe01312643c5)  |                                                                                                        |
| husky     | ![Style8P1.png](/files/a598200ad830311ff9bc9c4d22c246b87b95f080)  | ![Style8P2.png](/files/0448786f3167b086f9749efd3d4487ff946b8780)  |                                                                                                        |
| sailor    | ![Style9P1.png](/files/5cc7bd66111460734be092683bae5111677ddbb8)  | ![Style9P2.png](/files/cdd6e1e5aa2129825b39f2a40efce51578e41978)  | River, Wine, Chocolate, Cocktail                                                                       |
| upen      | ![Style10P1.png](/files/b87eb0736e8277b680abc99e904a7ab38ae666d7) | ![Style10P2.png](/files/c3b0fc80fbde4f80a5cb2d4770bde634d2893219) |                                                                                                        |
| bframe    | ![Style11P1.png](/files/ebb68f170a852ee6c1df2346a6c016c67f6de6a1) | ![Style11P2.png](/files/461d5787b85ab12f062f0b014145469240761916) |                                                                                                        |
| horatio   | ![Style12P1.png](/files/867f5ec093ee7859d4cd64773bca6467dd312569) | ![Style12P2.png](/files/5e8fdb69d575cf30ed793f91ee5e48ec2d321c59) |                                                                                                        |
| paintings | ![Style13P1.png](/files/20faf67c08906dc54266993f9d7f39fc090e3b24) | ![Style13P2.png](/files/ce0ca44a67cb26a525f634724e1f4be5003de82f) | Syndics, Skater, GoldenGate, Moitessier, PearlEarring, Lamentation, HolyWood, Europa, MayThird, Charon |
| klope     | ![Style14P1.png](/files/5346687fe349012ceeae88e1c9c778cb312a4673) | ![Style14P2.png](/files/fdcec6d2a383a65e91f605033031b8bc507ae638) | Spring, PastelFlower, BlueWater, BlackWhite                                                            |
| jefka     | ![Style15P1.png](/files/3f158779ccd72ede121359f56b0c5f0211b8c51d) | ![Style15P2.png](/files/05863a4986a967a11f859c0228d901cd69fb51cd) | nâu, xanh biển, xanh dương, trắng                                                                      |
| pazik     | ![Style16P1.png](/files/35f2db0f6d71cb1125e95e10399d2f254bc20710) | ![Style16P2.png](/files/1412efbfde56f11fb941c59486a325db7305faed) | đỏ, nâu                                                                                                |

## Đọc thêm

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

* [Beamer](/latex/vi/bai-thuyet-trinh/01-beamer.md)
* [Áp phích](/latex/vi/bai-thuyet-trinh/03-posters.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)
* [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)
* [Căn chỉnh văn bản](/latex/vi/dinh-dang/06-text-alignment.md)
* [Kiểu chữ](/latex/vi/phong-chu/02-font-typefaces.md)
* [Chèn hình ảnh](/latex/vi/chu-de-khac/27-inserting-images.md)
* [Sử dụng màu trong LaTeX](/latex/vi/dinh-dang/13-using-colors-in-latex.md)
* [Độ dài trong LaTeX](/latex/vi/dinh-dang/01-lengths-in-latex.md)
* [Hỗ trợ ngôn ngữ quốc tế](/latex/vi/ngon-ngu/03-international-language-support.md)
* [Tính năng **powerdot** tài liệu](ftp://bay.uchicago.edu/tex-archive/macros/latex/contrib/powerdot/doc/powerdot.pdf)


---

# 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/bai-thuyet-trinh/02-powerdot.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.
