#static #site #generator

bin+lib belong

Simple and flexible static site generator

1 unstable release

0.1.0 Apr 9, 2020

#4 in #site-generator

MIT/Apache

38KB
979 lines

belong

Static blog generator inspired by mdBook.

Features

  • Markdown to HTML rendering.
  • TOML front matter.
  • Familiar template language base on Jinja2/Django (Tera).
  • Basic theme and templates provided out of the box.
  • Syntax highlighting.

Getting started

Install belong using Cargo.

cargo install belong

Initialize a new project.

mkdir -p blog && cd blog
belong init

This will create a belong config file (belong.toml) and an example Markdown page in the following directory structure.

├── .gitignore
├── belong.toml
└── src
    └── hello-world.md

Finally build and open the project in the default web browser.

belong build --open

It will look something like the following:

example

License

Licensed under either of

at your option.

Dependencies

~10MB
~199K SLoC