A all-in-one, opinionated, swiss army knife, hackable static site generator.
JavaScript HTML
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
example
lib
test
.eslintrc
.gitattributes
.gitignore
.travis.yml
CHANGELOG.md
LICENSE
README.md
index.js
package.json

README.md

kartoffeldruck

Build Status

An intentionally non-pluggable, all-in-one, opinionated static site generator. Built with the zen of kartoffeldruck.

kartoffeldruck image

Image CC BY-SA 2.0, Walter Stempelo

Features

kartoffeldruck is a full fledged site generation solution. An incomplete list of features:

  • Markdown and Nunjucks templating support
  • Front matters
  • Pagination
  • Draft posts
  • Fetch tags and generate tag clouds
  • Generate table of contents
  • Custom urls (slugify, ...)
  • Custom helpers
  • Custom content processors

We intentionally do not provide any css processing pipelines or asset copy utilities. Use other tools that do the job.

Resources

Usage

Get the dependency via npm:

npm install kartoffeldruck

Place a kartoffeldruck.js file in your current project directory:

module.exports = function(druck) {

  // initialize the kartoffeldruck instance
  // you may specify (global) template locals
  // as well as the place for templates, pages, assets and dest more
  druck.init({
    locals: {
      site: {
        title: 'My Site'
      }
    }
  });


  druck.generate({
    source: '*.md',
    dest: ':name/index.html'
  });
};

Run kartoffeldruck in the current directory. It will pick up your runner file and generate the site into the dist directory (or whatever is specified as dest via druck.init(options).

> kartoffeldruck
Generating site in /some-dir
Done

Check out the example project to learn more.

Alternatives

You would like to spend hours composing a site generation solution yourself? Try out metalsmith. You would rather like to use Ruby anyway? Try jekyll. You want to experiment? Role your own.

Grunt Integration

Simply add the following task to your Gruntfile.js:

grunt.registerTask('kartoffeldruck', function() {
  var kartoffeldruck = require('kartoffeldruck');
  kartoffeldruck.run({
    logger: {
      log: grunt.log.ok
    }
  });
});

It will pick up your local kartoffeldruck.js file and generate the blog from there.

License

MIT