## GitWeb
如果你對項目有讀寫權限或只讀權限,你可能需要建立起一個基于網頁的簡易查看器。 Git 提供了一個叫做 GitWeb 的 CGI 腳本來做這項工作。

如果你想要查看 GitWeb 如何展示你的項目,并且在服務器上安裝了輕量級網絡服務器比如 lighttpd 或 webrick, Git 提供了一個命令來讓你啟動一個臨時的服務器。 在 Linux 系統的電腦上,lighttpd 通常已經安裝了,所以你只需要在項目目錄里執行 git instaweb 命令即可。 如果你使用 Mac 系統, Mac OS X Leopard 系統已經預安裝了 Ruby,所以 webrick 或許是你最好的選擇。 如果不想使用 lighttpd 啟動 instaweb 命令,你需要在執行時加入 --httpd 參數。
~~~
$ git instaweb --httpd=webrick
[2009-02-21 10:02:21] INFO WEBrick 1.3.1
[2009-02-21 10:02:21] INFO ruby 1.8.6 (2008-03-03) [universal-darwin9.0]
~~~
這個命令啟動了一個監聽 1234 端口的 HTTP 服務器,并且自動打開了瀏覽器。 這對你來說十分方便。 當你已經完成了工作并想關閉這個服務器,你可以執行同一個命令,并加上 --stop 選項:
~~~
$ git instaweb --httpd=webrick --stop
~~~
如果你現在想為你的團隊或你托管的開源項目持續的運行這個頁面,你需要通過普通的 Web 服務器來設置 CGI 腳本。 一些 Linux 發行版的軟件庫有 gitweb 包,可以通過 apt 或 yum 來安裝,你可以先試試。 接下來我們來快速的了解一下如何手動安裝 GitWeb。 首先,你需要獲得 Git 的源代碼,它包含了 GitWeb ,并可以生成自定義的 CGI 腳本:
~~~
$ git clone git://git.kernel.org/pub/scm/git/git.git
$ cd git/
$ make GITWEB_PROJECTROOT="/opt/git" prefix=/usr gitweb
SUBDIR gitweb
SUBDIR ../
make[2]: `GIT-VERSION-FILE' is up to date.
GEN gitweb.cgi
GEN static/gitweb.js
$ sudo cp -Rf gitweb /var/www/
~~~
需要注意的是,你需要在命令中指定 GITWEB_PROJECTROOT 變量來讓程序知道你的 Git 版本庫的位置。 現在,你需要在 Apache 中使用這個 CGI 腳本,你需要為此添加一個虛擬主機:
~~~
<VirtualHost *:80>
ServerName gitserver
DocumentRoot /var/www/gitweb
<Directory /var/www/gitweb>
Options ExecCGI +FollowSymLinks +SymLinksIfOwnerMatch
AllowOverride All
order allow,deny
Allow from all
AddHandler cgi-script cgi
DirectoryIndex gitweb.cgi
</Directory>
</VirtualHost>
~~~
再次提醒,GitWeb 可以通過任何一個支持 CGI 或 Perl 的網絡服務器架設;如果你需要的話,架設起來應該不會很困難。 現在,你可以訪問 http://gitserver/ 在線查看你的版本庫。
- 第一章 起步
- 1.1 關于版本控制
- 1.2 Git 簡史
- 1.3 Git 基礎
- 1.4 命令行
- 1.5 安裝 Git
- 1.6 初次運行 Git 前的配置
- 1.7 獲取幫助
- 1.8 總結
- 第二章 Git基礎
- 2.1 獲取 Git 倉庫
- 2.2 記錄每次更新到倉庫
- 2.3 查看提交歷史
- 2.4 撤消操作
- 2.5 遠程倉庫的使用
- 2.6 打標簽
- 2.7 Git 別名
- 2.8 總結
- 第三章 Git分支
- 3.1 分支簡介
- 3.2 分支的新建與合并
- 3.3 分支管理
- 3.4 分支開發工作流
- 3.5 遠程分支
- 3.6 變基
- 3.7 總結
- 第四章 服務器上Git
- 4.1 協議
- 4.2 在服務器上搭建 Git
- 4.3 生成 SSH 公鑰
- 4.4 配置服務器
- 4.5 Git 守護進程 TODO
- 4.6 Smart HTTP
- 4.7 GitWeb
- 4.8 GitLab
- 4.9 第三方托管的選擇
- 4.10 總結
- 第五章 分布式Git
- 5.1 分布式工作流程
- 第六章 GitHub
- 第七章 Git工具
- 第八章 自定義Git
- 第九章 Git于其他系統
- 第十章 Git內部原理
- 附錄A 其他環境中的Git
- A1.1 圖形界面 TODO
- A1.2 Visual Studio 中的 Git TODO
- A1.3 Eclipse 中的 Git
- 附錄B 將Git嵌入你的應用
- 附錄C Git命令
- 附錄D 常用命令
- D.1 配置和設置
- D.2 幫助
- D.3 創建和獲取倉庫
- D.4 文件狀態
- D.5 查看日志