This project builds schildi.chat using metalsmith.

yarn install

make

• Website
• Step by step guide
• GitHub

• handlebarsjs
• block helpers

Install plugins with

yarn install --dev <plugin-name>

in order to have them put into the devDependencies.

• ignore stuff
• default values plugin
• generate favicons;
• discover handlebars helpers
• nested layouts
• discover handlebars partials
• sass plugin
• postcss
• webpack
• metalsmith-contenthash
• ancestry
• transform source files in place
• use layouts as skeleton for source files
• inline svg
• link prefixes
• minify html

• headings plugin
• headings-identifier plugin
• generate navigation (maybe rather use ancestry to meet individual needs)
• multi language
• responsive images: generate and helper
• optimize svgs
• svg sprites: too old, (too) new
• handlebars alternative
• stylelint (or with postcss, but ditching sass or using it through postcss needed)
• metalsmith-rename
• minify images (this needs glob/pattern and decoupled dependencies added, orient on gulp plugin)
• cache

Those are used by metalsmith-in-place and metalsmith-layouts, in our case:

• jstransformer-handlebars for handlebars
• jstransformer-markdown-it for markdown

Which transformers to use is determined by file extension in order from right to left.
They can be used together (e.g. *.md.hbs for handlebars --> markdown --> html).