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.