rigid
v0.1.1
Published
A dead simple static website generator using marked.
Downloads
2
Maintainers
Readme
rigid
rigid is a dead simple static website generator with no fancy extras and magic in it. It uses marked for markdown parsing and mustache.js for easy templating.
Usage
To install rigid
simply run: npm install -g rigid
The config file
To use rigid in a new project you just have to have a rigid.json
config file.
{
"siteDir": "content",
"indexFile": "index.html",
"outputDir": "public"
}
These 3 properties are the only ones that must and can be set. The siteDir
is the directory where the single sites are located. These have to be written in markdown.
Basically you have one index.html
where you have defined all your website structure and design. This is the one file that you have to specify as the indexFile
in your rigid.json
config file.
sites
These sites are written in markdown and can have the extension .md
or .markdown
. They are being parsed and pasted into the specific part of your indexFile
.
These sites have to have front-matter in it, that means you can (and have to) specify some meta information for your sites.
---
title: About us
link_title: About us
slug: about-us
---
indexFile
The index file is your normal index.html
. You just have the ability to access some attributes via mustache.js.
For an example see the example folder.
Generate the site
To generate the site simply run rigid
in your directory where the rigid.json
config file is located or run rigid --path path/to/you/site
. It then generates the static site in your specified outputDir
.
Ordering the sites
If you have multiple sites and you want to order them, simply prefix their filename and the parser will take care of the rest. See the example for this.
Using Programmatically
There is also the possibility to use rigid
programmatically. This is rather easy:
var generator = require('rigid');
generator.generateSite(pathToSite, function(err) {
if(err) return console.error(err);
console.log('Finished!');
});