'\" t
.\"     Title: appstreamcli compose
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.79.2 <http://docbook.sf.net/>
.\"      Date: 28 Aug,2020
.\"    Manual: appstreamcli compose
.\"    Source: AppStream
.\"  Language: Persian
.\"
.TH "APPSTREAMCLI COMPOSE" "1" "" "AppStream" "appstreamcli compose"
.\" -----------------------------------------------------------------
.\" * 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-compose \- ساخت کاتالوگ فراداده AppStream از درخت‌های پوشه
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBappstreamcli\ compose\fR\ 'u
\fBappstreamcli compose\fR [\fBCOMMAND\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
این صفحه راهنما به‌طور خلاصه دستور
\fBappstreamcli compose\fR
را شرح می‌دهد\&.
.PP
ابزار
\fBappstreamcli compose\fR
برای ساخت کاتالوگ‌های فراداده AppStream از درخت‌های پوشه به کار می‌رود\&. این ابزار همچنین اقدامات متعدد مرتبط با تولید فراداده، مانند تغییر اندازه آیکون‌ها و تصاویر پیش‌نمایش، ادغام داده‌ها از پرونده‌های desktop\-entry ارجاع‌شده و اطلاعات وضعیت ترجمه را انجام می‌دهد\&. بنابراین، این ابزار روشی سریع برای آزمایش نحوه نمایش نهایی فراداده‌های پردازش‌شده برنامه‌ای که به دست کاربران می‌رسد فراهم می‌سازد\&. این ابزار همچنین روشی آسان برای تولید داده‌های AppStream برای پروژه‌هایی فراهم می‌کند که نیازی به تولیدکننده‌های داده پیچیده‌تر مانند
\fBappstream\-generator\fR
ندارند\&.
.PP
برای اینکه دستور
\fBappstreamcli compose\fR
در دسترس باشد، ممکن است لازم باشد ابتدا ماژول اختیاری compose را برای
\fBappstreamcli\fR
نصب کنید\&.
.PP
برای دریافت اطلاعات بیشتر درباره پروژه AppStream و سایر مؤلفه‌هایی که بخشی از آن هستند، به صفحات AppStream در
\m[blue]\fBFreedesktop\&.org\fR\m[]\&\s-2\u[1]\d\s+2
نگاهی بیندازید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fISOURCE\-DIRECTORIES\fR
.RS 4
فهرستی از پوشه‌ها برای پردازش که باید به عنوان آرگومان‌های مکانی مشخص شوند\&. داده‌های تمام پوشه‌ها در یک فضای نام خروجی واحد ترکیب خواهند شد\&.
.RE
.PP
\fB\-\-origin \fR\fB\fINAME\fR\fR
.RS 4
شناسه مبدأ داده‌های AppStream را تنظیم می‌کند\&. این شناسه می‌تواند مقداری مانند
"debian\-unstable\-main"
یا
"flathub"
باشد\&.
.RE
.PP
\fB\-\-result\-root \fR\fB\fIDIR\fR\fR
.RS 4
پوشه‌ای را تنظیم می‌کند که تمام خروجی‌های تولیدشده مستقر بر روی سامانه کاربر به آن صادر می‌شوند\&. اگر این پارامتر مشخص نشود و تنها یک پوشه برای پردازش وجود داشته باشد، از همان پوشه به عنوان مسیر خروجی پیش‌فرض استفاده می‌شود\&.
.sp
اگر هر دو گزینه
\fB\-\-data\-dir\fR
و
\fB\-\-icons\-dir\fR
تنظیم شده باشند، استفاده از
\fB\-\-result\-root\fR
ضروری نیست و هیچ داده‌ای در آن پوشه نوشته نخواهد شد\&.
.RE
.PP
\fB\-\-data\-dir \fR\fB\fIDIR\fR\fR
.RS 4
پوشه‌ای را که کاتالوگ فراداده‌های AppStream تولیدشده در آن نوشته می‌شود، بازنویسی می‌کند\&. داده‌ها مستقیماً در این پوشه نوشته می‌شوند و هیچ زیرپوشه‌ای ایجاد نخواهد شد (برخلاف زمانی که از
\fB\-\-result\-root\fR
برای تنظیم مکان خروجی استفاده می‌شود)\&.
.RE
.PP
\fB\-\-icons\-dir \fR\fB\fIDIR\fR\fR
.RS 4
پوشه‌ای را که آیکون‌های ذخیره‌شده در حافظه نهان (کَش) به آن صادر می‌شوند، بازنویسی می‌کند\&.
.RE
.PP
\fB\-\-hints\-dir \fR\fB\fIDIR\fR\fR
.RS 4
پوشه‌ای را برای ذخیره گزارش‌های راهنمایی (hints) ایجادشده در حین پردازش فراداده‌ها تعیین می‌کند\&. اگر این پارامتر تنظیم نشود، هیچ گزارش راهنمایی به صورت HTML/YAML ذخیره نخواهد شد\&.
.RE
.PP
\fB\-\-media\-dir \fR\fB\fIDIR\fR\fR
.RS 4
در صورت تنظیم، پوشه‌ای با محتوای رسانه‌ای (آیکون‌ها، تصاویر پیش‌نمایش و غیره) ایجاد می‌کند که می‌توان از طریق یک وب‌سرور ارائه کرد\&. فراداده‌ها به گونه‌ای گسترش می‌یابند که شامل اطلاعات مربوط به این رسانه‌های دوردست باشند\&.
.RE
.PP
\fB\-\-media\-baseurl \fR\fB\fIURL\fR\fR
.RS 4
نشانی اینترنتی (URL) که محتوای پوشه تعیین‌شده با
\fB\-\-media\-dir\fR
تحت آن ارائه خواهد شد\&. در صورت ایجاد پوشه رسانه‌ها، تنظیم این مقدار الزامی است\&.
.RE
.PP
\fB\-\-prefix \fR\fB\fIDIR\fR\fR
.RS 4
پیشوند پیش‌فرضی را که در پوشه‌های پردازش‌شده استفاده می‌شود تنظیم می‌کند\&. در صورتی که به صراحت مقداری تعیین نشود، مقدار پیش‌فرض
/usr
در نظر گرفته می‌شود\&.
.RE
.PP
\fB\-\-print\-report \fR\fB\fIMODE\fR\fR
.RS 4
گزارش نکات و مشکلات (که در صورت تعیین
\fB\-\-hints\-dir\fR
به عنوان سند HTML و YAML صادر می‌شود) را به صورت متنی در کنسول چاپ می‌کند\&.
.sp
حالت‌های مختلفی برای چاپ پشتیبانی می‌شوند:
\fIon\-error\fR
تنها در صورت شکست اجرای دستور، گزارشی کوتاه چاپ می‌کند (پیش‌فرض)،
\fIshort\fR
گزارشی چکیده تولید می‌کند که همیشه چاپ می‌شود و
\fIfull\fR
باعث چاپ یک گزارش مفصل می‌گردد\&.
.RE
.PP
\fB\-\-no\-partial\-urls\fR
.RS 4
در صورت تنظیم، تمام نشانی‌های وب در داده‌های تولیدشده به صورت مطلق خواهند بود و از
media_baseurl
استفاده نخواهد شد\&. این امر تغییر آینه (mirror) رسانه‌ها را بدون بازتولید کل داده‌ها دشوارتر می‌کند و به منظور افزایش انعطاف‌پذیری، عموماً توصیه نمی‌شود\&.
.RE
.PP
\fB\-\-icon\-policy \fR\fB\fIPOLICY\-STRING\fR\fR
.RS 4
سیاست آیکون موجود را با یک سیاست سفارشی جایگزین می‌کند\&. سیاست آیکون تعیین می‌کند که با آیکون‌ها در اندازه‌های مختلف چگونه رفتار شود\&. آن‌ها می‌توانند فقط در حافظه نهان آیکون قرار گیرند، یک آیکون دوردست در مکان رسانه‌ها باشند یا هم در حافظه نهان ذخیره شوند و هم در مکان دوردست در دسترس باشند\&.
.sp
رشته سیاست آیکون (icon\-policy) از عبارت‌های جداشده با ویرگولِ
%{size}x%{size}@%{scale}=%{state}
تشکیل شده است\&. مقادیر
size
و
scale
مربوط به اندازه و مقیاس آیکون هستند؛ در صورتی که مقیاس برابر ۱ باشد می‌توان آن را حذف کرد\&. مقدار
state
می‌تواند یکی از مقادیر
remote\c
،
cached
یا
cached\-remote
باشد\&.
.sp
به‌طور پیش‌فرض، سیاست
48x48=cached,48x48@2=cached,64x64=cached,64x64@2=cached,128x128=cached\-remote,128x128@2=cached\-remote
انتخاب شده است\&.
.RE
.PP
\fB\-\-image\-format \fR\fB\fIFORMAT\fR\fR
.RS 4
قالب پرونده‌ای را که آیکون‌ها و تصاویر پیش‌نمایش تولیدشده در آن ذخیره می‌شوند تعیین می‌کند\&. تنها قالب‌های
jxl
و
png
در اینجا مجاز هستند که
jxl
پیش‌فرض است\&.
.sp
قالب JPEG\-XL (jxl) با همان کیفیت بصری، حجم پرونده به مراتب کمتری نسبت به PNG تولید می‌کند، اما کلاینت‌های قدیمی‌تر AppStream قادر به نمایش آن نیستند\&. در صورتی که فراداده‌های تولیدشده باید توسط نرم‌افزارهایی که قبل از پشتیبانی از JPEG\-XL عرضه شده‌اند استفاده شوند، گزینه
png
را انتخاب کنید\&.
.sp
آیکون‌ها همیشه به صورت بدون اتلاف (lossless) ذخیره می‌شوند، در حالی که تصاویر پیش‌نمایش با تعادلی معقول بین کیفیت و اندازه کدگذاری می‌گردند\&.
.RE
.PP
\fB\-\-allow\-custom \fR\fB\fICUSTOM\-KEY\-NAMES\fR\fR
.RS 4
به‌طور پیش‌فرض، تمام ورودی‌های
custom
تنظیم‌شده در داده‌های ورودی MetaInfo حذف می‌شوند\&. این پرچم امکان قرار دادن کلیدهای سفارشی در لیست مجاز را برای انتقال به داده‌های کاتالوگ خروجی نهایی فراهم می‌کند\&. نام کلیدهای سفارشی باید به صورت فهرستی جداشده با ویرگول ارائه شوند\&.
.RE
.PP
\fB\-\-components \fR\fB\fICOMPONENT\-IDs\fR\fR
.RS 4
فهرستی جداشده با ویرگول از شناسه‌های مؤلفه AppStream تعیین می‌کند که باید برای فراداده‌های تولیدشده در نظر گرفته شوند\&. تمام مؤلفه‌های موجود در داده‌های ورودی که در این فهرست ذکر نشده‌اند، برای خروجی نهایی نادیده گرفته خواهند شد\&.
.RE
.PP
\fB\-\-no\-color\fR
.RS 4
خروجی رنگی چاپ نشود\&.
.RE
.PP
\fB\-\-verbose\fR
.RS 4
نمایش اطلاعات اشکال‌زدایی بیشتر\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
نمایش شماره نسخه
\fBappstreamcli compose\fR
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBappstreamcli\fR(1),
\fBappstream-generator\fR(1)\&.
.SH "نویسنده (AUTHOR)"
.PP
این صفحه راهنما توسط Matthias Klumpp نوشته شده است
<matthias@tenstral\&.net>\&.
.SH "حق نشر (COPYRIGHT)"
.br
حق نشر \(co 2020-2026 Matthias Klumpp
.br
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
Freedesktop.org
.RS 4
\%https://www.freedesktop.org/wiki/Distributions/AppStream
.RE