summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/xelatex/xepersian
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-01-14 18:49:06 +0000
committerKarl Berry <karl@freefriends.org>2009-01-14 18:49:06 +0000
commitae54731f22c86144ff5705f3db206fba358c04be (patch)
tree17c50cb6bab0b43cfcf93019675d7f31f4043123 /Master/texmf-dist/doc/xelatex/xepersian
parent899fb3d535cb0d801d8f1f8b528b47581e73f2f7 (diff)
xepersian update (5jan09)
git-svn-id: svn://tug.org/texlive/trunk@11873 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/xelatex/xepersian')
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/README12
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/beamer-example1.pdfbin21295 -> 0 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/beamer-example1.tex13
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/beamer-example2.pdfbin31364 -> 0 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/beamer-example2.tex31
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Goettingen.pdfbin0 -> 74715 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Hannover.pdfbin0 -> 73900 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Marburg.pdfbin0 -> 74832 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Montpellier.pdfbin0 -> 65717 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-PaloAlto.pdfbin0 -> 85630 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Pittsburgh.pdfbin0 -> 62420 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Szeged.pdfbin0 -> 74689 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-malmoe.pdfbin0 -> 60592 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-singapore.pdfbin0 -> 59597 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-warsaw.pdfbin0 -> 73799 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-xepersian-JLTree.pdfbin0 -> 79014 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-xepersian-JLTree.tex88
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/beamer-sample.pdfbin0 -> 58735 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/beamer-sample.tex82
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/clouds.jpgbin0 -> 13088 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/ftun-0.1.py430
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/gradient1.pngbin0 -> 187782 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/gradient2.pngbin0 -> 195782 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/iran.jpgbin0 -> 14797 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/ireland.jpgbin0 -> 18304 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/logo.pdfbin0 -> 10761 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/magazine-sample.pdfbin0 -> 158883 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/magazine-sample.tex178
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/notepad0.PNGbin7370 -> 0 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/notepad1.PNGbin37271 -> 20001 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/notepad2.PNGbin33727 -> 33401 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/notepad3.PNGbin11609 -> 34644 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/notepad4.PNGbin22358 -> 9097 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/notepad5.PNGbin0 -> 8865 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/notepad6.PNGbin0 -> 9202 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/notepad7.PNGbin0 -> 21313 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/notepad8.PNGbin0 -> 10993 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/notepad9.PNGbin0 -> 10018 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/persian.xdy (renamed from Master/texmf-dist/doc/xelatex/xepersian/farsi.xdy)0
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/presentation-sample.pdfbin0 -> 192359 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/presentation-sample.tex53
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/rain.jpgbin0 -> 14616 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/sumatrapdf1.PNGbin0 -> 9255 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/sumatrapdf2.PNGbin0 -> 7685 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/sun.jpgbin0 -> 10896 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/thesis-sample.tex66
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/userguide-persian.pdfbin0 -> 323435 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/userguide-persian.tex662
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/xepersian-cove.tex56
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/xepersian-esse.tex305
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/xepersian-magazine.tex262
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/xepersian-presentation.tex200
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/xepersian-thesis.tex54
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/xepersian-user-english.pdfbin0 -> 277204 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/xepersian-user-english.tex22
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/xepersian-userguide.pdfbin190913 -> 0 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/xepersian-userguide.tex411
57 files changed, 2464 insertions, 461 deletions
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/README b/Master/texmf-dist/doc/xelatex/xepersian/README
index 68c9d74e0f1..07d7807c65d 100644
--- a/Master/texmf-dist/doc/xelatex/xepersian/README
+++ b/Master/texmf-dist/doc/xelatex/xepersian/README
@@ -1,10 +1,10 @@
-------------------------------
-The XePersian Package v0.162
+The XePersian Package v0.163
-Updates: Huge Improvements: written a new package for unicode farsi maths digits, updated the user-guide.
+Updates: Huge Improvements: Almost rewritten all the macros, new functionalities have been added and lots of changes are done, written some new classes and packages.
XePersian is a package written for XeLaTeX that allows users to typeset
-Persian properly. The current version is 0.162 and it will be
+Persian properly. The current version is 0.163 and it will be
developed to meet the needs of Persian typesetting properly.
In order to use XePersian without getting any problem, the users are
@@ -29,8 +29,8 @@ from http://wiki.irmug.org/index.php/X_Series_2#Download_fonts and
http://wiki.irmug.org/index.php/XWZar
-Please report any bugs to the authors (mostafa.vahedi@gmail.com,vafa.khalighi@students.mq.edu.au,mehdioa@gmail.com).
+Please report any bugs to the author (vafa.khalighi@students.mq.edu.au).
-------------------------------
-FarsiLaTeX Group
-2008/09/27
+Vafa Khalighi
+2009/01/05
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/beamer-example1.pdf b/Master/texmf-dist/doc/xelatex/xepersian/beamer-example1.pdf
deleted file mode 100644
index b27f1474368..00000000000
--- a/Master/texmf-dist/doc/xelatex/xepersian/beamer-example1.pdf
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/beamer-example1.tex b/Master/texmf-dist/doc/xelatex/xepersian/beamer-example1.tex
deleted file mode 100644
index 9964a2bba7f..00000000000
--- a/Master/texmf-dist/doc/xelatex/xepersian/beamer-example1.tex
+++ /dev/null
@@ -1,13 +0,0 @@
-\documentclass[hyperref=xetex]{beamer}
-\usepackage{xepersian}
-\newfontfamily\farsifont[Script=Arabic,Scle=1.2,Mapping=parsidigits]{XB Zar}
-\title{نمونه اسلاید توسط \lr{\XePersian}}
-\author{وفا خلیقی}
-\begin{document}
-\frame{\maketitle}
-\section{مقدمه}
-\begin{frame}
-
-این یک نمونه اسلاید است که توسط \lr{\XePersian} درست شده است.
-\end{frame}
-\end{document}
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/beamer-example2.pdf b/Master/texmf-dist/doc/xelatex/xepersian/beamer-example2.pdf
deleted file mode 100644
index 17404c82399..00000000000
--- a/Master/texmf-dist/doc/xelatex/xepersian/beamer-example2.pdf
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/beamer-example2.tex b/Master/texmf-dist/doc/xelatex/xepersian/beamer-example2.tex
deleted file mode 100644
index 5418651514a..00000000000
--- a/Master/texmf-dist/doc/xelatex/xepersian/beamer-example2.tex
+++ /dev/null
@@ -1,31 +0,0 @@
-\documentclass{beamer}
-\usepackage{xepersian}
-\newfontfamily\farsifont[Script=Arabic,Scle=1.2,Mapping=parsidigits]{XB Zar}
-\mode<presentation>
-{
-\usetheme{Warsaw}
-}
-\title{تهیه اسلاید توسط \lr{\XePersian}}
-\author{وفا خلیقی}
-\institute{نام دانشگاه}
-\begin{document}
-\begin{frame}
- \titlepage
-\end{frame}
-\section{مقدمه}
-\subsection{حرف اول}
-\begin{frame}
-\frametitle{عنوان}
-متن اینجا قرار می‌گیرد.
-\end{frame}
-\section{قسمت بعدی}
-\subsection{یک زیرقسمت}
-\begin{frame}
-\framesubtitle{عنوان متن}
-متن اینجا قرار می‌گیرد.
-\end{frame}
-
-
-\end{document}
-
-
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Goettingen.pdf b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Goettingen.pdf
new file mode 100644
index 00000000000..4f7645fbbbb
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Goettingen.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Hannover.pdf b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Hannover.pdf
new file mode 100644
index 00000000000..0867fef3ab0
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Hannover.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Marburg.pdf b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Marburg.pdf
new file mode 100644
index 00000000000..66ea58fa08d
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Marburg.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Montpellier.pdf b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Montpellier.pdf
new file mode 100644
index 00000000000..1fc478cf951
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Montpellier.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-PaloAlto.pdf b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-PaloAlto.pdf
new file mode 100644
index 00000000000..6c05f4697dc
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-PaloAlto.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Pittsburgh.pdf b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Pittsburgh.pdf
new file mode 100644
index 00000000000..f20c315696a
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Pittsburgh.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Szeged.pdf b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Szeged.pdf
new file mode 100644
index 00000000000..4f46519ac37
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-Szeged.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-malmoe.pdf b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-malmoe.pdf
new file mode 100644
index 00000000000..ed56a8d3cab
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-malmoe.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-singapore.pdf b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-singapore.pdf
new file mode 100644
index 00000000000..b9d27f7541b
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-singapore.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-warsaw.pdf b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-warsaw.pdf
new file mode 100644
index 00000000000..53992b095c9
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-warsaw.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-xepersian-JLTree.pdf b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-xepersian-JLTree.pdf
new file mode 100644
index 00000000000..22929001e7a
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-xepersian-JLTree.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-xepersian-JLTree.tex b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-xepersian-JLTree.tex
new file mode 100644
index 00000000000..f8cc07f7fa4
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample-xepersian-JLTree.tex
@@ -0,0 +1,88 @@
+\documentclass{beamer}
+\usetheme{xepersian-JLTree}
+\usepackage{xepersian}
+\settextfont[Scale=1]{XB Zar}
+\setromantextfont[Scale=1]{Linux Libertine}
+\AtBeginDocument{\setdigitfont[Scale=1]{XB Zar}}
+\title{عنوان اسلاید}
+\subtitle{این یک زیرعنوان است}
+\author{وفا خلیقی}
+\institute{دانشگاه تهران}
+\AtBeginSubsection[]
+{
+ \begin{frame}<beamer>
+ \frametitle{فهرست مطالب}
+ \tableofcontents[currentsection]
+ \end{frame}
+}
+\begin{document}
+\begin{frame}
+\titlepage
+\end{frame}
+\section{کتاب‌نامه}
+\begin{frame}{کتاب‌نامه}
+[۱] دیوان حافظ
+\end{frame}
+\section{قضیه‌های ریاضی}
+\begin{frame}{این یک عنوان است}
+\framesubtitle{این زیرعنوان است}
+\begin{مثال}
+در این مثال به برسی توابعی خواهیم پرداخت که برای ما قابل استفاده هستند:
+\begin{equation}
+(x-y)^2=x^2-2xy+y^2
+\end{equation}
+\end{مثال}
+\begin{پاسخ}
+این یک پاسخ است
+\end{پاسخ}
+
+\end{frame}
+\section{ادامه عنوان قبلی}
+\begin{frame}{ادامهّ عنوان قبلی}
+\framesubtitle{ادامهٔ زیرعنوان قبلی}
+\begin{قضیه}
+این یک قضیه است.
+\end{قضیه}
+\begin{اثبات}
+این یک اثبات است
+\end{اثبات}
+\begin{نتیجه}
+این یک نتیجه است
+\end{نتیجه}
+\end{frame}
+\section{شروع مبحثی دیگر}
+\begin{frame}{ادامهّ عنوان قبلی}
+\framesubtitle{ادامهٔ زیرعنوان قبلی}
+\begin{لما}
+این یک لما است
+\end{لما}
+\begin{تعریف}
+این یک تعریف است
+\end{تعریف}
+\begin{تعریفها}
+این محیط مخصوص بیشتر از یک تعریف است
+\end{تعریفها}
+\end{frame}
+\section{نتیجه‌گیری نهائی}
+\begin{frame}{ادامهّ عنوان قبلی}
+\framesubtitle{ادامهٔ زیرعنوان قبلی}
+\begin{بلوک}{محیط بلوک}
+این محیط بلوک است
+\end{بلوک}
+\begin{بلوک‌مثال}{محیط بلوک مثال}
+این محیط بلوک مثال است
+\end{بلوک‌مثال}
+\begin{بلوک‌هشدار}{محیط بلوک هشدار}
+این محیط بلوک هشدار است.
+\end{بلوک‌هشدار}
+\end{frame}
+\section{مقداری متن معمولی}
+\begin{frame}{ادامهّ عنوان قبلی}
+\framesubtitle{ادامهٔ زیرعنوان قبلی}
+این هم مقداری متن معمولی می‌نویسم تا بتوانم به خط بعدی بروم و ببینم که آیا واقعاً \lr{beamer} دست از لجاجت برمی‌دارد یا نه
+\begin{roman}
+This is an English paragraph that I am writing here to see what happens after this, will I get a new bug or I am lucky enough?
+\end{roman}
+این دوباره متنی است فارسی که من آن را می‌نویسم و هنوز در حال آزمایش هستم تا بتوانم به خط بعدی بروم و نتیجه را مشاهده کنم.
+\end{frame}
+\end{document}
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample.pdf b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample.pdf
new file mode 100644
index 00000000000..b88b3240eb3
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample.tex b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample.tex
new file mode 100644
index 00000000000..270b23bbc3c
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/beamer-sample.tex
@@ -0,0 +1,82 @@
+\documentclass{beamer}
+\usetheme{Warsaw}
+\usepackage{xepersian}
+\settextfont[Scale=1]{XB Zar}
+\setromantextfont[Scale=1]{Linux Libertine}
+\AtBeginDocument{\setdigitfont[Scale=1]{XB Zar}}
+\title{عنوان اسلاید}
+\subtitle{این یک زیرعنوان است}
+\author{وفا خلیقی}
+\institute{دانشگاه تهران}
+\begin{document}
+\begin{frame}
+\titlepage
+\end{frame}
+
+
+\begin{frame}{این یک عنوان است}
+\framesubtitle{این زیرعنوان است}
+\begin{مثال}
+در این مثال به برسی توابعی خواهیم پرداخت که برای ما قابل استفاده هستند:
+\begin{equation}
+(x-y)^2=x^2-2xy+y^2
+\end{equation}
+\end{مثال}
+\begin{پاسخ}
+این یک پاسخ است
+\end{پاسخ}
+\begin{مسئله}
+این یک مسئله است.
+\end{مسئله}
+\end{frame}
+\begin{frame}{ادامهّ عنوان قبلی}
+\framesubtitle{ادامهٔ زیرعنوان قبلی}
+\begin{قضیه}
+این یک قضیه است.
+\end{قضیه}
+\begin{اثبات}
+این یک اثبات است
+\end{اثبات}
+\begin{نتیجه}
+این یک نتیجه است
+\end{نتیجه}
+\begin{حقیقت}
+این یک حقیقت است
+\end{حقیقت}
+\end{frame}
+\begin{frame}{ادامهّ عنوان قبلی}
+\framesubtitle{ادامهٔ زیرعنوان قبلی}
+\begin{لما}
+این یک لما است
+\end{لما}
+\begin{تعریف}
+این یک تعریف است
+\end{تعریف}
+\begin{تعریفها}
+این محیط مخصوص بیشتر از یک تعریف است
+\end{تعریفها}
+\begin{مثالها}
+این محیط مخصوص بیشتر از یک مثال است.
+\end{مثالها}
+\end{frame}
+\begin{frame}{ادامهّ عنوان قبلی}
+\framesubtitle{ادامهٔ زیرعنوان قبلی}
+\begin{بلوک}{محیط بلوک}
+این محیط بلوک است
+\end{بلوک}
+\begin{بلوک‌مثال}{محیط بلوک مثال}
+این محیط بلوک مثال است
+\end{بلوک‌مثال}
+\begin{بلوک‌هشدار}{محیط بلوک هشدار}
+این محیط بلوک هشدار است.
+\end{بلوک‌هشدار}
+\end{frame}
+\begin{frame}{ادامهّ عنوان قبلی}
+\framesubtitle{ادامهٔ زیرعنوان قبلی}
+این هم مقداری متن معمولی می‌نویسم تا بتوانم به خط بعدی بروم و ببینم که آیا واقعاً \lr{beamer} دست از لجاجت برمی‌دارد یا نه
+\begin{roman}
+This is an English paragraph that I am writing here to see what happens after this, will I get a new bug or I am lucky enough?
+\end{roman}
+این دوباره متنی است فارسی که من آن را می‌نویسم و هنوز در حال آزمایش هستم تا بتوانم به خط بعدی بروم و نتیجه را مشاهده کنم.
+\end{frame}
+\end{document}
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/clouds.jpg b/Master/texmf-dist/doc/xelatex/xepersian/clouds.jpg
new file mode 100644
index 00000000000..b4073a07231
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/clouds.jpg
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/ftun-0.1.py b/Master/texmf-dist/doc/xelatex/xepersian/ftun-0.1.py
new file mode 100644
index 00000000000..6d53ef6adfa
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/ftun-0.1.py
@@ -0,0 +1,430 @@
+#########################################
+# General Public License #
+# Author: Mostafa Vahedi #
+# Date: 3 Mar. 2008 #
+# Version 0.1 #
+#########################################
+
+import codecs
+
+import sys
+
+
+ft_numerical = [
+chr(0xB9), # Arabic Thoushads Seperator
+chr(0xBC) # ARABIC DECIMAL SEPARATOR
+]
+
+
+ft_vowels = [
+chr(0xB0), # ARABIC FATHA
+chr(0xB1), # ARABIC KASRA
+chr(0xB2), # ARABIC DAMMA
+chr(0xB3), # ARABIC FATHATAN
+chr(0xB4), # ARABIC SHADDA
+chr(0xBA), # ARABIC LETTER SUPERSCRIPT ALEF
+chr(0xBB), # ARABIC HAMZA ABOVE
+chr(0xC4) # ARABIC SUKUN
+]
+
+ft_non_joiners = [
+chr(0x8F) # ARABIC LETTER HAMZA
+]
+
+ft_bidi_joiners_initial = [
+chr(0xE4), # ARABIC LETTER AIN, initial form
+chr(0xE8), # ARABIC LETTER GHAIN, initial form
+chr(0xFB) # ARABIC LETTER HEH, initial form
+]
+
+ft_bidi_joiners_medial = [
+chr(0xE3), # ARABIC LETTER AIN, medial form
+chr(0xE7), # ARABIC LETTER GHAIN, medial form
+chr(0xFA) # ARABIC LETTER HEH, medial form
+]
+
+ft_bidi_joiners_final = [
+chr(0xE2), # ARABIC LETTER AIN, final form
+chr(0xE6), # ARABIC LETTER GHAIN, final form
+chr(0xFC) # ARABIC LETTER FARSI YEH, final form
+]
+
+ft_bidi_joiners_isolated = [
+chr(0xE1), # ARABIC LETTER AIN, isolated form
+chr(0xE5), # ARABIC LETTER GHAIN, isolated form
+chr(0xFD) # ARABIC LETTER FARSI YEH, isolated form
+]
+
+ft_bidi_joiners_initial_medial = [
+chr(0x8B), # ARABIC TATWEEL
+chr(0x8E), # ARABIC LETTER YEH WITH HAMZA ABOVE, initial-medial form
+chr(0x93), # ARABIC LETTER BEH, initial-medial form
+chr(0x95), # ARABIC LETTER PEH, initial-medial form
+chr(0x97), # ARABIC LETTER TEH, initial-medial form
+chr(0x99), # ARABIC LETTER THEH, initial-medial form
+chr(0x9B), # ARABIC LETTER JEEM, initial-medial form
+chr(0x9D), # ARABIC LETTER TCHEH, initial-medial form
+chr(0x9F), # ARABIC LETTER HAH, initial-medial form
+chr(0xA1), # ARABIC LETTER KHAH, initial-medial form
+chr(0xA8), # ARABIC LETTER SEEN, initial-medial form
+chr(0xAA), # ARABIC LETTER SHEEN, initial-medial form
+chr(0xAC), # ARABIC LETTER SAD, initial-medial form
+chr(0xAE), # ARABIC LETTER DAD, initial-medial form
+chr(0xAF), # ARABIC LETTER TAH, initial-medial form
+chr(0xE0), # ARABIC LETTER ZAH, initial-medial form
+chr(0xEA), # ARABIC LETTER FEH, initial-medial form
+chr(0xEC), # ARABIC LETTER QAF, initial-medial form
+chr(0xEE), # ARABIC LETTER KEHEH, initial-medial form
+chr(0xF0), # ARABIC LETTER GAF, initial-medial form
+chr(0xF3), # ARABIC LETTER LAM, initial-medial form
+chr(0xF5), # ARABIC LETTER MEEM, initial-medial form
+chr(0xF7), # ARABIC LETTER NOON, initial-medial form
+chr(0xFE) # ARABIC LETTER FARSI YEH, initial-medial form
+]
+
+ft_bidi_joiners_final_isolated = [
+chr(0x92), # ARABIC LETTER BEH, final-isolated form
+chr(0x94), # ARABIC LETTER PEH, final-isolated form
+chr(0x96), # ARABIC LETTER TEH, final-isolated form
+chr(0x98), # ARABIC LETTER THEH, final-isolated form
+chr(0x9A), # ARABIC LETTER JEEM, final-isolated form
+chr(0x9C), # ARABIC LETTER TCHEH, final-isolated form
+chr(0x9E), # ARABIC LETTER HAH, final-isolated form
+chr(0xA0), # ARABIC LETTER KHAH, final-isolated form
+chr(0xA7), # ARABIC LETTER SEEN, final-isolated form
+chr(0xA9), # ARABIC LETTER SHEEN, final-isolated form
+chr(0xAB), # ARABIC LETTER SAD, final-isolated form
+chr(0xAD), # ARABIC LETTER DAD, final-isolated form
+chr(0xC1), # ARABIC LETTER TAH, final-isolated form
+chr(0xC2), # ARABIC LETTER ZAH, final-isolated form
+chr(0xE9), # ARABIC LETTER FEH, final-isolated form
+chr(0xEB), # ARABIC LETTER QAF, final-isolated form
+chr(0xED), # ARABIC LETTER KEHEH, final-isolated form
+chr(0xEF), # ARABIC LETTER GAF, final-isolated form
+chr(0xF1), # ARABIC LETTER LAM, final-isolated form
+chr(0xF4), # ARABIC LETTER MEEM, final-isolated form
+chr(0xF6), # ARABIC LETTER NOON, final-isolated form
+chr(0xF9) # ARABIC LETTER HEH, final-isolated form
+]
+
+ft_right_joiners_final = [
+chr(0x91) # ARABIC LETTER ALEF, final form
+]
+
+ft_right_joiners_isolated = [
+chr(0x8D), # ARABIC LETTER ALEF WITH MADDA ABOVE, isolated form
+chr(0x90) # ARABIC LETTER ALEF, isolated form
+]
+
+ft_right_joiners_final_isolated = [
+chr(0xA2), # ARABIC LETTER DAL
+chr(0xA3), # ARABIC LETTER THAL
+chr(0xA4), # ARABIC LETTER REH
+chr(0xA5), # ARABIC LETTER ZAIN
+chr(0xA6), # ARABIC LETTER JEH
+chr(0xBF), # ARABIC LETTER TEH MARBUTAH
+chr(0xF2), # ARABIC LIGATURE LAM WITH ALEF
+chr(0xF8) # ARABIC LETTER WAW
+]
+
+
+table_FT_UN = {
+chr(0x80) : [u'\u06F0'], # EXTENDED ARABIC-INDIC DIGIT ZERO
+chr(0x81) : [u'\u06F1'], # EXTENDED ARABIC-INDIC DIGIT ONE
+chr(0x82) : [u'\u06F2'], # EXTENDED ARABIC-INDIC DIGIT TWO
+chr(0x83) : [u'\u06F3'], # EXTENDED ARABIC-INDIC DIGIT THREE
+chr(0x84) : [u'\u06F4'], # EXTENDED ARABIC-INDIC DIGIT FOUR
+chr(0x85) : [u'\u06F5'], # EXTENDED ARABIC-INDIC DIGIT FIVE
+chr(0x86) : [u'\u06F6'], # EXTENDED ARABIC-INDIC DIGIT SIX
+chr(0x87) : [u'\u06F7'], # EXTENDED ARABIC-INDIC DIGIT SEVEN
+chr(0x88) : [u'\u06F8'], # EXTENDED ARABIC-INDIC DIGIT EIGHT
+chr(0x89) : [u'\u06F9'], # EXTENDED ARABIC-INDIC DIGIT NINE
+chr(0x8A) : [u'\u060C'], # ARABIC COMMA
+chr(0x8B) : [u'\u0640'], # ARABIC TATWEEL
+chr(0x8C) : [u'\u061F'], # ARABIC QUESTION MARK
+chr(0x8D) : [u'\u0622'], # ARABIC LETTER ALEF WITH MADDA ABOVE, isolated form
+chr(0x8E) : [u'\u0626'], # ARABIC LETTER YEH WITH HAMZA ABOVE, initial-medial form
+chr(0x8F) : [u'\u0621'], # ARABIC LETTER HAMZA
+chr(0x90) : [u'\u0627'], # ARABIC LETTER ALEF, isolated form
+chr(0x91) : [u'\u0627'], # ARABIC LETTER ALEF, final form
+chr(0x92) : [u'\u0628'], # ARABIC LETTER BEH, final-isolated form
+chr(0x93) : [u'\u0628'], # ARABIC LETTER BEH, initial-medial form
+chr(0x94) : [u'\u067E'], # ARABIC LETTER PEH, final-isolated form
+chr(0x95) : [u'\u067E'], # ARABIC LETTER PEH, initial-medial form
+chr(0x96) : [u'\u062A'], # ARABIC LETTER TEH, final-isolated form
+chr(0x97) : [u'\u062A'], # ARABIC LETTER TEH, initial-medial form
+chr(0x98) : [u'\u062B'], # ARABIC LETTER THEH, final-isolated form
+chr(0x99) : [u'\u062B'], # ARABIC LETTER THEH, initial-medial form
+chr(0x9A) : [u'\u062C'], # ARABIC LETTER JEEM, final-isolated form
+chr(0x9B) : [u'\u062C'], # ARABIC LETTER JEEM, initial-medial form
+chr(0x9C) : [u'\u0686'], # ARABIC LETTER TCHEH, final-isolated form
+chr(0x9D) : [u'\u0686'], # ARABIC LETTER TCHEH, initial-medial form
+chr(0x9E) : [u'\u062D'], # ARABIC LETTER HAH, final-isolated form
+chr(0x9F) : [u'\u062D'], # ARABIC LETTER HAH, initial-medial form
+chr(0xA0) : [u'\u062E'], # ARABIC LETTER KHAH, final-isolated form
+chr(0xA1) : [u'\u062E'], # ARABIC LETTER KHAH, initial-medial form
+chr(0xA2) : [u'\u062F'], # ARABIC LETTER DAL
+chr(0xA3) : [u'\u0630'], # ARABIC LETTER THAL
+chr(0xA4) : [u'\u0631'], # ARABIC LETTER REH
+chr(0xA5) : [u'\u0632'], # ARABIC LETTER ZAIN
+chr(0xA6) : [u'\u0698'], # ARABIC LETTER JEH
+chr(0xA7) : [u'\u0633'], # ARABIC LETTER SEEN, final-isolated form
+chr(0xA8) : [u'\u0633'], # ARABIC LETTER SEEN, initial-medial form
+chr(0xA9) : [u'\u0634'], # ARABIC LETTER SHEEN, final-isolated form
+chr(0xAA) : [u'\u0634'], # ARABIC LETTER SHEEN, initial-medial form
+chr(0xAB) : [u'\u0635'], # ARABIC LETTER SAD, final-isolated form
+chr(0xAC) : [u'\u0635'], # ARABIC LETTER SAD, initial-medial form
+chr(0xAD) : [u'\u0636'], # ARABIC LETTER DAD, final-isolated form
+chr(0xAE) : [u'\u0636'], # ARABIC LETTER DAD, initial-medial form
+chr(0xAF) : [u'\u0637'], # ARABIC LETTER TAH, initial-medial form
+chr(0xB0) : [u'\u064E'], # ARABIC FATHA
+chr(0xB1) : [u'\u0650'], # ARABIC KASRA
+chr(0xB2) : [u'\u064F'], # ARABIC DAMMA
+chr(0xB3) : [u'\u064B'], # ARABIC FATHATAN
+chr(0xB4) : [u'\u0651'], # ARABIC SHADDA
+chr(0xB5) : [u'\u0023'], # * #
+chr(0xB6) : [u'\u0024'], # * $
+chr(0xB7) : [u'\u0025'], # * %
+chr(0xB8) : [u'\u0026'], # * &
+chr(0xB9) : [u'\u066C'], # Arabic Thoushads Seperator
+chr(0xBA) : [u'\u0670'], # ARABIC LETTER SUPERSCRIPT ALEF
+chr(0xBB) : [u'\u0654'], # ARABIC HAMZA ABOVE
+chr(0xBC) : [u'\u066B'], # ARABIC DECIMAL SEPARATOR
+chr(0xBD) : [u'\u0029'], # * RIGHT PARENTHESIS
+chr(0xBE) : [u'\u0028'], # * LEFT PARENTHESIS
+chr(0xBF) : [u'\u0629'], # ARABIC LETTER TEH MARBUTAH
+chr(0xC0) : [u'\u00BB'], # RIGHT-POINTING DOUBLE ANGLE QUOTATION MARK
+chr(0xC1) : [u'\u0637'], # ARABIC LETTER TAH, final-isolated form
+chr(0xC2) : [u'\u0638'], # ARABIC LETTER ZAH, final-isolated form
+chr(0xC3) : [u'\u00AB'], # LEFT-POINTING DOUBLE ANGLE QUOTATION MARK
+chr(0xC4) : [u'\u0652'], # ARABIC SUKUN
+chr(0xC5) : [u'\u002D'], # * -
+chr(0xC6) : [u'\u002E'], # * FULL STOP
+chr(0xC7) : [u'\u002F'], # * /
+chr(0xC8) : [u'\u002A'], # * *
+chr(0xC9) : [u'\u007E'], # * ~
+chr(0xCA) : [u'\u003A'], # * COLON
+chr(0xCB) : [u'\u061B'], # ARABIC SEMICOLON
+chr(0xCC) : [u'\u003E'], # * GREATER-THAN SIGN
+chr(0xCD) : [u'\u002B'], # * +
+chr(0xCE) : [u'\u003D'], # * =
+chr(0xCF) : [u'\u003C'], # * LESS-THAN SIGN
+chr(0xD0) : [u'\u0040'], # * @
+chr(0xD1) : [u'\u005D'], # * [
+chr(0xD2) : [u'\u005C'], # * \
+chr(0xD3) : [u'\u005B'], # * ]
+chr(0xD4) : [u'\u005E'], # * ^
+chr(0xD5) : [u'\u005F'], # * _
+chr(0xD6) : [u'\u0060'], # * `
+chr(0xD7) : [u'\u007D'], # * {
+chr(0xD8) : [u'\u007C'], # * |
+chr(0xDA) : [u'\u0020'], # * SPACE
+chr(0xDD) : [u'\u0021'], # * EXCLAMATION MARK
+chr(0xDE) : [u'\u007B'], # * }
+chr(0xE0) : [u'\u0638'], # ARABIC LETTER ZAH, initial-medial form
+chr(0xE1) : [u'\u0639'], # ARABIC LETTER AIN, isolated form
+chr(0xE2) : [u'\u0639'], # ARABIC LETTER AIN, final form
+chr(0xE3) : [u'\u0639'], # ARABIC LETTER AIN, medial form
+chr(0xE4) : [u'\u0639'], # ARABIC LETTER AIN, initial form
+chr(0xE5) : [u'\u063A'], # ARABIC LETTER GHAIN, isolated form
+chr(0xE6) : [u'\u063A'], # ARABIC LETTER GHAIN, final form
+chr(0xE7) : [u'\u063A'], # ARABIC LETTER GHAIN, medial form
+chr(0xE8) : [u'\u063A'], # ARABIC LETTER GHAIN, initial form
+chr(0xE9) : [u'\u0641'], # ARABIC LETTER FEH, final-isolated form
+chr(0xEA) : [u'\u0641'], # ARABIC LETTER FEH, initial-medial form
+chr(0xEB) : [u'\u0642'], # ARABIC LETTER QAF, final-isolated form
+chr(0xEC) : [u'\u0642'], # ARABIC LETTER QAF, initial-medial form
+chr(0xED) : [u'\u06A9'], # ARABIC LETTER KEHEH, final-isolated form
+chr(0xEE) : [u'\u06A9'], # ARABIC LETTER KEHEH, initial-medial form
+chr(0xEF) : [u'\u06AF'], # ARABIC LETTER GAF, final-isolated form
+chr(0xF0) : [u'\u06AF'], # ARABIC LETTER GAF, initial-medial form
+chr(0xF1) : [u'\u0644'], # ARABIC LETTER LAM, final-isolated form
+chr(0xF2) : [u'\u0644\u0627'], # ARABIC LIGATURE LAM WITH ALEF
+chr(0xF3) : [u'\u0644'], # ARABIC LETTER LAM, initial-medial form
+chr(0xF4) : [u'\u0645'], # ARABIC LETTER MEEM, final-isolated form
+chr(0xF5) : [u'\u0645'], # ARABIC LETTER MEEM, initial-medial form
+chr(0xF6) : [u'\u0646'], # ARABIC LETTER NOON, final-isolated form
+chr(0xF7) : [u'\u0646'], # ARABIC LETTER NOON, initial-medial form
+chr(0xF8) : [u'\u0648'], # ARABIC LETTER WAW
+chr(0xF9) : [u'\u0647'], # ARABIC LETTER HEH, final-isolated form
+chr(0xFA) : [u'\u0647'], # ARABIC LETTER HEH, medial form
+chr(0xFB) : [u'\u0647'], # ARABIC LETTER HEH, initial form
+chr(0xFC) : [u'\u06CC'], # ARABIC LETTER FARSI YEH, final form
+chr(0xFD) : [u'\u06CC'], # ARABIC LETTER FARSI YEH, isolated form
+chr(0xFE) : [u'\u06CC'] # ARABIC LETTER FARSI YEH, initial-medial form
+}
+
+
+def ft_is_numeric(ch):
+ if ((ch in ft_numerical) or
+ ((ch >= chr(0x80)) and (ch <= chr(0x89))) ):
+ return 1
+ return 0
+
+def ft_can_join_left(ch):
+ if ((ch in ft_bidi_joiners_initial) or
+ (ch in ft_bidi_joiners_medial) or
+ (ch in ft_bidi_joiners_final) or
+ (ch in ft_bidi_joiners_isolated) or
+ (ch in ft_bidi_joiners_initial_medial) or
+ (ch in ft_bidi_joiners_final_isolated)):
+ return 1
+ return 0
+
+def ft_can_join_right(ch):
+ if (ft_can_join_left(ch) or
+ (ch in ft_right_joiners_final) or
+ (ch in ft_right_joiners_isolated) or
+ (ch in ft_right_joiners_final_isolated)):
+ return 1
+ return 0
+
+def ft_joining_left(ch):
+ if ((ch in ft_bidi_joiners_initial) or
+ (ch in ft_bidi_joiners_medial) or
+ (ch in ft_bidi_joiners_initial_medial)):
+ return 1
+ return 0
+
+
+def ft_joining_right(ch):
+ if ((ch in ft_right_joiners_final) or
+ (ch in ft_bidi_joiners_medial) or
+ (ch in ft_bidi_joiners_final)):
+ return 1
+ return 0
+
+def ft_not_right_joined(ch):
+ if ((ch in ft_bidi_joiners_initial) or
+ (ch in ft_right_joiners_isolated) or
+ (ch in ft_bidi_joiners_isolated)):
+ return 1
+ return 0
+
+def ft_adjust_shaping(text, i):
+ current = text[i]
+ u = u''
+ try:
+ u = table_FT_UN[current][0]
+ except KeyError:
+ return u''
+
+ #if you don't want shaping remove the following comment
+ #return u
+
+ if ((current in ft_vowels) or (ft_is_numeric(current))):
+ return u
+
+ #find next non-vowel character on the left
+ text_len = len(text)
+ next_index = i+1
+ while ((next_index < text_len) and (text[next_index] in ft_vowels)):
+ next_index += 1
+
+ if (next_index == text_len):
+ next = ''
+ else:
+ next = text[next_index]
+
+ # if current letter is joining from left but next letter is or can not joining
+ if (ft_joining_left(current)):
+ if (not ft_can_join_right(next)):
+ u += u'\u200D' #ZWJ
+ elif (ft_not_right_joined(next)):
+ u += u'\u200D\u200C' #ZWJ+ZWNJ
+ # if current letter can join but next letter is joining from right
+ elif (ft_can_join_left(current)):
+ if (ft_joining_right(next)):
+ u += u'\u200C\u200D' #ZWNJ+ZWJ
+ elif (ft_can_join_right(next)):
+ u += u'\u200C' #ZWNJ
+ return u
+
+def ft_adjust_number(text):
+ result = u''
+ i = len(text)-1
+ while (i >= 0):
+ result += ft_adjust_shaping(text, i)
+ i -= 1
+ return result
+
+
+def map_ft_unicode(text):
+ mapped_text = u''
+
+ i = 0
+ while (i < len(text)):
+ if (ft_is_numeric(text[i])):
+ next_index = i
+ while ((next_index+1 < len(text)) and
+ (ft_is_numeric(text[next_index+1]))):
+ next_index += 1
+ mapped_text += ft_adjust_number(text[i:next_index+1])
+ i = next_index+1
+ continue
+
+ mapped_text += ft_adjust_shaping(text, i)
+ i += 1
+ return mapped_text
+
+def ft_next_part(line, i):
+ j = i
+ language_flag = (line[j]<chr(0x80))
+ while ((j<line_len) and ((line[j]<chr(0x80)) == language_flag) ):
+ j += 1
+ return j
+
+# Main body of the program
+if len(sys.argv) <= 2:
+ print 'usage: python undk in_filename out_filename'
+ exit(0)
+
+filename = sys.argv[1]
+outfile = sys.argv[2]
+
+try:
+ f = open(filename, 'r')
+except IOError:
+ print "Can not open the input file: " + filename
+ exit(0)
+
+try:
+ of = codecs.open(outfile, encoding='utf-8', mode='w')
+except IOError:
+ print "Can not open the output file: " + outfile
+ exit(0)
+
+line_number = 0
+for line in f:
+ line_number += 1
+ output_line = u''
+ line_len = len(line)
+
+ line_direction_rtl = 1
+ if line[0] == '>':
+ line_direction_rtl = 0
+ elif line[0] != '<':
+ print "FORMAT ERROR AT LINE: " + str(line_number)
+ exit(0)
+
+ i = 1
+
+ while (i<line_len):
+ next_part_index = ft_next_part(line, i)
+ next_part = line[i:next_part_index]
+ next_part_latin = (line[i]<chr(0x80))
+
+ if next_part_latin:
+ output_line += next_part.encode( 'utf-8' )
+ else:
+ output_line += map_ft_unicode(next_part)
+ i = next_part_index
+ # end of while
+
+ # write the processed line
+ of.write(output_line)
+ # end of line processing
+# end of file processing
+
+of.close()
+f.close()
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/gradient1.png b/Master/texmf-dist/doc/xelatex/xepersian/gradient1.png
new file mode 100644
index 00000000000..02cff8d380a
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/gradient1.png
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/gradient2.png b/Master/texmf-dist/doc/xelatex/xepersian/gradient2.png
new file mode 100644
index 00000000000..e6db39cf0c1
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/gradient2.png
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/iran.jpg b/Master/texmf-dist/doc/xelatex/xepersian/iran.jpg
new file mode 100644
index 00000000000..7ab38904137
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/iran.jpg
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/ireland.jpg b/Master/texmf-dist/doc/xelatex/xepersian/ireland.jpg
new file mode 100644
index 00000000000..bacd5b97700
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/ireland.jpg
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/logo.pdf b/Master/texmf-dist/doc/xelatex/xepersian/logo.pdf
new file mode 100644
index 00000000000..1363dc199a9
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/logo.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/magazine-sample.pdf b/Master/texmf-dist/doc/xelatex/xepersian/magazine-sample.pdf
new file mode 100644
index 00000000000..05deac3a84e
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/magazine-sample.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/magazine-sample.tex b/Master/texmf-dist/doc/xelatex/xepersian/magazine-sample.tex
new file mode 100644
index 00000000000..5197b86757f
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/magazine-sample.tex
@@ -0,0 +1,178 @@
+\documentclass[12pt,twoside]{xepersian-magazine}
+\usepackage{xepersian}
+\settextfont[Scale=1]{XB Zar}
+\setromantextfont[Scale=1]{Junicode}
+\setdigitfont{XB Zar}
+\pagestyle{fancy}
+\title{مجلهٔ زی‌پرشین}
+\author{وفا خلیقی}
+\edition{جلد اول}
+\customlogo{مجلهٔ زی‌پرشین}
+\customminilogo{مجلهٔ زی‌پرشین}
+\custommagazinename{مجلهٔ زی‌پرشین}
+\customwwwTxt{http://parsilatex.org}
+\begin{document}
+\begin{frontpage}
+\firstimage{img/ireland.jpg}{این زیرنویس تصویر اصلی در صفحهٔ اول است.}
+\firstarticle{این تیتر مقالهٔ اول است.}
+ {خوب این قسمت کوچکی از مقالهٔ اول است که ما در حال نوشتن آن هستم. باید یک مقدار بنویسیم تا مقداری این قسمت پر شود تا بتوانیم چیز قشنگی داشته باشیم. دقت کنیم که بصورت انتخابی حتی می‌توانیم زمان را هم درج کنیم که در سمت راست قرار می‌گیرد.}%
+ {۱۲:۳۴}
+\secondarticle{این هم سر تیتر مقالهٔ دوم است.}%
+ {این هم زیر تیتر مقالهٔ دوم است که آن را در اینجا می‌نویسیم.}%
+ {خوب این قسمت کوچکی از مقالهٔ اول است که ما در حال نوشتن آن هستم. باید یک مقدار بنویسیم تا مقداری این قسمت پر شود تا بتوانیم چیز قشنگی داشته باشیم. دقت کنیم که بصورت انتخابی حتی می‌توانیم زمان را هم درج کنیم که در سمت راست قرار می‌گیرد.}%
+ {قسمت الف}%
+ {۱۰:۲۳}
+
+\thirdarticle{این سرتیتر مقالهٔ سوم است.}%
+ {این هم زیرتیتر مقالهٔ سوم است که ما آن را در اینجا قرار می‌دهیم.}%
+ {خوب این قسمت کوچکی از مقالهٔ اول است که ما در حال نوشتن آن هستم. باید یک مقدار بنویسیم تا مقداری این قسمت پر شود تا بتوانیم چیز قشنگی داشته باشیم. دقت کنیم که بصورت انتخابی حتی می‌توانیم زمان را هم درج کنیم که در سمت راست قرار می‌گیرد. و همانطور که می‌بینید من مطلبی برای گفتن ندارم فقط متن علکی می‌نویسم تا کمی صفحه را پر کرده باشم. اما در قسمتهای بعدی مقداری از سهراب سپهری خواهم نوشت.}%
+
+ {قسمت ب}%
+ {۱۰:۰۲}
+
+\begin{indexblock}{نمایه (فهرست مطالب) اصلی}
+\indexitem{۱- مقاله اول}{1}
+
+\indexitem{۲- مقاله دوم}{3}
+
+\indexitem{۳- مقاله سوم}{3}
+
+\indexitem{۴- مقاله چهارم}{5}
+\end{indexblock}
+
+\begin{weatherblock}{وضع آب و هوا}
+\weatheritem{img/weather/rain.jpg}{امروز}{13}{9}{}
+\weatheritem{img/weather/sun.jpg}{فردا}{15}{1}{}
+\weatheritem{img/weather/clouds.jpg}{جمعه}{12}{6}{}
+\end{weatherblock}
+
+
+\begin{authorblock}
+\textbf{ویرایشگران}
+
+وفا خلیقی، مهدی امیدعلی و مصطفی واحدی
+
+\texttt{vafa@aol.com.au\\[5pt]
+http://parsilatex.org}\\
+\end{authorblock}
+\end{frontpage}
+\newsection{قسمت الف}
+\begin{article}{2}
+ {این تیتر این مقاله است.}
+ {این هم زیرتیتر این مقاله هست.}
+ {قسمت الف}
+ {1}
+\authorandplace{نام نویسنده}{مکان}
+
+
+
+
+\noindent\timestamp{۸:۲۵}
+ويژگی اصلی که اين معماری را متمايز کرده و در دنيای اينترنت آن‌ها در مقابل معماری قبلی شبكه‌ها قرار داده است، امكان ايجاد ارتباط مستقيم بين كامپيوترهای مختلف بدون نياز به دخالت سرورهای قدرتمند در بين راه است. نام‌ اين نوع معماری هم در واقع بر گرفته شده از همین ارتباط مستقیم بين گره‌ها است. در واقع در اين نوع شبكه‌ها اثری از سرورها نيست و تمامی گره‌های معمولی موجود در شبكه، بايد وظايفی را که قبلا بر عهده‌ی سرورها بود، خود انجام دهند. بنابراين در اين نوع معماری گره‌های معمولی در ضمن اين‌که از خدمات شبکه بهره‌مند می‌شود بايد نقش خدمت‌گزار را هم ايفا کنند . در اين نوع شبکه‌ها گره‌های معمولی به كمك روش‌ها و پروتكل‌های توزيع شده، تمامی وظايف مسير يابی در شبكه، جستجوی منابع، امنيت شبكه و شناسايی هويت استفاده كننده‌ها و هم‌چنين مقابله با حملات احتمالی مهاجمان را بر عهده دارند.
+\footnote{این یک زیرنویس فارسی است.}\Footnote{This is an English footnote.}
+\begin{equation}
+(a+b)^3=a^3+3a^2b+3ab^2+b^3\label{eq-1}
+\end{equation}
+این معادلهٔ \eqref{eq-1} است.
+\columntitle{lines}{این را برای مهم یا نشان دادن حرفی مهم در این مجله انجام می‌دهیم.}
+
+ويژگی اصلی که اين معماری را متمايز کرده و در دنيای اينترنت آن‌ها در مقابل معماری قبلی شبكه‌ها قرار داده است، امكان ايجاد ارتباط مستقيم بين كامپيوترهای مختلف بدون نياز به دخالت سرورهای قدرتمند در بين راه است. نام‌ اين نوع معماری هم در واقع بر گرفته شده از همین ارتباط مستقیم بين گره‌ها است. در واقع در اين نوع شبكه‌ها اثری از سرورها نيست و تمامی گره‌های معمولی موجود در شبكه، بايد وظايفی را که قبلا بر عهده‌ی سرورها بود، خود انجام دهند. بنابراين در اين نوع معماری گره‌های معمولی در ضمن اين‌که از خدمات شبکه بهره‌مند می‌شود بايد نقش خدمت‌گزار را هم ايفا کنند . در اين نوع شبکه‌ها گره‌های معمولی به كمك روش‌ها و پروتكل‌های توزيع شده، تمامی وظايف مسير يابی در شبكه، جستجوی منابع، امنيت شبكه و شناسايی هويت استفاده كننده‌ها و هم‌چنين مقابله با حملات احتمالی مهاجمان را بر عهده دارند.
+
+اما معماری همتابه‌همتا ويژگی‌های ديگری نيز دارد که آن را هم برای فراهم‌کنندگان کاربردها و هم برای استفاده‌کنندگان جذاب‌تر می‌کند. از آن‌جا که شبکه‌های همتابه‌همتا از همان زيرساخت‌های اينترنت استفاده می‌کنند ونيازی به راه‌اندازی سرورها ندارند، ساخت اين شبكه‌ها بسيار ارزان‌تر از ايجاد زير ساخت‌های لازم برای راه‌اندازی شبكه‌های مشتری/خدمت‌گزار است. هم‌چنين با زياد شدن تعداد کاربران چون درعمل تعداد گره‌های ارائه کننده‌ی خدمات هم بالا می‌رود، نه تنها عملكرد شبكه افت پيدا نمی‌كند بلكه انتظار بهبود عملکرد نيز می‌رود. گذشته از اين موارد، مالكيت اين شبكه‌ها به صورت اشتراكی بين تمام کاربران پخش شده و هيچ شخص يا شركتی نمی‌تواند سياست‌های دلخواه خود را در اين نوع شبكه‌ها اعمال کند.
+
+اماهيچ چيزی بی‌ بها به دست نمی‌آید. نبود سرور مرکزی اگر چه ويژگی‌های جذابی به شبکه‌های همتابه‌همتا می‌بخشد اما از طرف ديگر آن‌ها را با دشواری‌هايی نيز روبه‌رو می‌کند. عدم وجود يك هماهنگ كننده مركزی در شبكه، انجام بسياری از امور و ارائه خدمات را دچار مشكل می‌کند. از يک طرف، تغيير و رفت‌وآمد زیاد کاربران از ويژگی‌های ذاتی اين شبکه‌ها است و از طرف ديگر در اين شبكه‌ها، ديگر اين گره‌های معمولی هستند كه عهده‌دار تمامی وظايف هستند. به همين دلیل يکی از مشکلات اصلی فراروی اين شبكه‌ها، مقابله با تغييرات لحظه‌ای و فراهم آوردن ثبات در ارائه خدمات در بستری از بی‌ثباتی است.
+\end{article}
+
+\articlesep
+
+\begin{article}{2}
+ {این تیتر این مقاله است.}
+ {این هم زیرتیتر این مقاله هست.}
+ {قسمت الف}
+ {1}
+\authorandplace{نام نویسنده}{مکان}
+
+\noindent\timestamp{08:25}
+ويژگی اصلی که اين معماری را متمايز کرده و در دنيای اينترنت آن‌ها در مقابل معماری قبلی شبكه‌ها قرار داده است، امكان ايجاد ارتباط مستقيم بين كامپيوترهای مختلف بدون نياز به دخالت سرورهای قدرتمند در بين راه است. نام‌ اين نوع معماری هم در واقع بر گرفته شده از همین ارتباط مستقیم بين گره‌ها است. در واقع در اين نوع شبكه‌ها اثری از سرورها نيست و تمامی گره‌های معمولی موجود در شبكه، بايد وظايفی را که قبلا بر عهده‌ی سرورها بود، خود انجام دهند. بنابراين در اين نوع معماری گره‌های معمولی در ضمن اين‌که از خدمات شبکه بهره‌مند می‌شود بايد نقش خدمت‌گزار را هم ايفا کنند . در اين نوع شبکه‌ها گره‌های معمولی به كمك روش‌ها و پروتكل‌های توزيع شده، تمامی وظايف مسير يابی در شبكه، جستجوی منابع، امنيت شبكه و شناسايی هويت استفاده كننده‌ها و هم‌چنين مقابله با حملات احتمالی مهاجمان را بر عهده دارند.
+\Footnote{This is an English footnote.}\footnote{این یک زیرنویس فارسی است.}
+اما معماری همتابه‌همتا ويژگی‌های ديگری نيز دارد که آن را هم برای فراهم‌کنندگان کاربردها و هم برای استفاده‌کنندگان جذاب‌تر می‌کند. از آن‌جا که شبکه‌های همتابه‌همتا از همان زيرساخت‌های اينترنت استفاده می‌کنند ونيازی به راه‌اندازی سرورها ندارند، ساخت اين شبكه‌ها بسيار ارزان‌تر از ايجاد زير ساخت‌های لازم برای راه‌اندازی شبكه‌های مشتری/خدمت‌گزار است. هم‌چنين با زياد شدن تعداد کاربران چون درعمل تعداد گره‌های ارائه کننده‌ی خدمات هم بالا می‌رود، نه تنها عملكرد شبكه افت پيدا نمی‌كند بلكه انتظار بهبود عملکرد نيز می‌رود. گذشته از اين موارد، مالكيت اين شبكه‌ها به صورت اشتراكی بين تمام کاربران پخش شده و هيچ شخص يا شركتی نمی‌تواند سياست‌های دلخواه خود را در اين نوع شبكه‌ها اعمال کند.
+
+اماهيچ چيزی بی‌ بها به دست نمی‌آید. نبود سرور مرکزی اگر چه ويژگی‌های جذابی به شبکه‌های همتابه‌همتا می‌بخشد اما از طرف ديگر آن‌ها را با دشواری‌هايی نيز روبه‌رو می‌کند. عدم وجود يك هماهنگ كننده مركزی در شبكه، انجام بسياری از امور و ارائه خدمات را دچار مشكل می‌کند. از يک طرف، تغيير و رفت‌وآمد زیاد کاربران از ويژگی‌های ذاتی اين شبکه‌ها است و از طرف ديگر در اين شبكه‌ها، ديگر اين گره‌های معمولی هستند كه عهده‌دار تمامی وظايف هستند. به همين دلیل يکی از مشکلات اصلی فراروی اين شبكه‌ها، مقابله با تغييرات لحظه‌ای و فراهم آوردن ثبات در ارائه خدمات در بستری از بی‌ثباتی است.
+
+ويژگی اصلی که اين معماری را متمايز کرده و در دنيای اينترنت آن‌ها در مقابل معماری قبلی شبكه‌ها قرار داده است، امكان ايجاد ارتباط مستقيم بين كامپيوترهای مختلف بدون نياز به دخالت سرورهای قدرتمند در بين راه است. نام‌ اين نوع معماری هم در واقع بر گرفته شده از همین ارتباط مستقیم بين گره‌ها است. در واقع در اين نوع شبكه‌ها اثری از سرورها نيست و تمامی گره‌های معمولی موجود در شبكه، بايد وظايفی را که قبلا بر عهده‌ی سرورها بود، خود انجام دهند. بنابراين در اين نوع معماری گره‌های معمولی در ضمن اين‌که از خدمات شبکه بهره‌مند می‌شود بايد نقش خدمت‌گزار را هم ايفا کنند . در اين نوع شبکه‌ها گره‌های معمولی به كمك روش‌ها و پروتكل‌های توزيع شده، تمامی وظايف مسير يابی در شبكه، جستجوی منابع، امنيت شبكه و شناسايی هويت استفاده كننده‌ها و هم‌چنين مقابله با حملات احتمالی مهاجمان را بر عهده دارند.
+
+اما معماری همتابه‌همتا ويژگی‌های ديگری نيز دارد که آن را هم برای فراهم‌کنندگان کاربردها و هم برای استفاده‌کنندگان جذاب‌تر می‌کند. از آن‌جا که شبکه‌های همتابه‌همتا از همان زيرساخت‌های اينترنت استفاده می‌کنند ونيازی به راه‌اندازی سرورها ندارند، ساخت اين شبكه‌ها بسيار ارزان‌تر از ايجاد زير ساخت‌های لازم برای راه‌اندازی شبكه‌های مشتری/خدمت‌گزار است. هم‌چنين با زياد شدن تعداد کاربران چون درعمل تعداد گره‌های ارائه کننده‌ی خدمات هم بالا می‌رود، نه تنها عملكرد شبكه افت پيدا نمی‌كند بلكه انتظار بهبود عملکرد نيز می‌رود. گذشته از اين موارد، مالكيت اين شبكه‌ها به صورت اشتراكی بين تمام کاربران پخش شده و هيچ شخص يا شركتی نمی‌تواند سياست‌های دلخواه خود را در اين نوع شبكه‌ها اعمال کند.
+
+اماهيچ چيزی بی‌ بها به دست نمی‌آید. نبود سرور مرکزی اگر چه ويژگی‌های جذابی به شبکه‌های همتابه‌همتا می‌بخشد اما از طرف ديگر آن‌ها را با دشواری‌هايی نيز روبه‌رو می‌کند. عدم وجود يك هماهنگ كننده مركزی در شبكه، انجام بسياری از امور و ارائه خدمات را دچار مشكل می‌کند. از يک طرف، تغيير و رفت‌وآمد زیاد کاربران از ويژگی‌های ذاتی اين شبکه‌ها است و از طرف ديگر در اين شبكه‌ها، ديگر اين گره‌های معمولی هستند كه عهده‌دار تمامی وظايف هستند. به همين دلیل يکی از مشکلات اصلی فراروی اين شبكه‌ها، مقابله با تغييرات لحظه‌ای و فراهم آوردن ثبات در ارائه خدمات در بستری از بی‌ثباتی است.
+
+\expandedtitle{doublebox}{این هم مطلی است مهم یا چیزی که از خلاصهٔ این مقاله ما متوجه شده‌ایم و این برای ما و خوانندگان خیلی مهم است.}
+
+ويژگی اصلی که اين معماری را متمايز کرده و در دنيای اينترنت آن‌ها در مقابل معماری قبلی شبكه‌ها قرار داده است، امكان ايجاد ارتباط مستقيم بين كامپيوترهای مختلف بدون نياز به دخالت سرورهای قدرتمند در بين راه است. نام‌ اين نوع معماری هم در واقع بر گرفته شده از همین ارتباط مستقیم بين گره‌ها است. در واقع در اين نوع شبكه‌ها اثری از سرورها نيست و تمامی گره‌های معمولی موجود در شبكه، بايد وظايفی را که قبلا بر عهده‌ی سرورها بود، خود انجام دهند. بنابراين در اين نوع معماری گره‌های معمولی در ضمن اين‌که از خدمات شبکه بهره‌مند می‌شود بايد نقش خدمت‌گزار را هم ايفا کنند . در اين نوع شبکه‌ها گره‌های معمولی به كمك روش‌ها و پروتكل‌های توزيع شده، تمامی وظايف مسير يابی در شبكه، جستجوی منابع، امنيت شبكه و شناسايی هويت استفاده كننده‌ها و هم‌چنين مقابله با حملات احتمالی مهاجمان را بر عهده دارند.
+
+اما معماری همتابه‌همتا ويژگی‌های ديگری نيز دارد که آن را هم برای فراهم‌کنندگان کاربردها و هم برای استفاده‌کنندگان جذاب‌تر می‌کند. از آن‌جا که شبکه‌های همتابه‌همتا از همان زيرساخت‌های اينترنت استفاده می‌کنند ونيازی به راه‌اندازی سرورها ندارند، ساخت اين شبكه‌ها بسيار ارزان‌تر از ايجاد زير ساخت‌های لازم برای راه‌اندازی شبكه‌های مشتری/خدمت‌گزار است. هم‌چنين با زياد شدن تعداد کاربران چون درعمل تعداد گره‌های ارائه کننده‌ی خدمات هم بالا می‌رود، نه تنها عملكرد شبكه افت پيدا نمی‌كند بلكه انتظار بهبود عملکرد نيز می‌رود. گذشته از اين موارد، مالكيت اين شبكه‌ها به صورت اشتراكی بين تمام کاربران پخش شده و هيچ شخص يا شركتی نمی‌تواند سياست‌های دلخواه خود را در اين نوع شبكه‌ها اعمال کند.
+
+اماهيچ چيزی بی‌ بها به دست نمی‌آید. نبود سرور مرکزی اگر چه ويژگی‌های جذابی به شبکه‌های همتابه‌همتا می‌بخشد اما از طرف ديگر آن‌ها را با دشواری‌هايی نيز روبه‌رو می‌کند. عدم وجود يك هماهنگ كننده مركزی در شبكه، انجام بسياری از امور و ارائه خدمات را دچار مشكل می‌کند. از يک طرف، تغيير و رفت‌وآمد زیاد کاربران از ويژگی‌های ذاتی اين شبکه‌ها است و از طرف ديگر در اين شبكه‌ها، ديگر اين گره‌های معمولی هستند كه عهده‌دار تمامی وظايف هستند. به همين دلیل يکی از مشکلات اصلی فراروی اين شبكه‌ها، مقابله با تغييرات لحظه‌ای و فراهم آوردن ثبات در ارائه خدمات در بستری از بی‌ثباتی است.
+\end{article}
+
+\articlesep
+
+\newsection{قسمت ب}
+
+
+\begin{article}{2}
+ {این یک تیتر کوتاه است.وفا خلیقی}
+ {این هم مثل همیشه زیرتیتر است که ما آن را در اینجا قرار می‌دهیم.}
+ {قسمت ب}
+ {3}
+
+\authorandplace{نام نویسنده}{مکان}
+
+
+
+\noindent\timestamp{08:25} et ويژگی اصلی که اين معماری را متمايز کرده و در دنيای اينترنت آن‌ها در مقابل معماری قبلی شبكه‌ها قرار داده است، امكان ايجاد ارتباط مستقيم بين كامپيوترهای مختلف بدون نياز به دخالت سرورهای قدرتمند در بين راه است. نام‌ اين نوع معماری هم در واقع بر گرفته شده از همین ارتباط مستقیم بين گره‌ها است. در واقع در اين نوع شبكه‌ها اثری از سرورها نيست و تمامی گره‌های معمولی موجود در شبكه، بايد وظايفی را که قبلا بر عهده‌ی سرورها بود، خود انجام دهند. بنابراين در اين نوع معماری گره‌های معمولی در ضمن اين‌که از خدمات شبکه بهره‌مند می‌شود بايد نقش خدمت‌گزار را هم ايفا کنند . در اين نوع شبکه‌ها گره‌های معمولی به كمك روش‌ها و پروتكل‌های توزيع شده، تمامی وظايف مسير يابی در شبكه، جستجوی منابع، امنيت شبكه و شناسايی هويت استفاده كننده‌ها و هم‌چنين مقابله با حملات احتمالی مهاجمان را بر عهده دارند.
+
+اما معماری همتابه‌همتا ويژگی‌های ديگری نيز دارد که آن را هم برای فراهم‌کنندگان کاربردها و هم برای استفاده‌کنندگان جذاب‌تر می‌کند. از آن‌جا که شبکه‌های همتابه‌همتا از همان زيرساخت‌های اينترنت استفاده می‌کنند ونيازی به راه‌اندازی سرورها ندارند، ساخت اين شبكه‌ها بسيار ارزان‌تر از ايجاد زير ساخت‌های لازم برای راه‌اندازی شبكه‌های مشتری/خدمت‌گزار است. هم‌چنين با زياد شدن تعداد کاربران چون درعمل تعداد گره‌های ارائه کننده‌ی خدمات هم بالا می‌رود، نه تنها عملكرد شبكه افت پيدا نمی‌كند بلكه انتظار بهبود عملکرد نيز می‌رود. گذشته از اين موارد، مالكيت اين شبكه‌ها به صورت اشتراكی بين تمام کاربران پخش شده و هيچ شخص يا شركتی نمی‌تواند سياست‌های دلخواه خود را در اين نوع شبكه‌ها اعمال کند.
+
+اماهيچ چيزی بی‌ بها به دست نمی‌آید. نبود سرور مرکزی اگر چه ويژگی‌های جذابی به شبکه‌های همتابه‌همتا می‌بخشد اما از طرف ديگر آن‌ها را با دشواری‌هايی نيز روبه‌رو می‌کند. عدم وجود يك هماهنگ كننده مركزی در شبكه، انجام بسياری از امور و ارائه خدمات را دچار مشكل می‌کند. از يک طرف، تغيير و رفت‌وآمد زیاد کاربران از ويژگی‌های ذاتی اين شبکه‌ها است و از طرف ديگر در اين شبكه‌ها، ديگر اين گره‌های معمولی هستند كه عهده‌دار تمامی وظايف هستند. به همين دلیل يکی از مشکلات اصلی فراروی اين شبكه‌ها، مقابله با تغييرات لحظه‌ای و فراهم آوردن ثبات در ارائه خدمات در بستری از بی‌ثباتی است.
+
+ويژگی اصلی که اين معماری را متمايز کرده و در دنيای اينترنت آن‌ها در مقابل معماری قبلی شبكه‌ها قرار داده است، امكان ايجاد ارتباط مستقيم بين كامپيوترهای مختلف بدون نياز به دخالت سرورهای قدرتمند در بين راه است. نام‌ اين نوع معماری هم در واقع بر گرفته شده از همین ارتباط مستقیم بين گره‌ها است. در واقع در اين نوع شبكه‌ها اثری از سرورها نيست و تمامی گره‌های معمولی موجود در شبكه، بايد وظايفی را که قبلا بر عهده‌ی سرورها بود، خود انجام دهند. بنابراين در اين نوع معماری گره‌های معمولی در ضمن اين‌که از خدمات شبکه بهره‌مند می‌شود بايد نقش خدمت‌گزار را هم ايفا کنند . در اين نوع شبکه‌ها گره‌های معمولی به كمك روش‌ها و پروتكل‌های توزيع شده، تمامی وظايف مسير يابی در شبكه، جستجوی منابع، امنيت شبكه و شناسايی هويت استفاده كننده‌ها و هم‌چنين مقابله با حملات احتمالی مهاجمان را بر عهده دارند.
+
+اما معماری همتابه‌همتا ويژگی‌های ديگری نيز دارد که آن را هم برای فراهم‌کنندگان کاربردها و هم برای استفاده‌کنندگان جذاب‌تر می‌کند. از آن‌جا که شبکه‌های همتابه‌همتا از همان زيرساخت‌های اينترنت استفاده می‌کنند ونيازی به راه‌اندازی سرورها ندارند، ساخت اين شبكه‌ها بسيار ارزان‌تر از ايجاد زير ساخت‌های لازم برای راه‌اندازی شبكه‌های مشتری/خدمت‌گزار است. هم‌چنين با زياد شدن تعداد کاربران چون درعمل تعداد گره‌های ارائه کننده‌ی خدمات هم بالا می‌رود، نه تنها عملكرد شبكه افت پيدا نمی‌كند بلكه انتظار بهبود عملکرد نيز می‌رود. گذشته از اين موارد، مالكيت اين شبكه‌ها به صورت اشتراكی بين تمام کاربران پخش شده و هيچ شخص يا شركتی نمی‌تواند سياست‌های دلخواه خود را در اين نوع شبكه‌ها اعمال کند.
+
+اماهيچ چيزی بی‌ بها به دست نمی‌آید. نبود سرور مرکزی اگر چه ويژگی‌های جذابی به شبکه‌های همتابه‌همتا می‌بخشد اما از طرف ديگر آن‌ها را با دشواری‌هايی نيز روبه‌رو می‌کند. عدم وجود يك هماهنگ كننده مركزی در شبكه، انجام بسياری از امور و ارائه خدمات را دچار مشكل می‌کند. از يک طرف، تغيير و رفت‌وآمد زیاد کاربران از ويژگی‌های ذاتی اين شبکه‌ها است و از طرف ديگر در اين شبكه‌ها، ديگر اين گره‌های معمولی هستند كه عهده‌دار تمامی وظايف هستند. به همين دلیل يکی از مشکلات اصلی فراروی اين شبكه‌ها، مقابله با تغييرات لحظه‌ای و فراهم آوردن ثبات در ارائه خدمات در بستری از بی‌ثباتی است.
+
+\expandedtitle{lines}{این هم دوباره مطلب مهمی است که ما آن را از لابلای این مقاله برای خواننده درست کرده‌ایم.}
+
+ويژگی اصلی که اين معماری را متمايز کرده و در دنيای اينترنت آن‌ها در مقابل معماری قبلی شبكه‌ها قرار داده است، امكان ايجاد ارتباط مستقيم بين كامپيوترهای مختلف بدون نياز به دخالت سرورهای قدرتمند در بين راه است. نام‌ اين نوع معماری هم در واقع بر گرفته شده از همین ارتباط مستقیم بين گره‌ها است. در واقع در اين نوع شبكه‌ها اثری از سرورها نيست و تمامی گره‌های معمولی موجود در شبكه، بايد وظايفی را که قبلا بر عهده‌ی سرورها بود، خود انجام دهند. بنابراين در اين نوع معماری گره‌های معمولی در ضمن اين‌که از خدمات شبکه بهره‌مند می‌شود بايد نقش خدمت‌گزار را هم ايفا کنند . در اين نوع شبکه‌ها گره‌های معمولی به كمك روش‌ها و پروتكل‌های توزيع شده، تمامی وظايف مسير يابی در شبكه، جستجوی منابع، امنيت شبكه و شناسايی هويت استفاده كننده‌ها و هم‌چنين مقابله با حملات احتمالی مهاجمان را بر عهده دارند.
+
+اما معماری همتابه‌همتا ويژگی‌های ديگری نيز دارد که آن را هم برای فراهم‌کنندگان کاربردها و هم برای استفاده‌کنندگان جذاب‌تر می‌کند. از آن‌جا که شبکه‌های همتابه‌همتا از همان زيرساخت‌های اينترنت استفاده می‌کنند ونيازی به راه‌اندازی سرورها ندارند، ساخت اين شبكه‌ها بسيار ارزان‌تر از ايجاد زير ساخت‌های لازم برای راه‌اندازی شبكه‌های مشتری/خدمت‌گزار است. هم‌چنين با زياد شدن تعداد کاربران چون درعمل تعداد گره‌های ارائه کننده‌ی خدمات هم بالا می‌رود، نه تنها عملكرد شبكه افت پيدا نمی‌كند بلكه انتظار بهبود عملکرد نيز می‌رود. گذشته از اين موارد، مالكيت اين شبكه‌ها به صورت اشتراكی بين تمام کاربران پخش شده و هيچ شخص يا شركتی نمی‌تواند سياست‌های دلخواه خود را در اين نوع شبكه‌ها اعمال کند.
+
+اماهيچ چيزی بی‌ بها به دست نمی‌آید. نبود سرور مرکزی اگر چه ويژگی‌های جذابی به شبکه‌های همتابه‌همتا می‌بخشد اما از طرف ديگر آن‌ها را با دشواری‌هايی نيز روبه‌رو می‌کند. عدم وجود يك هماهنگ كننده مركزی در شبكه، انجام بسياری از امور و ارائه خدمات را دچار مشكل می‌کند. از يک طرف، تغيير و رفت‌وآمد زیاد کاربران از ويژگی‌های ذاتی اين شبکه‌ها است و از طرف ديگر در اين شبكه‌ها، ديگر اين گره‌های معمولی هستند كه عهده‌دار تمامی وظايف هستند. به همين دلیل يکی از مشکلات اصلی فراروی اين شبكه‌ها، مقابله با تغييرات لحظه‌ای و فراهم آوردن ثبات در ارائه خدمات در بستری از بی‌ثباتی است.
+\end{article}
+
+\articlesep
+
+
+\begin{editorial}{1}{این یک مثال از مقاله‌ای از طرف ویرایشگر است.}{نام و نام خانوادگی}{4}
+يژگی اصلی که اين معماری را متمايز کرده و در دنيای اينترنت آن‌ها در مقابل معماری قبلی شبكه‌ها قرار داده است، امكان ايجاد ارتباط مستقيم بين كامپيوترهای مختلف بدون نياز به دخالت سرورهای قدرتمند در بين راه است. نام‌ اين نوع معماری هم در واقع بر گرفته شده از همین ارتباط مستقیم بين گره‌ها است. در واقع در اين نوع شبكه‌ها اثری از سرورها نيست و تمامی گره‌های معمولی موجود در شبكه، بايد وظايفی را که قبلا بر عهده‌ی سرورها بود، خود انجام دهند. بنابراين در اين نوع معماری گره‌های معمولی در ضمن اين‌که از خدمات شبکه بهره‌مند می‌شود بايد نقش خدمت‌گزار را هم ايفا کنند . در اين نوع شبکه‌ها گره‌های معمولی به كمك روش‌ها و پروتكل‌های توزيع شده، تمامی وظايف مسير يابی در شبكه، جستجوی منابع، امنيت شبكه و شناسايی هويت استفاده كننده‌ها و هم‌چنين مقابله با حملات احتمالی مهاجمان را بر عهده دارند.
+
+اما معماری همتابه‌همتا ويژگی‌های ديگری نيز دارد که آن را هم برای فراهم‌کنندگان کاربردها و هم برای استفاده‌کنندگان جذاب‌تر می‌کند. از آن‌جا که شبکه‌های همتابه‌همتا از همان زيرساخت‌های اينترنت استفاده می‌کنند ونيازی به راه‌اندازی سرورها ندارند، ساخت اين شبكه‌ها بسيار ارزان‌تر از ايجاد زير ساخت‌های لازم برای راه‌اندازی شبكه‌های مشتری/خدمت‌گزار است. هم‌چنين با زياد شدن تعداد کاربران چون درعمل تعداد گره‌های ارائه کننده‌ی خدمات هم بالا می‌رود، نه تنها عملكرد شبكه افت پيدا نمی‌كند بلكه انتظار بهبود عملکرد نيز می‌رود. گذشته از اين موارد، مالكيت اين شبكه‌ها به صورت اشتراكی بين تمام کاربران پخش شده و هيچ شخص يا شركتی نمی‌تواند سياست‌های دلخواه خود را در اين نوع شبكه‌ها اعمال کند.
+
+اماهيچ چيزی بی‌ بها به دست نمی‌آید. نبود سرور مرکزی اگر چه ويژگی‌های جذابی به شبکه‌های همتابه‌همتا می‌بخشد اما از طرف ديگر آن‌ها را با دشواری‌هايی نيز روبه‌رو می‌کند. عدم وجود يك هماهنگ كننده مركزی در شبكه، انجام بسياری از امور و ارائه خدمات را دچار مشكل می‌کند. از يک طرف، تغيير و رفت‌وآمد زیاد کاربران از ويژگی‌های ذاتی اين شبکه‌ها است و از طرف ديگر در اين شبكه‌ها، ديگر اين گره‌های معمولی هستند كه عهده‌دار تمامی وظايف هستند. به همين دلیل يکی از مشکلات اصلی فراروی اين شبكه‌ها، مقابله با تغييرات لحظه‌ای و فراهم آوردن ثبات در ارائه خدمات در بستری از بی‌ثباتی است.
+\end{editorial}
+
+\articlesep
+
+
+\begin{shortarticle}{4}{محیط مقالهٔ کوتاه}{محیط مقالهٔ کوتاه داخل مجلهٔ زی‌پرشین}{5}
+\shortarticleitem{این یک تیتر کوتاه است}{ويژگی اصلی که اين معماری را متمايز کرده و در دنيای اينترنت آن‌ها در مقابل معماری قبلی شبكه‌ها قرار داده است، امكان ايجاد ارتباط مستقيم بين كامپيوترهای مختلف بدون نياز به دخالت سرورهای قدرتمند در بين راه است. نام‌ اين نوع معماری هم در واقع بر گرفته شده از همین ارتباط مستقیم بين گره‌ها است. در واقع در اين نوع شبكه‌ها اثری از سرورها نيست و تمامی گره‌های معمولی موجود در شبكه، بايد وظايفی را که قبلا بر عهده‌ی سرورها بود، خود انجام دهند. بنابراين در اين نوع معماری گره‌های معمولی در ضمن اين‌که از خدمات شبکه بهره‌مند می‌شود بايد نقش خدمت‌گزار را هم ايفا کنند . در اين نوع شبکه‌ها گره‌های معمولی به كمك روش‌ها و پروتكل‌های توزيع شده، تمامی وظايف مسير يابی در شبكه، جستجوی منابع، امنيت شبكه و شناسايی هويت استفاده كننده‌ها و هم‌چنين مقابله با حملات احتمالی مهاجمان را بر عهده دارند.}
+\shortarticleitem{یک تیتر کوتاه دیگر}{ويژگی اصلی که اين معماری را متمايز کرده و در دنيای اينترنت آن‌ها در مقابل معماری قبلی شبكه‌ها قرار داده است، امكان ايجاد ارتباط مستقيم بين كامپيوترهای مختلف بدون نياز به دخالت سرورهای قدرتمند در بين راه است. نام‌ اين نوع معماری هم در واقع بر گرفته شده از همین ارتباط مستقیم بين گره‌ها است. در واقع در اين نوع شبكه‌ها اثری از سرورها نيست و تمامی گره‌های معمولی موجود در شبكه، بايد وظايفی را که قبلا بر عهده‌ی سرورها بود، خود انجام دهند. بنابراين در اين نوع معماری گره‌های معمولی در ضمن اين‌که از خدمات شبکه بهره‌مند می‌شود بايد نقش خدمت‌گزار را هم ايفا کنند . در اين نوع شبکه‌ها گره‌های معمولی به كمك روش‌ها و پروتكل‌های توزيع شده، تمامی وظايف مسير يابی در شبكه، جستجوی منابع، امنيت شبكه و شناسايی هويت استفاده كننده‌ها و هم‌چنين مقابله با حملات احتمالی مهاجمان را بر عهده دارند.}
+\shortarticleitem{یک تیتر کوتاه دیگر}{ويژگی اصلی که اين معماری را متمايز کرده و در دنيای اينترنت آن‌ها در مقابل معماری قبلی شبكه‌ها قرار داده است، امكان ايجاد ارتباط مستقيم بين كامپيوترهای مختلف بدون نياز به دخالت سرورهای قدرتمند در بين راه است. نام‌ اين نوع معماری هم در واقع بر گرفته شده از همین ارتباط مستقیم بين گره‌ها است. در واقع در اين نوع شبكه‌ها اثری از سرورها نيست و تمامی گره‌های معمولی موجود در شبكه، بايد وظايفی را که قبلا بر عهده‌ی سرورها بود، خود انجام دهند. بنابراين در اين نوع معماری گره‌های معمولی در ضمن اين‌که از خدمات شبکه بهره‌مند می‌شود بايد نقش خدمت‌گزار را هم ايفا کنند . در اين نوع شبکه‌ها گره‌های معمولی به كمك روش‌ها و پروتكل‌های توزيع شده، تمامی وظايف مسير يابی در شبكه، جستجوی منابع، امنيت شبكه و شناسايی هويت استفاده كننده‌ها و هم‌چنين مقابله با حملات احتمالی مهاجمان را بر عهده دارند.}
+\shortarticleitem{یک تیتر کوتاه دیگر}{ويژگی اصلی که اين معماری را متمايز کرده و در دنيای اينترنت آن‌ها در مقابل معماری قبلی شبكه‌ها قرار داده است، امكان ايجاد ارتباط مستقيم بين كامپيوترهای مختلف بدون نياز به دخالت سرورهای قدرتمند در بين راه است. نام‌ اين نوع معماری هم در واقع بر گرفته شده از همین ارتباط مستقیم بين گره‌ها است. در واقع در اين نوع شبكه‌ها اثری از سرورها نيست و تمامی گره‌های معمولی موجود در شبكه، بايد وظايفی را که قبلا بر عهده‌ی سرورها بود، خود انجام دهند. بنابراين در اين نوع معماری گره‌های معمولی در ضمن اين‌که از خدمات شبکه بهره‌مند می‌شود بايد نقش خدمت‌گزار را هم ايفا کنند . در اين نوع شبکه‌ها گره‌های معمولی به كمك روش‌ها و پروتكل‌های توزيع شده، تمامی وظايف مسير يابی در شبكه، جستجوی منابع، امنيت شبكه و شناسايی هويت استفاده كننده‌ها و هم‌چنين مقابله با حملات احتمالی مهاجمان را بر عهده دارند.}
+\shortarticleitem{یک تیتر کوتاه دیگر}{ويژگی اصلی که اين معماری را متمايز کرده و در دنيای اينترنت آن‌ها در مقابل معماری قبلی شبكه‌ها قرار داده است، امكان ايجاد ارتباط مستقيم بين كامپيوترهای مختلف بدون نياز به دخالت سرورهای قدرتمند در بين راه است. نام‌ اين نوع معماری هم در واقع بر گرفته شده از همین ارتباط مستقیم بين گره‌ها است. در واقع در اين نوع شبكه‌ها اثری از سرورها نيست و تمامی گره‌های معمولی موجود در شبكه، بايد وظايفی را که قبلا بر عهده‌ی سرورها بود، خود انجام دهند. بنابراين در اين نوع معماری گره‌های معمولی در ضمن اين‌که از خدمات شبکه بهره‌مند می‌شود بايد نقش خدمت‌گزار را هم ايفا کنند . در اين نوع شبکه‌ها گره‌های معمولی به كمك روش‌ها و پروتكل‌های توزيع شده، تمامی وظايف مسير يابی در شبكه، جستجوی منابع، امنيت شبكه و شناسايی هويت استفاده كننده‌ها و هم‌چنين مقابله با حملات احتمالی مهاجمان را بر عهده دارند.}
+\shortarticleitem{یک تیتر کوتاه دیگر}{ويژگی اصلی که اين معماری را متمايز کرده و در دنيای اينترنت آن‌ها در مقابل معماری قبلی شبكه‌ها قرار داده است، امكان ايجاد ارتباط مستقيم بين كامپيوترهای مختلف بدون نياز به دخالت سرورهای قدرتمند در بين راه است. نام‌ اين نوع معماری هم در واقع بر گرفته شده از همین ارتباط مستقیم بين گره‌ها است. در واقع در اين نوع شبكه‌ها اثری از سرورها نيست و تمامی گره‌های معمولی موجود در شبكه، بايد وظايفی را که قبلا بر عهده‌ی سرورها بود، خود انجام دهند. بنابراين در اين نوع معماری گره‌های معمولی در ضمن اين‌که از خدمات شبکه بهره‌مند می‌شود بايد نقش خدمت‌گزار را هم ايفا کنند . در اين نوع شبکه‌ها گره‌های معمولی به كمك روش‌ها و پروتكل‌های توزيع شده، تمامی وظايف مسير يابی در شبكه، جستجوی منابع، امنيت شبكه و شناسايی هويت استفاده كننده‌ها و هم‌چنين مقابله با حملات احتمالی مهاجمان را بر عهده دارند.}
+\end{shortarticle}
+
+\articlesep
+
+\end{document}
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/notepad0.PNG b/Master/texmf-dist/doc/xelatex/xepersian/notepad0.PNG
deleted file mode 100644
index b8058e379d7..00000000000
--- a/Master/texmf-dist/doc/xelatex/xepersian/notepad0.PNG
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/notepad1.PNG b/Master/texmf-dist/doc/xelatex/xepersian/notepad1.PNG
index 09cd1992404..fa4280a0541 100644
--- a/Master/texmf-dist/doc/xelatex/xepersian/notepad1.PNG
+++ b/Master/texmf-dist/doc/xelatex/xepersian/notepad1.PNG
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/notepad2.PNG b/Master/texmf-dist/doc/xelatex/xepersian/notepad2.PNG
index 296bf2b7e4d..2ca989ee4c6 100644
--- a/Master/texmf-dist/doc/xelatex/xepersian/notepad2.PNG
+++ b/Master/texmf-dist/doc/xelatex/xepersian/notepad2.PNG
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/notepad3.PNG b/Master/texmf-dist/doc/xelatex/xepersian/notepad3.PNG
index be72edccb8a..4caff0cd76f 100644
--- a/Master/texmf-dist/doc/xelatex/xepersian/notepad3.PNG
+++ b/Master/texmf-dist/doc/xelatex/xepersian/notepad3.PNG
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/notepad4.PNG b/Master/texmf-dist/doc/xelatex/xepersian/notepad4.PNG
index 95cf788b955..93eee3981c3 100644
--- a/Master/texmf-dist/doc/xelatex/xepersian/notepad4.PNG
+++ b/Master/texmf-dist/doc/xelatex/xepersian/notepad4.PNG
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/notepad5.PNG b/Master/texmf-dist/doc/xelatex/xepersian/notepad5.PNG
new file mode 100644
index 00000000000..966cbd4c731
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/notepad5.PNG
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/notepad6.PNG b/Master/texmf-dist/doc/xelatex/xepersian/notepad6.PNG
new file mode 100644
index 00000000000..117aa7e25ec
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/notepad6.PNG
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/notepad7.PNG b/Master/texmf-dist/doc/xelatex/xepersian/notepad7.PNG
new file mode 100644
index 00000000000..edd4d880f0c
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/notepad7.PNG
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/notepad8.PNG b/Master/texmf-dist/doc/xelatex/xepersian/notepad8.PNG
new file mode 100644
index 00000000000..af28f12a113
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/notepad8.PNG
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/notepad9.PNG b/Master/texmf-dist/doc/xelatex/xepersian/notepad9.PNG
new file mode 100644
index 00000000000..6d252b5f2bc
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/notepad9.PNG
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/farsi.xdy b/Master/texmf-dist/doc/xelatex/xepersian/persian.xdy
index 548d939286d..548d939286d 100644
--- a/Master/texmf-dist/doc/xelatex/xepersian/farsi.xdy
+++ b/Master/texmf-dist/doc/xelatex/xepersian/persian.xdy
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/presentation-sample.pdf b/Master/texmf-dist/doc/xelatex/xepersian/presentation-sample.pdf
new file mode 100644
index 00000000000..756b9b0aac7
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/presentation-sample.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/presentation-sample.tex b/Master/texmf-dist/doc/xelatex/xepersian/presentation-sample.tex
new file mode 100644
index 00000000000..9632d6ba3e7
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/presentation-sample.tex
@@ -0,0 +1,53 @@
+\documentclass[12pt,twoside]{xepersian-presentation}
+\usepackage{eso-pic}
+\usepackage{xepersian}
+\settextfont[Scale=1]{XB Zar}
+\setromantextfont[Scale=1]{Linux Libertine}
+\setdigitfont[Scale=1]{XB Zar}
+\pagestyle{pres}
+\AddToShipoutPicture{
+\includegraphics{gradient2.png}
+}
+
+\begin{document}
+\begin{titlepage}
+\distance{1}
+\centering \LARGE
+ \bfseries عنوان اسلاید
+
+\distance{1}
+\large
+وفا خلیقی\\[1ex]نام دانشگاه
+\distance{2}
+\end{titlepage}
+
+\begin{plainslide}[این عنوان یک صفحه است.]
+این اولین صفحه اسلاید ما است که من در حال نوشتن آن هستم و کمی بیشتر می‌نویسم تا به خط بعدی بروم
+\footnote{این یک زیرنویس فارسی است.}\Footnote{This is an English footnote.}
+\begin{equation}
+(a+b)^2=a^2+2ab+b^2
+\end{equation}
+\begin{itemize}
+ \item یک
+ \item دو
+\end{itemize}
+
+\begin{enumerate}
+ \item یک
+ \item دو
+\end{enumerate}
+
+\begin{description}
+ \item [یک:] اولین عدد
+ \item [دو:] دومین عدد
+\end{description}
+
+\end{plainslide}
+\begin{rawslide}
+دومین صفحه
+
+\end{rawslide}
+
+\end{document}
+
+
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/rain.jpg b/Master/texmf-dist/doc/xelatex/xepersian/rain.jpg
new file mode 100644
index 00000000000..f33b75e7a0c
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/rain.jpg
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/sumatrapdf1.PNG b/Master/texmf-dist/doc/xelatex/xepersian/sumatrapdf1.PNG
new file mode 100644
index 00000000000..de1339c964c
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/sumatrapdf1.PNG
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/sumatrapdf2.PNG b/Master/texmf-dist/doc/xelatex/xepersian/sumatrapdf2.PNG
new file mode 100644
index 00000000000..ecee69220c3
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/sumatrapdf2.PNG
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/sun.jpg b/Master/texmf-dist/doc/xelatex/xepersian/sun.jpg
new file mode 100644
index 00000000000..1e823100386
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/sun.jpg
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/thesis-sample.tex b/Master/texmf-dist/doc/xelatex/xepersian/thesis-sample.tex
new file mode 100644
index 00000000000..ea9b50a224e
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/thesis-sample.tex
@@ -0,0 +1,66 @@
+\documentclass[a4paper,11pt]{xepersian-thesis}
+\usepackage{xepersian}
+\settextfont[Scale=1]{XB Zar}
+\setromantextfont[Scale=1]{Linux Libertine}
+\setdigitfont[Scale=1]{XB Zar}
+
+
+
+
+\begin{document}
+\title{اعداد مرکب}
+\author{وفا خلیقی}
+\degree{کارشناسی ریاضیات محض}
+\supervisor{محمد قدسی}
+\department{ریاضی}
+\university{تهران}
+\city{تهران}
+\thesisdate{\today}
+\maketitle
+\begin{acknowledgementpage}
+در اینجا دوست دارم از همه تشکر کنم
+\end{acknowledgementpage}
+\begin{abstractpage}
+اینجا هم باید مطلبی نوشت...
+\keywords{ریاضی محض، هندسه و توپولوژی}
+\end{abstractpage}
+\tableofcontents
+\listoftables
+\chapter{مجموعه اعداد}
+در اینجا لازم می‌دانم تا نگاهی روی مجموعهٔ اعداد اندازیم تا متوجه خصلت‌های آن شویم
+\begin{equation}
+(a+b)^2=a^2+2ab+b^3
+\end{equation}
+\newpage
+این صفحهٔ جدید است که ما در این صفحه به نوشتن مقالات دیگری مشغول هستیم.
+\section{مقدمه}
+
+\newpage
+این هم یک صفحهٔ جدید دیگر
+\chapter{دوم}
+\chapter{سوم}
+\appendix
+\chapter{اول}
+\chapter{دوم}
+\chapter{سوم}
+\bibliographystyle{unsrt}
+\begin{thebibliography}{99}
+\end{thebibliography}
+%\printindex
+\begin{roman}
+\romantitle{Pure Mathematics}
+\romanauthor{Vafa Khalighi}
+\romandegree{Bachelor of Pure Mathematics}
+\romanthesisdate{\romantoday}
+\romansupervisor{Mohammad Ghodsi}
+\romandepartment{Computer Science}
+\romanuniversity{Iran University of Science \& Technology}
+\romancity{Tehran}
+\begin{romanabstract}
+\noindent This is our abstract written in English and This thesis is written very very very carefully so that we can keep an eye on the beauty of typesetting.
+\romankeywords{Mathematics, topology, geometry and category theory.}
+\end{romanabstract}
+\makeromantitle
+\end{roman}
+\end{document}
+
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/userguide-persian.pdf b/Master/texmf-dist/doc/xelatex/xepersian/userguide-persian.pdf
new file mode 100644
index 00000000000..d732dd86730
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/userguide-persian.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/userguide-persian.tex b/Master/texmf-dist/doc/xelatex/xepersian/userguide-persian.tex
new file mode 100644
index 00000000000..34557f35426
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/userguide-persian.tex
@@ -0,0 +1,662 @@
+\documentclass{article}
+\makeatletter
+\renewcommand*\l@section{\@dottedtocline{2}{.5em}{2.3em}}
+\renewcommand*\l@subsection{\@dottedtocline{2}{2.7em}{2.3em}}
+\makeatother
+\addtolength{\textwidth}{5cm}
+\addtolength{\hoffset}{-2.5cm}
+\addtolength{\voffset}{-1cm}
+\addtolength{\textheight}{2.5cm}
+%\usepackage{pdfsync}
+\usepackage{fancyhdr}
+\pagestyle{fancy}
+% with this we ensure that the chapter and section
+% headings are in lowercase.
+% \renewcommand{\chaptermark}[1]{%
+% \markboth{#1}{}}
+\renewcommand{\sectionmark}[1]{%
+ \markright{\thesection\ #1}}
+\fancyhf{} % delete current header and footer
+\fancyhead[LO,RE]{\bfseries\thepage}
+%\fancyhead[RO]{\bfseries\rightmark}
+\fancyhead[LE,RO]{\bfseries\rightmark}
+\renewcommand{\headrulewidth}{0.5pt}
+\renewcommand{\footrulewidth}{0pt}
+\addtolength{\headheight}{0.5pt} % space for the rule
+\fancypagestyle{plain}{%
+ \fancyhead{} % get rid of headers on plain pages
+ \renewcommand{\headrulewidth}{0pt} % and the line
+}
+\usepackage{pstricks}
+\usepackage{animate}
+\usepackage{pstricks-add}
+\usepackage{multido}
+\usepackage{color}
+\definecolor{myblue}{rgb}{0.02,0.04,0.48}
+\definecolor{lightblue}{rgb}{0.61,.8,.8}
+\definecolor{myred}{rgb}{0.65,0.04,0.07}
+\definecolor{lightgray}{gray}{0.6}
+\definecolor{mygreen}{rgb}{0,.43,0}
+\usepackage{fancybox}
+\usepackage{fancyvrb}
+\usepackage{setspace}
+\usepackage{perpage}
+\usepackage{persianpoem}
+\newenvironment{myverb}{\begin{Verbatim}[frame=single,numbers=left,framerule=1mm,rulecolor=\color{red},fillcolor=\color{yellow},framesep=3mm,showspaces=true,commandchars=+\[\]]}{\end{Verbatim}}
+\usepackage{xepersian}
+\settextfont[Scale=1.2]{XB Zar}
+\setdigitfont[Scale=1.2]{XB Zar}
+\setromantextfont[Scale=1.2]{Linux Libertine}
+\defpersianfont\nastaliq[Scale=1.8]{IranNastaliq}
+\defromanfont\linlib[Scale=1.5]{Linux Libertine}
+%\addtolength{\hoffset}{-2cm}
+%\addtolength{\textwidth}{3cm}
+\newcommand{\textblue}[1]{{\addfontfeature{Color=0000FF}#1}}
+\numberwithin{equation}{section}
+\numberwithin{table}{section}
+\onehalfspacing
+\newcommand\femph[1]{«#1»}
+\frenchspacing
+\newcommand\LRcite[1]{\LR{\rmfamily{\cite{#1}}}}
+
+
+\begin{document}
+
+\thispagestyle{empty}
+
+\noindent
+\begin{LTR}
+\begin{pspicture}(0,13.5)(\linewidth,0)
+ \psline[linewidth=3mm,linecolor=mygreen](0,13.5)(\linewidth,13.5)
+ \rput(\linewidth,13.5)
+ {\pspolygon*(-3.6,0)(-1.4,0)(0,-1.4)(0,-3.6)}
+ \rput(\linewidth,13.5)
+ {\rput{-45}(-1,-1){\Large\textbf{\white \rl{نسخهٔ}}}}
+ \rput(\linewidth,13.5)
+ {\rput{-45}(-1.5,-1.5){\Large\textbf{\white \rl{۰/۱۶۳}}}}
+
+ \rput[l](13,3.7){\textsl{\huge \rl{راهنمای بستهٔ}}}
+ \psline[linewidth=3mm,linecolor=myred](0,3)(\linewidth,3)
+ \psline[linewidth=3mm,linecolor=myred](0,0)(\linewidth,0)
+ \rput[b](0.5\linewidth,5)
+ {\includegraphics[height=0.3\textheight]{iran.jpg}}
+ \rput[l](0,1.5){\psscaleboxto(\textwidth,2){\rl{زی‌پرشین}}}
+
+\end{pspicture}
+\end{LTR}
+
+\vfill\noindent
+{{\huge \textbf{گروه فارسی‌--لاتک}} \hfill
+{\large\textsl{وفا خلیقی، مهدی امیدعلی، و مصطفی واحدی}}}
+\newpage
+\pagenumbering{harfi}
+\section*{مقدمه}
+\newpage
+\tableofcontents
+\newpage
+\listoftables
+\newpage
+\listoffigures
+\newpage
+\pagenumbering{persian}
+\pagestyle{fancy}
+
+\section{نمونهٔ فایل ورودی}
+ یک نمونه فایل ورودی می‌تواند به صورت زیر باشد.
+
+
+\begin{Verbatim}[frame=single,numbers=left,framerule=1mm,rulecolor=\color{red},fillcolor=\color{yellow},framesep=3mm,showspaces=true,commandchars=+\(\)]
++color(myblue)\documentclass{book}
++color(lightblue)\usepackage{xepersian}
++color(myred)\settextfont[Scale=1]{XB Zar}
++color(myred)\setromantextfont[Scale=1]{Junicode}
++color(myred)\setdigitfont[Scale=1]{XB Zar}
++color(mygreen)\title{+rl(عنوان نوشتار)}
++color(mygreen)\author{+rl(نام نویسنده)}
++color(lightgray)\begin{document}
+\maketitle
+\tableofcontents
+\chapter{+rl(فصل اول)}
+\section{+rl(بخش اول)}
+...
++color(lightgray)\end{document}
+\end{Verbatim}
+
+همانطور که می‌بینید شکل فایل ورودی هیچ‌گونه تفاوتی با یک فایل استاندارد لاتک ندارد. تنها ممکن است فرمانهای خط سوم، چهارم، و پنجم این فایل نمونه برای شما
+نا آشنا باشند که در قسمتهای بعد به توضیح آنها می‌پردازیم. به طور کلی در استفاده از طبقه‌های استاندارد لاتک به جز فراخوانی بستهٔ \lr{\XePersian} هیچ
+کار اضافه‌ای لازم نیست که انجام دهید. تنها به عنوان یک توصیه، سعی کنید
+
+\centerline{\shadowbox{\nastaliq\textblue{
+ این بسته آخرین بسته‌ای باشد که فراخوانی می‌کنید و فرمان‌های خود را بعد از فراخوانی این بسته قرار دهید.}} }
+
+همچنین توجه داشته باشید که
+بسته‌های زیر به طور خودکار فراخوانی می‌شوند و شما نباید آنها را مستقیماً در فایل فراخوانی کنید.
+
+\centerline{\shadowbox{\lr{amsmath, amssymb, amsthm, graphicx.}}}
+
+همچنین بسته \lr{\XePersian} هنوز قابلیت استفاده از طبقهٔ \lr{memoir} را ندارد، ولی در آینده این امکان نیز افزوده خواهد شد.
+\section{فرمانهای بسته}
+در این قسمت تعدادی از فرمانهای مفید را که لازم است بدانید شرح می‌دهیم. در جدول \ref{commands} فرمانهای بسته را مشاهده
+می‌کنید. همچنین در بسته چند نوع شمارنده تعریف شده است که در جدول \ref{counters} مشاهده می‌کنید.
+
+
+
+\begin{table}[!hbp]
+\begin{center}
+\begin{tabular}{|r|l|}
+\hline
+ فرمان & شرح\\
+ \hline
+ \verb+\settextfont[...]{...}+&قلم فارسی متن را مشخص می‌کند.\\
+ \hline
+ \verb+\setromantextfont[...]{...}+&قلم انگلیسی متن را مشخص می‌کند.\\
+ \hline
+ \verb+\setdigitfont[...]{...}+&قلم ارقام را در فرمول‌ها مشخص می‌کند.\\
+ \hline
+ \verb+\defpersianfont\fontname[...]{...}+&یک قلم فارسی را مشخص می‌کند.\\
+\hline
+ \verb+\defromanfont\fontname[...]{...}+&یک قلم انگلیسی را مشخص می‌کند.\\
+\hline
+\verb+\footnote{...}+&برای درج یک پانوشت فارسی \\
+\hline
+\verb+\Footnote{...}+&برای درج یک پانوشت انگلیسی \\
+\hline
+\verb+\today+&درج تاریخ جاری خورشیدی\\
+\hline
+\verb+\englishtoday+&درج تاریخ جاری میلادی\\
+\hline
+\verb+\rldblcolumn+&ترتیب ستونها را در یک متن چندستونی از راست‌ به ‌چپ می‌کند (پیش‌فرض)\\
+\hline
+\verb+\lrdblcolumn+&ترتیب ستونها را در یک متن چند‌ستونی از چپ ‌به ‌راست می‌کند \\
+\hline
+\verb+\twocolumnstableofcontents+ & فهرست مطالب را در دو ستون می‌چیند (نیاز به فراخوانی \verb+fmultico+ دارد)\\
+\hline
+\verb+\lr{...}+&یک متن کوتاه انگلیسی را در یک پاراگراف فارسی قرار می‌دهد\\
+\hline
+ \verb+\rl{...}+&یک متن کوتاه فارسی را در یک پاراگراف انگلیسی قرار می‌دهد\\
+\hline
+\verb+\begin{LTR}+&شروع محیط چپ‌به‌راست\\
+ \verb+\end{LTR}+&پایان محیط چپ‌به‌راست\\
+\hline
+\verb+\begin{RTL}+&شروع محیط راست‌به‌چپ\\
+\verb+\end{RTL}+&پایان محیط راست‌به‌چپ\\
+\hline
+\verb+\begin{roman}+&شروع محیط انگلیسی مجهز به قلم انگلیسی متن\\
+ \verb+\end{roman}+&پایان محیط انگلیسی\\
+\hline
+\verb+\begin{persian}+&شروع محیط فارسی مجهز به قلم فارسی متن\\
+\verb+\end{persian}+&پایان محیط فارسی\\
+\hline
+\verb+\Roman+&برای درج کتاب‌نامه‌های انگلیسی\\
+\hline
+\verb+\Persian+&برای درج کتاب‌نامه‌های فارسی\\
+\hline
+ \verb+\rmfamily+&قلم انگلیسی را برای حروف‌چینی استفاده می‌کند (پیش‌فرض محیط \verb+roman+)\\
+\hline
+\verb+\farsifont+&قلم فارسی را برای حروف‌چینی استفاده می‌کند (پیش‌فرض محیط \verb+persian+) \\
+\hline
+ \verb+\PersianFootNum+&شمارهٔ پانوشت‌های انگلیسی را به صورت فارسی درج می‌کند (پیش‌فرض )\\
+\hline
+ \verb+\RomanFootNum+&شمارهٔ پانوشت‌های انگلیسی را به صورت انگلیسی درج می‌کند.\\
+\hline
+ \verb+\RomanBibNum+&شمارهٔ مراجع انگلیسی را به صورت انگلیسی درج می‌کند (پیش‌فرض)\\
+\hline
+ \verb+\PersianBibNum+&شمارهٔ مراجع انگلیسی را به صورت فارسی درج می‌کند.\\
+\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+persian+&همان اثر شمارنده \verb+arabic+ اصلی لاتک را دارد.\\
+\hline
+\verb+adadi+& شمارنده را به صورت یک، دو، سه، \ldots تغییر می‌دهد. \\
+\hline
+\verb+harfi+&شمارنده را به صورت الف\char"200D، ب، پ، \ldots تغییر می‌دهد.\\
+\hline
+\verb+tartibi+&شمارنده را به صورت اول، دوم، سوم، و \ldots تغییر می‌دهد.\\
+\hline
+\end{tabular}
+\end{center}
+\caption{شمارنده‌ها}\label{counters}
+\end{table}
+
+\section{استفاده از قلمهای مختلف}
+بستهٔ \lr{fontspec}، که به صورت خودکار فراخوانی می‌شود، امکان استفاده از قلمهای موجود در سیستم را فراهم می‌کند. برای استفاده از \lr{\XePersian}
+لازم است که حداقل یک قلم اصلی حروف‌چینی متن را مشخص کنید. این کار را با فرمان زیر انجام می‌دهیم:
+\begin{Verbatim}[frame=single,numbers=left,framerule=1mm,rulecolor=\color{red},fillcolor=\color{yellow},framesep=3mm,showspaces=true,commandchars=+()]
+\settextfont[Scale=+rl(مقیاس)]{+rl(نام قلم)}
+\end{Verbatim}
+به عنوان مثال با فرمان
+\begin{Verbatim}[frame=single,numbers=left,framerule=1mm,rulecolor=\color{blue},framesep=3mm,showspaces=true,commandchars=+()]
+\settextfont[Scale=1]{XB Zar}
+\end{Verbatim}
+
+قلم \lr{XB Zar} را با مقیاس بزرگی \lr{1} به عنوان قلم اصلی فارسی معرفی می‌کند. گزینهٔ \verb+Scale=1+ اختیاری است و مشخص می‌کند که قلم با چه سایزی مورد استفاده قرار گیرد. توجه داشته باشید که \lr{XB Zar} عنوان قلمی است که باید روی سیستم شما نصب باشد. اگر سیستم شما ویندوز است قلم مورد استفاده باید در پوشهٔ
+\fbox{\lr{C:$\backslash$windows$\backslash$fonts}}
+موجود باشد. این قلم یکی از قلمهای سری ایکس ساخته شده توسط گروه کاربران فارسی اپل-مکینتاش است که بسیار کامل هستند و توصیه می‌شود از این قلم‌ها استفاده شود. برای دریافت آنها به آدرس زیر مراجعه کنید:
+
+\centerline{\fbox{\texttt{http://wiki.irmug.org/index.php/X\_Series\_2}}}
+برای اینکه قلم نگارش ارقام در فرمول‌ها را مشخص کنید از فرمان زیر استفاده کنید:
+\begin{Verbatim}[frame=single,numbers=left,framerule=1mm,rulecolor=\color{red},fillcolor=\color{yellow},framesep=3mm,showspaces=true,commandchars=+()]
+\setdigitfont[Scale=+rl(مقیاس)]{+rl(نام قلم)}
+\end{Verbatim}
+و قلم نگارش متن‌های انگلیسی را با فرمان زیر مشخص می‌کنیم:
+\begin{Verbatim}[frame=single,numbers=left,framerule=1mm,rulecolor=\color{red},fillcolor=\color{yellow},framesep=3mm,showspaces=true,commandchars=+()]
+\setromantextfont[Scale=+rl(مقیاس)]{+rl(نام قلم)}
+\end{Verbatim}
+
+همچنین می‌توانید هر تعداد قلم فارسی دلخواه را معرفی کنید و در نوشتار خود مورد استفاده قرار دهید. فرمان انجام این کارها به صورت زیر است:
+\begin{Verbatim}[frame=single,numbers=left,framerule=1mm,rulecolor=\color{red},fillcolor=\color{yellow},framesep=3mm,showspaces=true,commandchars=+()]
+\defpersianfont\fontname[Scale=+rl(مقیاس)]{+rl(نام قلم)}
+\defromanfont\fontname[Scale=+rl(مقیاس)]{+rl(نام قلم)}
+\end{Verbatim}
+به عنوان مثال فرمان
+
+
+\begin{Verbatim}[frame=single,numbers=left,framerule=1mm,rulecolor=\color{blue},framesep=3mm,showspaces=true,commandchars=+()]
+\defpersianfont\nastaliq[Scale=2]{IranNastaliq}
+\end{Verbatim}
+قلم نستعلیق را برای نوشتار معرفی می‌کند و در متن می‌توانید به دو صورت از آن استفاده کنید:
+\begin{itemize}
+\item
+در یک محیط \lr{RTL} به صورت زیر
+
+\begin{Verbatim}[frame=single,numbers=left,framerule=1mm,rulecolor=\color{blue},framesep=3mm,showspaces=true,commandchars=+\[\]]
+\begin{RTL}
+\nastaliq
++rl[نمونه متن با قلم نستعلیق]
+\end{RTL}
+\end{Verbatim}
+
+
+که اثر آن همانند متن زیر است:
+
+\begin{center}\fbox{\Large\nastaliq نمونه متن با قلم نستعلیق}\end{center}
+این روش مناسب نوشتن یک پاراگراف یا بیشتر است.
+\item
+یا به صورت ساده به شکل زیر از قلم تعریف شده استفاده کنید
+
+\begin{Verbatim}[frame=single,numbers=left,framerule=1mm,rulecolor=\color{blue},framesep=3mm,showspaces=true,commandchars=+\[\]]
+\nastaliq{+rl[نمونه متن با قلم نستعلیق]}
+\end{Verbatim}
+که اثر این فرمان هم مشابه قبل است. این روش مناسب نوشتن یک متن کوتاه با قلم تعریف شده است.
+
+\end{itemize}
+به روش مشابه می‌توانید هر تعداد قلم انگلیسی دلخواه تعریف کنید و از آنها استفاده کنید. فرمان
+\begin{Verbatim}[frame=single,numbers=left,framerule=1mm,rulecolor=\color{red},fillcolor=\color{yellow},framesep=3mm,showspaces=true,commandchars=+()]
+\defromanfont\fontname[Scale=+rl(مقیاس)]{+rl(نام قلم)}
+\end{Verbatim}
+
+وظیفهٔ تعریف قلم‌های مختلف انگلیسی را به عهده دارد. به عنوان مثال با فرمان
+\begin{Verbatim}[frame=single,numbers=left,framerule=1mm,rulecolor=\color{blue},framesep=3mm,showspaces=true,commandchars=+()]
+\defromanfont\linlib[Scale=1.5]{Linux Libertine}
+\end{Verbatim}
+قلم
+\lr{Linux Libertine} با مقیاس بزرگی \lr{1.5} معرفی می‌شود که می‌توان از آن به صورت زیر استفاده کرد:
+
+\begin{Verbatim}[frame=single,numbers=left,framerule=1mm,rulecolor=\color{blue},framesep=3mm,showspaces=true,commandchars=+\[\]]
+\begin{LTR}
+\linlib
+Sample text with Linux Libertine font
+\end{LTR}
+\end{Verbatim}
+
+که اثر آن به شکل زیر است:
+
+
+\begin{LTR}\centerline{\fbox{\linlib
+Sample text with Linux Libertine font
+}}\end{LTR}
+
+\section{گزینه‌های بستهٔ \lr{\XePersian}}
+به دلیل تنوع روش‌های حروف‌چینی پایان‌نامه‌ها و کتاب‌های فارسی، بستهٔ \lr{\XePersian} دارای امکاناتی است که با استفاده از آنها می‌توانید نوشتار خود را به سبک دلخواه طراحی کنید.
+\subsection{پانوشت‌ها}
+از فرمان‌های
+\verb+\footnote+
+\verb+\Footnote+
+برای نوشتن پانوشت‌های فارسی و انگلیسی (به ترتیب) استفاده می‌شود. سبک پیش‌فرض بسته این است که شمارهٔ تمام پانوشت‌ها به صورت فارسی نوشته می‌شود و بسته به اولین پانوشت هر صفحه، خط حائل در سمت مناسب قرار داده می‌شود. اگر می‌خواهید شمارهٔ پانوشت‌های انگلیسی در کل نوشتار به صورت عدد انگلیسی باشد از گزینهٔ
+\verb+RomanFootNum+
+در هنگام فراخوانی بسته به صورت زیر استفاده کنید
+\begin{Verbatim}[frame=single,numbers=left,framerule=1mm,rulecolor=\color{blue},framesep=3mm,showspaces=true,commandchars=+()]
+\usepcackage[RomanFootNum]{xepersian}
+\end{Verbatim}
+همچنین در خود نوشتار هر جا که خواستید شمارهٔ پانوشت‌ها فارسی یا انگلیسی باشد از فرمان‌های
+\verb+\PersianFootNum+
+یا
+\verb+\RomanFootNum+
+(به ترتیب) استفاده کنید.
+به عنوان مثال
+این یک پانوشت فارسی است \footnote{شمارهٔ پانوشت فارسی است.} و این هم یک پانوشت انگلیسی است%
+\Footnote{The number of the footnote is persian.}
+که شمارهٔ آن فارسی است. حال فرمان
+\verb+\RomanFootNum+
+را در مستند قرار می‌دهیم.
+\RomanFootNum
+این یک پانوشت انگلیسی است%
+\Footnote{The number of the footnote is roman.}
+که شمارهٔ آن انگلیسی است. برای برگشت به حالت اولیه فرمان
+\verb+\PersianFootNum+
+را در مستند قرار می‌دهیم.
+\PersianFootNum
+و حال این یک پانوشت دیگر انگلیسی است%
+\Footnote{The number of the footnote is persian again.}
+که شمارهٔ آن فارسی شده است.
+\subsection{کتاب‌نامه}
+دو محیط \verb+\Persian+ و \verb+\Roman+ برای درج مراجع فارسی و انگلیسی تعریف شده است. بنابراین برای نوشتن کتاب‌نامهٔ خود به صورت زیر می‌توانید عمل کنید
+
+\begin{Verbatim}[frame=single,numbers=left,framerule=1mm,rulecolor=\color{blue},framesep=3mm,showspaces=true,commandchars=+()]
+\begin{thebibliography}
+\Persian
+\bibitem{hafez}+rl(دیوان حافظ، انتشارات سروش).
+\Roman
+\bibitem{faust} Johann Wolfgang von Goethe, Faust.
+\end{thebibliography}
+\end{Verbatim}
+در این صورت کتاب‌نامهٔ شما به صورت زیر حروف‌چینی می‌شود:
+
+\bigskip
+
+\centerline{\fbox{
+\begin{minipage}[r]{10cm}
+\begin{thebibliography}
+\Persian
+\bibitem{hafez} دیوان حافظ، انتشارات سروش.
+\Roman
+\bibitem{faust} Johann Wolfgang von Goethe, Faust.
+\end{thebibliography}
+\end{minipage}
+}}
+\bigskip
+
+اگر بخواهید شمارهٔ مراجع انگلیسی به صورت عدد فارسی باشد از فرمان \verb+\PersianBibNum+ در مستند خود استفاده کنید در این صورت کتاب‌نامهٔ شما به صورت زیر چیده می‌شود:
+\bigskip
+
+\PersianBibNum
+\centerline{\fbox{
+\begin{minipage}[r]{10cm}
+\begin{thebibliography}
+\Persian
+\bibitem{hafez} دیوان حافظ، انتشارات سروش.
+\Roman
+\bibitem{faust} Johann Wolfgang von Goethe, Faust.
+\end{thebibliography}
+\end{minipage}
+}}
+\bigskip
+\RomanBibNum
+
+به همین ترتیب می‌توانید از فرمان \verb+\RomanBibNum+ استفاده کنید و شمارهٔ مراجع انگلیسی را به صورت عدد انگلیسی درج کنید. این دو فرمان را در هر جای مستند که وارد کنید اثر خود را از آن نقطه به بعد ظاهر می‌کنند ولی اگر می‌خواهید یکی از این دو سبک را در نوشتار خود داشته باشید (که اغلب این‌گونه است) بهتر است از گزینه‌های
+\verb+RomanBibNum+ و یا \verb+PersianBibNum+
+هنگام فراخوانی بستهٔ \lr{\XePersian} استفاده کنید. گزینهٔ
+\verb+RomanBibNum+
+گزینهٔ پیش‌فرض است و بنابراین اگر می‌خواهید کتاب‌نامهٔ شما به فرم دوم چاپ شود از فرمان زیر در سرآغاز فایل خود استفاده کنید:
+
+\begin{Verbatim}[frame=single,numbers=left,framerule=1mm,rulecolor=\color{blue},framesep=3mm,showspaces=true,commandchars=+()]
+\usepackage[PersianBibNum]{xepersian}
+\end{Verbatim}
+
+\subsection*{خلاصه}
+اگر بخواهید مثلاً شمارهٔ پانوشت‌های انگلیسی به صورت انگلیسی باشد و شمارهٔ مراجع انگلیسی به صورت فارسی باشد از فرمان زیر استفاده کنید
+
+\begin{Verbatim}[frame=single,numbers=left,framerule=1mm,rulecolor=\color{blue},framesep=3mm,showspaces=true,commandchars=+()]
+\usepackage[PersianBibNum,RomanFootNum]{xepersian}
+\end{Verbatim}
+\section{حروف‌چینی شعر}
+برای حروف‌چینی شعر باید فرمان زیر را در سرآغاز فایل خود قرار دهید:
+
+\begin{Verbatim}[frame=single,numbers=left,framerule=1mm,rulecolor=\color{blue},framesep=3mm,showspaces=true,commandchars=+()]
+\usepackage{persianpoem}
+\end{Verbatim}
+بعد از این کار به راحتی می‌توانید شعر را حروف‌چینی کنید.
+
+{\nastaliq\doublespacing
+\begin{oldpoem}
+
+هله رفتیم و گرانی ز جمالت بردیم&
+جهت توشهٔ ره ذکر وصالت بردیم\\
+تا که ما را و ترا تذکرهٔ خوش باشد&
+دل خسته بتو دادیم و خیالت بردیم\\
+آن خیال رُخ خوبت که قمر بندهٔ اوست&
+وان خَم ابروی مانند هلالت بردیم\\
+و آن شکرخندهٔ خوبت که شکر تشنهٔ اوست&
+ز شکر خانهٔ مجموع خصالت بردیم\\
+چون کبوتر چو بپریم بتو بازآییم&
+زانکه ما این پَر و بال از پَر و بالت بردیم\\
+هر کجا پرد فرعی، بسوی اصل آید&
+هر چه داریم هم از عزّ و جلالت بردیم\\
+شمس تبریز شنو خدمت ما را زصبا&
+گر شمالست و صبا هم ز شمالت بردیم
+
+\end{oldpoem}
+}
+شعر بالا با کد زیر تولید شده است:
+
+\begin{Verbatim}[frame=single,numbers=left,framerule=1mm,rulecolor=\color{blue},framesep=3mm,showspaces=true,commandchars=+()]
+\begin{oldpoem}
++rl(هله رفتیم و گرانی ز جمالت بردیم)&
++rl(جهت توشهٔ ره ذکر وصالت بردیم)\\
++rl(تا که ما را و ترا تذکرهٔ خوش باشد)&
++rl(دل خسته بتو دادیم و خیالت بردیم)\\
++rl(آن خیال رُخ خوبت که قمر بندهٔ اوست)&
++rl(وان خَم ابروی مانند هلالت بردیم)\\
++rl(و آن شکرخندهٔ خوبت که شکر تشنهٔ اوست)&
++rl(ز شکر خانهٔ مجموع خصالت بردیم)\\
++rl(چون کبوتر چو بپریم بتو بازآییم)&
++rl(زانکه ما این پَر و بال از پَر و بالت بردیم)\\
++rl(هر کجا پرد فرعی، بسوی اصل آید)&
++rl(هر چه داریم هم از عزّ و جلالت بردیم)\\
++rl(شمس تبریز شنو خدمت ما را زصبا)&
++rl(گر شمالست و صبا هم ز شمالت بردیم)\\
+\end{oldpoem}
+\end{Verbatim}
+
+
+این محیط دارای حالت ستاره‌دار (\verb+oldpoem*+) نیز می‌باشد که اثر آن به صورت زیر است.
+\begin{oldpoem*}
+هله رفتیم و گرانی ز جمالت بردیم&
+جهت توشهٔ ره ذکر وصالت بردیم\\
+تا که ما را و ترا تذکرهٔ خوش باشد&
+دل خسته بتو دادیم و خیالت بردیم\\
+آن خیال رُخ خوبت که قمر بندهٔ اوست&
+وان خَم ابروی مانند هلالت بردیم\\
+و آن شکرخندهٔ خوبت که شکر تشنهٔ اوست&
+ز شکر خانهٔ مجموع خصالت بردیم\\
+چون کبوتر چو بپریم بتو بازآییم&
+زانکه ما این پَر و بال از پَر و بالت بردیم\\
+هر کجا پرد فرعی، بسوی اصل آید&
+هر چه داریم هم از عزّ و جلالت بردیم\\
+شمس تبریز شنو خدمت ما را زصبا&
+گر شمالست و صبا هم ز شمالت بردیم
+\end{oldpoem*}
+شعر بالا با کد زیر تولید شده است:
+
+\section{حروف‌چینی چند‌ستونی}
+برای حروف‌چینی یک متن در چند ستون از محیط زیر استفاده کنید. حداکثر تعداد ستونها ۵ است.
+
+\begin{Verbatim}[frame=single,numbers=left,framerule=1mm,rulecolor=\color{blue},framesep=3mm,showspaces=true,commandchars=+()]
+\begin{multicols}{+rl(تعداد ستون‌ها)}
+.....
+\end{multicols}
+\end{Verbatim}
+
+\section{محیط مورد فارسی}
+محیط مورد برای استفاده در فارسی نیز تعریف شده است که در زیر مثال آنرا می‌بنید:
+
+$$
+\rcases{\mbox{مرد}\cr\mbox{زن}}\mbox{آدم}
+$$
+
+طرح بالا با کد زیر نوشته شده است.
+\begin{Verbatim}[frame=single,numbers=left,framerule=1mm,rulecolor=\color{blue},framesep=3mm,showspaces=true,commandchars=+()]
+$$\rcases{\mbox{+rl(مرد)}\cr\mbox{+rl(زن)}}\mbox{+rl(آدم)}$$
+\end{Verbatim}
+
+
+\section{تولید نمایه}
+به همراه این بسته، فایلی ارائه شده است که شما را قادر می‌سازد به راحتی نمایه برای مستندتان فراهم کنید. خود بسته هیچ‌گونه محدودیتی با نمایه‌سازی ندارد،
+ولی نرم‌افزار
+\lr{makeindex} هنگام مرتب کردن فایل نمایه، ترتیب بعضی از حروف را به درستی رعایت نمی‌کند.
+برای رفع این مشکل، استفاده از \lr{xindy} بجای \lr{makeindex} توصیه می‌شود.
+
+اگر از تکلایو ۲۰۰۸ استفاده می‌کنید \lr{xindy} به طور خودکار روی سیستم شما نصب است. کافی است فایل \lr{persian.xdy} را که همراه این بسته
+ارائه شده است در دایرکتوری جاری قرار دهید و فرمانهای زیر را در خط فرمان اجرا کنید:
+
+\begin{Verbatim}[frame=single,numbers=left,framerule=1mm,rulecolor=\color{blue},framesep=3mm,showspaces=true,commandchars=+()]
+tex2xindy < filename.idx > filename.raw
+xindy -I xindy -M persian.xdy filename.raw
+\end{Verbatim}
+
+\noindent بعد از انجام این کار، نمایهٔ مرتب شدهٔ شما آمادهٔ تزریق به مستند می‌شود.
+
+توجه داشته باشید که اگر می‌خواهید از نمایه استفاده کنید، باید شمارندهٔ صفحه را در حالت \lr{\texttt{persian}} قرار دهید. البته شمارندهٔ صفحه به صورت
+پیش‌فرض در این حالت قرار دارد.
+\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}\\
+2.1a+b&=\cos y\label{eq2}
+\end{align}
+
+فرمولهای بالا با کد زیر تولید شده‌اند.
+
+\begin{roman}
+\begin{verbatim}
+\begin{align}
+a^2+b^2&=\sin x\label{eq1}\\
+1a+b&=\cos y\label{eq2}
+\end{align}
+\end{verbatim}
+\end{roman}
+ارجاع به فرمول \eqref{eq1} به صورت طبیعی امکان‌پذیر است. برای اطلاعات بیشتر به \femph{مقدمه‌ای نه‌چندان کوتاه بر \lr{\LaTeXe}}
+%\footnote{قابل دسترسی از\texttt{http://www.ctan.org}}
+مراجعه کنید.
+\section{تهیهٔ اسلاید با \lr{beamer}}
+امکانات استفاده از طبقهٔ \lr{beamer} در حد مطلوبی برقرار است. برای استفادهٔ بهینه چند محیط جدید تعریف شده‌اند.
+\begin{Verbatim}[frame=single,numbers=left,framerule=1mm,rulecolor=\color{red},fillcolor=\color{yellow},framesep=3mm,showspaces=true,commandchars=+()]
+\begin{+rl(بلوک)}{+rl(عنوان)}
+...
+\end{+rl(بلوک)}
+\end{Verbatim}
+با این فرمان یک بلوک عادی تشکیل می‌شود که جهت آن از راست به چپ است. به جای ''بلوک`` می‌توانید از ''بلوک‌مثال`` یا ''بلوک‌هشدار`` استفاده کنید.
+
+\section{استفاده از \lr{PSTricks}}
+تمامی امکانات استفاده از \lr{PSTricks} در بسته موجود است.
+% \begin{LTR}
+% %-------------------- write timeline file ---------------------%
+% \newwrite\TimeLineFile
+% \immediate\openout\TimeLineFile=sinus.txt
+% \immediate\write\TimeLineFile{::0x0,1}%
+% %remaining frames: overlay filled circle at its current postion
+% \multido{\i=2+1}{90}{%
+% \immediate\write\TimeLineFile{%
+% ::\i % put filled circle on top
+% }}
+% \immediate\closeout\TimeLineFile
+% %------------------- assemble animation -----------------------%
+% \psset{xunit=\pstRadUnit,dashadjust=false}
+% \begin{animateinline}[controls,timeline=sinus.txt,
+% begin={\begin{pspicture}(-0.5,-1.5)(6.6,2)},
+% end={\end{pspicture}}]{24}
+% %---- static material: axes, labels, curve ----%
+% \psaxes[trigLabels,trigLabelBase=3]{->}(0,0)(-2mm,-1.5)(6.5,1.5)[t,-90][$y=\sin(t)$,0]
+% \psplot[xunit=1cm,linestyle=dashed,algebraic]{0}{\psPiTwo}{sin(x)}
+% \newframe
+% \multiframe{91}{n=0+4}{\psset{xunit=1cm,linecolor=blue}
+% \pscustom[xunit=1cm,fillcolor=blue!30,fillstyle=solid,
+% linestyle=none,algebraic,dimen=inner]{%
+% \psplot{0}{\n\space DegtoRad}{sin(x)}
+% \psline(!\n\space DegtoRad 0)
+% }
+% \psplot[xunit=1cm,linestyle=dashed,linecolor=black,
+% algebraic]{0}{\n\space DegtoRad}{sin(x)}
+% \psdot[opacity=0.4,dotsize=3mm](!\n\space dup DegtoRad exch sin)
+% \psline[linestyle=dashed](!\n\space dup DegtoRad exch sin)(!\n\space DegtoRad 0)
+% }
+% \end{animateinline}
+% \end{LTR}
+
+
+
+
+\appendix
+\section{نصب ویرایشگر روی ویندوز}
+برای استفاده از \lr{\XePersian} باید \lr{XeTeX} روی سیستم شما نصب باشد. اگر از \lr{MikTex 2.7} یا بالاتر، و یا از \lr{TeXLive 2008}
+و یا بالاتر استفاده می‌کنید، \lr{XeTeX} به طور خودکار روی سیستم شما نصب شده است. تنها کاری که باید در این صورت انجام دهید نصب و
+تنظیم یک ویرایشگر مناسب برای کار است. لیست کنترل زیر ابزارهای لازم را برای کار با این بسته به شما نشان می‌دهد.
+\begin{enumerate}
+\item توزیع مناسبی از \lr{\TeX} مانند \lr{Texlive}(\lr{2008} یا بالاتر) یا \lr{Miktex} (\lr{2.7} یا بالاتر).
+\item نرم‌افزار مناسب ویرایش متنهای یونیکد (در ویندوز \lr{notepad++}\footnote{قابل دریافت از \LR{\texttt{http://notepad-plus.sourceforge.net/}}} و در لینوکس \lr{gedit}).
+\item نرم‌افزار مناسب نمایش فایلهای پی.دی.اف (در ویندوز توصیه می‌شود از \lr{SumatraPDF}\footnote{قابل دریافت از \lr{\texttt{http://www.parsilatex.org/pdfreader/SumatraPDF.rar}}} به جای آکروبات ریدر استفاده شود).
+\end{enumerate}
+از آنجا که کاربران ایرانی معمولا از ویندوز استفاده می‌کنند و با توجه به اینکه یک ویرایشگر مناسب زندگی را برای کاربر بسیار راحت می‌کند، در ادامه
+روش نصب و تنظیم ویرایشگر مناسب را در ویندوز به طور کامل شرح می‌دهیم. توجه داشته باشید که فرض بر این است یک توزیع مناسب از تک و
+همچنین \lr{SumatraPDF} روی سیستم شما نصب است.
+
+فایل نصب‌کنندهٔ \lr{notepad++} را اجرا کنید ( توجه داشته باشید که جدیدترین نسخه این فایل را از صفحهٔ خانگی این نرم‌افزار دریافت کرده باشید).
+افزونهٔ (\lr{plugin}) \verb+NppExec.dll+ را نیز از صفحهٔ خانگی \lr{notepad++} دریافت کنید و آن را در پوشهٔ
+\begin{roman}\verb|C:\Program Files\Notepad++\plugins|\end{roman}
+قرار دهید.
+سپس به صورتی که در شکلهای زیر نشان داده شده است نرم‌افزار را نصب و تنظیم کنید.
+
+\centerline{\includegraphics[height=5cm]{notepad1.PNG}}
+\centerline{\includegraphics[height=7cm]{notepad2.PNG}}
+\centerline{\includegraphics[height=6cm]{notepad3.PNG}}
+\centerline{\includegraphics[height=5cm]{notepad4.PNG}}
+\centerline{\includegraphics[height=6cm]{notepad5.PNG}}
+\centerline{\includegraphics[height=5cm]{notepad6.PNG}}
+
+متنی که در آخرین مرحله باید وارد کنید و حاصل را با عنوان \lr{xelatex} ذخیره کنید متن زیر است که می‌توانید به راحتی آن را از همین فایل پی.دی.اف
+کپی کنید و در پنجره‌ای که ظاهر شده است بچسبانید(به کوچک و بزرگ بودن حروف و همچنین فاصله بین کلمات دقت کنید):
+
+\setLR
+\small{
+\begin{verbatim}
+NPP_SAVE
+cd $(CURRENT_DIRECTORY)
+xelatex $(NAME_PART)
+\end{verbatim}
+}
+\setRL
+برای استفادهٔ بهینه از این ویرایشگر، بهتر است راهنمای آنرا مطالعه کنید. فقط به عنوان یک مطلب که ممکن است برای شما مفید باشد، هنگام ویرایش متنهای فارسی،
+با فشردن \lr{ALT+CTRL+R} صفحه نمایش از راست به چپ قرار می‌گیرد و بنابراین کار شما راحت‌تر می‌شود. برای برگشتن به حالت چپ‌به‌راست کافی است
+\lr{ALT+CTRL+L} را فشار دهید. بعد از انجام این کارها به راحتی می‌توانید با فشردن کلید \verb+F6+ فایل ورودی خود را پردازش کنید.
+
+برای اینکه بتوانید از داخل ویرایشگر فایل پی.دی.اف خروجی را مشاهده کنید و ویژگی جستجوی معکوس را داشته باشید باید یک نمایشگر پی.دی.اف مناسب را
+نصب و تنظیم کنید. نمایشگر مناسب این کار \lr{SumatraPDF} است که بسیار کم حجم و پرقدرت است. در زیر روش تنظیم ویرایشگر و نمایشگر را با شکل‌هایی
+توضیح داده‌ایم
+
+\centerline{\includegraphics[height=9cm]{sumatrapdf1.PNG}}
+\centerline{\includegraphics[height=5cm]{sumatrapdf2.PNG}}
+\centerline{\includegraphics[height=5cm]{notepad7.PNG}}
+\centerline{\includegraphics[height=5cm]{notepad8.PNG}}
+\centerline{\includegraphics[height=5cm]{notepad9.PNG}}
+
+بعد از انجام این کارها، بعد از اولین بار پردازش فایل، از منوی \lr{Run} گزینهٔ \lr{view} را انتخاب کنید تا فایل پی.دی.اف باز شود. حال بعد از هر بار پردازش،
+فایل پی.دی.اف به طور خودکار آپدیت می‌شود. برای استفاده از خاصیت \lr{Inverse Search} یا جستجوی معکوس باید بستهٔ \lr{pdfsync} را در فایل ورودی خود
+فراخوانی کنید. در این صورت با دو بار کلیک کردن بر یک نقطه از فایل پی.دی.اف به خط متناظر در \lr{notepad++} می‌روید. توجه داشته باشید که نسخه‌ای
+از \lr{SumatraPDF} را نصب کرده باشید که قابلیت جستجوی معکوس را داشته باشد. این نسخه را می‌توانید از آدرس زیر دریافت کنید
+
+\begin{roman}
+\verb+http://parsilatex.org/pdfreader/SumatraPDF.rar+
+\end{roman}
+
+و آن را در پوشهٔ زیر قرار دهید
+
+\begin{roman}
+\verb+C:\Program Files\SumatraPDF+
+\end{roman}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/xepersian-cove.tex b/Master/texmf-dist/doc/xelatex/xepersian/xepersian-cove.tex
new file mode 100644
index 00000000000..510a197d2cf
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/xepersian-cove.tex
@@ -0,0 +1,56 @@
+\begingroup
+\evensidemargin \paperwidth\relax
+\advance\evensidemargin -2in
+\advance\evensidemargin -\textwidth
+\divide\evensidemargin 2
+\oddsidemargin\evensidemargin
+
+\begin{titlepage}
+
+\let\footnotesize\small
+\let\footnoterule\relax
+\setcounter{page}{0}
+
+\null
+\vfil
+\vskip 25pt
+\begin{center}
+ {\LARGE\textbf{\XePersian}}\\[5pt]
+ {\large\textbf{\XeLaTeX\ macros for typesetting Persian in \XeTeX}.}\\
+\end{center}
+
+\bigskip\bigskip
+\hbox to \hsize{%
+ \hss
+\includegraphics[width=9cm,height=9cm]{iran.jpg}
+ \hss}
+\bigskip
+\bigskip
+
+\begin{center}
+{\LARGE\textbf{User's Guide}}\par
+\vskip 3em
+{\large \lineskip .75em Vafa Khalighi}\par
+\vskip 1.5em
+{\large \thefiledate\\[2pt]
+ Version \Version%
+ \footnote{Documentation edited and repacked at \thefiledate\ by
+ Vafa Khalighi \url{vafa.khalighi@students.mq.edu.au}.}}\par
+
+\end{center}
+\vfil
+\small
+Author's address:\\
+ 4/34 Sorrell Street\\
+ Parramatta\\
+ NSW 2150\\
+ Australia\\[3mm]
+ Internet: \Verb[codes={\catcode`\<=12}]+<vafa.khalighi@students.mq.edu.au>+
+\end{titlepage}
+
+\endgroup
+
+\setcounter{footnote}{0}
+\tableofcontents
+\pagenumbering{arabic}
+\endinput
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/xepersian-esse.tex b/Master/texmf-dist/doc/xelatex/xepersian/xepersian-esse.tex
new file mode 100644
index 00000000000..26691aadd10
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/xepersian-esse.tex
@@ -0,0 +1,305 @@
+\part*{Welcome to XePersian}
+\XePersian\ is a set of macro written for \LaTeX\ over \XeTeX\ in the hope that Persian typesetting in \TeX\ becomes quite easy and at the same time the Persian users would benefit from the \TeX\ tools that are available for English users.
+
+\File{\textsf{New!}}
+There is a change in the manual. I wrote a new \LaTeX\ class\footnote{The name of this class is \textsf{xepersian-user} and is included in the \XePersian\ package but please note that this class has no use for Persian typesetting and it is simply designed for typesetting the manual.} for writing the manual just to be more attractive, eye-catching and tidy. I also decided to write the manual in English and that is because \XePersian\ package will be placed on CTAN and it is included in various \TeX\ distributions like MiK\TeX\ and \TeX Live and if I write the manual in Persian, then I have abused the hospitality of CTAN, MiK\TeX\ and \TeX Live distributions, so I wrote the manual in plain English in the hope that everyone will be able to understand the material explained here.
+
+I have rewritten almost all the macros, new functionalities have been added and lots of changes have been done, therefore, I would like to encourage all the users to read this manual very carefully before trying to use the package. \XePersian\ now works with \textsf{article}, \textsf{report}, \textsf{book}, \textsf{amsart}, \textsf{amsbook}, \textsf{refrep}, \textsf{bookest} and \textsf{beamer} classes. Also I have written some new classes: \textsf{xepersian-thesis} (for typesetting Persian thesis), \textsf{xepersian-presentation} (for typesetting plain electronic Persian presentations) and \textsf{xepersian-magazine} (for typesetting Persian magazines, newspapers and other papers).
+
+\File{\textsf{Thanks}}
+Please note that \XePersian\ is not just mine, it belongs to all and it is the result of the hard work of several other people. I would like to thanks \textsf{Jonathan Kew} (the author of \XeTeX) for making such a wonderful \TeX\ system and answering my questions, \textsf{Karl Berry} and \textsf{Jim Hefferon} for all their wonderful encouragements, \textsf{Ross Moore} (my teacher and an abosolute \TeX acker) for helping and guiding me patiently and kindly, \textsf{Will Robertson} (the author of \textsf{fontspec} package) for his excellent \textsf{fontspec} package and also answering my question, \textsf{François Charette} (the author of several \XeLaTeX\ packages, more importantly the \textsf{bidi} package) for his wonderful \textsf{bidi} package which is currently the basis of \XePersian , \textsf{Mostafa Vahedi} for writing the preliminary version of the package and also motivating me to develop the package, \textsf{Mehdi Omidali} for participating in the development of \XePersian , contributiong mapping files, testing the development version of the package, his bug reports, bug fixes and writing the manual in Persian, and eventually I would like to thanks to all the users of \XePersian, firstly for using the package and secondly for their bug reports.
+
+
+
+\begin{Warning}
+Keep in mind the following typographical conventions in this User's Guide.
+\begin{itemize}
+ \item All literal input characters, i.e., those that should appear verbatim
+ in your input file, appear in upright "Helvetica" and {\UsageFont
+ Helvetica-Bold} fonts.
+ \item Meta arguments, for which you are supposed to substitute a value
+ (e.g., <Scale>) appear in slanted <Helvetica-Oblique> and
+ {\UsageFont\MetaFont Helvetica-BoldOblique} fonts.
+ \item The main entry for a macro or parameter that states its syntax appears
+ in a large bold font, \emph{except for the optional arguments, which are in
+ medium weight}. This is how you can recognize the optional arguments.
+ \item References to \XePersian\ commands and parameters within paragraphs are
+ set in {\UsageFont Helvetica-Bold}.
+
+\end{itemize}
+\end{Warning}
+\part{The Essentials}
+\section{An Example of the Input File}
+\begin{LVerb}
+ \documentclass{book}
+ \usepackage{xepersian}
+ \settextfont[Scale=1]{XB Zar}
+ \setromantextfont[Scale=1]{Linux Libertine}
+ \setdigitfont[Scale=1]{XB Zar}
+ \title{<title name>}
+ \author{<author name>}
+ \begin{document}
+ \maketitle
+ \tableofcontents
+ \chapter{<chapter name>}
+ ...
+ \section{<section name>}
+ ...
+ \subsection{<subsection name>}
+ ...
+ \end{document}
+\end{LVerb}
+
+\begin{Warning}
+Always load \XePersian\ package as the last package in the permeable of your document and put your definitions after loading \XePersian . Also note that the packages: \textsf{amsmath}, \textsf{amssymb}, \textsf{amsthm} and \textsf{graphicx} are loaded by default and you \emph{should not} load them.
+\end{Warning}
+
+\section{The Basic Commands of The Package\label{s-1}}
+In this section, I will be explaining some of the useful commands which you are best equipped to know.
+\begin{description}
+\mitem \settextfont`[...]'{...}
+
+Selects the default Persian font.
+
+\mitem \setromantextfont`[...]'{...}
+
+Selects the deafult Roman font.
+
+\mitem \setdigitfont`[...]'{...}
+
+Selects the digits font in maths formuals.
+
+\mitem \defpersianfont\n\fontname`[...]'{...}
+
+Defines an extra Persian font.
+
+\mitem \defromanfont\n\fontname`[...]'{...}
+
+Defines an extra Roman font.
+
+\mitem \footnote{...}
+
+Inserts Persian footnote.
+
+\mitem \Footnote{...}
+
+Inserts Roman footnote.
+
+\mitem \today
+
+Inserts Iranian date of today.
+
+\mitem \romantoday
+
+Inserts Roman date of today.
+
+\mitem \rldblcolumn
+
+Places columns from right to left in the \emph{twocolumns} documents (default).
+
+\mitem \lrdblcolumn
+
+Places columns from left to right in the \emph{twocolumns} documents.
+
+\mitem \twocolumnstableofcontents
+
+Typesets \emph{table of contents} in two columns (needs to load \textsf{fmultico} package at the permeable of the document).
+
+\mitem \lr{...}
+
+Typesets a short Roman text in a Persian paragraph.
+
+\mitem \rl{...}
+
+Typesets a short Persian text in a Roman paragraph.
+\end{description}
+\begin{Ex}
+ "\begin{LTR}" \ldots\ "\end{LTR}"
+\end{Ex}
+Left To Right environment.
+
+\begin{Ex}
+ "\begin{RTL}" \ldots\ "\end{RTL}"
+\end{Ex}
+Right To Left environment.
+
+\begin{Ex}
+ "\begin{roman}" \ldots\ "\end{roman}"
+\end{Ex}
+Typesets a Roman paragraph.
+
+\begin{Ex}
+ "\begin{persian}" \ldots\ "\end{persian}"
+\end{Ex}
+Typesets a Persian paragraph.
+\begin{description}
+\mitem \Roman
+
+Similar to {\UsageFont roman} environment but intended to be used in the bibliography environment.
+
+\mitem \Persian
+
+Similar to {\UsageFont persian} environment but intended to be used in the bibliography environment.
+
+\mitem \rmfamily
+
+Uses Roman font for typesetting (deafult in {\UsageFont roman} environment).
+
+\mitem \persianfont
+
+Uses Persian font for typesetting (deafualt in {\UsageFont persian} environment).
+
+\mitem \PersianFootNum
+
+Typesets the the Roman footnote numbers in Persian (default).
+
+\mitem \RomanFootNum
+
+Typesets the Roman footnote numbers in Roman.
+
+\mitem \RomanBibNum
+
+Typesets the numbers of \n\bibitem\ in Roman (default).
+
+\mitem \PersianBibNum
+
+Typesets the numbers of \n\bibitem\ in Persian.
+\end{description}
+\subsection{Using Different Fonts}
+To write a minimal document with \XePersian\, you will need to select a font for typesetting the main text. We achieve this by the following command:
+\begingroup
+\catcode`\<=12
+ \Mac \settextfont`[Scale=<integer>]'{<fontname>}
+\endgroup
+For example with the command:
+\begin{LVerb}
+ \settextfont[Scale=1]{XB Zar}
+\end{LVerb}
+We choose {\UsageFont XB Zar} as the main text font with the Scale of 1.
+
+\begin{drivers} {\UsageFont XB Zar} is the name of the font which should be installed on your machine. If you are on \textsf{Microsoft Windows}, then the font should be avaliable in \fbox{C:$\backslash$windows$\backslash$fonts} folder. This font is one of the \textsf{X Series} font made by \textsf{IRMUG} (Iranian Mac Users Group) which are perfect and you are advised to use these fonts. To obtain them, you can explore \href{http://wiki.irmug.org/index.php/X_Series_2}{\textsf{IRMUG}}.\end{drivers}
+
+In addition to selecting the main text font, we also need to choose the fonts for Roman texts and digits in maths formuals. We select the font for Roman texts by the following command:
+\begingroup
+\catcode`\<=12
+ \Mac \setromantextfont`[Scale=<integer>]'{<fontname>}
+\endgroup
+And we select the font for digits in maths formuals by the command:
+\begingroup
+\catcode`\<=12
+ \Mac \setdigitfont`[Scale=<integer>]'{<fontname>}
+\endgroup
+You also can define as many extra Persian and Roman fonts as you wish and use them in your document. This is done in the following syntax:
+\begingroup
+\catcode`\<=12
+ \Mac \defpersianfont\n\fontname`[Scale=<integer>]'{<fontname>}
+ \Mac \defromanfont\n\fontname`[Scale=<integer>]'{<fontname>}
+\endgroup
+For example, the command:
+\begin{LVerb}
+ \defpersianfont\nastaligh[Scale=1.5]{IranNastaliq}
+\end{LVerb}
+Defines the {\UsageFont Nastaligh} font for the text and you can use it in the following ways:
+\begin{itemize}
+\item If your intention is to write a short text with this font, you can use:
+\begingroup
+\catcode`\<=12
+ \Mac \nastaligh{<text>}
+\endgroup
+\item If you are going to write a long piece of text with this font you can either use {\UsageFont RTL} environment as follow:
+\begingroup
+\catcode`\<=12
+\begin{Ex}
+ "\begin{RTL}"
+ "\nastaligh"
+ <text>
+ "\end{RTL}"
+\end{Ex}
+\endgroup
+or even better define a new environment as follow:
+\begin{LVerb}
+ \newenvironment{Nastaligh}{\begin{RTL}\nastaligh}
+ {\end{RTL}}
+\end{LVerb}
+and then use this environment to typeset the text whenever you wish.
+\end{itemize}
+I am not going to explain this for Roman fonts because I would just repeat myself but it can be done quite similar to what I have been demonstrating above for Persian fonts.
+\subsection{The Bilingual Bibliography Environment}
+The commands \n\Persian\ and \n\Roman\ are defined so that you can switch between Persian and Roman texts easily in the bibliography environment.
+\subsection{The Options Of The Package}
+\subsubsection{The Footnotes}
+You can use the commands \n\footnote\ and \n\Footnote\ to insert Persian and English footnotes respectively. The package puts the numbers of all footnotes in Persian and automatically places the footnote-rule on the appropriate side of the page based on the first footnote on the page automatically by default\footnote{This means if your first footnote in a page is a Roman footnote, then the footnote-rule will appear on the left bottom side of the page and if your first footnote in a page is a Persian footnote, then the footnote rule will appear on the right bottom side of the page.}.
+
+\File{OPTION!}
+If you wish all Roman footnote numbers appear in Roman instead Persian, then you can load \XePersian\ with the appropriate option as follow:
+ \Mac \usepackage[RomanFootNum]{xepersian}
+In addition to this, two commands: \n\PersianFootNum\ and \n\RomanFootNum\ are provided, as you might have guessed from the name of the commands \n\PersianFootNum\ puts the number of all Roman footnote in Persian and \n\RomanFootNum\ puts the number of all Roman footnotes in Roman.
+
+\subsubsection{The bibitem Numbers}
+
+\File{OPTION!}
+\XePersian\ will put the numbers of all Roman \n\bibitem\ In Roman by default, but if you wish that all Roman \n\bibitem\ numbers appear in Persian, you can load \XePersian\ with the appropriate option as follow:
+ \Mac \usepackage[PersianBibNum]{xepersian}
+In addition to this, two commands: \n\RomanBibNum\ and \n\PersianBibNum\ are provided, the command \n\RomanBibNum\ puts the number of all Roman \n\bibitem\ in Roman and \n\PersianBibNum\ puts the number of all Roman \n\bibitem\ in Persian.
+
+\File{Summary}
+If you wish to have Roman \n\bibitem\ numbers in Persian and the Roman footnote numbers in Roman, you can load \XePersian\ with the appropriate options as follow:
+ \Mac \usepackage[PersianBibNum,RomanFootNum]{xepersian}
+
+\section{The Counters}
+The following counters are defined in the package:
+\begin{description}
+\mitem arabic
+
+The main {\UsageFont arabic} counter of \LaTeX\ has been redefined for comaptibility with the package.
+
+\mitem persian
+
+Has the effect of the main {\UsageFont arabic} counter of \LaTeX .
+
+\mitem adadi
+
+Changes the counting to the Prsian Numbers.
+
+\mitem harfi
+
+Changes the counting to the Persian alphabets.
+
+\mitem tartibi
+
+Changes the counting to the Persian ordering numbers.
+\end{description}
+\section{Typesetting Persian Poems}
+To typeset a poem, you will nead to load \textsf{persianpoem} package as this package is not loaded by default and then use \textsf{oldpoem} or its starred version (\textsf{oldpoem*}). The \textsf{oldpoem} has the following syntax:
+\begin{LVerb}
+ \begin{oldpoem}
+ <verse1>&<verse2>\\
+ <verse3>&<verse4>\\
+ \end{oldpoem}
+\end{LVerb}
+\section{Multicolumns Typesetting}
+To typeset a text in multicolumns, you need to load \textsf{fmultico} package and use the \textsf{multicols} environment which has the following syntax:
+\begingroup
+\catcode`\<=12
+\begin{Ex}
+ "\begin{multicols}{<number of columns>}"
+ <text>
+ "\end{multicols}"
+\end{Ex}
+\endgroup
+\section{The Persian Case}
+The Persian case is also defined which has the following syntax:
+\begin{LVerb}
+ $$\rcases{\mbox{<branch1>}\cr\mbox{<branch2>}\cr ...}
+ \mbox{<main>}$$
+\end{LVerb}
+\section{Index Generation}
+To generate index, you will need to place \textsf{persian.xdy} file in the current directory and then open a \textsf{command prompt} and do the following:
+\begin{LVerb}
+ tex2xindy < filename.idx > filename.raw
+ xindy -I xindy -M persian.xdy filename.raw
+\end{LVerb}
+\begin{drivers}
+To generate index, the page counter should be \textsf{persian}\footnote{This is the default counter.}.
+\end{drivers}
+\endinput
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/xepersian-magazine.tex b/Master/texmf-dist/doc/xelatex/xepersian/xepersian-magazine.tex
new file mode 100644
index 00000000000..489e5b1cdce
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/xepersian-magazine.tex
@@ -0,0 +1,262 @@
+\part{Magazine Typesetting}
+\section{Introduction}
+\textsf{xepersian-magazine} class allows you to create magazines, newspapers and any other types of papers. The output document has a front page and as many inner pages as desired. Articles appear one after another, telling the type, number of columns, heading, subheading, images, author and so forth. It is possible to change the aspect of (almost) everything therefore it is highly customizable. Commands to add different titles, headings and footers are also provided.
+\section{Usage}
+To create a magazine just load the class as usual\footnote{You also need to load \XePersian\ after loading the document class and choose fonts for the main text, Roman text and digits in maths formuals. For more detail see section \ref{s-1} of the manual.}, with
+\begingroup
+\catcode`\<=12
+ \Mac \documentclass`[<class-options>]'{xepersian-magazine}
+\endgroup
+at the beginning of your source file. The class options are described in section \ref{s-options}.
+
+From this point it is possible to include packages and renew class commands described in section \ref{s-custom}.
+\subsection{Front Page}
+
+\File{\small frontpage}
+As every magazine, \textsf{xepersian-magazine} has its own front page. It includes main headings, an index, the magazine logo and other useful information. This environment should be the first you use within \textsf{xepersian-magazine} class but it is not mandatory.
+
+\File{\small\n\firstimage}
+\File{\small\n\firstarticle}
+The first two commands you can use inside the {\UsageFont frontpage} environment are \n\firstimage\ and \n\firstarticle\ which include, respectively, the main image and the main heading in the front page. The first one takes two arguments "<image>" and "<description>". Notice that second argument is optional and it declares the image caption; "<image>" defines the relative path to the image. In order to include the first piece of article use
+\begingroup
+\catcode`\<=12
+ \Mac \firstarticle{<title>}{<opening>}{`<time>'}
+\endgroup
+first two arguments are mandatory and represent heading and the opening paragraph. Last argument is optional (you can leave it blank) and indicates the time when article happened.
+
+\File{\footnotesize\n\secondarticle}
+The second piece of article is included using the command \n\secondarticle\ just as the first article. The main difference are that this second piece has two more arguments and it does not include an image.
+\begingroup
+\catcode`\<=12
+ \Mac \secondarticle{<title>}{<subtitle>}{<opening>}
+ \Mac {<pagesof>}{`<time>'}
+\endgroup
+The new arguments "<subtitle>" and "<pagesof>" define a subtitle and the name of the section for this piece of article.
+
+\File{\small\n\thirdarticle}
+The third piece of article is the last one in the \textsf{xepersian-magazine} front page. It works like the \n\secondarticle.
+\begingroup
+\catcode`\<=12
+ \Mac \thirdarticle{<title>}{<subtitle>}{<opening>}
+ \Mac {<pagesof>}{`<time>'}
+\endgroup
+The arguments meaning is the same as \n\secondarticle\ command.
+
+\File{\small indexblock}
+\File{\small authorblock}
+\File{\small weatherblock}
+The front page includes three information blocks besides the news: {\UsageFont indexblock} which contains the index, {\UsageFont authorblock} which includes information about the author and a {\UsageFont weatherblock} containing a weather forecast. All these three environments are mostly a frame in the front page therefore they can be redefined to fit your personal wishes but I kept them to give an example and to respec the original \textsf{xepersian-magazine} format.
+
+\File{\small \n\indexitem}
+The {\UsageFont indexblock} environment contains a manually editted index of \textsf{xepersian-magazine}. It takes one optional argument "<title>" and places a title over the index block. To add entries inside the index just type
+\begingroup
+\catcode`\<=12
+ \Mac \indexitem{`<title>'}{<reference>}
+\endgroup
+inside the environment. The "<title>" is the index entry text and the "<reference>" points to a article inside \textsf{xepersian-magazine}. It will be more clear when you read subsecton \ref{sub-1}. In order to get a correct output, it is necessary to leave a blank line between index items.
+
+The {\UsageFont authorblock} environment can include whatever you would like. I called it {\UsageFont authorblock} because I think it is nice to include some author reference in the front page: who you are, why are you doing this... This environment creates a frame box in the bottom right corner of the front page with your own logo at the top.
+
+\File{\small\n\weatheritem}
+Finally, the {\UsageFont weatherblock} lets you include a weather forecast. It takes one optional argument "<title>" that places a title over the weather block. It can fit up to three weather icons with maximum and minimum temperatures, description and name. To add each of the weather entries type the following
+\begingroup
+\catcode`\<=12
+ \Mac \weatheritem{<image>}{<day-name>}{<max>}
+ \Mac {<min>}{<short-des>}
+\endgroup
+The first argument includes the path to the weather icon (i.e. sunny or rainy), "<day-name>" like Monday, "<max>" and "<min>" are the highest and lowest day temperatures and "<short-des>" is a brief description of the weather condition: partly cloudy, sunny and windy \ldots
+\subsection{Inside\label{sub-1}}
+Once we have created the front page we should include all articles inside our magazine. \textsf{xepersian-magazine} arranges all articles one after each other, expanding headings all over the page and splitting the article text in the number of columns we wish. There are three different environments to define a piece of article: the {\UsageFont article} environment described in section \ref{subsub-1}, the {\UsageFont editorial} environment \ref{subsub-2} for opinion articles and the {\UsageFont shortarticle} environment explained in \ref{subsub-3}.
+\subsubsection{The article environment\label{subsub-1}}
+
+\File{\small article}The main environment to include a piece of article is called {\UsageFont article}. It takes four arguments that set up the headings and structure of the article.
+\begingroup
+\catcode`\<=12
+\begin{Ex}
+ "\begin{article}{<num-of-columns>}{<title>}{<subtitle>}"\\"{<pagesof>}{<label>}" \\
+\ldots\ "<text>" \ldots\ \\
+ "\end{article}"
+\end{Ex}
+\endgroup
+
+The first argument "<num-of-columns>" sets the number of columns the article will be divided whereas "<label>" is used when pointing an article from the index in the front page. The rest of the arguments are easy to understand.
+
+Inside the {\UsageFont article} environment, besides the main text of the article, it is possible to include additional information using several class commands.
+
+\File{\scriptsize\n\authorandplace}
+\File{\small\n\timestamp}
+The \n\authorandplace"{<author>}{<place>}" inserts the name of the editor and the place where the article happened in the way many magazines do. Another useful command is \n\timestamp"{<time>}" which includes the time and a separator just before the text. These two commands should be used before the text because they type the text as the same place they are executed.
+
+\File{\small\n\image}
+To include images within the text of an article, \textsf{xepersian-magazine} provides an \n\image\ command. Since \textsf{fmultico} package does not provide any float support for its \textsf{multicols} environment, I created a macro that includes an image only if that is possible, calculating if there is enough space for the image.It is not the best solution but it works quite well and I could not find a better one. To include an image use the command and its two arguments: the relative path to the image and a short description.
+\begingroup
+\catcode`\<=12
+ \Mac \image{<image>}{<description>}
+\endgroup
+
+\File{\small\n\columntitle}
+\File{\footnotesize\n\expandedtitle}
+Within the text of the article, it is possible to add column and expanded titles. The main difference between them is that the first one keeps inside the width of an article column whereas the second expands all over the width of the page, breaking all the columns. Their use is analogous, as follows
+\begingroup
+\catcode`\<=12
+ \Mac \columntitle{<type>}{<text>}
+ \Mac \expandedtitle{<type>}{<text>}
+\endgroup
+These two commands use \textsf{fancybox} package features. That’s why there are five different types of titles which correspond mainly with fancybox ones: \textsf{shadowbox},
+\textsf{doublebox}, \textsf{ovalbox}, \textsf{Ovalbox} and \textsf{lines}.
+\subsubsection{The editorial environment\label{subsub-2}}
+
+\File{editorial}
+In addition to the editorial article environment, one can use the editorial environment to create editorial or opinion texts. The main feature is that it transforms the style
+of the heading. Although this environment accepts all the commands article takes, it does not make any sense to use the \n\authorandplace\ command within it since it includes an author argument. To create an editorial text use
+\begingroup
+\catcode`\<=12
+\begin{Ex}
+"\begin{editorial}{<num-of-columns>}{<title>}{<author>}{<label>}"\\
+ \ldots\ "<text>" \ldots\ \\
+ "\end{editorial}"
+\end{Ex}
+\endgroup
+All arguments have the same meaning as article environment (see \ref{subsub-1}).
+\subsubsection{The shortarticle environment\label{subsub-3}}
+
+\File{\small shortarticle}
+The shortarticle environment creates a block of short article. Althought it has its own title and subtitle, each piece of article within it may have a title. To use it just
+type:
+\begingroup
+\catcode`\<=12
+\begin{Ex}
+"\begin{shortarticle}{<num-of-columns>}{<title>}{<subtitle>}{<label>}"\\
+\ldots\ "<text>" \ldots\ \\
+"\shortarticleitem{<title>}{<text>}"\\
+\ldots\ \\
+"\end{shortarticle}"
+\end{Ex}
+\endgroup
+You can also specify the number of columns of the block like editorial and article environments. To add a piece of article inside the shortarticle use the \n\shortarticleitem, indicating a title and the text of the issue.
+\subsubsection{Commands between articles}
+
+\File{\n\articlesep}
+\File{\small\n\newsection}
+There are two commands you can use among the articles inside \textsf{xepersian-magazine}: \n\articlesep\ and \n\newsection. The first one does not take any parameter and just draws a line between two articles. The second changes the content of "\xepersian@section" to the new "<section name>". From the point it is used, all articles which follow will be grouped within the new section.
+\begingroup
+\catcode`\<=12
+ \Mac \newsection{<section name>}
+\endgroup
+
+
+\section{Customization\label{s-custom}}
+\textsf{xepersian-magazine} includes many commands which can be used to customize its aspect, from the front page to the last page. I will list them grouped so it is easy to find
+them. Treat them as standard \LaTeX\ commands, using \n\renewcommand\ to change
+their behaviour.
+\subsection{Front Page}
+
+\File{\small\n\customlogo}
+\File{\scriptsize\n\customminilogo}
+\File{\tiny\n\custommagazinename}
+When creating a magazine, everyone wants to show its own logo instead of \textsf{xepersian-magazine} default heading. To achieve this, you need to put the following command at the preamble of your document:
+\begingroup
+\catcode`\<=12
+ \Mac \customlogo{<text>}
+ \Mac \customminilogo{<text>}
+ \Mac \custommagazinename{<text>}
+\endgroup
+
+\File{\n\edition}
+\File{\footnotesize\n\editionformat}
+The edition text has to be declared in the preamble of the document. One important thing to know is that \n\author, \n\date\ and \n\title\ have no effect inside \textsf{xepersian-magazine} since the magazine date is taken from \n\today\ command and the other two are only for the title page (if using \n\maketitle).
+
+\newpage
+\File{\footnotesize\n\indexFormat}
+\File{\tiny\n\indexEntryFormat}
+\File{\tiny\n\indexEntryPageTxt}
+\File{\tiny\n\indexEntryPageFormat}
+\File{\tiny\n\indexEntrySeparator}
+When defining the index in the front page, there are several commands to customize the final index style. \n\indexFormat\ sets the format of the title; \n\indexEntryFormat, the format of each index entry; \n\indexEntryPageTxt\ and \n\indexEntryPageFormat\ lets you define which is the text that goes with the page number and its format. Finally, \textsf{xepersian-magazine} creates a thin line between index entries, you can redefine it using \n\indexEntrySeparator. To get the index with "xepersian@indexwidth" is provided.
+\vskip 3.5cm
+
+\File{\tiny\n\weatherFormat}
+\File{\tiny\n\weatherTempFormat}
+\File{\tiny\n\weatherUnits}
+Relating to the weather block, the title format can be changed redefining \n\weatherFormat. In order to customize the format of the temperature numbers and their units it is necessary to redefine \n\weatherTempFormat\ and \n\weatherUnits\ respectively.
+\vskip 3cm
+
+\File{\tiny\n\*TitleFormat}
+\File{\tiny\n\*SubtitleFormat}
+\File{\tiny\n\*TextFormat}
+The main article that appear in the front page can change their formats. To obtain that there are three standard commands to modify the title, subtitle and text style. You just have to replace the star ("*") with first, second or third depending on which article you are editing. Note that first piece of article has no subtitle therefore it does not make any sense to use the non-existent command \n\firstSubtitleFormat.
+\vskip 2cm
+
+\File{\tiny\n\pictureCaptionFormat}
+\File{\tiny\n\pagesFormat}
+Two other elements to configure are the picture captions and the pages or section format in the entire document. To proceed just redefine the macros \n\pictureCaptionFormat\ and \n\pagesFormat.
+\newpage
+\subsection{Inside The Magazine}
+\File{\tiny\n\innerTitleFormat}
+\File{\tiny\n\innerSubtitleFormat}
+\File{\tiny\n\innerAuthorFormat}
+\File{\tiny\n\innerPlaceFormat}
+The articles inside \textsf{xepersian-magazine} may have a different format from the ones in the front page. To change their title or subtitle format redefine \n\innerTitleFormat\ and \n\innerSubtitleFormat. The article text format matches the document general definition. When using the \n\authorandplace\ command, you might want to change the default style. Just renew \n\innerAuthorFormat\ and \n\innerPlaceFormat\ to get the results.
+\vskip 3cm
+
+\File{\tiny\n\timestampTxt}
+\File{\tiny\n\timestampSeparator}
+\File{\tiny\n\timestampFormat}
+The \n\timestamp\ command described in section \ref{subsub-1} lets you introduce the time of the event before the article text. You can configure its appearance by altering
+several commands: \n\timestampTxt\ which means the text after the timestamp; \n\timestampSeparator\ which defines the element between the actual timestamp and the beginning of the text and, finally, \n\timestampFormat\ to change the entire timestamp format.
+\vskip 2cm
+
+\File{\tiny\n\innerTextFinalMark}
+\textsf{xepersian-magazine} puts a small black square at the end of the article. As I wanted to create a highly customizable \LaTeX\ class I added the macro \n\innerTextFinalMark\ to change this black square. This item will appear always following the last character of the text with the "~" character.
+
+\File{\tiny\n\minraggedcols}
+\File{\tiny\n\raggedFormat}
+The \n\minraggedcols\ counter is used to tell \textsf{xepersian-magazine} when article text should be ragged instead of justified. The counter represents the minimum number of columns that are needed in order to use ragged texts. For example, if \n\minraggedcols\ is set to 3, all articles with 3 columns or more will be ragged. Articles with 1, 2 columns will have justified text. By default, \n\minraggedcols\ is set to 4.
+
+The \n\raggedFormat\ macro can be redefined to fit user ragged style. Default value is \n\RaggedLeft.
+
+\File{\n\heading}
+\File{\n\foot}
+\textsf{xepersian-magazine} includes package \textsf{fancyhdr} for changing headings and footers. Although it is possible to use its own commands to modify \textsf{xepersian-magazine} style, there are two commands to change headings and foot appearance. Place them in the preamble of your \textsf{xepersian-magazine} document.
+\begingroup
+\catcode`\<=12
+ \Mac \heading{<left>}{<center>}{<right>}
+ \Mac \foot{<left>}{<center>}{<right>}
+\endgroup
+If you still prefer to use fancyhdr macros, use them after the {\UsageFont frontpage} environment.
+
+\begin{drivers}
+\textsf{xepersian-magazine} by default places no headers and footers. If you want headers and foooters, then after loading \textsf{xepersian} package, you should write "\pagestyle{fancy}" at the preamble of your document.
+\end{drivers}
+
+\section{Class Options\label{s-options}}
+The \textsf{xepersian-magazine} class is in itself an alteration of the standard \textsf{article} class, thus
+it inherits most of its class options but \textsf{twoside}, \textsf{twocolumn}, \textsf{notitlepage} and
+\textsf{a4paper}. If you find problems when loading other article features, please let me
+know to fix it.
+
+There are also five own options that \textsf{xepersian-magazine} implements.
+\begin{description}
+\mitem a3paper
+
+(false) This option makes \textsf{xepersian-magazine} 297 mm width by 420 mm height.
+This option is implemented because the standard \textsf{article} class does not
+allow this document size.
+
+\mitem 9pt
+
+(false) Allows the 9pt font size that \textsf{article} class does not include (default
+is 10pt).
+
+\mitem columnlines
+
+(false) Adds lines between columns in the entire \textsf{xepersian-magazine}. The
+default line width is 0.1pt but it is possible to change this by setting length
+\n\columnlines\ in the preamble.
+
+\mitem showgrid
+(false) This option is only for developing purposes. Because the front
+page has a personal design using the textpos package, I created this grid to
+make easier the lay out.
+\end{description}
+\endinput
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/xepersian-presentation.tex b/Master/texmf-dist/doc/xelatex/xepersian/xepersian-presentation.tex
new file mode 100644
index 00000000000..8f3e0762e88
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/xepersian-presentation.tex
@@ -0,0 +1,200 @@
+\part{Producing Presentations}
+At the moment, there are two classes that you can prepare your presentations with. These classes are:
+\section{xepersian-presentations class}
+\textsf{xepersian-presentation} is a simple class for presentations to be shown on screen or beamer. It is derived from \LaTeX 's
+article class.The “virtual paper size” of documents produced by this class: width=128mm,
+height=96mm. \textsf{xepersian-presentation} requires that the \textsf{fancyhdr} and \textsf{geometry} packages are available on the system.
+Enhancements to the \textsf{xepersian-presentation} class are easily made available by other packages, these include slides with a background from a bitmap (\textsf{eso-pic}
+package).
+
+\subsection{Usage}
+The class is used with
+\begingroup
+\catcode`\<=12
+ \Mac \documentclass`[<options>]'{xepersian-presentation}
+\endgroup
+
+\File{OPTION!}
+Options of the \textsf{article} class are also available to \textsf{xepersian-presentation}, e. g. "10pt", "11pt", "12pt" for selection of
+font size. However, not all options
+of the \textsf{article} class will be appropriate for a presentation class, e. g. "twocolumn".
+
+\File{EXAMPLE}
+A simple example document:
+\begin{LVerb}
+ \documentclass[12pt]{xepersian-presentation}
+ \usepackage{eso-pic}
+ \usepackage{xepersian}
+ \settextfont[Scale=1]{XB Zar}
+ \setromantextfont[Scale=1]{Linux Libertine}
+ \setdigitfont[Scale=1]{XB Zar}
+ \pagestyle{pres}
+ \AddToShipoutPicture{
+ \includegraphics{gradient2.png}
+ }
+ \begin{document}
+ \begin{titlepage}
+ \centering
+ \distance{1}
+ {
+ \Huge \bfseries Title of the presentation \par
+ }
+ \vspace{1.3ex} \large
+ Author\\[2ex]Institution
+ \distance{2}
+ \end{titlepage}
+ \begin{plainslide}[Title of Page]
+ The first page
+ \end{plainslide}
+ \begin{rawslide}
+ The second page
+ \end{rawslide}
+ \end{document}
+ \end{LVerb}
+
+The title page can be created within the "titlepage" environment, the "\maketitle" command is not
+available. Slides may be created with the "plainslide" environment, you may add the title of the slide with the
+optional parameter. The contents of the slide are centered vertically.
+Another environment generating a slide is "rawslide": slides are written without title, contents are not vertically
+centered.
+
+The \n\distance"{number}" command allows to introduce vertical space into slides constructed with the
+"rawslide" and "titlepage" environments. You should use pairs of "\distance{}" commands with numbers
+indicating the relative height of empty space, see the "titlepage" in the example above.
+
+Pictures can be included with the "includegraphics"-command of the "graphicx"-package. Please be
+aware that the dimensions of the pages are 128mm $\times$ 96mm and therefore included graphics are scaled
+appropriately.
+\subsection{Enhancements to xepersian-presentation}
+\subsubsection{Fill background of a presentation with bitmaps}
+\textsf{eso-pic} package allows you to paint the background with a picture:
+\begin{Ex}
+"\usepackage{eso-pic}"\\
+...\\
+"\AddToShipoutPicture{"\\
+"\includegraphics{gradient2.png}"\\
+"}"
+\end{Ex}
+
+\n\AddToShipoutPicture"{}" puts the picture on every page, \n\AddToShipoutPicture"*{}" puts
+it on to the current page, \n\ClearShipoutPicture\ clears the background beginning with the current
+page. Details of "eso-pic"'s commands can be found in its own documentation.
+
+\section{beamer Class}
+\XePersian\ currently works with \textsf{beamer} class quite well and all should go well with \textsf{default}, \textsf{Warsaw}, \textsf{Goettingen}, \textsf{Hannover}, \textsf{Malmoe}, \textsf{Marburg}, \textsf{Montpellier}, \textsf{PaloAlto}, \textsf{Pittsburgh}, \textsf{Singapore}, \textsf{Szeged} and \textsf{xepersian-JLTree}\footnote{\textsf{xepersian-JLTree} theme is the modified version of \textsf{JLTree} theme.} themes but other themes are not yet supported.
+
+\begin{Warning}
+I have defined some new environments for beamer and you should use these new environments instead beamer's original environments. These new environments are:
+\end{Warning}
+\begin{Ex}
+"\begin{"\textbf{\PersianTxt{قضیه}}"}"
+\ldots\ "<text>" \ldots\
+"\end{"\textbf{\PersianTxt{قضیه}}"}"
+\end{Ex}
+You should use \textbf{\PersianTxt{قضیه}} environment instead \textbf{theorem} environment.
+\begin{Ex}
+"\begin{"\textbf{\PersianTxt{نتیجه}}"}"
+\ldots\ "<text>" \ldots\
+"\end{"\textbf{\PersianTxt{نتیجه}}"}"
+\end{Ex}
+You should use \textbf{\PersianTxt{نتیجه}} environment instead \textbf{corollary} environment.
+\begin{Ex}
+"\begin{"\textbf{\PersianTxt{حقیقت}}"}"
+\ldots\ "<text>" \ldots\
+"\end{"\textbf{\PersianTxt{حقیقت}}"}"
+\end{Ex}
+You should use \textbf{\PersianTxt{حقیقت}} environment instead \textbf{fact} environment.
+\begin{Ex}
+"\begin{"\textbf{\PersianTxt{لما}}"}"
+\ldots\ "<text>" \ldots\
+"\end{"\textbf{\PersianTxt{لما}}"}"
+\end{Ex}
+You should use \textbf{\PersianTxt{لما}} environment instead \textbf{lema} environment.
+\begin{Ex}
+"\begin{"\textbf{\PersianTxt{مسئله}}"}"
+\ldots\ "<text>" \ldots\
+"\end{"\textbf{\PersianTxt{مسئله}}"}"
+\end{Ex}
+You should use \textbf{\PersianTxt{مسئله}} environment instead \textbf{problem} environment.
+\begin{Ex}
+"\begin{"\textbf{\PersianTxt{پاسخ}}"}"
+\ldots\ "<text>" \ldots\
+"\end{"\textbf{\PersianTxt{پاسخ}}"}"
+\end{Ex}
+You should use \textbf{\PersianTxt{پاسخ}} environment instead \textbf{solution} environment.
+\begin{Ex}
+"\begin{"\textbf{\PersianTxt{تعریف}}"}"
+\ldots\ "<text>" \ldots\
+"\end{"\textbf{\PersianTxt{تعریف}}"}"
+\end{Ex}
+You should use \textbf{\PersianTxt{تعریف}} environment instead \textbf{definition} environment.
+\begin{Ex}
+"\begin{"\textbf{\PersianTxt{تعریفها}}"}"
+\ldots\ "<text>" \ldots\
+"\end{"\textbf{\PersianTxt{تعریفها}}"}"
+\end{Ex}
+You should use \textbf{\PersianTxt{تعریفها}} environment instead \textbf{definitions} environment.
+\begin{Ex}
+"\begin{"\textbf{\PersianTxt{مثال}}"}"
+\ldots\ "<text>" \ldots\
+"\end{"\textbf{\PersianTxt{مثال}}"}"
+\end{Ex}
+You should use \textbf{\PersianTxt{مثال}} environment instead \textbf{example} environment.
+\begin{Ex}
+"\begin{"\textbf{\PersianTxt{مثالها}}"}"
+\ldots\ "<text>" \ldots\
+"\end{"\textbf{\PersianTxt{مثالها}}"}"
+\end{Ex}
+You should use \textbf{\PersianTxt{مثالها}} environment instead \textbf{examples} environment.
+
+\begin{Ex}
+"\begin{"\textbf{\PersianTxt{اثبات}}"}"
+\ldots\ "<text>" \ldots\
+"\end{"\textbf{\PersianTxt{اثبات}}"}"
+\end{Ex}
+You should use \textbf{\PersianTxt{اثبات}} environment instead \textbf{proof} environment.
+\begin{Ex}
+"\begin{"\textbf{\PersianTxt{بلوک}}"}{<title>}"
+\ldots\ "<text>" \ldots\
+"\end{"\textbf{\PersianTxt{بلوک}}"}"
+\end{Ex}
+You should use \textbf{\PersianTxt{بلوک}} environment instead \textbf{block} environment.
+\begin{Ex}
+"\begin{"\textbf{\PersianTxt{بلوک‌مثال}}"}{<title>}"
+\ldots\ "<text>" \ldots\
+"\end{"\textbf{\PersianTxt{بلوک‌مثال}}"}"
+\end{Ex}
+You should use \textbf{\PersianTxt{بلوک‌مثال}} environment instead \textbf{exampleblock} environment.
+\begin{Ex}
+"\begin{"\textbf{\PersianTxt{بلوک‌هشدار}}"}{<title>}"
+\ldots\ "<text>" \ldots\
+"\end{"\textbf{\PersianTxt{بلوک‌هشدار}}"}"
+\end{Ex}
+You should use \textbf{\PersianTxt{بلوک‌هشدار}} environment instead \textbf{alertblock} environment.
+
+\subsection{An Example}
+
+\File{Example}
+\begin{LVerb}
+ \documentclass{beamer}
+ \usetheme{Warsaw}
+ \usepackage{xepersian}
+ \settextfont[Scale=1]{XB Zar}
+ \setromantextfont[Scale=1]{Linux Libertine}
+ \AtBeginDocument{\setdigitfont[Scale=1]{XB Zar}}
+ \title{<title>}
+ \subtitle{<subtitle>}
+ \author{<author>}
+ \institute{<institute>}
+ \begin{document}
+ \begin{frame}
+ \titlepage
+ \end{frame}
+ \begin{frame}{<frame-title>}
+ \framesubtitle{<frame-subtitle>}
+ ... <text> ...
+ \end{frame}
+ ...
+ \end{document}
+\end{LVerb}
+\endinput
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/xepersian-thesis.tex b/Master/texmf-dist/doc/xelatex/xepersian/xepersian-thesis.tex
new file mode 100644
index 00000000000..761621572a5
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/xepersian-thesis.tex
@@ -0,0 +1,54 @@
+\part{Thesis Typesetting}
+We typeset thesis by a class called \textsf{xepersian-thesis} which is the modified version of \textsf{report} class, therefore it contains all the commands and options that \textsf{report} class has. I just give an input example since the commands are easy to understand and this manual is already too long and boring enough!
+
+\begin{LVerb}
+ \documentclass[a4paper,11pt]{xepersian-thesis}
+ \usepackage{xepersian}
+ \settextfont[Scale=1]{XB Zar}
+ \setromantextfont[Scale=1]{Linux Libertine}
+ \setdigitfont[Scale=1]{XB Zar}
+ \begin{document}
+ \title{<title name in Persian>}
+ \author{<author name in Persian>}
+ \degree{<degree name in Persian>}
+ \supervisor{<supervisor name in Persian>}
+ \department{<department name in Persian>}
+ \university{<university name in Persian>}
+ \city{<city name in Persian>}
+ \thesisdate{\today}
+ \maketitle
+ \begin{acknowledgementpage}
+ ... <text> ...
+ \end{acknowledgementpage}
+ \begin{abstractpage}
+ ... <text> ...
+ \keywords{<text>}
+ \end{abstractpage}
+ \tableofcontents
+ \listoftables
+ \chapter{<chapter name>}
+ ... <text> ...
+ \Roman
+ \romantitle{<title name in English>}
+ \romanauthor{<author name in English>}
+ \romandegree{<degree name in English>}
+ \romanthesisdate{\romantoday}
+ \romansupervisor{<supervisor name in English>}
+ \romandepartment{<department name in English>}
+ \romanuniversity{<university name in English>}
+ \romancity{<city name in English>}
+ \begin{romanabstract}
+ ... <text> ...
+ \romankeywords{<text>}
+ \end{romanabstract}
+ \makeromantitle
+ \end{document}
+\end{LVerb}
+
+\begin{Warning}
+\begin{itemize}
+\item You should rename the image of your university logo to \textsf{logo} and put it in the current directory so \XePersian\ can compile your document correctly.
+\item The argument of \n\romanuniversity\ does not contain the word {\UsageFont University} so this means you have to type it yourself, i.e. If your want to produce \textsf{University of Tehran}, then you have to type \texttt{University of Tehran} for "<university name in English>".
+\end{itemize}
+\end{Warning}
+\endinput
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/xepersian-user-english.pdf b/Master/texmf-dist/doc/xelatex/xepersian/xepersian-user-english.pdf
new file mode 100644
index 00000000000..8adc34b6442
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/xepersian-user-english.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/xepersian-user-english.tex b/Master/texmf-dist/doc/xelatex/xepersian/xepersian-user-english.tex
new file mode 100644
index 00000000000..fac6631f853
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/xepersian-user-english.tex
@@ -0,0 +1,22 @@
+\documentclass[11pt]{xepersian-user}
+\setmainfont[Mapping=tex-text]{Junicode}
+\setPersianFont{XB Zar}
+\def\Date{09/01/05}
+\def\Version{0.163}
+\includeonly{%
+xepersian-cove,%
+xepersian-esse,%
+xepersian-magazine,%
+xepersian-thesis,%
+xepersian-presentation%
+}
+\makeindex
+\begin{document}
+\include{xepersian-cove} % Cover page; Table of Contents
+\include{xepersian-esse} % Welcome to XePersian; The essentials
+\include{xepersian-magazine}
+\include{xepersian-thesis}
+\include{xepersian-presentation}
+
+
+\end{document}
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/xepersian-userguide.pdf b/Master/texmf-dist/doc/xelatex/xepersian/xepersian-userguide.pdf
deleted file mode 100644
index 2d53b6c5d76..00000000000
--- a/Master/texmf-dist/doc/xelatex/xepersian/xepersian-userguide.pdf
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/xepersian-userguide.tex b/Master/texmf-dist/doc/xelatex/xepersian/xepersian-userguide.tex
deleted file mode 100644
index 204b9df9c1a..00000000000
--- a/Master/texmf-dist/doc/xelatex/xepersian/xepersian-userguide.tex
+++ /dev/null
@@ -1,411 +0,0 @@
-\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}
-