git-web--browse

Имя

git-web—browse - скрипт-помощник Git для запуска веб-браузера

Синтаксис

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

Описание

Этот скрипт, насколько это возможно, пытается отобразить URL-адреса и файлы, переданные в качестве аргументов, как HTML-страницы в новых вкладках уже открытого веб-браузера.

В настоящее время поддерживаются следующие браузеры (или команды):

firefox (по умолчанию под X Window, если не используется KDE)
iceweasel
seamonkey
iceape
chromium (также поддерживается как chromium-browser)
google-chrome (также поддерживается как chrome)
konqueror (по умолчанию под KDE, см. Note about konqueror ниже)
opera
w3m (по умолчанию вне графических сред)
elinks
links
lynx
dillo
open (по умолчанию под Mac OS X GUI)
start (по умолчанию под MinGW)
cygstart (по умолчанию под Cygwin)
xdg-open

Также могут быть указаны пользовательские команды.

Параметры

-b <browser>
--browser=<browser>: Использовать указанный браузер. Он должен быть в списке поддерживаемых браузеров.
-t <browser>
--tool=<browser>: То же, что и выше.
-c <conf.var>
--config=<conf.var>: Переменная CONF.VAR ищется в файлах конфигурации Git. Если она установлена, то ее значение определяет используемый браузер.

Переменные конфигурации

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 будет рассматривать указанный инструмент как пользовательскую команду и будет использовать shell eval для выполнения команды с переданными в качестве аргументов URL-адресами.

Примечание о 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] для получения дополнительной информации об этом.

© 2005–2026 Linus Torvalds and others
Licensed under the GNU General Public License version 2.
https://git-scm.com/docs/git-web--browse