Luapress v3.3

Markdown goes in, HTML comes out. Luapress is a simple and fast static site/blog generator.

Install with Luarocks:

$ luarocks install luapress

Create a new site in the current directory:

$ luapress init http://mywebsite.com

Drop Markdown files in posts/ & pages/ and build with:

$ luapress

Markdown Extras

Luapress handles a few extensions to normal markdown:

Config Options

Modify the auto-generated config.lua to customise the Luapress output:

All the available options and defaults can be viewed in the default config.

Environments

Multiple environments can be defined in the config file:

config = {
    url = 'http://localhost/mysite',
    envs = {
        production = {
            url = 'http://mysite.com',
            build_dir = 'production'
        }
    }
}

To build against envs:

# Builds default (localhost/mysite) to ./build (the default)
$ luapress

# Builds production (mysite.com) to ./production
$ luapress production

Templates

Luapress templates use mustache, but also offer legacy support for LHTML. You only need to worry about a few files:

The included templates and this website serve as good references for building templates.

Plugins

Plugins can be used like so:

$! MY_PLGUIN arg, arg, arg !$

To use plugins not included with Luapress, just drop them in plugins/ alongside your posts/ and pages/. Plugins must contain an init.lua file which returns a single function. Check out the gallery plugin as a good reference for building plugins.