# Rustipo

> Rustipo is a Markdown-first static site generator written in Rust for blogs, docs, notes, and personal sites. It uses Tera templates for layout and keeps theme structure separate from palette-driven styling.

Use the published docs site as the primary source for end-user workflows and feature behavior.
Use the GitHub repository docs for contributor guidance, release workflow details, and repository-specific context.

## Start Here

- [Rustipo docs home](https://fcendesu.github.io/rustipo/): High-level overview of the project and its strengths.
- [Getting started](https://fcendesu.github.io/rustipo/guides/getting-started/): Install Rustipo, create a site, choose a palette, and preview locally.
- [CLI reference](https://fcendesu.github.io/rustipo/reference/cli/): Commands, deployment helpers, and recommended local workflow.

## Core Concepts

- [Content model](https://fcendesu.github.io/rustipo/reference/content-model/): Markdown organization, frontmatter, routes, taxonomies, and authoring behavior.
- [Themes and palettes](https://fcendesu.github.io/rustipo/reference/themes-and-palettes/): Built-in themes, palette selection, theme contracts, and image helper support.
- [Examples](https://fcendesu.github.io/rustipo/examples/): Representative site shapes for personal sites, journals, and knowledge bases.

## Docs And Deployment

- [Build the docs site](https://fcendesu.github.io/rustipo/guides/building-the-docs-site/): How the in-repo documentation project is built and published.
- [GitHub releases](https://github.com/fcendesu/rustipo/releases): Release notes, binaries, and tagged versions.

## Contributing And Project Metadata

- [Contributing guide](https://fcendesu.github.io/rustipo/guides/contributing/): How to contribute code, docs, and examples back to Rustipo.
- [Repository README](https://github.com/fcendesu/rustipo/blob/master/README.md): Project-facing install story, examples, and contributor entry points.
- [CONTRIBUTING.md](https://github.com/fcendesu/rustipo/blob/master/CONTRIBUTING.md): Repository contributor expectations and local workflow.
- [Security policy](https://github.com/fcendesu/rustipo/blob/master/SECURITY.md): Private reporting guidance for vulnerabilities.