🚀 Krik

A fast static site generator written in Rust 🦀 that transforms Markdown files into beautiful, responsive websites with internationalization support and modern theming ✨

✨ Features

Core

• GitHub Flavored Markdown with tables, footnotes, code blocks
• YAML front matter with custom fields and layout override
• Draft support via draft: true in front matter
• Automatic asset copying and directory structure preservation
• Site configuration via site.toml

Theming & i18n

• Light/dark mode with OS detection and manual toggle
• Language detection from file.lang.md pattern
• Supported languages: en, it, es, fr, de, pt, ja, zh, ru, ar
• Tera-based templating with responsive design

Advanced

• Development server with live reload and file watching
• RFC 4287 compliant Atom feeds with xml:base support
• Table of contents generation with toc: true
• Bidirectional footnote navigation with smooth scrolling
• Smart scroll-to-top button and theme-aware syntax highlighting

🌐 Demo

See Krik in action! My personal website is built with Krik and showcases real-world usage:

• Live Website: https://mirkocaserta.com - A complete blog built with Krik
• Feature Demo: https://mirkocaserta.com/krik/ - Comprehensive demo showcasing all Krik features including themes, i18n, TOC, footnotes, and more

The demo site includes example posts demonstrating markdown features, theme switching, internationalization, and all the advanced capabilities that make Krik a powerful static site generator.

📦 Installation

From Source

git clone https://github.com/mcaserta/krik.git
cd krik
cargo build --release

The executable will be available at target/release/kk.

Global Install

cargo install krik

🔧 Usage

Initialize New Site

Create a new Krik site with sample content and default theme:

kk init                     # Initialize in current directory
kk init my-blog             # Initialize in new directory
kk init my-blog --force     # Overwrite existing files

Create Content

Create new blog posts and pages quickly:

kk post "My Great Post"           # Create new blog post
kk post                           # Create with default title "New post"
kk post "Custom Post" -f my-slug  # Custom filename

kk page "About Us"                # Create new page
kk page                           # Create with default title "New page"
kk page "Contact" -f contact      # Custom filename

Basic Usage

Generate a site from the current directory:

kk

Development Server

kk server                    # Start on port 3000 with live reload
kk server --port 8080        # Custom port
kk server --no-live-reload   # Disable live reload (useful for mobile devices)

Features: Live reload, file watching, multi-interface binding, network discovery

Production Build

kk --input /path/to/content --output /path/to/site --theme /path/to/theme

Options

• -i, --input <DIR>: Input directory (default: content)
• -o, --output <DIR>: Output directory (default: _site)
• -t, --theme <DIR>: Theme directory (default: themes/default)
• -p, --port <PORT>: Server port (default: 3000)
• --no-live-reload: Disable live reload functionality (server subcommand only)

📁 Content Organization

Directory Structure

content/
├── site.toml        # Site configuration (not copied to output)
├── posts/           # Blog posts (uses 'post' template)
│   ├── sample.md
│   ├── sample.it.md # Italian translation
│   └── time-series.md
├── pages/           # Static pages (uses 'page' template)
│   └── about.md
├── images/          # Static files (copied as-is)
│   └── logo.png
└── any-file.md      # Root level files (uses 'page' template)

Site Configuration

title = "My Blog"
base_url = "https://example.com"  # Optional, for feeds

Front Matter

Add metadata to your markdown files using YAML front matter:

---
title: "My Blog Post"
date: 2024-01-15T10:30:00Z
layout: post
tags: ["rust", "static-site", "web"]
toc: true
draft: false # Set to true to skip processing
---
# Your content here

Fields: title, date, draft, layout, tags, toc

Theme System

Tera-based templates with light/dark mode auto-detection and manual toggle. Templates automatically chosen based on directory (posts/ → post template, pages/ → page template). Override with layout field in front matter.

Development

cargo build
cargo test
cargo run -- --input ./content --output ./_site

License

MIT License