summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/xelatex/persian-bib/Persian-bib-userguide.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/xelatex/persian-bib/Persian-bib-userguide.tex')
-rw-r--r--Master/texmf-dist/doc/xelatex/persian-bib/Persian-bib-userguide.tex110
1 files changed, 94 insertions, 16 deletions
diff --git a/Master/texmf-dist/doc/xelatex/persian-bib/Persian-bib-userguide.tex b/Master/texmf-dist/doc/xelatex/persian-bib/Persian-bib-userguide.tex
index e667312b412..cc0dd57ca2d 100644
--- a/Master/texmf-dist/doc/xelatex/persian-bib/Persian-bib-userguide.tex
+++ b/Master/texmf-dist/doc/xelatex/persian-bib/Persian-bib-userguide.tex
@@ -1,5 +1,7 @@
\documentclass[a4paper]{article}
-% محمود امین‌طوسی، http://webpages.iust.ac.ir/mamintoosi
+% محمود امین‌طوسی، http://profs.hsu.ac.ir/mamintoosi
+% To do
+% http://qa.parsilatex.com/2551
%\versionnumber{0.6}
@@ -9,6 +11,7 @@
\usepackage[linktocpage=true,colorlinks,citecolor=blue,pagebackref=true]{hyperref}%
\usepackage[nonamebreak,square]{natbib}%nonamebreak,numbers,
\usepackage[top=30mm, bottom=30mm, left=30mm, right=30mm]{geometry}
+\usepackage{listings}
\usepackage{xepersian}
\settextfont[Scale=1]{XB Zar}%{XB Niloofar}
@@ -25,17 +28,17 @@
{\small بسم الله الرحمن الرحيم\\}
\vspace{2cm}
راهنمای استفاده از سبک‌های فارسی برای \textcolor{red}{\lr{\textsc{Bib}\TeX}}\\
- در \textcolor{green}{زی‌پرشین}\\
+ در \textcolor{blue}{زی‌پرشین}\\
\lr{(Persian-bib User Guide)}
}
\author{محمود امین‌طوسی و مصطفی واحدی\\
-\lr{http://www.parsilatex.com}\\
+\url{http://www.parsilatex.com}\\
\lr{\{m.amintoosi,mostafa.vahedi\} at gmail.com}
}
-
+\date{}
\begin{document}
\maketitle
-\vspace{2cm}
+%\vspace{2cm}
\tableofcontents
\section{مقدمه}
@@ -58,17 +61,29 @@
\section{سبک‌های فعلی قابل استفاده در زی‌پرشین}
-در حال حاضر فایلهای سبک زیر برای استفاده در زی‌پرشین آماده شده‌اند\footnote{برای دیدن و مقایسه‌ی خروجی این سبک‌ها کافیست برنامه‌ی پرل \lr{gen\_pdf} را -- که همراه با بسته‌ی \lr{Persian-bib} است -- اجرا کنید تا به صورت خودکار نمونه خروجی‌هایی با تمام این سبک‌ها تولید نماید.}:
+در حال حاضر فایلهای سبک زیر برای استفاده در زی‌پرشین آماده شده‌اند\footnote{برای دیدن و مقایسه‌ی خروجی سبک‌های مورد استفاده در اسناد فارسی، کافیست برنامه‌ی پرل \lr{gen\_pdf} را -- که همراه با بسته‌ی \lr{Persian-bib} است -- اجرا کنید تا به صورت خودکار نمونه خروجی‌هایی با تمام این سبک‌ها تولید نماید و یا به ویکی پارسی‌لاتک
+ (\url{http://wiki.parsilatex.com})
+ مراجعه فرمایید.}:
\begin{description}
\item [unsrt-fa.bst] این سبک متناظر با \lr{unsrt.bst} می‌باشد. مراجع به ترتیب ارجاع در متن ظاهر می‌شوند.
\item [plain-fa.bst] این سبک متناظر با \lr{plain.bst} می‌باشد. مراجع بر اساس نام‌خانوادگی نویسندگان، به ترتیب صعودی مرتب می‌شوند.
همچنین ابتدا مراجع فارسی و سپس مراجع انگلیسی خواهند آمد.
-\item [acm-fa.bst] این سبک متناظر با \lr{acm.bst} می‌باشد. شبیه \lr{plain-fa.bst} است. قالب مراجع کمی متفاوت است. اسامی نویسندگان انگلیسی با حروف بزرگ انگلیسی نمایش داده می‌شوند.
-\item [ieeetr-fa.bst] این سبک متناظر با \lr{ieeetr.bst} می‌باشد. مراجع مرتب نمی‌شوند.
+\item [acm-fa.bst] این سبک متناظر با \lr{acm.bst} می‌باشد. شبیه \lr{plain-fa.bst} است. قالب مراجع کمی متفاوت است. اسامی نویسندگان انگلیسی با حروف بزرگ انگلیسی نمایش داده می‌شوند. (مراجع مرتب می‌شوند)
+\item [ieeetr-fa.bst] این سبک متناظر با \lr{ieeetr.bst} می‌باشد. (مراجع مرتب نمی‌شوند)
%\item [persia-unsorted.bst] این سبک شبیه \lr{ieeetr-fa.bst} می‌باشد با این تفاوت که برخی نامها با حروف توپر نوشته شده‌اند.
-\item [plainnat-fa.bst] این سبک متناظر با \lr{plainnat.bst} می‌باشد. نیاز به بستهٔ \lr{natbib} دارد.
-\item [chicago-fa.bst] این سبک متناظر با \lr{chicago.bst} می‌باشد. نیاز به بستهٔ \lr{natbib} دارد.
-\item [asa-fa.bst] این سبک متناظر با \lr{asa.bst} می‌باشد. نیاز به بستهٔ \lr{natbib} دارد.
+\item [plainnat-fa.bst] این سبک متناظر با \lr{plainnat.bst} می‌باشد. نیاز به بستهٔ \lr{natbib} دارد. (مراجع مرتب می‌شوند)
+\item [chicago-fa.bst] این سبک متناظر با \lr{chicago.bst} می‌باشد. نیاز به بستهٔ \lr{natbib} دارد. (مراجع مرتب می‌شوند)
+\item [asa-fa.bst] این سبک متناظر با \lr{asa.bst} می‌باشد. نیاز به بستهٔ \lr{natbib} دارد. (مراجع مرتب می‌شوند)
+\item[plain-fa-inLTR]
+این سبک همان سبک
+\lr{plain-fa}
+می‌باشد ولی برای اسناد چپ به راست می‌تواند مورد استفاده قرار گیرد. منظور حالتی است که به عنوان مثال کل سند لاتین است و مایلیم یک یا چند مرجع فارسی هم داشته باشیم.
+\item[plain-fa-inLTR-beamer]
+این سبک مشابه سبک
+\lr{plain-fa-inLTR}
+است با این تفاوت که شامل اصلاحاتی جزیی برای استفاده در اسناد چپ به راست طبقه نوشتاری
+\lr{beamer}
+می‌باشد.
\end{description}
@@ -104,7 +119,7 @@ xelatex myfile
با قالبی خاص ذخیره می‌شود. به هر رکورد یک مدخل\LTRfootnote{Entry} گفته می‌شود. یک نمونه مدخل برای معرفی کتاب \lr{Digital Image Processing} در ادامه آمده است:
\begin{LTR}
\begin{verbatim}
-@BOOK{Gonzalez02image,
+@BOOK{Gonzalez02book,
AUTHOR = {Rafael Gonzalez and Richard Woods},
TITLE = {Digital Image Processing},
PUBLISHER = {Prentice-Hall, Inc.},
@@ -186,7 +201,8 @@ xelatex myfile
\end{latin}
نام مؤلفینِ اولین دو نمونه ارجاعِ بخش مثالها (بخش \ref{Sec:examples}) به همین‌ صورت در پاورقی ظاهر شده است.
-\item همانگونه که مشاهده می‌کنید با بستهٔ \lr{hyperref} مشکلی وجود ندارد، البته به شرط داشتن بستهٔ \lr{bidi}نسخهٔ ۱.۰.۴ (\lr{revision} ۱۹۰ به بعد) . فقط یک استثناءوجود دارد و آن هم رنگ مرجع در هنگامی است که قسمتی از اسامی مؤلفین یک مرجع درانتهای یک خط و قسمتی دیگر در ابتدای خط بعد قرار گیرد. در این حالت کل دو خط رنگی می‌شوند. راه حلی نسبی برای آن با گزینه \lr{nonamebreak} از بستهٔ \lr{natbib} و گزینه کشیده \lr{(Kashida)} از بستهٔ زی‌پرشین وجود دارد. در \lr{LuaPersian} که سبک فارسی در حال گسترشی توسط آقای خلیقی است این مشکل وجود ندارد.
+\item همانگونه که مشاهده می‌کنید با بستهٔ \lr{hyperref} مشکلی وجود ندارد، البته به شرط داشتن بستهٔ \lr{bidi}نسخهٔ ۱.۰.۴ (\lr{revision} ۱۹۰ به بعد) . فقط یک استثناءوجود دارد و آن هم رنگ مرجع در هنگامی است که قسمتی از اسامی مؤلفین یک مرجع درانتهای یک خط و قسمتی دیگر در ابتدای خط بعد قرار گیرد. در این حالت کل دو خط رنگی می‌شوند. راه حلی نسبی برای آن با گزینه \lr{nonamebreak} از بستهٔ \lr{natbib} و گزینه کشیده \lr{(Kashida)} از بستهٔ زی‌پرشین وجود دارد.
+%در \lr{LuaPersian} که سبک فارسی در حال گسترشی توسط آقای خلیقی است این مشکل وجود ندارد.
%یک مثال را ببینیم:در اینجا چند مرجع پشت سر هم داریم که از یک خط بیشتر شده‌اند: \citet{Omidali82phdThesis} و \citealp*{Khalighi87xepersian} و \citet{Amintoosi09precise,Amintoosi87afzayesh} اگر گزینه \lr{nonamebreak} را استفاده نکنید هر دو خط آبی خواهند شد. با استفاده از گزینهٔ مذکور که مربوط به بستهٔ \lr{natbib} است، این مشکل رنگی شدن دو خط برطرف می‌شود ولی ممکن است تنظیم خط به هم بخورد،‌ کمتر از طول خط شود و یا از حد خارج شود. این مشکل بسیاری از اوقات توسط گزینهٔ کشیده \lr{(Kashida)} در بستهٔ زی‌پرشین قابل حل است.
@@ -204,11 +220,58 @@ xelatex myfile
\begin{latin} \LRE{\verb+\LRE{\lr{\citealp{referenceTag}}}+} \end{latin}
%\newcommand\LRcite[1]{\LRE{\lr{\cite{#1}}}}
+\item
+در طبقه نوشتاری
+\lr{biditufte-book}
+صرفا می‌توانید از سبک‌های
+\lr{plainnat-fa}، \lr{chicago-fa} و \lr{asa-fa}
+ استفاده فرمایید.
-\item برای گزارش مشکل به تالار گفتگوی پارسی‌لاتک (\url{http://forum.parsilatex.com}) مراجعه فرمایید.
+\item برای گزارش مشکل به سایت پرسش و پاسخ پارسی‌لاتک
+ (\url{http://qa.parsilatex.com})
+ مراجعه فرمایید.
\end{itemize}
+\section{مراجع فارسی در اسناد لاتین}
+برای داشتن مراجع فارسی در اسناد لاتین می‌توانید از سبک‌های
+\lr{plain-fa-inLTR}
+\lr{plain-fa-inLTR-beamer}
+استفاده فرمایید. از آنجا که به احتمال زیاد کاربران این بخش با زبان انگلیسی راحت‌تر هستند، نحوه استفاده از آن به انگلیسی بیان می‌شود.
+\begin{latin}
+Suppose that you want to have Persian or Arabic references in your Left-to-Right document. In this case plain-fa-inLTR.bst in Persian-bib package is the right solution.
+You should insert the following codes in the premable of your document and use a the aforementioned style in your documnet:
+
+\begin{lstlisting}[language=tex,breaklines=true, basicstyle=\ttfamily, numberstyle=\footnotesize, numbersep=10pt, captionpos=b, frame=single, breakatwhitespace=false]
+\usepackage{fontspec}
+\newfontfamily\Persianfont[Script=Arabic,Scale=1]{A font with Persian glifs such az XB Zar}
+\makeatletter
+\TeXXeTstate=1
+\def\Persiantext#1{\begingroup\beginR\Persianfont#1\endR\endgroup}
+\makeatother
+\end{lstlisting}
+
+Note that the encoding of your .bib file should be UTF-8. As you know, your bibliography section should be as follow:
+\begin{verbatim}
+\bibliographystyle{plain-fa-inLTR}
+\bibliography{SomeReferences}
+\end{verbatim}
+
+If you have Persian references in your beamer presentation, please use `plain-fa-inLTR-beamer' and insert the following code in the premable of your document:
+
+\begin{lstlisting}[language=tex,breaklines=true, basicstyle=\ttfamily, numberstyle=\footnotesize, numbersep=10pt, captionpos=b, frame=single, breakatwhitespace=false]
+\usepackage{fontspec}
+\newfontfamily\Persianfont[Script=Arabic,Scale=1]{A font with Persian glifs such az XB Zar}
+\makeatletter
+\TeXXeTstate=1
+\def\Persiantext#1{\begingroup\beginR\Persianfont#1\hfill\endR\endgroup}
+\def\newRAblock#1{#1\hfill}
+\makeatother\end{lstlisting}
+%
+
+\end{latin}
+
\section{پرسش و پاسخ}
\begin{question}
آیا برای داشتن مراجع، استفاده از استیلهای فارسی الزامی است؟
@@ -270,15 +333,30 @@ xelatex myfile
\end{question}
\answer بسته‌ی \lr{natbib} را با گزینه‌ی \lr{numbers} فراخوانی نمایید.
+
+
+\begin{question}اگر سند من فارسی و مراجع من انگلیسی باشد و قصد از استیلهای انگلیسی استفاده داشته باشم چگونه عمل کنم؟
+ \end{question}
+\answer
+\begin{LTR}
+\begin{verbatim}
+ \setLTRbibitems
+ \makeatletter
+ \bidi@AtBeginEnvironment{thebibliography}{\latinfont}
+ \makeatother
+ \bibliographystyle{STYLE_FILE_NAME} % such as plain
+ \bibliography{BIB_FILE_NAME} %such as MyReferences
+\end{verbatim}
+\end{LTR}
+
\begin{question} آخرین نسخه‌های استیلهای فارسی را از کجا تهیه کنیم؟
\end{question}
\answer آخرین نسخه‌ی پایدار استیلهای فارسی با دانلود بسته‌ی \lr{Persian-bib} از آدرس:\\
\lr{\url{http://mirror.ctan.org/biblio/bibtex/contrib/persian-bib.zip}\hfill}\\
قابل استفاده است. آخرین نسخه‌ی در دست توسعه‌ی این استیلها نیز از سایت زیر قابل برداشت است:\\ \lr{\url{https://bitbucket.org/mamintoosi/persian-bib/}\hfill}
-
\section*{قدردانی}
-در اینجا لازم است از آقای \textcolor{blue}{وفا خلیقی} به خاطر زحمات بسیار ایشان در تولید بستهٔ \XePersian، نگهداری از بستهٔ \lr{bidi} و پاسخگویی به سؤالات بسیار کاربران و آقایان دکتر مهدی امیدعلی و مصطفی واحدی که با تلاشهای خود روحی تازه در کالبد لاتک فارسی دمیدند تشکر نمایم. همچنین از سایر دوستانمان مخصوصاً آقایان امیرمسعود پورموسی، سیدرضی علوی‌زاده، هادی صفی‌اقدم، وحید دامن‌افشان و محمد چهارسوقی که زحمات زیادی در سایت پارسی‌لاتک و در جهت توسعه‌ی زی‌پرشین کشیدند قدردانی می‌نمایم. از جناب عینیان نیز برای نکته مربوط به زیرنویس نام لاتین نویسندگان سپاس‌گزاری می‌کنم.
+در اینجا لازم است از آقای \textcolor{blue}{وفا خلیقی} به خاطر زحمات بسیار ایشان در تولید بستهٔ \XePersian، نگهداری از بستهٔ \lr{bidi} و پاسخگویی به سؤالات بسیار کاربران و آقایان دکتر مهدی امیدعلی و مصطفی واحدی که با تلاشهای خود روحی تازه در کالبد لاتک فارسی دمیدند تشکر نمایم. همچنین از سایر دوستانمان مخصوصاً آقایان وحید دامن‌افشان، فرشاد ترابی، هادی صفی‌اقدم، سیداحمد موسوی، ابوالفضل دیانت، امیرمسعود پورموسی و سیدرضی علوی‌زاده، که زحمات زیادی در سایت پارسی‌لاتک و در جهت توسعه‌ی زی‌پرشین کشیدند قدردانی می‌نمایم. از جناب عینیان نیز برای نکته مربوط به زیرنویس نام لاتین نویسندگان سپاس‌گزاری می‌کنم.
\bibliographystyle{asa-fa}%{chicago-fa}%{plainnat-fa}%
\bibliography{MyReferences}