lekker
v0.0.4
Published
Easy compose your document tree.
Downloads
4
Readme
lekker
Yet another static site generator.
Philosophy
Some static sites just need to be durable and easy to reason about. Rather than build another abstraction, lekker embraces the tried and true: HTML. Express your data via semantic HTML (albeit in fragments) and organize your hierarchy via the file system.
How To
To build your document tree, simply point lekker at the root document.
npx lekker build src/index.htmlYou can pass also pass an outDir option. Defaults to dist.
npx lekker build src/index.html --outDir=publicOrder of Operations
lekker operates by crawling your document tree and folding each fragments until it reaches the leaf document.
In doing so, lekker follows HTML best practices. For example, a folded document should not contain more than one of each of the following elements in it:
navheadermainfooter
Therefore, lekker gives priority to last-in-time usage of the above elements. For all other elements, Lekker simply appends them to the DOM.
For example, when lekker encounters subsequent usage of <meta> tags, it will append them to the document's <head>.
The order of operations is as follows:
- First, start with the
rootDocspecified inlekker.json - Next, check each directory on the way to the document in question for more
index.htmldocuments - Finally, fold in the content from the actual document being compiled
Other elements, as for example: