> 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/jian-bao/02-powerdot.md).
# Powerdot
**Powerdot** 是 LaTeX 的一個強大的簡報類別。它提供多項功能，讓簡報者能在短時間內更輕鬆地製作出專業外觀的投影片。本文說明如何使用 `powerdot`.
## 簡介
在 **powerdot**，若要建立新投影片，對應的文字與圖片必須包在特殊環境中。請參見下列範例。
```latex
\documentclass[paper=smartboard]{powerdot}
\title{Powerdot Presentation}
\author{Overleaf}
\date{\today}
\begin{document}
\maketitle
\begin{slide}{Slide Title}
\begin{itemize}
\item This is an item
\item 第二項
\item Third item
\end{itemize}
\end{slide}
\end{document}
```
[開啟這個基本的 `powerdot` 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)
開啟上述範例將建立一個專案，產生這兩張投影片：
在一個 `powerdot` 文件中的第一個指令必須載入 `powerdot` 類別；例如：
```latex
\documentclass[paper=smartboard]{powerdot}
```
其中 `[paper=smartboard]` 設定簡報投影片的尺寸。請參見 [`powerdot` 說明文件](http://mirrors.ctan.org/macros/latex/contrib/powerdot/doc/powerdot.pdf) 以獲得更多 `paper` 選項值。之後，通常的資料（作者、標題與日期）可以放在前言中。在文件內，指令 `\maketitle` 以及 `\section` 會建立一張新投影片以顯示相應資訊。
在標籤 `\begin{slide}` 以及 `\end{slide}` 之間必須輸入新投影片的內容。投影片的標題可以在開啟指令後方的大括號中，作為可選參數設定。在此範例中，標題是「Slide Title」。
**注意**：要編譯一個 `powerdot` 文件（例如在 Overleaf 上）時，你需要使用 `latex` 編譯器，而不是 `pdflatex` 或 `xelatex`.
## 基本用法
可以在類別宣告指令中加入一些額外參數。
```latex
\documentclass[
mode=print,
paper=smartboard,
orient=landscape
]{powerdot}
% 簡報中繼資料
\title{Powerdot Presentation}
\author{Overleaf}
\date{\today}
\begin{document}
\maketitle
% section：標題佔滿整張投影片
\section{First section}
\begin{slide}{Slide Title}
\begin{itemize}
\item This is an item
\item 第二項
\item Third item
\end{itemize}
\end{slide}
\begin{slide}{Slide N 2}
這是第 2 張投影片的內容。
數學 $x=2\pi r$。
\end{slide}
\end{document}
```
[在此開啟 `powerdot` 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)
在此範例中，幾個選項是在指令的方括號內設定的 `\documentclass[...]{powerdot}`:
**mode=print**
此模式可用來列印投影片，它會刪除疊加與轉場效果。另有其他模式，其中 present 是簡報的預設模式；而 handout 會產生投影片的黑白總覽，每頁列印兩張投影片。
**paper=smartboard**
這是在智慧黑板或寬螢幕簡報中要使用的紙張大小。其他紙張大小包括 screen（4/3 比例）、a4paper 和 letterpaper。
**orient=landscape**
文件方向。可用值為 landscape 和 portrait
**注意**：如果你想探索更完整的範例，請在 Overleaf 中開啟以下專案：
[開啟較大的 `powerdot` 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)
## 新增註解
在 `powerdot` 可以為投影片新增註解，作為簡報者的輔助。
```latex
\documentclass[
display=notes,
mode=print,
paper=smartboard,
orient=landscape
]{powerdot}
% 簡報中繼資料
\title{Powerdot Presentation}
\author{Overleaf}
\date{\today}
\begin{document}
\maketitle
% section：標題佔滿整張投影片
\section{First section}
\begin{slide}{Slide Title}
\begin{itemize}
\item This is an item
\item 第二項
\item Third item
\end{itemize}
\end{slide}
\begin{note}{About items}
說明項目清單可以自訂。
\end{note}
\end{document}
```
[在此開啟 `powerdot` 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)
若要建立註解，必須使用 `注意` 環境，而且要緊接在對應的投影片下方使用。語法與 `slide` 環境相同，你也可以為註解設定標題。
若只要渲染註解，請將選項 `display=notes` 傳給文件類別指令。此參數的其他值有： `slidesnotes` 會同時列印註解與投影片，還有 `投影片` 只會列印投影片。
**注意**：如果你想探索更完整的範例，請在 Overleaf 中開啟以下專案：
[開啟較大的 `powerdot` 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)
## 樣式與調色盤
powerdot 簡報的外觀可以透過樣式與調色盤來改變。樣式會改變簡報的整體外觀，而調色盤則決定樣式中使用的色彩組合。
```latex
\documentclass[
style=sailor,
paper=smartboard
]{powerdot}
\pdsetup{palette=Chocolate}
...
```
可以將一些額外選項傳給 `\documentclass` 前一個範例中，會改變投影片外觀的：
**style=sailor**
設定 sailor 樣式。
其他選項，例如 `palette` 可以包含在 `\pdsetup{...}`.
**\pdsetup{palette=Chocolate}**
設定 chocolate 色彩調色盤。
請參閱 [參考指南](#reference-guide) 以查看可用樣式與調色盤清單。
[在 Overleaf 中開啟 powerdot 套件的範例](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)
## 轉場效果
可以為 powerdot 簡報加入轉場效果，使其在視覺上更具吸引力。
```latex
\documentclass[
style=sailor,
display=slides,
paper=smartboard,
orient=landscape,
]{powerdot}
\pdsetup{trans=Split}
...
```
在此範例中，一個名為 `Split` 的轉場效果是透過指令加入簡報中的
```latex
\pdsetup{trans=Split}
```
它會將新投影片切分成兩半，並以動畫方式讓各半部出現在螢幕上。這些效果取決於 PDF 檢視器，並在全螢幕模式下支援最常見的選項。
其他可能的轉場效果有
* `Blinds`
* `Box`
* `Wipe`
* `Dissolve`
* `Glitter`
* `Replace`
* `Fly`
* `Push`
* `Cover`
* `Uncover`
* `Fade`
[在 Overleaf 中開啟 powerdot 套件的範例](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)
## 疊加
可以使用特殊指令，只揭露投影片中的某些元素，而不是整個內容。達成這件事有兩種方法。
| | |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| `latex
\begin{slide}{Slide Title}
你可以在下方看到一個項目清單。 \pause \\
有一些指令可以讓它們依序出現
\begin{itemize}[type=1]
\item<2> 這是一個項目
\item<3> 第二個項目
\item<4> 第三個項目
\end{itemize}
\end{slide}
` |  |
與疊加相關的兩個指令是：
* `\pause` 會顯示該指令之後的文字，直到下一個疊加為止，
* `\begin{itemize}[type=1]` 額外參數可在 `itemize` 以及 `enumerate` 環境中啟用疊加。可以使用 `\pause` 指令，或如範例所示，為每個 `項目`。這個額外參數決定哪些疊加會顯示目前項目。例如，第一個項目只會出現在第二個疊加中。
在 `\item` 指令中，額外參數的其他可能語法如下：
* `\item<-2>`。這個項目會出現在除第二個以外的所有疊加中。
* `\item<2->`。這個項目會從第二個疊加起出現在所有疊加中。
* `\item<2-5>`。這個項目會從第二個疊加列印到第五個疊加。
[在 Overleaf 中開啟 powerdot 套件的範例](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)
## 投影片中的逐字文本
簡報中的某些內容需要 `powerdot` 特殊指令。例如，要將逐字文本加入投影片，必須在 `slide` 環境來繪製圖形。
```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]{Slide 2}
步驟 1 和 2：
\begin{code}
compute a;
compute b;
\end{code}
\end{slide}
\end{document}
```
[在此開啟 `powerdot` 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)
方括號內的參數， `method=direct` 是將逐字文本加入投影片所必須的，但不允許疊加。另一個選項是使用 `method=file` 它允許逐字文本與疊加，但如果有很多投影片使用此方法，可能會很慢。
[在 Overleaf 中開啟 powerdot 套件的範例](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)
## 參考指南
以下列出所有官方 **powerdot** 樣式，以及對應樣式可用的所有調色盤。
| | 主頁 | 內頁 | 調色盤 |
| --------- | ----------------------------------------------------------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| simple |  |  | |
| tycja |  |  | |
| ikeda |  |  | |
| fyma |  |  | 藍、綠、灰、棕、橘 |
| ciment |  |  | |
| elcolors |  |  | |
| aggie |  |  | |
| husky |  |  | |
| sailor |  |  | River, Wine, Chocolate, Cocktail |
| upen |  |  | |
| bframe |  |  | |
| horatio |  |  | |
| paintings |  |  | Syndics, Skater, GoldenGate, Moitessier, PearlEarring, Lamentation, HolyWood, Europa, MayThird, Charon |
| klope |  |  | Spring, PastelFlower, BlueWater, BlackWhite |
| jefka |  |  | 棕色、海綠色、藍色、白色 |
| pazik |  |  | 紅色、棕色 |
## 延伸閱讀
如需更多資訊，請參見
* [Beamer](/latex/zh-tw/jian-bao/01-beamer.md)
* [海報](/latex/zh-tw/jian-bao/03-posters.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)
* [文字對齊](/latex/zh-tw/ge-shi-hua/06-text-alignment.md)
* [字型字體](/latex/zh-tw/zi-xing/02-font-typefaces.md)
* [插入圖片](/latex/zh-tw/geng-duo-zhu-ti/27-inserting-images.md)
* [在 LaTeX 中使用顏色](/latex/zh-tw/ge-shi-hua/13-using-colors-in-latex.md)
* [LaTeX 中的長度](/latex/zh-tw/ge-shi-hua/01-lengths-in-latex.md)
* [國際語言支援](/latex/zh-tw/yu-yan/03-international-language-support.md)
* [該 **powerdot** 說明文件](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/zh-tw/jian-bao/02-powerdot.md?ask=&goal=
```
`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.