README.md

Mon, 06 Jul 2020 10:56:23 -0500

author
Tuomo Valkonen <tuomov@iki.fi>
date
Mon, 06 Jul 2020 10:56:23 -0500
changeset 21
3c71c525cec2
parent 19
d0b9a9c90832
child 24
4013d2901832
permissions
-rw-r--r--

Use markdown-it as default markdown parser.


# lgen

This is a very simple website templating engine based on markdown and Lua,
written by Tuomo Valkonen ⟨<tuomov@iki.fi>⟩.

It is not particularly supported or maintained; it was created back in 2009
to build [my own website](http://tuomov.iki.fi/). The engine is still being
used for that purpose. I decided to put the code online in 2017 after
having had to spend some time to convert it from earlier versions to [Lua 5.3][Lua] from which the `module()` function had been removed.

## Features

For details see the included example.

  * Embedded Lua code with the ltp engine.
  * Advanced markdown features, including syntax highlighting of code blocks
    and LaTeX mathematics via
    [markdown-it][] and [KaTeX][] or [Pandoc][]. Markdown-it is now the default renderer. To select lua-markdown, use `renderer: lua-markdown` in the page YAML meta section. Use `renderer: pandoc` for Pandoc.

## Installation

You need to install [Lua 5.3][Lua].
To use [markdown-it][], you need to install [NodeJS][] and then execute `npm install` to install in the top directory of this project.

## License

Aside from the included `compat_env.lua` and the ltp engine (which is has not
updated to Lua 5.3, and requires on the compat_env module), the code is in
the public domain.

[KaTeX]: https://katex.org/
[markdown-it]: https://github.com/markdown-it/markdown-it
[Pandoc]: https://pandoc.org/
[Lua]: http://www.lua.org/
[NodeJS]: https://nodejs.org/en/

mercurial