Dist::Zilla::MintingProfile::Starter(3)

NAME
Dist::Zilla::MintingProfile::Starter - A minimal Dist::Zilla minting profile

SYNOPSIS
  # setup only needs to be run once to set up your dzil config
  $ dzil setup
  $ dzil new -P Starter My::New::Dist

DESCRIPTION
This minting profile for "dzil new" creates a minimal new distribution consisting of a basic "dist.ini" using the [@Starter] plugin bundle, and a skeleton for the main module and its documentation. The author, license, and copyright will be populated in the "dist.ini" and documentation from the current dzil "config.ini", which can be initialized using "dzil setup". The version is initialized statically as 0.001.

The Dist::Zilla::Starter guide explains how the Dist::Zilla plugin system works, and how it is specifically used for the minting process.

See Dist::Zilla::MintingProfile::Starter::Git for a version of this profile designed for the [@Starter::Git] bundle variant.

CUSTOMIZING
It's easy to create your own local version of this (or any other) minting profile which you can customize as you choose. First create a new directory in "profiles" in your dzil configuration folder:

  $ mkdir -p ~/.dzil/profiles/myminter

Then, copy the contents from the profile you want (such as the "profiles/default" directory of this distribution). Modify the copied files to your liking, and then you can use it to mint a distribution.

  $ dzil new -p myminter My::New::Dist

You can also specify a default provider ("-P" option) or profile ("-p" option) in your dzil config ("~/.dzil/config.ini").

  ; config.ini
  [%Mint]
  profile = myminter

  ; or
  [%Mint]
  provider = Starter

  $ dzil new My::New::Dist # now defaults to the specified provider and/or profile

If no provider or profile is configured or specified, "dzil new" will use the "default" local profile, or the default "[@Basic]" profile shipped with Dist::Zilla.

BUGS
Report any issues on the public bugtracker.

AUTHOR
Dan Book <dbook@cpan.org>

COPYRIGHT AND LICENSE
This software is Copyright (c) 2016 by Dan Book.

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)

SEE ALSO
Dist::Zilla, Dist::Zilla::PluginBundle::Starter