نام (NAME)

prepmx - پیش‌پردازنده برای PMX، برنامه آسان حروف‌چینی موسیقی

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

prepmx [options] jobname [outdir/] [stylefile]

توضیحات (DESCRIPTION)

M-Tx یک زبان پیش‌پردازنده با کاربرد آسان برای برنامه حروف‌چینی موسیقی PMX است که برای افراد غیرمتخصص طراحی شده است. برای یک نمونه ساده، به مثال زیر نگاهی بیندازید:

c2+ e4 g | b4d- c1 d c2 |
c8 g+ e g c- g+ e g | d g f g c- g+ e g |

برای راهنمای نحو، لطفاً به کتابچه راهنمای M-Tx نوشتهٔ Dirk Laurie، خالق زبان M-Tx و نویسندهٔ prepmx(1)، ابزار خط فرمان آن مراجعه کنید.

prepmx فایل jobname.mtx را برای تولید jobname.pmx پردازش می‌کند. سپس می‌توانید این فایل را با استفاده از دستور pmxab(1) که یک پیش‌پردازنده برای MusiXTeX است پردازش نمایید.

outdir/ پوشه‌ای است که “pmx” فایل نهایی .tex را در آن قرار می‌دهد. توجه داشته باشید که اسلش پایانی الزامی است. شما می‌توانید یک stylefile برای M-Tx مشخص کنید. در صورت حذف، در صورت وجود از فایل “mtxstyle.txt” در پوشه جاری استفاده می‌شود.

گزینه‌ها (OPTIONS)

گزینه‌ها را می‌توان در یک خط “Options:” در مقدمه (preamble) نیز مشخص کرد، که اولویت بالاتری نسبت به خط فرمان دارد.

-b: غیرفعال‌سازی unbeamVocal
-c: غیرفعال‌سازی doChords
-D: فعال‌سازی debugMode
-f: فعال‌سازی solfaNoteNames
-i: فعال‌سازی ignoreErrors
-m: غیرفعال‌سازی doLyrics
-n: فعال‌سازی instrumentNames
-t: غیرفعال‌سازی doUptext
-u: غیرفعال‌سازی uptextOnRests
-v: فعال‌سازی beVerbose
-w: فعال‌سازی pedanticWarnings
-n: انتخاب Special Case n
-H: چاپ وضعیت فعال‌بودن تمامی گزینه‌ها

وضعیت خروج (EXIT STATUS)

در صورتی که هیچ خطایی یافت نشود، prepmx با کد خروج 0 خاتمه می‌یابد. در صورت بروز خطا، شماره خط پردازش‌شده بازگردانده می‌شود. این ممکن است همیشه خطی نباشد که خطای واقعی در آن رخ داده است. وضعیت بازگشتی 10000 به این معنی است که فایل ورودی خالی بوده یا امکان باز کردن آن وجود نداشته است.

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

راهنمای کاربر M-Tx (mtxdoc.pdf)
pmxab(1)، musixtex(1)

نویسندگان (AUTHORS)

برنامه prepmx توسط Dirk Laurie <dirk.laurie@gmail.com> نوشته شده است. این صفحه راهنما توسط Roland Stigge <stigge@antcom.de> برای پروژه دبیان نوشته شده است. این متن توسط Nis Martensen <nis.martensen@web.de> و Bob Tennent <rdt@cs.queensu.ca> بازنگری و گسترش یافته است.