'\" t
.\"     Title: xdg-open
.\"    Author: Kevin Krammer
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 12/06/2025
.\"    Manual: xdg-open Manual
.\"    Source: xdg-utils 1.0
.\"  Language: Persian
.\"
.TH "XDG\-OPEN" "1" "12/06/2025" "xdg-utils 1.0" "xdg-open Manual"
.\" -----------------------------------------------------------------
.\" * 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)"
xdg\-open \- باز کردن یک فایل یا نشانی اینترنتی در برنامه برگزیده کاربر
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBxdg\-open\fR\ 'u
\fBxdg\-open\fR {\fB\fIfile\fR\fR | \fB\fIURL\fR\fR}
.HP \w'\fBxdg\-open\fR\ 'u
\fBxdg\-open\fR {\fB\-\-help\fR | \fB\-\-manual\fR | \fB\-\-version\fR}
.SH "توضیحات (DESCRIPTION)"
.PP
دستور \fBxdg\-open\fR یک فایل یا نشانی اینترنتی (URL) را در برنامه برگزیده کاربر باز می‌کند\&. اگر یک نشانی اینترنتی ارائه شود، در مرورگر وب برگزیده کاربر باز خواهد شد\&. اگر یک فایل ارائه شود، در برنامه برگزیده برای فایل‌های آن نوع باز می‌شود\&. دستور \fBxdg\-open\fR از نشانی‌های اینترنتی file، ftp، http و https پشتیبانی می‌کند\&.
.PP
دستور \fBxdg\-open\fR تنها برای استفاده درون یک نشست رومیزی است\&. استفاده از \fBxdg\-open\fR به‌عنوان کاربر ارشد (root) توصیه نمی‌شود\&.
.PP
از آنجا که \fBxdg\-open\fR نمی‌تواند آرگومان‌هایی را که با
\(lq\-\(rq
آغاز می‌شوند مدیریت کند، توصیه می‌شود مسیرهای فایل به یکی از روش‌های زیر ارائه شوند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ارائه مسیرهای مطلق؛ یعنی با استفاده از
\fBrealpath\fR
به‌عنوان پیش‌پردازنده\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
افزودن پیشوند
\(lq\&./\(rq
به مسیرهای نسبی شناخته‌شده فایل\&. برای نمونه با استفاده از
sed \-E \*(Aqs|^[^/]|\&./\e0|\*(Aq\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ارائه یک نشانی اینترنتی پرونده (file URL)\&.
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-\-help\fR
.RS 4
نمایش خلاصه دستور\&.
.RE
.PP
\fB\-\-manual\fR
.RS 4
نمایش این صفحه راهنما\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
نمایش اطلاعات نسخه xdg\-utils\&.
.RE
.SH "کدهای خروج (EXIT CODES)"
.PP
کد خروج 0 نشان‌دهنده موفقیت است، در حالی که کد خروج غیرصفر نشانگر شکست است\&. کدهای خطای زیر ممکن است بازگردانده شوند:
.PP
\fB1\fR
.RS 4
خطا در نحو (سینتکس) خط فرمان\&.
.RE
.PP
\fB2\fR
.RS 4
یکی از فایل‌های ارائه‌شده در خط فرمان وجود نداشت\&.
.RE
.PP
\fB3\fR
.RS 4
ابزار لازم پیدا نشد\&.
.RE
.PP
\fB4\fR
.RS 4
عملیات شکست خورد\&.
.RE
.PP
در صورت موفقیت، فرایند راه‌اندازی‌شده از فایل \&.desktop منشعب (fork) نخواهد شد و بنابراین ممکن است منجر به اجرای طولانی‌مدت \fBxdg\-open\fR شود\&. این رفتار عمداً با بیشتر بازکننده‌های مخصوص میزکار تفاوت دارد تا به برنامه‌های مبتنی بر خط فرمان اجازه دهد در همان ترمینالی اجرا شوند که \fBxdg\-open\fR از آن فراخوانی شده بود\&.
.SH "گزارش مشکلات (REPORTING ISSUES)"
.PP
لطفاً به یاد داشته باشید که
\fBxdg\-open\fR
بیشتر کاستی‌های پیکربندی خود و بازکنندهٔ زیربنایی را به ارث می‌برد\&.
.PP
در صورتی که دستور
xdg\-mime query default "$(xdg\-mime query filetype path/to/troublesome_file)"
نام برنامه‌ای را که مسئول رفتار غیرمنتظره است نشان دهد، می‌توانید با تنظیم یک گرداننده (handler) دیگر آن را برطرف کنید\&. (اگر برنامه ایراد دارد به توسعه‌دهندگان آن اطلاع دهید)
.PP
همچنین نکته امنیتی را در
\fBxdg-mime\fR(1)
برای زیردستور
default
ببینید\&.
.PP
اگر یک ایراد با استفاده از بازکنندهٔ مخصوص محیط رومیزی قابل بازتولید باشد (و مشکل پیکربندی نباشد): لطفاً ابتدا آن را به مسئول مربوط به همان بخش گزارش دهید (گزارش به xdg\-utils بهتر از گزارش ندادن است، اما از آنجا که xdg\-utils در زمان آزاد بسیار اندکی نگهداری می‌شوند، رفع مشکل بسیار بیشتر طول خواهد کشید)\&.
.PP
در صورتی که مشکل منحصراً مربوط به xdg\-open باشد، لطفاً آن را گزارش کنید به:
https://gitlab\&.freedesktop\&.org/xdg/xdg\-utils/\-/issues
\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBxdg-mime\fR(1),
\fBxdg-settings\fR(1),
\m[blue]\fBMIME applications associations specification\fR\m[]\&\s-2\u[1]\d\s+2
.SH "مثال‌ها (EXAMPLES)"
.PP
.if n \{\
.RS 4
.\}
.nf
xdg\-open \*(Aqhttp://www\&.freedesktop\&.org\*(Aq
.fi
.if n \{\
.RE
.\}
.sp
وب‌سایت freedesktop\&.org را در مرورگر وب پیش‌فرض کاربر باز می‌کند\&.
.PP
.if n \{\
.RS 4
.\}
.nf
xdg\-open /tmp/foobar\&.png
.fi
.if n \{\
.RE
.\}
.sp
فایل تصویری PNG به‌مسیر /tmp/foobar\&.png را در برنامه پیش‌فرض مشاهده تصویر کاربر باز می‌کند\&.
.SH "نویسندگان (AUTHORS)"
.PP
\fBKevin Krammer\fR
.RS 4
نویسنده\&.
.RE
.PP
\fBJeremy White\fR
.RS 4
نویسنده\&.
.RE
.SH "حق نشر (COPYRIGHT)"
.br
حق نشر \(co 2006
.br
.SH "نکات (NOTES)"
.IP " 1." 4
MIME applications associations specification
.RS 4
\%http://www.freedesktop.org/wiki/Specifications/mime-apps-spec
.RE