1.Dd $Mdocdate: June 10 2020 $2.Dt DEPP-INDEX 13.Os4.Sh NAME5.Nm depp-index6.Nd generate an index page for Git web viewers7.Sh SYNOPSIS8.Nm depp-index9.Op Fl d Ar destination10.Op Fl p Ar num11.Op Fl s Ar description12.Op Fl t Ar title13.Op Fl x14.Ar repository ...15.Sh DESCRIPTION16For the given17.Ar repostories18.Nm19generates an HTML index page listing all of them.20The listing includes a short description of each repository, the time it was last modified, and a link to a repository page which provides more information.21Repositories are sorted in descending order by their modification time.22Referenced repository pages must be generated separately, for instance using23.Xr depp 1 .24.Pp25The options are as follows:26.Bl -tag -width Ds27.It Fl d Ar destination28The generated HTML and CSS files are written to the given29.Ar destination30directory.31This directory is created if it does not exist yet.32By default a33.Pa www34subdirectory is created and used in the current directory.35.It Fl p Ar num36List37.Ar num38repositories per generated web page.39The default is 20, the special value -1 disable pagination entirely.40.It Fl s Ar description41The header of the generated HTML optionally contains a short42.Ar description43of the page.44By default, no description is included.45.It Fl t Ar title46This argument specifies the47.Ar title48of the generated index page.49.It Fl x50Strip the51.Pa .git52file name extension (if it exists) when linking to the repository on the index page.53This is useful when serving both the HTML and the Git repository itself over HTTP in the same directory.54.El55.Sh FILES56The following files are used in bare Git repositories for metadata:57.Bl -tag -width Ds58.It Pa git-description59Used to provide a description for each repository in the list.60.El61.Sh EXIT STATUS62.Ex -std depp-index63.Sh SEE ALSO64.Xr depp 1 ,65.Xr git 166.Sh AUTHORS67.An Sören Tempel Aq Mt soeren@soeren-tempel.net