نام (NAME)

musixtex - فایل‌های MusiXTeX را با استفاده از پیش‌پردازنده‌های prepmx، xml2pmx، pmxab و autosp در صورت نیاز پردازش کرده و سپس فایل‌های میانی و لاگ را حذف می‌کند (مگر اینکه از -i استفاده شود)

خلاصه دستور (SYNOPSIS)

[ texlua ] musixtex[.lua] { option | jobname [ .xml | .mtx | .pmx | .aspc | .tex | .ltx ] } ...

توضیحات (DESCRIPTION)

اگر آرگومان jobname دارای پسوند .tex باشد، رفتار پیش‌فرض پردازش فایل با استفاده از موارد زیر است:

etex(1)

(گذر اول)

musixflx(1)

(گذر دوم)

etex(1)

(گذر سوم)

dvips(1)

(تبدیل dvi به Postscript)

ps2pdf(1)

(تبدیل Postscript به Portable Document Format)

که معمولاً پس از آن فایل‌های میانی و فایل‌های لاگ حذف می‌شوند. یک لاگ به نام musixtex.log ایجاد می‌شود، حتی اگر سایر فایل‌های لاگ حذف شوند.

اگر آرگومان jobname دارای پسوند .pmx باشد، فایل ابتدا با استفاده از pmxab(1) پیش‌پردازش می‌شود و فایل .tex حاصل طبق روال بالا پردازش خواهد شد.

اگر آرگومان jobname دارای پسوند .xml باشد، فایل ابتدا با استفاده از xml2pmx(1) پیش‌پردازش می‌شود و فایل .pmx حاصل طبق روال بالا پردازش خواهد شد.

اگر آرگومان jobname دارای پسوند .mtx باشد، فایل ابتدا با استفاده از prepmx(1) پیش‌پردازش می‌شود و فایل .pmx حاصل طبق روال بالا پردازش خواهد شد.

اگر آرگومان jobname دارای پسوند .ltx باشد، فایل با استفاده از latex(1) (یا pdflatex(1)) به جای etex پردازش می‌شود.

اگر آرگومان jobname دارای پسوند .aspc باشد، فایل ابتدا با استفاده از autosp(1) پیش‌پردازش می‌شود و فایل .tex یا .ltx حاصل طبق روال بالا پردازش خواهد شد.

اگر آرگومان jobname هیچ‌یک از این پسوندها را نداشته باشد، اسکریپت به ترتیب به دنبال فایلی با نام‌های jobname.xml یا jobname.mtx یا jobname.pmx یا jobname.aspc یا jobname.tex یا jobname.ltx می‌گردد و آن را طبق روال بالا پردازش می‌کند.

گزینه‌ها (OPTIONS)

-v, -version, --version

چاپ نام برنامه و شماره نسخه، و خروج

-h, -help, --help

نمایش خلاصه نحوه استفاده و خروج

-l

فرض کردن سورس به عنوان LaTeX؛ در صورت داشتن پسوند .ltx به طور ضمنی فعال می‌شود

-p

تغییر پردازنده TeX به pdfetex(1) یا pdflatex(1) (و عدم اجرای پردازنده dvi)

-c

پیش‌پردازش فایل pmx با استفاده از pmxchords(1)

-d

عدم تولید فایل .ps و تغییر پردازنده dvi به dvipdfm(1)

-D dvix

استفاده از dvix به عنوان پردازنده dvi؛ به عنوان مثال، -D "dvipdfm -m 0.9". برای جلوگیری از تولید .ps، از -d پیش از -D استفاده کنید.

-P ps2pdf

استفاده از ps2pdf به عنوان پردازنده Postscript؛ به عنوان مثال، -P "ps2pdf -sPAPERSIZE=a4"

-F fmt

استفاده از fmt به عنوان پردازنده TeX؛ به عنوان مثال، -F "luatex --output-format=dvi". یک مثال دیگر: به حداقل رساندن خروجی TeX با استفاده از -F "texfot etex" امکان‌پذیر است.

-m

توقف پردازش در مرحله فایل pmx

-M mtxx

استفاده از mtxx به عنوان پیش‌پردازنده mtx؛ به عنوان مثال، -M "prepmx -i".

-X pmxx

استفاده از pmxx به عنوان پیش‌پردازنده pmx؛ به عنوان مثال، -X "./pmxab".

-A aspcx

استفاده از aspcx به عنوان پیش‌پردازنده aspc؛ به عنوان مثال، -A "autosp -l".

-L xmlx

استفاده از xmlx به عنوان پیش‌پردازنده xml؛ به عنوان مثال، -L "./XML2PMX".

-t

توقف پردازش در مرحله فایل‌های tex/mid

-s

توقف پردازش در مرحله فایل dvi

-g

توقف پردازش در مرحله فایل ps

-i

نگه‌داری فایل‌های میانی و فایل‌های لاگ

-1

پردازش تک‌گذره [pdf][la]tex؛ یعنی بدون فراخوانی musixflx

-x

فراخوانی makeindex(1) جهت به‌روزرسانی پایگاه داده نمایه

-f

بازگردانی به حالت پردازش پیش‌فرض

-q

حالت بی‌صدا (تنها پیام‌های خود musixtex نمایش داده می‌شوند)؛ سایر پیام‌ها به یک فایل موقت هدایت می‌شوند. اگر خطایی در مرحله TeX رخ دهد، پردازش بلافاصله متوقف شده و انتهای فایل لاگ به stderr فرستاده می‌شود. اطلاعات نسخه از فایل موقت به فایل لاگ کپی می‌شود.

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

توجه داشته باشید که چهار موتور TeX از طریق گزینه‌های -l و -p در دسترس هستند:

etex پیش‌فرض

latex     -l
pdfetex   -p
pdflatex  -l -p

در صورت استفاده از گزینه -F، چنانچه نام موتور به ترتیب شامل "latex" و "pdf" نباشد، باید گزینه‌های -l و -p تنظیم شوند. برای مثال، چهار موتور فوق را می‌توان با موارد زیر جایگزین کرد:

-F "luatex --output-format=dvi"
-F "lualatex --output-format=dvi"
-F "luatex" -p
-F "lualatex" -p

همچنین ببینید (SEE ALSO)

autosp(1), etex(1), latex(1), pdfetex(1), pdflatex(1), makeindex(1), musixflx(1), dvipdfm(1), dvips(1), pmxab(1), pmxchords(1), prepmx(1), ps2pdf(1), xml2pmx(1) و musixdoc.pdf.

نویسنده (AUTHOR)

این صفحه راهنما توسط Bob Tennent <rdt@cs.queensu.ca> نوشته شده است. برای تولید PDF، از دستور زیر استفاده کنید:

groff -man musixtex.1 -T pdf > musixtex.1.pdf