A Rust Site Engine

A Rust Site Engine, or arse, is static site generator written in Rust. It seeks to provide a simple and flexible base for serving sites using:

• Tera for templates
• pulldown-cmark for CommonMark rendering
• routerify to serve the site
• simplecss for default styling

Usage

• Run an existing site given the path to its config TOML: arse run config.toml
• Create and run a new site from user input: arse new
• Logging verbosity can be increased with -v or -vv, the default level is INFO.

Rendering and Styling

A default template, default.tmpl, is provided statically within the binary. To change the Tera template, add your custom template to the templates directory referenced in the docpaths configuration section of config.toml. Once the template is in the templates directory, change the templates parameter in the site configuration section to reference the template's file name. This template will now be loaded at runtime.

The following elements are available within the Tera context for rendering:

• site, mapping directly to the fields available in the site configuration section
• posts, a lexically reverse-sorted list of HTML rendered from markdown in site/:topic/posts/*

Path to 1.0

• [x] Dynamic route handling
• [x] Provide meaningful logging of binary activites at appropriate levels
• [x] Context-specific Errors and handling
• [x] Support custom Tera templates
• [ ] Administration portal for site management

License

Licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.