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

名称

git-web—​browse - 启动网页浏览器的 Git 辅助脚本

概要

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

描述

此脚本尽可能尝试在已打开的网页浏览器中以新标签页的形式显示作为参数传递的 URL 和文件(FILEs),作为 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>
--browser=<browser>

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

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

同上。

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

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

配置变量

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

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

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