hub

「 git + hub = github, 让git与github更容易合作 」

中文 | english

---

校对 ✅

翻译的原文	与日期	最新更新	更多
commit	⏰ 2018 9.6		中文翻译

• readme.md
• etc
• src
  • ./src/hub.1.zh.md

贡献

欢迎 👏 勘误/校对/更新贡献 😊 具体贡献请看

生活

If help, buy me coffee —— 营养跟不上了，给我来瓶营养快线吧! 💰

---

目录

• git + hub = github
  • 安装
    • Homebrew
    • Windows
    • Fedora Linux
    • Arch Linux
    • 集成版本
    • 源-安装
  • 别名
    • PowerShell
    • Shell tab-补全
  • 元信息

git + hub = github

hub是一个包装git的命令行工具,为了使用额外的功能和命令扩展,使得使用GitHub变得更容易.

$ hub clone rtomayko/tilt

# 相等于:
$ git clone git://github.com/rtomayko/tilt.git

hub是最好换成git别名,所以你可以在shell中输入$ git <command>和得到所有有用的hub功能.请参阅下面的"别名".

看到使用文档获取所有命令及其参数的列表.

安装

依赖关系:

• git 1.7.3或者以上

Homebrew

hub可以在macOS上通过安装Homebrew:

$ brew install hub
$ hub version
git version 1.7.6
hub version 2.2.3

Windows

hub可以在Windows上通过安装Scoop:

> scoop install hub

Fedora Linux

在Fedora上你可以通过DNF安装hub:

$ sudo dnf install hub
$ hub version
git version 2.9.3
hub version 2.2.9

Arch Linux

在Arch Linux上你可以从官方存储库安装hub:

$ sudo pacman -S hub

集成版本

hub可以轻松安装为可执行文件.下载最新的编译二进制文件,并将它放在可执行路径中的任何位置.

源-安装

在你的GOPATH已经设置后:

$ go get github.com/github/hub
$ cd "$GOPATH"/src/github.com/github/hub
$ make install prefix=/usr/local

编译的先决条件是:

• make
• go1.8+
• 带有Bundler的Ruby 1.9+ - 用于生成man手册页

别名

当换成git别名时,使用hub感觉是最好的.这不危险;你的普通的git命令都可以正常工作.hub只是添加了一些糖.

hub alias显示当前shell的说明.若带上-s标志,它会输出适合的eval脚本.

例如:

$ hub alias -s
alias git=hub

你应该把这个命令放在你的.bash_profile或其他启动脚本:

eval "$(hub alias -s)"

PowerShell

如果您使用的是PowerShell,则可以为hub设置别名,只需要将以下内容放在PowerShell配置文件中(通常~/Documents/WindowsPowerShell/Microsoft.PowerShell_profile.ps1):

Set-Alias git hub

一种简单的方法是从PowerShell提示符运行以下命令:

Add-Content $PROFILE "`nSet-Alias git hub"

注意:您需要重新启动PowerShell控制台才能获取更改.

如果您的PowerShell配置文件不存在,则可以通过运行以下命令来创建它:

New-Item -Type file -Force $PROFILE

Shell tab-补全

hub存储库包含bash,zsh和fish的tab-补全脚本.这些脚本会tab-补全了git附带的补全脚本.

安装说明

• hub - bash
• hub - zsh
• hub - fish

元信息

• 主页:https://github.com/github/hub
• 错误:https://github.com/github/hub/issues
• 作者:https://github.com/github/hub/contributors