The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

unbelievable - Yet another site generator (can you believe it?)

SYNOPSIS

    unbelievable new <sitename>
    cd <sitename>
    unbelievable build

Say unbelievable --man for full documentation. Available subcommands are new, build, and help.

DESCRIPTION

unbelievable makes static sites using Dancer2 and wallflower. The inputs are UTF-8 encoded Markdown files, or HTML files or other assets. Your site is a full Dancer2 application, so can do anything you want! Databases, fancy templating --- the sky's the limit.

To build your static site, unbelievable requests every file in the public/ and content/ directories of your application. public/ usually holds your static files (e.g., images and CSS), just like in a regular Dancer2 application. content/ generally holds your Markdown files. For example, content/foo.md will be accessible (unless you say otherwise in your Dancer2 code) as /foo and /foo/.

For now, don't use request.uri_base in your templates. The generated templates assume they are mounted in /. Please open an issue if that turns out to be a problem.

SUBCOMMANDS

new

TODO!

build

Options

-s, --route-style style

Request routes in style. Valid values are:

htmlfile

Request each route as a file ending in html (e.g., /foo.html.

dir

Request each route as a directory (e.g., /foo/).

LICENSE

Copyright (C) 2020 Chris White.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR

Chris White <cxwembedded@gmail.com>