NAME

App::Dapper::Init - Starter projects for the "dapper init" command.

DESCRIPTION

dapper init writes a starter project into the current directory. These templates are built in (dapper templates lists them):

default

The smallest project: a project file, one layout and one page.

blog

A complete blog: a home page that lists the newest posts across several pages, a page per post, category and tag pages, an Atom feed, a sitemap, SEO tags, a schema for posts, a menu from a data file, code highlighting, and optional search.

portfolio

A grid of projects with images, and about and contact pages.

business

A small business: services, opening hours, contact details and news, all from one data file.

docs

Documentation with a sidebar, previous and next links, and code highlighting.

$ dapper init
$ dapper init --template blog
$ dapper init --template ./my-theme
$ dapper init --template https://github.com/someone/dapper-theme.git

A template can also be a directory, or a git repository (cloned with git), laid out like a project: its files are copied into the current directory (without .git, the output directory or .dapper).

templates

Returns the names of the built-in templates.

description

Takes a template name and returns its one-line description.

template_files

Takes a template: a built-in name, a directory, or a git URL. Returns a hash of the template's files (path to content) and its notes for AGENTS.md.

init

Initialize a Dapper project from a template. Takes the source directory, output directory, layout directory, config file name and template name (default: default). Nothing is written if any of the files already exist. A .gitignore for the output directory is added if there isn't one. Returns the template's notes for AGENTS.md, if it has any.