Mercurial

非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

功能

在 Mercurial 仓库中时显示 Mercurial 相关信息。为确保最佳兼容性， 请确保您的 hg 可执行文件保持最新（例如当分支或状态信息显示异常时）。

示例配置

json

{
  "type": "mercurial",
  "style": "powerline",
  "powerline_symbol": "",
  "foreground": "#193549",
  "background": "#ffeb3b",
  "options": {
    "fetch_status": true,
    "native_fallback": false
  }
}

yaml

type: mercurial
style: powerline
powerline_symbol: 
foreground: "#193549"
background: "#ffeb3b"
options:
  fetch_status: true
  native_fallback: false

toml

type = "mercurial"
style = "powerline"
powerline_symbol = ""
foreground = "#193549"
background = "#ffeb3b"

[options]
fetch_status = true
native_fallback = false

选项

信息获取

由于执行 Mercurial (hg) 命令可能降低提示符响应速度，默认不主动获取信息。您可设置 fetch_status 为 true 来启用额外信息获取（并填充模板）。

Name	Type	Default	Description
fetch_status	boolean	false	fetch the local changes
native_fallback	boolean	false	when set to true and hg.exe is not available when inside a WSL2 shared Windows drive, we will fallback to the native hg executable to fetch data. Not all information can be displayed in this case
status_formats	map[string]string		a key, value map allowing to override how individual status items are displayed. For example, "status_formats": { "Added": "Added: %d" } will display the added count as Added: 1 instead of +1. See the Status section for available overrides

模板 (信息)

默认模板

hg {{.Branch}} {{if .LocalCommitNumber}}({{.LocalCommitNumber}}:{{.ChangeSetIDShort}}){{end}}{{range .Bookmarks }} \uf02e {{.}}{{end}}{{range .Tags}} \uf02b {{.}}{{end}}{{if .Working.Changed}} \uf044 {{ .Working.String }}{{ end }}

属性

Name	Type	Description
.Working	Status	changes in the worktree (see below)
.IsTip	boolean	Current commit is the tip commit
.ChangeSetID	string	The current local commit number
.ChangeSetIDShort	string	The current local commit number
.Branch	string	current branch
.Bookmarks	[]string	the currently checked out revision number
.Tags	[]string	the currently checked out revision number

状态标识

Name	Type	Description
.Untracked	int	number of files not under version control
.Modified	int	number of modified files
.Deleted	int	number of deleted files
.Added	int	number of added files
.Changed	boolean	if the status contains changes or not
.String	string	a string representation of the changes above

本地变更使用以下语法表示：

Icon	Description
?	Untracked
~	Modified
-	Deleted
+	Added