stagit

custom fork of stagit
Index Commits 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