在OSX上安装Git HTML帮助

Question

我已经尝试根据以下链接提供的说明在OSX上安装Git HTML帮助页面:

• http://help.github.com/install-git-html-help/
• http://www.railsatwork.com/2010/12/installing-git-html-documentation-on.html

但是当我进入涉及运行的最终验证步骤时:

git help --web commit

我收到以下错误:

fatal: '/usr/local/git/share/doc/git-doc': not a documentation directory

我已经验证了文件夹/ usr/local/git/share/doc/git-doc实际上是在我运行"git clone"时创建的,并且它充满了看起来像git文档文件的文件.

有人能让我知道我错过了什么吗？谢谢!

以下是在git-doc文件夹中创建的一些文件的简短列表:

• exec_cmd.c
• exec_cmd.h
• 快速import.c
• 取-pack.h
• 修正,内建
• FMT合并,msg.h
• fsck.c
• fsck.h
• generate-cmdlist.sh
• gettext.c
• gettext.h
• 混帐相加 - interactive.perl
• git-am.sh
• 混帐archimport.perl
• git-bisect.sh
• GIT-COMPAT-util.h
• 混帐cvsexportcommit.perl
• 混帐cvsimport.perl
• 混帐cvsserver.perl
• git-difftool--helper.sh
• 混帐difftool.perl
• git-filter-branch.sh

编辑:只是查看了git clone结果并发现了这个警告,不确定它是否有所不同:"在上游原点找不到远程分支html,而是使用HEAD"

Answer 1

从中更改克隆命令地址

$ sudo git clone git://git.kernel.org/pub/scm/git/git.git git-doc --branch html

至

$ sudo git clone git://git.kernel.org/pub/scm/git/git-htmldocs.git git-doc

希望很快就会在Github教程中进行更改.

更新:

如果您认为自己拥有Xcode 4提供的Apple Git发行版,那么您就是其中之一:

# create directory to keep Git documentation html-files
$ sudo mkdir -p /usr/local/git/share/doc # or whatever directory you choose

# change to that directory
$ cd /usr/local/git/share/doc

# clone repo with documentation 
$ sudo git clone git://git.kernel.org/pub/scm/git/git-htmldocs.git git-doc 

# point your Git explicitly to a new documentation directory
$ git config --global help.htmlpath /usr/local/git/share/doc/git-doc

# tell Git to use html-formatted help by default
$ git config --global help.format html

这将在.gitconfig中创建一个条目,如:

[help]
    format = html
    htmlpath = /usr/local/git/share/doc/git-doc