stagit

static git page generator
git clone git://git.codemadness.org/stagit
Log | Files | Refs | README | LICENSE

stagit-index.1 (1096B)


      1 .Dd August 2, 2021
      2 .Dt STAGIT-INDEX 1
      3 .Os
      4 .Sh NAME
      5 .Nm stagit-index
      6 .Nd static git index page generator
      7 .Sh SYNOPSIS
      8 .Nm
      9 .Op Ar repodir...
     10 .Sh DESCRIPTION
     11 .Nm
     12 will create an index HTML page for the repositories specified and writes
     13 the HTML data to stdout.
     14 The repos in the index are in the same order as the arguments
     15 .Ar repodir
     16 specified.
     17 .Pp
     18 The basename of the directory is used as the repository name.
     19 The suffix ".git" is removed from the basename, this suffix is commonly used
     20 for "bare" repos.
     21 .Pp
     22 The content of the follow files specifies the meta data for each repository:
     23 .Bl -tag -width Ds
     24 .It .git/description or description (bare repos).
     25 description
     26 .It .git/owner or owner (bare repo).
     27 owner of repository
     28 .El
     29 .Pp
     30 For changing the style of the page you can use the following files:
     31 .Bl -tag -width Ds
     32 .It favicon.png
     33 favicon image.
     34 .It logo.png
     35 32x32 logo.
     36 .It style.css
     37 CSS stylesheet.
     38 .El
     39 .Sh EXAMPLES
     40 .Bd -literal
     41 cd htmlroot
     42 stagit-index path/to/gitrepo1 path/to/gitrepo2 > index.html
     43 .Ed
     44 .Sh SEE ALSO
     45 .Xr stagit 1
     46 .Sh AUTHORS
     47 .An Hiltjo Posthuma Aq Mt hiltjo@codemadness.org