.\" This manpage is licensed under the GNU Public License
.TH MUSIXTEX 1 2024-04-18  "musixtex version 0.23" ""

.SH "نام (NAME)"
musixtex \- فایل‌های MusiXTeX را با استفاده از پیش‌پردازنده‌های prepmx، xml2pmx، pmxab و autosp در صورت نیاز پردازش کرده و سپس فایل‌های میانی و لاگ را حذف می‌کند (مگر اینکه از \-i استفاده شود)
.SH "خلاصه دستور (SYNOPSIS)"
[ texlua ]
.B musixtex[.lua]
{
.I option
|
.I jobname
[ .xml | .mtx  | .pmx  | .aspc | .tex | .ltx ] } ...
.SH "توضیحات (DESCRIPTION)"
.TP
اگر آرگومان jobname دارای پسوند \fB.tex\fR باشد، رفتار پیش‌فرض پردازش فایل با استفاده از موارد زیر است:
.TP 12
.BR etex (1)
(گذر اول)
.TP
.BR musixflx (1)
(گذر دوم)
.TP
.BR etex (1)
(گذر سوم)
.TP
.BR dvips (1)
(تبدیل dvi به Postscript)
.TP
.BR ps2pdf (1)
(تبدیل Postscript به Portable Document Format)
.TP
که معمولاً پس از آن فایل‌های میانی و فایل‌های لاگ حذف می‌شوند. یک لاگ به نام \fBmusixtex.log\fR ایجاد می‌شود، حتی اگر سایر فایل‌های لاگ حذف شوند.
.P
اگر آرگومان jobname دارای پسوند \fB.pmx\fR باشد، فایل ابتدا با استفاده از
.BR pmxab (1)
پیش‌پردازش می‌شود و فایل \fB.tex\fR حاصل طبق روال بالا پردازش خواهد شد.
.P
اگر آرگومان jobname دارای پسوند \fB.xml\fR باشد، فایل ابتدا با استفاده از
.BR xml2pmx (1)
پیش‌پردازش می‌شود و فایل \fB.pmx\fR حاصل طبق روال بالا پردازش خواهد شد.
.P
اگر آرگومان jobname دارای پسوند \fB.mtx\fR باشد، فایل ابتدا با استفاده از
.BR prepmx (1)
پیش‌پردازش می‌شود و فایل \fB.pmx\fR حاصل طبق روال بالا پردازش خواهد شد.
.P
اگر آرگومان jobname دارای پسوند \fB.ltx\fR باشد، فایل با استفاده از
.BR latex (1)
(یا
.BR pdflatex (1))
به جای
.BR etex
پردازش می‌شود.
.P
اگر آرگومان jobname دارای پسوند \fB.aspc\fR باشد، فایل ابتدا با استفاده از
.BR autosp (1)
پیش‌پردازش می‌شود و فایل \fB.tex\fR یا \fB.ltx\fR حاصل طبق روال بالا پردازش خواهد شد.
.P
اگر آرگومان jobname هیچ‌یک از این پسوندها را نداشته باشد، اسکریپت به ترتیب به دنبال فایلی با نام‌های
.IR jobname .xml
یا
.IR jobname .mtx
یا
.IR jobname .pmx
یا
.IR jobname .aspc
یا
.IR jobname .tex
یا
.IR jobname .ltx
می‌گردد و آن را طبق روال بالا پردازش می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP 10
.B \-v, \-version, \-\-version
چاپ نام برنامه و شماره نسخه، و خروج
.TP
.B \-h, \-help, \-\-help
نمایش خلاصه نحوه استفاده و خروج
.TP
.B \-l
فرض کردن سورس به عنوان LaTeX؛
در صورت داشتن پسوند \fB.ltx\fR به طور ضمنی فعال می‌شود
.TP
.B \-p
تغییر پردازنده TeX به
.BR pdfetex (1)
یا
.BR pdflatex (1)
(و عدم اجرای پردازنده dvi)
.TP
.B \-c
پیش‌پردازش فایل pmx با استفاده از
.BR pmxchords (1)
.TP
.B \-d
عدم تولید فایل \fB.ps\fR و تغییر پردازنده dvi به
.BR dvipdfm (1)
.TP
.B \-D dvix
استفاده از
.B dvix
به عنوان پردازنده dvi؛ به عنوان مثال، \-D "dvipdfm \-m 0.9".
برای جلوگیری از تولید \fB.ps\fR، از
.B \-d
.I پیش از
.B \-D
استفاده کنید.
.TP
.B \-P ps2pdf
استفاده از
.B ps2pdf
به عنوان پردازنده Postscript؛ به عنوان مثال، \-P "ps2pdf \-sPAPERSIZE=a4"
.TP
.B \-F fmt
استفاده از
.B fmt
به عنوان پردازنده TeX؛ به عنوان مثال، \-F "luatex \-\-output\-format=dvi". یک مثال دیگر: به حداقل رساندن خروجی TeX با استفاده از \-F "texfot etex" امکان‌پذیر است.
.TP
.B \-m
توقف پردازش در مرحله فایل pmx
.TP
.B \-M mtxx
استفاده از
.B mtxx
به عنوان پیش‌پردازنده mtx؛ به عنوان مثال، \-M "prepmx \-i".
.TP
.B \-X pmxx
استفاده از
.B pmxx
به عنوان پیش‌پردازنده pmx؛ به عنوان مثال، \-X "./pmxab".
.TP
.B \-A aspcx
استفاده از
.B aspcx
به عنوان پیش‌پردازنده aspc؛ به عنوان مثال، \-A "autosp \-l".
.TP
.B \-L xmlx
استفاده از
.B xmlx
به عنوان پیش‌پردازنده xml؛ به عنوان مثال، \-L "./XML2PMX".
.TP
.B \-t
توقف پردازش در مرحله فایل‌های tex/mid
.TP
.B \-s
توقف پردازش در مرحله فایل dvi
.TP
.B \-g
توقف پردازش در مرحله فایل ps
.TP
.B \-i
نگه‌داری فایل‌های میانی و فایل‌های لاگ
.TP
.B \-1
پردازش تک‌گذره [pdf][la]tex؛ یعنی بدون فراخوانی
.B musixflx
.TP
.B \-x
فراخوانی
.BR makeindex (1)
جهت به‌روزرسانی پایگاه داده نمایه
.TP
.B \-f
بازگردانی به حالت پردازش پیش‌فرض
.TP
.B \-q
حالت بی‌صدا (تنها پیام‌های خود musixtex نمایش داده می‌شوند)؛ سایر پیام‌ها به یک فایل موقت هدایت می‌شوند.
اگر خطایی در مرحله TeX رخ دهد، پردازش بلافاصله متوقف شده و انتهای فایل لاگ به stderr فرستاده می‌شود.
اطلاعات نسخه از فایل موقت به فایل لاگ کپی می‌شود.

