To use Mercurial with Kiln On Demand, we recommend that you install the following Mercurial extensions:
- The Kiln extension provides path guessing when acting on related Kiln repositories and quick access to the Kiln website.
- BigPush automatically pushes large repositories in small pieces, for greater reliability. Read more on here.
Install the Extensions
Install the extensions with these quick steps:
- Grab the extensions themselves by logging in to Kiln
- Click on your avatar at the top right, click Kiln Client and Tools
- Download the extensions zip bundle and extract it to your favorite location
- Open the file
.hgrcin your home directory, or
%USERPROFILE%\Mercurial-Kiln.inion Windows. If it doesn’t exist, create it.
- In that file, add a section called
[extensions]if one does not already exist
- Add one line for each extension you wish to include that names the extension and points to where on disk you’ve stored it
For example, to use all 3 extensions, and save them to default unzipped folder/directory name
~/kiln_extensions, then your
%USERPROFILE%\Mercurial-Kiln.ini on Windows) might look like this:
[ui] username=Your Loginname <firstname.lastname@example.org> [extensions] kilnauth=~/kiln_extensions/kilnauth.py big-push=~/kiln_extensions/big-push.py kiln=~/kiln_extensions/kiln.py [auth] kiln.prefix=yoursite.fogbugz.com kiln.username=Your Loginname [kiln_scheme] kiln=http://yoursite.fogbugz.com/Kiln/Code
If everything worked correctly, you should be able to pull up the help documentation by typing
hg help extensionname For example:
gozer:~ benjamin$ hg help kilnauth kilnauth extension - stores authentication cookies for HTTP repositories This extension knows how to capture Kiln authentication tokens when pushing over HTTP. This means you only need to enter your login and password once; after that, the FogBugz token will be stored in your home directory, allowing pushing without a password. If you ever need to logout of Kiln, simply run "hg logout'' list of commands: logout log out of http repositories use "hg -v help kilnauth" to show aliases and global options gozer:~ benjamin$
Older Deprecated Extensions
If you are using Kiln For Your Server, or if you have been using Kiln On Demand for a few years now, you may have a few older deprecated plugins. If you do, you can remove them from your
kilnpath: we no longer distribute this as of Kiln On Demand 3.0 or later.
kbfiles:extension has been deprecated and has been replaced by the native Mercurial
largefilesextension. See ‘How Do I Perform the conversion from KBFiles to LargeFiles‘ for more information.
Gestalt:provided several commands that help new Mercurial users learn how Mercurial works. The primary command provided is “hg next”, which shows an overview of your local repository, its relationship and status to its parent, and what actions you may consider performing next.
CaseGuardreported case-folding collisions when trying to add files that differ only by case.
Enable other Mercurial Extensions
To enable largefiles, add the line
hgext.largefiles = to your
[extensions] section in your mercurial configuration file.
Of course, there are a plethora of other extensions for Mercurial, both built-in and third-party. You might have others under the