.TH "YAPS" "1" "13 August 2005" .SH "نام (NAME)" \fBYAPS\fP \- تبدیل یک پرونده abc به یک پرونده PostScript .SH "خلاصه دستور (SYNOPSIS)" \fByaps\fP \fIabc\ file\fP [\-d] [\-e\ \fI\fP] [\-E] [\-l] [\-M \fIXXXxYYY\fP] [\-N] [\-k \fInn\fP] [\-o \fIfile\ name\fP] [\-P \-\fIss\fP] [\-s \fIXX\fP] [\-V] [\-ver] [\-x] [\-OCC] .SH "گزینه‌ها (OPTIONS)" .TP .B \-d فقط برای رفع اشکال (دیباگ). ساختارهای دادهٔ داخلی استفاده شده در برنامه را نمایش می‌دهد. .TP .B \-e \fI\fP قطعه‌های موسیقی با شماره‌های مرجع در یک فهرست جدا شده با کاما را رسم می‌کند. استفاده از فاصله مجاز نیست اما می‌توان محدوده‌ای از شماره‌های مرجع را مشخص کرد؛ برای نمونه، 1,3,7\-10. .TP .B \-E خروجی Encapsulated Postscript تولید می‌کند. .TP .B \-M \fIXXXxYYY\fP تنظیم اندازه حاشیه‌ها بر حسب پوینت (point)، که در آن 28.3 پوینت = ۱ سانتی‌متر و 72 پوینت = ۱ اینچ است. .TP .B \-N شماره‌گذاری صفحات را اضافه می‌کند. .TP .B \-k [\fInn\fP] شماره‌گذاری میزان‌ها را اضافه می‌کند. اگر شماره \fInn\fP مشخص شود، هر \fInn\fP میزان یک‌بار شماره‌گذاری می‌شود. در غیر این صورت تمام میزان‌ها شماره‌گذاری می‌شوند. .TP .B \-o \fIfilename\fP نام پروندهٔ خروجی postscript را تعیین می‌کند. .TP .B \-P \fIss\fP اندازه کاغذ را مشخص می‌کند که در آن 0 برابر A4 و 1 برابر US Letter است، یا XXXxYYY اندازه کاغذ را بر حسب واحدهای پوینت تعیین می‌کند. .TP .B \-s \fIXX\fP ضریب مقیاس‌بندی را مشخص می‌کند (پیش‌فرض 0.7 است). .TP .B \-V صداها (voices) برای یک قطعه چندصدایی به طور جداگانه چاپ می‌شوند. در غیر این صورت به صورت درهم‌آمیخته (interleaved) چاپ خواهند شد. .TP .B \-ver شماره نسخه را چاپ کرده و خارج می‌شود. .TP .B \-x شماره قطعه را در فیلد X: چاپ می‌کند. .TP .B \-OCC در صورتی لازم است که قطعه از شیوه نگارش قدیمی برای آکوردها استفاده کند که به جای [...] با +..+ مشخص شده‌اند. .SH "ویژگی‌ها (FEATURES)" .PP * از کد تجزیه‌کنندهٔ abc2midi استفاده می‌کند، بنابراین امید است سازگاری با abc2midi خوب باشد. .PP * پهنای متن ترانه را برای حروف‌چینی شعر اندازه می‌گیرد. .PP * در بیشتر بخش‌ها از ساختارهای داده با قابلیت گسترش پویا استفاده می‌کند، بنابراین نباید با محدودیت‌های زمان کامپایل مقید شوید. .PP * صداهای متعدد را طوری رسم می‌کند که نت‌های هم‌زمان در یک راستا تراز شوند. .PP * از نویسه‌های خاص با استفاده از قلم ISO latin 1 پشتیبانی می‌کند. نویسه‌های خاص با کدی مشابه TeX مانند \(aqE یا کد هشت‌هشتی ۳ رقمی مانند \e315 ایجاد می‌شوند. .PP * از کلیدهای زیر پشتیبانی می‌کند: baritone، tenor، alto، mezzo، soprano، treble، bass. شیوه استفاده توصیه‌شده عبارت است از: .PP * سکوت‌های نامرئی (x) مانند سکوت‌های عادی نمایش داده می‌شوند. .PP * شناسه‌های غیرعددی صدا مانند V: soprano پذیرفته می‌شوند. .PP I:clef=bass .PP برای آسان‌تر کردن ورود قطعه‌ها در کلیدهایی غیر از کلید سل (treble clef)، برنامه yaps از I:octave=\-1 پشتیبانی می‌کند تا نشان دهد یک C در قطعه، نمایانگر نتی یک اکتاو پایین‌تر از زیروبمی تعریف‌شده در استاندارد abc است. این موارد را می‌توان در یک دستور I: ترکیب کرد؛ برای نمونه: .PP I:clef=bass octave=\-2 .PP همچنین می‌توانید از کلیدهایی استفاده کنید که یک، دو یا سه اکتاو بالاتر یا پایین‌تر از حد معمول هستند، مثلاً treble\-8، treble+15، treble\-22. کلید با یک عدد کوچک 8، 15 یا 22 در بالا یا پایین نماد کلید رسم می‌شود. دستورهای clef= و octave= می‌توانند در فیلد K: نیز قرار گیرند، برای نمونه: .PP K:G clef=bass\-8 octave=\-3 .PP توجه داشته باشید که بین رفتار yaps و رفتار abc2ps 1.3.3 ناسازگاری وجود دارد. برنامه abc2ps 1.3.3 از دستور I:octave=N پشتیبانی نمی‌کند، اما انتخاب برخی کلیدها باعث می‌شود به طور خودکار چند اکتاو انتقال (transpose) یابد. می‌توانید کد abc تولید کنید که برای هر دو کار کند، با قرار دادن یک دستور I:octave=N بعد از تغییر کلید تا انتقالی را که abc2ps به طور خودکار انجام می‌دهد اعمال کند. .PP * برچسب‌های کادربندی‌شده برای بخش‌ها (part labels) تولید می‌کند. .PP * از نماد سِنیو (segno) با !segno! و کُدا با !coda! پشتیبانی می‌کند. سایر دستورالعمل‌های موسیقی مانند !fine! و !D.C.! به صورت متن ظاهر می‌شوند. .PP * از فیلد U: برای خلاصه کردن نمادها به نویسه‌های تکی پشتیبانی می‌کند؛ برای نمونه: .PP U:S = !segno! .PP امکان استفاده از S را برای ایجاد نماد segno فراهم می‌کند. در حال حاضر این قابلیت فقط امکان تعریف نمادهای جدید را می‌دهد و اجازه تغییر نمادهای از پیش تعریف‌شدهٔ M، L، R، H و T را نمی‌دهد. .PP * از دستورالعمل‌های !red! و !black! برای جابه‌جایی بین رنگ‌های سیاه و قرمز یا برعکس پشتیبانی می‌کند. .PP * از پسوندهای زیر از abc2ps برای abc پشتیبانی می‌کند: .PP %%newpage \- شروع یک صفحه جدید .br %%vskip N \- افزودن فضای عمودی به اندازه N پوینت. اگر N با \(aqcm\(aq یا \(aqin\(aq همراه باشد، واحدها به جای پوینت به عنوان سانتی‌متر یا اینچ در نظر گرفته می‌شوند، مثلاً 4cm. .br %%text \- چاپ متن .br %%centre (یا %%center) \- چاپ متن وسط‌چین. .br اگر %%text یا %%centre در سرآیند ظاهر شوند، متن بالای قطعه ظاهر می‌شود. .PP %%staffsep SIZE \- تنظیم فضای خالی عمودی بین ۲ خط حامل (staves) متوالی. .PP %%titleleft N \- انتخاب عنوان قرار گرفته در سمت چپ یا وسط‌چین. مقدار N = 1 عنوان را در سمت چپ قرار می‌دهد در حالی که N = 0 آن را وسط‌چین می‌کند. .br %%titlecaps \- عنوان با حروف بزرگ (capital) نمایش داده می‌شود. .br %%textfont NAME SIZE \- انتخاب قلم با نام NAME و اندازه پوینت SIZE برای متن تولید شده توسط %%text یا %%centre. اگر فقط NAME داده شود، اندازه قلم ثابت می‌ماند. به همین ترتیب، اگر \(aq\-\(aq به عنوان NAME داده شود، فقط اندازه قلم تغییر می‌کند. .br %%titlefont NAME SIZE \- انتخاب قلم برای عنوان. .br %%subtitlefont NAME SIZE \- انتخاب قلم برای عنوان‌های پس از عنوان نخست. .br %%composerfont NAME SIZE \- انتخاب قلم برای واژه‌ها در فیلدهای C: و O: و مشخص‌کننده بخش (P: در سرآیند). .br %%wordsfont NAME SIZE \- انتخاب قلم برای واژه‌ها در فیلدهای W:. .br %%partsfont NAME SIZE \- انتخاب قلم برای بخش‌های کادربندی‌شده و !instruction! . .br %%vocalfont NAME SIZE \- انتخاب قلم برای واژه‌ها در فیلدهای w:. .br %%gchordfont NAME SIZE \- انتخاب قلم برای آکوردهای گیتار در قطعه موسیقی. (توصیه می‌شود نام قلم را برای دو مورد آخر تغییر ندهید، زیرا برنامه عرض رشته‌ها را با استفاده از قلم‌های پیش‌فرض محاسبه می‌کند) .br %%titlespace، %%subtitlespace، %%textspace، %%composerspace، %%wordsspace، %%partsspace، %%vocalspace و %%gchordspace میزان فضای خالی باقی‌مانده در بالای نوع مربوطه از متن را تعیین می‌کنند. هر یک از این موارد باید با اندازه‌ای بر حسب پوینت یا مقداری بر حسب سانتی‌متر یا اینچ دنبال شوند. .br برای نمونه: %%composerfont 3 %%titlefont 2cm .PP * از قرار دادن آکوردهای همراهی (accompaniment chords) در بالا یا پایین خط حامل پشتیبانی می‌کند. .PP %%chordsabove \- قرار دادن آکوردهای همراهی در بالای خط حامل (پیش‌فرض). .br %%chordsbelow \- قرار دادن آکوردهای همراهی در پایین خط حامل. .PP * از متن اختیاری محصور در علامت نقل‌قول قبل و بعد از مشخصات تمپو در فیلد Q: پشتیبانی می‌کند. این پسوند از abc2ps آمده است. .SH "نویسنده (AUTHOR)" James Allwright .SH "پشتیبانی (SUPPORTED)" Seymour Shlien .PP مستندات کامل‌تر را می‌توان در پرونده abcguide.txt که همراه با بسته توزیع abcMIDI ارائه می‌شود یافت. .SH "نسخه (VERSION)" این صفحه راهنما نسخه 1.39 به تاریخ 13 August 2005 را شرح می‌دهد.