@static-pages/mustache-writer
v1.0.4
Published
Mustache template engine for Static Pages.
Downloads
5
Readme
Static Pages / Mustache Writer
Renders page data via Mustache templates.
Uses the Mustache package under the hood.
This package is part of the StaticPagesJs project, see:
- Documentation: staticpagesjs.github.io
- Core: @static-pages/core
Options
| Option | Type | Default value | Description |
|--------|------|---------------|-------------|
| view
| string \| (d: Data) => string
| main.mustache
| Template to render. If it's a function it gets evaluated on each render call. |
| viewsDir
| string \| string[]
| views
| One or more directory path where the templates are found. |
| outDir
| string
| dist
| Directory where the rendered output is saved. |
| outFile
| string \| (d: Data) => string
| see outFile section | Path of the rendered output relative to outDir
. |
| onOverwrite
| (d: string) => void
| console.warn(...)
| Callback function that gets executed when a file name collision occurs. |
| onInvalidPath
| (d: string) => void
| console.warn(...)
| Callback function that gets executed when a file name contains invalid characters. |
| showdownEnabled
| string[]
| []
| Transform these variables to markdown; uses showdown. |
| showdownOptions
| showdown.ConverterOptions
| see showdownOptions section | Custom options for the showdown markdown renderer. |
outFile
defaults
The default behaviour is to guess file path by a few possible properties of the data:
- if
data.url
is defined, append.html
and use that. - if
data.header.path
is defined, replace extension to.html
and use that. - if nothing matches call the
onInvalidPath
handler withundefined
file name.
showdownOptions
defaults
This package uses a sligthly modified defaults compared to the official Showdown defaults:
{
simpleLineBreaks: true,
ghCompatibleHeaderId: true,
customizedHeaderId: true,
tables: true,
}