schildichat-website
This project builds schildi.chat using metalsmith.
Prepare build
yarn install
Build
make
Info about metalsmith
Info about handlebars
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-handlebarsfor handlebarsjstransformer-markdown-itfor 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).