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

名称

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

概要

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

描述

此脚本尽可能尝试将作为参数传递的 URL 和 FILE 显示为新标签页中的 HTML 页面，在一个已打开的 Web 浏览器中。

目前支持以下浏览器（或命令）：

  • 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

Web 浏览器可以通过 -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 man 页（如果可能）。

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