weitcis / website

schildichat-website

This project builds schildi.chat using metalsmith.

Prepare build

yarn install

Build

make

Info about metalsmith

• Website
• Step by step guide
• GitHub

Info about handlebars

• handlebarsjs
• block helpers

Plugins

Install plugins with

yarn install --dev <plugin-name>

in order to have them put into the devDependencies.

Used

• 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

Interesting, but currently unused

• 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)

jstransformers

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).