'\" t
.\"     Title: appstreamcli
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.79.2 <http://docbook.sf.net/>
.\"      Date: 26 July,2012
.\"    Manual: appstreamcli
.\"    Source: AppStream
.\"  Language: Persian
.\"
.TH "APPSTREAMCLI" "1" "" "AppStream" "appstreamcli"
.\" -----------------------------------------------------------------
.\" * 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)"
appstreamcli \- مدیریت قالب‌های فراداده AppStream و جست‌وجوی داده‌های AppStream
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBappstreamcli\fR\ 'u
\fBappstreamcli\fR [\fBCOMMAND\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
این صفحه راهنما به‌طور خلاصه دستور
\fBappstreamcli\fR
را مستند می‌کند\&.
.PP
\fBappstreamcli\fR
یک ابزار کمکی کوچک برای کار با فراداده‌های AppStream و دسترسی به نمایه مؤلفه‌های AppStream از خط فرمان است\&. نمایه مؤلفه‌های AppStream شامل فهرستی از تمام مؤلفه‌های نرم‌افزاری موجود برای توزیع شما است که با نام بسته‌های آن‌ها تطبیق داده شده است\&. این نمایه با استفاده از داده‌های AppStream XML یا Debian DEP\-11 که توسط توزیع شما ارائه می‌شود تولید می‌گردد\&.
.PP
برای اطلاعات بیشتر درباره پروژه AppStream و سایر مؤلفه‌هایی که بخشی از آن هستند، به صفحات AppStream در
\m[blue]\fBFreedesktop\&.org\fR\m[]\&\s-2\u[1]\d\s+2\&.
نگاهی بیندازید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fBget \fR\fB\fIID\fR\fR
.RS 4
دریافت یک مؤلفه از استخر فراداده بر اساس شناسه آن\&.
.RE
.PP
\fBs\fR, \fBsearch \fR\fB\fITERM\fR\fR
.RS 4
جست‌وجو در استخر مؤلفه‌های AppStream برای یک عبارت جست‌وجوی مشخص\&.
.RE
.PP
\fBwhat\-provides \fR\fB\fITYPE\fR\fR\fB \fR\fB\fITERM\fR\fR
.RS 4
بازگرداندن مؤلفه‌هایی که یک مورد مشخص را ارائه می‌دهند\&. نوع مورد را می‌توان با استفاده از پارامتر
\fB\fITYPE\fR\fR
مشخص کرد، و مقداری که باید جست‌وجو شود باید با استفاده از پارامتر
\fB\fITERM\fR\fR
ارائه گردد\&.
.sp
مثال‌ها:
.sp
دریافت مؤلفه‌هایی که نوع رسانه "text/xml" را مدیریت می‌کنند\&.
.sp
\fBappstreamcli\fR
what\-provides mediatype "text/xml"
.sp
دریافت مؤلفه‌ای که کتابخانه "libfoo\&.so\&.2" را ارائه می‌دهد\&.
.sp
\fBappstreamcli\fR
what\-provides lib libfoo\&.so\&.2
.RE
.PP
\fBlist\-reviews \fR\fB\fIID\fR\fR
.RS 4
فهرست کردن نظرات کاربران برای مؤلفه نرم‌افزاری با شناسه مشخص، دریافت شده از یک سرویس برخط سازگار با Open Desktop Ratings Service (ODRS)\&.
.sp
نظرات بر اساس میزان مفید بودن از نظر سایر کاربران مرتب می‌شوند و تعداد نظرات نمایش‌داده‌شده در هر نوبت از طریق پرچم
\fB\-\-limit\fR
محدود می‌شود\&. صفحات بعدی نتایج را می‌توان با استفاده از پرچم
\fB\-\-start\fR
که نمایه نخستین نظر برای دریافت را تعیین می‌کند درخواست کرد\&.
.sp
به‌طور پیش‌فرض، نظرات منطبق با محلی‌سازی جاری سیستم در اولویت هستند؛ از پرچم
\fB\-\-locale\fR
برای انتخاب یک محلی‌سازی دیگر استفاده کنید\&. پرچم
\fB\-\-server\fR
می‌تواند برای دریافت نظرات از یک سرور سازگار با ODRS دیگر به جای سرور پیش‌فرض استفاده شود\&.
.RE
.PP
\fBrefresh\fR, \fBrefresh\-cache\fR
.RS 4
تازه‌سازی پایگاه داده در صورت نیاز\&. در صورتی که می‌خواهید بازسازی پایگاه داده را اجبار کنید، پرچم
\fB\-\-force\fR
را ارسال نمایید\&.
.sp
این دستور باید با دسترسی root اجرا شود\&.
.RE
.PP
\fBstatus\fR
.RS 4
نمایش اطلاعات گوناگون درباره فراداده‌های نصب‌شده و حافظه نهان فراداده\&.
.RE
.PP
\fBos\-info\fR
.RS 4
نمایش اطلاعات درباره سیستم‌عامل جاری از نمایه فراداده\&. این امر مستلزم آن است که سیستم‌عامل یک مؤلفه
operating\-system
برای خود ارائه داده باشد\&.
.RE
.PP
\fBdump \fR\fB\fIID\fR\fR
.RS 4
تخلیه کامل توضیحات XML مؤلفه‌های دارای شناسه مشخص که در استخر فراداده یافت شده‌اند\&.
.RE
.PP
\fBvalidate \fR\fB\fIFILES\fR\fR
.RS 4
اعتبارسنجی فراداده AppStream XML برای مطابقت با مشخصات\&.
.sp
هر دو نوع فراداده XML، یعنی XML بالادست (upstream) و توزیع (distro)، پشتیبانی می‌شوند\&. نوع قالبی که باید اعتبارسنجی شود به‌طور خودکار تعیین می‌گردد\&.
.sp
پرچم
\fB\-\-pedantic\fR
اعتبارسنجی سخت‌گیرانه‌تری را برای پرونده اجرا می‌کند و موارد جزئی و اشکالات نگارشی را نیز در گزارش می‌آورد\&.
.RE
.PP
\fBvalidate\-tree \fR\fB\fIDIRECTORY\fR\fR
.RS 4
اعتبارسنجی فراداده AppStream XML موجود در یک درخت پوشه\&.
.sp
این دستور یک اعتبارسنجی استاندارد روی تمام فراداده‌های یافت‌شده انجام می‌دهد، اما خطاهای دیگر مانند وجود پرونده‌های \&.desktop و معتبر بودن سایر فراداده‌های تکمیلی را نیز بررسی می‌کند\&.
.RE
.PP
\fBcheck\-license \fR\fB\fILICENSE\fR\fR
.RS 4
بررسی اعتبار یک رشته مجوز یا عبارت مجوز و نمایش جزئیات آن\&.
.sp
این گزینه بررسی می‌کند که آیا رشته مجوز برای AppStream معتبر در نظر گرفته می‌شود یا خیر، و در صورت نامعتبر بودن، یک کد خروج غیر صفر برمی‌گرداند\&. این دستور همچنین اطلاعات مفیدی مانند شناسه استاندارد (canonical ID) مجوز، مناسب بودن آن به عنوان مجوزی برای فراداده AppStream، و آزاد و متن‌باز بودن یا انحصاری بودن نرم‌افزار را نمایش می‌دهد\&.
.sp
پروژه AppStream هر مجوزی را که توسط بنیاد نرم‌افزار آزاد (FSF)، پیشگامان متن‌باز (OSI) یا فهرست مجوزهای صریح راهنمای نرم‌افزار آزاد دبیان (DFSG) مناسب شناخته شده باشد، به عنوان آزاد و متن‌باز در نظر می‌گیرد\&.
.RE
.PP
\fBinstall \fR\fB\fIID\fR\fR
.RS 4
نصب یک مؤلفه نرم‌افزاری با شناسه آن با استفاده از مدیر بسته یا Flatpak\&.
.sp
این دستور شناسه مؤلفه AppStream را به یک کاندیدای نصب تبدیل کرده و سپس مدیر بسته بومی یا Flatpak (در صورت وجود) را برای نصب مؤلفه فراخوانی می‌کند\&.
.RE
.PP
\fBremove \fR\fB\fIID\fR\fR
.RS 4
حذف نصب یک مؤلفه نرم‌افزاری با شناسه آن با استفاده از مدیر بسته یا Flatpak\&.
.sp
این دستور نرم‌افزار منطبق با شناسه انتخاب‌شده را با استفاده از مدیر بسته بومی یا Flatpak (در صورت وجود) حذف می‌کند\&.
.RE
.PP
\fBput \fR\fB\fIFILE\fR\fR
.RS 4
نصب یک پرونده فراداده در پوشه مناسب روی دستگاه جاری\&.
.RE
.PP
\fBcompare\-versions\fR, \fBvercmp \fR\fB\fIVER1\fR\fR\fB \fR\fB\fI[CMP]\fR\fR\fB \fR\fB\fIVER2\fR\fR
.RS 4
مقایسه دو شماره نسخه\&. اگر دو شماره نسخه به عنوان پارامتر داده شوند، نسخه‌ها مقایسه شده و نتیجه مقایسه در خروجی استاندارد چاپ می‌شود\&.
.sp
اگر یک شماره نسخه، یک عملگر مقایسه و یک شماره نسخه دیگر به عنوان پارامتر ارسال شوند، نتیجه عملیات مقایسه در خروجی استاندارد چاپ می‌شود، و در صورتی که مقایسه برقرار نباشد،
\fBappstreamcli\fR
با وضعیت خروج غیر صفر خارج می‌شود\&. عملگر مقایسه می‌تواند یکی از موارد زیر باشد:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
eq
\- برابر با
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ne
\- نابرابر با
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
lt
\- کمتر از
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
gt
\- بیشتر از
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
le
\- کمتر یا برابر با
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ge
\- بیشتر یا برابر با
.RE
.RE
.PP
\fBnew\-template \fR\fB\fITYPE\fR\fR\fB \fR\fB\fIFILE\fR\fR
.RS 4
ایجاد یک الگوی پرونده metainfo برای استفاده در پروژه‌های نرم‌افزاری\&. گزینه
\fB\-\-from\-desktop\fR
می‌تواند برای استفاده از یک پرونده \&.desktop به عنوان الگو جهت تولید پرونده نمونه استفاده شود\&.
.sp
پرونده‌های تولیدشده شامل ورودی‌های نمونه‌ای هستند که باید توسط نویسنده پروژه با مقادیر مورد نظر واقعی پر شوند\&.
.sp
نخستین پارامتر
\fITYPE\fR
نام یک نوع مؤلفه AppStream است\&. برای فهرست کامل، به
\m[blue]\fBمستندات\fR\m[]\&\s-2\u[2]\d\s+2
یا خروجی راهنمای
\fBappstreamcli\fR
برای این زیردستور مراجعه کنید\&.
.RE
.PP
\fBmake\-desktop\-file \fR\fB\fIMI_FILE\fR\fR\fB \fR\fB\fIDESKTOP_FILE\fR\fR
.RS 4
ایجاد یک پرونده desktop\-entry استاندارد XDG از یک پرونده metainfo\&. اگر پرونده desktop\-entry مشخص‌شده در
\fIDESKTOP_FILE\fR
از قبل وجود داشته باشد، با اطلاعات جدید استخراج‌شده از پرونده metainfo گسترش می‌یابد؛ در غیر این صورت پرونده جدیدی ایجاد خواهد شد\&.
.sp
این دستور از نخستین
binary
ذکر شده در برچسب
provides
مؤلفه برای فیلد
Exec=
پرونده desktop\-entry جدید استفاده می‌کند\&. اگر این رفتار مورد نظر نیست، پرچم
\fB\-\-exec\fR
می‌تواند برای تعیین صریح یک دودویی جهت اجرا استفاده شود\&. روش‌های دیگر راه‌اندازی برنامه در حال حاضر پشتیبانی نمی‌شوند\&.
.sp
برای تولید یک desktop\-entry مناسب، این دستور فرض می‌کند نه تنها برچسب‌های حداقل مورد نیاز برای یک مؤلفه AppStream تنظیم شده‌اند، بلکه دارای یک برچسب
<icon/>
از نوع "stock" برای توصیف آیکون استانداردی که باید استفاده شود و همچنین یک برچسب
<categories/>
حاوی دسته‌هایی که برنامه باید در آن‌ها قرار گیرد نیز می‌باشد\&.
.RE
.PP
\fBnews\-to\-metainfo \fR\fB\fINEWS_FILE\fR\fR\fB \fR\fB\fIMI_FILE\fR\fR\fB \fR\fB\fI[OUT_FILE]\fR\fR
.RS 4
این دستور یک پرونده NEWS را که توسط بسیاری از پروژه‌های متن‌باز استفاده می‌شود به XML مورد استفاده AppStream تبدیل می‌کند\&. از آنجا که پرونده‌های NEWS متن ساده و آزاد هستند، برای به دست آوردن نتایج منطقی از روش‌های اکتشافی (heuristics) متعددی استفاده می‌شود\&. مبدل همچنین می‌تواند نسخه YAML توصیف انتشار AppStream را خوانده و آن را نیز به XML تبدیل کند\&. پرونده metainfo به نام
\fIMI_FILE\fR
باید وجود داشته باشد، و هر ورودی انتشاری که از قبل در آن وجود دارد با ورودی‌های تولیدشده از
\fINEWS_FILE\fR
جایگزین خواهد شد\&. اگر
\fIMI_FILE\fR
روی "\-" تنظیم شود، هیچ پرونده metainfo خوانده نمی‌شود و فقط ورودی‌های انتشار تولیدشده بدون مؤلفه دربرگیرنده در خروجی استاندارد نوشته می‌شوند\&. اگر
\fI[OUT_FILE]\fR
مشخص شده باشد، داده‌های تغییر یافته به جای اعمال روی
\fIMI_FILE\fR
در آن پرونده خاص نوشته می‌شوند\&. اگر روی "\-" تنظیم شود، خروجی در خروجی استاندارد نوشته خواهد شد\&.
.sp
به جای یک پرونده metainfo، پارامتر
\fIMI_FILE\fR
می‌تواند یک پرونده فراداده انتشار نیز باشد، یعنی پرونده‌ای XML با عنصر ریشه
releases
که برای اطلاعات انتشار خارجی استفاده می‌شود\&. یک پرونده موجود با عنصر ریشه خود شناسایی می‌شود، بنابراین نام پرونده اهمیتی ندارد\&. از آنجا که چنین پرونده‌ای جز ورودی‌های انتشاری که قرار است نوشته شوند چیزی در بر ندارد، در صورت عدم وجود نیز ایجاد می‌شود\&. این حالت فقط برای پرونده‌هایی با نام
*\&.releases\&.xml
که نام الزامی طبق مشخصات است اعمال می‌شود؛ هر پرونده ناموجود دیگر منجر به خطا خواهد شد\&.
.sp
گزینه
\fB\-\-format\fR
می‌تواند برای اجبار خواندن پرونده ورودی در یک قالب مشخص ("text" ،"markdown" یا "yaml") در صورتی که تشخیص خودکار قالب ناموفق باشد، استفاده شود\&. گزینه
\fB\-\-limit\fR
برای محدود کردن تعداد ورودی‌های انتشار نوشته‌شده استفاده می‌شود (جدیدترین ورودی‌ها همیشه در ابتدا خواهند بود)\&. گزینه
\fB\-\-translatable\-count\fR
تعداد توصیفات انتشاری را که به عنوان قابل ترجمه علامت‌گذاری می‌شوند محدود می‌کند که مجدداً از جدیدترین ورودی شمارش می‌شود\&. توصیفات هر انتشار قدیمی‌تر با
translate="no"
علامت‌گذاری می‌شوند تا به الگوی ترجمه وارد نشوند\&.
.RE
.PP
\fBmetainfo\-to\-news \fR\fB\fIMI_FILE\fR\fR\fB \fR\fB\fINEWS_FILE\fR\fR
.RS 4
این دستور عملکرد دستور
\fBnews\-to\-metainfo\fR
را معکوس کرده و با استفاده از XML موجود در پرونده metainfo یا در پرونده فراداده انتشار، یک پرونده NEWS به صورت متنی یا YAML می‌نویسد\&. اگر
\fINEWS_FILE\fR
روی "\-" تنظیم شود، داده‌های حاصل به جای پرونده در خروجی استاندارد نوشته می‌شوند\&.
.sp
اگر
\fIMI_FILE\fR
یک پرونده metainfo باشد که اطلاعات انتشار خود را در یک پرونده خارجی نگهداری می‌کند (<releases type="external"/>)، این دستور با شکست مواجه شده و درخواست می‌کند که پرونده فراداده انتشار به جای آن ارسال شود، زیرا داده‌های ارجاع‌شده بخشی از خود پرونده metainfo نیستند\&.
.sp
گزینه
\fB\-\-format\fR
می‌تواند برای تعیین صریح قالب خروجی ("yaml" ،"text" یا "markdown") استفاده شود\&. اگر تنظیم نشده باشد،
\fBappstreamcli\fR
بر اساس نام
\fINEWS_FILE\fR
حدس می‌زند کدام قالب مناسب‌تر است؛ بنابراین هنگام نوشتن در خروجی استاندارد، تعیین این گزینه الزامی است\&.
.RE
.PP
\fBconvert \fR\fB\fIFILE1\fR\fR\fB \fR\fB\fIFILE1\fR\fR
.RS 4
تبدیل فراداده AppStream XML به نمایش YAML آن و برعکس\&.
.RE
.PP
\fBcompose\fR
.RS 4
گردآوری فهرست فراداده AppStream از یک درخت پوشه حاوی پرونده‌های metainfo\&. این دستور تنها در صورتی در دسترس است که مؤلفه
org\&.freedesktop\&.appstream\&.compose
نصب شده باشد\&. برای اطلاعات بیشتر به
\fBappstreamcli-compose\fR(1)
مراجعه کنید\&.
.RE
.PP
\fB\-\-details\fR
.RS 4
چاپ اطلاعات بیشتر درباره یک مؤلفه یافت‌شده\&.
.RE
.PP
\fB\-\-no\-color\fR
.RS 4
عدم چاپ خروجی رنگی\&.
.RE
.PP
\fB\-\-no\-net\fR
.RS 4
عدم دسترسی به شبکه هنگام اعتبارسنجی فراداده\&.
.sp
همین اثر را می‌توان با تنظیم متغیر محیطی
\fBAS_VALIDATE_NONET\fR
پیش از اجرای
\fBappstreamcli\fR
به دست آورد\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
نمایش شماره نسخه
\fBappstreamcli\fR
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBpkgcli\fR(1)\&.
.SH "نویسنده (AUTHOR)"
.PP
این صفحه راهنما توسط Matthias Klumpp
<matthias@tenstral\&.net>
نوشته شده است\&.
.SH "حق نشر (COPYRIGHT)"
.br
Copyright \(co 2012-2026 Matthias Klumpp
.br
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
Freedesktop.org
.RS 4
\%https://www.freedesktop.org/wiki/Distributions/AppStream
.RE
.IP " 2." 4
مستندات
.RS 4
\%https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html
.RE