Other types of files

Besides generating content from .cmark section-based files, KitchenSink also copies some video and images, and knows how to call in some generators for very specific formats.

videos

KitchenSink copies .webm and .mp4 files under /videos.

sounds

KitchenSink copies .ogg, flac, .wav, .midi, and .mp3 files under /videos.

images

KitchenSink copies .jpg, .jpeg, and .png files under /images.

documents

KitchenSink copies .pdf files under /docs.

HTML

KitchenSink copies .html files under / that is, with no prefix.

The main use-case is to allow porting some other website to KitchenSink, starting from some imported .html Other usages could be to support things like webmaster-verification tools on Google.

⚠️ there is no conflict detection yet so avoid having a .cmark matching a .html file or you risk inconsistencies.

javascript

KitchenSink copies .js files under /js.

webfonts

KitchenSink copies .ttf and .woff2 files under /webfonts.

So-called raw files

KitchenSink copies .txt, .json, .csv, and .dhall files under /raw excepts for robots.txt and kitchen-sink.json. I use this feature for attaching datasets or showing a long text result (e.g., a long output of a command that is too slow to generate).

exception. The file robots.txt stays at the root of the output dir to meet the robots exclusion standard.

GraphViz dot files

KitchenSink calls dot to generate under /gen/images/<filename>.png. There is little support to control the command that KitchenSink handles. If you need more control, generate pictures aside or use a command-section.