#staticsite #website #blog

bin+lib helianto

A minimalist static website generator

2 releases

Uses old Rust 2015

0.1.0-beta1 Jan 13, 2016
0.1.0-alpha2 Dec 31, 2015

#1187 in Filesystem


1.5K SLoC


A minimalist website generator written in Rust.


You can install Helianto with Cargo :

cargo install helianto --git="https://github.com/m-r-r/helianto.git"

Basic usage

Creating a new project

One you have installed Helianto, you can create a new project with the --init option:

helianto --init new-website

Helianto will create a directory and populate it with the default template and CSS files.
An exemple page will also be created.

You can then build your site with the following command:

cd new-website

Changing the layout

You can change the layout of your website by modifying the page.html.hbs file in the _layouts directory. If this file is missing, Helianto will use the builtin one instead.

All the templates are using the Handlebar syntax.

Changing the assets

By default, Helianto creates a css directory containing the stylesheets used by the website.

Helianto copies all the files wich are not documents to the output directory. You can thus edit or remove the existing stylesheets and add new static files.

Adding content

You can create new pages by adding Markdown files in your website's directory.
The directory structure created by helianto --init already include an example page:

# Welcome

Created:  2015-12-30T16:47:45+01:00  
Keywords: helianto, test  

This is an example

The metadata block is optional, only the title of the document is required.

For now, Helianto only supports the following metadata :

Name Format Comment
Created An RFC 3339 date Used to sort the entries in the index
Keywords A coma separated list of keywords Used in the HTML metadata
Language An ISO 639-1 language code Used in the HTML metadata


~142K SLoC