'\" t
.\"     Title: mkvpropedit
.\"    Author: Moritz Bunkus <moritz@bunkus.org>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2026-08-24
.\"    Manual: User Commands
.\"    Source: MKVToolNix 101.0
.\"  Language: English
.\"
.TH "MKVPROPEDIT" "1" "2026\-08\-24" "MKVToolNix 101\&.0" "User Commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
mkvpropedit \- ویرایش مشخصات فایل‌های Matroska(TM) موجود بدون نیاز به بازترکیب کامل (remux)
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBmkvpropedit\fR\ 'u
\fBmkvpropedit\fR [options] {source\-filename} {actions}
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه یک فایل موجود
Matroska(TM)
را تحلیل کرده و برخی از مشخصات آن را ویرایش می‌کند\&. سپس آن تغییرات را روی فایل موجود می‌نویسد\&. از جمله مشخصاتی که می‌توانند تغییر کنند، عناصر اطلاعات قطعه (مانند عنوان) و سرآیندهای ترک (مانند کد زبان، پرچم «ترک پیش‌فرض» یا نام) هستند\&.
.PP
گزینه‌ها:
.PP
\fB\-l\fR, \fB\-\-list\-property\-names\fR
.RS 4
نام تمام مشخصات شناخته‌شده و قابل ویرایش، نوع آن‌ها (رشته، عدد صحیح، بولی و غیره) و یک توضیح کوتاه را فهرست می‌کند\&. برنامه پس از آن خارج می‌شود؛ بنابراین نیازی به ارائه پارامتر
\fIsource\-filename\fR
نیست\&.
.RE
.PP
\fB\-p\fR, \fB\-\-parse\-mode\fR \fImode\fR
.RS 4
حالت تجزیه را تنظیم می‌کند\&. پارامتر \*(Aq\fImode\fR\*(Aq می‌تواند \*(Aqfast\*(Aq (که مقدار پیش‌فرض نیز هست) یا \*(Aqfull\*(Aq باشد\&. حالت \*(Aqfast\*(Aq کل فایل را تجزیه نمی‌کند بلکه از عناصر فراپیمایش (meta seek) برای یافتن عناصر مورد نیاز در فایل مبدأ استفاده می‌کند\&. در ۹۹٪ موارد این کار کافی است\&. اما برای فایل‌هایی که فاقد عناصر فراپیمایش هستند یا آسیب دیده‌اند، ممکن است کاربر مجبور به استفاده از حالت تجزیه \*(Aqfull\*(Aq شود\&. پیمایش کامل یک فایل ممکن است چند دقیقه طول بکشد در حالی که پیمایش سریع تنها چند ثانیه زمان می‌برد\&.
.RE
.PP
کنش‌های مربوط به مشخصات اطلاعات ترک و قطعه:
.PP
\fB\-e\fR, \fB\-\-edit\fR \fIselector\fR
.RS 4
بخش مورد نظر از فایل
Matroska(TM)
(اطلاعات قطعه یا سرآیندهای یک ترک مشخص) را تعیین می‌کند که تمام کنش‌های بعدی
add،
set
و
delete
روی آن اعمال می‌شوند\&. این گزینه می‌تواند چندین بار استفاده شود تا تغییرات روی بیش از یک عنصر اعمال شوند\&.
.sp
به‌طور پیش‌فرض
\fBmkvpropedit\fR(1)
بخش اطلاعات قطعه را ویرایش خواهد کرد\&.
.sp
برای شرح کامل ساختار دستوری، بخش مربوط به
انتخاب‌گرهای ویرایش
را ببینید\&.
.RE
.PP
\fB\-a\fR, \fB\-\-add\fR \fIname\fR=\fIvalue\fR
.RS 4
مشخصه
\fIname\fR
را با مقدار
\fIvalue\fR
اضافه می‌کند\&. این مشخصه حتی اگر قبلاً وجود داشته باشد نیز اضافه خواهد شد\&. توجه داشته باشید که اکثر مشخصات یکتا هستند و نمی‌توانند بیش از یک بار وجود داشته باشند\&.
.RE
.PP
\fB\-s\fR, \fB\-\-set\fR \fIname\fR=\fIvalue\fR
.RS 4
تمام نمونه‌های مشخصه
\fIname\fR
را به مقدار
\fIvalue\fR
تنظیم می‌کند\&. اگر چنین مشخصه‌ای وجود نداشته باشد، اضافه خواهد شد\&.
.RE
.PP
\fB\-d\fR, \fB\-\-delete\fR \fIname\fR
.RS 4
تمام نمونه‌های مشخصه
\fIname\fR
را حذف می‌کند\&. توجه داشته باشید که برخی مشخصات الزامی هستند و نمی‌توان آن‌ها را حذف کرد\&.
.RE
.PP
کنش‌های مربوط به برچسب‌ها و فصل‌ها:
.PP
\fB\-t\fR, \fB\-\-tags\fR \fIselector\fR:\fIfilename\fR
.RS 4
برچسب‌های موجود در فایل را با برچسب‌های موجود در
filename
اضافه یا جایگزین می‌کند، یا در صورت خالی بودن
filename
آن‌ها را حذف می‌کند\&.
\fBmkvpropedit\fR(1)
همان قالب برچسب‌های XML را می‌خواند که
\fBmkvmerge\fR(1)
نیز می‌خواند\&.
.sp
شناسه
\fIselector\fR
باید یکی از کلمات
\fBall\fR،
\fBglobal\fR
یا
\fBtrack\fR
باشد\&. با
\fBall\fR،
\fBmkvpropedit\fR(1)
تمام برچسب‌های موجود در یک فایل را جایگزین یا حذف می‌کند\&. با
\fBglobal\fR
تنها برچسب‌های سراسری جایگزین یا حذف می‌شوند\&.
.sp
با
\fBtrack\fR،
\fBmkvpropedit\fR(1)
برچسب‌ها را برای یک ترک خاص جایگزین می‌کند\&. علاوه بر این، برچسب‌های خوانده‌شده از
filename
به همان ترک اختصاص خواهند یافت\&. ترک به همان شیوه‌ای مشخص می‌شود که
انتخاب‌گرهای ویرایش
تعیین می‌شوند (در زیر ببینید)، مانند
\-\-tags track:a1:new\-audio\-tags\&.xml\&.
.RE
.PP
\fB\-\-add\-track\-statistics\-tags\fR
.RS 4
آمار تمام ترک‌های یک فایل را محاسبه کرده و برچسب‌های آماری جدیدی برای آن‌ها اضافه می‌کند\&. اگر فایل قبلاً حاوی چنین برچسب‌هایی باشد، به‌روزرسانی خواهند شد\&.
.RE
.PP
\fB\-\-delete\-track\-statistics\-tags\fR
.RS 4
تمام برچسب‌های آماری موجود ترک‌ها را از یک فایل حذف می‌کند\&. اگر فایل حاوی برچسب‌های آماری ترک نباشد، تغییری نخواهد کرد\&.
.RE
.PP
\fB\-c\fR, \fB\-\-chapters\fR \fIfilename\fR
.RS 4
فصل‌های موجود در فایل را با فصل‌های موجود در
filename
اضافه یا جایگزین می‌کند، یا در صورت خالی بودن
filename
آن‌ها را حذف می‌کند\&.
\fBmkvpropedit\fR(1)
همان قالب‌های XML و قالب‌های فصل ساده‌ای را می‌خواند که
\fBmkvmerge\fR(1)
نیز می‌خواند\&.
.RE
.PP
کنش‌های مدیریت پیوست‌ها:
.PP
\fB\-\-add\-attachment\fR \fIfilename\fR
.RS 4
پیوست جدیدی را از
\fIfilename\fR
اضافه می‌کند\&.
.sp
اگر گزینه
\fB\-\-attachment\-name\fR
پیش از این گزینه استفاده شده باشد، مقدار آن به عنوان نام پیوست جدید استفاده می‌شود\&. در غیر این صورت از
\fIfilename\fR
برگرفته می‌شود\&.
.sp
اگر گزینه
\fB\-\-attachment\-mime\-type\fR
پیش از این گزینه استفاده شده باشد، مقدار آن به عنوان نوع MIME پیوست جدید استفاده می‌شود\&. در غیر این صورت از محتوای
\fIfilename\fR
به‌طور خودکار شناسایی می‌شود\&.
.sp
اگر گزینه
\fB\-\-attachment\-description\fR
پیش از این گزینه استفاده شده باشد، مقدار آن به عنوان توضیحات پیوست جدید استفاده می‌شود\&. در غیر این صورت هیچ توضیحی تنظیم نخواهد شد\&.
.sp
اگر گزینه
\fB\-\-attachment\-uid\fR
پیش از این گزینه استفاده شده باشد، مقدار آن به عنوان شناسه یکتا (UID) پیوست جدید استفاده می‌شود\&. در غیر این صورت یک UID تصادفی به‌طور خودکار ایجاد می‌شود\&.
.RE
.PP
\fB\-\-replace\-attachment\fR \fIselector\fR:\fIfilename\fR
.RS 4
یک یا چند پیوست مطابق با
\fIselector\fR
را با فایل
\fIfilename\fR
جایگزین می‌کند\&. اگر بیش از یک پیوست موجود با
\fIselector\fR
مطابقت داشته باشد، محتوای همه آن‌ها با محتوای
\fIfilename\fR
جایگزین خواهد شد\&.
.sp
شناسه
\fIselector\fR
می‌تواند یکی از چهار شکل را داشته باشد\&. این اشکال در زیر در بخش
انتخاب‌گرهای پیوست
توضیح داده شده‌اند\&.
.sp
اگر گزینه
\fB\-\-attachment\-name\fR
پیش از این گزینه استفاده شده باشد، مقدار آن به عنوان نام جدید برای هر پیوست ویرایش‌شده تنظیم می‌شود\&. در غیر این صورت نام‌ها تغییر نمی‌کنند\&.
.sp
اگر گزینه
\fB\-\-attachment\-mime\-type\fR
پیش از این گزینه استفاده شده باشد، مقدار آن به عنوان نوع MIME جدید برای هر پیوست ویرایش‌شده تنظیم می‌شود\&. در غیر این صورت نوع‌های MIME تغییر نمی‌کنند\&.
.sp
اگر گزینه
\fB\-\-attachment\-description\fR
پیش از این گزینه استفاده شده باشد، مقدار آن به عنوان توضیحات جدید برای هر پیوست ویرایش‌شده تنظیم می‌شود\&. در غیر این صورت توضیحات تغییر نمی‌کنند\&.
.sp
اگر گزینه
\fB\-\-attachment\-uid\fR
پیش از این گزینه استفاده شده باشد، مقدار آن به عنوان UID جدید برای هر پیوست ویرایش‌شده تنظیم می‌شود\&. در غیر این صورت UIDها تغییر نمی‌کنند\&.
.RE
.PP
\fB\-\-update\-attachment\fR \fIselector\fR
.RS 4
مشخصات یک یا چند پیوست منطبق بر
\fIselector\fR
را تنظیم می‌کند\&. اگر بیش از یک پیوست با
\fIselector\fR
مطابقت داشته باشد، مشخصات همه آن‌ها به‌روزرسانی خواهد شد\&.
.sp
شناسه
\fIselector\fR
می‌تواند یکی از چهار شکل را داشته باشد\&. این اشکال در زیر در بخش
انتخاب‌گرهای پیوست
توضیح داده شده‌اند\&.
.sp
اگر گزینه
\fB\-\-attachment\-name\fR
پیش از این گزینه استفاده شده باشد، مقدار آن به عنوان نام جدید برای هر پیوست ویرایش‌شده تنظیم می‌شود\&. در غیر این صورت نام‌ها تغییر نمی‌کنند\&.
.sp
اگر گزینه
\fB\-\-attachment\-mime\-type\fR
پیش از این گزینه استفاده شده باشد، مقدار آن به عنوان نوع MIME جدید برای هر پیوست ویرایش‌شده تنظیم می‌شود\&. در غیر این صورت نوع‌های MIME تغییر نمی‌کنند\&.
.sp
اگر گزینه
\fB\-\-attachment\-description\fR
پیش از این گزینه استفاده شده باشد، مقدار آن به عنوان توضیحات جدید برای هر پیوست ویرایش‌شده تنظیم می‌شود\&. در غیر این صورت توضیحات تغییر نمی‌کنند\&.
.sp
اگر گزینه
\fB\-\-attachment\-uid\fR
پیش از این گزینه استفاده شده باشد، مقدار آن به عنوان UID جدید برای هر پیوست ویرایش‌شده تنظیم می‌شود\&. در غیر این صورت UIDها تغییر نمی‌کنند\&.
.RE
.PP
\fB\-\-delete\-attachment\fR \fIselector\fR
.RS 4
یک یا چند پیوست منطبق با
\fIselector\fR
را حذف می‌کند\&.
.sp
شناسه
\fIselector\fR
می‌تواند یکی از چهار شکل را داشته باشد\&. این اشکال در زیر در بخش
انتخاب‌گرهای پیوست
توضیح داده شده‌اند\&.
.RE
.PP
گزینه‌های مربوط به کنش‌های پیوست:
.PP
\fB\-\-attachment\-name\fR \fIname\fR
.RS 4
نام مورد استفاده برای عملیات بعدی
\fB\-\-add\-attachment\fR
یا
\fB\-\-replace\-attachment\fR
را تعیین می‌کند\&.
.RE
.PP
\fB\-\-attachment\-mime\-type\fR \fImime\-type\fR
.RS 4
نوع MIME مورد استفاده برای عملیات بعدی
\fB\-\-add\-attachment\fR
یا
\fB\-\-replace\-attachment\fR
را تعیین می‌کند\&.
.RE
.PP
\fB\-\-attachment\-description\fR \fIdescription\fR
.RS 4
توضیحات مورد استفاده برای عملیات بعدی
\fB\-\-add\-attachment\fR
یا
\fB\-\-replace\-attachment\fR
را تعیین می‌کند\&.
.RE
.PP
\fB\-\-enable\-legacy\-font\-mime\-types\fR
.RS 4
استفاده از نوع‌های قدیمی (legacy)
MIME
را برای برخی انواع پیوست‌های قلم فعال می‌کند\&. برای نمونه، \*(Aqapplication/x\-truetype\-font\*(Aq به جای \*(Aqfonts/ttf\*(Aq برای قلم‌های TrueType استفاده خواهد شد\&.
.sp
این امر هم بر افزودن پیوست‌های جدید و هم بر جایگزینی پیوست‌های موجود تأثیر می‌گذارد، اما تنها زمانی که نوع جدید
MIME
مشخص نشده باشد\&. سایر پیوست‌های موجود تغییر نمی‌کنند\&.
.sp
نوع‌های
MIME
تحت تأثیر عبارتند از \*(Aqfont/sfnt\*(Aq، \*(Aqfont/ttf\*(Aq و \*(Aqfont/collection\*(Aq که همگی به \*(Aqapplication/x\-truetype\-fonts\*(Aq نگاشت می‌شوند و \*(Aqfont/otf\*(Aq که به \*(Aqapplication/vnd\&.ms\-opentype\*(Aq نگاشت می‌شود\&.
.RE
.PP
سایر گزینه‌ها:
.PP
\fB\-\-disable\-language\-ietf\fR
.RS 4
به‌طور معمول هنگامی که کاربر تغییراتی را در مشخصه سرآیند ترک \*(Aqlanguage\*(Aq درخواست می‌کند،
\fBmkvpropedit\fR(1)
علاوه بر عنصر قدیمی
Language،
همان تغییر را روی عنصر سرآیند ترک جدید
LanguageIETF
نیز اعمال خواهد کرد\&. اگر از این گزینه استفاده شود، تغییر تنها روی عنصر قدیمی
Language
اعمال می‌شود\&.
.sp
این گزینه بر تغییرات درخواست‌شده از طریق مشخصه سرآیند ترک \*(Aqlanguage\-ietf\*(Aq تأثیری ندارد\&.
.RE
.PP
\fB\-\-normalize\-language\-ietf\fR \fImode\fR
.RS 4
نرمال‌سازی تمام برچسب‌های زبان IETF BCP 47 را فعال می‌کند؛ چه به شکل متعارف (canonical) با حالت \*(Aqcanonical\*(Aq، چه به شکل زیربرچسب‌های زبان گسترش‌یافته با حالت \*(Aqextlang\*(Aq، یا با حالت \*(Aqoff\*(Aq آن را غیرفعال می‌کند\&. به‌طور پیش‌فرض، نرمال‌سازی به شکل متعارف اعمال می‌شود\&.
.sp
در شکل متعارف، تمام زیربرچسب‌هایی که مقادیر ترجیحی برای آن‌ها وجود دارد با آن مقادیر ترجیحی جایگزین می‌شوند\&. برای نمونه این کار \*(Aqzh\-yue\-jyutping\*(Aq را به \*(Aqyue\-jyutping\*(Aq یا \*(Aqfr\-FX\*(Aq را به \*(Aqfr\-FR\*(Aq تبدیل می‌کند\&.
.sp
برای شکل زیربرچسب‌های زبان گسترش‌یافته، ابتدا شکل متعارف ساخته می‌شود\&. پس از آن تمام زبان‌های اصلی که زیربرچسب زبان گسترش‌یافته دارند، با آن زیربرچسب زبان گسترش‌یافته و پیشوند آن جایگزین می‌شوند\&. برای نمونه این کار \*(Aqyue\-jyutping\*(Aq را دوباره به \*(Aqzh\-yue\-jyutping\*(Aq تبدیل می‌کند اما تأثیری بر \*(Aqfr\-FR\*(Aq ندارد زیرا \*(Aqfr\*(Aq یک زیربرچسب زبان گسترش‌یافته نیست\&.
.sp
این نرمال‌سازی تنها برای عناصری اعمال می‌شود که واقعاً تغییر یافته‌اند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
هنگام ویرایش سرآیندهای ترک، تنها آن دسته از عناصر زبان ترک که از طریق مشخصات ویرایش تعیین شده‌اند تحت تأثیر قرار می‌گیرند\&. زبان ترک‌هایی که ویرایش نمی‌شوند، تغییر نخواهد کرد\&. همچنین ویرایش یک ترک بدون تغییر مشخصه زبان آن، تأثیری بر زبان ترک نخواهد داشت\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
هنگام ویرایش فصل‌ها، تمام عناصر زبان تمامی عناصر فصل تحت تأثیر قرار می‌گیرند زیرا فصل‌های موجود همیشه به‌طور کامل جایگزین می‌شوند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
هنگام ویرایش برچسب‌ها، تنها عناصر زبان آن برچسب‌هایی که واقعاً جایگزین می‌شوند تحت تأثیر قرار می‌گیرند\&. برای نمونه، هنگامی که برچسب‌های سراسری را جایگزین می‌کنید، برچسب‌های موجود ترک تحت تأثیر قرار نمی‌گیرند\&.
.RE
.sp
بهترین راه برای نرمال‌سازی تمام برچسب‌های زبان موجود در یک فایل، ترکیب مجدد (remux) آن با
\fBmkvmerge\fR(1)
و تنظیم گزینه \*(Aq\-\-normalize\-language\-ietf\*(Aq روی حالت مورد نظر است\&.
.RE
.PP
\fB\-\-command\-line\-charset\fR \fIcharacter\-set\fR
.RS 4
مجموعه‌نویسه مبدأ برای تبدیل رشته‌های ارائه‌شده در خط فرمان را تعیین می‌کند\&. پیش‌فرض آن برابر با مجموعه‌نویسه ارائه‌شده توسط موقعیت مکانی (locale) فعلی سیستم است\&.
.RE
.PP
\fB\-\-output\-charset\fR \fIcharacter\-set\fR
.RS 4
مجموعه‌نویسه‌ای را که رشته‌های خروجی باید به آن تبدیل شوند، تعیین می‌کند\&. پیش‌فرض آن مجموعه‌نویسه ارائه‌شده توسط موقعیت مکانی (locale) فعلی سیستم است\&.
.RE
.PP
\fB\-r\fR, \fB\-\-redirect\-output\fR \fIfile\-name\fR
.RS 4
تمام پیام‌ها را به جای کنسول، در فایل
\fIfile\-name\fR
می‌نویسد\&. اگرچه این کار را می‌توان به‌سادگی با تغییر مسیر خروجی شل انجام داد، اما مواردی وجود دارد که این گزینه لازم است: هنگامی که ترمینال پیش از نوشتن خروجی در فایل، آن را بازتفسیر می‌کند\&. مجموعه‌نویسه تعیین‌شده با
\fB\-\-output\-charset\fR
رعایت می‌شود\&.
.RE
.PP
\fB\-\-no\-bom\fR
.RS 4
به‌طور معمول فایل‌های متنی ایجادشده و رمزگذاری‌شده در یکی از گونه‌های UTF با یک نشانگر ترتیب بایت (BOM) شروع می‌شوند\&. استفاده از این گزینه، نوشتن آن نشانگر ترتیب بایت را غیرفعال می‌کند\&.
.RE
.PP
\fB\-\-ui\-language\fR \fIcode\fR
.RS 4
استفاده از ترجمه‌های زبان
\fIcode\fR
را اجبار می‌کند (برای نمونه \*(Aqde_DE\*(Aq برای ترجمه‌های آلمانی)\&. وارد کردن \*(Aqlist\*(Aq به عنوان
\fIcode\fR
باعث می‌شود برنامه فهرستی از ترجمه‌های موجود را خروجی دهد\&.
.RE
.PP
\fB\-\-abort\-on\-warnings\fR
.RS 4
به برنامه می‌گوید که پس از صدور نخستین هشدار متوقف شود\&. کد خروج برنامه برابر با ۱ خواهد بود\&.
.RE
.PP
\fB\-\-debug\fR \fItopic\fR
.RS 4
اشکال‌زدایی را برای یک قابلیت خاص فعال می‌کند\&. این گزینه تنها برای توسعه‌دهندگان مفید است\&.
.RE
.PP
\fB\-\-engage\fR \fIfeature\fR
.RS 4
قابلیت‌های آزمایشی را فعال می‌کند\&. فهرستی از قابلیت‌های موجود را می‌توان با
\fBmkvpropedit \-\-engage list\fR
دریافت کرد\&. این ویژگی‌ها برای استفاده در شرایط عادی در نظر گرفته نشده‌اند\&.
.RE
.PP
\fB\-\-gui\-mode\fR
.RS 4
حالت رابط گرافیکی کاربر (GUI) را فعال می‌کند\&. در این حالت ممکن است خطوطی با قالب‌بندی ویژه خروجی داده شوند که به یک واسط کاربری کنترل‌کننده گزارش می‌دهند چه اتفاقی در حال رخ دادن است\&. این پیام‌ها از قالب \*(Aq#GUI#message\*(Aq پیروی می‌کنند\&. این پیام ممکن است با جفت‌های کلید/مقدار دنبال شود، مانند \*(Aq#GUI#message#key1=value1#key2=value2\&...\*(Aq\&. نه پیام‌ها و نه کلیدها هرگز ترجمه نمی‌شوند و همواره به انگلیسی خروجی داده می‌شوند\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
خروجی پرگو ارائه می‌دهد و تمام عناصر مهم
Matroska(TM)
را هنگام خوانده شدن نمایش می‌دهد\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
اطلاعات کاربرد را نشان داده و خارج می‌شود\&.
.RE
.PP
\fB\-V\fR, \fB\-\-version\fR
.RS 4
اطلاعات نسخه را نشان داده و خارج می‌شود\&.
.RE
.PP
\fB@\fR\fIoptions\-file\&.json\fR
.RS 4
آرگومان‌های اضافی خط فرمان را از فایل
\fIoptions\-file\fR
می‌خواند\&. برای توضیحات کامل در مورد قالب‌های پشتیبانی‌شده برای چنین فایل‌هایی، بخش بنام "Option files" را در صفحه راهنمای
\fBmkvmerge\fR(1)
ببینید\&.
.RE
.SH "انتخاب‌گرهای ویرایش (EDIT SELECTORS)"
.PP
گزینه
\fB\-\-edit\fR
بخش مورد نظر از فایل
Matroska(TM)
(اطلاعات قطعه یا سرآیندهای یک ترک خاص) را تعیین می‌کند که تمام کنش‌های بعدی
add،
set
و
delete
روی آن اعمال می‌شوند\&. این حالت تا زمانی که گزینه بعدی
\fB\-\-edit\fR
یافت شود معتبر می‌ماند\&. به آرگومان این گزینه، انتخاب‌گر ویرایش گفته می‌شود\&.
.PP
به‌طور پیش‌فرض
\fBmkvpropedit\fR(1)
بخش اطلاعات قطعه را ویرایش خواهد کرد\&.
.SS "اطلاعات قطعه (Segment information)"
.PP
اطلاعات قطعه را می‌توان با یکی از این سه کلمه انتخاب کرد: \*(Aqinfo\*(Aq، \*(Aqsegment_info\*(Aq یا \*(Aqsegmentinfo\*(Aq\&. این بخش شامل مشخصاتی مانند عنوان قطعه یا
UID
قطعه است\&.
.SS "سرآیندهای ترک (Track headers)"
.PP
سرآیندهای ترک را می‌توان با یک انتخاب‌گر کمی پیچیده‌تر انتخاب کرد\&. تمام گونه‌ها با \*(Aqtrack:\*(Aq آغاز می‌شوند\&. مشخصات سرآیند ترک شامل عناصری مانند کد زبان، پرچم «ترک پیش‌فرض» یا نام ترک است\&.
.PP
\fBtrack:\fR\fIn\fR
.RS 4
اگر پارامتر
\fIn\fR
یک عدد باشد،
\fIn\fR‌امین
ترک انتخاب خواهد شد\&. ترتیب ترک‌ها همان ترتیبی است که گزینه
\fB\-\-identify\fR
در
\fBmkvmerge\fR(1)
خروجی می‌دهد\&.
.sp
شماره‌گذاری از ۱ آغاز می‌شود\&.
.RE
.PP
\fBtrack:\fR\fIt\fR\fIn\fR
.RS 4
اگر پارامتر با یک تک‌نویسه
\fIt\fR
آغاز شود و به دنبال آن یک
\fIn\fR
بیاید،
\fIn\fR‌امین
ترک از یک نوع ترک مشخص انتخاب خواهد شد\&. پارامتر نوع ترک
\fIt\fR
باید یکی از این چهار نویسه باشد: \*(Aqa\*(Aq برای ترک صوتی، \*(Aqb\*(Aq برای ترک دکمه، \*(Aqs\*(Aq برای ترک زیرنویس و \*(Aqv\*(Aq برای ترک ویدیویی\&. ترتیب ترک‌ها همان ترتیبی است که گزینه
\fB\-\-identify\fR
در
\fBmkvmerge\fR(1)
خروجی می‌دهد\&.
.sp
شماره‌گذاری از ۱ آغاز می‌شود\&.
.RE
.PP
\fBtrack:\fR=\fIuid\fR
.RS 4
اگر پارامتر با یک \*(Aq=\*(Aq آغاز شود و به دنبال آن یک عدد
\fIuid\fR
بیاید، ترکی که عنصر
UID
ترک آن با
\fIuid\fR
داده‌شده برابر باشد انتخاب خواهد شد\&. شناسه‌های
UID
ترک‌ها را می‌توان با
\fBmkvinfo\fR(1)
به دست آورد\&.
.RE
.PP
\fBtrack:\fR@\fInumber\fR
.RS 4
اگر پارامتر با یک \*(Aq@\*(Aq آغاز شود و به دنبال آن یک عدد
\fInumber\fR
بیاید، ترکی که عنصر شماره ترک آن با این
\fInumber\fR
برابر باشد انتخاب خواهد شد\&. شماره ترک‌ها را می‌توان با
\fBmkvinfo\fR(1)
به دست آورد\&.
.RE
.SS "نکات (Notes)"
.PP
به دلیل ماهیت انتخاب‌گرهای ویرایش ترک، ممکن است چندین انتخاب‌گر با سرآیندهای یک ترک یکسان مطابقت داشته باشند\&. در چنین مواردی تمام کنش‌های مربوط به آن انتخاب‌گرهای ویرایش ترکیب شده و به ترتیبی که در خط فرمان داده شده‌اند اجرا خواهند شد\&.
.SH "انتخاب‌گرهای پیوست (ATTACHMENT SELECTORS)"
.PP
یک انتخاب‌گر پیوست همراه با دو کنش
\fB\-\-replace\-attachment\fR
و
\fB\-\-delete\-attachment\fR
استفاده می‌شود\&. این انتخاب‌گر می‌تواند یکی از چهار شکل زیر را داشته باشد:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
انتخاب بر پایه شناسه پیوست\&. در این شکل، انتخاب‌گر صرفاً یک عدد است که همان شناسه پیوست خروجی داده شده توسط دستور شناسایی
\fBmkvmerge\fR(1)
می‌باشد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
انتخاب بر پایه UID پیوست (شناسه یکتا)\&. در این شکل، انتخاب‌گر علامت مساوی
=
به همراه یک عدد است که همان شناسه یکتای پیوست خروجی داده شده توسط دستور شناسایی پرگوی
\fBmkvmerge\fR(1)
می‌باشد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
انتخاب بر پایه نام پیوست\&. در این شکل، انتخاب‌گر عبارت دقیق
name:
به همراه نام پیوست موجود است\&. اگر این انتخاب‌گر همراه با
\fB\-\-replace\-attachment\fR
استفاده شود، دو‌نقطه‌های درون نام برای تطبیق باید به صورت
\ec
اسکیپ شوند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
انتخاب بر پایه نوع MIME\&. در این شکل، انتخاب‌گر عبارت دقیق
mime\-type:
به همراه نوع MIME پیوست موجود است\&. اگر این انتخاب‌گر همراه با
\fB\-\-replace\-attachment\fR
استفاده شود، دو‌نقطه‌های درون نوع MIME برای تطبیق باید به صورت
\ec
اسکیپ شوند\&.
.RE
.SH "مدیریت زبان (LANGUAGE HANDLING)"
.PP
\fBmkvpropedit\fR(1)
بیشتر سعی می‌کند به‌طور پیش‌فرض کار درست را انجام دهد\&. بنابراین اعمال تغییرات روی مشخصه
\fBlanguage\fR
باعث خواهد شد که
\fBmkvpropedit\fR(1)
همان تغییر را بر روی هر دو عنصر جدید "LanguageIETF" و عنصر قدیمی "Language" اعمال کند، شبیه به نحوه عملکرد
\fBmkvmerge\fR(1)
که زبان را بر روی هر دو عنصر اعمال می‌کند\&. برای نمونه هنگام استفاده از
mkvpropedit movie\&.mkv \-\-edit track:2 \-\-set language=zh\-TW
عنصر "LanguageIETF" بر روی
zh\-TW
تنظیم خواهد شد و عنصر قدیمی "Language" بر روی
chi\&.
.PP
علاوه بر این، یک مشخصه سرآیند ترک جدید به نام
\fBlanguage\-ietf\fR
وجود دارد که می‌تواند تنظیم یا حذف شود\&. تغییرات روی این مشخصه تنها بر عنصر سرآیند ترک جدید "LanguageIETF" اعمال می‌شود\&. یک نکته قابل توجه این است که عنصر سرآیند ترک قدیمی "Language" یک عنصر الزامی در Matroska است \(em به این معنی که حتی اگر در فایل وجود نداشته باشد، همچنان یک مقدار ضمنی دارد\&. هنگامی که کاربر تنها مشخصه
\fBlanguage\-ietf\fR
را تنظیم می‌کند و مشخصه
\fBlanguage\fR
را تنظیم نمی‌کند،
\fBmkvpropedit\fR(1)
بنابراین در موارد خاصی عنصر قدیمی "Language" را اضافه کرده و آن را بر روی
und
(به معنای «تعیین‌نشده») تنظیم می‌کند، زیرا کاربر مقداری برای آن مشخص نکرده است\&.
.PP
هنگام خواندن فایل‌های فصل یا برچسب XML، ابزار
\fBmkvpropedit\fR(1)
همانند
\fBmkvmerge\fR(1)
عمل می‌کند\&.
.PP
ایجاد عناصر جدید می‌تواند به‌طور کامل با گزینه خط فرمان `\-\-disable\-language\-ietf` که بر هر سه عنصر جدید اثر می‌گذارد غیرفعال شود\&.
.PP
می‌توانید روش نرمال‌سازی اعمال‌شده بر زیربرچسب‌های زبان گسترش‌یافته را با پارامتر
\fB\-\-normalize\-language\-ietf\fR
انتخاب کنید\&.
.SH "مثال‌ها (EXAMPLES)"
.PP
مثال زیر فایلی به نام \*(Aqmovie\&.mkv\*(Aq را ویرایش می‌کند\&. این دستور عنوان قطعه را تنظیم کرده و کد زبان یک ترک صوتی و یک ترک زیرنویس را تغییر می‌دهد\&. توجه داشته باشید که این مثال را می‌توان با حذف نخستین گزینه
\fB\-\-edit\fR
کوتاه‌تر کرد، زیرا در هر صورت ویرایش عنصر اطلاعات قطعه حالت پیش‌فرض برای تمام گزینه‌های پیش از نخستین گزینه
\fB\-\-edit\fR
است\&.
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvpropedit movie\&.mkv \-\-edit info \-\-set "title=The movie" \-\-edit track:a1 \-\-set language=fre \-\-edit track:a2 \-\-set language=ita
.fi
.if n \{\
.RE
.\}
.PP
مثال دوم پرچم «ترک پیش‌فرض» را از اولین ترک زیرنویس حذف کرده و آن را برای دومی تنظیم می‌کند\&. توجه داشته باشید که
\fBmkvpropedit\fR(1)
برخلاف
\fBmkvmerge\fR(1)،
هنگامی که پرچم «ترک پیش‌فرض» برای یک ترک روی \*(Aq1\*(Aq تنظیم می‌شود، این پرچم را برای سایر ترک‌ها به‌طور خودکار روی \*(Aq0\*(Aq قرار نمی‌دهد\&.
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvpropedit movie\&.mkv \-\-edit track:s1 \-\-set flag\-default=0 \-\-edit track:s2 \-\-set flag\-default=1
.fi
.if n \{\
.RE
.\}
.PP
جایگزینی برچسب‌ها برای دومین ترک زیرنویس در یک فایل به این صورت است:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvpropedit movie\&.mkv \-\-tags track:s2:new\-subtitle\-tags\&.xml
.fi
.if n \{\
.RE
.\}
.PP
حذف تمام برچسب‌ها مستلزم حذف نام فایل است:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvpropedit movie\&.mkv \-\-tags all:
.fi
.if n \{\
.RE
.\}
.PP
جایگزینی فصل‌ها در یک فایل به این صورت است:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvpropedit movie\&.mkv \-\-chapters new\-chapters\&.xml
.fi
.if n \{\
.RE
.\}
.PP
حذف تمام فصل‌ها مستلزم حذف نام فایل است:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvpropedit movie\&.mkv \-\-chapters \*(Aq\*(Aq
.fi
.if n \{\
.RE
.\}
.PP
افزودن یک فایل قلم (Arial\&.ttf) به عنوان پیوست:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvpropedit movie\&.mkv \-\-add\-attachment Arial\&.ttf
.fi
.if n \{\
.RE
.\}
.PP
افزودن یک فایل قلم (89719823\&.ttf) به عنوان پیوست و ارائه برخی اطلاعات، با توجه به اینکه این فایل در واقع همان Arial است:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvpropedit movie\&.mkv \-\-attachment\-name Arial\&.ttf \-\-attachment\-description \*(AqThe Arial font as a TrueType font\*(Aq \-\-attachment\-mime\-type application/x\-truetype\-font \-\-add\-attachment 89719823\&.ttf
.fi
.if n \{\
.RE
.\}
.PP
جایگزینی یک فایل قلم پیوست‌شده (Comic\&.ttf) با یک فایل دیگر (Arial\&.ttf):
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvpropedit movie\&.mkv \-\-attachment\-name Arial\&.ttf \-\-attachment\-description \*(AqThe Arial font as a TrueType font\*(Aq \-\-replace\-attachment name:Comic\&.ttf:Arial\&.ttf
.fi
.if n \{\
.RE
.\}
.PP
حذف دومین فایل پیوست‌شده، هر چه که باشد:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvpropedit movie\&.mkv \-\-delete\-attachment 2
.fi
.if n \{\
.RE
.\}
.PP
حذف تمام قلم‌های پیوست‌شده بر اساس نوع MIME:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvpropedit movie\&.mkv \-\-delete\-attachment mime\-type:application/x\-truetype\-font
.fi
.if n \{\
.RE
.\}
.SH "کدهای خروج (EXIT CODES)"
.PP
\fBmkvpropedit\fR(1)
با یکی از این سه کد خروج خارج می‌شود:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB0\fR
\-\- این کد خروج به این معنی است که ویرایش با موفقیت به پایان رسیده است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB1\fR
\-\- در این حالت
\fBmkvpropedit\fR(1)
دست‌کم یک هشدار صادر کرده است، اما ویرایش ادامه یافته است\&. یک هشدار با پیشوند متن \*(AqWarning:\*(Aq مشخص می‌شود\&. بسته به ماهیت اشکالات رخ‌داده، فایل‌های حاصل ممکن است درست باشند یا خیر\&. اکیداً به کاربر توصیه می‌شود که هم هشدار و هم فایل‌های حاصل را بررسی کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB2\fR
\-\- این کد خروج پس از رخ دادن یک خطا استفاده می‌شود\&.
\fBmkvpropedit\fR(1)
بلافاصله پس از نمایش پیام خطا متوقف می‌شود\&. پیام‌های خطا گستره‌ای از آرگومان‌های اشتباه خط فرمان گرفته تا خطاهای خواندن/نوشتن و فایل‌های آسیب‌دیده را در بر می‌گیرند\&.
.RE
.SH "فایل‌های متنی و تبدیل مجموعه‌نویسه (TEXT FILES AND CHARACTER SET CONVERSIONS)"
.PP
برای بررسی دقیق و عمیق درباره نحوه مدیریت تبدیل‌های مجموعه‌نویسه، کدگذاری ورودی/خروجی، کدگذاری خط فرمان و کدگذاری کنسول در تمامی ابزارهای مجموعه MKVToolNix، لطفاً بخشی با همین عنوان را در صفحه راهنمای
\fBmkvmerge\fR(1)
ببینید\&.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.PP
\fBmkvpropedit\fR(1)
از متغیرهای پیش‌فرضی که تنظیمات محلی (locale) سیستم را تعیین می‌کنند (مانند
\fILANG\fR
و خانواده
\fILC_*\fR)
استفاده می‌کند\&. متغیرهای تکمیلی:
.PP
\fIMKVPROPEDIT_DEBUG\fR، \fIMKVTOOLNIX_DEBUG\fR و شکل کوتاه آن \fIMTX_DEBUG\fR
.RS 4
محتوای آن به گونه‌ای رفتار می‌شود که گویی از طریق گزینه
\fB\-\-debug\fR
ارسال شده است\&.
.RE
.PP
\fIMKVPROPEDIT_ENGAGE\fR، \fIMKVTOOLNIX_ENGAGE\fR و شکل کوتاه آن \fIMTX_ENGAGE\fR
.RS 4
محتوای آن به گونه‌ای رفتار می‌شود که گویی از طریق گزینه
\fB\-\-engage\fR
ارسال شده است\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBmkvmerge\fR(1),
\fBmkvinfo\fR(1),
\fBmkvextract\fR(1),
\fBmkvtoolnix-gui\fR(1)
.SH "وبگاه (WWW)"
.PP
همیشه می‌توان جدیدترین نسخه را در
\m[blue]\fBوبگاه اصلی MKVToolNix\fR\m[]\&\s-2\u[1]\d\s+2
یافت\&.
.SH "نویسنده (AUTHOR)"
.PP
\fBMoritz Bunkus\fR <\&moritz@bunkus\&.org\&>
.RS 4
توسعه‌دهنده
.RE
.SH "نکات (NOTES)"
.IP " 1." 4
وبگاه اصلی MKVToolNix
.RS 4
\%https://mkvtoolnix.download
.RE