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)