NAME

dapper - A publishing tool for static websites.

SYNOPSIS

dapper [options] <command>

# Initialize the current directory with a fresh skeleton of a site
$ dapper init

# Build the site
$ dapper build

# Build the site, then serve it locally at http://localhost:8000,
# rebuilding whenever a file changes
$ dapper serve

# Rebuild the site whenever a file (source, layout, config) changes
$ dapper watch

# Get help on usage and switches
$ dapper -h

# Print the version
$ dapper -v

DESCRIPTION

Dapper transforms simple text files into static websites. Source files (Markdown with YAML front matter) are combined with layout templates and written to an output directory.

See App::Dapper or the README at https://github.com/markdbenson/dapper for the full documentation: the project file, source files, layouts, variables, filters and deployment.

OPTIONS

-s, --source=source directory

Specify the directory containing source files to process. If this command line option is not present, it defaults to the source setting in the config file, or "_source".

-o, --output=output directory

Specify the directory to place the output files in. If this command line option is not present, it defaults to the output setting in the config file, or "_output".

-l, --layout=layout directory

Specify the directory containing layout files. If this command line option is not present, it defaults to the layout setting in the config file, or "_layout".

-c, --config=config file

Specify the config file name to use. If this command line option is not present, it defaults to "_config.yml".

-p, --port=port

Specify the port to use for the serve command. This option is only used for the serve command. If this command line option is not present, it defaults to "8000".

-q, --quiet

Only print errors.

-h, --help

Get help on available commands and options.

-v, --version

Print the version and exit.

AUTHOR

Mark Benson, <mark at jayber.org>

BUGS

Please report any bugs or feature requests at https://github.com/markdbenson/dapper/issues.

LICENSE AND COPYRIGHT

The MIT License (MIT)

Copyright (c) 2002-2026 Mark Benson

See App::Dapper for the full license text.