diff options
Diffstat (limited to 'Master')
12 files changed, 371 insertions, 166 deletions
diff --git a/Master/texmf-dist/bibtex/bst/iran-bibtex/iran-unsrt.bst b/Master/texmf-dist/bibtex/bst/iran-bibtex/iran-unsrt.bst index 0ad33155dc3..cd7955b90a4 100644 --- a/Master/texmf-dist/bibtex/bst/iran-bibtex/iran-unsrt.bst +++ b/Master/texmf-dist/bibtex/bst/iran-bibtex/iran-unsrt.bst @@ -1,6 +1,6 @@ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %% -%% This file is “iran-unsrt.bst”, v0.1.0 (2024/01/8) +%% This file is “iran-unsrt.bst”, v0.1.1 (2024-05-06) %% generated with the DOCSTRIP utility, then modified to support %% bilingual (English/Latin, and Persian/Farsi) in accordance with the %% “Iran Manual of Style Citation Guide” (1st edn., 2016). @@ -1447,15 +1447,10 @@ FUNCTION {format.full.label.names} if$ t "others" = { - " " * bbl.etal * + " " * label.etal * } { - numnames #2 > - { label.comma * } - 'skip$ - if$ - label.and - separate.by.space * t * + label.comma * label.and separate.by.space * t * } if$ } diff --git a/Master/texmf-dist/bibtex/bst/iran-bibtex/iran-year.bst b/Master/texmf-dist/bibtex/bst/iran-bibtex/iran-year.bst index 06bae75f44c..cb7feac8abd 100644 --- a/Master/texmf-dist/bibtex/bst/iran-bibtex/iran-year.bst +++ b/Master/texmf-dist/bibtex/bst/iran-bibtex/iran-year.bst @@ -1,6 +1,6 @@ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %% -%% This file is “iran-year.bst”, v0.1.0 (2024/01/8) +%% This file is “iran-year.bst”, v0.1.1 (2024-05-06) %% generated with the DOCSTRIP utility, then modified to support %% bilingual (English/Latin, and Persian/Farsi) in accordance with the %% “Iran Manual of Style Citation Guide” (1st edn., 2016). @@ -1448,15 +1448,10 @@ FUNCTION {format.full.label.names} if$ t "others" = { - " " * bbl.etal * + " " * label.etal * } { - numnames #2 > - { label.comma * } - 'skip$ - if$ - label.and - separate.by.space * t * + label.comma * label.and separate.by.space * t * } if$ } diff --git a/Master/texmf-dist/bibtex/bst/iran-bibtex/iran.bst b/Master/texmf-dist/bibtex/bst/iran-bibtex/iran.bst index e1575ba6be3..7a76ceb1c9c 100644 --- a/Master/texmf-dist/bibtex/bst/iran-bibtex/iran.bst +++ b/Master/texmf-dist/bibtex/bst/iran-bibtex/iran.bst @@ -1,6 +1,6 @@ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %% -%% This file is “iran.bst”, v0.4.0 (2024/01/8) +%% This file is “iran.bst”, v0.4.1 (2024-05-06) %% generated with the DOCSTRIP utility, then modified to support %% bilingual (English/Latin, and Persian/Farsi) in accordance with the %% “Iran Manual of Style Citation Guide” (1st edn., 2016). @@ -1448,15 +1448,10 @@ FUNCTION {format.full.label.names} if$ t "others" = { - " " * bbl.etal * + " " * label.etal * } { - numnames #2 > - { label.comma * } - 'skip$ - if$ - label.and - separate.by.space * t * + label.comma * label.and separate.by.space * t * } if$ } diff --git a/Master/texmf-dist/bibtex/bst/iran-bibtex/iranlatin-unsrt.bst b/Master/texmf-dist/bibtex/bst/iran-bibtex/iranlatin-unsrt.bst index 21624b47552..e34c05b977c 100644 --- a/Master/texmf-dist/bibtex/bst/iran-bibtex/iranlatin-unsrt.bst +++ b/Master/texmf-dist/bibtex/bst/iran-bibtex/iranlatin-unsrt.bst @@ -1,6 +1,6 @@ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %% -%% This file is “iranlatin-unsrt.bst”, v0.1.0 (2024/01/8) +%% This file is “iranlatin-unsrt.bst”, v0.1.1 (2024-05-06) %% created by modifying “iranlatin.bst” file in accordance with the %% “Iran Manual of Style Citation Guide” (1st edn., 2016) to support %% English/Latin only. @@ -1107,12 +1107,7 @@ FUNCTION {format.full.label.names} " " * bbl.etal * } { - numnames #2 > - { bbl.comma * } - 'skip$ - if$ - bbl.and - separate.by.space * t * + bbl.comma * bbl.and separate.by.space * t * } if$ } diff --git a/Master/texmf-dist/bibtex/bst/iran-bibtex/iranlatin-year.bst b/Master/texmf-dist/bibtex/bst/iran-bibtex/iranlatin-year.bst index fe31ac79885..045f3f34841 100644 --- a/Master/texmf-dist/bibtex/bst/iran-bibtex/iranlatin-year.bst +++ b/Master/texmf-dist/bibtex/bst/iran-bibtex/iranlatin-year.bst @@ -1,6 +1,6 @@ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %% -%% This file is “iranlatin-year.bst”, v0.1.0 (2024/01/8) +%% This file is “iranlatin-year.bst”, v0.1.1 (2024-05-06) %% created by modifying “iranlatin.bst” file in accordance with the %% “Iran Manual of Style Citation Guide” (1st edn., 2016) to support %% English/Latin only. @@ -1108,12 +1108,7 @@ FUNCTION {format.full.label.names} " " * bbl.etal * } { - numnames #2 > - { bbl.comma * } - 'skip$ - if$ - bbl.and - separate.by.space * t * + bbl.comma * bbl.and separate.by.space * t * } if$ } diff --git a/Master/texmf-dist/bibtex/bst/iran-bibtex/iranlatin.bst b/Master/texmf-dist/bibtex/bst/iran-bibtex/iranlatin.bst index d56034edade..a5095e258ce 100644 --- a/Master/texmf-dist/bibtex/bst/iran-bibtex/iranlatin.bst +++ b/Master/texmf-dist/bibtex/bst/iran-bibtex/iranlatin.bst @@ -1,6 +1,6 @@ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %% -%% This file is “iranlatin.bst”, v0.1.0 (2024/01/8) +%% This file is “iranlatin.bst”, v0.1.1 (2024-05-06) %% created by modifying “iran.bst” file in accordance with the %% “Iran Manual of Style Citation Guide” (1st edn., 2016) to support %% English/Latin only. @@ -1108,12 +1108,7 @@ FUNCTION {format.full.label.names} " " * bbl.etal * } { - numnames #2 > - { bbl.comma * } - 'skip$ - if$ - bbl.and - separate.by.space * t * + bbl.comma * bbl.and separate.by.space * t * } if$ } diff --git a/Master/texmf-dist/doc/bibtex/iran-bibtex/README.md b/Master/texmf-dist/doc/bibtex/iran-bibtex/README.md index 5c730faac68..1da64ac767d 100644 --- a/Master/texmf-dist/doc/bibtex/iran-bibtex/README.md +++ b/Master/texmf-dist/doc/bibtex/iran-bibtex/README.md @@ -28,7 +28,13 @@ The current version of this package (v0.3.0, and higher) supports ten types of e ### Load package -Load the `iran-bibtex` package in your LaTeX file by using the `\usepackage[<bibstyle>]{iran-bibtex}` command in the preamble. With this package, there's no need to explicitly set the bibliography style using the `\bibliographystyle{<bibstyle>}` command anymore. It is recommended to load the `iran-bibtex` package before the `hyperref` package for optimal performance. +To use the `iran-bibtex` package in your LaTeX document, simply include the command `\usepackage[<bibstyle>,<options>]{iran-bibtex}` in the preamble. + +With this package, there's no need to explicitly set the bibliography style using the `\bibliographystyle{<bibstyle>}` command. + +Any additional options specified as `<options>` will be passed to and processed by the [natbib](https://ctan.org/pkg/natbib) package. + +For optimal performance, it's recommended to load the `iran-bibtex` package before the `hyperref` package. ### Package's options as `<bibstyle>` @@ -36,13 +42,25 @@ The bibliography styles included in this package are organized into two distinct There are five different type of `<bibstyle>` options as follows: -| No. | Options | Description | -| :-: | :---------------------------------- | :---------- | -|1 |`iran`<br>`iranlatin` | Author-date citation format, with reference items are arranged in alphabetical order. | -|2 |`iran-plain`<br>`iranlatin-plain` | Numerical labeled citation format, with reference items are both alphabetically sorted and numerically labeled. These styles are closely resembling the standard `plain` style. | -|3 |`iran-year`<br>`iranlatin-year` | Author-date citation format, with reference items are arranged in chronological order by year. | -|4 |`iran-plainyr`<br>`iranlatin-plainyr`| Numerical labeled citation format, with reference items are both chronologically by year sorted and numerically labeled. | -|5 |`iran-unsrt`<br>`iranlatin-unsrt` | Numerical labeled citation format, with reference items are sorted by citation order and numerically labeled. These styles are closely resembling the standard `unsrt` style. | + 1. For Persian documents (produced by [xepersian](https://ctan.org/pkg/xepersian) package) + +| No. | Options | Description | +| :-: | :------------ | :---------- | +|1 |`iran` | Author-date citation format, with reference items are arranged in alphabetical order. | +|2 |`iran-plain` | Numerical labeled citation format, with reference items are both alphabetically sorted and numerically labeled. This style is closely resembling the standard `plain` style. | +|3 |`iran-year` | Author-date citation format, with reference items are arranged in chronological order by year. | +|4 |`iran-plainyr` | Numerical labeled citation format, with reference items are both chronologically by year sorted and numerically labeled. | +|5 |`iran-unsrt` | Numerical labeled citation format, with reference items are sorted by citation order and numerically labeled. This style is closely resembling the standard `unsrt` style. | + + 2. For non-Persian documents (produced by any processor) + +| No. | Options | Description | +| :-: | :----------------- | :---------- | +|1 |`iranlatin` | Author-date citation format, with reference items are arranged in alphabetical order. | +|2 |`iranlatin-plain` | Numerical labeled citation format, with reference items are both alphabetically sorted and numerically labeled. This style is closely resembling the standard `plain` style. | +|3 |`iranlatin-year` | Author-date citation format, with reference items are arranged in chronological order by year. | +|4 |`iranlatin-plainyr` | Numerical labeled citation format, with reference items are both chronologically by year sorted and numerically labeled. | +|5 |`iranlatin-unsrt` | Numerical labeled citation format, with reference items are sorted by citation order and numerically labeled. This style is closely resembling the standard `unsrt` style. | ### Compilation @@ -93,6 +111,11 @@ If you want to report any bugs or issues, please use [the issue tracker](https:/ ## Change log +### Version 0.4.1 (2024/05/6) + + 1. Made some improvements. + 2. Minor bugs have been fixed. + ### Version 0.4.0 (2024/01/8) 1. Implemented several improvements. diff --git a/Master/texmf-dist/doc/bibtex/iran-bibtex/iran-bibtex-structure.pdf b/Master/texmf-dist/doc/bibtex/iran-bibtex/iran-bibtex-pattern.pdf Binary files differindex 4c6f7cfd765..c7aaac23d1d 100644 --- a/Master/texmf-dist/doc/bibtex/iran-bibtex/iran-bibtex-structure.pdf +++ b/Master/texmf-dist/doc/bibtex/iran-bibtex/iran-bibtex-pattern.pdf diff --git a/Master/texmf-dist/doc/bibtex/iran-bibtex/iran-bibtex-structure.tex b/Master/texmf-dist/doc/bibtex/iran-bibtex/iran-bibtex-pattern.tex index acfb59dce84..76ef4209898 100644 --- a/Master/texmf-dist/doc/bibtex/iran-bibtex/iran-bibtex-structure.tex +++ b/Master/texmf-dist/doc/bibtex/iran-bibtex/iran-bibtex-pattern.tex @@ -16,17 +16,17 @@ \begin{document} -\title{خلاصهای از ساختار چیدمان پیادهشدهی مشخصهها در شیوهی استاددهی ایران} +\title{خلاصهای از الگوی چیدمان مشخصهها در فهرستنویسی منبعها به شیوهی استناددهی ایران} \author{فرشاد رسولی\thanks{رایانامه: \url{farshad.rasuli@gmail.com}}} -\date{نسخهی ۰٫۴٫۰ --- ۱۸ دی ۱۴۰۲} +\date{نسخهی ۰٫۴٫۱ --- ۱۷ اردیبهشت ۱۴۰۳} \maketitle \begin{description} \item[مدخل (\lr{entry}):] -به هر اثری که اطلاعات شناسنامهای آن برای استناددهی در نوشتار وارد میگردد گفته میشود. مدخل میتواند از نوع \verb|@book|، \verb|@incollection|، \verb|@article|، \verb|@inproceeding|، \verb|@masterthesis|، \verb|@phdthesis|، \verb|@misc|، و غیره باشد. +به هر اثری که اطلاعات شناسنامهای آن برای استناددهی در نوشتار وارد میگردد گفته میشود. مدخل میتواند از نوع \verb|@book|، \verb|@incollection|، \verb|@article|، \verb|@inproceeding|، \verb|@masterthesis|، \verb|@phdthesis|، \verb|@misc| باشد. \item[مشخصه (\lr{field}):] -به هر یک از مشخصههای شناسنامهای مدخل مانند \lr{\tt author}، \lr{\tt title}، \lr{\tt year}، و غیره گفته میشود. +به هر یک از مشخصههای شناسنامهای مدخل مانند \lr{\tt author}، \lr{\tt title}، \lr{\tt year} گفته میشود. \end{description} @@ -524,7 +524,7 @@ \section{پارسا (پایاننامهی کارشناسیارشد، و رسالهی دکتری)} -برای استناد به پایاننامهی کارشناسیارشد از مدخل \verb|@mastersthesis| و برای استناد به رسالهی دکتری از مدخل \verb|@phdthesis| استفاده کنید. الگوی چیدمان مشخصههای مدخل مقاله در ادامه ارائه شده است. +برای استناد به پایاننامهی کارشناسیارشد از مدخل \verb|@mastersthesis| و برای استناد به رسالهی دکتری از مدخل \verb|@phdthesis| استفاده کنید. الگوی چیدمان مشخصههای مدخل پارسا در ادامه ارائه شده است. @@ -639,7 +639,7 @@ -\subsection{اثرهای متفرقه که زیر نام نویسنده مرتب میشود} +\subsection{اثر متفرقه که زیر نام نویسنده مرتب میشود} اگر برای مدخل \verb|@misc|، مشخصهی \verb|author| وارد گردد، زیر نام نویسنده مرتب میشود. \begin{itemize}[nosep] @@ -656,7 +656,7 @@ -\subsection{اثرهای منتشر نشده که زیر عنوان مرتب میشود} +\subsection{اثر متفرقه که زیر عنوان مرتب میشود} اگر برای مدخل \verb|@misc|، مشخصهی \verb|author| وارد نشود، باید مشخصهی \verb|key| آن مدخل برابر با مشخصهی \verb|title| وارد شود که زیر عنوان مرتب گردد. \begin{itemize}[nosep] diff --git a/Master/texmf-dist/doc/bibtex/iran-bibtex/iran-bibtex-userguide-fa.pdf b/Master/texmf-dist/doc/bibtex/iran-bibtex/iran-bibtex-userguide-fa.pdf Binary files differnew file mode 100644 index 00000000000..382d98a821d --- /dev/null +++ b/Master/texmf-dist/doc/bibtex/iran-bibtex/iran-bibtex-userguide-fa.pdf diff --git a/Master/texmf-dist/doc/bibtex/iran-bibtex/iran-bibtex-userguide-fa.tex b/Master/texmf-dist/doc/bibtex/iran-bibtex/iran-bibtex-userguide-fa.tex new file mode 100644 index 00000000000..c9e7da533d7 --- /dev/null +++ b/Master/texmf-dist/doc/bibtex/iran-bibtex/iran-bibtex-userguide-fa.tex @@ -0,0 +1,230 @@ +\documentclass[a4paper,11pt]{article} + +\usepackage{color} +\usepackage[usenames,dvpinames,table]{xcolor} +\usepackage{xecolor} +\usepackage{graphics} +\usepackage{graphicx} +\usepackage{enumitem} +\usepackage{array} +\usepackage{makecell} +\usepackage{verbatim} + +\usepackage[colorlinks,citecolor=green]{hyperref} + +\usepackage[localise,perpagefootnote=on,computeautoilg=on]{xepersian} +\settextfont{Parsi Nevis} +\setpersianmonofont{Vazir Code} +\setlatintextfont{Parsi Nevis} + +\SepMark{-} +\eqcommand{زیرنویسلاتین}{LTRfootnote} +\eqcommand{مل}{lr} +\eqcommand{ارجاع}{ref} +\eqcommand{فرارجاع}{eqref} +\eqcommand{صفحهارجاع}{pageref} +\eqcommand{استناد}{cite} +\eqcommand{استنادلاتین}{Latincite} +\eqcommand{استنادپ}{citep} +\eqcommand{استنادم}{citet} + + +\setlength{\parskip}{6pt minus 2pt} + +\makeatletter +\def\HyColor@@@UseColor[#1]#2\@nil{\xecolor[{#1}]{#2}} +\def\HyColor@@@@UseColor#1\@nil{\xecolor{#1}} +\makeatother + + + + + +\begin{document} + + + +\title{راهنمای کاربر بستهی \lr{\bf\sffamily iran-bibtex}} +\author{فرشاد رسولی\thanks{رایانامه: \url{farshad.rasuli@gmail.com}}} +\date{نسخهی ۰٫۴٫۱ --- ۱۷ اردیبهشت ۱۴۰۳} +\maketitle + + +\begin{abstract} +این بسته با هدف پیادهسازی شیوهنامهی ایران در سامانهی لاتک تهیه شده است. شیوهنامهی ایران که یک شیوهنامه برای فهرستنویسی منبعهای اطلاعاتی به فارسی، و انگلیسی است بر پایهی ویرایش شانزدهم شیوهنامهی شیکاگو در سال ۱۳۹۵ توسط ایرانداک منتشر شده است. با این بسته، شما میتوانید از سبکهای مختلف استناددهی درون متنی که فهرستنویسی منبعهای اطلاعاتی بر پایهی شیوهنامهی ایران است استفاده کنید. +\end{abstract} + + + +\section{شیوهنامهی ایران} +شیوهنامهی ایران یک شیوهنامهی فهرستنویسی منبعهای اطلاعاتی به زبان فارسی، و انگلیسی است که در سال ۱۳۹۵ توسط ایرانداک\زیرنویس{پژوهشگاه علوم و فناوری اطلاعات ایران} تهیه و منتشر شده است. این بسته با هدف پیادهسازی این شیوهنامه در سامانهی لاتک برای استفاده در نوشتارهای فارسی، و انگلیسی آماده شده است. + + +این بسته به گونهای طراحی شده است که در نوشتارهای فارسی که با \XePersian{} آماده میشوند و نوشتارهای غیرفارسی که با موتورهای پردازش مختلف آماده میشوند نیز کاربرد دارد. + + +برای استنادهای درون متنی، پیشنهاد شیوهنامهی ایران استفاده از سبک پدیدآورنده-سال است؛ ولی از آنجایی که سبکهای استناددهی مختلفی در سامانهی لاتک وجود دارد، با حفظ اصلهای این شیوهنامه در فهرستنویسی منبعهای اطلاعاتی، دیگر سبکهای استناددهی درون متنی مانند سبکهای شمارهگذاری نیز افزوده شده است. + + +\section{چگونگی فراخوانی، و استفاده از بسته} + + +\subsection{فراخوانی بسته} +برای فراخوانی بستهی ایران-بیبتک کافی است این بسته را با این فرمان فراخوانی کنید:\\ +\hspace*{\fill}\lr{\tt \textbackslash usepackage[<bibstyle>,<options>]\{iran-bibtex\}} + + +سبک استناددهی مورد نیاز در بخش \مل{\tt <bibstyle>} تعیین میشود. با استفاده از این بسته، دیگر نیازی به استفاده از فرمان\\ +\hspace*{\fill}\lr{\tt \textbackslash bibliographystyle\{<style>\}}\\ +برای تعیین سبک استناددهی نخواهید داشت و بستهی ایران-بیبتک، پروندهی \مل{\tt *.bst} مورد نیاز را انتخاب میکند. اگر این فرمان در پروندهی شما وجود دارد، پیش از پردازش پرونده، آن را حذف کنید سپس با تعیین پایگاه داده مرجعها\LTRfootnote{bibliography database} پرونده را پردازش کنید. + + +توجه کنید که این بسته با بستهی \مل{\sffamily natbib} کار میکند؛ از این رو، با فراخوانی این بسته، بستهی \مل{\sffamily natbib} نیز فراخوانی میشود و هر گزینهای که به عنوان \مل{\tt <options>} تعیین شود توسط بستهی \مل{\sffamily natbib} پردازش و اجرا میگردد؛ از این رو، راهنمای این بسته را بخوانید. + + +پیشنهاد میشود که بستهی ایران-بیبتک را پیش از بستهی \مل{\sffamily hyperref} فراخوانی کنید. + + +برای تولید خروجی نوشتارهای فارسی کافی است پروندهی موردنظر را به این ترتیب پردازش کنید: +\begin{itemize}[nosep] +\begin{latin} +\item \texttt{xelatex file.tex} +\item \texttt{bibtex8 -W -c iran-bibtex-cp1256fa file} +\item \texttt{xelatex file.tex} +\item \texttt{xelatex file.tex} +\end{latin} +\end{itemize} + + +فرمان \مل{\tt bibtex8 -W -c iran-bibtex-cp1256fa file} مرجعهای غیرفارسی را پس از مرجعهای فارسی فهرست میکند. اگر میخواهید که مرجعهای غیرفارسی در آغاز فهرست شوند فرمان \مل{\tt bibtex8 file} را جایگزین کنید. + + + + +\subsection{سبکهای استناددهی آماده شده در این بسته} + +سبکهای استناددهی آماده شده در این بسته در جدولهای~\ارجاع{tab:iran-cite-styles}، و \ارجاع{tab:iranlatin-cite-styles} فهرست شدهاند. سبکهای استناددهی در جدول~\ارجاع{tab:iran-cite-styles} برای استفاده در نوشتارهای فارسی و سبکهای استناددهی در جدول~\ارجاع{tab:iranlatin-cite-styles} برای استفاده در نوشتارهای غیرفارسی به کار میروند. + +\begin{table}[!hbt] \centering +\caption{سبکهای استناددهی آماده شده برای استفاده در نوشتارهای فارسی} +\label{tab:iran-cite-styles} +\begin{tabular}{cccc} +\hline +\thead{سبک\\استناددهی} & \thead{شیوهی\\استناددهی} & \thead{شیوهی مرتبسازی} & \thead{نمونه استناد\\درون متنی}\\ +\hline +\مل{\tt iran} & پدیدآورنده-سال & نام پدیدآورندگان & (کیانی ۱۳۹۵)\\ +\مل{\tt iran-plain} & شمارهگذاری & نام پدیدآورندگان & [۱]\\ +\مل{\tt iran-year} & پدیدآورنده-سال & سال اثر & (کیانی ۱۳۹۵)\\ +\مل{\tt iran-plainyr} & شمارهگذاری & سال اثر & [۱]\\ +\مل{\tt iran-unsrt} & شمارهگذاری & استناد در متن &[۱]\\ +\hline +\end{tabular} +\end{table} + + +\begin{table}[!hbt] \centering +\caption{سبکهای استناددهی آماده شده برای استفاده در نوشتارهای غیرفارسی}\label{tab:iranlatin-cite-styles} +\begin{tabular}{cccc} +\hline +\thead{سبک\\استناددهی} & \thead{شیوهی\\استناددهی} & \thead{شیوهی مرتبسازی} & \thead{نمونه استناد\\درون متنی}\\ +\hline +\مل{\tt iranlatin} & پدیدآورنده-سال & نام پدیدآورندگان & \مل{(Sanchez 2016)}\\ +\مل{\tt iranlatin-plain} & شمارهگذاری & نام پدیدآورندگان & \مل{[1]}\\ +\مل{\tt iranlatin-year} & پدیدآورنده-سال & سال اثر & \مل{(Sanchez 2016)}\\ +\مل{\tt iranlatin-plainyr} & شمارهگذاری & سال اثر & \مل{[1]}\\ +\مل{\tt iranlatin-unsrt} & شمارهگذاری & استناد در متن & \مل{[1]}\\ +\hline +\end{tabular} +\end{table} + + + + + +\subsection{فرمانهای استناد} +از آنجایی این بسته با بستهی \مل{\sffamily natbib} کار میکند، همهی فرمانهای استناد بستهی \مل{\sffamily natbib} در دسترس هستند. استناد به دو شکل میتواند باشد: پرانتزی، و متنی. در استناد پرانتزی، نام پدیدآورندگان و سال اثر (یا شمارهی استناد) بین پرانتز (یا براکت) قرار میگیرد. در استناد متنی نام پدیدآورندگان نوشته شده سپس سال اثر (یا شمارهی استناد) بین پرانتز (یا براکت) قرار میگیرد. در ادامه سه فرمان پرکاربرد از فرمانهای استناد به همراهی مثالی در سبک استناددهی \مل{\tt iran} ارائه شده است. + + +\paragraph*{فرمان \lr{\tt \textbackslash cite} (استناد پرانتزی)}~\\[0.5\baselineskip] +\begin{tabular}{ccc} +(کیانی و همکاران ۱۳۹۵) &$\Rightarrow$& \lr{\tt \textbackslash cite\{key\}}\\ +(کیانی و همکاران ۱۳۹۵، فصل~۲) &$\Rightarrow$& \lr{\tt \textbackslash cite\rl{[فصل~۲]}\{key\}}\\ +(ببینید کیانی و همکاران ۱۳۹۵، ص.~۱۰) &$\Rightarrow$& \lr{\tt \textbackslash cite\rl{[ص.~۱۰][ببینید]}\{key\}}\\ +(کیانی، صفایی، رفیعی، و امانی ۱۳۹۵) &$\Rightarrow$& \lr{\tt \textbackslash cite*\{key\}}\\ +(کیانی، صفایی، رفیعی، و امانی ۱۳۹۵، فصل~۲) &$\Rightarrow$& \lr{\tt \textbackslash cite*\rl{[فصل~۲]}\{key\}}\\ +(ببینید کیانی، صفایی، رفیعی، و امانی ۱۳۹۵، ص.~۱۰) &$\Rightarrow$& \lr{\tt \textbackslash cite*\rl{[ص.~۱۰][ببینید]}\{key\}}\\ +\end{tabular} + + + +\paragraph*{فرمان \lr{\tt \textbackslash citep} (استناد پرانتزی)}~\\[0.5\baselineskip] +\begin{tabular}{ccc} +(کیانی و همکاران ۱۳۹۵) &$\Rightarrow$& \lr{\tt \textbackslash citep\{key\}}\\ +(کیانی و همکاران ۱۳۹۵، فصل~۲) &$\Rightarrow$& \lr{\tt \textbackslash citep\rl{[فصل~۲]}\{key\}}\\ +(ببینید کیانی و همکاران ۱۳۹۵، ص.~۱۰) &$\Rightarrow$& \lr{\tt \textbackslash citep\rl{[ص.~۱۰][ببینید]}\{key\}}\\ +(کیانی، صفایی، رفیعی، و امانی ۱۳۹۵) &$\Rightarrow$& \lr{\tt \textbackslash citep*\{key\}}\\ +(کیانی، صفایی، رفیعی، و امانی ۱۳۹۵، فصل~۲) &$\Rightarrow$& \lr{\tt \textbackslash citep*\rl{[فصل~۲]}\{key\}}\\ +(ببینید کیانی، صفایی، رفیعی، و امانی ۱۳۹۵، ص.~۱۰) &$\Rightarrow$& \lr{\tt \textbackslash citep*\rl{[ص.~۱۰][ببینید]}\{key\}}\\ +\end{tabular} + + + +\paragraph*{فرمان \lr{\tt \textbackslash citet} (استناد متنی)}~\\[0.5\baselineskip] +\begin{tabular}{ccc} +کیانی و همکاران (۱۳۹۵) &$\Rightarrow$& \lr{\tt \textbackslash citet\{key\}}\\ +کیانی و همکاران (۱۳۹۵، فصل~۲) &$\Rightarrow$& \lr{\tt \textbackslash citet\rl{[فصل~۲]}\{key\}}\\ +ببینید کیانی و همکاران (۱۳۹۵، ص.~۱۰) &$\Rightarrow$& \lr{\tt \textbackslash citet\rl{[ص.~۱۰][ببینید]}\{key\}}\\ +کیانی، صفایی، رفیعی، و امانی (۱۳۹۵) &$\Rightarrow$& \lr{\tt \textbackslash citet*\{key\}}\\ +کیانی، صفایی، رفیعی، و امانی (۱۳۹۵، فصل~۲) &$\Rightarrow$& \lr{\tt \textbackslash citet*\rl{[فصل~۲]}\{key\}}\\ +ببینید کیانی، صفایی، رفیعی، و امانی (۱۳۹۵، ص.~۱۰) &$\Rightarrow$& \lr{\tt \textbackslash citet*\rl{[ص.~۱۰][ببینید]}\{key\}}\\ +\end{tabular} + + + +\section{آمادهسازی پایگاه داده مرجعها} +پروندهی \مل{\tt *.bib} که دربردارندهی مشخصات مرجعها است باید با رمزینهی \مل{\tt utf8} ذخیره شده باشد. مدخلهای\زیرنویسلاتین{entry} سازگار شده با شیوهنامهی ایران در این بسته عبارتند از: +\begin{center} +\begin{tabular}{*{3}{>{\centering\arraybackslash}p{0.3\linewidth}}} +\lr{\tt @book} & \lr{\tt @incollection} & \lr{\tt @article}\\ +\lr{\tt @proceedings} & \lr{\tt @inproceedings} & \lr{\tt @conference}\\ +\lr{\tt @masterthesis} & \lr{\tt @phdtesis} & \lr{\tt @unpublished}\\ +\lr{\tt @misc} & & +\end{tabular} +\end{center} +دیگر نوع مدخلها که عبارتند از \مل{\tt @booklet}، \مل{\tt @inbook}، \مل{\tt @manual}، و \مل{\tt @techreport} با شیوهنامهی ایران سازگار نشدهاند و پیشنهاد میشود که از آنها استفاده نشود. + + +برای اطلاع از الگوی چیدمان مشخصهها\زیرنویسلاتین{field}، و مشخصههای مورد استفاده برای هر مدخل در فهرستنویسی منبعها، و مرجعها، پروندهی +\مل{\tt iran-bibtex-pattern.pdf} را ببینید. + + + + + + +\subsection{مشخصهی \lr{\tt language}} +در این بسته، از مشخصهی \مل{\tt language} برای تعیین حروفچینی آن مرجع در فهرست مرجعها، و منبعها استفاده میشود. برای آنکه مرجعی که به زبان فارسی است از راست به چپ حروفچینی شود، باید مشخصهی \مل{\tt language} آن مرجع برابر با \مل{\tt persian} وارد گردد\زیرنویس{این مشخصه به بزرگی یا کوچکی حرفها حساس نیست}؛ در غیر این صورت، آن مرجع به عنوان مرجعی غیرفارسی فهرست میشود. + + +\subsection{مشخصهی \lr{\tt authorfa}} +در یک نوشتار فارسی که از سبک استناددهی پدیدآورنده-سال استفاده میشود، پیشنهاد میگردد که نام پدیدآورندگان اثرهای غیرفارسی در متن به فارسی نوشته شود. از این رو، با توجه به آنکه آن اثر قرار است زیر نام چه کسانی مرتب شود، نام آنها در مشخصهی \مل{\tt authorfa} وارد شود. + + + +\section{مثالهای استفاده از این بسته} +شمار زیادی از مثالهای آورده شده در شیوهنامهی ایران، که با استفاده از این بسته پیادهسازی شدند در مخزن گیتهاب این بسته به نشانی +\href{https://github.com/farshadrasuli/iran-bibtex}{github.com/farshadrasuli/iran-bibtex} +در پوشهی \مل{examples} آماده شده است که میتواند راهنمای بسیار خوبی برای یادگیری استفاده از این بسته در استفاده از شیوهنامهی ایران باشد. + + + + + + + + + + + + +\end{document}
\ No newline at end of file diff --git a/Master/texmf-dist/tex/latex/iran-bibtex/iran-bibtex.sty b/Master/texmf-dist/tex/latex/iran-bibtex/iran-bibtex.sty index e84bb0f9357..1cc11bf54d3 100644 --- a/Master/texmf-dist/tex/latex/iran-bibtex/iran-bibtex.sty +++ b/Master/texmf-dist/tex/latex/iran-bibtex/iran-bibtex.sty @@ -1,5 +1,5 @@ %% -%% This is file “iran-bibtex.sty”, v0.4.0 (2024/01/8) +%% This is file “iran-bibtex.sty”, v0.4.1 (2024-05-06) %% %% __________________________________________________ %% Copyright (c) 2023-2024 Farshad Rasuli @@ -26,28 +26,30 @@ % === Package structure: Identification \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{iran-bibtex} -\def\iranbibtex@version{0.4.0} -\def\iranbibtexdate{2024/01/8} % January 8th, 2024 -\def\iranbibtexfirstrelease{2023/12/12} % December 12th, 2023 + [2024-05-06 v0.4.1 Iran Manual of Style (1st edn, 2016)] + +\def\iranbibtex@version{0.4.1} +\def\iranbibtexdate{2024-05-06} % May 6th, 2024 +\def\iranbibtexfirstrelease{2023-12-12} % December 12th, 2023 \edef\@iranbibtex@info{% -****************************************************^^J% -* ^^J% -* iran-bibtex package^^J% -* ^^J% -* Description: This package is an implementation of^^J% -* the Iran Manual of Style (1st edition, 2016)^^J% -* citation guide to Persian and English information^^J% -* sources in BibTeX.^^J% -* ^^J% -* Copyright (c) 2023-2024 Farshad Rasuli^^J% -* ^^J% -****************************************************^^J% +***************************************************************% +* *% +* iran-bibtex package v\iranbibtex@version\ (\iranbibtexdate) *% +* *% +* Description: This package is an implementation of *% +* the Iran Manual of Style (1st edition, 2016) *% +* citation guide to Persian and English information *% +* sources in BibTeX. *% +* *% +* Copyright (c) 2023-2024 Farshad Rasuli *% +* *% +***************************************************************% } % === Package structure: Preliminary declarations -\RequirePackage{natbib} + @@ -56,10 +58,7 @@ %% iran bibliography style: author-year style, sorted by authors' name \DeclareOption{iran} {% - \setcitestyle{authoryear,% citation mode - round,% braces - aysep={},% between author and year - }% + \PassOptionsToPackage{authoryear,round,sort&compress}{natbib}% \bibliographystyle{iran}% } @@ -68,10 +67,7 @@ %% iran bibliography style: numbered style, sorted by authors' name \DeclareOption{iran-plain} {% - \setcitestyle{numbers,% citation mode - square,% braces - sort&compress, % multiple numerical citations are compressed - }% + \PassOptionsToPackage{numbers,square,sort&compress}{natbib}% \bibliographystyle{iran}% } @@ -80,10 +76,7 @@ %% iran bibliography style: author-year style, sorted by year \DeclareOption{iran-year} {% - \setcitestyle{authoryear,% citation mode - round,% braces - aysep={},% between author and year - }% + \PassOptionsToPackage{authoryear,round,sort&compress}{natbib}% \bibliographystyle{iran-year}% } @@ -92,10 +85,7 @@ %% iran bibliography style: numbered style, sorted by year \DeclareOption{iran-plainyr} {% - \setcitestyle{numbers,% citation mode - square,% braces - sort&compress, % multiple numerical citations are compressed - }% + \PassOptionsToPackage{numbers,square,sort&compress}{natbib}% \bibliographystyle{iran-year}% } @@ -104,10 +94,7 @@ %% iran bibliography style: numbered style, sorted by citation order \DeclareOption{iran-unsrt} {% - \setcitestyle{numbers,% citation mode - square,% braces - sort&compress, % multiple numerical citations are compressed - }% + \PassOptionsToPackage{numbers,square,sort&compress}{natbib}% \bibliographystyle{iran-unsrt}% } @@ -116,10 +103,7 @@ %% iran bibliography style for English/Latin document: author-year style, sorted by authors' name \DeclareOption{iranlatin} {% - \setcitestyle{authoryear,% citation mode - round,% braces - aysep={},% between author and year - }% + \PassOptionsToPackage{authoryear,round,sort&compress}{natbib}% \bibliographystyle{iranlatin}% } @@ -128,10 +112,7 @@ %% iran bibliography style for English/Latin document: numbered style, sorted by authors' name \DeclareOption{iranlatin-plain} {% - \setcitestyle{numbers,% citation mode - square,% braces - sort&compress, % multiple numerical citations are compressed - }% + \PassOptionsToPackage{numbers,square,sort&compress}{natbib}% \bibliographystyle{iranlatin}% } @@ -140,10 +121,7 @@ %% iran bibliography style for English/Latin document: author-year style, sorted by year \DeclareOption{iranlatin-year} {% - \setcitestyle{authoryear,% citation mode - round,% braces - aysep={},% between author and year - }% + \PassOptionsToPackage{authoryear,round,sort&compress}{natbib}% \bibliographystyle{iranlatin-year}% } @@ -152,10 +130,7 @@ %% iran bibliography style for English/Latin document: numbered style, sorted by year \DeclareOption{iranlatin-plainyr} {% - \setcitestyle{numbers,% citation mode - square,% braces - sort&compress, % multiple numerical citations are compressed - }% + \PassOptionsToPackage{numbers,square,sort&compress}{natbib}% \bibliographystyle{iranlatin-year}% } @@ -164,20 +139,28 @@ %% iran bibliography style for English/Latin document: numbered style, sorted by citation order \DeclareOption{iranlatin-unsrt} {% - \setcitestyle{numbers,% citation mode - square,% braces - sort&compress, % multiple numerical citations are compressed - }% + \PassOptionsToPackage{numbers,square,sort&compress}{natbib}% \bibliographystyle{iranlatin-unsrt}% } +%% other options pass to natbib package +\DeclareOption*{\PassOptionsToPackage{\CurrentOption}{natbib}} + + + \ProcessOptions\relax +\RequirePackage{natbib} +\setcitestyle{aysep={}}% between author and year + + + + % === Package structure: Provide commands @@ -203,60 +186,59 @@ % === Package structure: Modifying the extra label that is appended to the year for one author in the same year -% Modify extra label of Latin items ---------------------------------- -\providecommand{\extrayearlabelen}[1]{#1} - +%% Modify extra label of Latin bib items +\def\extrayearlabelen#1{#1} -% Set the equivalent Persian character for the English character ----- -% Implemeted by Bahman Mirzakhani (github.com/bahman-mirzakhani). -% Inspired from tex.stackexchange.com/questions/64131/implementing-switch-cases +%% Modify extra label of Persian bib items +\newcommand\makeswitch[2][]% +{% + \newcommand#2[1]% create a switch named #2 which takes one argument + {% + \ifcsname\string#2@case@##1\endcsname% check switch and case is exist or not + \csname\string#2@case@##1\endcsname% execute the switch and case + \else#1% expand #1 (first arugument of makeswitch) + \fi% + }% +} \newcommand\addcase[3]{\expandafter\def\csname\string#1@case@#2\endcsname{#3}} -\newcommand\makeswitch[2][]{% - \newcommand#2[1]{% - \ifcsname\string#2@case@##1\endcsname\csname\string#2@case@##1\endcsname\else#1\fi% - }% -} -\makeswitch[#1]\changealph -\addcase\changealph{a}{الف} -\addcase\changealph{b}{ب} -\addcase\changealph{c}{پ} -\addcase\changealph{d}{ت} -\addcase\changealph{e}{ث} -\addcase\changealph{f}{ج} -\addcase\changealph{g}{چ} -\addcase\changealph{h}{ح} -\addcase\changealph{i}{خ} -\addcase\changealph{j}{د} -\addcase\changealph{k}{ذ} -\addcase\changealph{l}{ر} -\addcase\changealph{m}{ز} -\addcase\changealph{n}{ژ} -\addcase\changealph{o}{س} -\addcase\changealph{p}{ش} -\addcase\changealph{q}{ص} -\addcase\changealph{r}{ض} -\addcase\changealph{s}{ط} -\addcase\changealph{t}{ظ} -\addcase\changealph{u}{ع} -\addcase\changealph{v}{غ} -\addcase\changealph{w}{ف} -\addcase\changealph{x}{ق} -\addcase\changealph{y}{ک} -\addcase\changealph{z}{گ} -\addcase\changealph{aa}{ل} -\addcase\changealph{ab}{م} -\addcase\changealph{ac}{ن} -\addcase\changealph{ad}{و} -\addcase\changealph{ae}{ه} -\addcase\changealph{af}{ی} - - - -% Modify extra label of Persian items -------------------------------- -\providecommand{\extrayearlabelfa}[1]{\changealph{#1}} + +\makeswitch[#1]\extrayearlabelfa + +\addcase\extrayearlabelfa{a}{الف} +\addcase\extrayearlabelfa{b}{ب} +\addcase\extrayearlabelfa{c}{پ} +\addcase\extrayearlabelfa{d}{ت} +\addcase\extrayearlabelfa{e}{ث} +\addcase\extrayearlabelfa{f}{ج} +\addcase\extrayearlabelfa{g}{چ} +\addcase\extrayearlabelfa{h}{ح} +\addcase\extrayearlabelfa{i}{خ} +\addcase\extrayearlabelfa{j}{د} +\addcase\extrayearlabelfa{k}{ذ} +\addcase\extrayearlabelfa{l}{ر} +\addcase\extrayearlabelfa{m}{ز} +\addcase\extrayearlabelfa{n}{ژ} +\addcase\extrayearlabelfa{o}{س} +\addcase\extrayearlabelfa{p}{ش} +\addcase\extrayearlabelfa{q}{ص} +\addcase\extrayearlabelfa{r}{ض} +\addcase\extrayearlabelfa{s}{ط} +\addcase\extrayearlabelfa{t}{ظ} +\addcase\extrayearlabelfa{u}{ع} +\addcase\extrayearlabelfa{v}{غ} +\addcase\extrayearlabelfa{w}{ف} +\addcase\extrayearlabelfa{x}{ق} +\addcase\extrayearlabelfa{y}{ک} +\addcase\extrayearlabelfa{z}{گ} +\addcase\extrayearlabelfa{aa}{ل} +\addcase\extrayearlabelfa{ab}{م} +\addcase\extrayearlabelfa{ac}{ن} +\addcase\extrayearlabelfa{ad}{و} +\addcase\extrayearlabelfa{ae}{ه} +\addcase\extrayearlabelfa{af}{ی} |