diff options
Diffstat (limited to 'Master/texmf-dist/doc/xelatex/xepersian/user-guide.tex')
-rw-r--r-- | Master/texmf-dist/doc/xelatex/xepersian/user-guide.tex | 56 |
1 files changed, 44 insertions, 12 deletions
diff --git a/Master/texmf-dist/doc/xelatex/xepersian/user-guide.tex b/Master/texmf-dist/doc/xelatex/xepersian/user-guide.tex index 78f799d9d05..7e522958d8f 100644 --- a/Master/texmf-dist/doc/xelatex/xepersian/user-guide.tex +++ b/Master/texmf-dist/doc/xelatex/xepersian/user-guide.tex @@ -1,14 +1,14 @@ -\documentclass[a4paper,11pt]{refrep} +\documentclass[a4paper,11pt]{report} \usepackage{xepersian} -\pagestyle{headings} \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}}} +\title{حروفچینی فارسی در \lr{\XePersian}\\[0.2cm]نسخهٔ ۰/۱۶۱۱۱۱۱۱۱} +\author{وفا خلیقی\thanks{پست الکترونیک: \lr{vafa.khalighi@students.mq.edu.au}}} +\setlength\columnseprule{0.4pt} \begin{document} \maketitle -\tableofcontents +\twocolumnstableofcontents \chapter{مقدمه} -به حروفچینی فارسی با \lr{\XePersian} خوش آمدید. هدف \lr{\XePersian} ارائه یک بستهٔ کاملاً کامل و پایدار برای حروفچینی است. لطفاً به خاطر داشته باشید که \lr{\XePersian} هنوز در حالت آزمایش است و این نسخهٔ ۰/۱۶۱۱۱۱۱۱ از آن است. من سعی کردهام، میکنم و خواهم کرد تا تمام امکانات حروفچینی فارسی را در \lr{\XePersian} جمع کنم. اما این خود نیاز به آزمایش و امتحان دارد تا اشکالات پیدا و رفع شود. +به حروفچینی فارسی با \lr{\XePersian} خوش آمدید. هدف \lr{\XePersian} ارائه یک بستهٔ کاملاً کامل و پایدار برای حروفچینی است. لطفاً به خاطر داشته باشید که \lr{\XePersian} هنوز در حالت آزمایش است و این نسخهٔ ۰/۱۶۱۱۱۱۱۱۱ از آن است. من سعی کردهام، میکنم و خواهم کرد تا تمام امکانات حروفچینی فارسی را در \lr{\XePersian} جمع کنم. اما این خود نیاز به آزمایش و امتحان دارد تا اشکالات پیدا و رفع شود. لطفاً قبل از استفاده از \lr{\XePersian} این سند را بدقت بخوانید تا با دستورات و امکانات \lr{\XePersian} آشنا شوید. @@ -24,7 +24,7 @@ فلسفهٔ \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} قرار دارند. لطفاً قبل از انجام هر کاری این قلمها را روی سیستم خود نصب کنید. +تعدادی قلمهای فارسی مناسب با \lr{\XePersian} عرضه میشوند. این قلمها در پوشهٔ \lr{True Type Fonts} قرار دارند. لطفاً قبل از انجام هر کاری این قلمها را روی سیستم خود نصب کنید. \section{اسکلت یک متن فارسی ساده } \subsection{طبقات \lr{article} و \lr{amsart}} \setLR @@ -106,10 +106,10 @@ $\vdots$ \section{نکات} \begin{itemize} \item \lr{\XePersian} -قلم نازلی را برای قلم فارسی به عنوان پیشفرض استفاده میکند لذا باید این قلم را روی سیستم خود نصب کرده باشید. اگر میخواهید از قلم دیگری به عنوان قلم فارسی استفاده کنید، میتوانید دستور زیر را در پیشدرآمد فایل خود قرار دهید: +قلم زر را برای قلم فارسی به عنوان پیشفرض استفاده میکند لذا باید این قلم را روی سیستم خود نصب کرده باشید. اگر میخواهید از قلم دیگری به عنوان قلم فارسی استفاده کنید، میتوانید دستور زیر را بعد از \verb|\usepackage{xepersian}| در پیشدرآمد فایل خود قرار دهید: \setLR -\verb|\newfontfamily\farsifont[Script=Arabic,Scale=1.2,Mapping=farsidigits]{name of your font}| +\verb|\newfontfamily\farsifont[Script=Arabic,Scale=1.2,Mapping=parsidigits]{name of your font}| \setRL @@ -125,6 +125,15 @@ $\vdots$ \setRL +\item +دستور \verb|\setparsimathsdigitsfont| امکان انتخاب فونت اعداد فارسی را در محیط ریاضی به شما میدهد. اگر اصلاً از این فرمان استفاده نکنید، اعداد به صورت لاتین در محیط ریاضی درج میشوند. لطفاً توجه داشته باشید که این فرمان را باید بعد از \verb|\begin{document}| قرار دهید. شکل کلی این دستور به شکل زیر است: + + +\setLR +\verb|\setparsimathsdigitsfont{name of your font}| +\setRL + + \item \lr{\XePersian} بصورت پیشفرض بستههای \lr{amsmath, amssymb, amsthm} و دیگر بستههای مربوط را فراخوانی میکند لذا شما نباید این بستهها را دوباره در پیشدرآمد فایل خود فراخوانی کنید. @@ -164,7 +173,7 @@ $\vdots$ برای قرار دادن زیرنویس انگلیسی. متن انگلیسی را درون \verb|{}| قرار میدهیم. \vspace{.5cm} -\verb|\pagenumbering{farsi}|: +\verb|\pagenumbering{harfi}|: برای تبدیل شمارهٔ صفحات از عددی به حروف الفبای فارسی. \vspace{.5cm} @@ -172,6 +181,15 @@ $\vdots$ \verb|\pagenumbering{arabic}|: برای تبدیل شمارهٔ صفحات از حروفی به عددی. +\vspace{.5cm} + +\verb|\pagenumbering{adadi}|: +برای تبدیل شماره صفحات به عددی که با حروف نوشته میشود، مانند یک، دو، سه و ... + +\vspace{.5cm} + +\verb|\twocolumnstableofcontents|: +برای حروفچینی فهرست مطالب در دو ستون. مانند فهرست مطالب این سند. \newpage @@ -181,7 +199,7 @@ $\vdots$ \vspace{0.5cm} -لطفاً به خاطر داشته باشید که برای حروفچینی شعر نیازی به قراردادن بستهای خاص ندارید؛ \lr{\XePersian} این کار را بصورت خودکار انجام میدهد. +لطفاً به خاطر داشته باشید که برای حروفچینی شعر نیازی به قراردادن بستهای خاص ندارید؛ \lr{\XePersian} این کار را بصورت خودکار انجام میدهد. هدف ما در اینجا فقط معرفی این محیط میباشد، اگر قصد دارید این محیط را به طور کامل فرا گیرید، لطفاً به آخرین راهنمای فارسیتک مراجعه فرمائید. \subsection{حروفچینی شعر سنتی} حروفچینی شعر سنتی در محیطی به نام \lr{oldpoem} انجام میگیرد. این محیط دو حالت دارد: \subsubsection{حالت معمولی} @@ -305,6 +323,18 @@ $\vdots$ \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}} نباشد. @@ -319,7 +349,7 @@ $\vdots$ \item تغییر نوع شمارهگذاری صفحه، بخش، فصل، قسمت، زیرقسمت و زیر زیر قسمت برای سازگاری کامل با سایر بستهها. \item -اضافه کردن امکان داشتن شماره صفحه به ترتیب حروف الفبای فارسی، برای عوض کردن شماره صفحه از عددی به حروفی کافی است فرمان \verb|\pagenumbering{farsi}| را به کار ببرید و اگر دوباره دوست داشتید شمارهٔ صفحه را از حروفی به عددی تغییر دهید کافی است از فرمان \verb|\pagenumbering{arabic}| استفاده کنید. +اضافه کردن امکان داشتن شماره صفحه به ترتیب حروف الفبای فارسی، برای عوض کردن شماره صفحه از عددی به حروفی کافی است فرمان \verb|\pagenumbering{harfi}| را به کار ببرید و اگر دوباره دوست داشتید شمارهٔ صفحه را از حروفی به عددی تغییر دهید کافی است از فرمان \verb|\pagenumbering{arabic}| استفاده کنید. \item امکان داشتن جدولی که در بعضی از خانههای آن بتوان به راحتی انگلیسی نوشت. لطفاً به مثال زیر توجه کنید: \begin{center} @@ -347,4 +377,6 @@ $\vdots$ امکان داشتن شماره پیوست بر حسب حروف الفبا. \end{enumerate} +\chapter{تشکر و قدردانی ویژه} +بستهٔ \lr{\XePersian} نشانهٔ تلاش و زحمت بسیار آقایان مصطفی واحدی و مهدی امیدعلی است. بسیاری از کدهای اصلی توسط این دو دوست عزیزم نوشته شده است. در نسخهٔ کنونی نیز بیشتر تغییرات و اصلاحات توسط آقای مهدی امیدعلی صورت گرفته است. در اینجا لازم میدانم تشکر ویژهای از آقایان مصطفی واحدی و مهدی امیدعلی نمایم. \end{document} |