Ⅰ. 插件描述
A command-line tool that makes git easier to use with GitHub.Ⅱ. 基本信息
|
Ⅲ. 安装方法
使用Vundle管理器安装
在你的.vimrc下添加:Plugin 'github/hub':source %
:PluginInstall对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。
使用NeoBundle管理器安装
在你的.vimrc下添加:NeoBundle 'github/hub':source %
:NeoBundleInstall使用VimPlug管理器安装
在你的.vimrc下添加:Plug 'github/hub':source %
:PlugInstall使用Pathogen管理器安装
在终端中运行以下命令:cd ~/.vim/bundle
git clone https://github.com/github/hubⅣ. 文档说明
hub is a command line tool that wraps git in order to extend it with extra
features and commands that make working with GitHub easier.
This repository and its issue tracker is **not for reporting problems with
GitHub.com** web interface. If you have a problem with GitHub itself, please
contact Support.
Usage
$ hub clone rtomayko/tilt
#=> git clone git://github.com/rtomayko/tilt.git
# if you prefer HTTPS to git/SSH protocols:
$ git config --global hub.protocol https
$ hub clone rtomayko/tilt
#=> git clone https://github.com/rtomayko/tilt.gitSee usage examples or the [full reference
documentation](https://hub.github.com/hub.1.html) to see all available commands
and flags.
hub can also be used to make shell scripts that [directly interact with the
GitHub API](https://hub.github.com/#scripting).
hub can be safely aliased as git, so you can type `$ git
<command> in the shell and have it expanded with hub` features.
Installation
The hub executable has no dependencies, but since it was designed to wrapgit, it's recommended to have at least git 1.7.3 or newer.
| platform | manager | command to run |
|---|---|---|
| macOS, Linux | Homebrew | brew install hub |
| Windows | Scoop | scoop install hub |
| Windows | Chocolatey | choco install hub |
| Fedora Linux | DNF | sudo dnf install hub |
| Arch Linux | pacman | sudo pacman -S hub |
| FreeBSD | pkg(8) | pkg install hub |
| Debian | apt(8) | sudo apt install hub |
| Ubuntu | Snap | snap install hub --classic |
Packages other than Homebrew are community-maintained (thank you!) and they
are not guaranteed to match the latest hub release. Check `hub
version` after installing a community package.
Standalone
hub can be easily installed as an executable. Download the [latest
binary][latest] for your system and put it anywhere in your executable path.
GitHub Actions
hub can be used for automation through [GitHub Actions][] workflows:
steps:
- uses: actions/checkout@v2
- name: hub example
shell: bash
run: |
curl -fsSL https://github.com/github/hub/raw/master/script/get | bash -s 2.14.1
bin/hub pr list # list pull requests in the current repo
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}Note that the default GITHUB_TOKEN will only work for API operations within _the
same repo that runs this workflow_. If you need to access or write to other
repositories, generate a Personal Access Token with repo scope and add
it to your [repository secrets][].
Source
Prerequisites for building from source are:
make- Go 1.11+
Clone this repository and run make install:
git clone \
--config transfer.fsckobjects=false \
--config receive.fsckobjects=false \
--config fetch.fsckobjects=false \
https://github.com/github/hub.git
cd hub
make install prefix=/usr/localAliasing
Some hub features feel best when it's aliased as git. This is not dangerous; your
_normal git commands will all work_. hub merely adds some sugar.
hub alias displays instructions for the current shell. With the -s flag, it
outputs a script suitable for eval.
You should place this command in your .bash_profile or other startup script:
eval "$(hub alias -s)"PowerShell
If you're using PowerShell, you can set an alias for hub by placing the
following in your PowerShell profile (usually~/Documents/WindowsPowerShell/Microsoft.PowerShell_profile.ps1):
Set-Alias git hubA simple way to do this is to run the following from the PowerShell prompt:
Add-Content $PROFILE "`nSet-Alias git hub"Note: You'll need to restart your PowerShell console in order for the changes to be picked up.
If your PowerShell profile doesn't exist, you can create it by running the following:
New-Item -Type file -Force $PROFILEShell tab-completion
hub repository contains tab-completion scripts for bash, zsh and fish.
These scripts complement existing completion scripts that ship with git.