Gabs is a stupid system for creating websites with Github Flavored Markdown. It consists of only a single command to create a website and build it.
Install it from crates.io, from source or from the releases page:
shell
$ cargo install gabs
Or:
shell
$ git clone https://github.com/gboncoffee/gabs
$ cargo build --release
$ # then link the executable to somewhere in your path
First, inside the directory of your website, run the command to create the
_gabs directory and build a simple default example.
Inside the _gabs directory, you place your files. HTML files are templates,
and Markdown files will be build with them. Stylesheets and scripts will be just
copied to their location and linked to their templates. Examples:
_gabs/index.md will build to index.html _gabs/posts/post.md will build to posts/post.html _gabs/index.html is a template with name "index" _gabs/index.css will be the stylesheet for any file with the
"index" template and will be copied to index.css. If there are files called footer.html and/or header.html, they'll be added
to the bottom and the top of the <body> of every document. Of course, no
template can be named "footer" or "header".
If there are files called global.css or global.js, they'll be linked to
every document.
Note that the filename of Markdown files DOES NOT MEAN ANYTHING. To define the template for a Markdown file, read below:
Markdown files can have a special first line called the Gabs header. It looks like this:
```