نام (NAME)

git-web--browse - اسکریپت کمکی گیت برای راه‌اندازی یک مرورگر وب

خلاصه دستور (SYNOPSIS)

git web--browse [<options>] (<URL>|<file>)...

توضیحات (DESCRIPTION)

این اسکریپت تا حد امکان تلاش می‌کند نشانی‌های اینترنتی (URLs) و فایل‌هایی که به عنوان آرگومان ارسال شده‌اند را به صورت صفحات HTML در زبانه‌های جدیدی از یک مرورگر وبِ از قبل بازشده نمایش دهد.

مرورگرها (یا دستورات) زیر در حال حاضر پشتیبانی می‌شوند:

•firefox (این گزینه پیش‌فرض در X Window هنگام عدم استفاده از KDE است)

•iceweasel

•seamonkey

•iceape

•chromium (همچنین به عنوان chromium-browser پشتیبانی می‌شود)

•google-chrome (همچنین به عنوان chrome پشتیبانی می‌شود)

•konqueror (این گزینه پیش‌فرض در KDE است؛ به نکته‌ای درباره konqueror در زیر مراجعه کنید)

•opera

•w3m (این گزینه پیش‌فرض خارج از محیط‌های گرافیکی است)

•elinks

•links

•lynx

•dillo

•open (این گزینه پیش‌فرض در واسط گرافیکی Mac OS X است)

•start (این گزینه پیش‌فرض در MinGW است)

•cygstart (این گزینه پیش‌فرض در Cygwin است)

•xdg-open

دستورات سفارشی نیز ممکن است مشخص شوند.

گزینه‌ها (OPTIONS)

-b <browser>, --browser=<browser>

استفاده از مرورگر مشخص‌شده. این مرورگر باید در فهرست مرورگرهای پشتیبانی‌شده قرار داشته باشد.

-t <browser>, --tool=<browser>

مشابه مورد بالا.

-c <conf.var>, --config=<conf.var>

متغیر CONF.VAR در فایل‌های پیکربندی گیت جستجو می‌شود. اگر مقداردهی شده باشد، مقدار آن مرورگری را که باید استفاده شود مشخص می‌کند.

متغیرهای پیکربندی (CONFIGURATION VARIABLES)

CONF.VAR (از گزینه -c) و web.browser

مرورگر وب را می‌توان با استفاده از یک متغیر پیکربندی که همراه با گزینه خط فرمان -c (یا --config) ارسال شده، یا متغیر پیکربندی web.browser در صورت عدم استفاده از گزینه اول تعیین کرد.

browser.<tool>.path

می‌توانید با تنظیم متغیر پیکربندی browser.<tool>.path صریحاً مسیر کاملی برای مرورگر ترجیحی خود مشخص کنید. برای مثال، می‌توانید مسیر مطلق firefox را با مقداردهی browser.firefox.path پیکربندی نمایید. در غیر این صورت، git web--browse فرض می‌کند که این ابزار در PATH در دسترس است.

browser.<tool>.cmd

هنگامی که مرورگرِ مشخص‌شده توسط گزینه‌ها یا متغیرهای پیکربندی در میان مرورگرهای پشتیبانی‌شده نباشد، متغیر پیکربندی متناظر browser.<tool>.cmd جستجو می‌شود. در صورت وجود این متغیر، git web--browse با ابزار مشخص‌شده مانند یک دستور سفارشی رفتار کرده و از دستور eval شل برای اجرای دستور به همراه نشانی‌های وب ارسالی به عنوان آرگومان استفاده می‌کند.

نکته‌ای درباره KONQUEROR (NOTE ABOUT KONQUEROR)

هنگامی که konqueror توسط یک گزینه خط فرمان یا یک متغیر پیکربندی مشخص می‌شود، ما kfmclient را اجرا می‌کنیم تا در صورت امکان تلاش کند صفحه راهنمای HTML را در یک زبانه جدید در یک konqueror که قبلاً باز شده است نمایش دهد.

جهت حفظ یکپارچگی، اگر browser.konqueror.path روی چیزی مانند A_PATH_TO/konqueror تنظیم شده باشد نیز همین ترفند را امتحان می‌کنیم. بدین معنا که در عوض تلاش خواهیم کرد A_PATH_TO/kfmclient را اجرا کنیم.

اگر واقعاً تمایل دارید از konqueror استفاده کنید، می‌توانید از تنظیمی شبیه به ساختار زیر استفاده نمایید:

[web]
        browser = konq
[browser "konq"]
        cmd = A_PATH_TO/konqueror

نکته‌ای درباره git-config --global

توجه داشته باشید که این متغیرهای پیکربندی احتمالاً باید با استفاده از فلگ --global تنظیم شوند، به عنوان مثال مانند زیر:

$ git config --global web.browser firefox

زیرا آن‌ها بیشتر وابسته به کاربر هستند تا مختص مخزن. برای اطلاعات بیشتر در این خصوص به git-config(1) مراجعه کنید.

گیت (GIT)

بخشی از مجموعه git(1)