.TP 0
گزینه‌ها بر پردازش تمام فایل‌های بعدی MusiXTeX تأثیر می‌گذارند مگر اینکه با گزینه دیگری تغییر کنند. فلگ‌های گزینه‌ها را نمی‌توان با یکدیگر ترکیب کرد؛ برای مثال به جای \fB \-lx\fP از \fB \-l \-x \fP استفاده کنید.

توجه داشته باشید که چهار موتور TeX از طریق گزینه‌های \-l و \-p در دسترس هستند:
.TP
.nf
    etex      پیش‌فرض
    latex     \-l
    pdfetex   \-p
    pdflatex  \-l \-p
.fi
.TP 0
در صورت استفاده از گزینه \-F، چنانچه نام موتور به ترتیب شامل "latex" و "pdf" نباشد، باید گزینه‌های \-l و \-p تنظیم شوند. برای مثال، چهار موتور فوق را می‌توان با موارد زیر جایگزین کرد:
.nf
  \-F "luatex \-\-output\-format=dvi"
  \-F "lualatex \-\-output\-format=dvi"
  \-F "luatex" \-p
  \-F "lualatex" \-p
.fi

.SH "همچنین ببینید (SEE ALSO)"
.BR autosp (1),
.BR etex (1),
.BR latex (1),
.BR pdfetex (1),
.BR pdflatex (1),
.BR makeindex (1),
.BR musixflx (1),
.BR dvipdfm (1),
.BR dvips (1),
.BR pmxab (1),
.BR pmxchords (1),
.BR prepmx (1),
.BR ps2pdf (1),
.BR xml2pmx (1)
و \fBmusixdoc.pdf\fR.
.SH "نویسنده (AUTHOR)"
این صفحه راهنما توسط Bob Tennent <rdt@cs.queensu.ca> نوشته شده است. برای تولید PDF، از دستور زیر استفاده کنید:
.PP
.nf
groff \-man musixtex.1 \-T pdf > musixtex.1.pdf
.fi