'\" t
.\"     Title: git-web--browse
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2026-06-29
.\"    Manual: Git Manual
.\"    Source: Git 2.55.0
.\"  Language: English
.\"
.TH "GIT\-WEB\-\-BROWSE" "1" "2026\-06\-29" "Git 2\&.55\&.0" "Git 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)"
git-web--browse \- اسکریپت کمکی گیت برای راه‌اندازی یک مرورگر وب
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIgit web\-\-browse\fR [<options>] (<URL>|<file>)\&...
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
این اسکریپت تا حد امکان تلاش می‌کند نشانی‌های اینترنتی (URLs) و فایل‌هایی که به عنوان آرگومان ارسال شده‌اند را به صورت صفحات HTML در زبانه‌های جدیدی از یک مرورگر وبِ از قبل بازشده نمایش دهد.
.sp
مرورگرها (یا دستورات) زیر در حال حاضر پشتیبانی می‌شوند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
firefox (این گزینه پیش‌فرض در X Window هنگام عدم استفاده از KDE است)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
iceweasel
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
seamonkey
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
iceape
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
chromium (همچنین به عنوان chromium\-browser پشتیبانی می‌شود)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
google\-chrome (همچنین به عنوان chrome پشتیبانی می‌شود)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
konqueror (این گزینه پیش‌فرض در KDE است؛ به
\fIنکته‌ای درباره konqueror\fR
در زیر مراجعه کنید)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
opera
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
w3m (این گزینه پیش‌فرض خارج از محیط‌های گرافیکی است)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
elinks
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
links
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
lynx
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
dillo
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
open (این گزینه پیش‌فرض در واسط گرافیکی Mac OS X است)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
start (این گزینه پیش‌فرض در MinGW است)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
cygstart (این گزینه پیش‌فرض در Cygwin است)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
xdg\-open
.RE
.sp
دستورات سفارشی نیز ممکن است مشخص شوند.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-b <browser>, \-\-browser=<browser>
.RS 4
استفاده از مرورگر مشخص‌شده. این مرورگر باید در فهرست مرورگرهای پشتیبانی‌شده قرار داشته باشد.
.RE
.PP
\-t <browser>, \-\-tool=<browser>
.RS 4
مشابه مورد بالا.
.RE
.PP
\-c <conf\&.var>, \-\-config=<conf\&.var>
.RS 4
متغیر CONF\&.VAR در فایل‌های پیکربندی گیت جستجو می‌شود. اگر مقداردهی شده باشد، مقدار آن مرورگری را که باید استفاده شود مشخص می‌کند.
.RE
.SH "متغیرهای پیکربندی (CONFIGURATION VARIABLES)"
.SS "CONF\&.VAR (از گزینه \-c) و web\&.browser"
.sp
مرورگر وب را می‌توان با استفاده از یک متغیر پیکربندی که همراه با گزینه خط فرمان \-c (یا \-\-config) ارسال شده، یا متغیر پیکربندی \fBweb\&.browser\fR در صورت عدم استفاده از گزینه اول تعیین کرد.
.SS "browser\&.<tool>\&.path"
.sp
می‌توانید با تنظیم متغیر پیکربندی \fBbrowser\&.\fR\fI<tool>\fR\fB\&.path\fR صریحاً مسیر کاملی برای مرورگر ترجیحی خود مشخص کنید. برای مثال، می‌توانید مسیر مطلق firefox را با مقداردهی \fIbrowser\&.firefox\&.path\fR پیکربندی نمایید. در غیر این صورت، \fIgit web\-\-browse\fR فرض می‌کند که این ابزار در PATH در دسترس است.
.SS "browser\&.<tool>\&.cmd"
.sp
هنگامی که مرورگرِ مشخص‌شده توسط گزینه‌ها یا متغیرهای پیکربندی در میان مرورگرهای پشتیبانی‌شده نباشد، متغیر پیکربندی متناظر \fBbrowser\&.\fR\fI<tool>\fR\fB\&.cmd\fR جستجو می‌شود. در صورت وجود این متغیر، \fIgit web\-\-browse\fR با ابزار مشخص‌شده مانند یک دستور سفارشی رفتار کرده و از دستور eval شل برای اجرای دستور به همراه نشانی‌های وب ارسالی به عنوان آرگومان استفاده می‌کند.
.SH "نکته‌ای درباره KONQUEROR (NOTE ABOUT KONQUEROR)"
.sp
هنگامی که \fIkonqueror\fR توسط یک گزینه خط فرمان یا یک متغیر پیکربندی مشخص می‌شود، ما \fIkfmclient\fR را اجرا می‌کنیم تا در صورت امکان تلاش کند صفحه راهنمای HTML را در یک زبانه جدید در یک konqueror که قبلاً باز شده است نمایش دهد.
.sp
جهت حفظ یکپارچگی، اگر \fIbrowser\&.konqueror\&.path\fR روی چیزی مانند \fBA_PATH_TO/konqueror\fR تنظیم شده باشد نیز همین ترفند را امتحان می‌کنیم. بدین معنا که در عوض تلاش خواهیم کرد \fBA_PATH_TO/kfmclient\fR را اجرا کنیم.
.sp
اگر واقعاً تمایل دارید از \fIkonqueror\fR استفاده کنید، می‌توانید از تنظیمی شبیه به ساختار زیر استفاده نمایید:
.sp
.if n \{\
.RS 4
.\}
.nf
        [web]
                browser = konq

        [browser "konq"]
                cmd = A_PATH_TO/konqueror
.fi
.if n \{\
.RE
.\}
.sp
.SS "نکته‌ای درباره git\-config \-\-global"
.sp
توجه داشته باشید که این متغیرهای پیکربندی احتمالاً باید با استفاده از فلگ \fB\-\-global\fR تنظیم شوند، به عنوان مثال مانند زیر:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git config \-\-global web\&.browser firefox
.fi
.if n \{\
.RE
.\}
.sp
.sp
زیرا آن‌ها بیشتر وابسته به کاربر هستند تا مختص مخزن. برای اطلاعات بیشتر در این خصوص به \fBgit-config\fR(1) مراجعه کنید.
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)