taxus

A static site generator built in Rust.

Founded on Tera and Yew. Named for the genus of the yew tree.

Authoring

Write with Ease

Author content using the CommonMark markdown standard, thanks to the pulldown-cmark crate.

Intuitively build out the content directory to define your site. Create directories that correspond to your routes. Write _index.md files for section pages, and individual markdown files for regular pages.

Describe with Rich Metadata

Metadata is defined via TOML frontmatter:

+++
title = "My Page"
description = "A brief description"
date = 2024-01-15
tags = ["rust", "web"]
+++

Frontmatter is parsed and converted into injectable variables for templates.

Co-located Assets

Place images alongside your markdown—they're copied to output automatically:

content/blog/
├── my-post.md
├── photo.jpg
└── diagrams/
    └── architecture.png

Internal Links

Reference other pages by content path with build-time validation. The @/ prefix signals an internal link relative to content/:

See the [other page](@/path/to/page.md) for details.

References