persian-bib (14mar15)

git-svn-id: svn://tug.org/texlive/trunk@36511 c570f23f-e606-0410-a88d-b1316a301751

5 files changed, 112 insertions, 25 deletions

diff --git a/Master/texmf-dist/doc/xelatex/persian-bib/MyReferences.bib b/Master/texmf-dist/doc/xelatex/persian-bib/MyReferences.bib
index eca653aba97..a57dfdf98ab 100644
--- a/Master/texmf-dist/doc/xelatex/persian-bib/MyReferences.bib
+++ b/Master/texmf-dist/doc/xelatex/persian-bib/MyReferences.bib
@@ -53,8 +53,7 @@
   ADDRESS =      {تهران، ایران},
   month = 		 {اسفند},
   pages = {101--108},
-  LANGUAGE =     {Persian},  
-  url = {http://www.civilica.com/Paper-ACCSI14-ACCSI14_107.htm}
+  LANGUAGE =     {Persian}
 }
 
 @article{Baker02limits,
@@ -93,7 +92,7 @@
 @MISC{Khalighi87xepersian,
   AUTHOR =      {خلیقی,وفا},
   TITLE =        {زی‌پرشین (\lr{\XePersian}): بسته فارسی برای حروف‌چینی در \lr{\LaTeX2e}},
-  HOWPUBLISHED =    {\lr{\href{HTTP://BITBUCKET.ORG/VAFA/XEPERSIAN}{HTTP://BITBUCKET.ORG/VAFA/XEPERSIAN}}},
+  HOWPUBLISHED =    {\lr{\href{http://ctan.org/pkg/xepersian}{http://ctan.org/pkg/xepersian}}},
   YEAR =         {۱۳۸۷},
   LANGUAGE =     {Persian}
   }
diff --git a/Master/texmf-dist/doc/xelatex/persian-bib/Persian-bib-userguide.pdf b/Master/texmf-dist/doc/xelatex/persian-bib/Persian-bib-userguide.pdf
index bb916c78bac..629709eb770 100644
--- a/Master/texmf-dist/doc/xelatex/persian-bib/Persian-bib-userguide.pdf
+++ b/Master/texmf-dist/doc/xelatex/persian-bib/Persian-bib-userguide.pdf
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}
diff --git a/Master/texmf-dist/doc/xelatex/persian-bib/README b/Master/texmf-dist/doc/xelatex/persian-bib/README
index 27e95870691..cdb10011375 100644
--- a/Master/texmf-dist/doc/xelatex/persian-bib/README
+++ b/Master/texmf-dist/doc/xelatex/persian-bib/README
@@ -1,7 +1,7 @@
-Persian-bib, V0.6			2011/07/10
+Persian-bib, V0.8			2015/03/14
 Persian translations of some BibTeX styles
-Author: Mahmood Amintoosi, http://profsite.sttu.ac.ir/mamintoosi
-Copyright � 2009�2011
+Author: Mahmood Amintoosi, http://profs.hsu.ac.ir/mamintoosi
+Copyright � 2009�2016
 It may be distributed and/or modified under the LaTeX Project Public License,
 version 1.3c or higher (your choice). The latest version of
 this license is at: http://www.latex-project.org/lppl.txt
@@ -15,7 +15,9 @@ Unlike bib-fr package which can be used only for French references, the Persian
 .bst files simultaneously handle both Latin and Persian references. 
 
 File 'cp1256fa.csf' is prepared for correct sorting of Persian references and 
-three fields named 'LANGUAGE', 'TRANSLATOR' and 'AUTHORFA' are defined. 
+three fields named 'LANGUAGE', 'TRANSLATOR' and 'AUTHORFA' are defined. This
+file has a bit modification with respect to its previous version (0.6) according
+to PersianAcademy:  http://www.persianacademy.ir
 
 Setting 'LNAGUAGE' to 'Persian' makes the reference direction Left-to-Right and 
 makes BibTeX to use Persian translations of keywords such as 'et al.'. 
@@ -32,11 +34,19 @@ The user should mention the Persian equivalent of the author(s) name(S),
 for proper referencing in the text. If this field is omitted, the original 
 author name, in 'AUTHOR' will be used.
 
+Currently  7 files unsrt-fa.bst, acm-fa.bst, ieeetr-fa.bst, plain-fa.bst,
+Asa-fa.bst, chicago-fa.bst and plainnat-fa.bst are modified for Persian 
+documents prepared with XePersian (a Persian typesetting package over XeTeX).
+Hence this package is dependent to XePersian Package.
+From version 0.8 (2015/03/14), two other styles 'plain-fa-inLTR' and 
+'plain-fa-inLTR-beamer' are added to the package. These styles are prepared for
+inserting Persian references in LTR documents which are dependent to bidi
+package.
+
 Current Persian bst files work fine with hyperref and natbib packages.
 
 Persian translations of key-words such as 'et al.' can be changed with other translations.
 If you modify anything, however, please change the name of the file.
 
 Mahmood Amintoosi  <m.amintoosi@gmail.com>
-http://bitbucket.org/mamintoosi/persian-bib/
-
+http://www.parsilatex.com/
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/xelatex/persian-bib/bibtex-example.pdf b/Master/texmf-dist/doc/xelatex/persian-bib/bibtex-example.pdf
deleted file mode 100644
index 58a755473e1..00000000000
--- a/Master/texmf-dist/doc/xelatex/persian-bib/bibtex-example.pdf
+++ /dev/null