The templates....
Latest commit de4ff2c Jul 30, 2015 @ferventcoder ferventcoder Merge pull request #19 from ComFreek/patch-2
Add note on UTF-8 problems with Warmup


The templates …

… it’s all about the templates.

##Welcome to the simple way of creating chocolatey packages Take a look at this repository (note the _templates folder). Now open a command line, navigate to your source code top level folder and type the following:

 cinst warmup
 warmup addTextReplacement __CHOCO_PKG_MAINTAINER_NAME__ "Your Name"
 warmup addTextReplacement __CHOCO_PKG_MAINTAINER_REPO__ "Your Repository (contains your packages)"
 git clone
 cd chocolateytemplates\_templates
 warmup addTemplateFolder chocolatey "%cd%\chocolatey"
 warmup addTemplateFolder chocolatey3 "%cd%\chocolatey3"
 warmup addTemplateFolder chocolateyauto "%cd%\chocolateyauto"
 warmup addTemplateFolder chocolateyauto3 "%cd%\chocolateyauto3"

(Use $pwd instead of %cd% for use in PowerShell, e.g. warmup addTemplateFolder chocolatey "$pwd\chocolatey")

  • The package maintainer name (old term: owner) (CHOCO_PKG_MAINTAINER_NAME) would be you.
  • Your packages repository (CHOCO_PKG_MAINTAINER_REPO) is part of a github repo just ferventcoder/chocolatey-packages if your repository is This is only used for image urls. This repository contains your packages, also automatic packages if you have them. It is not recommended to use separate repositories for manual and automatic packages.

Now whenever you want to create a new package you just open a command line and navigate to your packages repository source code folder (or install stexbar cinst stexbar and just hit Ctrl+M from explorer).

 warmup templateName packageName

as in

 warmup chocolatey3 notepadplusplus

Note that Warmup has problems with UTF-8 encoded files (see the related issue at its GitHub repository). Therefore, the UTF-8 test in the *.nuspec files <!-- Do not remove this test for UTF-8: if “Ω”… might actually fail, i.e. you see ??? in your editor.

It is recommended to use choco new for initial package creation, see Chocolatey's wiki entry on package creation.