kalastatic

kalastatic

Static site application framework for prototyping and styleguiding.

Install

Dependencies

• node 4, 5 or 6

Globally

$ npm install kalastatic -g

Project Dependency

To install KalaStatic as a dependency in your project:

$ npm install kalstatic --save

Usage

Convention

Construct your source files, using the template engine name in the file extension.

src/index.html.jade

---
youAreUsingJade: true
pretty: true
---
doctype html
html(lang="en")
  head
    title= title
  body
    h1 Jade - node template engine

Configuration

KalaStatic can be configured through a kalastatic.yml file. The default options are as follows:

# The base directory of where your package.json lives.
base: '.',

# The directory (from base), where the source content files live.
source: 'src',

# Additional sources to read for KSS documentation for the styleguide.
kssSource: [],

# Where to build out the files.
destination: 'build',

# Where the final CSS will be built out to. This is used for the Styleguide.
css: '../main.css',

# The options to pass off to the Metalsmith plugins when building, keyed by plugin name.
pluginOpts: {}

Build

Globally

$ kalastatic build

Project Dependency

$ node_modules/.bin/kalastatic build

API

KalaStatic can be used a JavaScript API. Calling KalaStatic() will build, and return a Promise.

var KalaStatic = require('kalastatic')
KalaStatic('path/to/site').then(function() {
  // Site built
})

Changelog

2.1.12: 2016-12-05

• Fix process exit code on error