> 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/ar/alarwdh-altqdymyh/02-powerdot.md).
# Powerdot
**Powerdot** فئة عروض تقديمية قوية لـLaTeX. وهي توفّر عدة ميزات تجعل من الأسهل على مقدم العرض إنشاء شرائح ذات مظهر احترافي في وقت قصير. تشرح هذه المقالة كيفية استخدام `powerdot`.
## مقدمة
في **powerdot**، لإنشاء شريحة جديدة يجب أن يُحاط النص والصور المقابلان داخل بيئة خاصة. انظر المثال أدناه.
```latex
\documentclass[paper=smartboard]{powerdot}
\title{عرض Powerdot التقديمي}
\author{Overleaf}
\date{\today}
\begin{document}
\maketitle
\begin{slide}{عنوان الشريحة}
\begin{itemize}
\item هذا عنصر
\item العنصر الثاني
\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}` يجب كتابة محتويات شريحة جديدة. يمكن تعيين عنوان للشريحة كمعامل اختياري داخل الأقواس المعقوفة مباشرة بعد الأمر الافتتاحي. في المثال، العنوان هو «عنوان الشريحة».
**ملاحظة**: لترجمة `powerdot` مستند (مثلًا على Overleaf) تحتاج إلى استخدام `latex` المترجم بدلاً من `pdflatex` أو `xelatex`.
## الاستخدام الأساسي
يمكن إضافة بعض المعلمات الإضافية إلى أمر تعريف الفئة.
```latex
\documentclass[
mode=print,
paper=smartboard,
orient=landscape
]{powerdot}
% بيانات العرض التقديمي
\title{عرض Powerdot التقديمي}
\author{Overleaf}
\date{\today}
\begin{document}
\maketitle
% القسم: العنوان يشغل الشريحة كاملة
\section{القسم الأول}
\begin{slide}{عنوان الشريحة}
\begin{itemize}
\item هذا عنصر
\item العنصر الثاني
\item العنصر الثالث
\end{itemize}
\end{slide}
\begin{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**
يمكن استخدام هذا الوضع لطباعة الشرائح، إذ يحذف التراكبات وتأثيرات الانتقال. توجد أوضاع أخرى، وهي الوضع الافتراضي للعروض التقديمية؛ و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 التقديمي}
\author{Overleaf}
\date{\today}
\begin{document}
\maketitle
% القسم: العنوان يشغل الشريحة كاملة
\section{القسم الأول}
\begin{slide}{عنوان الشريحة}
\begin{itemize}
\item هذا عنصر
\item العنصر الثاني
\item العنصر الثالث
\end{itemize}
\end{slide}
\begin{note}{حول العناصر}
اذكر أن قوائم العناصر يمكن تخصيصها.
\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)
لإنشاء ملاحظة، يجب استخدام البيئة `note` مباشرة أسفل الشريحة المقابلة. البنية هي نفسها كما في `الشريحة` البيئة، ويمكنك أيضًا تعيين عنوان للملاحظة.
لعرض الملاحظات فقط، يُمرَّر الخيار `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}**
اضبط لوحة ألوان الشوكولاتة.
انظر [دليل المراجع](#reference-guide) للحصول على قائمة بالأنماط ولوحات الألوان المتاحة.
[افتح مثالًا على حزمة 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,
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`
[افتح مثالًا على حزمة 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)
## التراكبات
يمكن استخدام أوامر خاصة لإظهار بعض عناصر الشريحة فقط بدلاً من المحتوى بالكامل. توجد طريقتان لتحقيق ذلك.
| | |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| `latex
\begin{slide}{عنوان الشريحة}
يمكنك رؤية قائمة بالعناصر أدناه. \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>`. يُطبع هذا العنصر من التراكب الثاني إلى التراكب الخامس.
[افتح مثالًا على حزمة 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,
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]{الشريحة 2}
الخطوتان 1 و2:
\begin{code}
احسب a;
احسب 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` الذي يسمح بالنص الحرفي والتراكبات، لكنه قد يكون بطيئًا إذا استخدمت العديد من الشرائح هذه الطريقة.
[افتح مثالًا على حزمة 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** الأنماط الرسمية وجميع لوحات الألوان المتاحة للأنماط المقابلة مدرجة.
| | الصفحة الرئيسية | الصفحة الداخلية | لوحات الألوان |
| --------- | ----------------------------------------------------------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| بسيط |  |  | |
| 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/ar/alarwdh-altqdymyh/01-beamer.md)
* [الملصقات](/latex/ar/alarwdh-altqdymyh/03-posters.md)
* [الخط العريض والمائل والتحته خط](/latex/ar/asasyat-latex/03-bold-italics-and-underlining.md)
* [أحجام الخطوط، والعائلات، والأنماط](/latex/ar/alkhtwt/01-font-sizes-families-and-styles.md)
* [محاذاة النص](/latex/ar/altnsyq/06-text-alignment.md)
* [وجوه الخطوط](/latex/ar/alkhtwt/02-font-typefaces.md)
* [إدراج الصور](/latex/ar/mzyd-mn-almwdhwaat/27-inserting-images.md)
* [استخدام الألوان في LaTeX](/latex/ar/altnsyq/13-using-colors-in-latex.md)
* [الأطوال في LaTeX](/latex/ar/altnsyq/01-lengths-in-latex.md)
* [دعم اللغات الدولية](/latex/ar/allghat/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/ar/alarwdh-altqdymyh/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.