The Kitchen Sink Blog Generator

Kitchen-Sink is a frivolous static-site generator.

This website is the main documentation and main example of Kitchen-Sink features. You can install KitchenSink from source using the GitHub directory.

We don’t claim to be the best organized nor the fastest nor the prettiest. We just want to generate web pages from content and move on.

all articles

Feature list

2483 words / 42 links / 3 images / 6 snippets

This article lists the main features of Kitchen Sink. We do not really compare it to the vast amount of other static-site generators.

The Kitchen Sink philosophy

744 words / 1 links / 0 images / 0 snippets

In these pages, I sometimes use “It’s a kitchen-sink!” as a placeholder for apologetic or unapologetic statements regarding the lack of sophistication of Kitchen-Sink. This article positions a few tenents for Kitchen-Sink, and hopefully helps you get a feel the experience we want to build around this software.

Other types of files

202 words / 2 links / 0 images / 0 snippets

There is more to a blog than just CommonMark HTML. This article explains briefly how the KitchenSink engine handles other format.

The section-based format

1788 words / 3 links / 0 images / 1 snippets

Writing articles in KitchenSink requires to write text files with a specific format called the section-based authoring format. A section-based format consists of delimited sections of text. Sections either configure the page (e.g., the tile of the page) or provide meaty content for readers to read.

This article describes the section-based format and sections available to write articles.

Development

379 words / 5 links / 0 images / 1 snippets

You want to change, extend, or restrict Kitchen-Sink? found a bug? want to extract some feature out of it or on the opposite, embed it in a larger application?

Engine

487 words / 2 links / 0 images / 0 snippets

This article answers questions the engine (i.e., the glue-code performing the dance to understand what layout code to apply to generate results).

Dhall support in depth

811 words / 5 links / 0 images / 8 snippets

Documenting the special feature of Dhall-sections.

Getting started

575 words / 6 links / 0 images / 4 snippets

This article gets you started with KitchenSink. As of date, you need some amount of programming know-how.

Layouts and extensions

1194 words / 8 links / 0 images / 5 snippets

There are two notions of layouts in KitchenSink: article layouts and website layouts. This article answers questions like: how do you change the layout of the blog? how do you extend KitchenSink?

Whishlist

38 words / 0 links / 0 images / 0 snippets

A whishlist, which actually is a todolist.

The kitchen-sink-dot-json file

364 words / 0 links / 0 images / 1 snippets

The kitchen-sink.json file is simpble but quite important as it configures things like the URL of your blog.

Design points

716 words / 2 links / 0 images / 0 snippets

This article gives a number of design points and architecture tradeoffs.