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

NAME

qgoda build - Build a qgoda site

SYNOPSIS

qgoda build [<global options>] [--dry-run]

Try 'qgoda --help' for a description of global options.

DESCRIPTION

Builds a Qgoda powered site. In brief it does the following:

It reads its configuration from the file _config.yaml in the current working directory.

It collects all files in the current directory but ignores all files and directories with names starting with an underscore ('_').

If a file contains front matter, that front matter is taken as meta information about that file. Front-matter is in YAML format:

    ---
    title: My first blog post
    type: post
    ---
    Text with *markup* or [% TemplateToolkit %] code follows.

If the file does not contain front matter, default values are applied and no processing takes place.

The resulting output is then copied to the output directory _site.

After the build was finished, the number of seconds elapsed since the epoch is written into the file _timestamp.

If you want to continuously recreate the site, whenever an input file was modified, created or deleted, try the command qgoda watch instead!

See http://www.qgoda.net/ for detailed information!

OPTIONS

-D, --drafts

Process draft documents (documents with the draft property set)

-F, --future

Process documents with a date (date property) in the future

--dry-run

Just print what would be done but do not write any files.

-h, --help

Show this help page and exit.

SEE ALSO

qgoda(1), Qgoda::Command::Watch, Markdown, Template Toolkit, YAML

QGODA

Part of Qgoda.