gitVal

A static site generator for Git repositories, written in V.

gitVal is a V language implementation of gitmal. It generates browsable HTML websites from Git repositories with syntax highlighting, markdown rendering, commit history, and branch/tag navigation.

Installation

Prerequisites

• V compiler
• chroma for syntax highlighting:

  go install github.com/alecthomas/chroma/v2/cmd/chroma@latest
  

Build

v -prod . -o gitval

Usage

gitval [options] <repository-path>

Options

Option	Description	Default
-O, --output	Output directory	output
-t, --theme	Syntax highlighting theme	github
-n, --name	Project name	Repository directory name
-o, --owner	Project owner name	-
-d, --default-branch	Default branch	Autodetects master or main
-b, --branches	Pattern for branches to include	All branches
-m, --minify	Minify HTML output	false
-g, --gzip	Gzip compress output	false
-p, --preview-themes	Preview available themes	-

Examples

# Generate site for current repository
gitval .

# Generate with custom project name and owner
gitval -o myusername -n myproject /path/to/repo

# Generate with dark theme
gitval -t github-dark /path/to/repo

# Generate with custom output directory
gitval -O ./public /path/to/repo

# Preview available themes
gitval -p

Features

• Syntax highlighting for 200+ languages (via chroma)
• 60+ color themes
• Markdown rendering with resolved links
• Commit history with file diffs
• Branch and tag navigation
• File tree with collapsible directories
• Responsive design
• Light and dark theme support

License

MIT License - see LICENSE file.