'\" t
.\"     Title: flatpakrepo
.\"    Author: Alexander Larsson <alexl@redhat.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/27/2026
.\"    Manual: flatpakrepo
.\"    Source: flatpak
.\"  Language: Persian
.\"
.TH "FLATPAKREPO" "5" "" "flatpak" "flatpakrepo"
.\" -----------------------------------------------------------------
.\" * 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)"
flatpakrepo \- ارجاع به یک مخزن دوردست
.SH "توضیحات (DESCRIPTION)"
.PP
فلت‌پک (Flatpak) از پرونده‌های flatpakrepo برای به‌اشتراک‌گذاری اطلاعات مخازن دوردست (remotes) استفاده می‌کند\&. پرونده
flatpakrepo
حاوی اطلاعات کافی برای افزودن مخزن دوردست است\&. برای انجام این کار از دستور
\fBflatpak remote\-add \-\-from\fR
استفاده کنید\&.
.PP
پرونده‌های flatpakrepo همچنین ممکن است حاوی اطلاعات بیشتری باشند که هنگام نمایش مخزن دوردست به کاربر، برای مثال در یک فروشگاه برنامه (App Store)، کاربرد دارد\&.
.PP
پسوند نام پرونده که معمولاً برای پرونده‌های flatpakrepo به کار می‌رود
\&.flatpakrepo\&.
است\&.
.PP
پرونده‌های flatpakrepo همچنین می‌توانند در مسیرهای
/usr/share/flatpak/remotes\&.d/
و
/etc/flatpak/remotes\&.d/
قرار گیرند تا مخازن دوردست در سطح کل سیستم را به صورت ایستا از پیش پیکربندی کنند\&. این پرونده‌ها باید حتماً از پسوند
\&.flatpakrepo
استفاده کنند\&. اگر پرونده‌ای با نام یکسان در هر دو مسیر وجود داشته باشد، پرونده موجود در
/etc
اولویت خواهد داشت\&.
.SH "قالب فایل (FILE FORMAT)"
.PP
پرونده flatpakrepo از همان قالب پرونده‌های \&.ini استفاده می‌کند که در پرونده‌های واحد systemd یا پرونده‌های \&.desktop برنامه‌ها به کار می‌رود\&.
.SS "[Flatpak Repo]"
.PP
تمام اطلاعات درون گروه [Flatpak Repo] قرار دارد\&.
.PP
کلیدهای زیر می‌توانند در این گروه حضور داشته باشند:
.PP
\fBVersion\fR (uint64)
.RS 4
نسخه قالب پرونده؛ در صورت وجود باید برابر با 1 باشد\&.
.RE
.PP
\fBUrl\fR (string)
.RS 4
نشانی اینترنتی (URL) مخزن دوردست\&. این کلید اجباری است\&.
.RE
.PP
\fBGPGKey\fR (string)
.RS 4
کلید GPG انکودشده با base64 برای مخزن دوردست\&.
.RE
.PP
\fBDefaultBranch\fR (string)
.RS 4
شاخه پیش‌فرض جهت استفاده برای این مخزن دوردست\&.
.RE
.PP
\fBSubset\fR (string)
.RS 4
محدود کردن مخزن دوردست به زیرمجموعه نام‌برده از مراجع (refs)\&.
.RE
.PP
\fBTitle\fR (string)
.RS 4
عنوان مخزن دوردست\&. این مقدار باید یک نام کاربرپسند باشد که بتوان آن را مثلاً در فروشگاه برنامه نمایش داد\&.
.RE
.PP
\fBComment\fR (string)
.RS 4
خلاصه‌ای کوتاه از مخزن دوردست، برای نمایش مثلاً در فروشگاه برنامه\&.
.RE
.PP
\fBDescription\fR (string)
.RS 4
توضیحات مفصل‌تر درباره مخزن دوردست، برای نمایش مثلاً در فروشگاه برنامه\&.
.RE
.PP
\fBIcon\fR (string)
.RS 4
نشانی URL یک نماد (آیکون) که می‌تواند برای نمایش مخزن دوردست استفاده شود\&.
.RE
.PP
\fBHomepage\fR (string)
.RS 4
نشانی URL صفحه وبی که مخزن دوردست را توصیف می‌کند\&.
.RE
.PP
\fBFilter\fR (string)
.RS 4
مسیر یک پرونده محلی جهت فیلتر کردن مراجع مخزن دوردست (remote refs)\&. برای جزئیات قالب پرونده به
\fBflatpak-remote-add\fR(1)
مراجعه کنید\&.
.sp
نکته: با این فیلد در دستور flatpak remote\-add تا حدی به صورت ویژه رفتار می‌شود\&. اگر مخزنی را با گزینه \-\-if\-not\-exists نصب کنید و آن مخزن از قبل پیکربندی شده باشد، فیلد فیلتر در پیکربندی مخزن در هر صورت به‌روزرسانی خواهد شد\&. همچنین اگر فیلد فیلتر تعیین *نشده* باشد، تمام فیلترهای موجود پاک می‌شوند\&. هدف در اینجا این است که اگر پرونده عادی و بالادستی (بدون فیلتر) flatpakrepo را اضافه کنید، مخزن فیلترشده از پیش‌پیکربندی‌شده بتواند با مخزن عادی جایگزین شود\&.
.RE
.PP
\fBDeploySideloadCollectionID\fR (string)
.RS 4
شناسه مجموعه (collection ID) مخزن دوردست، در صورت وجود\&. این شناسه به صورت یکتا مجموعه برنامه‌های موجود در مخزن دوردست را برای امکان بازتوزیع همتا‌به‌همتا (نگاه کنید به
\fBflatpak\fR(1))
مشخص می‌کند\&. توصیه می‌شود به جای DeployCollectionID یا CollectionID از این کلید استفاده شود، زیرا فقط کلاینت‌های جدیدتر (فلت‌پک 1\&.12\&.8 یا بالاتر) به آن توجه می‌کنند (و کلاینت‌های قدیمی‌تر شناسه‌های مجموعه را به درستی پردازش نمی‌کنند)\&.
.RE
.PP
\fBDeployCollectionID\fR (string)
.RS 4
این گزینه منسوخ شده است اما همچنان برای سازگاری رو به عقب پشتیبانی می‌شود\&. به جای آن از DeploySideloadCollectionID استفاده کنید\&.
.RE
.PP
\fBCollectionID\fR (string)
.RS 4
این گزینه منسوخ شده است اما همچنان برای سازگاری رو به عقب پشتیبانی می‌شود\&. به جای آن از DeploySideloadCollectionID استفاده کنید\&.
.RE
.SH "مثال (EXAMPLE)"
.sp
.if n \{\
.RS 4
.\}
.nf
[Flatpak Repo]
Title=gedit
Url=http://sdk\&.gnome\&.org/repo\-apps/
GPGKey=mQENBFUUCGcBCAC/K9WeV4xCaKr3NKRqPXeY5mpaXAJyasLqCtrDx92WUgbu0voWrhohNAKpqizod2dvzc/XTxm3rHyIxmNfdhz1gaGhynU75Qw4aJVcly2eghTIl++gfDtOvrOZo/VuAq30f32dMIgHQdRwEpgCwz7WyjpqZYltPAEcCNL4MTChAfiHJeeiQ5ibystNBW8W6Ymf7sO4m4g5+/aOxI54oCOzD9TwBAe+yXcJJWtc2rAhMCjtyPJzxd0ZVXqIzCe1xRvJ6Rq7YCiMbiM2DQFWXKnmYQbj4TGNMnwNdAajCdrcBWEMSbzq7EzuThIJRd8Ky4BkEe1St6tuqwFaMZz+F9eXABEBAAG0KEdub21lIFNESyAzLjE2IDxnbm9tZS1vcy1saXN0QGdub21lLm9yZz6JATgEEwECACIFAlUUCGcCGwMGCwkIBwMCBhUIAgkKCwQWAgMBAh4BAheAAAoJEArkz6VV0VKBa5cH/0vXa31YgEjNk78gGFXqnQxdD1WYA87OYxDi189l4lA802EFTF4wCBuZyDOqdd5BhS3Ab0cR778DmZXRUP2gwe+1zTJypU2JMnDpkwJ4NK1VP6/tE4SAPrznBtmb76BKaWBqUfZ9Wq1zg3ugvqkZB/Exq+usypIOwQVp1KL58TrjBRda0HvRctzkNhr0qYAtkfLFe0GvksBp4vBm8uGwAx7fw/HbhIjQ9pekTwvB+5GwDPO/tSip/1bQfCS+XJB8Ffa04HYPLGedalnWBrwhYY+G/kn5Zh9L/AC8xeLwTJTHM212rBjPa9CWs9C6a57MSaeGIEHLC1hEyiJJ15w8jmY=
DeployCollectionID=org\&.gnome\&.Apps
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBflatpak\fR(1),
\fBflatpak-remote-add\fR(1),
\fBflatpakref\fR(5)