stagit-index.1 - stagit - static git page generator
 (HTM) git clone git://git.codemadness.org/stagit
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) README
 (DIR) 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