Skip to content

A fast static site generator with executable code blocks inspired by Zola & Quarto.

License

Notifications You must be signed in to change notification settings

lostmygithubaccount/zorto

Repository files navigation

Zorto

Under construction. Zorto is in early development, check back soon.

A fast static site generator with executable code blocks inspired by Zola and Quarto.

Install

Recommended:

curl -LsSf https://dkdc.sh/zorto/install.sh | sh

uv:

uv tool install zorto

cargo:

cargo install zorto

You can use uvx to run it without installing:

uvx zorto

Usage

zorto [OPTIONS] <COMMAND>

Commands

Command Description
build Build the site
preview Start preview server with live reload
init Initialize a new site
check Check site for errors without building
clean Remove output directory

Quick start

# Create a new site
zorto init my-site
cd my-site

# Start dev server
zorto preview --open

# Build for production
zorto build

build

zorto build [--output <dir>] [--drafts] [--base-url <url>]

preview

zorto preview [--port <port>] [--drafts] [--open]

Features

  • TOML frontmatter (+++ delimited)
  • Syntax-highlighted code blocks
  • Executable code blocks (```{python})
  • Shortcodes (inline and block)
  • File includes ({{ include(path="...") }})
  • SASS/SCSS compilation
  • Live reload preview server
  • Taxonomy and pagination support
  • Sitemap and Atom feed generation
  • Internal link validation

About

A fast static site generator with executable code blocks inspired by Zola & Quarto.

Resources

License

Stars

Watchers

Forks