简体中文 ▾ 主题 ▾ 最新版本 ▾ git-web--browse 上次更新于 2.35.0

名称

git-web—​browse - Git 辅助脚本,用于启动 Web 浏览器

概要

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

描述

此脚本尽可能尝试将作为参数传递的 URL 和 FILE 显示为 HTML 页面,并在已打开的 Web 浏览器的新选项卡中显示。

当前支持以下浏览器(或命令):

  • 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 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 配置变量(如果前者未使用)来指定 Web 浏览器。

browser.<tool>.path

你可以通过设置配置变量 browser.<tool>.path 显式提供首选浏览器的完整路径。例如,你可以通过设置 *browser.firefox.path* 来配置 firefox 的绝对路径。否则,git web--browse 假定该工具在 PATH 中可用。

browser.<tool>.cmd

当通过选项或配置变量指定的浏览器不在受支持的浏览器之列时,将查找相应的 browser.<tool>.cmd 配置变量。如果此变量存在,则 git web--browse 将把指定的工具视为自定义命令,并将使用 shell eval 来运行该命令,并将 URL 作为参数传递。

关于 KONQUEROR 的说明

当通过命令行选项或配置变量指定 konqueror 时,我们启动 kfmclient,以尝试在已打开的 konqueror 的新选项卡中打开 HTML 手册页(如果可能)。

为了保持一致性,如果 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] 套件的一部分

scroll-to-top