Directory Structure

A Hwaro project has the following structure:

  my-site/
├── config.toml          # Site configuration
├── content/             # Markdown content
│   ├── index.md         # Homepage
│   ├── about.md         # /about/
│   └── blog/            # Section
│       ├── _index.md    # /blog/
│       └── post.md      # /blog/post/
├── templates/           # Jinja2 templates
│   ├── base.html        # Base layout
│   ├── page.html        # Page template
│   ├── section.html     # Section template
│   └── shortcodes/      # Shortcode templates
├── static/              # Static assets
│   └── assets/
│       ├── css/
│       └── js/
└── public/              # Build output (generated)

Directories

content/

Markdown files with TOML front matter. Directory structure maps to URLs:

templates/

Jinja2 templates for rendering content:

static/

Files copied directly to output. static/css/style.css becomes /css/style.css.

public/

Generated output directory. Deploy this folder.

Special Files