'\" t
.\"     Title: appstream-generator
.\"    Author: [بخش "نویسنده" را ببینید]
.\" Generator: DocBook XSL Stylesheets v1.79.2 <http://docbook.sf.net/>
.\"      Date: 18 April,2016
.\"    Manual: appstream-generator
.\"    Source: AppStream Generator
.\"  Language: Persian
.\"
.TH "APPSTREAM\-GENERATOR" "1" "" "AppStream Generator" "appstream\-generator"
.\" -----------------------------------------------------------------
.\" * 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)"
appstream-generator \- تولید فراداده AppStream از مخازن توزیع
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBappstream\-generator\fR\ 'u
\fBappstream\-generator\fR [\fBCOMMAND\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
این صفحه راهنما به‌طور خلاصه دستور
\fBappstream\-generator\fR
را شرح می‌دهد\&.
.PP
\fBappstream\-generator\fR
فراداده‌های AppStream را از مخازن یک توزیع نرم‌افزاری تولید می‌کند\&. این ابزار در حال حاضر از قالب‌های مخزن / توزیع‌های زیر پشتیبانی می‌کند: Debian، Ubuntu، Arch Linux، RPM\-MD (Fedora، Mageia)\&.
.PP
تولیدکننده، فایل‌های فراداده کاتالوگ AppStream را در قالب AppStream YAML یا XML به منظور ارائه به کاربران تولید می‌کند، و همچنین گزارش‌های تفصیلی HTML درباره مؤلفه‌های یافت‌شده و گزارش‌های HTML و JSON از مشکلات مشاهده‌شده در حین تدوین فراداده‌ها ارائه می‌دهد\&. این ابزار فایل‌های \&.desktop و همچنین فایل‌های metainfo را می‌خواند، فونت‌ها را رندر می‌کند، تصاویر را تغییر اندازه می‌دهد، نماگرفت‌ها (screenshots) را کش می‌کند و کارهای دیگر را برای تولید فراداده‌های باکیفیت جهت استفاده مراکز نرم‌افزاری مبتنی بر AppStream و سایر ابزارها انجام می‌دهد\&. معمولاً
\fBappstream\-generator\fR
با گردش کار موجود برای ساخت و تحویل نرم‌افزار در یک توزیع ادغام می‌شود\&.
.PP
ابزار
\fBappstream\-generator\fR
بر پایه کتابخانه
libappstream
برای تبدیل و تحلیل فراداده است\&. اگر صرفاً می‌خواهید پردازش فراداده AppStream را در ابزار دیگری تعبیه کنید، استفاده مستقیم از
libappstream
احتمالاً انتخاب بهتری است\&. ابزار تولیدکننده کارهای سنگینی مانند رندر قلم‌ها و مقیاس‌بندی تصاویر انجام می‌دهد که ممکن است برای موارد ساده ضروری نباشد\&.
.PP
برای استفاده از
\fBappstream\-generator\fR، یک فایل پیکربندی لازم است\&. قالب‌های JSON و YAML پشتیبانی می‌شوند (برای مثال
asgen\-config\&.json
یا
asgen\-config\&.yaml)\&. قالب آن به تفصیل در
\m[blue]\fBمستندات asgen\-config\fR\m[]\&\s-2\u[1]\d\s+2
شرح داده شده است\&.
.PP
این تولیدکننده از طیف گسترده‌ای از ویژگی‌ها پشتیبانی می‌کند که می‌توان آن‌ها را به‌صورت جداگانه پیکربندی کرد تا با نیازهای پروژه‌های مختلف سازگار شده و فراداده‌های تولیدشده با موارد کاربرد خاص تنظیم شوند\&. برای کسب اطلاعات درباره گزینه‌های موجود، به مستندات فایل پیکربندی مراجعه کنید\&.
.PP
برای کسب اطلاعات بیشتر درباره پروژه AppStream و سایر مؤلفه‌هایی که بخشی از آن هستند، صفحات AppStream را در
\m[blue]\fBFreedesktop\&.org\fR\m[]\&\s-2\u[2]\d\s+2
مشاهده کنید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fBrun\fR \fISUITE\fR [\fISECTION\fR]
.RS 4
پردازش فراداده‌های جدید برای مجموعه (suite) توزیع داده‌شده و انتشار آن\&.
.RE
.PP
\fBcleanup\fR
.RS 4
پاک‌سازی فراداده‌ها و فایل‌های چندرسانه‌ای قدیمی/منقضی‌شده از حافظه موقت (cache) و پوشه‌ها\&. توصیه می‌شود این دستور بسته به میزان تغییرات در مخزن نرم‌افزاری، هر هفته یا دست‌کم هر ماه اجرا شود\&.
.RE
.PP
\fBpublish\fR \fISUITE\fR [\fISECTION\fR]
.RS 4
برون‌ریزی تمام فراداده‌ها و انتشار گزارش‌ها در پوشه‌های خروجی (export)\&.
.sp
معمولاً نمی‌خواهید این وظیفه را به‌طور صریح اجرا کنید، زیرا از قبل به‌طور خودکار توسط دستور
\fBrun\fR
انجام می‌شود\&.
.RE
.PP
\fBremove\-found \fR\fB\fISUITE\fR\fR
.RS 4
حذف تمام فراداده‌های پردازش‌شده معتبر و نکات راهنما (hints) از مجموعه انتخاب‌شده\&.
.RE
.PP
\fBforget \fR\fB\fIPKID\fR\fR
.RS 4
حذف تمام اطلاعات موجود درباره این شناسه بسته (package\-id) (کامل یا جزئی)\&.
.sp
یک شناسه بسته از سه‌گانه
name/version/arch
تشکیل شده است\&. برای این دستور، می‌توان نسخه و معماری را حذف کرد تا تمام بسته‌های منطبق با یک نام خاص یا ترکیب نام\-نسخه فراموش شوند\&.
.RE
.PP
\fBinfo \fR\fB\fIPKID\fR\fR
.RS 4
نمایش اطلاعات مرتبط با این شناسه بسته (package\-id) (کامل)\&.
.sp
یک شناسه بسته از سه‌گانه
name/version/arch
تشکیل شده است\&.
.RE
.PP
\fB\-w|\-\-workspace \fR\fB\fIDIR\fR\fR
.RS 4
تعیین مکان فضای کاری (workspace)\&.
.sp
اگر این پرچم حذف شود و هیچ پوشه فضای کاری در فایل پیکربندی تولیدکننده مشخص نشده باشد، پوشه جاری به عنوان مکان فضای کاری در نظر گرفته می‌شود\&.
.sp
این پارامتر، در صورت مشخص شدن، بر هر مکان فضای کاری تعریف‌شده در جاهای دیگر اولویت دارد\&.
.RE
.PP
\fB\-c|\-\-config \fR\fB\fIFILE\fR\fR
.RS 4
تعیین یک فایل پیکربندی\&.
.sp
تعیین صریح یک فایل پیکربندی برای تولیدکننده (JSON یا YAML)\&. اگر این پرچم حذف شود، تولیدکننده در پوشه فضای کاری جاری به دنبال
asgen\-config\&.json، سپس
asgen\-config\&.yaml و سپس
asgen\-config\&.yml
می‌گردد\&.
.sp
اگر هیچ پوشه فضای کاری درون خود فایل پیکربندی تعریف نشده باشد، پوشه‌ای که فایل در آن قرار دارد به عنوان فضای کاری استفاده می‌شود\&. این حالت را می‌توان با تعیین صریح یک فضای کاری با
\fB\-w\fR
لغو کرد\&.
.RE
.PP
\fB\-\-force\fR
.RS 4
اجرای اجباری دستور\&.
.RE
.PP
\fB\-\-verbose\fR
.RS 4
نمایش اطلاعات اشکال‌زدایی اضافی\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
نمایش شماره نسخه
\fBappstream\-generator\fR\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
appstreamcli (1)\&.
.SH "نویسنده (AUTHOR)"
.PP
این صفحه راهنما توسط Matthias Klumpp
<matthias@tenstral\&.net>
نوشته شده است\&.
.SH "حق نشر (COPYRIGHT)"
.br
Copyright \(co 2016-2026 Matthias Klumpp
.br
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
مستندات asgen-config
.RS 4
\%https://github.com/ximion/appstream-generator/blob/master/docs/asgen-config.md
.RE
.IP " 2." 4
Freedesktop.org
.RS 4
\%http://www.freedesktop.org/wiki/Distributions/AppStream
.RE