nicolino

This README is the one indexed from the repository at its latest ref, not from the tag for this version.

# Nicolino

A **good** static site generator.

## Features

- **Markdown-based content** - Write in markdown, get HTML
- **Posts and pages** - Blog posts with RSS feeds and static pages
- **Taxonomies** - Tags, categories, and custom classification systems
- **Image galleries** - Automatic thumbnails with lightbox
- **Books** - mdbook/gitbook-style documentation with hierarchical chapters, sidebar TOC, and navigation
- **Search** - Site search functionality
- **Sitemap** - Automatic XML sitemap generation
- **Fast builds** - Parallel, incremental builds via Croupier task system

## WARNING

This project is still in development and may change suddenly in places like
the configuration file format, but it is ready to start being used.

For more information, visit <https://nicolino.ralsina.me>

## Building for Release (Static Binaries)

The project uses `libvips` for fast image processing, but libvips cannot be statically linked. To create static binaries, we use the `-Dnovips` flag which falls back to `crimage` (a pure-Crystal image library).

**Important trade-offs:**
- **Non-release builds with crimage are very slow** - image processing will take noticeably longer
- **Release builds with crimage are somewhat faster** - but still slower than libvips
- **Static builds require `-Dnovips`** - otherwise linking will fail due to missing libvips static libraries

For development use, build without `-Dnovips` for fast image processing with libvips. For release/static builds, use `-Dnovips` and accept the performance trade-off.