Skip to content

GozziA Go Static Site Generator

Built for learning. Simple by design.

Gozzi

Quick Example โ€‹

Install and create your first site:

bash
go install github.com/tduyng/gozzi@latest
bash
mkdir my-blog && cd my-blog
mkdir -p content/blog templates static

# Create config
cat > config.toml << EOF
base_url = "https://example.com"
title = "My Blog"
EOF

# Create first post
mkdir -p content/blog/hello-world
cat > content/blog/hello-world/index.md << EOF
+++
title = "Hello World"
date = 2024-01-15
+++

# My First Post

Welcome to my blog built with Gozzi!
EOF
bash
cat > templates/post.html << EOF
<!DOCTYPE html>
<html>
<head>
    <title>{{ .Page.Config.title }}</title>
</head>
<body>
    <article>
        <h1>{{ .Page.Config.title }}</h1>
        <time>{{ date .Page.Config.date "Jan 2, 2006" }}</time>
        {{ .Page.Content }}
    </article>
</body>
</html>
EOF
bash
gozzi serve
# Visit http://localhost:1313

Real Usage โ€‹

I built Gozzi to learn, and now I use it daily for tduyng.com:

  • 100+ blog posts and notes
  • Math expressions with KaTeX
  • Diagrams with Mermaid
  • Full-text search
  • Builds in ~100ms

See the real-world example to learn from my setup.

Documentation โ€‹

Open Source โ€‹

Gozzi is MIT licensed. Built by learning, shared for learning.

View source on GitHub ยท Report issues ยท Discussions

Released under the MIT License.