summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/xelatex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2008-09-28 00:38:09 +0000
committerKarl Berry <karl@freefriends.org>2008-09-28 00:38:09 +0000
commit481994839d45d4e497b7dde0c7619bfc88d6c6af (patch)
tree7e7035fec516300d9d4d30ae4c95da6bd665534a /Master/texmf-dist/doc/xelatex
parentf278b35cd0f364590612f947a7950e591a26e8a5 (diff)
xepersian update (27sep08)
git-svn-id: svn://tug.org/texlive/trunk@10758 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/xelatex')
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/README12
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/beamer-example1.tex1
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/beamer-example2.tex1
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/farsi.xdy118
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/notepad0.PNGbin0 -> 7370 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/notepad1.PNGbin0 -> 37271 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/notepad2.PNGbin0 -> 33727 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/notepad3.PNGbin0 -> 11609 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/notepad4.PNGbin0 -> 22358 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/user-guide.pdfbin76974 -> 0 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/user-guide.tex382
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/xepersian-mathsdigitspec.tex50
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/xepersian-userguide.pdfbin0 -> 190913 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian/xepersian-userguide.tex411
14 files changed, 587 insertions, 388 deletions
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/README b/Master/texmf-dist/doc/xelatex/xepersian/README
index ebb63a6a0c5..68c9d74e0f1 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.161111111
+The XePersian Package v0.162
-Updates: Huge Improvements: introducing \twocolumnstableofcontents, \setparsimathsdigitsfont, \pagenumbering{adadi}. Changed \pagenumbering{farsi} to \pagenumbering{harfi}. Corrected the table of contents problem in amsart and amsbook classes. Corrected the header problems in all classes.
+Updates: Huge Improvements: written a new package for unicode farsi maths digits, updated the user-guide.
XePersian is a package written for XeLaTeX that allows users to typeset
-Persian/Arabic properly. The current version is 0.161111111 and it will be
+Persian properly. The current version is 0.162 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 author (vafa.khalighi@students.mq.edu.au).
+Please report any bugs to the authors (mostafa.vahedi@gmail.com,vafa.khalighi@students.mq.edu.au,mehdioa@gmail.com).
-------------------------------
-Vafa Khalighi
-2008/09/17
+FarsiLaTeX Group
+2008/09/27
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/beamer-example1.tex b/Master/texmf-dist/doc/xelatex/xepersian/beamer-example1.tex
index 3b564e025ae..9964a2bba7f 100644
--- a/Master/texmf-dist/doc/xelatex/xepersian/beamer-example1.tex
+++ b/Master/texmf-dist/doc/xelatex/xepersian/beamer-example1.tex
@@ -1,5 +1,6 @@
\documentclass[hyperref=xetex]{beamer}
\usepackage{xepersian}
+\newfontfamily\farsifont[Script=Arabic,Scle=1.2,Mapping=parsidigits]{XB Zar}
\title{نمونه اسلاید توسط \lr{\XePersian}}
\author{وفا خلیقی}
\begin{document}
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/beamer-example2.tex b/Master/texmf-dist/doc/xelatex/xepersian/beamer-example2.tex
index 483a9faba99..5418651514a 100644
--- a/Master/texmf-dist/doc/xelatex/xepersian/beamer-example2.tex
+++ b/Master/texmf-dist/doc/xelatex/xepersian/beamer-example2.tex
@@ -1,5 +1,6 @@
\documentclass{beamer}
\usepackage{xepersian}
+\newfontfamily\farsifont[Script=Arabic,Scle=1.2,Mapping=parsidigits]{XB Zar}
\mode<presentation>
{
\usetheme{Warsaw}
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/farsi.xdy b/Master/texmf-dist/doc/xelatex/xepersian/farsi.xdy
new file mode 100644
index 00000000000..548d939286d
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/farsi.xdy
@@ -0,0 +1,118 @@
+;; $Id: makeidx.xdy,v 1.1 1997/02/07 14:17:31 kehr Exp $
+;;
+;; This file implements the Output Style Specifiers for plain
+;; makeindex (see manpage of makeindex 2.x) in conjuction with
+;; TeX/LaTeX.
+;;
+;; The Input Style Specifiers of makeindex cannot de defined in a
+;; `xindy' style file. Use an appropriate version of the program
+;; `tex2xindy' which should be included with this distribution.
+;;
+;; Since `xindy' uses a different specification language than
+;; makeindex and some of the command-line options of makeindex are now
+;; only available as style-file commands, this file can only serve as
+;; a template that produces the default-markup of makeindex. However,
+;; it may be used as a starting point for further modification and
+;; specialization.
+;;
+;; The following values are taken from the source of the makeindex
+;; distribution (see file scanst.h and the manpage) for further
+;; details.
+;;
+
+;; Define all attributes appearing in your document. Your attributes
+;; are all encapsulators you use in your \index commands following the
+;; vertical bar sign `|'. For example `foo' is the attribute in the
+;; command \index{...|foo}. Here you specify the set of attributes
+;; that appear in your document, the order in which they appear in the
+;; index and which one superdes the other.
+;;
+;; Example: a) (define-attibutes (("default") ("bf") ("it")))
+;; b) (define-attibutes (("bf" "default")))
+;;
+;; The initial command is (change it accordingly):
+
+(define-attributes ("default"))
+
+;; The description of the location-classes.
+;; Add more location classes as needed.
+
+(define-location-class "arabic-page-numbers" ("arabic-numbers"))
+(define-location-class "roman-page-numbers" ("roman-numbers-lowercase"))
+(define-location-class "Roman-page-numbers" ("roman-numbers-uppercase"))
+(define-location-class "alpha-page-numbers" ("alpha"))
+(define-location-class "Alpha-page-numbers" ("ALPHA"))
+
+;; The most frequently used cross reference class "see". Add more, if
+;; necessary.
+
+(define-crossref-class "see")
+(markup-crossref-list :open "\see{" :close "}{}" :class "see")
+
+;; In makeindex: page_precedence <string> "rnaRA"
+;; List all location classes appearing in your document.
+
+(define-location-class-order ("roman-page-numbers"
+ "arabic-page-numbers"
+ "alpha-page-numbers"
+ "Roman-page-numbers"
+ "Alpha-page-numbers"
+ "see"))
+
+
+;; preamble <string> "\\begin{theindex}\n"
+;; postamble <string> "\n\n\\end{theindex}\n"
+
+(markup-index :open "\begin{theindex}~n"
+ :close "~n~n\end{theindex}~n"
+ :tree)
+
+;; These specifiers are not directly supported via a command-line
+;; switch as in makeindex. Add the appropriate markup-commands into
+;; the preamble.
+
+;; setpage_prefix <string> "~n \setcounter{page}{"
+;; setpage_suffix <string> "}~n"
+
+;; group_skip <string> "~n~n \indexspace~n"
+
+(markup-letter-group-list :sep "~n~n \indexspace~n")
+
+;; The indexentries (item_<..> specifiers)
+
+(markup-indexentry :open "~n \item " :depth 0)
+(markup-indexentry :open "~n \subitem " :depth 1)
+(markup-indexentry :open "~n \subsubitem " :depth 2)
+
+;; Location-references
+
+;; delim_0 <string> ", "
+;; delim_1 <string> ", "
+;; delim_2 <string> ", "
+
+(markup-locclass-list :open ", " :sep ", ")
+
+;; delim_n <string> ", "
+
+(markup-locref-list :sep ", ")
+
+;; delim_r <string> "--"
+
+(markup-range :sep "--")
+
+;; Here follow all letter-groups. The short-cut notation is used here.
+
+(define-letter-groups
+ ("آ" "ا" "ب" "پ" "ت" "ث" "ج" "چ" "ح" "خ" "د" "ذ" "ر" "ز"
+ "ژ" "س" "ش" "ص" "ض" "ط" "ظ" "ع" "غ" "ف" "ق" "ک" "گ" "ل" "م" "ن" "ه" "و" "ی"))
+
+;;
+;; The sort-rules map all letters to their lowercase counterpart.
+;;
+
+
+;; End
+
+;; Local Variables:
+;; mode: lisp
+;; End:
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/notepad0.PNG b/Master/texmf-dist/doc/xelatex/xepersian/notepad0.PNG
new file mode 100644
index 00000000000..b8058e379d7
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/notepad0.PNG
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/notepad1.PNG b/Master/texmf-dist/doc/xelatex/xepersian/notepad1.PNG
new file mode 100644
index 00000000000..09cd1992404
--- /dev/null
+++ 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
new file mode 100644
index 00000000000..296bf2b7e4d
--- /dev/null
+++ 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
new file mode 100644
index 00000000000..be72edccb8a
--- /dev/null
+++ 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
new file mode 100644
index 00000000000..95cf788b955
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/notepad4.PNG
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/user-guide.pdf b/Master/texmf-dist/doc/xelatex/xepersian/user-guide.pdf
deleted file mode 100644
index 0e6f33e8cce..00000000000
--- a/Master/texmf-dist/doc/xelatex/xepersian/user-guide.pdf
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/user-guide.tex b/Master/texmf-dist/doc/xelatex/xepersian/user-guide.tex
deleted file mode 100644
index 7e522958d8f..00000000000
--- a/Master/texmf-dist/doc/xelatex/xepersian/user-guide.tex
+++ /dev/null
@@ -1,382 +0,0 @@
-\documentclass[a4paper,11pt]{report}
-\usepackage{xepersian}
-\usepackage[top=2.5cm,right=2.5cm,bottom=2.5cm,left=2.5cm]{geometry}
-\title{حروف‌چینی فارسی در \lr{\XePersian}\\[0.2cm]نسخهٔ ۰/۱۶۱۱۱۱۱۱۱}
-\author{وفا خلیقی\thanks{پست الکترونیک: \lr{vafa.khalighi@students.mq.edu.au}}}
-\setlength\columnseprule{0.4pt}
-\begin{document}
-\maketitle
-\twocolumnstableofcontents
-\chapter{مقدمه}
-به حروف‌چینی فارسی ‪ ‬با ‪\lr{\XePersian} ‬خوش آمدید. هدف \lr{\XePersian} ارائه یک بستهٔ کاملاً کامل و پایدار برای حروف‌چینی است. لطفاً به خاطر داشته باشید که \lr{\XePersian} هنوز در حالت آزمایش است و این نسخهٔ ۰/۱۶۱۱۱۱۱۱۱ از آن است. من سعی کرده‌ام، می‌کنم و خواهم کرد تا تمام امکانات حروف‌چینی فارسی را در \lr{\XePersian} جمع کنم. اما این خود نیاز به آزمایش و امتحان دارد تا اشکالات پیدا و رفع شود.
-
-
-لطفاً قبل از استفاده از \lr{\XePersian} این سند را بدقت بخوانید تا با دستورات و امکانات \lr{\XePersian} آشنا شوید.
-
-همچنین اگر اشکالی، پیشنهادی و یا سؤالی دارید، می‌توانید آن را به نویسندهٔ \lr{\XePersian} گزارش دهید تا مؤلف \lr{\XePersian} بتواند نسخهٔ بعدی کاملتری را ارائه دهد.
-
-دوست دارم از صمیم قلب از آقای \lr{Jonathan Kew } برای پشتیبانی‌ها و اعتمادشان به من تشکر کنم.
-
-در اینجا نیز دوست دارم از مسئولان پروژه‌های تک‌پارسی و فارسی‌تک تشکر و قدردانی کنم به این خاطر که نوشتن \lr{\XePersian} ممکن نبود مگر با مطالعهٔ کدهای این دو پروژه. همچنین تعدادی از امکانات فارسی‌تک و تک‌پارسی در \lr{\XePersian} گنجانده شده است.
-
-در پایان نیز دوست دارم صمیمانه از دوستان خوب و نازنینم در وبلاگ فارسی‌لاتک، آقایان مصطفی واحدی، مهدی امیدعلی، مرتضی خدادادیان، وحید قاسمیان و بسیاری از دوستان دیگر تشکر کنم. بدون نظرات و پشتیبانی‌های این دوستان، من نمی‌توانستم انگیزهٔ لازم را در انجام این کار پیدا کنم.
-\chapter{فلسفه و دستورات}
-فلسفهٔ \lr{\XePersian} این است که یک استفاده کنندهٔ معمولی باید قادر باشد به راحتی به حروف‌چینی فارسی بپردازد. در حال حاضر \lr{\XePersian} با کلاسهای \lr{article, amsart, amsbook, report, book, bookest, refrep} و \lr{beamer} به زیبایی و آسانی کار می‌کند. در هر نسخه از \lr{\XePersian} تلاش بر این است تا حداقل سه کلاس دیگر نیز به آن اضافه شود. همچنین در هر نسخه بسته‌های زیادی نیز به \lr{\XePersian} اضافه خواهند شد تا کاربران آزادی کامل در حروف‌چینی فارسی داشته باشند.
-
-\section{قلمهای فارسی}
-تعدادی قلمهای فارسی مناسب با \lr{\XePersian} عرضه می‌شوند. این قلمها در پوشهٔ \lr{True Type Fonts} قرار دارند. لطفاً قبل از انجام هر کاری این قلمها را روی سیستم خود نصب کنید.
-\section{اسکلت یک متن فارسی ساده }
-\subsection{طبقات \lr{article} و \lr{amsart}}
-\setLR
-\verb|\documentclass{article}|\\
-\verb|\usepackage{xepersian}|\\
-\verb|\title{|\rl{عنوان مطلب}\verb|}|\\
-\verb|\author{|\rl{نام نویسنده}\verb|}|\\
-\verb|\begin{document}|\\
-\verb|\maketitle|\\
-\verb|\tableofcontents|\\
-\verb|\section{|\rl{یک قسمت}\verb|}|
-
-$\vdots$
-
-\verb|\subsection{|\rl{یک زیر قسمت}\verb|}|
-
-$\vdots$
-
-\verb|\subsubsection{|\rl{یک زیر زیر قسمت}\verb|}|
-
-$\vdots$
-
-
-\verb|\end{document}|
-\setRL
-
-\newpage
-\subsection{طبقهٔ \lr{beamer}}
-\setLR
-\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$
-
-\verb|\end{frame}|
-
-$\vdots$
-
-
-\verb|\end{document}|
-\setRL
-
-\subsection{سایر طبقات}
-\setLR
-\verb|\documentclass{book}|\\
-\verb|\usepackage{xepersian}|\\
-\verb|\title{|\rl{عنوان مطلب}\verb|}|\\
-\verb|\author{|\rl{نام نویسنده}\verb|}|\\
-\verb|\begin{document}|\\
-\verb|\maketitle|\\
-\verb|\tableofcontents|\\
-\verb|\chapter{|\rl{یک فصل}\verb|}|
-
-$\vdots$
-
-\verb|\section{|\rl{یک قسمت}\verb|}|
-
-$\vdots$
-
-\verb|\subsection{|\rl{یک زیر قسمت}\verb|}|
-
-$\vdots$
-
-\verb|\subsubsection{|\rl{یک زیر زیر قسمت}\verb|}|
-
-$\vdots$
-
-
-\verb|\end{document}|
-\setRL
-\newpage
-\section{نکات}
-\begin{itemize}
-\item \lr{\XePersian}
-قلم زر را برای قلم فارسی به عنوان پیش‌فرض استفاده می‌کند لذا باید این قلم را روی سیستم خود نصب کرده باشید. اگر می‌خواهید از قلم دیگری به عنوان قلم فارسی استفاده کنید، می‌توانید دستور زیر را بعد از \verb|\usepackage{xepersian}| در پیش‌درآمد فایل خود قرار دهید:
-
-\setLR
-\verb|\newfontfamily\farsifont[Script=Arabic,Scale=1.2,Mapping=parsidigits]{name of your font}|
-\setRL
-
-
-\item
-اگر می‌خواهید پاراگرافی انگلیسی بنویسید باید آن پاراگراف را در محیط \lr{\texttt{english}} قرار دهید:
-
-\setLR
-\verb|\begin{english}|
-
-$\vdots$
-
-\verb|\end{english}|
-\setRL
-
-
-\item
-دستور \verb|\setparsimathsdigitsfont| امکان انتخاب فونت اعداد فارسی را در محیط ریاضی به شما می‌دهد. اگر اصلاً از این فرمان استفاده نکنید، اعداد به صورت لاتین در محیط ریاضی درج می‌شوند. لطفاً توجه داشته باشید که این فرمان را باید بعد از \verb|\begin{document}| قرار دهید. شکل کلی این دستور به شکل زیر است:
-
-
-\setLR
-\verb|\setparsimathsdigitsfont{name of your font}|
-\setRL
-
-
-
-\item \lr{\XePersian}
-بصورت پیش‌فرض بسته‌های \lr{amsmath, amssymb, amsthm} و دیگر بسته‌های مربوط را فراخوانی می‌کند لذا شما نباید این بسته‌ها را دوباره در پیش‌درآمد فایل خود فراخوانی کنید.
-\item \lr{\XePersian}
-بصورت خودکار بستهٔ \lr{graphicx} را فراخوانی می‌کند لذا شما نباید این بسته را در پیش‌درآمد فایل خود فراخوانی کنید.
-
-\end{itemize}
-\newpage
-\section{دستورات کلیدی }
-\verb|\XePersian|:
-برای قرار دادن نماد \lr{\XePersian}. البته اگر در محیط \lr{\texttt{english}} نیستید باید از شکل
-\verb|\lr{\XePersian}|
-این دستور استفاده کنید.
-
-\vspace{0.5cm}
-
-\verb|\rl{}|:
-برای قرار دادن کلمه/کلمات و یا جمله‌ای فارسی زمانی که در محیط \lr{\texttt{english}} هستیم. کلمه/کلمات و یا جمله فارسی درون \verb|{}| قرار می‌گیرد.
-
-\vspace{0.5cm}
-
-\verb|\lr{}|:
-برای قرار دادن کلمه/کلمات و یا جمله‌ای انگلیسی زمانی که در محیط \lr{\texttt{english}} نیستیم. کلمه/کلمات و یا جمله انگلیسی درون \verb|{}| قرار می‌گیرد.
-
-
-
-
-
-\vspace{0.5cm}
-
-\verb|\footnote{}|:
-برای قرار دادن زیرنویس فارسی. متن فارسی را درون \verb|{}| قرار می‌دهیم.
-
-\vspace{0.5cm}
-
-\verb|\Footnote{}|:
-برای قرار دادن زیرنویس انگلیسی. متن انگلیسی را درون \verb|{}| قرار می‌دهیم.
-\vspace{.5cm}
-
-\verb|\pagenumbering{harfi}|:
-برای تبدیل شمارهٔ صفحات از عددی به حروف الفبای فارسی.
-
-\vspace{.5cm}
-
-\verb|\pagenumbering{arabic}|:
-برای تبدیل شمارهٔ صفحات از حروفی به عددی.
-
-\vspace{.5cm}
-
-\verb|\pagenumbering{adadi}|:
-برای تبدیل شماره صفحات به عددی که با حروف نوشته می‌شود، مانند یک، دو، سه و ...
-
-\vspace{.5cm}
-
-\verb|\twocolumnstableofcontents|:
-برای حروف‌چینی فهرست مطالب در دو ستون. مانند فهرست مطالب این سند.
-
-
-\newpage
-\chapter{امکانات حروف‌چینی فارسی }
-\section{حروف‌چینی شعر}
-حروف‌چینی شعر از فارسی‌تک به \lr{\XePersian} اضافه شده است. در اینجا لازم می‌دانم از آقای بهداد اسفهبد که مؤلف اصلی آن هستند تشکر کنم.
-
-\vspace{0.5cm}
-
-لطفاً به خاطر داشته باشید که برای حروف‌چینی شعر نیازی به قراردادن بسته‌ای خاص ندارید؛ \lr{\XePersian} این کار را بصورت خودکار انجام می‌دهد. هدف ما در اینجا فقط معرفی این محیط می‌باشد، اگر قصد دارید این محیط را به طور کامل فرا گیرید، لطفاً به آخرین راهنمای فارسی‌تک مراجعه فرمائید.
-\subsection{حروف‌چینی شعر سنتی}
-حروف‌چینی شعر سنتی در محیطی به نام \lr{oldpoem} انجام می‌گیرد. این محیط دو حالت دارد:
-\subsubsection{حالت معمولی}
-\begin{oldpoem}
-هله رفتیم و گرانی ز جمالت بردیم&
-جهت توشهٔ ره ذکر وصالت بردیم\\
-تا که ما را و ترا تذکرهٔ خوش باشد&
-دل خسته بتو دادیم و خیالت بردیم\\
-آن خیال رُخ خوبت که قمر بندهٔ اوست&
-وان خَم ابروی مانند هلالت بردیم\\
-و آن شکرخندهٔ خوبت که شکر تشنهٔ اوست&
-ز شکر خانهٔ مجموع خصالت بردیم\\
-چون کبوتر چو بپریم بتو بازآییم&
-زانکه ما این پَر و بال از پَر و بالت بردیم\\
-هر کجا پرد فرعی، بسوی اصل آید&
-هر چه داریم هم از عزّ و جلالت بردیم\\
-شمس تبریز شنو خدمت ما را زصبا&
-گر شمالست و صبا هم ز شمالت بردیم
-
-\end{oldpoem}
-شعر بالا با کد زیر تولید شده است:
-
-\setLR
-\verb|\documentclass{article}|\\
-\verb|\usepackage{xepersian}|\\
-\verb|\begin{document}|\\
-\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}|\\
-\verb|\end{document}|
-\setRL
-\subsubsection{حالت ستاره‌دار}
-\begin{oldpoem*}
-هله رفتیم و گرانی ز جمالت بردیم&
-جهت توشهٔ ره ذکر وصالت بردیم\\
-تا که ما را و ترا تذکرهٔ خوش باشد&
-دل خسته بتو دادیم و خیالت بردیم\\
-آن خیال رُخ خوبت که قمر بندهٔ اوست&
-وان خَم ابروی مانند هلالت بردیم\\
-و آن شکرخندهٔ خوبت که شکر تشنهٔ اوست&
-ز شکر خانهٔ مجموع خصالت بردیم\\
-چون کبوتر چو بپریم بتو بازآییم&
-زانکه ما این پَر و بال از پَر و بالت بردیم\\
-هر کجا پرد فرعی، بسوی اصل آید&
-هر چه داریم هم از عزّ و جلالت بردیم\\
-شمس تبریز شنو خدمت ما را زصبا&
-گر شمالست و صبا هم ز شمالت بردیم
-
-\end{oldpoem*}
-شعر بالا با کد زیر تولید شده است:
-
-\setLR
-\verb|\documentclass{article}|\\
-\verb|\usepackage{xepersian}|\\
-\verb|\begin{document}|\\
-\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*}|\\
-\verb|\end{document}|
-\setRL
-\subsection{حروف‌چینی شعر نو}
-حروف‌چینی شعر نو نیز در محیطی به نام \lr{newpoem} امکان پذیر است. این محیط دارای دو حالت معمولی و ستاره‌دار می‌باشد.
-\section{تهیه اسلاید}
-به آسانی می‌توانید اسلایدهای زیبایی را با کلاس \lr{beamer} در \lr{\XePersian} درست کنید. دو مثال نیز در پوشهٔ \lr{doc} موجود می‌باشد. در نسخه‌های بعدی تلاش خواهد شد تا کلاسها و بسته‌های مختلف و متنوع دیگری را برای تهیه اسلاید در \lr{\XePersian} فراهم آورد.
-\section{نوشتهٔ سرصفحه}
-برای فعال کردن نوشتهٔ سر صفحه سه راه وجود دارد:
-\begin{itemize}
-\item
-در پیش‌درآمد فایل خود دستور \verb|\pagestyle{headings}| را قرار دهید.
-\item
-در پیش‌درآمد فایل خود دستور \verb|\pagestyle{myheadings}| را قرار دهید و سپس \lr{\texttt{myheadings}} را تعریف کنید.
-\item
-از بستهٔ \lr{\texttt{fancyhdr}} استفاده کنید که کاملاً با \lr{\XePersian} سازگار است.
-\end{itemize}
-\section{قرار دادن عکس}
-قرار دادن عکس نیز به آسانی امکان پذیر است. هر چند که می‌توانید از دستورات
-\lr{\XeTeX}
- استفاده کنید اما دستور
-\verb|\includegraphics|
- پیشنهاد می‌شود.
-\section{جدول}
-به آسانی می‌توانید جدول خود را در
-\lr{\XePersian}
- تولید کنید.
-\section{حروف‌چینی یک متن در چند ستون}
-می‌توانید تا ۵ ستون داشته باشید. برای حروف‌چینی یک متن در چند ستون از محیط زیر استفاده می‌کنیم:
-
-\setLR
-\verb|\begin{multicols}{number of columns}|
-
-$\vdots$
-
-\verb|\end{multicols}|
-\setRL
-\chapter{تغییرات جدید}
-\begin{enumerate}
-\item
-تغییر \lr{Mapping} از \lr{farsidigits} به \lr{parsidigits}.
-\item
-معرفی دستور جدید \verb|\setparsimathsdigitsfont|.
-\item
-تغییر \verb|\pagenumbering{farsi}| به \verb|\pagenumbering{harfi}|.
-\item
-معرفی \verb|\pagenumbering{adadi}|.
-\item
-معرفی \verb|\twocolumntableofcontents|.
-\item
-اصلاح مشکلات موجود در فهرست مطالب بسته‌های \lr{amsart} و \lr{amsbook} و همچنین اصلاح مشکلات موجود در سربرگ و شماره صفحه تمام بسته‌های موجود.
-\item
-مستقل سازی \lr{\XePersian} از \lr{Arab\XeTeX}.
-\item
-ساختن فارسی به عنوان زبان اصلی تا دیگر نیازی به محیط آزاردهنده \lr{\texttt{farsi}} نباشد.
-\item
-معرفی محیط جدید و مفید \lr{\texttt{english}}.
-\item
-اصلاح چند باگ بزرگ.
-\item
-اصلاح عدم سازگاری \lr{xepersian} با نسخهٔ جدید \lr{bidi}
-\item
-درست چاپ شدن شماره بخش‌ها، فصل‌ها، قسمت‌ها، زیرقسمت‌ها و زیر زیر قسمت‌ها (در نسخهٔ قبلی این شماره‌ها از سمت مخالف (چپ) شروع می‌شدند).
-\item
-تغییر نوع شماره‌گذاری صفحه، بخش، فصل، قسمت، زیرقسمت و زیر زیر قسمت برای سازگاری کامل با سایر بسته‌ها.
-\item
-اضافه کردن امکان داشتن شماره صفحه به ترتیب حروف الفبای فارسی، برای عوض کردن شماره صفحه از عددی به حروفی کافی است فرمان \verb|\pagenumbering{harfi}| را به کار ببرید و اگر دوباره دوست داشتید شمارهٔ صفحه را از حروفی به عددی تغییر دهید کافی است از فرمان \verb|\pagenumbering{arabic}| استفاده کنید.
-\item
-امکان داشتن جدولی که در بعضی از خانه‌های آن بتوان به راحتی انگلیسی نوشت. لطفاً به مثال زیر توجه کنید:
-\begin{center}
-\begin{tabular}{|r|r|}\hline
-من و تو&تو و من\\ \hline
-\lr{me and you}&\lr{you and me}\\ \hline
-\end{tabular}
-\end{center}
-جدول بالا با کد زیر تولید شده است:
-
-\setLR
-\verb|\documentclass{article}|\\
-\verb|\usepackage{xepersian}|\\
-\verb|\begin{document}|\\
-\verb|\begin{center}|\\
-\verb|\begin{tabular}|\LR{\texttt{\{|r|r|\}}}\verb|\hline|\\
-\rl{من و تو}\verb|&|\rl{تو و من}\verb|\\ \hline|\\
-\verb|\lr{me and you}&\lr{you and me}\\ \hline|\\
-\verb|\end{tabular}|\\
-\verb|\end{center}|\\
-\verb|\end{document}|
-\setRL
-
-\item
-امکان داشتن شماره پیوست بر حسب حروف الفبا.
-
-\end{enumerate}
-\chapter{تشکر و قدردانی ویژه}
-بستهٔ \lr{\XePersian} نشانهٔ تلاش و زحمت بسیار آقایان مصطفی واحدی و مهدی امیدعلی است. بسیاری از کدهای اصلی توسط این دو دوست عزیزم نوشته شده است. در نسخهٔ کنونی نیز بیشتر تغییرات و اصلاحات توسط آقای مهدی امیدعلی صورت گرفته است. در اینجا لازم می‌دانم تشکر ویژه‌ای از آقایان مصطفی واحدی و مهدی امیدعلی نمایم.
-\end{document}
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/xepersian-mathsdigitspec.tex b/Master/texmf-dist/doc/xelatex/xepersian/xepersian-mathsdigitspec.tex
new file mode 100644
index 00000000000..345dcdc7766
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/xepersian-mathsdigitspec.tex
@@ -0,0 +1,50 @@
+\UnicodeMathSymbol{"1D7CE}{\mbfzero }{\mathord}{mathematical bold digit 0}%
+\UnicodeMathSymbol{"1D7CF}{\mbfone }{\mathord}{mathematical bold digit 1}%
+\UnicodeMathSymbol{"1D7D0}{\mbftwo }{\mathord}{mathematical bold digit 2}%
+\UnicodeMathSymbol{"1D7D1}{\mbfthree }{\mathord}{mathematical bold digit 3}%
+\UnicodeMathSymbol{"1D7D2}{\mbffour }{\mathord}{mathematical bold digit 4}%
+\UnicodeMathSymbol{"1D7D3}{\mbffive }{\mathord}{mathematical bold digit 5}%
+\UnicodeMathSymbol{"1D7D4}{\mbfsix }{\mathord}{mathematical bold digit 6}%
+\UnicodeMathSymbol{"1D7D5}{\mbfseven }{\mathord}{mathematical bold digit 7}%
+\UnicodeMathSymbol{"1D7D6}{\mbfeight }{\mathord}{mathematical bold digit 8}%
+\UnicodeMathSymbol{"1D7D7}{\mbfnine }{\mathord}{mathematical bold digit 9}%
+\UnicodeMathSymbol{"1D7D8}{\Bbbzero }{\mathord}{mathematical double-struck digit 0}%
+\UnicodeMathSymbol{"1D7D9}{\Bbbone }{\mathord}{mathematical double-struck digit 1}%
+\UnicodeMathSymbol{"1D7DA}{\Bbbtwo }{\mathord}{mathematical double-struck digit 2}%
+\UnicodeMathSymbol{"1D7DB}{\Bbbthree }{\mathord}{mathematical double-struck digit 3}%
+\UnicodeMathSymbol{"1D7DC}{\Bbbfour }{\mathord}{mathematical double-struck digit 4}%
+\UnicodeMathSymbol{"1D7DD}{\Bbbfive }{\mathord}{mathematical double-struck digit 5}%
+\UnicodeMathSymbol{"1D7DE}{\Bbbsix }{\mathord}{mathematical double-struck digit 6}%
+\UnicodeMathSymbol{"1D7DF}{\Bbbseven }{\mathord}{mathematical double-struck digit 7}%
+\UnicodeMathSymbol{"1D7E0}{\Bbbeight }{\mathord}{mathematical double-struck digit 8}%
+\UnicodeMathSymbol{"1D7E1}{\Bbbnine }{\mathord}{mathematical double-struck digit 9}%
+\UnicodeMathSymbol{"1D7E2}{\msanszero }{\mathord}{mathematical sans-serif digit 0}%
+\UnicodeMathSymbol{"1D7E3}{\msansone }{\mathord}{mathematical sans-serif digit 1}%
+\UnicodeMathSymbol{"1D7E4}{\msanstwo }{\mathord}{mathematical sans-serif digit 2}%
+\UnicodeMathSymbol{"1D7E5}{\msansthree }{\mathord}{mathematical sans-serif digit 3}%
+\UnicodeMathSymbol{"1D7E6}{\msansfour }{\mathord}{mathematical sans-serif digit 4}%
+\UnicodeMathSymbol{"1D7E7}{\msansfive }{\mathord}{mathematical sans-serif digit 5}%
+\UnicodeMathSymbol{"1D7E8}{\msanssix }{\mathord}{mathematical sans-serif digit 6}%
+\UnicodeMathSymbol{"1D7E9}{\msansseven }{\mathord}{mathematical sans-serif digit 7}%
+\UnicodeMathSymbol{"1D7EA}{\msanseight }{\mathord}{mathematical sans-serif digit 8}%
+\UnicodeMathSymbol{"1D7EB}{\msansnine }{\mathord}{mathematical sans-serif digit 9}%
+\UnicodeMathSymbol{"1D7EC}{\mbfsanszero }{\mathord}{mathematical sans-serif bold digit 0}%
+\UnicodeMathSymbol{"1D7ED}{\mbfsansone }{\mathord}{mathematical sans-serif bold digit 1}%
+\UnicodeMathSymbol{"1D7EE}{\mbfsanstwo }{\mathord}{mathematical sans-serif bold digit 2}%
+\UnicodeMathSymbol{"1D7EF}{\mbfsansthree }{\mathord}{mathematical sans-serif bold digit 3}%
+\UnicodeMathSymbol{"1D7F0}{\mbfsansfour }{\mathord}{mathematical sans-serif bold digit 4}%
+\UnicodeMathSymbol{"1D7F1}{\mbfsansfive }{\mathord}{mathematical sans-serif bold digit 5}%
+\UnicodeMathSymbol{"1D7F2}{\mbfsanssix }{\mathord}{mathematical sans-serif bold digit 6}%
+\UnicodeMathSymbol{"1D7F3}{\mbfsansseven }{\mathord}{mathematical sans-serif bold digit 7}%
+\UnicodeMathSymbol{"1D7F4}{\mbfsanseight }{\mathord}{mathematical sans-serif bold digit 8}%
+\UnicodeMathSymbol{"1D7F5}{\mbfsansnine }{\mathord}{mathematical sans-serif bold digit 9}%
+\UnicodeMathSymbol{"1D7F6}{\mttzero }{\mathord}{mathematical monospace digit 0}%
+\UnicodeMathSymbol{"1D7F7}{\mttone }{\mathord}{mathematical monospace digit 1}%
+\UnicodeMathSymbol{"1D7F8}{\mtttwo }{\mathord}{mathematical monospace digit 2}%
+\UnicodeMathSymbol{"1D7F9}{\mttthree }{\mathord}{mathematical monospace digit 3}%
+\UnicodeMathSymbol{"1D7FA}{\mttfour }{\mathord}{mathematical monospace digit 4}%
+\UnicodeMathSymbol{"1D7FB}{\mttfive }{\mathord}{mathematical monospace digit 5}%
+\UnicodeMathSymbol{"1D7FC}{\mttsix }{\mathord}{mathematical monospace digit 6}%
+\UnicodeMathSymbol{"1D7FD}{\mttseven }{\mathord}{mathematical monospace digit 7}%
+\UnicodeMathSymbol{"1D7FE}{\mtteight }{\mathord}{mathematical monospace digit 8}%
+\UnicodeMathSymbol{"1D7FF}{\mttnine }{\mathord}{mathematical monospace digit 9}%
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/xepersian-userguide.pdf b/Master/texmf-dist/doc/xelatex/xepersian/xepersian-userguide.pdf
new file mode 100644
index 00000000000..2d53b6c5d76
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/xepersian-userguide.pdf
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
new file mode 100644
index 00000000000..204b9df9c1a
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian/xepersian-userguide.tex
@@ -0,0 +1,411 @@
+\documentclass{article}
+\usepackage{makeidx}
+\makeindex
+\usepackage{pstricks}
+\usepackage{pst-func}
+\usepackage{pstricks-add}
+\usepackage{xepersian}
+\usepackage{persianpoem,fmultico}
+\newfontinstance\farsifont[Script=Arabic,Scale=1,Mapping=parsidigits]{XB Zar}
+\newfontinstance\nastaliq[Script=Arabic,Scale=1,Mapping=parsidigits]{IranNastaliq}
+\setdigitfont[Scale=1, Mapping=parsidigits]{XB Zar}
+\addtolength{\hoffset}{-2cm}
+\addtolength{\textwidth}{3cm}
+\newcommand{\textblue}[1]{{\addfontfeature{Color=0000FF}#1}}
+\usepackage{setspace}
+\usepackage{perpage}
+\numberwithin{equation}{section}
+\numberwithin{table}{section}
+\onehalfspacing
+\newcommand\femph[1]{\lr{''}#1\lr{``}}
+\frenchspacing
+\title{راهنمای بستهٔ \lr{\XePersian}}
+\author{گروه فارسی-لاتک\footnote{مصطفی واحدی \texttt{mostafa.vahedi@gmail.com}، وفا خلیقی \texttt{vafa.khalighi@students.mq.edu.au}، و مهدی امیدعلی \texttt{mehdioa@gmail.com}}}
+\begin{document}
+\maketitle
+\twocolumnstableofcontents
+\pagenumbering{farsi}
+\begin{abstract}
+\lr{\XePersian}
+یک بسته برای نگارش مستندات فارسی در
+\lr{\XeLaTeX}
+است.
+هدف \lr{\XePersian} این است که یک استفاده کنندهٔ معمولی قادر باشد به راحتی به حروف‌چینی فارسی بپردازد. در
+ حال حاضر \lr{\XePersian} با کلاسهای \lr{article, amsart, amsbook, report, book, bookest, refrep} و \lr{beamer} به زیبایی و آسانی کار می‌کند.
+ \end{abstract}
+\section{موارد مورد نیاز}
+برای استفاده از \lr{\XePersian} باید \lr{\XeTeX} روی سیستم شما نصب باشد. اگر از \lr{MikTex 2.7} یا بالاتر، و یا از \lr{TeXLive 2008}
+و یا بالاتر استفاده می‌کنید، \lr{\XeTeX} به طور خودکار روی سیستم شما نصب شده است. تنها کاری که باید در این صورت انجام دهید نصب و
+تنظیم یک ویرایشگر مناسب برای کار است. لیست کنترل زیر ابزارهای لازم را برای کار با این بسته به شما نشان می‌دهد.
+\begin{enumerate}
+\item توزیع مناسبی از تک مانند تکلایو یا میکتک.
+\item نرم‌افزار مناسب ویرایش متنهای یونیکد (در ویندوز \lr{notepad++}\footnote{قابل دریافت از \LR{\texttt{http://notepad-plus.sourceforge.net/}}} و در لینوکس \lr{gedit}).
+\item نرم‌افزار مناسب نمایش فایلهای پی.دی.اف (در ویندوز توصیه می‌شود از \lr{foxit reader}\footnote{قابل دریافت از \lr{\texttt{http://www.foxitsoftware.com/}}} به جای آکروبات ریدر استفاده شود).
+\end{enumerate}
+از آنجا که کاربران ایرانی معمولا از ویندوز استفاده می‌کنند و با توجه به اینکه یک ویرایشگر مناسب زندگی را برای کاربر بسیار راحت می‌کند، در ادامه
+روش نصب و تنظیم ویرایشگر مناسب را در ویندوز به طور کامل شرح می‌دهیم. توجه داشته باشید که فرض بر این است یک توزیع مناسب از تک (مانند تکلایو یا میکتک)
+ و همچنین فاکسیت ریدر روی سیستم شما نصب است.
+
+فایل نصب‌کنندهٔ \lr{notepad++} را اجرا کنید ( توجه داشته باشید که جدیدترین نسخه این فایل را از صفحهٔ خانگی این نرم‌افزار دریافت کرده باشید).
+سپس به صورتی که در شکلهای زیر نشان داده شده است نرم‌افزار را نصب و تنظیم کنید.
+
+\centerline{\XeTeXpicfile "notepad1.PNG" height 7cm}
+\centerline{\XeTeXpicfile "notepad2.PNG" height 5cm}
+\centerline{\XeTeXpicfile "notepad3.PNG" height 5cm}
+
+بعد از آخرین شکل، گزینهٔ \lr{save} را فشار دهید و فرمان را با نام \lr{xelatex} ذخیره کنید. از این به بعد با فشردن کلید \lr{F6} می‌توانید به راحتی
+فایل خود را پردازش کنید. بعد از یک بار پردازش، می‌توانید به راحتی با فشردن \lr{CTRL+F6} فایل خود را مستقیماً پردازش کنید.
+
+برای استفادهٔ بهینه از این ویرایشگر، بهتر است راهنمای آنرا مطالعه کنید. فقط به عنوان یک مطلب که ممکن است برای شما مفید باشد، هنگام ویرایش متنهای فارسی،
+با فشردن \lr{ALT+CTRL+R} صفحه نمایش از راست به چپ قرار می‌گیرد و بنابراین کار شما راحت‌تر می‌شود. برای برگشتن به حالت چپ‌به‌راست کافی است
+\lr{ALT+CTRL+L} را فشار دهید.
+\section{نمونهٔ فایل ورودی}
+یک نمونه فایل ورودی می‌تواند به صورت زیر باشد.
+
+\setLR
+\noindent\verb+\documentclass{book}+\\
+\verb+\usepackage{xepersian}+\\
+\verb+\newfontinstance\farsifont[Script=Arabic,Scale=1,Mapping=parsidigits]{XB Zar}+\\
+\verb+\setdigitfont[Script=Arabic,Mapping=farsidigits]{XB Zar}+\\
+\verb+\title{+\rl{عنوان }\verb+}+\\
+\verb+\author{+\rl{نام نویسنده}\verb+}+\\
+\verb+\begin{document}+\\
+\verb+\maketitle+\\
+\verb+\tableofcontents+\\
+\verb+\chapter{+\rl{فصل اول}\verb+}+\\
+\verb+\section{+\rl{بخش اول}\verb+}+\\
+\vdots\\
+\verb+\end{document}+
+\setRL
+
+همانطور که می‌بینید شکل فایل ورودی هیچ‌گونه تفاوتی با یک فایل استاندارد لاتک ندارد. تنها ممکن است فرمانهای خط سوم و چهارم این فایل نمونه برای شما
+نا آشنا باشند که در قسمتهای بعد به توضیح آنها می‌پردازیم. به طور کلی در استفاده از طبقه‌های استاندارد لاتک به جز فراخوانی بستهٔ \lr{\XePersian} هیچ
+کار اضافه‌ای لازم نیست که انجام دهید. تنها به عنوان یک توصیه، سعی کنید {\Large\nastaliq\textblue{ این بسته آخرین بسته‌ای باشد که فراخوانی می‌کنید.}} همچنین توجه داشته باشید که
+بسته‌های زیر به طور خودکار فراخوانی می‌شوند و شما نباید آنها را مستقیماً در فایل فراخوانی کنید.
+
+\begin{center}\lr{amsmath, amssymb, amsthm, graphicx.}\end{center}
+
+همچنین بسته \lr{\XePersian} هنوز قابلیت استفاده از طبقهٔ \lr{memoir} را ندارد، ولی در آینده این امکان نیز افزوده خواهد شد.
+\section{فرمانهای بسته}
+در این قسمت تعدادی از فرمانهای مفید را که لازم است بدانید شرح می‌دهیم. تعدادی از این فرمانها مربوط به خود بستهٔ \lr{\XePersian} است و تعدادی هم مربوط
+به بسته‌هایی است که این بسته به طور خودکار فراخوانی می‌کند، ولی لازم است که این فرمانها را بدانید. در جدول \ref{commands} فرمانهای بسته را مشاهده
+می‌کنید. همچنین در بسته چند نوع شمارنده تعریف شده است که در جدول \ref{counters} مشاهده می‌کنید.
+
+
+
+\begin{table}[hbp]
+\begin{center}
+\begin{tabular}{|r|l|}
+\hline
+ فرمان & شرح\\
+ \hline
+ \verb+\farsifont+& قلم فارسی را برای حروف‌چینی به کار می‌بندد (پیش‌فرض)\\
+\hline
+\verb+\setRL+&جهت پاراگرافها را راست‌ به ‌چپ می‌کند (پیش‌فرض) \\
+\hline
+ \verb+\setLR+&جهت پاراگرافها را چپ‌ به‌ راست می‌کند\\
+\hline
+\verb+\footnote{...}+&برای درج یک پانوشت فارسی \\
+\hline
+\verb+\Footnote{...}+&برای درج یک پانوشت انگلیسی \\
+\hline
+\verb+\today+&درج تاریخ جاری خورشیدی\\
+\hline
+\verb+\rldblcolumn+&ترتیب ستونها را در یک متن چندستونی از راست‌ به ‌چپ می‌کند (پیش‌فرض)\\
+\hline
+\verb+\lrdblcolumn+&ترتیب ستونها را در یک متن چند‌ستونی از چپ ‌به ‌راست می‌کند \\
+\hline
+\verb+\twocolumnstableofcontents+ & فهرست مطالب را در دو ستون می‌چیند (نیاز به فراخوانی \verb+fmultico+ دارد)\\
+\hline
+\verb+\lr{...}+&یک متن کوتاه انگلیسی را در یک پاراگراف فارسی قرار می‌دهد\\
+\hline
+ \verb+\rl{...}+&یک متن کوتاه فارسی را در یک پاراگراف انگلیسی قرار می‌دهد\\
+\hline
+\verb+\begin{english}+&شروع محیط انگلیسی \\
+ \verb+\end{english}+&پایان محیط انگلیسی\\
+\hline
+\end{tabular}
+\end{center}
+\caption{فرمانها}\label{commands}
+\end{table}
+
+\begin{table}[hbp]
+\begin{center}
+\begin{tabular}{|r|l|}
+\hline
+ شمارنده & شرح\\
+\hline
+\verb+arabic+&شمارندهٔ عربی اصلی لاتک برای سازگاری با بسته از نو تعریف شده است. \\
+\hline
+ \verb+farsi+&همان اثر شمارنده \verb+arabic+ اصلی لاتک را دارد.\\
+\hline
+\verb+adadi+& شمارنده را به صورت یک، دو، سه، \ldots تغییر می‌دهد. \\
+\hline
+\verb+harfi+&شمارنده را به صورت ا، ب، پ، \ldots تغییر می‌دهد.\\
+\hline
+\end{tabular}
+\end{center}
+\caption{شمارنده‌ها}\label{counters}
+\end{table}
+
+\section{استفاده از قلمهای مختلف}
+بستهٔ \lr{fontspec}، که به صورت خودکار فراخوانی می‌شود، امکان استفاده از قلمهای موجود در سیستم را فراهم می‌کند. برای استفاده از \lr{\XePersian}
+لازم است که حداقل یک قلم با نام \lr{farsifont} را تعریف کنید که به صورت زیر انجام می‌شود:
+
+\begin{english}\verb+\newfontinstance\farsifont[Script=Arabic,Scale=1,Mapping=parsidigits]{XB Zar}+\end{english}
+
+این فرمان، قلم \lr{XB Zar} را به عنوان قلم فارسی معرفی می‌کند. گزینهٔ \verb+Scale=Arabic+ ضروری است تا حروف فارسی به هم بچسبند. گزینهٔ
+\verb+Scale=1+ اندازهٔ قلم را یک برابر اندازهٔ نرمال آن تعریف می‌کند که مقدار ۱ قابل تغییر است. گزینهٔ \verb+Mapping=parsidigits+ اعداد را در محیط فارسی
+با ارقام فارسی نمایش می‌دهد.
+
+به همین ترتیب می‌توانید هر تعداد از قلمهایی را که مایل هستید، با نامهای مختلف تعریف کنید. مثلا فرمان
+
+\begin{english}\verb+\newfontinstance\nastaliq[Script=Arabic,Scale=2]{IranNastaliq}+\end{english}
+
+قلم نستعلیق را معرفی می‌کند که می‌توانید از آن به صورت زیر استفاده کنید:
+
+\setLR\begin{center}\verb+{\nastaliq+ \rl{نمونهٔ متن با قلم نستعلیق} \verb+}+\end{center}\setRL
+
+که اثر آن همانند متن زیر است:
+
+\begin{center}{\Large\nastaliq نمونهٔ متن با قلم نستعلیق}\end{center}
+
+قلمی را که اعداد در محیط ریاضی با آن نگارش می‌شوند می‌توانید به دلخواه انتخاب کنید. برای این کار، فرمان زیر را در سرآغاز فایل خود قرار دهید.
+
+\begin{english}
+\verb|\setdigitfont[|Scale=1, Mapping=parsidigits\verb|]{|XB Zar\verb|}|
+\end{english}
+
+به این ترتیب قلم \lr{XB Zar} را برای نمایش اعداد در فرمولها انتخاب می‌کنید. اگر قلم اعداد را مشخص نکنید، قلم پیش‌فرض مورد استفاده قرار می‌گیرد.
+
+همچنین می‌توانید قلمی را که با آن متنهای انگلیسی نگارش می‌شوند با فرمان زیر تعیین کنید.
+
+\begin{english}
+\verb|\setromanfont[|Scale=1, Mapping=tex-text\verb|]{|Times New Roman\verb|}|
+\end{english}
+
+\textblue{توجه داشته باشید که قلم انگلیسی باید بعد از قلم ریاضی تعریف شود.}
+ اگر قلم انگلیسی معرفی نشود، قلم استاندارد تک مورد استفاده قرار
+می‌گیرد.
+
+در آخر لازم است که بیان شود قلمهای \lr{farsiweb} به همراه این بسته ارائه شده است. همچنین قلمهای مفید و مجانی سری ایکس ۲ را می‌توانید
+از \texttt{http://wiki.irmug.org/index.php/X\_Series\_2} تهیه کنید.
+\section{حروف‌چینی شعر}
+برای حروف‌چینی شعر باید فرمان زیر را در سرآغاز فایل خود قرار دهید:
+
+\begin{english}
+\verb+\usepackage{+persianpoem,fmultico\verb+}+
+\end{english}
+بعد از این کار به راحتی می‌توانید شعر را حروف‌چینی کنید.
+{\nastaliq\doublespacing
+\begin{oldpoem}
+
+هله رفتیم و گرانی ز جمالت بردیم&
+جهت توشهٔ ره ذکر وصالت بردیم\\
+تا که ما را و ترا تذکرهٔ خوش باشد&
+دل خسته بتو دادیم و خیالت بردیم\\
+آن خیال رُخ خوبت که قمر بندهٔ اوست&
+وان خَم ابروی مانند هلالت بردیم\\
+و آن شکرخندهٔ خوبت که شکر تشنهٔ اوست&
+ز شکر خانهٔ مجموع خصالت بردیم\\
+چون کبوتر چو بپریم بتو بازآییم&
+زانکه ما این پَر و بال از پَر و بالت بردیم\\
+هر کجا پرد فرعی، بسوی اصل آید&
+هر چه داریم هم از عزّ و جلالت بردیم\\
+شمس تبریز شنو خدمت ما را زصبا&
+گر شمالست و صبا هم ز شمالت بردیم
+
+\end{oldpoem}
+}
+شعر بالا با کد زیر تولید شده است:
+
+\setLR
+\noindent\verb|\begin{oldpoem}|\\
+\rl{هله رفتیم و گرانی ز جمالت بردیم}\verb|&|\\
+\rl{جهت توشهٔ ره ذکر وصالت بردیم}\verb|\\|\\
+\rl{تا که ما را و ترا تذکرهٔ خوش باشد}\verb|&|\\
+\rl{دل خسته بتو دادیم و خیالت بردیم}\verb|\\|\\
+\rl{آن خیال رُخ خوبت که قمر بندهٔ اوست}\verb|&|\\
+\rl{وان خَم ابروی مانند هلالت بردیم}\verb|\\|\\
+\rl{و آن شکرخندهٔ خوبت که شکر تشنهٔ اوست}\verb|&|\\
+\rl{ز شکر خانهٔ مجموع خصالت بردیم}\verb|\\|\\
+\rl{چون کبوتر چو بپریم بتو بازآییم}\verb|&|\\
+\rl{زانکه ما این پَر و بال از پَر و بالت بردیم}\verb|\\|\\
+\rl{هر کجا پرد فرعی، بسوی اصل آید}\verb|&|\\
+\rl{هر چه داریم هم از عزّ و جلالت بردیم}\verb|\\|\\
+\rl{شمس تبریز شنو خدمت ما را زصبا}\verb|&|\\
+\rl{گر شمالست و صبا هم ز شمالت بردیم}\\
+\verb|\end{oldpoem}|\\
+\setRL
+
+این محیط دارای حالت ستاره‌دار نیز می‌باشد که اثر آن به صورت زیر است.
+\begin{oldpoem*}
+هله رفتیم و گرانی ز جمالت بردیم&
+جهت توشهٔ ره ذکر وصالت بردیم\\
+تا که ما را و ترا تذکرهٔ خوش باشد&
+دل خسته بتو دادیم و خیالت بردیم\\
+آن خیال رُخ خوبت که قمر بندهٔ اوست&
+وان خَم ابروی مانند هلالت بردیم\\
+و آن شکرخندهٔ خوبت که شکر تشنهٔ اوست&
+ز شکر خانهٔ مجموع خصالت بردیم\\
+چون کبوتر چو بپریم بتو بازآییم&
+زانکه ما این پَر و بال از پَر و بالت بردیم\\
+هر کجا پرد فرعی، بسوی اصل آید&
+هر چه داریم هم از عزّ و جلالت بردیم\\
+شمس تبریز شنو خدمت ما را زصبا&
+گر شمالست و صبا هم ز شمالت بردیم
+\end{oldpoem*}
+شعر بالا با کد زیر تولید شده است:
+
+\setLR
+\noindent\verb|\begin{oldpoem*}|\\
+\rl{هله رفتیم و گرانی ز جمالت بردیم}\verb|&|\\
+\rl{جهت توشهٔ ره ذکر وصالت بردیم}\verb|\\|\\
+\rl{تا که ما را و ترا تذکرهٔ خوش باشد}\verb|&|\\
+\rl{دل خسته بتو دادیم و خیالت بردیم}\verb|\\|\\
+\rl{آن خیال رُخ خوبت که قمر بندهٔ اوست}\verb|&|\\
+\rl{وان خَم ابروی مانند هلالت بردیم}\verb|\\|\\
+\rl{و آن شکرخندهٔ خوبت که شکر تشنهٔ اوست}\verb|&|\\
+\rl{ز شکر خانهٔ مجموع خصالت بردیم}\verb|\\|\\
+\rl{چون کبوتر چو بپریم بتو بازآییم}\verb|&|\\
+\rl{زانکه ما این پَر و بال از پَر و بالت بردیم}\verb|\\|\\
+\rl{هر کجا پرد فرعی، بسوی اصل آید}\verb|&|\\
+\rl{هر چه داریم هم از عزّ و جلالت بردیم}\verb|\\|\\
+\rl{شمس تبریز شنو خدمت ما را زصبا}\verb|&|\\
+\rl{گر شمالست و صبا هم ز شمالت بردیم}\\
+\verb|\end{oldpoem*}|\\
+\setRL
+\section{حروف‌چینی چند‌ستونی}
+برای حروف‌چینی یک متن در چند ستون از محیط زیر استفاده کنید. حداکثر تعداد ستونها ۵ است.
+
+\setLR
+\verb|\begin{multicols}{|\rl{تعداد ستونهای}\verb|}|
+
+$\vdots$
+
+\verb|\end{multicols}|
+\setRL
+
+\section{محیط مورد فارسی}
+محیط مورد برای استفاده در فارسی نیز تعریف شده است که در زیر مثال آنرا می‌بنید:
+
+$$
+\rcases{\mbox{مرد}\cr\mbox{زن}}\mbox{آدم}
+$$
+
+طرح بالا با کد زیر نوشته شده است.
+
+\setLR\verb|$$\rcases{\mbox{|\rl{مرد}\verb|}\cr\mbox{|\rl{زن}\verb|}}\mbox{|\rl{آدم}\verb|}$$|\setRL
+
+
+\section{تولید نمایه}
+به همراه این بسته، فایلی ارائه شده است که شما را قادر می‌سازد به راحتی نمایه برای مستندتان فراهم کنید. خود بسته هیچ‌گونه محدودیتی با نمایه‌سازی ندارد،
+ولی نرم‌افزار
+\lr{makeindex} هنگام مرتب کردن فایل نمایه، ترتیب بعضی از حروف را به درستی رعایت نمی‌کند.
+برای رفع این مشکل، استفاده از \lr{xindy} بجای \lr{makeindex} توصیه می‌شود.
+
+اگر از تکلایو ۲۰۰۸ استفاده می‌کنید \lr{xindy} به طور خودکار روی سیستم شما نصب است. کافی است فایل \lr{farsi.xdy} را که همراه این بسته
+ارائه شده است در دایرکتوری جاری قرار دهید و فرمانهای زیر را در خط فرمان اجرا کنید:
+
+\begin{english}
+\noindent\verb|tex2xindy <| filename.idx \verb|>| filename.raw\\
+\verb|xindy -I xindy -M| farsi.xdy filename.raw
+\end{english}
+
+\noindent بعد از انجام این کار، نمایهٔ مرتب شدهٔ شما آمادهٔ تزریق به مستند می‌شود.
+
+توجه داشته باشید که اگر می‌خواهید از نمایه استفاده کنید، باید شمارندهٔ صفحه را در حالت \lr{\texttt{farsi}} قرار دهید. البته شمارندهٔ صفحه به صورت
+پیش‌فرض در این حالت قرار دارد.
+\section{فرمولهای ریاضی}
+بسته با حروف‌چینی فرمولهای ریاضی هیچ‌گونه مشکلی ندارد و از آنجا که بسته‌های \lr{amsmath,amsthm,} و \lr{amssymb} به طور خودکار فراخوانی می‌شوند،
+اکیداً توصیه می‌شود از فرمانهای کلاف \lr{AMSLatex} استفاده کنید. توجه داشته باشید که محیط \texttt{eqnarray} کلا با بستهٔ \lr{amsmath}
+مشکل دارد و به خصوص شمارهٔ فرمول نوشته شده با این محیط ناپایدار است. به جای این محیط، از محیط \texttt{align} استفاده کنید که
+حروف‌چینی آن از \texttt{eqnarray} بهتر است و شمارهٔ آن نیز بدون مشکل قابل ارجاع است.
+\begin{align}
+a^2+b^2&=\sin x\label{eq1}\\
+10a+b&=\cos y\label{eq2}
+\end{align}
+
+فرمولهای بالا با کد زیر تولید شده‌اند.
+
+\begin{english}
+\begin{verbatim}
+\begin{align}
+a^2+b^2&=\sin x\label{eq1}\\
+1a+b&=\cos y\label{eq2}
+\end{align}
+\end{verbatim}
+\end{english}
+ارجاع به فرمول \eqref{eq1} به صورت طبیعی امکان پذیر است. برای اطلاعات بیشتر به \femph{مقدمه‌ای نه‌چندان کوتاه بر \lr{\LaTeXe}}
+%\footnote{قابل دسترسی از\texttt{http://www.ctan.org}}
+مراجعه کنید.
+\section{تهیهٔ اسلاید}
+برای تهیهٔ اسلاید، بسته به طور کامل با طبقهٔ \texttt{beamer} سازگار است. یک فایل نمونه برای استفاده از این بسته می‌تواند به صورت زیر باشد:
+
+\setLR
+\noindent\verb|\documentclass[hyperref=xetex]{beamer}|\\
+\verb|\usepackage{xepersian}|\\
+\verb|\title{|\rl{عنوان مطلب}\verb|}|\\
+\verb|\author{|\rl{نام نویسنده}\verb|}|\\
+\verb|\begin{document}|\\
+\verb|\frame{\maketitle}|\\
+\verb|\section{|\rl{یک قسمت}\verb|}|\\
+\verb|\frametitle{|\rl{مطلب}\verb|}|\\
+\verb|\framesubtitle{|\rl{زیر مطلب}\verb|}|
+
+$\vdots$
+
+\noindent\verb|\end{frame}|
+
+$\vdots$
+
+
+\noindent\verb|\end{document}|
+\setRL
+
+\section{استفاده از \lr{PSTricks}}
+تمامی امکانات استفاده از \lr{PSTricks} در بسته موجود است.
+
+\setLR
+ \psset{yunit=0.5cm,xunit=2cm}
+ \begin{pspicture*}(-3,-5)(3,10)
+ \psaxes[Dy=2]{->}(0,0)(-3,-5)(3,10)
+ \psset{linewidth=1.5pt}
+ \psPolynomial[coeff=0 0 0 1,linecolor=blue]{-2}{4}
+ \psPolynomial[coeff=0 0 0 1,linecolor=red,%
+ linestyle=dashed,Derivation=2]{-2}{4}
+ \psPolynomial[coeff=0 0 0 1,linecolor=cyan,%
+ linestyle=dotted,Derivation=3]{-2}{4}
+ \rput[lb](1.8,4){\textcolor{blue}{$f(x)=x^3$}}
+ \rput[lb](0.2,8){\textcolor{red}{$f^{\prime\prime}(x)=6x$}}
+ \rput[lb](-2,5){\textcolor{cyan}{$f^{\prime\prime\prime}(x)=6$}}
+ \end{pspicture*}
+\setRL
+
+شکل بالا با کد زیر تولید شده است.
+\begin{english}
+\begin{verbatim}
+\setLR
+ \psset{yunit=0.5cm,xunit=2cm}
+ \begin{pspicture*}(-3,-5)(3,10)
+ \psaxes[Dy=2]{->}(0,0)(-3,-5)(3,10)
+ \psset{linewidth=1.5pt}
+ \psPolynomial[coeff=0 0 0 1,linecolor=blue]{-2}{4}
+ \psPolynomial[coeff=0 0 0 1,linecolor=red,%
+ linestyle=dashed,Derivation=2]{-2}{4}
+ \psPolynomial[coeff=0 0 0 1,linecolor=cyan,%
+ linestyle=dotted,Derivation=3]{-2}{4}
+ \rput[lb](1.8,4){\textcolor{blue}{$f(x)=x^3$}}
+ \rput[lb](0.2,8){\textcolor{red}{$f^{\prime\prime}(x)=6x$}}
+ \rput[lb](-2,5){\textcolor{cyan}{$f^{\prime\prime\prime}(x)=6$}}
+ \end{pspicture*}
+\setRL
+\end{verbatim}
+\end{english}
+
+\section{امکانات آینده}
+در نظر است الگوی کاملی برای شکستن کلمات فارسی تهیه شود تا قابل استفاده با این بسته باشد. همچنین در نظر است برای نگارش پایان‌نامه‌، بسته‌ٔ مجزایی
+بر اساس این بسته تهیه شود. اگر امکانی خاص مد نظر شماست که این بسته از آن بی‌بهره است، لطفاً اطلاع دهید تا در ویرایشهای آیندهٔ
+این بسته مورد نظر قرار بگیرد.
+\end{document}
+