Skip to content

Warbo/git2html

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

73 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DESCRIPTION
-----------

git2html is a simple git web interface. Unlike other web interfaces,
git2html does not generate content dynamically: instead of using a CGI
script, it generates static HTML pages.

Generating static HTML pages has advantages and disadvantages.  The
main advantages are that it is more secure and more robust.  It is
more robust in the sense that web server configuration changes are
unlikely to cause the interface to stop working.  Its primary
disadvantage is that because the pages are generated statically, not
all queries can be supported, e.g., diffs between arbitrary revisions.
Despite this seemingly dehabilitating disadvantage, the output is
surprisingly useful.

USAGE
-----

The first time you run git2html, you need to indicate your project's
name (-p), the link for viewers to clone the repository (-l), the
repository to get updates from (-r) and the target directory.

Here is how I configured git2html's viewer directory:

 $ ./git2html.sh \
     -p git2html \
     -l http://hssl.cs.jhu.edu/~neal/git2html.git \
     -r /home/neal/public_html/git2html.git 
     ~/public_html/git2html/src/

Note that this first run will take a fair amount of time.  git2html
tries to be smart and avoids doing a fair amount of redundant work on
subsequent runs.

Subsequent runs only require the target directory (git2html saves the
configuration in the target directory in the .ht_git2html file).

After commiting to git2html's repository, the following command is
run:

 $ ./git2html.sh ~/public_html/git2html/src/

HOMEPAGE
--------

http://hssl.cs.jhu.edu/~neal/git2html/

SOURCE
------

To get the source:

  git clone http://hssl.cs.jhu.edu/~neal/git2html.git

BUG REPORTS
-----------

Send bug reports to Neal H. Walfield <neal@walfield.org>.