.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.4 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "LY" "1" "Apr 04, 2026" "0.9.10" "python-ly"
.SH "نام (NAME)"
ly \- دستکاری فایل‌های مبدأ LilyPond
.sp
کاربرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ly [options] commands file, ...
.EE
.UNINDENT
.UNINDENT
.sp
ابزاری برای دستکاری و پردازش فایل‌های مبدأ LilyPond
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B  \-v\fP,\fB  \-\-version
نمایش شماره نسخه و خروج
.TP
.B  \-h\fP,\fB  \-\-help
نمایش این متن راهنما و خروج
.TP
.B  \-i\fP,\fB  \-\-in\-place
بازنویسی روی فایل‌های ورودی
.TP
.BI \-o\fP,\fB  \-\-output \ NAME
نام فایل خروجی
.TP
.BI \-e\fP,\fB  \-\-encoding \ ENC
کدگذاری (ورودی) (پیش‌فرض UTF\-8)
.TP
.BI \-\-output\-encoding \ ENC
کدگذاری خروجی (پیش‌فرض مشابه کدگذاری ورودی)
.TP
.BI \-l\fP,\fB  \-\-language \ NAME
زبان پیش‌فرض نام زیروبمی نُت‌ها (پیش‌فرض \(dqnederlands\(dq)
.TP
.BI \-d \ <variable=value>
تنظیم یک متغیر
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینه ویژه \fB\-\-\fP باقی‌مانده آرگومان‌ها را به عنوان نام فایل در نظر می‌گیرد.
.SH "آرگومان‌ها (ARGUMENTS)"
.sp
دستور یک آرگومان حاوی فرمان‌های جداشده با نقطه‌ویرگول است. در بیشتر موارد باید دستور را درون علامت نقل‌قول قرار دهید تا به عنوان یک آرگومان واحد در نظر گرفته شود.
.sp
می‌توانید بیش از یک فایل LilyPond را مشخص کنید. اگر می‌خواهید چندین فایل را پردازش کرده و نتیجه عملیات روی هر فایل را در یک فایل خروجی مجزا بنویسید، می‌توانید از دو نویسه ویژه در نام فایل خروجی استفاده کنید: نویسه \(aq*\(aq با مسیر کامل فایل ورودی فعلی (بدون پسوند) و نویسه \(aq?\(aq با نام فایل ورودی (بدون مسیر و پسوند) جایگزین خواهد شد. اگر مایل نیستید \(aq*\(aq یا \(aq?\(aq در نام فایل خروجی جایگزین شوند، می‌توانید \fB\-d replace\-pattern=false\fP\& را تنظیم کنید.
.sp
اگر نام فایل‌های ورودی یا خروجی را مشخص نکنید، ورودی استاندارد خوانده شده و در خروجی استاندارد نوشته می‌شود..SH "دستورها (COMMANDS)"
.sp
دستورهای اطلاعاتی که اطلاعات را در خروجی استاندارد می‌نویسند و فایل را
تغییر نمی‌دهند:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B \fBmode\fP
چاپ حالت (mode) سند (در صورت مشخص نبودن، حدس زده می‌شود)
.TP
.B \fBversion\fP
چاپ نسخه LilyPond، اگر در سند تعیین شده باشد
.TP
.B \fBlanguage\fP
چاپ زبان نام نت‌ها (pitch names)، اگر در سند تعیین شده باشد
.UNINDENT
.UNINDENT
.UNINDENT
.sp
دستورهایی که فایل را تغییر می‌دهند:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B \fBindent\fP
دندانه‌گذاری مجدد فایل
.TP
.B \fBreformat\fP
قالب‌بندی مجدد فایل
.TP
.B \fBtranslate <language>\fP
ترجمه نام نت‌ها به زبان مشخص‌شده
.TP
.B \fBtranspose <from> <to>\fP
انتقال گام (transpose) فایل همان‌گونه که LilyPond انجام می‌دهد؛ نام نت‌ها
در زبان \(aqnederlands\(aq ارائه می‌شوند
.TP
.B \fBabs2rel\fP
تبدیل نت‌نویسی مطلق (absolute) به نسبی (relative)
.TP
.B \fBrel2abs\fP
تبدیل نت‌نویسی نسبی (relative) به مطلق (absolute)
.TP
.B \fBsimplify\-accidentals\fP
جایگزینی نت‌های دارای علامت‌های عرضی (accidentals) تا جای ممکن با
همسایگان بکار (natural) آن‌ها
.TP
.B \fBwrite [filename]\fP
نوشتن فایل در نام فایل داده‌شده یا متغیر خروجی output.
اگر آخرین دستور یک دستور ویرایشی بوده باشد،
write به‌طور خودکار فراخوانی می‌شود.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
دستورهایی که فایل را به قالبی دیگر صادر می‌کنند:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B \fBmusicxml [filename]\fP
صادر کردن به MusicXML (در حال توسعه، هنوز بسیار ناقص است)
.TP
.B \fBhighlight [filename]\fP
صادر کردن سند به‌صورت HTML دارای رنگ‌آمیزی نحو
.TP
.B \fBhl [filename]\fP
نام مستعار برای highlight
.UNINDENT
.UNINDENT
.UNINDENT
.sp
در بین دستورها، می‌توانید با استفاده از ساختارهای زیر متغیری را مقداردهی یا حذف کنید:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B \fBvariable=value\fP
مقداردهی یک متغیر به value. مقادیر خاص عبارتند از true و false
که به عنوان مقادیر بولی تفسیر می‌شوند، یا ارقام
که به عنوان مقادیر عدد صحیح (integer) تفسیر خواهند شد.
.TP
.B \fBvariable=\fP
حذف مقدار یک متغیر (unset)
.UNINDENT
.UNINDENT
.UNINDENT.SH "متغیرها (VARIABLES)"
.sp
متغیرهای زیر را می‌توان برای تغییر رفتار دستورها تنظیم کرد.
اگر مقداری پیش‌فرض وجود داشته باشد، میان براکت‌ها نوشته شده است:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B \fBmode\fP
حالت فایلی که باید خوانده شود (پیش‌فرض خودکار یا automatic)؛ می‌تواند یکی
از این موارد باشد: lilypond، scheme، latex، html، docbook، texinfo.
.TP
.B \fBoutput\fP [\-]
نام فایل خروجی (همچنین با آرگومان \-o نیز تنظیم می‌شود)
.TP
.B \fBencoding\fP [UTF\-8]
کدگذاری خواندن ورودی (همچنین با آرگومان \-e نیز تنظیم می‌شود)
.TP
.B \fBdefault\-language\fP [nederlands]
زبان پیش‌فرض نام زیروبمی‌ها (pitch names)، هنگامی که به نحو دیگری در سند
مشخص نشده باشد
.TP
.B \fBoutput\-encoding\fP
کدگذاری نوشتن خروجی (پیش‌فرض آن \fBencoding\fP است، همچنین
توسط آرگومان \fB\-\-output\-encoding\fP نیز تنظیم می‌شود)
.TP
.B \fBin\-place\fP [\fBfalse\fP]
آیا فایل‌های ورودی رونویسی شوند یا خیر (مشابه \fB\-i\fP)
.TP
.B \fBbackup\-suffix\fP [~]
پسوندی که هنگام ویرایش فایل‌ها درجا (in\-place) استفاده می‌شود؛ در صورت تنظیم،
پیش از رونویسی، از فایل اصلی نسخه پشتیبان تهیه می‌کند
.TP
.B \fBreplace\-pattern\fP [\fBtrue\fP]
مشخص می‌کند که آیا \(aq*\(aq و \(aq?\(aq در نام فایل خروجی جایگزین شوند یا خیر.
.TP
.B \fBrel\-startpitch\fP [\fBtrue\fP]
مشخص می‌کند که آیا موسیقی نسبی (relative music) با زیروبمی آغازین (startpitch) نوشته شود یا خیر
.TP
.B \fBrel\-absolute\fP
مشخص می‌کند که آیا اولین زیروبمی در یک عبارت نسبی بدون startpitch مشخص،
مطلق در نظر گرفته شود یا خیر. اگر \fBfalse\fP باشد، نسبی با
\fBc\(aq\fP\& در نظر گرفته می‌شود. اگر \fBtrue\fP باشد، مطلق فرض می‌شود (در واقع
نسبی با \fBf\fP\&). در صورت تنظیم نشدن، مقدار پیش‌فرض این متغیر تنها در صورتی
\fBtrue\fP خواهد بود که نسخه LilyPond موجود در سند >= 2.18 باشد.
.TP
.B \fBindent\-tabs\fP [\fBfalse\fP]
مشخص می‌کند که آیا از تب‌ها (tabs) برای تورفتگی استفاده شود یا خیر
.TP
.B \fBindent\-width\fP [2]
تعداد فاصله‌ها (spaces) برای هر سطح تورفتگی (در صورت عدم استفاده از تب‌ها)
.TP
.B \fBfull\-html\fP [\fBTrue\fP]
در صورت تنظیم روی True، یک سند کامل با خروجی HTML دارای پررنگ‌سازی نحوی (syntax\-highlighted)
صادر می‌شود، در غیر این صورت تنها محتوای خام پیچیده‌شده در عنصری
که با متغیرهای \fBwrapper\-\fP پیکربندی شده است صادر خواهد شد.
.TP
.B \fBstylesheet\fP
نام فایل برای ارجاع به‌عنوان شیوه‌نامه (stylesheet) خارجی جهت
HTML دارای پررنگ‌سازی نحوی. این نام فایل عیناً
در برچسب \fB<link rel=\(dqstylesheet\(dq>\fP استفاده می‌شود.
.TP
.B \fBinline\-style\fP [\fBfalse\fP]
مشخص می‌کند که آیا برای HTML دارای پررنگ‌سازی نحوی از صفت‌های سبک درون‌خطی (inline style) استفاده شود یا خیر.
به‌طور پیش‌فرض یک شیوه‌نامه css تعبیه می‌شود.
.TP
.B \fBnumber\-lines\fP [\fBfalse\fP]
مشخص می‌کند که آیا هنگام ایجاد HTML دارای پررنگ‌سازی نحوی، شماره خطوط اضافه شود یا خیر.
.TP
.B \fBwrapper\-tag\fP [\fBpre\fP]
برچسبی که HTML دارای پررنگ‌سازی نحوی در آن قرار می‌گیرد. مقادیر ممکن:
\fBdiv\fP، \fBpre\fP، \fBid\fP و \fBcode\fP
.TP
.B \fBwrapper\-attribute\fP [\fBclass\fP]
صفتی که برای برچسب دربرگیرنده استفاده می‌شود. مقادیر ممکن: \fBid\fP و \fBclass\fP\&.
.TP
.B \fBdocument\-id\fP [\fBlilypond\fP]
نامی که برای wrapper\-attribute اعمال می‌شود.
اگر سه گزینه پیشین از مقادیر پیش‌فرض خود استفاده کنند،
عناصر HTML پررنگ‌شده در عنصری به شکل
\fB<pre class=\(dqlilypond\(dq></pre>\fP قرار می‌گیرند.
.TP
.B \fBlinenumbers\-id\fP [\fBlinenumbers\fP]
اگر شماره خطوط صادر شوند، این نامی است که برای عناصر \fB<td>\fP استفاده می‌شود
.UNINDENT
.UNINDENT
.UNINDENT
.sp
این متغیرها بر خروجی دستورهای اطلاعاتی اثر می‌گذارند:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B \fBwith\-filename\fP
نام فایل را در کنار اطلاعاتی نظیر نسخه و
غیره چاپ می‌کند. اگر بیش از یک فایل مشخص شده باشد، این متغیر به‌طور پیش‌فرض
\fBtrue\fP است.
.UNINDENT
.UNINDENT
.UNINDENT.SH "مثال‌ها (EXAMPLES)"
.sp
در اینجا مثالی برای تنظیم مجدد تورفتگی و ترانهش (transpose) یک فایل LilyPond آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ly \(dqindent; transpose c d\(dq \-o output.ly file.ly
.EE
.UNINDENT
.UNINDENT
.sp
مثال‌هایی با استفاده از \(aq*\(aq در نام فایل خروجی:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ly \(dqtranspose c d\(dq *.ly \-o \(aq*\-transposed.ly\(aq
ly highlight *.ly \-o \(aqhtml/?.html\(aq
.EE
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
Wilbert Berendsen
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
2025, Wilbert Berendsen
.\" End of generated man page.