summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/xelatex/xepersian/xepersian-userguide.tex
blob: 204b9df9c1a485469fba3a6e115354b8221df147 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
\documentclass{article}
\usepackage{makeidx}
\makeindex
\usepackage{pstricks}
\usepackage{pst-func}
\usepackage{pstricks-add}
\usepackage{xepersian}
\usepackage{persianpoem,fmultico}
\newfontinstance\farsifont[Script=Arabic,Scale=1,Mapping=parsidigits]{XB Zar}
\newfontinstance\nastaliq[Script=Arabic,Scale=1,Mapping=parsidigits]{IranNastaliq}
\setdigitfont[Scale=1, Mapping=parsidigits]{XB Zar}
\addtolength{\hoffset}{-2cm}
\addtolength{\textwidth}{3cm}
\newcommand{\textblue}[1]{{\addfontfeature{Color=0000FF}#1}}
\usepackage{setspace}
\usepackage{perpage}
\numberwithin{equation}{section}
\numberwithin{table}{section}
\onehalfspacing
\newcommand\femph[1]{\lr{''}#1\lr{``}}
\frenchspacing
\title{راهنمای بستهٔ \lr{\XePersian}}
\author{گروه فارسی-لاتک\footnote{مصطفی واحدی \texttt{mostafa.vahedi@gmail.com}، وفا خلیقی \texttt{vafa.khalighi@students.mq.edu.au}، و مهدی امیدعلی \texttt{mehdioa@gmail.com}}}
\begin{document}
\maketitle
\twocolumnstableofcontents
\pagenumbering{farsi}
\begin{abstract}
\lr{\XePersian}
یک بسته برای نگارش مستندات فارسی در 
\lr{\XeLaTeX}
است. 
هدف \lr{\XePersian} این است که یک استفاده کنندهٔ معمولی قادر باشد به راحتی به حروف‌چینی فارسی بپردازد. در
 حال حاضر \lr{\XePersian} با کلاسهای \lr{article, amsart, amsbook, report, book, bookest, refrep} و \lr{beamer} به زیبایی و آسانی کار می‌کند. 
 \end{abstract}
\section{موارد مورد نیاز}
برای استفاده از  \lr{\XePersian} باید  \lr{\XeTeX} روی سیستم شما نصب باشد. اگر از \lr{MikTex 2.7} یا بالاتر، و یا از \lr{TeXLive 2008} 
و یا بالاتر استفاده می‌کنید، \lr{\XeTeX} به طور خودکار روی سیستم شما نصب شده است. تنها کاری که باید در این صورت انجام دهید نصب و 
تنظیم یک ویرایشگر مناسب برای کار است. لیست کنترل زیر ابزارهای لازم را برای کار با این بسته به شما نشان می‌دهد.
\begin{enumerate}
\item توزیع مناسبی از تک مانند تکلایو یا میکتک.
\item نرم‌افزار مناسب ویرایش متنهای یونیکد (در ویندوز \lr{notepad++}\footnote{قابل دریافت از \LR{\texttt{http://notepad-plus.sourceforge.net/}}} و در لینوکس \lr{gedit}).
\item نرم‌افزار مناسب نمایش فایلهای پی.دی.اف (در ویندوز توصیه می‌شود از \lr{foxit reader}\footnote{قابل دریافت از \lr{\texttt{http://www.foxitsoftware.com/}}} به جای آکروبات ریدر استفاده شود).
\end{enumerate}
از آنجا که کاربران ایرانی معمولا از ویندوز استفاده می‌کنند و با توجه به اینکه یک ویرایشگر مناسب زندگی را برای کاربر بسیار راحت می‌کند، در ادامه 
روش نصب و تنظیم ویرایشگر مناسب را در ویندوز به طور کامل شرح می‌دهیم. توجه داشته باشید که فرض بر این است یک توزیع مناسب از تک (مانند تکلایو یا میکتک)
 و همچنین فاکسیت ریدر روی سیستم شما نصب است. 

فایل نصب‌کنندهٔ \lr{notepad++} را اجرا کنید ( توجه داشته باشید که جدیدترین نسخه این فایل را از صفحهٔ خانگی این نرم‌افزار دریافت کرده باشید).
سپس به صورتی که در شکلهای زیر نشان داده شده است نرم‌افزار را نصب و تنظیم کنید.

\centerline{\XeTeXpicfile "notepad1.PNG" height 7cm}
\centerline{\XeTeXpicfile "notepad2.PNG" height 5cm}
\centerline{\XeTeXpicfile "notepad3.PNG" height 5cm}

بعد از آخرین شکل، گزینهٔ \lr{save} را فشار دهید و فرمان را با نام \lr{xelatex} ذخیره کنید. از این به بعد با فشردن کلید \lr{F6} می‌توانید به راحتی 
فایل خود را پردازش کنید. بعد از یک بار پردازش، می‌توانید به راحتی با فشردن \lr{CTRL+F6} فایل خود را مستقیماً پردازش کنید.

برای استفادهٔ بهینه از این ویرایشگر، بهتر است راهنمای آنرا مطالعه کنید. فقط به عنوان یک مطلب که ممکن است برای شما مفید باشد، هنگام ویرایش متنهای فارسی،
با فشردن \lr{ALT+CTRL+R} صفحه نمایش از راست به چپ قرار می‌گیرد و بنابراین کار شما راحت‌تر می‌شود. برای برگشتن به حالت چپ‌به‌راست کافی است
\lr{ALT+CTRL+L} را فشار دهید.
\section{نمونهٔ فایل ورودی}
یک نمونه فایل ورودی می‌تواند به صورت زیر باشد.

\setLR
\noindent\verb+\documentclass{book}+\\
\verb+\usepackage{xepersian}+\\
\verb+\newfontinstance\farsifont[Script=Arabic,Scale=1,Mapping=parsidigits]{XB Zar}+\\
\verb+\setdigitfont[Script=Arabic,Mapping=farsidigits]{XB Zar}+\\
\verb+\title{+\rl{عنوان }\verb+}+\\
\verb+\author{+\rl{نام نویسنده}\verb+}+\\
\verb+\begin{document}+\\
\verb+\maketitle+\\
\verb+\tableofcontents+\\
\verb+\chapter{+\rl{فصل اول}\verb+}+\\
\verb+\section{+\rl{بخش اول}\verb+}+\\
\vdots\\
\verb+\end{document}+
\setRL

همانطور که می‌بینید شکل فایل ورودی هیچ‌گونه تفاوتی با یک فایل استاندارد لاتک ندارد. تنها ممکن است فرمانهای خط سوم و چهارم این فایل نمونه برای شما 
نا آشنا باشند که در قسمتهای بعد به توضیح آنها می‌پردازیم. به طور کلی در استفاده از طبقه‌های استاندارد لاتک به جز فراخوانی بستهٔ \lr{\XePersian} هیچ 
کار اضافه‌ای لازم نیست که انجام دهید. تنها به عنوان یک توصیه، سعی کنید {\Large\nastaliq\textblue{ این بسته آخرین بسته‌ای باشد که فراخوانی می‌کنید.}} همچنین توجه داشته باشید که 
بسته‌های زیر به طور خودکار فراخوانی می‌شوند و شما نباید آنها را مستقیماً در فایل فراخوانی کنید.

\begin{center}\lr{amsmath, amssymb, amsthm, graphicx.}\end{center}

همچنین بسته \lr{\XePersian} هنوز قابلیت استفاده از طبقهٔ \lr{memoir} را ندارد، ولی در آینده این امکان نیز افزوده خواهد شد. 
\section{فرمانهای بسته}
در این قسمت تعدادی از فرمانهای مفید را که لازم است بدانید شرح می‌دهیم. تعدادی از این فرمانها مربوط به خود بستهٔ \lr{\XePersian} است و تعدادی هم مربوط 
به بسته‌هایی است که این بسته به طور خودکار فراخوانی می‌کند، ولی لازم است که این فرمانها را بدانید. در جدول \ref{commands} فرمانهای بسته را مشاهده
می‌کنید. همچنین در بسته چند نوع شمارنده تعریف شده است که در جدول \ref{counters} مشاهده می‌کنید.



\begin{table}[hbp]
\begin{center}
\begin{tabular}{|r|l|}
\hline
 فرمان & شرح\\
 \hline
 \verb+\farsifont+& قلم فارسی را برای حروف‌چینی به کار می‌بندد (پیش‌فرض)\\
\hline
\verb+\setRL+&جهت پاراگرافها را راست‌ به ‌چپ می‌کند (پیش‌فرض) \\
\hline
 \verb+\setLR+&جهت پاراگرافها را چپ‌ به‌ راست می‌کند\\
\hline
\verb+\footnote{...}+&برای درج یک پانوشت فارسی \\
\hline
\verb+\Footnote{...}+&برای درج یک پانوشت انگلیسی \\
\hline
\verb+\today+&درج تاریخ جاری خورشیدی\\
\hline
\verb+\rldblcolumn+&ترتیب ستونها را در یک متن چندستونی از راست‌ به ‌چپ می‌کند (پیش‌فرض)\\
\hline 
\verb+\lrdblcolumn+&ترتیب ستونها را در یک متن چند‌ستونی از چپ ‌به ‌راست می‌کند \\
\hline
\verb+\twocolumnstableofcontents+ & فهرست مطالب را در دو ستون می‌چیند (نیاز به فراخوانی \verb+fmultico+ دارد)\\
\hline
\verb+\lr{...}+&یک متن کوتاه انگلیسی را در یک پاراگراف فارسی قرار می‌دهد\\
\hline
 \verb+\rl{...}+&یک متن کوتاه فارسی را در یک پاراگراف انگلیسی قرار می‌دهد\\
\hline
\verb+\begin{english}+&شروع محیط انگلیسی \\
 \verb+\end{english}+&پایان محیط انگلیسی\\
\hline
\end{tabular}
\end{center}
\caption{فرمانها}\label{commands}
\end{table}

\begin{table}[hbp]
\begin{center}
\begin{tabular}{|r|l|}
\hline
 شمارنده & شرح\\
\hline
\verb+arabic+&شمارندهٔ عربی اصلی لاتک برای سازگاری با بسته از نو تعریف شده است. \\
\hline
 \verb+farsi+&همان اثر شمارنده \verb+arabic+ اصلی لاتک را دارد.\\
\hline
\verb+adadi+& شمارنده را به صورت یک، دو، سه، \ldots تغییر می‌دهد. \\
\hline
\verb+harfi+&شمارنده را به صورت ا، ب، پ، \ldots تغییر می‌دهد.\\
\hline
\end{tabular}
\end{center}
\caption{شمارنده‌ها}\label{counters}
\end{table}

\section{استفاده از قلمهای مختلف}
بستهٔ \lr{fontspec}، که به صورت خودکار فراخوانی می‌شود، امکان استفاده از قلمهای موجود در سیستم را فراهم می‌کند. برای استفاده از \lr{\XePersian}
لازم است که حداقل یک قلم با نام \lr{farsifont} را تعریف کنید که به صورت زیر انجام می‌شود:

\begin{english}\verb+\newfontinstance\farsifont[Script=Arabic,Scale=1,Mapping=parsidigits]{XB Zar}+\end{english}

این فرمان، قلم \lr{XB Zar} را به عنوان قلم فارسی معرفی می‌کند. گزینهٔ \verb+Scale=Arabic+ ضروری است تا حروف فارسی به هم بچسبند. گزینهٔ 
\verb+Scale=1+ اندازهٔ قلم را یک برابر اندازهٔ نرمال آن تعریف می‌کند که مقدار ۱ قابل تغییر است. گزینهٔ \verb+Mapping=parsidigits+ اعداد را در محیط فارسی
با ارقام فارسی نمایش می‌دهد.

به همین ترتیب می‌توانید هر تعداد از قلمهایی را که مایل هستید، با نامهای مختلف تعریف کنید. مثلا فرمان

\begin{english}\verb+\newfontinstance\nastaliq[Script=Arabic,Scale=2]{IranNastaliq}+\end{english}

قلم نستعلیق را معرفی می‌کند که می‌توانید از آن به صورت زیر استفاده کنید:

\setLR\begin{center}\verb+{\nastaliq+ \rl{نمونهٔ متن با قلم نستعلیق} \verb+}+\end{center}\setRL

که اثر آن همانند متن زیر است:

\begin{center}{\Large\nastaliq نمونهٔ متن با قلم نستعلیق}\end{center}

قلمی را که اعداد در محیط ریاضی با آن نگارش می‌شوند می‌توانید به دلخواه انتخاب کنید. برای این کار، فرمان زیر را در سرآغاز فایل خود قرار دهید.

\begin{english}
\verb|\setdigitfont[|Scale=1, Mapping=parsidigits\verb|]{|XB Zar\verb|}|
\end{english}

به این ترتیب قلم \lr{XB Zar} را برای نمایش اعداد در فرمولها انتخاب می‌کنید. اگر قلم اعداد را مشخص نکنید، قلم پیش‌فرض مورد استفاده قرار می‌گیرد.

همچنین می‌توانید قلمی را که با آن متنهای انگلیسی نگارش می‌شوند با فرمان زیر تعیین کنید.

\begin{english}
\verb|\setromanfont[|Scale=1, Mapping=tex-text\verb|]{|Times New Roman\verb|}|
\end{english}

\textblue{توجه داشته باشید که قلم انگلیسی باید بعد از قلم ریاضی تعریف شود.}
 اگر قلم انگلیسی معرفی نشود، قلم استاندارد تک مورد استفاده قرار 
می‌گیرد.

در آخر لازم است که بیان شود  قلمهای \lr{farsiweb} به همراه این بسته ارائه شده است. همچنین قلمهای مفید و مجانی سری ایکس ۲ را می‌توانید 
از \texttt{http://wiki.irmug.org/index.php/X\_Series\_2} تهیه کنید.
\section{حروف‌چینی شعر}
برای حروف‌چینی شعر باید فرمان زیر را در سرآغاز فایل خود قرار دهید:

\begin{english}
\verb+\usepackage{+persianpoem,fmultico\verb+}+
\end{english}
بعد از این کار به راحتی می‌توانید شعر را حروف‌چینی کنید.
{\nastaliq\doublespacing
\begin{oldpoem}

هله رفتیم و گرانی ز جمالت بردیم&
جهت توشهٔ ره ذکر وصالت بردیم\\
تا که ما را و ترا تذکرهٔ خوش باشد&
دل خسته بتو دادیم و خیالت بردیم\\
آن خیال رُخ خوبت که قمر بندهٔ اوست&
وان خَم ابروی مانند هلالت بردیم\\
و آن شکرخندهٔ خوبت که شکر تشنهٔ اوست&
ز شکر خانهٔ مجموع خصالت بردیم\\
چون کبوتر چو بپریم بتو بازآییم&
زانکه ما این پَر و بال از پَر و بالت بردیم\\
هر کجا پرد فرعی، بسوی اصل آید&
هر چه داریم هم از عزّ و جلالت بردیم\\
شمس تبریز شنو خدمت ما را زصبا&
گر شمالست و صبا هم ز شمالت بردیم

\end{oldpoem}
}
شعر بالا با کد زیر تولید شده است:

\setLR
\noindent\verb|\begin{oldpoem}|\\
\rl{هله رفتیم و گرانی ز جمالت بردیم}\verb|&|\\
\rl{جهت توشهٔ ره ذکر وصالت بردیم}\verb|\\|\\
\rl{تا که ما را و ترا تذکرهٔ خوش باشد}\verb|&|\\
\rl{دل خسته بتو دادیم و خیالت بردیم}\verb|\\|\\
\rl{آن خیال رُخ خوبت که قمر بندهٔ اوست}\verb|&|\\
\rl{وان خَم ابروی مانند هلالت بردیم}\verb|\\|\\
\rl{و آن شکرخندهٔ خوبت که شکر تشنهٔ اوست}\verb|&|\\
\rl{ز شکر خانهٔ مجموع خصالت بردیم}\verb|\\|\\
\rl{چون کبوتر چو بپریم بتو بازآییم}\verb|&|\\
\rl{زانکه ما این پَر و بال از پَر و بالت بردیم}\verb|\\|\\
\rl{هر کجا پرد فرعی، بسوی اصل آید}\verb|&|\\
\rl{هر چه داریم هم از عزّ و جلالت بردیم}\verb|\\|\\
\rl{شمس تبریز شنو خدمت ما را زصبا}\verb|&|\\
\rl{گر شمالست و صبا هم ز شمالت بردیم}\\
\verb|\end{oldpoem}|\\
\setRL

این محیط دارای حالت ستاره‌دار نیز می‌باشد که اثر آن به صورت زیر است.
\begin{oldpoem*}
هله رفتیم و گرانی ز جمالت بردیم&
جهت توشهٔ ره ذکر وصالت بردیم\\
تا که ما را و ترا تذکرهٔ خوش باشد&
دل خسته بتو دادیم و خیالت بردیم\\
آن خیال رُخ خوبت که قمر بندهٔ اوست&
وان خَم ابروی مانند هلالت بردیم\\
و آن شکرخندهٔ خوبت که شکر تشنهٔ اوست&
ز شکر خانهٔ مجموع خصالت بردیم\\
چون کبوتر چو بپریم بتو بازآییم&
زانکه ما این پَر و بال از پَر و بالت بردیم\\
هر کجا پرد فرعی، بسوی اصل آید&
هر چه داریم هم از عزّ و جلالت بردیم\\
شمس تبریز شنو خدمت ما را زصبا&
گر شمالست و صبا هم ز شمالت بردیم
\end{oldpoem*}
شعر بالا با کد زیر تولید شده است:

\setLR
\noindent\verb|\begin{oldpoem*}|\\
\rl{هله رفتیم و گرانی ز جمالت بردیم}\verb|&|\\
\rl{جهت توشهٔ ره ذکر وصالت بردیم}\verb|\\|\\
\rl{تا که ما را و ترا تذکرهٔ خوش باشد}\verb|&|\\
\rl{دل خسته بتو دادیم و خیالت بردیم}\verb|\\|\\
\rl{آن خیال رُخ خوبت که قمر بندهٔ اوست}\verb|&|\\
\rl{وان خَم ابروی مانند هلالت بردیم}\verb|\\|\\
\rl{و آن شکرخندهٔ خوبت که شکر تشنهٔ اوست}\verb|&|\\
\rl{ز شکر خانهٔ مجموع خصالت بردیم}\verb|\\|\\
\rl{چون کبوتر چو بپریم بتو بازآییم}\verb|&|\\
\rl{زانکه ما این پَر و بال از پَر و بالت بردیم}\verb|\\|\\
\rl{هر کجا پرد فرعی، بسوی اصل آید}\verb|&|\\
\rl{هر چه داریم هم از عزّ و جلالت بردیم}\verb|\\|\\
\rl{شمس تبریز شنو خدمت ما را زصبا}\verb|&|\\
\rl{گر شمالست و صبا هم ز شمالت بردیم}\\
\verb|\end{oldpoem*}|\\
\setRL
\section{حروف‌چینی چند‌ستونی}
برای حروف‌چینی یک متن در چند ستون از محیط زیر استفاده کنید. حداکثر تعداد ستونها ۵ است.

\setLR
\verb|\begin{multicols}{|\rl{تعداد ستونهای}\verb|}|

$\vdots$

\verb|\end{multicols}|
\setRL

\section{محیط مورد فارسی}
محیط مورد برای استفاده در فارسی نیز تعریف شده است که در زیر مثال آنرا می‌بنید:

$$
\rcases{\mbox{مرد}\cr\mbox{زن}}\mbox{آدم}
$$

طرح بالا با کد زیر نوشته شده است.

\setLR\verb|$$\rcases{\mbox{|\rl{مرد}\verb|}\cr\mbox{|\rl{زن}\verb|}}\mbox{|\rl{آدم}\verb|}$$|\setRL


\section{تولید نمایه}
به همراه این بسته، فایلی ارائه شده است که شما را قادر می‌سازد به راحتی نمایه برای مستندتان فراهم کنید. خود بسته هیچ‌گونه محدودیتی با نمایه‌سازی ندارد،
ولی نرم‌افزار 
\lr{makeindex} هنگام مرتب کردن فایل نمایه، ترتیب بعضی از حروف را به درستی رعایت نمی‌کند. 
برای رفع این مشکل، استفاده از \lr{xindy} بجای \lr{makeindex} توصیه می‌شود.

اگر از تکلایو ۲۰۰۸ استفاده می‌کنید \lr{xindy} به طور خودکار روی سیستم شما نصب است. کافی است فایل \lr{farsi.xdy} را که همراه این بسته 
ارائه شده است در دایرکتوری جاری قرار دهید و فرمانهای زیر را در خط فرمان اجرا کنید:

\begin{english}
\noindent\verb|tex2xindy <| filename.idx \verb|>| filename.raw\\
\verb|xindy -I xindy -M| farsi.xdy filename.raw
\end{english} 

\noindent بعد از انجام این کار، نمایهٔ مرتب شدهٔ شما آمادهٔ تزریق به مستند می‌شود.

توجه داشته باشید که اگر می‌خواهید از نمایه استفاده کنید، باید شمارندهٔ صفحه را در حالت \lr{\texttt{farsi}} قرار دهید. البته شمارندهٔ صفحه به صورت 
پیش‌فرض در این حالت قرار دارد.
\section{فرمولهای ریاضی}
بسته با حروف‌چینی فرمولهای ریاضی هیچ‌گونه مشکلی ندارد و از آنجا که بسته‌های \lr{amsmath,amsthm,} و \lr{amssymb}  به طور خودکار فراخوانی می‌شوند،
اکیداً توصیه می‌شود از فرمانهای کلاف \lr{AMSLatex} استفاده کنید. توجه داشته باشید که محیط \texttt{eqnarray} کلا با بستهٔ \lr{amsmath}
مشکل دارد و به خصوص شمارهٔ فرمول نوشته شده با این محیط ناپایدار است. به جای این محیط، از محیط \texttt{align} استفاده کنید که 
حروف‌چینی آن از \texttt{eqnarray} بهتر است و شمارهٔ آن نیز بدون مشکل قابل ارجاع است.
\begin{align}
a^2+b^2&=\sin x\label{eq1}\\
10a+b&=\cos y\label{eq2}
\end{align}

فرمولهای بالا با کد زیر تولید شده‌اند.

\begin{english}
\begin{verbatim}
\begin{align}
a^2+b^2&=\sin x\label{eq1}\\
1a+b&=\cos y\label{eq2}
\end{align}
\end{verbatim}
\end{english}
ارجاع به فرمول \eqref{eq1} به صورت طبیعی امکان پذیر است. برای اطلاعات بیشتر به \femph{مقدمه‌ای نه‌چندان کوتاه بر \lr{\LaTeXe}}
%\footnote{قابل دسترسی از\texttt{http://www.ctan.org}} 
مراجعه کنید.
\section{تهیهٔ اسلاید}
برای تهیهٔ اسلاید، بسته به طور کامل با طبقهٔ \texttt{beamer} سازگار است. یک فایل نمونه برای استفاده از این بسته می‌تواند به صورت زیر باشد:

\setLR
\noindent\verb|\documentclass[hyperref=xetex]{beamer}|\\
\verb|\usepackage{xepersian}|\\
\verb|\title{|\rl{عنوان مطلب}\verb|}|\\
\verb|\author{|\rl{نام نویسنده}\verb|}|\\
\verb|\begin{document}|\\
\verb|\frame{\maketitle}|\\
\verb|\section{|\rl{یک قسمت}\verb|}|\\
\verb|\frametitle{|\rl{مطلب}\verb|}|\\
\verb|\framesubtitle{|\rl{زیر مطلب}\verb|}|

$\vdots$

\noindent\verb|\end{frame}|

$\vdots$


\noindent\verb|\end{document}|
\setRL

\section{استفاده از \lr{PSTricks}}
تمامی امکانات استفاده از \lr{PSTricks} در بسته موجود است.

\setLR
   \psset{yunit=0.5cm,xunit=2cm}
    \begin{pspicture*}(-3,-5)(3,10)
     \psaxes[Dy=2]{->}(0,0)(-3,-5)(3,10)
     \psset{linewidth=1.5pt}
     \psPolynomial[coeff=0 0 0 1,linecolor=blue]{-2}{4}
     \psPolynomial[coeff=0 0 0 1,linecolor=red,%
       linestyle=dashed,Derivation=2]{-2}{4}
     \psPolynomial[coeff=0 0 0 1,linecolor=cyan,%
       linestyle=dotted,Derivation=3]{-2}{4}
     \rput[lb](1.8,4){\textcolor{blue}{$f(x)=x^3$}}
    \rput[lb](0.2,8){\textcolor{red}{$f^{\prime\prime}(x)=6x$}}
    \rput[lb](-2,5){\textcolor{cyan}{$f^{\prime\prime\prime}(x)=6$}}
 \end{pspicture*}
\setRL

شکل بالا با کد زیر تولید شده است.
\begin{english}
\begin{verbatim}
\setLR
   \psset{yunit=0.5cm,xunit=2cm}
    \begin{pspicture*}(-3,-5)(3,10)
     \psaxes[Dy=2]{->}(0,0)(-3,-5)(3,10)
     \psset{linewidth=1.5pt}
     \psPolynomial[coeff=0 0 0 1,linecolor=blue]{-2}{4}
     \psPolynomial[coeff=0 0 0 1,linecolor=red,%
       linestyle=dashed,Derivation=2]{-2}{4}
     \psPolynomial[coeff=0 0 0 1,linecolor=cyan,%
       linestyle=dotted,Derivation=3]{-2}{4}
     \rput[lb](1.8,4){\textcolor{blue}{$f(x)=x^3$}}
    \rput[lb](0.2,8){\textcolor{red}{$f^{\prime\prime}(x)=6x$}}
    \rput[lb](-2,5){\textcolor{cyan}{$f^{\prime\prime\prime}(x)=6$}}
 \end{pspicture*}
\setRL
\end{verbatim}
\end{english}

\section{امکانات آینده}
در نظر است الگوی کاملی برای شکستن کلمات فارسی تهیه شود تا قابل استفاده با این بسته باشد. همچنین در نظر است برای نگارش پایان‌نامه‌، بسته‌ٔ مجزایی 
بر اساس این بسته تهیه شود. اگر امکانی خاص مد نظر شماست که این بسته از آن بی‌بهره است، لطفاً اطلاع دهید تا در ویرایشهای آیندهٔ 
این بسته مورد نظر قرار بگیرد.
\end{document}