This is the Super Simple Site generator.
You give it markdown files and (if you fancy) an HTML layout to render them into - and it gives you static HTML.
That's it. No magic, no fancy build tools - Markdown and HTML. Now go and make that website!
To setup, you run
npm install -g susiand then to parse markdown files into HTML you can use:
susi directory/with/markdown_files/ output_directory/ path/to/layouts/So, for example:
susi /var/www/markdown /var/www/html /var/www/layout.htmlwill parse all markdown files in /var/www/markdown/ and will create corresponding HTML files in /var/www/html/ using the /var/www/layout.html file.
Now parsing naked Markdown files into naked HTML often isn't enough, so there's the layouts which you pass in as the third parameter.
At least create a single layout file called page.html.
Say you have a layout with a few navigation links and some css like this:
<!doctype html>
<html>
<head>
<link rel="stylesheet" href="style.css">
<title>{{title}}</title>
</head>
<body>
<nav>
<ul>
<li><a href='home.html'>Home</a></li>
<li><a href='projects.html'>Projects</a></li>
<li><a href='contact.html'>Contact</a></li>
</nav>
<h1>{{title}}</h1>
<h2>{{date}}</h2>
<section id="main">{{contents}}</section>
</body>
</html>When you pass in the path to this files directory as the third parameter, SuSi will render each markdown file into the place of {{contents}}.
So if you do:
susi input/ output/ path/to/layout/A markdown file like this:
{
"title": "My Site",
"date": "2014-11-27"
}
---
# Some headline
Some *text* of mine.will be rendered into:
<!doctype html>
<html>
<head>
<link rel="stylesheet" href="style.css">
<title>My Site</title>
</head>
<body>
<nav>
<ul>
<li><a href='home.html'>Home</a></li>
<li><a href='projects.html'>Projects</a></li>
<li><a href='contact.html'>Contact</a></li>
</nav>
<section id="main">
<h1>My Site</h1>
<h2>2014-11-27</h2>
<p>Some <em>text</em>of mine.</p>
</section>
</body>
</html>which is pretty handy.
Each markdown file is expected to have a
Each markdown file is expected to have a a frontmatter section formatted in JSON like so:
{
"title": "new site gen",
"date": "2014-11-27",
"layout:" "page"
}Note: A triple dash '---' on a new line is required to seperate the frontmatter from the markdown formatted text.
Note: You may leave out the layout field, which then defaults to page.
The layout attribute will be used to look for a file with a matching name and ".html" suffix in the directory specified as the third parameter on the commandline to susi.
Of course additional, custom attributes can be optionally included in the frontmatter json and can then be used in all the html layout files using the "Mustache" style syntax.
The html layout files can use the Apache SSI style html comment "include" directive to pull in other layout files to provide basica support for "partials", to help keep things DRY, eg.
<!--#include virtual="meta.html" -->
<!--#include virtual="header.html" -->
<div class="container">
<div class="starter-template">
<h1>{{title}}</h1>
<p class="lead">
{{contents}}
</p>
</div>
</div><!-- /.container -->
<!--#include virtual="footer.html" -->Note: the "included" files can use the "Mustache" syntax as well, as they will be resolved after all the include directives have been processed.
Now, seriously, go make static websites!
SuSi is available under the ISC License.
If you have any suggestions, found bugs or want a new feature, don't hesitate to submit a pull request or open an issue.
Pull requests are always welcome, no matter how small. But if you're about to create large, sweeping changes, I suggest opening an issue before making those changes to check, if they're making sense in the scope of the project and to discuss them to avoid later frustration.