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
sourcesetting 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
outputsetting 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
layoutsetting 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.