A simple blog tooling package that will automatically look for markdown files and convert them into HTML blog posts. Intended for use with Rocket and Tera templates, but could be used elsewhere.
For this to work, you should have a folder, for instance, blog which serves
as the root. Within this folder, you can have any folder structure you like,
so long as there is a markdown file and a JSON file next to each other. The
markdown and JSON file need to have the same file stem. For example, you could
have
The JSON must conform to the following schema
{
"title": String,
"date": ISO 8601 Date i.e. YYYY-MM-DD,
"desc": Optional<String>,
"slug": String,
"tags": [String],
"keywords": Optional<[String]>,
"canonical_link": Optional<String>,
"author_name": Optional<String>,
"author_webpage": Optional<String>
}
If you put the whole blog inside a lazy static it can massively help with website speed
pub static BLOG_ROOT: &str = "blog";
lazy_static! {
pub static ref STATIC_BLOG_ENTRIES: Blog = get_blog(PathBuf::from(BLOG_ROOT), None, None);
}
You can run the example blog with
cargo +nightly run --example blog
For now Rocket requires the use of nightly toolchains. You can then view the blog at localhost:8080