| LY(1) | python-ly | LY(1) |
نام (NAME)
ly - دستکاری فایل‌های مبدأ LilyPond
کاربرد:
ly [options] commands file, ...
ابزاری برای دستکاری و پردازش فایل‌های مبدأ LilyPond
گزینه‌ها (OPTIONS)
- -v, --version
- نمایش شماره نسخه و خروج
- -h, --help
- نمایش این متن راهنما و خروج
- -i, --in-place
- بازنویسی روی فایل‌های ورودی
- -o,--output NAME
- نام فایل خروجی
- -e,--encoding ENC
- کدگذاری (ورودی) (پیش‌فرض UTF-8)
- --output-encoding ENC
- کدگذاری خروجی (پیش‌فرض مشابه کدگذاری ورودی)
- -l,--language NAME
- زبان پیش‌فرض نام زیروبمی نُت‌ها (پیش‌فرض "nederlands")
- -d <variable=value>
- تنظیم یک متغیر
گزینه ویژه -- باقی‌مانده آرگومان‌ها را به عنوان نام فایل در نظر می‌گیرد.
آرگومان‌ها (ARGUMENTS)
دستور یک آرگومان حاوی فرمان‌های جداشده با نقطه‌ویرگول است. در بیشتر موارد باید دستور را درون علامت نقل‌قول قرار دهید تا به عنوان یک آرگومان واحد در نظر گرفته شود.
می‌توانید بیش از یک فایل LilyPond را مشخص کنید. اگر می‌خواهید چندین فایل را پردازش کرده و نتیجه عملیات روی هر فایل را در یک فایل خروجی مجزا بنویسید، می‌توانید از دو نویسه ویژه در نام فایل خروجی استفاده کنید: نویسه '*' با مسیر کامل فایل ورودی فعلی (بدون پسوند) و نویسه '?' با نام فایل ورودی (بدون مسیر و پسوند) جایگزین خواهد شد. اگر مایل نیستید '*' یا '?' در نام فایل خروجی جایگزین شوند، می‌توانید -d replace-pattern=false را تنظیم کنید.
اگر نام فایل‌های ورودی یا خروجی را مشخص نکنید، ورودی استاندارد خوانده شده و در خروجی استاندارد نوشته می‌شود..SH "دستورها (COMMANDS)"
دستورهای اطلاعاتی که اطلاعات را در خروجی استاندارد می‌نویسند و فایل را تغییر نمی‌دهند:
دستورهایی که فایل را تغییر می‌دهند:
- indent
- دندانه‌گذاری مجدد فایل
- reformat
- قالب‌بندی مجدد فایل
- translate <language>
- ترجمه نام نت‌ها به زبان مشخص‌شده
- transpose <from> <to>
- انتقال گام (transpose) فایل همان‌گونه که LilyPond انجام می‌دهد؛ نام نت‌ها در زبان 'nederlands' ارائه می‌شوند
- abs2rel
- تبدیل نت‌نویسی مطلق (absolute) به نسبی (relative)
- rel2abs
- تبدیل نت‌نویسی نسبی (relative) به مطلق (absolute)
- simplify-accidentals
- جایگزینی نت‌های دارای علامت‌های عرضی (accidentals) تا جای ممکن با همسایگان بکار (natural) آن‌ها
- write [filename]
- نوشتن فایل در نام فایل داده‌شده یا متغیر خروجی output. اگر آخرین دستور یک دستور ویرایشی بوده باشد، write به‌طور خودکار فراخوانی می‌شود.
دستورهایی که فایل را به قالبی دیگر صادر می‌کنند:
- musicxml [filename]
- صادر کردن به MusicXML (در حال توسعه، هنوز بسیار ناقص است)
- highlight [filename]
- صادر کردن سند به‌صورت HTML دارای رنگ‌آمیزی نحو
- hl [filename]
- نام مستعار برای highlight
در بین دستورها، می‌توانید با استفاده از ساختارهای زیر متغیری را مقداردهی یا حذف کنید:
- variable=value
- مقداردهی یک متغیر به value. مقادیر خاص عبارتند از true و false که به عنوان مقادیر بولی تفسیر می‌شوند، یا ارقام که به عنوان مقادیر عدد صحیح (integer) تفسیر خواهند شد.
- variable=
- حذف مقدار یک متغیر (unset)
متغیرهای زیر را می‌توان برای تغییر رفتار دستورها تنظیم کرد. اگر مقداری پیش‌فرض وجود داشته باشد، میان براکت‌ها نوشته شده است:
- mode
- حالت فایلی که باید خوانده شود (پیش‌فرض خودکار یا automatic)؛ می‌تواند یکی از این موارد باشد: lilypond، scheme، latex، html، docbook، texinfo.
- output [-]
- نام فایل خروجی (همچنین با آرگومان -o نیز تنظیم می‌شود)
- encoding [UTF-8]
- کدگذاری خواندن ورودی (همچنین با آرگومان -e نیز تنظیم می‌شود)
- default-language [nederlands]
- زبان پیش‌فرض نام زیروبمی‌ها (pitch names)، هنگامی که به نحو دیگری در سند مشخص نشده باشد
- output-encoding
- کدگذاری نوشتن خروجی (پیش‌فرض آن encoding است، همچنین توسط آرگومان --output-encoding نیز تنظیم می‌شود)
- in-place [false]
- آیا فایل‌های ورودی رونویسی شوند یا خیر (مشابه -i)
- backup-suffix [~]
- پسوندی که هنگام ویرایش فایل‌ها درجا (in-place) استفاده می‌شود؛ در صورت تنظیم، پیش از رونویسی، از فایل اصلی نسخه پشتیبان تهیه می‌کند
- replace-pattern [true]
- مشخص می‌کند که آیا '*' و '?' در نام فایل خروجی جایگزین شوند یا خیر.
- rel-startpitch [true]
- مشخص می‌کند که آیا موسیقی نسبی (relative music) با زیروبمی آغازین (startpitch) نوشته شود یا خیر
- rel-absolute
- مشخص می‌کند که آیا اولین زیروبمی در یک عبارت نسبی بدون startpitch مشخص، مطلق در نظر گرفته شود یا خیر. اگر false باشد، نسبی با c' در نظر گرفته می‌شود. اگر true باشد، مطلق فرض می‌شود (در واقع نسبی با f). در صورت تنظیم نشدن، مقدار پیش‌فرض این متغیر تنها در صورتی true خواهد بود که نسخه LilyPond موجود در سند >= 2.18 باشد.
- indent-tabs [false]
- مشخص می‌کند که آیا از تب‌ها (tabs) برای تورفتگی استفاده شود یا خیر
- indent-width [2]
- تعداد فاصله‌ها (spaces) برای هر سطح تورفتگی (در صورت عدم استفاده از تب‌ها)
- full-html [True]
- در صورت تنظیم روی True، یک سند کامل با خروجی HTML دارای پررنگ‌سازی نحوی (syntax-highlighted) صادر می‌شود، در غیر این صورت تنها محتوای خام پیچیده‌شده در عنصری که با متغیرهای wrapper- پیکربندی شده است صادر خواهد شد.
- stylesheet
- نام فایل برای ارجاع به‌عنوان شیوه‌نامه (stylesheet) خارجی جهت HTML دارای پررنگ‌سازی نحوی. این نام فایل عیناً در برچسب <link rel="stylesheet"> استفاده می‌شود.
- inline-style [false]
- مشخص می‌کند که آیا برای HTML دارای پررنگ‌سازی نحوی از صفت‌های سبک درون‌خطی (inline style) استفاده شود یا خیر. به‌طور پیش‌فرض یک شیوه‌نامه css تعبیه می‌شود.
- number-lines [false]
- مشخص می‌کند که آیا هنگام ایجاد HTML دارای پررنگ‌سازی نحوی، شماره خطوط اضافه شود یا خیر.
- wrapper-tag [pre]
- برچسبی که HTML دارای پررنگ‌سازی نحوی در آن قرار می‌گیرد. مقادیر ممکن: div، pre، id و code
- wrapper-attribute [class]
- صفتی که برای برچسب دربرگیرنده استفاده می‌شود. مقادیر ممکن: id و class.
- document-id [lilypond]
- نامی که برای wrapper-attribute اعمال می‌شود. اگر سه گزینه پیشین از مقادیر پیش‌فرض خود استفاده کنند، عناصر HTML پررنگ‌شده در عنصری به شکل <pre class="lilypond"></pre> قرار می‌گیرند.
- linenumbers-id [linenumbers]
- اگر شماره خطوط صادر شوند، این نامی است که برای عناصر <td> استفاده می‌شود
این متغیرها بر خروجی دستورهای اطلاعاتی اثر می‌گذارند:
- with-filename
- نام فایل را در کنار اطلاعاتی نظیر نسخه و غیره چاپ می‌کند. اگر بیش از یک فایل مشخص شده باشد، این متغیر به‌طور پیش‌فرض true است.
در اینجا مثالی برای تنظیم مجدد تورفتگی و ترانهش (transpose) یک فایل LilyPond آورده شده است:
ly "indent; transpose c d" -o output.ly file.ly
مثال‌هایی با استفاده از '*' در نام فایل خروجی:
ly "transpose c d" *.ly -o '*-transposed.ly' ly highlight *.ly -o 'html/?.html'
نویسندگان (AUTHORS)
Wilbert Berendsen
کپی‌رایت و تکثیر (COPYRIGHT)
2025, Wilbert Berendsen
| April 4, 2026 | 0.9.10 |