.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "portals.conf" "5" "" "" "File Formats Manual"
.SH "نام (NAME)"
portals.conf \- پیکربندی پورتال میزکار XDG
.SH "خلاصه (SYNOPSIS)"
.sp
\fI$XDG_CONFIG_HOME/xdg\-desktop\-portal/{*\-}portals.conf\fP
.sp
\fI$XDG_CONFIG_DIRS/xdg\-desktop\-portal/{*\-}portals.conf\fP
.sp
\fI/etc/xdg\-desktop\-portal/{*\-}portals.conf\fP
.sp
\fI$XDG_DATA_HOME/xdg\-desktop\-portal/{*\-}portals.conf\fP
.sp
\fI$XDG_DATA_DIRS/xdg\-desktop\-portal/{*\-}portals.conf\fP
.sp
\fI/usr/share/xdg\-desktop\-portal/{*\-}portals.conf\fP
.SH "توضیحات (DESCRIPTION)"
.sp
برنامهٔ xdg\-desktop\-portal از یک فایل پیکربندی برای تعیین این‌که کدام بک‌اند پورتال باید برای ارائهٔ پیاده‌سازی رابط درخواستی استفاده شود، بهره می‌برد.
این سازوکار بسیار شبیه به مشخصات freedesktop.org برای
\(dqارتباط میان انواع MIME و برنامه‌ها\(dq (mime\-apps)
است.
.sp
محیط‌های میزکار و توزیع‌کنندگان سیستم‌عامل باید پیکربندی پیش‌فرضی را برای بک‌اندهای پورتال انتخابی خود در
\fB/usr/share/xdg\-desktop\-portal/DESKTOP\-portals.conf\fP
ارائه دهند، که در آن \fBDESKTOP\fP نام محیط میزکار همان‌گونه است که در متغیر محیطی \fBXDG_CURRENT_DESKTOP\fP پس از تبدیل حروف بزرگ ASCII به حروف کوچک ظاهر می‌شود.
برای نمونه، KDE باید فایل \fB/usr/share/xdg\-desktop\-portal/kde\-portals.conf\fP را ارائه دهد.
.sp
کاربران می‌توانند با نوشتن یک فایل
\fB~/.config/xdg\-desktop\-portal/portals.conf\fP
این پیش‌فرض‌ها را بازنویسی (override) کنند، یا برای یک محیط میزکار که در حالت عادی پشتیبانی نمی‌شود، پیکربندی فراهم نمایند. کاربران بیش از یک محیط میزکار می‌توانند از نام‌های فایل مختص به میزکار مانند
\fBkde\-portals.conf\fP
استفاده کنند که تنها در محیط میزکار مربوطه استفاده خواهد شد.
.sp
به همین ترتیب، مدیران سیستم می‌توانند یک پیکربندی پیش‌فرض برای تمام کاربران در
\fB/etc/xdg\-desktop\-portal/DESKTOP\-portals.conf\fP
یا
\fB/etc/xdg\-desktop\-portal/portals.conf\fP
فراهم کنند.
.sp
مکان‌های زیر برای یافتن پیکربندی جستجو می‌شوند (بیشترین اولویت در ابتدا):
.INDENT 0.0
.IP \(bu 2
\fB$XDG_CONFIG_HOME\fP، با پیش‌فرض \fB~/.config\fP
.IP \(bu 2
هر شاخه در \fB$XDG_CONFIG_DIRS\fP، با پیش‌فرض \fB/etc/xdg\fP
.IP \(bu 2
مسیر \fBsysconfdir\fP در زمان ساخت برای xdg\-desktop\-portal، معمولاً \fB/etc\fP
.IP \(bu 2
\fB$XDG_DATA_HOME\fP، با پیش‌فرض \fB~/.local/share\fP
(تنها جهت سازگاری با سایر مشخصات جستجو می‌شود؛ نوشتن پیکربندی در اینجا توصیه نمی‌شود)
.IP \(bu 2
هر شاخه در \fB$XDG_DATA_DIRS\fP، با پیش‌فرض \fB/usr/local/share:/usr/share\fP
.IP \(bu 2
مسیر \fBdatadir\fP در زمان ساخت برای xdg\-desktop\-portal، معمولاً \fB/usr/share\fP
.UNINDENT
.sp
در هر یک از این مکان‌ها، برای هر نام محیط میزکار فهرست‌شده در متغیر محیطی \fBXDG_CURRENT_DESKTOP\fP، برنامهٔ xdg\-desktop\-portal وجود فایل \fBxdg\-desktop\-portal/DESKTOP\-portals.conf\fP را بررسی می‌کند که در آن \fBDESKTOP\fP نام محیط میزکار با حروف کوچک است. اگر فایل پیکربندی مختص به محیط میزکار یافت نشود، فایل غیرمختص به میزکار \fBxdg\-desktop\-portal/portals.conf\fP خوانده خواهد شد.
برای نمونه، اگر \fBXDG_CURRENT_DESKTOP\fP روی \fBBudgie:GNOME\fP تنظیم شده باشد، برنامهٔ xdg\-desktop\-portal به دنبال
\fBxdg\-desktop\-portal/budgie\-portals.conf\fP،
\fBxdg\-desktop\-portal/gnome\-portals.conf\fP
و
\fBxdg\-desktop\-portal/portals.conf\fP
به همان ترتیب خواهد گشت.
.SS "قالب فایل (FILE FORMAT)"
.sp
قالب فایل پیکربندی پورتال‌ها همان قالب \fB\&.ini\fP است که توسط فایل‌های واحد systemd یا فایل‌های desktop برنامه‌ها استفاده می‌شود.
.sp
\fB[preferred]\fP
.INDENT 0.0
.INDENT 3.5
گروه اصلی پیکربندی برای پورتال‌های ترجیحی.
.UNINDENT
.UNINDENT
.sp
کلیدهای زیر می‌توانند در گروه \fBpreferred\fP وجود داشته باشند:
.sp
\fBdefault\fP \fI(رشته)\fP
.INDENT 0.0
.INDENT 3.5
بک‌اند پورتال پیش‌فرض برای استفاده در تمامی رابط‌ها، مگر اینکه رابط به صراحت ذکر شده باشد.
.UNINDENT
.UNINDENT
.sp
\fBorg.freedesktop.impl.portal.*\fP \fI(رشته)\fP
.INDENT 0.0
.INDENT 3.5
یکی از پیاده‌سازی‌های معتبر واسط پورتال ارائه‌شده توسط xdg\-desktop\-portal.
.UNINDENT
.UNINDENT
.sp
هر کلید در این گروه شامل فهرستی جداشده با نقطه ویرگول از پیاده‌سازی‌های بک‌اند پورتال است تا برای پیاده‌سازی واسط درخواستی، به همان ترتیبی که در فایل پیکربندی مشخص شده است، جستجو شود. علاوه بر این، مقادیر ویژهٔ \fBnone\fP و \fB*\fP را می‌توان استفاده کرد:
.sp
\fBnone\fP
.INDENT 0.0
.INDENT 3.5
هیچ پیاده‌سازی پورتالی برای این واسط ارائه نشود.
.UNINDENT
.UNINDENT
.sp
\fB*\fP
.INDENT 0.0
.INDENT 3.5
از اولین پیاده‌سازی پورتال یافت‌شده به ترتیب الفبایی (lexicographical) استفاده شود.
.UNINDENT
.UNINDENT
.SS "مثال (EXAMPLE)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[preferred]
# Use xdg\-desktop\-portal\-gtk for every portal interface...
default=gtk
# ... except for the ScreenCast interface
org.freedesktop.impl.portal.ScreenCast=gnome
.EE
.UNINDENT
.UNINDENT
.SS "محیط (ENVIRONMENT)"
.sp
\fBXDG_CURRENT_DESKTOP\fP
.INDENT 0.0
.INDENT 3.5
فهرستی جداشده با دونقطه از محیط‌های میزکار، اولویت با موارد خاص‌تر در ابتدا، که برای انتخاب پیکربندی پورتال مختص به میزکار استفاده می‌شود.
مقدار پیش‌فرض یک فهرست خالی است.
.UNINDENT
.UNINDENT
.sp
\fBXDG_CONFIG_HOME\fP
.INDENT 0.0
.INDENT 3.5
فایل \fBportals.conf\fP مربوط به هر کاربر در این شاخه قرار دارد. مقدار پیش‌فرض \fB$HOME/.config\fP است.
.UNINDENT
.UNINDENT
.sp
\fBXDG_CONFIG_DIRS\fP
.INDENT 0.0
.INDENT 3.5
فهرستی جداشده با دونقطه از شاخه‌های پیکربندی سیستمی و شاخه‌های پیکربندی ثانویهٔ کاربری. مقدار پیش‌فرض \fB/etc/xdg\fP است.
.UNINDENT
.UNINDENT
.sp
\fBXDG_DATA_HOME\fP
.INDENT 0.0
.INDENT 3.5
شاخهٔ داده‌های کاربری که جهت سازگاری با سایر مشخصات جستجو می‌شود. مقدار پیش‌فرض \fB$HOME/.local/share\fP است.
.UNINDENT
.UNINDENT
.sp
\fBXDG_DATA_DIRS\fP
.INDENT 0.0
.INDENT 3.5
فهرستی جداشده با دونقطه از شاخه‌های دادهٔ سیستمی و شاخه‌های دادهٔ ثانویهٔ کاربری. مقدار پیش‌فرض \fB/usr/local/share:/usr/share\fP است.
.UNINDENT
.UNINDENT
.SS "همچنین ببینید (SEE ALSO)"
.INDENT 0.0
.IP \(bu 2
مشخصات شاخهٔ پایهٔ XDG (XDG Base Directory Specification) \%<https://\:specifications\:.freedesktop\:.org/\:basedir-spec/\:basedir-spec-latest\:.html>
.IP \(bu 2
مشخصات مدخل میزکار XDG (XDG Desktop Entry specification) \%<https://\:specifications\:.freedesktop\:.org/\:desktop-entry-spec/\:desktop-entry-spec-latest\:.html>
.IP \(bu 2
مشخصات ارتباط میان انواع MIME و برنامه‌های XDG (XDG Association between MIME type and applications specification) \%<https://\:specifications\:.freedesktop\:.org/\:mime-apps-spec/\:mime-apps-spec-latest\:.html>
.UNINDENT
.\" End of generated man page.