Git
English ▾ 主题 ▾ 最新版本 ▾ git-web--browse 最后更新于 2.35.0

名称

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

概要

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

描述

此脚本尽可能地将作为参数传递的 URL 和文件显示为已打开的 Web 浏览器的新标签页中的 HTML 页面。

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

  • firefox(在不使用 KDE 的 X Window 下,这是默认值)

  • 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=<浏览器>

使用指定的浏览器。它必须在支持的浏览器列表中。

-t <浏览器>
--tool=<浏览器>

与上相同。

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

在 Git 配置文件中查找 CONF.VAR。如果已设置,则其值指定应使用的浏览器。

配置变量

CONF.VAR(来自 -c 选项)和 web.browser

可以使用 -c(或 --config)命令行选项传递的配置变量,或者 web.browser 配置变量来指定 Web 浏览器,如果未使用前者。

browser.<工具>.path

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

browser.<工具>.cmd

当通过选项或配置变量指定的浏览器不在支持的浏览器中时,将查找相应的 browser.<工具>.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