NAME

Dist::Zilla::MintingProfile::Starter::Git - A minimal Dist::Zilla minting profile for git workflows

SYNOPSIS

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

DESCRIPTION

This minting profile for dzil new creates a minimal new distribution consisting of a basic dist.ini using the [@Starter::Git] plugin bundle, a skeleton for the main module and its documentation, and a basic .gitignore. 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 directory is then initialized as a git repository using [Git::Init].

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

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::Git

$ dzil new My::New::Dist # now uses 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) 2018 by Dan Book.

This is free software, licensed under:

The Artistic License 2.0 (GPL Compatible)

SEE ALSO

Dist::Zilla, Dist::Zilla::PluginBundle::Starter::Git, Dist::Zilla::MintingProfile::Starter