FLATPAK REMOTE-ADD(1)         flatpak remote-add         FLATPAK REMOTE-ADD(1)

نام (NAME)
       flatpak-remote-add - افزودن یک مخزن دوردست

خلاصه دستور (SYNOPSIS)
       flatpak remote-add [OPTION...] NAME LOCATION

توضیحات (DESCRIPTION)
       یک مخزن دوردست را به پیکربندی مخازن فلت‌پک اضافه می‌کند.  NAME نام مخزن
       دوردست جدید است و LOCATION یک نشانی اینترنتی (URL) یا مسیر فایل است.
       LOCATION می‌تواند یک مخزن فلت‌پک یا یک فایل .flatpakrepo باشد که مخزن را
       توصیف می‌کند. در حالت اول ممکن است لازم باشد گزینه‌های اضافی مانند کلید
       GPG مخزن را نیز مشخص کنید.

       مگر اینکه با گزینه‌های --user یا --installation بازنویسی شود، این دستور
       پیکربندی پیش‌فرض سراسری سیستم را تغییر می‌دهد.

گزینه‌ها (OPTIONS)
       گزینه‌های زیر پشتیبانی می‌شوند:

       -h, --help
           نمایش گزینه‌های راهنما و خروج.

       --from
           فرض می‌کند که شناسهٔ URI یک فایل .flatpakrepo است نه خود مخزن. اگر
           پسوند فایل .flatpakrepo باشد، این گزینه به‌طور پیش‌فرض فعال است،
           بنابراین عموماً به آن نیازی ندارید.

       -u, --user
           تغییر پیکربندی به ازای کاربر.

       --system
           تغییر پیکربندی پیش‌فرض سراسری سیستم.

       --installation=NAME
           تغییر یک مکان نصب سراسری سیستم مشخص‌شده با NAME از میان موارد
           تعریف‌شده در /etc/flatpak/installations.d/. استفاده از
           --installation=default معادل استفاده از --system است.

       --no-gpg-verify
           غیرفعال‌سازی اعتبارسنجی GPG برای مخزن دوردست افزوده‌شده.

       --prio=PRIO
           تنظیم اولویت برای مخزن دوردست. مقدار پیش‌فرض ۱ است؛ مقدار بالاتر به
           معنی اولویت بیشتر است. این گزینه عمدتاً برای ابزارهای گرافیکی نصب
           استفاده می‌شود. همچنین هنگام جستجوی مخزن دوردست برای تأمین محیط زمان
           اجرای یک برنامه به کار می‌رود. مبدا برنامه پیش از سایر مخازن با
           اولویت یکسان بررسی می‌شود.

       --subset=SUBSET
           محدود کردن ارجاع‌های (refs) در دسترس از مخزن دوردست به آن‌هایی که
           بخشی از زیرمجموعهٔ نام‌برده هستند.

       --no-enumerate
           علامت‌گذاری مخزن دوردست به‌عنوان شمارش‌نشده (not enumerated). این بدان
           معناست که این مخزن دوردست برای فهرست‌کردن برنامه‌ها (مثلاً در ابزارهای
           گرافیکی نصب) استفاده نخواهد شد.

       --no-use-for-deps
           علامت‌گذاری مخزن دوردست برای عدم استفاده در حل خودکار وابستگی‌های
           محیط زمان اجرا.

       --if-not-exists
           اگر مخزن دوردست ارائه‌شده از قبل وجود دارد، هیچ عملیاتی انجام ندهد.

       --disable
           غیرفعال کردن مخزن دوردست افزوده‌شده.

       --title=TITLE
           یک عنوان برای مخزن دوردست، مثلاً برای نمایش در واسط کاربری.

       --comment=COMMENT
           یک توضیح تک‌خطی برای مخزن دوردست، مثلاً برای نمایش در واسط کاربری.

       --description=DESCRIPTION
           یک توضیح کامل در قالب یک پاراگراف برای مخزن دوردست، مثلاً برای نمایش
           در واسط کاربری.

       --homepage=URL
           نشانی اینترنتی (URL) وب‌سایت مخزن دوردست، مثلاً برای نمایش در واسط
           کاربری.

       --icon=URL
           نشانی اینترنتی (URL) آیکون مخزن دوردست، مثلاً برای نمایش در واسط
           کاربری.

       --default-branch=BRANCH
           شاخهٔ پیش‌فرض برای مخزن دوردست، عمدتاً برای استفاده در واسط کاربری.

       --filter=PATH
           افزودن یک فیلتر محلی به مخزن دوردست. یک فایل فیلتر فهرستی از خطوط
           است که هر خط با «allow» یا «deny» شروع می‌شود و سپس یک الگوی
           منطبق‌سازی (glob) برای ارجاعِ مجاز یا غیرمجاز می‌آید. الگوها یک ارجاع
           جزئی را مشخص می‌کنند (یعنی می‌توانید بخش‌های انتهایی را حذف کنید که در
           این صورت با همه چیز مطابقت می‌یابد)، و تنها نویسهٔ «*» دارای عملکرد
           ویژه است که با هر چیزی در آن بخش از ارجاع مطابقت دارد.

           به‌طور پیش‌فرض همهٔ ارجاع‌ها مجاز هستند، اما اگر یک ارجاع با یک قانون
           deny مطابقت داشته باشد ممنوع می‌شود، مگر اینکه به‌طور مشخص با یک
           قانون allow مطابقت یابد. این بدان معناست که می‌توانید از آن برای
           پیاده‌سازی فهرست مجاز (allowlist) و فهرست مسدودشده (blocklist)
           استفاده کنید.

           نمونه‌ای از یک فایل فیلتر در زیر آورده شده است:

               # This is an allowlist style filter as it denies all first
               deny *
               allow runtime/org.freedesktop.*
               allow org.some.app/arm
               allow org.signal.Signal/*/stable
               allow org.signal.Signal.*/*/stable


       --gpg-import=FILE
           وارد کردن کلیدهای GPG از فایل دسته‌کلید (keyring) مشخص‌شده به‌عنوان
           کلیدهای معتمد برای مخزن دوردست جدید. اگر فایل - باشد، دسته‌کلید از
           ورودی استاندارد خوانده می‌شود.

       --signature-lookaside=URL
           مشخص کردن یک نشانی اینترنتی (URL) برای جستجوی امضاها در این مخزن
           دوردست (فقط مخازن OCI).

       --authenticator-name=NAME
           مشخص کردن احرازهویت‌کننده (authenticator) برای استفاده در مخزن
           دوردست.

       --authenticator-option=KEY=VALUE
           مشخص کردن یک گزینه برای احرازهویت‌کننده در مخزن دوردست.

       --authenticator-install
           فعال‌سازی نصب خودکار احرازهویت‌کننده.

       --no-authenticator-install
           غیرفعال‌سازی نصب خودکار احرازهویت‌کننده.

       --no-follow-redirect
           پیروی نکردن از xa.redirect-url تعریف‌شده در فایل خلاصه (summary).

       -v, --verbose
           چاپ اطلاعات اشکال‌زدایی هنگام پردازش دستور.

       --ostree-verbose
           چاپ اطلاعات اشکال‌زدایی OSTree هنگام پردازش دستور.

مثال‌ها (EXAMPLES)
       $ flatpak remote-add gnome https://sdk.gnome.org/gnome.flatpakrepo

       $ flatpak --user remote-add --no-gpg-verify test-repo
       https://people.gnome.org/~alexl/gnome-sdk/repo

همچنین ببینید (SEE ALSO)
       flatpak(1), flatpak-remote-modify(1), flatpak-remote-delete(1),
       flatpak-remotes(1), flatpakrepo(5)

flatpak                                                  FLATPAK REMOTE-ADD(1)