STAGIT-INDEX(1)

📦
version 1.2 · 2 versions
, in alpine 3.24, nixos 26.05

✨ STAGIT-INDEX(1) ✨

okay so bestie, let me tell you about stagit-index — it's a static git index page generator, and honestly it's giving main character energy for your repo collection 💅

🌸 SYNOPSIS 🌸

stagit-index [repodir...]

💖 DESCRIPTION 💖

stagit-index will create an index HTML page for the repositories you specify and writes the HTML data to stdout. Like, it just yeets that HTML straight out to standard output, no cap 🫶

The repos in the index are in the same order as the arguments repodir you specified — so the order you type them is the order you get them. Iconic, predictable, we love that for you ✨

The basename of the directory is used as the repository name. The suffix ".git" is removed from the basename, and yes that suffix is commonly used for "bare" repos — so don't stress, it handles that for you 🎀

The content of the follow files specifies the meta data for each repository 👑

  • .git/description or description (bare repos) — the description 💬
  • .git/owner or owner (bare repo) — the owner of repository 👤

For changing the style of the page you can use the following files, and ngl this is where you get to be creative bestie 🎨:

  • favicon.png — favicon image 🌟
  • logo.png — 32x32 logo 🖼️
  • style.css — CSS stylesheet 💅

🦋 EXAMPLES 🦋

cd htmlroot
stagit-index path/to/gitrepo1 path/to/gitrepo2 > index.html
like literally just cd into your htmlroot, list your repos, and redirect that output into index.html. slay 🔥

⭐ SEE ALSO ⭐

🌈 AUTHORS 🌈

Hiltjo Posthuma <hiltjo@codemadness.org> — thank you for this gift, fr fr 💜

and that's the whole vibe bestie — this is the Debian build from August 2, 2021, brought to you with love and a lil sparkle 🎀✨ bye pookie 🫶

📦 where this page comes from