Web-based Git Repository Browsing (GitWeb)
SourceForge.net provides a centralized install of GitWeb as a web interface for browsing your project Git.
Features
GitWeb supports common actions such as:
- Reviewing recent changes in the repository.
- Viewing the contents of a checked-in file (including raw or syntax-highlighted outputs).
- Viewing the differences between two revisions of a file.
- Easily accessing tagged versions of file content.
Configuration
Several per-repository configuration options are available to you to change the information displayed on the landing page for a git repository.
- Create a "description" file in your git repository root, with a brief, one-line description of your repository. This file is treated as plain text, any HTML will be escaped. This will appear in the top section of the gitweb repository landing page.
- Create a "cloneurl" file in your git repository root, containing one url per line. Use this to display the clone url for your repository. This will appear in the same section as the description line, one url per line.
- Create a "README.html" file in your git repository root, with arbitrary descriptive content. HTML is allowed, and will be displayed inside a div tag on the gitweb page, in a section below the one with description.
- Set the owner, by setting a gitweb.owner configuration variable in the "config" file, located in your git repository root. If the "gitweb" section does not exist, create it. The owner setting in the config should look like the sample below (you can use any arbitrary string for owner):
[gitweb] owner = Your Name <youremail>
References: http://repo.or.cz/w/alt-git.git?a=blob_plain;f=gitweb/README
Access
To access GitWeb:
- Access the Project Summary page for the desired project.
- Click on the "Git Browse" link under the Code dropdown menu.
The link will be to the PROJECT's http://PROJECT.git.sourceforge.net/ page.
