Cài đặt Git HTML Help trên OSX

Question

Tôi đã cố gắng để cài đặt các trang trợ giúp Git HTML trên OSX theo các hướng dẫn được cung cấp bởi các liên kết sau đây:

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

Nhưng khi tôi đến bước xác minh cuối cùng liên quan đến việc chạy:

git help --web commit 

tôi nhận được lỗi sau:

tôi đã xác minh rằng thư mục,/usr/local/git/share/doc/git-doc được trong thực tế tạo ra khi tôi chạy "git clone", và rằng nó có đầy đủ các tệp xuất hiện dưới dạng tệp tài liệu git.

Ai đó có thể cho tôi biết tôi đang thiếu gì không? Cảm ơn!

Dưới đây là một danh sách ngắn của một số các tập tin đã được tạo ra trong thư mục git-doc:

• exec_cmd.c
• exec_cmd.h
• nhanh import.c
• lấy-pack.h
• fixup-builtins
• fmt-merge-msg.h
• fsck.c
• fsck.h
• generate-cmdlist.sh
• gettext.c
• gettext.h
• git-add - interactive.perl
• git-am.sh
• git- archimport.perl
• git-bisect.sh
• git-compat-util.h
• git-cvsexportcommit.perl
• git-cvsimport.perl
• git-cvsserver.perl
• git-difftool--helper.sh
• git-difftool.perl
• git-filter-branch.sh

EDIT: Chỉ cần nhìn qua kết quả git clone và thấy cảnh báo này, không chắc chắn nếu nó làm cho một sự khác biệt: "Remote chi nhánh html không tìm thấy trong nguồn gốc thượng nguồn, sử dụng ĐẦU thay vì"

Answer 1

Thay đổi địa chỉ lệnh clone từ

$ 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 

Hy vọng điều này sẽ được thay đổi trong Github hướng dẫn sớm.

UPDATE:

Nếu bạn là một trong những người nghĩ rằng đó là đủ để có phân phối của Apple Git cung cấp với Xcode 4:

# 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 

này sẽ tạo ra một mục trong .gitconfig của bạn như:

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

Answer 2

Các code is (builtin/help.c):

static void get_html_page_path(struct strbuf *page_path, const char *page) 
{ 
    struct stat st; 
    const char *html_path = system_path(GIT_HTML_PATH); 

    /* Check that we have a git documentation directory. */ 
    if (stat(mkpath("%s/git.html", html_path), &st) 
     || !S_ISREG(st.st_mode)) 
    die("'%s': not a documentation directory.", html_path); 

    strbuf_init(page_path, 0); 
    strbuf_addf(page_path, "%s/%s.html", html_path, page); 
} 

vì vậy, có thể có một số vấn đề với GIT_HTML_PATH biến môi trường (như trong old issue đó), hoặc bạn không có bất kỳ tập tin trong git.html destinati của bạn trên thư mục trợ giúp.