2021-08-03 17:22:50 +00:00
|
|
|
.Dd August 2, 2021
|
2015-12-26 20:05:55 +00:00
|
|
|
.Dt STAGIT-INDEX 1
|
2015-12-20 16:11:25 +00:00
|
|
|
.Os
|
|
|
|
|
.Sh NAME
|
2015-12-26 20:05:55 +00:00
|
|
|
.Nm stagit-index
|
2015-12-20 20:34:40 +00:00
|
|
|
.Nd static git index page generator
|
2015-12-20 16:11:25 +00:00
|
|
|
.Sh SYNOPSIS
|
|
|
|
|
.Nm
|
|
|
|
|
.Op Ar repodir...
|
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
|
.Nm
|
2015-12-20 20:34:40 +00:00
|
|
|
will create an index HTML page for the repositories specified and writes
|
2017-04-22 12:38:39 +00:00
|
|
|
the HTML data to stdout.
|
|
|
|
|
The repos in the index are in the same order as the arguments
|
2016-01-08 12:42:26 +00:00
|
|
|
.Ar repodir
|
|
|
|
|
specified.
|
2015-12-20 20:34:40 +00:00
|
|
|
.Pp
|
2017-04-22 12:38:39 +00:00
|
|
|
The basename of the directory is used as the repository name.
|
|
|
|
|
The suffix ".git" is removed from the basename, this suffix is commonly used
|
|
|
|
|
for "bare" repos.
|
2015-12-26 20:05:55 +00:00
|
|
|
.Pp
|
|
|
|
|
The content of the follow files specifies the meta data for each repository:
|
|
|
|
|
.Bl -tag -width Ds
|
|
|
|
|
.It .git/description or description (bare repos).
|
|
|
|
|
description
|
|
|
|
|
.It .git/owner or owner (bare repo).
|
|
|
|
|
owner of repository
|
|
|
|
|
.El
|
|
|
|
|
.Pp
|
2015-12-20 20:34:40 +00:00
|
|
|
For changing the style of the page you can use the following files:
|
|
|
|
|
.Bl -tag -width Ds
|
|
|
|
|
.It favicon.png
|
|
|
|
|
favicon image.
|
2017-04-22 12:38:39 +00:00
|
|
|
.It logo.png
|
|
|
|
|
32x32 logo.
|
2015-12-20 20:34:40 +00:00
|
|
|
.It style.css
|
|
|
|
|
CSS stylesheet.
|
|
|
|
|
.El
|
2021-08-03 17:22:50 +00:00
|
|
|
.Sh EXAMPLES
|
|
|
|
|
.Bd -literal
|
|
|
|
|
cd htmlroot
|
|
|
|
|
stagit-index path/to/gitrepo1 path/to/gitrepo2 > index.html
|
|
|
|
|
.Ed
|
2015-12-20 20:34:40 +00:00
|
|
|
.Sh SEE ALSO
|
2015-12-26 20:05:55 +00:00
|
|
|
.Xr stagit 1
|
2015-12-20 16:11:25 +00:00
|
|
|
.Sh AUTHORS
|
|
|
|
|
.An Hiltjo Posthuma Aq Mt hiltjo@codemadness.org
|
